DOI: 10.5281/zenodo.10644076
title: ERC-20 and ERC-721 Transfer events

description: Description

This repository contains information about the Transfer events emitted by ERC-20 and ERC-721 contracts on the Ethereum blockchain. Specifically, the events in the repository are those included in the first 15 million blocks of the chain, i.e., from block 0 (added on July 30th, 2015, 15:26:13 GMT) to block 14,999,999 (added on June 21st, 2022, 02:28:10 GMT).

All files in the repository are written according to the CSV (Comma Separated Value) format. For space reasons, they have also been compressed using the XZ utility. The dataset consists of the following files.



block_timestamps_0-14999999.csv.xz contains information about the timestamps of individual blocks. Specifically, each row in the file represents a block and consists of 2 fields.  



The first field represents the block identifier (i.e., its height).

The second field is the Unix epoch timestamp indicating the instant at which the block was added to the blockchain.



The erc20_transfers.csv.xz (resp. erc721_transfers.csv.xz) file contains a row for each ERC-20 (resp. ERC-721) Transfer event. The description of each transfer includes 4 fields. 



Block identifier in which the transfer occurred.

Numeric identifier of the contract that produced the event.

Numeric identifier of the sender of the transfer.

Numeric identifier of the recipient of the transfer.



The erc20_contracts.csv.xz (resp. erc721_contracts.csv.xz) file contains the Ethereum addresses of the contracts that have raised at least one ERC-20 Transfer event (resp. ERC-721) within the considered blocks. More precisely, each row of these files represents a contract and consists of 2 fields.



Ethereum address of the contract. 

Numerical identifier used to represent the contract. Specifically, the identifiers listed in erc20_contracts.csv.xz are used inside erc20_transfers.csv.xz, while those of erc721_contracts.csv.xz are used in the erc721_transfers.csv.xz file.



The erc20_addresses.csv.xz (resp. erc721_addresses.csv.xz) file contains the Ethereum addresses of the participants involved in at least one ERC-20 Transfer event (resp. ERC-721) within the considered blocks. More precisely, each row of these files is composed of 2 fields.



Ethereum address of the participant. 

Numerical identifier used to represent the participant. The identifiers contained in erc20_addresses.csv.xz are used in the erc20_transfers.csv.xz file, while those of erc721_addresses.csv.xz are used in the erc721_transfers.csv.xz file.



The erc20_values_dec.csv.xz file contains the amounts of all ERC-20 token transfers. The file includes a row for each ERC-20 transfer and the n-th row contains the amount of fungible tokens exchanged in the n-th transfer of the erc20_transfers.csv.xz file.

The erc721_values_dec.csv.xz file has one row for each ERC-721 token transfer. The n-th row of this file contains the identifier of the non-fungible token exchanged in the n-th transfer of the erc721_transfers.csv.xz file.


Cite this work  

If the data included in this repository have been useful, please cite the following articles in your work.

@article{LoporchioMBR24,
  title        = "Comparing Ethereum fungible and non-fungible tokens: an analysis of transfer networks",
  author       = "Loporchio, Matteo and
                  Di Francesco Maesa, Damiano and
                  Bernasconi, Anna and
                  Ricci, Laura",
  journal      = "Applied Network Science",
  volume       = "9",
  number       = "1",
  pages        = "72",
  year         = 2024
}

@incollection{Loporchio2024-gb,
  title     = "Analysis and characterization of {ERC-20} token network
               topologies",
  booktitle = "Complex Networks \& Their Applications {XII}",
  author    = "Loporchio, Matteo and Di Francesco Maesa, Damiano and
               Bernasconi, Anna and Ricci, Laura",
  publisher = "Springer Nature Switzerland",
  pages     = "344--355",
  series    = "Studies in computational intelligence",
  year      =  2024,
  address   = "Cham"
}

Funding

This work was partially supported by Project Awesome: Analysis Framework for Web3 SOcial MEdia, project code: 2022MAWEZA, under the National Recovery and Resilience Plan funded by the European Union - NextGenerationEU, MISSION 4 COMPONENT 2, INVESTMENT N.1.1 CALL PRIN 2022 D.D. 104 02-02-2022, CUP N.I53D23003680006, and by Project DLT-FRUIT: A user centered framework for facilitating DLTs FRUITion, project code: P2022NZPJA, under the National Recovery and Resilience Plan funded by the European Union - NextGenerationEU, MISSION 4 COMPONENT 2, INVEST- MENT N.1.1 CALL PRIN 2022 PNRR D.D. n. 1409 14/09/2022, CUP N.I53D23006100001.

References

[1] M. Loporchio, D. Di Francesco Maesa, A. Bernasconi, and L. Ricci, “Analysis and Characterization of ERC-20 Token Network Topologies,” Complex Networks & Their Applications XII. Springer Nature Switzerland, pp. 344–355, 2024. https://doi.org/10.1007/978-3-031-53472-0_29

[2] M. Loporchio, D. Di Francesco Maesa, A. Bernasconi, and L. Ricci, "Comparing Ethereum Fungible and Non-Fungible Tokens: an Analysis of Transfer Networks," Applied Network Science, vol. 9, no. 1. Springer Science and Business Media LLC, Nov. 20, 2024. https://doi.org/10.1007/s41109-024-00682-8