DOI: 10.6084/m9.figshare.26305093.v1
title: BitcoinTemporalGraph

description: This dataset contains several files:<b>dataset.tar.gz</b>: A compressed PostgreSQL database representing a graph.<b>addresses.csv</b>: A list of approximately 100,000 labeled Bitcoin addresses.<b>BitcoinTalkThreads.tar.gz</b>: A compressed folder of approximately 14 million messages collected from the BitcoinTalk forum, used to obtain the list of labeled Bitcoin addresses.<b>LabelingOtherSources.tar.gz</b>: Various sources used to enrich the list of addresses.BitcoinTemporalGraph (dataset.tar.gz)This dataset represents a graph of value transfers between Bitcoin users. The nodes represent entities/users, and the edges represent value transfers or transactions between these entities. The graph is temporal and directed.Usage:Decompress the archive: "pigz -p 10 -dc dataset.tar.gz | tar -xvf -"Restore the tables into an existing PostgreSQL database using the <code>pg_restore</code> utility: "pg_restore -j number_jobs -Fd -O -U database_username -d database_name dataset"Ensure substantial storage for the database: 40GB for <code>node_features</code> and 80GB for <code>transaction_edges</code> (including indexes)Dataset DescriptionThe database contains two tables: <code>node_features</code> (approximately 252 million rows) and <code>transaction_edges</code> (approximately 785 million rows).Columns for <code>node_features</code> table:<b>alias</b>: Identifier of the node<b>degree</b>: Degree of the node<b>degree_in</b>: Number of incoming edges to the node<b>degree_out</b>: Number of outgoing edges from the node<b>total_transaction_in</b>: Total count of value transfers received by the node<b>total_transaction_out</b>: Total count of value transfers initiated by the nodeAmounts are expressed in satoshis (1 satoshi = 10^-8 Bitcoin):<b>min_sent</b>: Minimum amount sent by the node during a transaction<b>max_sent</b>: Maximum amount sent by the node during a transaction<b>total_sent</b>: Total amount sent by the node during all transactions<b>min_received</b>: Minimum amount received by the node during a transaction<b>max_received</b>: Maximum amount received by the node during a transaction<b>total_received</b>: Total amount received by the node during all transactions<b>label</b>: Label describing the type of entity represented by the nodeTransactions on the Bitcoin network are stored in the public ledger named the "Bitcoin Blockchain". Each transaction is recorded in a block, with the block index indicating the transaction's position in the blockchain.<b>first_transaction_in</b>: Block index of the first transaction received by the node<b>last_transaction_in</b>: Block index of the last transaction received by the node<b>first_transaction_out</b>: Block index of the first transaction sent by the node<b>last_transaction_out</b>: Block index of the last transaction sent by the nodeNodes can represent one or more Bitcoin addresses (pseudonyms used by Bitcoin users). A real entity often uses multiple addresses. The dataset contains only transactions between nodes (outer transactions), but provides information about inner transactions (transactions between addresses controlled by the same node).<b>cluster_size</b>: Number of addresses represented by the node<b>cluster_num_edges</b>: Number of transactions between the addresses represented by the node<b>cluster_num_cc</b>: Number of connected components in the transaction graph of the addresses represented by the node<b>cluster_num_nodes_in_cc</b>: Number of non-isolated addresses in the clusterColumns in the <code>transaction_edges</code> table:<b>a</b>: Node alias of the sender<b>b</b>: Node alias of the recipient<b>reveal</b>: Block index of the first transaction from <code>a</code> to <code>b</code><b>last_seen</b>: Block index of the last transaction from <code>a</code> to <code>b</code><b>total</b>: Total number of transactions from <code>a</code> to <code>b</code><b>min_sent</b>: Minimum amount sent (in satoshis) in a transaction from <code>a</code> to <code>b</code><b>max_sent</b>: Maximum amount sent (in satoshis) in a transaction from <code>a</code> to <code>b</code><b>total_sent</b>: Total amount sent (in satoshis) in all transactions from <code>a</code> to <code>b</code>Dataset of Bitcoin Labeled Addresses (addresses.csv)This file contains 101,186 labeled Bitcoin addresses with the following columns:<b>address</b>: Bitcoin address<b>entity</b>: Name of the entity<b>category</b>: Type of the entity (e.g., individual, bet, ransomware, gambling, exchange, mining, ponzi, marketplace, faucet, bridge, mixer)<b>source</b>: Source used to label the addressBitcoinTalk Threads (BitcoinTalkThreads.tar.gz)This compressed folder contains 14,067,713 messages from 546,440 threads on the BitcoinTalk forum. Each thread is saved as a separate JSON file.Other Sources (LabelingOtherSources.tar.gz)This folder includes text files listing addresses collected from various alternative sources:Addresses of centralized exchanges sourced from CoinMarketCap and DeFiLlama.Ransomware addresses identified in several research papers, including the Padua ransomware dataset, the Sextorsion Padua dataset, and the Montréal ransomware dataset. These addresses were compiled from public sources such as security reports, academic publications, and online databases listing Bitcoin addresses linked to illegal activities.Specially Designated Nationals (SDN) List maintained by the U.S. Department of Justice.Addresses holding bitcoins related to the bridge Wrapped Bitcoin (WBTC).Bitcoin addresses extracted from user profiles on BitcoinTalk. Forum users often include their personal Bitcoin addresses in their profiles or signatures.Addresses associated with mining entities, which can be identified by the messages miners include in their coinbase transactions.<br>