Social Impact Token Redemption Tool

WHAT IT DOES

Social Impact Token Redemption Tool is a DeFi tool that enables users to redeem their social impact tokens for reward assets. It reads the social impact token contract address, redemption contract address, the user's token balance, redemption rate (exchange rate with the reward asset), redemption limits, reward 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 reward asset, burning the redeemed tokens, transferring the reward 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 social impact token and redemption contracts are deployed. Enter the social impact token contract address, redemption contract address, the amount you wish to redeem, and the reward asset address (use address(0) for native currency). The tool will read on-chain data and display a preview including: social impact token, redemption contract, redeem amount, reward asset, your token balance, redemption rate, redemption limits, reward 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 reward assets, and recording the redemption.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the social impact 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 the reward asset. Redemption limits are read via `getMinRedemption()` and `getMaxRedemption()`. Reward asset balance is read via `getRewardBalance()` or `balanceOf()` on the reward 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 reward 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 social impact goals were actually achieved—it reads only the token balance. It cannot detect if impact metrics are being misrepresented. It cannot guarantee that the reward asset is available—the reward balance must be sufficient. It cannot prevent front-running of redemptions. It cannot validate that the redemption rate is fair. 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 reward asset has enough liquidity for the redemption. The tool does not store or transmit any token or redemption data.