ERC-2981 Royalty Info Setter

WHAT IT DOES

This tool enables NFT creators, artists, and rights holders to set and manage ERC-2981 royalty information for their NFTs. ERC-2981 is a standard for royalty payments in NFTs, allowing creators to specify a royalty recipient and percentage that should be paid on secondary sales. Marketplaces and dApps can read this information to enforce creator royalties. It connects to your wallet and reads the NFT contract address, token ID, royalty recipient, royalty basis points, current royalty info, royalty history, and timestamps. The tool signs and submits transactions to set royalty info, update royalty recipient, update basis points, record royalty metadata, and emit royalty events.

HOW TO USE

1. Connect your wallet using the wallet bridge (supports MetaMask, WalletConnect, and other EVM-compatible wallets).

2. Select the target network that matches your NFT contract deployment.

3. Enter the NFT contract address and the token ID, then click "load contract" to initialize the connection.

4. Click "fetch royalty info" to retrieve the current royalty recipient and basis points.

5. Review the current royalty settings displayed on the page.

6. Enter the royalty recipient address and the royalty basis points (1 bp = 0.01%, max 10000 = 100%).

7. Click "validate royalty" to verify that the recipient address is valid and the basis points are within the allowed range.

8. Click "check royalty history" to view the complete history of royalty changes for this token.

9. Review the royalty details including recipient, basis points, and percentage before executing.

10. Click "set royalty info" to sign and submit the transaction that updates the royalty information on-chain.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible NFT contract that implements the ERC-2981 standard interface (royaltyInfo(uint256, uint256) view returns (address, uint256), setRoyaltyInfo(uint256, address, uint256) external, getCurrentRoyalty(uint256) view returns (address, uint256), getRoyaltyHistory(uint256) view). The setRoyaltyInfo function updates the royalty recipient and basis points for a specific token ID. Only the token owner or authorized operator can call this function. The royaltyInfo view function returns the royalty recipient and amount for a given token ID and sale price, which marketplaces use to calculate royalties. The contract typically emits a RoyaltyInfoUpdated event when changes are made. The getCurrentRoyalty view returns the current recipient and basis points, while getRoyaltyHistory provides a complete audit trail. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Royalty metadata is recorded both in the contract's history and locally for the user's reference.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify off-chain royalty agreements — it does not check that the royalty recipient is entitled to receive royalties or that the basis points were agreed upon. It cannot validate recipient entitlement — the tool cannot confirm that the recipient actually holds the rights to the NFT or that they created the work. It cannot detect royalty disputes — the tool cannot identify conflicts between multiple parties claiming rights. It cannot ensure fair royalty distribution — the tool does not verify that the basis points are appropriate or that the recipient is the correct one. The tool also cannot verify that recipients actually hold rights — all royalty data is accepted as entered and is not validated against off-chain records.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the NFT contract to implement the ERC-2981 interface described above. All transactions incur gas fees paid by the connected wallet. The tool maintains no persistent storage — all state is refreshed from the blockchain on each session. Setting royalty info is an important decision that affects future sales — ensure the recipient address and basis points are correct before executing. Once set, the royalty info can be changed by the token owner or authorized operator, but changes should be made carefully to avoid confusion. Consider consulting legal advice before setting royalty rates, especially for high-value NFTs.