This command-line utility creates a snapshot of any ERC1155 token in JSON or CSV format. Use your own fully synced Ethereum node or any Ethereum node as a service like Infura.
- Works without a local Ethereum node.
- Automatically resumes the next time upon failure.
- Tested to work with Infura / QuickNode / Alchemy.
npm install token-snapshot -g
None. Prompts for user input and produces a configuration file on the first run.
Navigate to a directory where you'd like to save the token snapshot to.
cd path/to/a/directory
Run the program:
snapshot
{
"provider": "https://mainnet.infura.io/v3/<key>",
"contractAddress": "",
"fromBlock": 0,
"toBlock": "latest",
"ids": [6, 9],
"format": "json",
"blocksPerBatch": 2500,
"delay": 0,
"checkIfContract": "yes"
}
Enter your fully synced Ethereum node. Could be a local node or remote services like Infura.
Address of your ERC20 token.
The block height to scan from. To save time, enter the block number of the transaction your token was created on.
The block height to end the scan at.
Array of token ids to include in the snapshot
The format of the output file(s), either CSV
or JSON
. both
is selected by default.
The number of blocks to query per batch.
If you are using remote service like Infura, keep this number relative low (2000-5000) to avoid rate limits. If you are using a dedicated Ethereum node, you can increase this number to suit your needs.
The delay (in ms) between each request in the loop. Tweak this if you are experiencing rate limit from your provider.
Checks each address to determine whether it is a smart contract or an Ethereum wallet.
You will get your snapshot files in the newly created result/balances
folder. You can also check the detail of each block in which a tx was found in result/tx/{token Symbol}
@Pedrojok01:
> https://github.com/Pedrojok01/token-snapshot/tree/main