Recovery Key Generator

WHAT IT DOES

Recovery Key Generator gives wallet owners and developers direct control over recovery key management for smart accounts and multisig wallets. It reads on-chain recovery contract state, including whether a recovery key is currently active, the configured timelock period, pending recovery requests, and wallet balances. You can register a new recovery key with a configurable timelock delay, revoke an existing recovery key, update the timelock parameter, and execute a pending recovery flow. The tool shows you in real time whether a recovery key is valid, how long the timelock is, and whether a recovery is currently pending—so you never have to guess or rely on event logs that only prove a registration happened at some point in the past.

HOW TO USE

Connect your EVM wallet. Enter the wallet or account contract address you want to manage and the recovery key address you wish to register, revoke, or check. Optionally provide a guardian address if your wallet supports social recovery configurations. Set the timelock in seconds—for example, 86400 for one day or 0 for no delay. Use "Check recovery status" to see if the key is active, the current timelock, and any pending recovery. Click "Register recovery key" to add a new key with the specified timelock. Use "Revoke recovery key" to immediately invalidate a key. The "Set timelock" button updates the delay period for future recovery operations, and "Execute recovery" finalizes a pending recovery after the timelock has elapsed. Each action generates a transaction you review and sign in your wallet. After confirmation, the tool refreshes recovery status and wallet balances automatically.

TECHNICAL APPROACH

This tool queries live contract state using ethers v5.7.2, not historical event logs. It calls isRecoveryKey() directly on the wallet contract to confirm whether a key is currently active, avoiding the trap of assuming a registration event means the key is still valid. It reads getRecoveryTimelock() and getRecoveryPending() to show the current delay period and any in-progress recovery requests. 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. When registering a key, the tool sends the timelock as a uint256 parameter directly to the contract, allowing precise control over recovery delays.

WHAT IT CANNOT SEE

This tool cannot detect off-chain recovery intent, social recovery consensus, or whether the recovery key material has been securely stored or compromised. It cannot guarantee that a registered recovery key will be honored by the wallet contract in all edge cases—that depends on the contract's own validation logic, guardian requirements, and any additional off-chain checks. 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 multi-signature requirements. The tool manages recovery key registrations, but it does not guarantee that the wallet contract will execute recovery as expected.

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, recovery key address, and timelock 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 recovery interface. The tool is free and open under the BotGentz PLAYBOOK‑C specification.