Seigniorage Share Claim Tool

WHAT IT DOES

This tool provides on-chain claiming of seigniorage shares, enabling you to claim your proportional share of seigniorage revenue from a protocol. It reads your connected wallet address, seigniorage contract address, user address, claimable amount, total seigniorage, claim status, current block timestamp, claim history, and share percentage. You can then sign and send transactions to claim your seigniorage shares and record claim metadata on-chain. All seigniorage parameters are displayed in a clear review panel before you sign, so you know exactly what you are claiming. The tool also logs transaction hashes, confirmation status, and gas costs, providing a complete audit trail of all claim activities.

HOW TO USE

Connect your wallet using the built-in wallet bridge, choose the network that matches your seigniorage contract, and paste the seigniorage contract address and user address. Enter the token decimals for display purposes. The review panel shows all inputs, your claimable amount, total seigniorage, share percentage, and claim status before you sign. Use the numbered action buttons: check claim to view your current claimable amount, total seigniorage, share percentage, claim status, and claim history; or claim share to claim your seigniorage share. You can also view claim history to see all past claim timestamps for your address. Each transaction is signed sequentially, and the tool displays transaction details and confirmation status.

THE REAL MECHANISM

This tool uses ethers.js v5.7.2 to build and send transactions through the wallet's signer. It does not rely on any hardcoded contract addresses – you paste the seigniorage contract you are using, so you are in full control. When you claim seigniorage, the tool constructs a contract call to the claimSeigniorage function, which transfers your claimable amount from the contract to your wallet. The tool reads state via claimableAmount, totalSeigniorage, sharePercentage, claimStatus, and getClaimHistory view functions. The claimableAmount represents the seigniorage revenue you are entitled to based on your share percentage. The claimStatus indicates whether you have already claimed your share. All transactions are sequential to prevent nonce conflicts, and gas costs are calculated using effectiveGasPrice for accurate post-EIP-1559 reporting.

WHAT IT CANNOT SEE

This tool cannot verify off-chain seigniorage calculations, predict future seigniorage, detect contract vulnerabilities, or ensure that the seigniorage contract handles claims correctly. It cannot detect if the seigniorage calculation is accurate or if the contract has vulnerabilities. The tool also cannot verify that the seigniorage contract correctly handles edge cases like claim eligibility, share updates, or payment failures. It cannot simulate the outcome of a transaction before you sign it, nor can it guarantee that the claim will be processed correctly if the contract is not properly implemented.

PLEASE NOTE

This tool works only on EVM-compatible chains supported by your wallet and provider. Always double-check the contract addresses and user addresses before signing. Use testnet first. The tool is a transaction-signing interface and claim management tool, not a seigniorage calculation or contract security verification system.