Transaction Graph Dataset for the Ethereum Blockchain

This dataset contains ether as well as popular ERC20 token transfer transactions extracted from the Ethereum Mainnet blockchain.

Only send ether, contract function call, contract deployment transactions are present in the dataset. Miner reward (static block reward) and "uncle block inclusion reward" are added as transactions to the dataset. Transaction fee reward and "uncles reward" are not currently included in the dataset.

Details of the datasets are given below:

FILENAME FORMAT:

The filenames have the following format:

eth-tx--.txt.bz2

where is the starting block number and final block number.

For example file eth-tx-1000000-1099999.txt.bz2 contains transactions from

block 1000000 to block 1099999 inclusive.

The files are compressed with bzip2. They can be uncompressed using command bunzip2.

TRANSACTION FORMAT:

Each line in a file corresponds to a transaction. The transaction has the following format:

is the abreviation for the asset.  For example ETH means ether transfer in Wei

                   units.  ERC20 tokens transfers (transfer and transferFrom function calls in ERC20

                    contract) are indicated by token symbol. For example GUSD is Gemini USD stable

                    coin. The JSON file erc20tokens.json given below contains the details of ERC20 tokens.

                    Failed transactions are prefixed with "F-".

   Number of the block which contains the transaction.

       Position of the transaction in the block (i.e. transaction number in the block). Static block reward and uncle block inclusion reward has 0 as tx no. The position of transactions in the block is shifted by 1. The first transaction has 1 as tx no.

Source ethereum address of the transfer. For static block rewards, the from addr is ETHMAINBLOCK. For uncle block inclusion rewards, the from addr is ETHMAINUNCLE.

   Destination ethereum address of the transfer. The to addr is 0x0 for contract deployment transactions instead of null.

      Amount of transfer. The amount is given as hexadecimal a number.

BLOCK TIME FORMAT:

The block time file has the following format:

    Number of the block.

 Unix timestamp at which the block is mined as a hexadecimal number.

erc20tokens.json FILE:

This file contains the list of popular ERC20 token contracts whose transfer/transferFrom transactions appear in the data files.

ERC20 token list: USDT TRYb XAUt BNB LEO LINK HT HEDG MKR CRO VEN INO PAX INB SNX REP MOF ZRX SXP OKB XIN OMG SAI HOT DAI EURS HPT BUSD USDC SUSD HDG QCAD PLUS BTCB WBTC cWBTC renBTC sBTC imBTC pBTC

IMPORTANT NOTE:

Public Ethereum Mainnet blockchain data is open and can be obtained by connecting as a node on the blockchain or by using the block explorer web sites such as http://etherscan.io . The downloaders and users of this dataset accept the full responsibility of using the data in GDPR compliant manner or any other regulations. We provide the data as is and we cannot be held responsible for anything.

NOTE:

If you use this dataset, please do not forget to add the DOI number to the citation.

If you use our dataset in your research, please also cite our paper: https://link.springer.com/article/10.1007/s10586-021-03511-0

@article{kilic2022parallel, title={Parallel Analysis of Ethereum Blockchain Transaction Data using Cluster Computing}, journal={Cluster Computing}, author={K{\i}l{\i}{\c{c}}, Baran and {\"O}zturan, Can and Sen, Alper}, year={2022}, month={Jan} }

Field	Value
Data last updated	December 4, 2024
Metadata last updated	December 4, 2024
Created	December 4, 2024
Format	JSON
License	Creative Commons Attribution
Has views	False
Id	d7d9bc04-62f5-467e-bf37-10d1b5eef177
Package id	171cbc34-8ae5-403e-b472-151e76b11e0e
Position	0
State	active

Additional Information