Social Recovery Guardian Rotation Tool

WHAT IT DOES

The Social Recovery Guardian Rotation Tool enables secure management of guardians for social recovery wallets. It reads comprehensive state from social recovery wallet contracts including wallet address, current guardian list with addresses and weights, guardian threshold requirements, rotation eligibility, proposal status (pending, approved, executed, failed), approval counts, required approvals, execution delays, platform fees, and guardian confirmation status. Users can rotate guardians using multiple methods: rotateGuardian with remove/add addresses and threshold, proposeGuardianRotation for proposal creation, executeGuardianRotation to execute an approved proposal, or confirmRotation to approve a pending proposal. The tool displays current guardians with their active status and weights, providing complete visibility into wallet security configuration.

HOW TO USE

Connect your Web3 wallet and paste the social recovery wallet contract address. The tool never hardcodes addresses—you specify the contract you're vouching for. Enter the guardian address to remove and the guardian address to add (for rotation operations), set the guardian threshold, and optionally specify a proposal ID for confirm/execute operations. Select the rotation method (rotateGuardian, proposeGuardianRotation, executeGuardianRotation, or confirmRotation). Check "Approve token spending" to handle approvals automatically, "Force rotation" to bypass checks, or "Batch rotation" for multiple guardian changes. Click "Fetch guardian state" to view wallet address, guardian count, threshold, rotation eligibility, proposal status, approval count, required approvals, execution delay, platform fee, and the full list of current guardians with their addresses, weights, and active status. Review the displayed guardian list and state carefully—guardians have the ability to initiate recovery of your wallet. Click "Execute rotation" to submit the rotation transaction. Transaction status, gas costs, and confirmation are displayed upon completion.

MECHANICAL ADVANTAGE: COMPREHENSIVE GUARDIAN STATE AGGREGATION WITH GUARDIAN LIST DISCOVERY

Unlike hardcoded wallet tools that only show guardian count, this tool fetches nine 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 guardians by iterating through guardian indices until it hits empty entries (capped at 20 for performance), displaying addresses, weights, and active status for complete transparency. The tool dynamically selects the appropriate rotation method based on user input—rotateGuardian for immediate rotation, proposeGuardianRotation for proposal creation, executeGuardianRotation for execution, and confirmRotation for approvals. Gas estimation factors in rotation method complexity, and the tool uses receipt.effectiveGasPrice post-transaction for accurate cost reporting rather than relying on the pre-EIP-1559 gasPrice cap. Guardian thresholds, approval counts, and proposal status are displayed prominently, enabling informed security management.

WHAT IT CANNOT SEE

This tool cannot verify that the social recovery wallet contract is legitimate or has not been compromised. It cannot detect if the guardian rotation parameters have been manipulated or if the contract has been upgraded or modified. Rotation 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 rotation parameters are valid, predict gas prices during congestion, or detect if the rotation has been front-run. The tool cannot ensure that the rotation will be approved, verify off-chain guardian identity, or provide legal or security advice. It cannot guarantee that the new guardians are trustworthy, verify the correctness of guardian details, ensure that all approvals will be received, or track rotation status outside of the tool. Guardian rotation is a critical security operation—changing guardians affects wallet recovery capabilities.

PLEASE NOTE

This tool operates on EVM-compatible chains only. It reads from and writes to social recovery wallet contracts but provides no legal or security advice. All guardian rotation decisions remain your responsibility. Always verify contract addresses, guardian addresses, and thresholds before submitting transactions. The tool displays current state but does not automatically rotate—you must review and confirm each transaction through your wallet. Gas costs vary by network conditions; the tool estimates but cannot guarantee optimal pricing. Guardian rotation typically requires approval from existing guardians—ensure you have the required number of approvals before execution. Understanding the specific guardian rotation rules and approval process for each social recovery wallet implementation is essential before making changes.