Perpetual Bond Coupon Claim Tool

WHAT IT DOES

Perpetual Bond Coupon Claim Tool is a DeFi tool that enables users to claim coupon payments from perpetual bonds. It reads the perpetual bond contract address, the user's bond holdings, coupon rate, coupon payment schedule (frequency and next payment date), accrued coupon amount, coupon claim history, account nonce, gas estimates for claim, and previous claim records. The tool then guides you through claiming the accrued coupon tokens, transferring them to your wallet, updating your claim status, and resetting the accrual counter for the next period.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the perpetual bond contract is deployed. Enter the perpetual bond contract address and the coupon token address (the token in which coupons are paid). The tool will read on-chain data and display a preview including: bond contract, coupon token, your bond holdings, coupon rate, payment frequency (monthly/quarterly/annually), next payment date, accrued coupon amount, claim history, and estimated gas. Review all details carefully. Click "claim coupon" to execute the coupon claim. The tool will guide you through three steps: verifying the accrued coupon amount, claiming coupon tokens, and updating your claim status.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the perpetual bond contract. It reads the user's bond holdings using `balanceOf(user)` on the bond token. The coupon rate is read via `getCouponRate()` which returns the annualized rate. Payment schedule is read using `getPaymentFrequency()` and `getNextPaymentDate()` view functions. The accrued coupon amount is calculated as `(holdings * couponRate * elapsedTime) / 365`, where elapsedTime is the time since the last claim. Coupon claim history is scanned using `eth_getLogs` for `CouponClaimed` events, with adaptive chunking (halving chunk size on failure) to handle different RPC limits—the tool walks backward from the current block and continues even if some ranges are rejected. The claim transaction calls `claimCoupon()` on the contract, which transfers the accrued coupon tokens to the user, updates the user's claim status, and resets the accrual counter. Gas estimates are calculated using `estimateGas` on the claim method with EIP-1559 fee data from `feeData`. All transactions are built with EIP-1559 fee data, and the tool uses `effectiveGasPrice` from receipts for accurate cost accounting.

WHAT IT CANNOT SEE

This tool cannot predict future coupon rates—rates may change over time. It cannot guarantee that the protocol will have sufficient funds for coupon payments—the protocol may run out of reserves. It cannot detect if the coupon rate is manipulated by the contract owner. It cannot ensure that the coupon payment schedule is honored—the protocol may miss payments. It cannot prevent front-running of coupon claims by other users. It cannot validate that the bond will continue to generate coupons indefinitely—the protocol may change or cease operations. It cannot verify that the bond contract is secure or free from vulnerabilities. It cannot predict changes in protocol governance that could affect coupon terms or payment schedules.

PLEASE NOTE

This tool is EVM-only and supports Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, and Avalanche. The claim transaction is signed by the connected wallet, and the user pays gas fees. Coupons accrue over time—claiming resets the accrual counter. The tool does not store or transmit any bond data. Always verify the coupon rate and payment schedule before claiming. Test on testnet before using on mainnet.