https://github.com/devrandom/forensics

https://github.com/devrandom/forensics

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/devrandom/forensics
• Owner: devrandom
• License: apache-2.0
• Created: 2019-05-09T18:53:11.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2021-10-29T10:23:13.000Z (over 3 years ago)
• Last Synced: 2025-01-31T22:07:00.964Z (5 months ago)
• Language: Python
• Size: 10.7 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Blockchain forensics

Naive tracking of blockchain addresses by crawling the transaction

graph starting at that address.

## Usage

Put addresses you want to track in the file `seed-address`.  Optionally set

the environment variable `MIN_HEIGHT` to the minimum block height

you are interested in.  Optionally set the environment variable `OMIT_BUSY_ADDRESSES`

if you want to skip addresses with more than 25 transactions (those may be exchange

hot wallets or such).  By default, amounts under 1 BTC are omitted, but you can change

that via `MIN_VALUE` in satoshis. 

To run:

```sh

./track.py

```

You can kill and restart the process at any time.  Every time a scanning pass is

done, the file `txmap` will be populated with a JSON dump of all transactions

that were found.  `txmap` also acts as the persistent state of the script.

## Limitations

- Only the last 25 transactions are considered for each address

- Exchange wallets and mixers may result in a large number of unwanted hits (but see `OMIT_BUSY_ADDRESSES` above)