Guardian-Approved Recovery Executor

WHAT IT DOES

This tool executes guardian-approved wallet recoveries, allowing authorized parties to transfer wallet ownership after guardian approval. It reads and displays recovery proposal details (target wallet address, new owner address, proposer, and number of guardian approvals), approval eligibility (whether the caller is authorized to execute), recovery status (pending, approved, executed, or cancelled), executor balance, chain ID, recovery history (number of past recoveries), and approval threshold (minimum number of guardian approvals required). Beyond read-only access, the tool lets you execute the five key actions: execute a guardian-approved wallet recovery, approve a recovery execution (if required), batch execute multiple recoveries in one transaction, claim recovery confirmation, and cancel a pending recovery.

HOW TO USE

Connect your wallet and select the network. Enter the recovery contract address, proposal ID, and type "EXECUTE" in the confirmation field. Click "Load State" to fetch the target wallet, new owner, guardian approvals, proposer, recovery status, eligibility, threshold, and recovery history. Review the proposal details, guardian approvals, and recovery status. If the required guardian approvals have been met and you are eligible, click "Execute Recovery" to complete the wallet recovery. If the contract requires explicit approval, click "Approve" first. To execute multiple recoveries at once, click "Batch Execute." Click "Claim" to confirm a completed recovery, or "Cancel" to cancel a pending recovery. Each transaction shows confirmation and gas cost reporting.

TECHNICAL MECHANISM

The tool interacts with a guardian recovery contract that manages wallet recoveries with guardian approval. The executeRecovery() function completes the recovery process, transferring wallet ownership to the new owner after sufficient guardian approvals. The contract validates that the caller is eligible and that the recovery is pending. The recoveryStatus() function returns the current state (0 = pending, 1 = approved, 2 = executed, 3 = cancelled). The approvalThreshold() function returns the minimum number of guardian approvals required. Batch execution uses executeBatch() with an array of proposal IDs. The tool fetches recovery history via recoveryHistory().

WHAT IT CANNOT SEE

Cannot verify that the recovery is justified or that the guardians have properly approved it. Relies entirely on the recovery contract's verification and the destination chain's final state. Cannot detect if the guardians were coerced, if the recovery is being executed maliciously, or if the recovery is being performed by an unauthorized party.

PLEASE NOTE — EVM CHAINS ONLY

Supports Ethereum, Polygon, Optimism, Arbitrum, Base and similar EVM chains. The recovery contract must implement targetWallet(), newOwner(), guardianApprovals(), proposer(), recoveryStatus(), approvalEligible(), approvalThreshold(), executeRecovery(), approveRecovery(), executeBatch(), claimRecovery(), cancelRecovery(), and recoveryHistory(). The tool is read-write: it signs transactions for execution, approval, batch execution, claiming, and cancellation. Always verify the contract address and proposal ID before submitting. Execution requires explicit confirmation.