Smart Account Factory

WHAT IT DOES

Smart Account Factory gives developers and users comprehensive control over guardian-managed smart accounts and wallet contracts. It reads live on-chain state including guardian addresses and weights, recovery thresholds, pending recovery requests with timelocks, guardian voting status, approval counts, and wallet balances. You can deploy new smart accounts, add or remove guardians, update guardian weights, adjust recovery thresholds, initiate recovery to a new owner, approve or reject recovery proposals as a guardian, and execute recovery after sufficient approvals. The tool shows you in real time whether a guardian is active, their weight, the current threshold, guardian count, pending recovery details, and current approval weight—so you never have to guess or rely on event logs that only prove past actions.

HOW TO USE

Connect your EVM wallet. Enter the smart account or wallet contract address you want to manage and the guardian address you wish to check or modify. Set guardian weight (default 1) and recovery threshold. Provide a new owner address when initiating recovery. Use "Check status" to see guardian status, weight, threshold, guardian count, pending recovery, approval weight, and wallet balance. Click "Add guardian" to register a new guardian with a specified weight. Use "Remove guardian" to revoke an existing guardian. "Update weight" changes a guardian's voting power. "Set threshold" updates the minimum weight required for recovery. "Initiate recovery" starts the recovery process to a new owner. Guardians then call "Approve recovery" to add their weight or "Reject recovery" to block the proposal. After sufficient approval weight is reached, "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(), getRecoveryPending(), and getRecoveryApprovals() directly on the wallet contract to confirm current status—avoiding the trap of assuming a registration event means the guardian is still active or that approvals exist. 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 for recovery approval, enabling flexible governance from simple majority to complex multi-sig arrangements with veto power.

WHAT IT CANNOT SEE

This tool cannot detect off-chain guardian intent, coordination, or compromise. It cannot guarantee that guardians will participate in governance or recovery decisions—that depends on their individual choices 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 threshold has been met 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. The tool manages guardian configurations and recovery flows, but it does not guarantee that guardians will act 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, 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 guardian interface. The tool is free and open under the BotGentz PLAYBOOK‑C specification.