Generates a snapshot of all CAT coins at a target block height.

Environment variables should be passed to configure the behavior of the tool:

• FULL_NODE_HOSTNAME - Hostname of full node to call RPCs against
• DB_SOURCE_DIR - Location of full node database on host machine
• START_HEIGHT - The height of the blockchain to start creating the snapshot from (default: 0)
• TARGET_HEIGHT - The height of the blockchain to end the snapshot (no default - must be set)

These can be set by creating a .env file in the root of this project. Example:

FULL_NODE_HOSTNAME=localhost DB_SOURCE_DIR=/home/freddie/chia-mount/db/ START_HEIGHT=1146800 TARGET_HEIGHT=1149800 

First you need to install dependencies:

python3 setup.py install

Then setup the database:

python3 setup_database.py 

Now you can run the snapshot generator with the following command:

python3 start.py 

Once you have populated the database with a snapshot you can run a data export with the following commands.

To generate a CSV containing all Spacebucks inner puzzle hashes and amounts:

python3 export.py --output-dir /Users/freddiecoleman/code/CAT-addresses/results/ --tail-hash 78ad32a8c9ea70f27d73e9306fc467bab2a6b15b30289791e37ab6e8612212b1 

To get individual coins:

python3 export.py --output-dir /Users/freddiecoleman/code/CAT-addresses/results/ --tail-hash 78ad32a8c9ea70f27d73e9306fc467bab2a6b15b30289791e37ab6e8612212b1 --coins 

To generate a CSV containing all CATs TAIL hashes, inner puzzle hashes and amounts:

python3 export.py --output-dir /Users/freddiecoleman/code/CAT-addresses/results/ 

To get individual coins:

python3 export.py --output-dir /Users/freddiecoleman/code/CAT-addresses/results/ --coins 

To generate multiple CSVs with each containing a specific CATs inner puzzle hashes and amounts:

python3 export.py --output-dir /Users/freddiecoleman/code/CAT-addresses/results/ --explode 

To get individual coins:

python3 export.py --output-dir /Users/freddiecoleman/code/CAT-addresses/results/ --explode --coins 

Data cleanup should only be required if the application exits half-way through a run meaning it only imports some blocks at a particular height.

This could happen if the computer crashes or there is a power cut.

The command will delete records from the database at and above a provided height.

python3 clean.py --height 2232000 

If you want to feed data into the CAT-admin-tool for use with Secure the bag you should run the following command:

python3 export.py --output-dir /Users/freddiecoleman/code/CAT-addresses/results/ --tail-hash 78ad32a8c9ea70f27d73e9306fc467bab2a6b15b30289791e37ab6e8612212b1 

The order of this data is important so don't change it. This is because your wallet will increase the range of keys used for puzzle hash discovery as puzzle hashes at greater offsets come in. If you import data in a different order you may need to change your config to increase the range of keys that your wallet is checking.