Creator Royalty Claimer

WHAT IT DOES

Creator Royalty Claimer connects to any EVM-based creator royalty contract and enables you to claim accrued royalty payments with a single click. The tool reads comprehensive contract state including total royalties accrued, token address, creator/beneficiary address, royalty pool balance, claimable amount per creator, royalty distribution parameters, claim window, current block timestamp, claim history, royalty rate parameters, and platform fee share. It then displays your claimable amount, the royalty pool balance, the current royalty rate, platform fee percentage, claim window status, and whether you have already claimed. When royalties are available and you are the authorized creator, the tool enables a one-click claim transaction. The tool handles multiple claim function signatures (claimRoyalties, withdrawEarnings, executeClaim) and automatically detects the correct function to call. After submission, the tool displays the transaction hash and refreshes the contract data to show the updated claim status. This is ideal for musicians, artists, content creators, and any creator economy participants who need to track and withdraw their on-chain royalty earnings.

HOW TO USE

Connect your Web3 wallet (MetaMask, WalletConnect, or any EIP-1193 provider). Select the correct network for your royalty contract — the tool supports Ethereum, Polygon, Arbitrum, Optimism, Base, Avalanche C-Chain, and BNB Chain. Paste your royalty contract address into the input field. The tool reads the contract using a default ABI that covers standard royalty functions, but you can paste a custom ABI if your contract uses non-standard naming. Review the displayed data carefully: your claimable amount, token type, royalty pool balance, royalty rate percentage, platform fee percentage, claim window, and whether you have already claimed. The status indicator will show "Ready to claim" when you have claimable royalties, "Claimed" if you have already withdrawn, "No royalties" if nothing is available, or "Not your royalty" if you are not the authorized creator for that contract. When royalties are available and you are the creator, the "Claim royalties" button becomes enabled. Click it to submit the claim transaction — the tool will show a confirmation dialog with all details, submit the transaction, and wait for confirmation. After successful execution, the contract data refreshes automatically to show the updated claim status.

THE REAL MECHANISM

This tool does not assume a single royalty structure — it adapts to the contract's actual implementation. It first detects the correct claim function by testing common names (claimRoyalties, withdrawEarnings, executeClaim) through static calls, falling back to the user-provided name if none are found. For royalty data, the tool reads claimableAmount(yourAddress) to determine what you are owed, token() to identify the payment currency, royaltyPool() to check the total available funds, royaltyRate() and platformFee() to display the fee structure, claimWindow() to show the claim period, and hasClaimed(yourAddress) to prevent duplicate claims. The tool also reads creator(yourAddress) to verify that you are the authorized creator before enabling the claim button. This multi-step verification ensures you only attempt to claim when funds are actually available and you are the correct recipient. The tool auto-refreshes data after each claim to keep the display current. All transaction parameters are estimated using eth_estimateGas and sent with the wallet's preferred gas strategy. The tool monitors the transaction receipt and extracts the effectiveGasPrice to display actual gas cost, not the cap. For ERC-20 royalty payments, the tool reads the token address and displays it clearly.

WHAT IT CANNOT SEE

Creator Royalty Claimer cannot verify that royalty calculations are accurate or fairly determined by the platform. It cannot detect if the royalty rate has been changed without notice or if the platform has adjusted rates retroactively. It cannot guarantee that the royalty pool contains sufficient funds for all creators or that funds will be available when you claim. It cannot ensure that the royalty contract has not been upgraded, modified, or paused by its owner. It cannot prevent the platform from pausing, adjusting, or cancelling royalty payments at any time. It cannot recover funds if the claim transaction fails due to contract bugs, out-of-gas errors, or network conditions. It cannot verify that the platform is accurately tracking all revenue streams or that the revenue data is correct. It cannot detect if the royalty contract is malicious, contains hidden fee structures, or has been deployed by an untrusted party. It cannot verify that your royalty entitlement has been properly registered or that you are the correct beneficiary.

PLEASE NOTE — EVM CHAINS ONLY

This tool works exclusively with EVM-compatible blockchains. Non-EVM chains are not supported. The tool does not deploy contracts, manage private keys, or sign anything outside the connected wallet's secure environment. It is a read-and-execute interface that relies entirely on the royalty contract's implementation and the royalty distribution logic defined therein. Always verify the royalty contract address and royalty rate directly on-chain before claiming.