Skip to content

A tool to go up the transaction tree of an address on the Blockchain.

License

Notifications You must be signed in to change notification settings

thisiskeanyvy/blocktracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BlockTracker

A tool to go up the transaction tree of an address on the Blockchain.

What is BlockTracker?

BlockTracker is a tool for tracking transactions from wallet addresses on the Blockchain. It is able to list them and establish a transaction tree.

Even after mixing funds from one or more wallets, it is able to trace the transactions back to the final wallet address.

How does it work?

Developed in the Python language, the tool uses the argparse library to handle command line commands. It uses the requests library to retrieve data from multiple API's via a GET method and then sorts it.

To trace a fund mix, the tool builds a transaction tree and also analyses the addresses of the recipients. Once the transaction tree is established, it determines with probabilities the possible final address(es).


Installation

#Clone the github repository

$ git clone https://github.com/thisiskeanyvy/blocktracker.git

#Go to the tool's folder

$ cd blocktracker/

#Installing the pre-required Python libraries

$ pip3 install -r requirements.txt

#Run the tool with the command line

$ python3 blocktracker.py

Prerequisites :

  • Python >= 3
    • Argparse (libraries)
    • Requests (libraries)
    • Pandas (libraries)
    • Tabloo (libraries)
  • Pip >= 3

Using the command line software :

#List the commands that can be used

$ python3 blocktracker.py -h #--help
usage: blocktracker.py [-h] [-w WHATADDRESS] [-t TRACK]

optional arguments:
-h, --help       show this help message and exit
-w WHATADDRESS, --whataddress WHATADDRESS
Get type of wallet address
-t TRACK, --track TRACK
Get all transactions from an address

#Know the type of crypto-currency in the wallet

$ python3 blocktracker.py -w TScgcMteFMiYzXMgWPoKkaTNnKaLWZnnPb #--whataddress
TRON (TRX)

#Get the transaction tree of one or more addresses of a wallet

$ python3 blocktracker.py -t 0xbaf681271070c832DbB217665ACf0005f0A87A0c #--track
Address n°1 : 0xbaf681271070c832DbB217665ACf0005f0A87A0c
-----------------
- Transactions List -

Time : 2019-03-24 20:46:47
From : 0x6a67e74a202949c6a08496cd764452970135862c
To : 0xbaf681271070c832dbb217665acf0005f0a87a0c
-----------------
Time : 2019-03-24 20:54:24
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : Contract Creation
-----------------
Time : 2019-03-25 18:19:42
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : Contract Creation
-----------------
Time : 2019-03-25 18:29:21
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : Contract Creation
-----------------
Time : 2019-03-25 18:33:11
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : Contract Creation
-----------------
Time : 2019-03-27 21:27:38
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0x02d8fd2bb0eb0ec9d522f4048c4e5be4fb1ce00e
-----------------
Time : 2019-03-27 21:42:05
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0x02d8fd2bb0eb0ec9d522f4048c4e5be4fb1ce00e
-----------------
Time : 2019-03-27 23:02:56
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0xfba47af95dafe128dfe192aec9b38fe4642fe52d
-----------------
Time : 2019-07-07 22:57:04
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0xc7fce44d4d0ea55188f56d1a97aa332eb1b0a0ed
-----------------
Time : 2019-07-07 23:35:16
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0xa78a1fd878d0961b557b366919c0f2871af9a365
-----------------
Time : 2019-07-11 01:11:11
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0xb4c0f04a7a08e472c94486d5281f03d5ac3b5bb3
-----------------
Time : 2019-07-15 00:51:09
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0x2143aa1d1108e918422317b45ca14d28813cb454
-----------------
Time : 2019-09-06 23:36:25
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0xe9d4cd0e1f0e1e0b8b73c03541624557c56d0108
-----------------
Time : 2019-12-26 17:08:43
From : 0xbaf681271070c832dbb217665acf0005f0a87a0c
To : 0x4fedda5671a544bc94a002c32799db2a42780db1
-----------------

Using the advanced tool :

#List the transactions of several addresses

$ python3 blocktracker.py -t address1,address2,address3 #--track

Development Process

BlockTracker is released under the terms of the GPL-3.0 license. See Licence for more information or see https://opensource.org/licenses/GPL-3.0.

Licence GPL-3.0 :

Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

Features :

Whataddress function :

Execution: Offline

Supported crypto-currencies :

  • Ethereum (ETH)
  • Bitcoin (BTC)
  • Bitcoin Cash (BCH)
  • Cardano (ADA)
  • Cosmos (ATOM)
  • Dash (DASH)
  • Dogecoin (DOGE)
  • Komodo (KMD)
  • Lisk (LSK)
  • Litecoin (LTC)
  • NEM (XEM)
  • NEO (NEO)
  • Ontology (ONT)
  • Polkadot (DOT)
  • Ripple (XRP)
  • Stellar (XLM)
  • Tezos (XTZ)
  • TRON (TRX)
  • Waves (WAVES)
  • Zcash (ZEC)

Tracking function :

Execution: Online

Type of requests: GET

Supported crypto-currencies :

  • Ethereum (ETH)
  • Bitcoin (BTC)
  • Bitcoin Cash (BCH)
  • Cardano (ADA)
  • Cosmos (ATOM)
  • Dash (DASH)
  • Dogecoin (DOGE)
  • Komodo (KMD)
  • Lisk (LSK)
  • Litecoin (LTC)
  • NEM (XEM)
  • NEO (NEO)
  • Ontology (ONT)
  • Polkadot (DOT)
  • Ripple (XRP)
  • Stellar (XLM)
  • Tezos (XTZ)
  • TRON (TRX)
  • Waves (WAVES)
  • Zcash (ZEC)