{"id":13792464,"url":"https://github.com/thisiskeanyvy/blocktracker","last_synced_at":"2025-04-14T23:55:39.947Z","repository":{"id":155582106,"uuid":"389657495","full_name":"thisiskeanyvy/blocktracker","owner":"thisiskeanyvy","description":"A tool to go up the transaction tree of an address on the Blockchain.","archived":false,"fork":false,"pushed_at":"2021-08-11T07:41:49.000Z","size":36,"stargazers_count":17,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-14T23:55:22.084Z","etag":null,"topics":["bitcoin","bitcoin-cash","blockchain","blocktracker","cardano","cosmos","cryptocurrency","dash","dogecoin","ethereum","ethereum-token","komodo","lisk","litecoin","nem","neo","ripple","tezos","transaction-tracker","tron"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thisiskeanyvy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-07-26T14:16:02.000Z","updated_at":"2025-01-29T14:26:02.000Z","dependencies_parsed_at":"2024-01-28T17:25:59.398Z","dependency_job_id":null,"html_url":"https://github.com/thisiskeanyvy/blocktracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisiskeanyvy%2Fblocktracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisiskeanyvy%2Fblocktracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisiskeanyvy%2Fblocktracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thisiskeanyvy%2Fblocktracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thisiskeanyvy","download_url":"https://codeload.github.com/thisiskeanyvy/blocktracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248981261,"owners_count":21193144,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","bitcoin-cash","blockchain","blocktracker","cardano","cosmos","cryptocurrency","dash","dogecoin","ethereum","ethereum-token","komodo","lisk","litecoin","nem","neo","ripple","tezos","transaction-tracker","tron"],"created_at":"2024-08-03T22:01:12.499Z","updated_at":"2025-04-14T23:55:39.929Z","avatar_url":"https://github.com/thisiskeanyvy.png","language":"Python","funding_links":[],"categories":["I - Tools List"],"sub_categories":[],"readme":"# BlockTracker\nA tool to go up the transaction tree of an address on the Blockchain.\n\n## What is BlockTracker?\n\nBlockTracker is a tool for tracking transactions from wallet addresses on the Blockchain. It is able to list them and establish a transaction tree.\n\nEven after mixing funds from one or more wallets, it is able to trace the transactions back to the final wallet address.\n\n### How does it work?\n\nDeveloped 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.\n\nTo 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).\n\n------\n\n## Installation\n\n#Clone the github repository\n\n```shell\n$ git clone https://github.com/thisiskeanyvy/blocktracker.git\n```\n\n#Go to the tool's folder\n\n```shell\n$ cd blocktracker/\n```\n\n#Installing the pre-required Python libraries\n\n```shell\n$ pip3 install -r requirements.txt\n```\n\n#Run the tool with the command line\n\n```shell\n$ python3 blocktracker.py\n```\n\n### Prerequisites :\n\n- Python \u003e= 3\n  - Argparse (libraries)\n  - Requests (libraries)\n  - Pandas (libraries)\n  - Tabloo (libraries)\n- Pip \u003e= 3\n\n### Using the command line software :\n\n#List the commands that can be used\n\n```shell\n$ python3 blocktracker.py -h #--help\n```\n\n```shell\nusage: blocktracker.py [-h] [-w WHATADDRESS] [-t TRACK]\n\noptional arguments:\n-h, --help       show this help message and exit\n-w WHATADDRESS, --whataddress WHATADDRESS\nGet type of wallet address\n-t TRACK, --track TRACK\nGet all transactions from an address\n```\n\n#Know the type of crypto-currency in the wallet\n\n```shell\n$ python3 blocktracker.py -w TScgcMteFMiYzXMgWPoKkaTNnKaLWZnnPb #--whataddress\n```\n\n```shell\nTRON (TRX)\n```\n\n#Get the transaction tree of one or more addresses of a wallet\n\n```shell\n$ python3 blocktracker.py -t 0xbaf681271070c832DbB217665ACf0005f0A87A0c #--track\n```\n\n```shell\nAddress n°1 : 0xbaf681271070c832DbB217665ACf0005f0A87A0c\n-----------------\n- Transactions List -\n\nTime : 2019-03-24 20:46:47\nFrom : 0x6a67e74a202949c6a08496cd764452970135862c\nTo : 0xbaf681271070c832dbb217665acf0005f0a87a0c\n-----------------\nTime : 2019-03-24 20:54:24\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : Contract Creation\n-----------------\nTime : 2019-03-25 18:19:42\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : Contract Creation\n-----------------\nTime : 2019-03-25 18:29:21\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : Contract Creation\n-----------------\nTime : 2019-03-25 18:33:11\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : Contract Creation\n-----------------\nTime : 2019-03-27 21:27:38\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0x02d8fd2bb0eb0ec9d522f4048c4e5be4fb1ce00e\n-----------------\nTime : 2019-03-27 21:42:05\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0x02d8fd2bb0eb0ec9d522f4048c4e5be4fb1ce00e\n-----------------\nTime : 2019-03-27 23:02:56\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0xfba47af95dafe128dfe192aec9b38fe4642fe52d\n-----------------\nTime : 2019-07-07 22:57:04\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0xc7fce44d4d0ea55188f56d1a97aa332eb1b0a0ed\n-----------------\nTime : 2019-07-07 23:35:16\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0xa78a1fd878d0961b557b366919c0f2871af9a365\n-----------------\nTime : 2019-07-11 01:11:11\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0xb4c0f04a7a08e472c94486d5281f03d5ac3b5bb3\n-----------------\nTime : 2019-07-15 00:51:09\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0x2143aa1d1108e918422317b45ca14d28813cb454\n-----------------\nTime : 2019-09-06 23:36:25\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0xe9d4cd0e1f0e1e0b8b73c03541624557c56d0108\n-----------------\nTime : 2019-12-26 17:08:43\nFrom : 0xbaf681271070c832dbb217665acf0005f0a87a0c\nTo : 0x4fedda5671a544bc94a002c32799db2a42780db1\n-----------------\n```\n\n#### Using the advanced tool :\n\n#List the transactions of several addresses\n\n```shell\n$ python3 blocktracker.py -t address1,address2,address3 #--track\n```\n\n------\n\n## Development Process\n\nBlockTracker is released under the terms of the GPL-3.0 license. See [Licence](https://github.com/thisiskeanyvy/blocktracker/blob/main/LICENSE) for more information or see https://opensource.org/licenses/GPL-3.0.\n\n### Licence GPL-3.0 :\n\nPermissions 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.\n\n### Features :\n\n#### Whataddress function :\n\nExecution: Offline\n\nSupported crypto-currencies :\n\n- [x] Ethereum (ETH)\n- [x] Bitcoin (BTC)\n- [x] Bitcoin Cash (BCH)\n- [x] Cardano (ADA)\n- [x] Cosmos (ATOM)\n- [x] Dash (DASH)\n- [x] Dogecoin (DOGE)\n- [x] Komodo (KMD)\n- [x] Lisk (LSK)\n- [x] Litecoin (LTC)\n- [x] NEM (XEM)\n- [x] NEO (NEO)\n- [x] Ontology (ONT)\n- [x] Polkadot (DOT)\n- [x] Ripple (XRP)\n- [x] Stellar (XLM)\n- [x] Tezos (XTZ)\n- [x] TRON (TRX)\n- [x] Waves (WAVES)\n- [x] Zcash (ZEC)\n\n#### Tracking function :\n\nExecution: Online\n\nType of requests: GET\n\nSupported crypto-currencies :\n\n- [x] Ethereum (ETH)\n- [ ] Bitcoin (BTC)\n- [ ] Bitcoin Cash (BCH)\n- [ ] Cardano (ADA)\n- [ ] Cosmos (ATOM)\n- [ ] Dash (DASH)\n- [ ] Dogecoin (DOGE)\n- [ ] Komodo (KMD)\n- [ ] Lisk (LSK)\n- [ ] Litecoin (LTC)\n- [ ] NEM (XEM)\n- [ ] NEO (NEO)\n- [ ] Ontology (ONT)\n- [ ] Polkadot (DOT)\n- [ ] Ripple (XRP)\n- [ ] Stellar (XLM)\n- [ ] Tezos (XTZ)\n- [ ] TRON (TRX)\n- [ ] Waves (WAVES)\n- [ ] Zcash (ZEC)\n\n------\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthisiskeanyvy%2Fblocktracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthisiskeanyvy%2Fblocktracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthisiskeanyvy%2Fblocktracker/lists"}