Social Recovery Wallet Tool

WHAT IT DOES

Social Recovery Wallet Tool gives wallet owners and guardians full control over social recovery configurations for smart accounts and multisig wallets. It reads on-chain recovery state including guardian addresses and their weights, the recovery threshold (minimum weight needed), pending recovery requests with timelocks, and wallet balances. You can add or remove guardians, update the threshold, initiate a recovery to a new owner address, confirm recovery as a guardian, and execute recovery after the timelock expires. The tool shows you in real time whether a guardian is active, their weight, the current threshold, guardian count, and any pending recovery—so you never have to guess or rely on event logs that only prove past registrations.

HOW TO USE

Connect your EVM wallet. Enter the social recovery wallet contract address you want to manage and the guardian address you wish to check or modify. Optionally set guardian weight (default 1) and recovery threshold. Provide a new owner address when initiating recovery. Use "Check recovery status" to see guardian status, weight, threshold, guardian count, pending recovery, and wallet balance. Click "Add guardian" to register a new guardian with a specified weight. Use "Remove guardian" to revoke an existing guardian. "Set threshold" updates the minimum weight required for recovery. "Initiate recovery" starts the recovery process to a new owner. Guardians then call "Confirm recovery" to add their approval. After sufficient confirmations and timelock expiry, "Execute recovery" finalizes the transfer. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool queries live contract state using ethers v5.7.2, not historical event logs. It calls isGuardian(), getGuardianWeight(), getThreshold(), getGuardianCount(), and getRecoveryPending() directly on the wallet contract to confirm current status, avoiding the trap of assuming a registration event means the guardian is still active. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects—digging three levels deep to avoid showing "[object Object]" when a transaction reverts. For transaction costing, it uses receipt.effectiveGasPrice post-EIP-1559 rather than tx.gasPrice, which overstates actual spend. The tool supports weighted voting where each guardian contributes a weight, and the threshold is the minimum total weight required, enabling flexible governance models from simple majority to complex multi-sig arrangements.

WHAT IT CANNOT SEE

This tool cannot detect off-chain social consensus, guardian intent, or whether guardians have agreed to participate in recovery. It cannot guarantee that guardians will actually confirm a recovery request—that depends on their individual decisions and availability. It cannot verify the security of guardian key material or whether a guardian's private keys have been compromised. It does not simulate execution or test whether the timelock has elapsed before allowing recovery. It cannot see pending recovery operations that are not yet broadcast to the public mempool, nor can it detect wallet-specific policies such as minimum guardian thresholds or custom recovery rules beyond what is stored on-chain.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. This is a read‑write tool that requires signing transactions—always verify the wallet contract address, guardian addresses, weights, threshold, and new owner before approving. No contract addresses are hardcoded; you paste the contract you are using, so you are responsible for verifying its safety and ensuring it implements the expected social recovery interface. The tool is free and open under the BotGentz PLAYBOOK‑C specification.