Bitcoin dust transactions
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.
-
The
infosection 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:
timestamprepresents the Unix timestamp of the block containing the transaction.blockIdrepresents the height of the block containing the transaction.txIdis a numeric value that univocally identifies the transaction.isCoinbaseis equal to 1 if the transaction is a coinbase transaction, 0 otherwise.feedenotes the transaction fee, expressed in satoshis (i.e., the smallest bitcoin denomination).approximateSizedenotes the approximate size of the transaction (expressed in bytes).
-
The
inputssection contains a sequence of (0 or more) transaction inputs separated by a semicolon. Each input, in turn, is represented as a comma-separated stringaddrId,amount,prevTxId,offsetwhere:addrIdrepresents the numeric identifier of the spending address;amountis the amount of value associated with the input (expressed in satoshis);prevTxIdrepresents the numeric identifier of the transaction that created the output that is currently being spent;offsetrepresents the position, among all outputs ofprevTxId, of the output that is currently being spent.
- The
outputssection contains a sequence of (1 or more) transaction outputs separated by a semicolon. Each output, in turn, is represented as a comma-separated stringaddrId,amount,scriptTypewhere:
addrIdrepresents the numeric identifier of the receiving address;amountis the amount of value associated with the output (expressed in satoshis);scriptTypeis 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
- 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.
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 |
|
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.