Published March 3, 2023 | Version 1.0.0

Bitcoin dust transactions

  • 1. University of Pisa

Description

General information

This repository contains data regarding Bitcoin dust transactions. In the Bitcoin protocol, dust refers to the small amounts of currency that are lower than the fee required to spend them in a transaction. 

The repository comprises all transactions with at least one dust output or input. According to our definition, a dust output (or input) is considered dust if the associated amount is between 1 and 545 satoshis (where 1 satoshi = 10-8 bitcoin). For more details about the definition of dust, see [1].

All dust transactions have been extracted from the first 479,970 blocks of the Bitcoin blockchain, thus covering the time period between January 3rd, 2009 18:15 GMT and August 10th, 2017 18:03 GMT.

Data set description

File Description
txs A text file containing a representation of all Bitcoin transactions that create and consume dust. See the description below for more information about the structure of this file.
txs_addr_map.csv A CSV file that maps numeric address identifiers to real Bitcoin addresses. This file comprises all addresses appearing in the txs data set.
labels.csv A CSV file containing categorical entity labels for Bitcoin addresses appeared in transactions between 2010 and 2018. This file has been derived from the Entity-Address data set [2, 3] (see also: https://github.com/Maru92/EntityAddressBitcoin).
outputs_spent_stats.csv  A CSV file containing statistics about all spent outputs in the first 479970 blocks of the Bitcoin blockchain. The file describes the durations of dust and non-dust outputs. The duration is defined as the difference between the height of the block where the output is spent and the height of the block where it was created. 
cluster_sizes_*.csv These CSV files contain information about clusters of addresses induced by Bitcoin transactions. They have been used for the clustering analysis presented in [4]. See this GitHub repository for more information.

Transaction representation

The txs file contains a textual representation of dust transactions in the Bitcoin blockchain. Each row of the file corresponds to a transaction and is represented as a sequence of fields

info:inputs:outputs

with the following meaning.

  1. The info section contains general information about the transaction. It is represented as a list of comma-separated fields, namely: timestamp,blockId,txId,isCoinbase,fee,approxSize.

    The meaning of the fields is the following:

    1. timestamp represents the Unix timestamp of the block containing the transaction.
    2. blockId represents the height of the block containing the transaction.
    3. txId is a numeric value that univocally identifies the transaction.
    4. isCoinbase is equal to 1 if the transaction is a coinbase transaction, 0 otherwise.
    5. fee denotes the transaction fee, expressed in satoshis (i.e., the smallest bitcoin denomination).
    6. approximateSize denotes the approximate size of the transaction (expressed in bytes).
  2. The inputs section contains a sequence of (0 or more) transaction inputs separated by a semicolon. Each input, in turn, is represented as a comma-separated string addrId,amount,prevTxId,offset where:

    1. addrId represents the numeric identifier of the spending address;
    2. amount is the amount of value associated with the input (expressed in satoshis);
    3. prevTxId represents the numeric identifier of the transaction that created the output that is currently being spent;
    4. offset represents the position, among all outputs of prevTxId, of the output that is currently being spent.
       
  3. The outputs section contains a sequence of (1 or more) transaction outputs separated by a semicolon. Each output, in turn, is represented as a comma-separated string addrId,amount,scriptType where:
     
    1. addrId represents the numeric identifier of the receiving address;
    2. amount is the amount of value associated with the output (expressed in satoshis);
    3. scriptType is a numeric identifier representing the type of the script associated with the output (i.e., 0=UNKNOWN; 1=P2PK; 2=P2PKH; 3=P2SH; 4=RETURN; 5=EMPTY).

Data analysis

Data included in this repository have been employed for the analyses presented in [4, 5]. This GitHub repository contains several tools, written in Java and Python, for analyzing the data.

Cite this work

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

@article{loporchio2023bitcoin, 
  title={Is Bitcoin gathering dust? An analysis of low-amount Bitcoin transactions},
  author={Loporchio, Matteo and Bernasconi, Anna and Di Francesco Maesa, Damiano and Ricci, Laura},
  journal={Applied Network Science},
  volume={8},
  number={1},
  pages={1--28},
  year={2023},
  publisher={SpringerOpen}
}

References

  1. Pérez-Solà, Cristina, et al. "Another coin bites the dust: an analysis of dust in UTXO-based cryptocurrencies." Royal Society open science 6.1 (2019): 180817.
  2. Jourdan, Marc, et al. "Characterizing entities in the bitcoin blockchain." 2018 IEEE international conference on data mining workshops (ICDMW). IEEE, 2018.
  3. Jourdan, Marc, et al. "A probabilistic model of the bitcoin blockchain." Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition Workshops. 2019.
  4. Loporchio, Matteo, et al. "Is Bitcoin gathering dust? An analysis of low-amount Bitcoin transactions." Applied Network Science 8.1 (2023): 1-28.
  5. Loporchio, Matteo, et al. "An Analysis of Bitcoin Dust Through Authenticated Queries." Complex Networks and Their Applications XI: Proceedings of The Eleventh International Conference on Complex Networks and their Applications: COMPLEX NETWORKS 2022—Volume 2. Cham: Springer International Publishing, 2023.

Files

cluster_sizes_diff_F_N2.csv

Files (6.8 GB)

Name Size
md5:9eb1dad6d514b77532dd586b6855017e
492.3 kB Preview Download
md5:57f63ba1de3f87e6cfb190571642b3b5
381.5 kB Preview Download
md5:1c6c92ec8dc0b54d770e563bf335c08c
7.5 MB Preview Download
md5:2f13f5d35132d9c8db229b1955b6d4da
4.9 MB Preview Download
md5:b6308eeb54ea0aab434f8384a9ffb685
1.6 GB Preview Download
md5:91f319dce6427c4780a903f777e0daa1
1.6 GB Preview Download
md5:4ff41eed87c73fd7bc903a9f24ea8f8d
1.6 GB Preview Download
md5:f9757f2cda7c8a30db437bca6c6f28d5
1.4 GB Preview Download
md5:5b03c3d41bd65113b1e5c358d895512c
12.6 MB Preview Download
txs
md5:a684f437e8e5c37f839d3e5415a1398b
496.7 MB Download
md5:2f2bec43c6a3bb3940b8300b05929124
153.3 MB Preview Download

Additional details

Related works

Is compiled by
Journal article: 10.1007/s41109-023-00557-4 (DOI)

References

  • Pérez-Solà, Cristina, et al. "Another coin bites the dust: an analysis of dust in UTXO-based cryptocurrencies." Royal Society open science 6.1 (2019): 180817.
  • Jourdan, Marc, et al. "Characterizing entities in the bitcoin blockchain." 2018 IEEE international conference on data mining workshops (ICDMW). IEEE, 2018.
  • Jourdan, Marc, et al. "A probabilistic model of the bitcoin blockchain." Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition Workshops. 2019.
  • Loporchio, Matteo, et al. "Is Bitcoin gathering dust? An analysis of low-amount Bitcoin transactions." Applied Network Science 8.1 (2023): 1-28.
  • Loporchio, Matteo, et al. "An Analysis of Bitcoin Dust Through Authenticated Queries." Complex Networks and Their Applications XI: Proceedings of The Eleventh International Conference on Complex Networks and their Applications: COMPLEX NETWORKS 2022—Volume 2. Cham: Springer International Publishing, 2023.