Prediction Market Redemption Tool

WHAT IT DOES

This tool enables prediction market participants to redeem their winning shares after a market has been resolved. Redemption converts shares into their payout value, allowing users to claim their winnings. The redemption value is determined by the market's final outcome and the share's payout ratio. It connects to your wallet and reads the prediction market contract address, market ID, share balance, redemption value, outcome status, redemption history, and timestamps. The tool signs and submits transactions to redeem winning shares, claim payouts, update redemption status, record redemption metadata, and emit redemption 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 prediction market contract deployment.

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

4. Click "fetch redemption status" to retrieve your share balance, redemption value per share, and the market's outcome status.

5. Review the outcome status — you can only redeem shares if the market is resolved.

6. Check your share balance and the redemption value to calculate your expected payout.

7. Click "validate redemption" to verify that you have shares to redeem and the market is resolved.

8. Click "check redemption history" to view your past redemptions for this market.

9. Review the share balance, redemption value, and expected payout before executing.

10. Click "redeem shares" to sign and submit the transaction that converts your shares into their payout value.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible prediction market contract that implements a standard redemption interface (getShareBalance(address, uint256) view returns (uint256), getRedemptionValue(uint256) view returns (uint256), getOutcomeStatus(uint256) view returns (uint8), redeem(uint256) external, getRedemptionHistory(address, uint256) view). The getShareBalance view returns the number of shares held by the user for a specific market. The getRedemptionValue view returns the payout per share in the payout token (usually the same as the collateral token). The redeem function validates that the market is resolved, the caller has shares, and the redemption value is positive, then transfers the payout amount to the caller and burns the shares. The contract typically emits a Redeemed event when shares are redeemed. The getRedemptionHistory view provides a full audit trail of redemptions for each user and market. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Redemption 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 outcome accuracy — it does not check whether the market resolution is factually correct or based on accurate information. It cannot validate redemption eligibility — the tool cannot confirm that the user is entitled to redeem the shares or that the shares are valid. It cannot detect fraudulent claims — the tool cannot identify attempts to redeem shares that were not legitimately acquired or that are subject to restrictions. It cannot ensure fair payout — the tool does not verify that the redemption value is correct or that the payout calculation is accurate. The tool also cannot verify that outcomes are correct — it relies on the market's resolution mechanism and does not independently verify the outcome.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the prediction market contract to implement the redemption 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. Redemption is typically only available after the market has been resolved — ensure the market is resolved before attempting to redeem. The redemption value may be zero if the market resolved against your position. Always verify the redemption value and payout amount before executing. Consider waiting for the market resolution to be confirmed before redeeming to avoid disputes.