Governance Proposal Bond Reclaimer

WHAT IT DOES

The Governance Proposal Bond Reclaimer enables recovery of posted governance proposal bonds after successful proposal execution, challenge expiration, or when reclamation conditions are met. It reads comprehensive state from governance contracts including proposal ID, proposal status (pending, active, executed, defeated), bond amount, bond status (posted, pending, released, forfeited), refund eligibility, reclamation eligibility, reclamation windows, forfeiture status, reclamation deadlines, platform fees, and user's bond history. Users can reclaim bonds using multiple methods: reclaimBond with amount and data, refundBond with metadata, withdrawBond for partial withdrawals, or retrieveBond with force option. The tool displays all bonds associated with the connected wallet, their status, and reclamation eligibility, providing complete visibility into recoverable funds.

HOW TO USE

Connect your Web3 wallet and paste the governance contract address. The tool never hardcodes addresses—you specify the contract you're vouching for. Enter the proposal ID to reclaim a bond from, select the reclamation method, and optionally specify the bond amount (auto-detected if left at 0). Provide optional reclamation data or reference. Check "Force reclaim" to bypass eligibility checks or "Batch reclaim multiple bonds" to recover multiple bonds in one transaction. Click "Fetch bond & reclamation state" to view proposal status, bond amount, bond status, refund eligibility, reclamation eligibility, reclamation window, forfeiture status, reclamation deadline, platform fee, and your bonds with their status. Review the displayed state and bond list carefully—reclaiming a bond recovers locked funds but may forfeit them if conditions aren't met. Click "Reclaim bond" to submit the reclamation transaction. Transaction status, gas costs, and confirmation are displayed upon completion.

MECHANICAL ADVANTAGE: COMPREHENSIVE BOND STATE AGGREGATION WITH USER BOND DISCOVERY

Unlike hardcoded governance tools that only show single bond status, this tool fetches ten different state variables in parallel using Promise.all with individual error boundaries, ensuring that a revert in one view function doesn't prevent retrieval of other critical metrics. The tool automatically discovers all bonds associated with the connected wallet by calling getUserBonds, then fetches status, amount, and reclamation eligibility for each bond (capped at 10 for performance), displaying them in a clear list for easy identification of reclaimable bonds. The tool dynamically selects the appropriate reclamation method based on user input—reclaimBond with amount and data, refundBond with metadata, withdrawBond for partial withdrawals, and retrieveBond with force option. Gas estimation factors in reclamation method complexity, and the tool uses receipt.effectiveGasPrice post-transaction for accurate cost reporting rather than relying on the pre-EIP-1559 gasPrice cap. Reclamation windows and deadlines are displayed prominently, enabling timely recovery of posted bonds.

WHAT IT CANNOT SEE

This tool cannot verify that the governance contract is legitimate or has not been compromised. It cannot detect if the reclamation parameters have been manipulated or if the contract has been upgraded or modified. Reclamation may not execute at optimal gas price due to network conditions or succeed if the contract is paused or frozen. The tool cannot recover funds if execution fails due to contract bugs or insufficient approval. It cannot verify that reclamation parameters are valid, predict gas prices during congestion, or detect if the reclamation has been front-run. The tool cannot ensure that the bond will be refunded, verify off-chain proposal validity, or provide legal or governance advice. It cannot guarantee that the bond is reclaimable, verify the correctness of the proposal, ensure that all reclamation conditions are met, or track bond status outside of the tool. Reclamation windows are time-sensitive—missing the window may result in bond forfeiture.

PLEASE NOTE

This tool operates on EVM-compatible chains only. It reads from and writes to governance contracts but provides no legal or governance advice. All reclamation decisions remain your responsibility. Always verify contract addresses, proposal IDs, and reclamation parameters before submitting transactions. The tool displays current state but does not automatically reclaim—you must review and confirm each transaction through your wallet. Gas costs vary by network conditions; the tool estimates but cannot guarantee optimal pricing. Reclamation windows are typically time-limited—ensure you reclaim bonds within the allowed window to avoid forfeiture. Understanding the specific reclamation conditions and forfeiture rules for each governance contract is essential before attempting to reclaim a bond.