Snapshot to Claim Contract Builder

WHAT IT DOES

Snapshot to Claim Contract Builder lets you turn a token holder snapshot into a fully functional merkle-based claim contract. You provide a list of addresses and their allocated amounts—for example, from a token distribution, airdrop, or reward program—and the tool generates a merkle root from the data. It then deploys a claim contract that allows recipients to verify their eligibility and claim their tokens by submitting a merkle proof. This eliminates the need for individual approve-and-transfer transactions, saving gas and simplifying the distribution process.

HOW TO USE

Connect your EVM wallet and select the network. Enter the token contract address you want to distribute. In the snapshot input area, list each recipient on a new line using the format: address,amount (amount in wei). Click "Generate merkle root" to compute the merkle tree and root hash from your snapshot data—the tool displays the root and the total number of recipients. Review the root, then click "Deploy claim contract" to deploy a MerkleClaim contract on-chain with the generated root. The contract is ready for recipients to claim their tokens using their address and proof.

TECHNICAL MECHANISM

The tool builds a merkle tree from the snapshot data using keccak256 hashing. Each leaf is computed as keccak256(abi.encodePacked(address, amount)). The leaves are sorted deterministically and the tree is constructed using the merkletreejs library. The root is stored in the deployed claim contract, which implements a claim function that verifies a user-supplied merkle proof against the root. The contract also includes a withdraw function for the owner to recover any unclaimed tokens after the claim period ends. The deployment transaction is submitted via the connected wallet, and the tool reports the contract address and transaction hash upon success.

WHAT IT CANNOT SEE

This tool cannot generate merkle roots or proofs without external snapshot data—it requires the user to provide the list of addresses and amounts. It does not read historical blockchain state directly; the snapshot must be pre-computed and provided as input. The tool cannot guarantee that the snapshot data reflects current on-chain holdings, as balances may have changed since the snapshot was taken. It also cannot detect or handle tokens with non-standard transfer or claim logic beyond the standard ERC-20 interface.

PLEASE NOTE

The deployed claim contract uses a merkle root that is immutable after deployment—you cannot update the snapshot once the contract is on-chain. Ensure your snapshot data is accurate and complete before deploying. Recipients will need the merkle proof for their address to claim; the tool does not generate individual proofs automatically (you would need to provide them separately or through a separate interface). The contract includes a safety period check and a withdraw function for unclaimed tokens. This tool is for EVM chains only and does not support non-EVM networks.