Lost Wallet Recovery Initiator

WHAT IT DOES

This tool initiates recovery of lost wallets, allowing authorized parties to transfer control from a lost wallet to a recovery wallet. It reads and displays the lost wallet address, recovery wallet address, recovery eligibility (whether the caller is authorized to initiate), recovery status (pending, initiated, completed, or cancelled), account balance, chain ID, recovery history (number of past recoveries), and recovery threshold (minimum number of initiations required). Beyond read-only access, the tool lets you execute the five key actions: initiate recovery of a lost wallet, approve a recovery initiation (if required), batch initiate 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, lost wallet address, recovery wallet address, and type "RECOVER" in the confirmation field. Click "Load State" to fetch the recovery status, eligibility, threshold, and recovery history. Review the lost wallet, recovery wallet, and recovery status. If you are eligible and have sufficient balance, click "Initiate Recovery" to start the recovery process. If the contract requires explicit approval, click "Approve" first. To initiate multiple recoveries at once, click "Batch Initiate." 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 recovery contract that manages lost wallet recovery. The initiateRecovery() function starts the recovery process, transferring control from the lost wallet to the recovery wallet. The contract validates that the caller is eligible and that the recovery is pending. The recoveryStatus() function returns the current state (0 = pending, 1 = initiated, 2 = completed, 3 = cancelled). The recoveryThreshold() function returns the minimum number of initiations required. Batch initiation uses initiateBatch() with arrays of lost and recovery wallets. The tool fetches recovery history via recoveryHistory().

WHAT IT CANNOT SEE

Cannot verify that the wallet is genuinely lost or that the recovery is authorized. Relies entirely on the recovery contract's verification and the destination chain's final state. Cannot detect if the wallet is not actually lost, if the recovery is being initiated 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 recoveryStatus(), recoveryEligible(), recoveryThreshold(), initiateRecovery(), approveRecovery(), initiateBatch(), claimRecovery(), cancelRecovery(), and recoveryHistory(). The tool is read-write: it signs transactions for initiation, approval, batch initiation, claiming, and cancellation. Always verify the contract address and wallet addresses before submitting. Recovery initiation requires explicit confirmation.