Local Currency Token Redemption Tool

WHAT IT DOES

Local Currency Token Redemption Tool is a DeFi tool that enables users to redeem local currency tokens for a reserve asset (e.g., stablecoin, fiat-backed token, or native currency). It reads the local currency token contract address, redemption contract address, the user's token balance, redemption rate (exchange rate with the reserve asset), redemption limits (minimum and maximum), reserve asset balance, redemption history, account nonce, gas estimates for redemption, and previous redemption records. The tool then guides you through redeeming your tokens for the reserve asset, burning the redeemed tokens, transferring the reserve asset to your wallet, updating the token supply, and recording the redemption on-chain.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the local currency token and redemption contracts are deployed. Enter the local currency token contract address, redemption contract address, the amount you wish to redeem, and the reserve asset address (use address(0) for native currency). The tool will read on-chain data and display a preview including: local currency token, redemption contract, redeem amount, reserve asset, your token balance, redemption rate, redemption limits, reserve balance, the amount you will receive, and estimated gas. Review all details carefully. Click "redeem tokens" to execute the redemption. The tool will guide you through three steps: verifying balance and limits, burning tokens and transferring reserve assets, and recording the redemption.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the local currency token and redemption contracts. It reads the user's token balance using `balanceOf(user)` on the token contract. The redemption rate is read via `getRedemptionRate()` which returns the current exchange rate between the token and reserve asset. Redemption limits are read via `getMinRedemption()` and `getMaxRedemption()`. Reserve asset balance is read via `getReserveBalance()` or `balanceOf()` on the reserve asset contract. Redemption history is scanned using `eth_getLogs` for `TokensRedeemed` 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 redemption transaction calls `redeem(amount)` on the redemption contract, which burns the tokens, transfers the reserve asset to the user, and updates the token supply. Gas estimates are calculated using `estimateGas` 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 verify that the local currency is backed by sufficient reserves—it reads only the reserve balance. It cannot detect if reserve assets are being misused. It cannot guarantee that the redemption rate is fair—the rate is set by the contract. It cannot prevent front-running of redemptions. It cannot validate that token supply is accurately tracked. It cannot detect if the redemption contract has been modified. It cannot ensure that redemption limits are appropriate. It cannot verify that redemption terms are enforced off-chain.

PLEASE NOTE

This tool is EVM-only and supports Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, and Avalanche. The redemption transaction is signed by the connected wallet, and the user pays gas fees. Ensure you have sufficient token balance and that the reserve asset has enough liquidity for the redemption. The tool does not store or transmit any token or redemption data.