Smart Contract Wallet Ownership Transfer Tool

WHAT IT DOES

This tool gives you full visibility and control over the ownership state of any smart contract wallet that follows the standard two-step ownership transfer pattern (ownable with pending owner and timelock). It reads and displays the current owner address, the pending owner address (if a transfer is in progress), the ownership transfer status (idle or pending), the configured timelock delay period, and the recent ownership transfer history (last five events). Beyond read-only access, the tool lets you execute the three core ownership actions: initiate a transfer to a new address, accept ownership if you are the pending owner, or renounce ownership entirely. All actions are signed transactions submitted through your connected wallet, with clear confirmation and gas cost reporting.

HOW TO USE

Connect your EVM-compatible wallet using the top-right connect button. Select the network where your target contract is deployed. Enter the contract address of the smart contract wallet you want to inspect or manage, then click "Load Ownership State." The tool will fetch and display the current owner, pending owner, timelock delay, transfer status, and the last five transfer events. If you are the current owner, the "Initiate Transfer" and "Renounce" buttons become active — enter a new owner address and click "Initiate Transfer" to start the two-step process. If you are the pending owner, the "Accept Ownership" button will be available to finalize the transfer. Each transaction shows a confirmation prompt and reports the transaction hash and gas cost upon completion.

TECHNICAL MECHANISM — EVENT SCANNING WITH CHUNKED BACKOFF AND CONFIRMATION AGAINST STATE

Most ownership tools either query only the current state or scan logs in a single large range, both of which break under public RPC limits. This tool combines state queries with chunked log scanning for history: it fetches the current owner and pending owner via direct read calls, then retrieves ownership history by scanning for OwnershipTransferred and OwnershipTransferStarted events. The log scanner walks backwards in 10,000-block chunks and, if any chunk fails due to rate limiting or timeout, it halves the chunk size for that specific range and retries — never aborting the entire scan. A single RPC refusal cannot end the scan. Once events are retrieved, the tool confirms the current pending status by re-reading the pendingOwner() state after the scan, ensuring the displayed status reflects the latest on-chain state rather than a stale log entry.

WHAT IT CANNOT SEE

This tool cannot verify that the new owner address you enter is a secure or controlled wallet, nor that the private key is available or that the new owner actually wants ownership. It relies entirely on the caller's own address input and the contract's ownership logic. It cannot detect whether the current owner has been compromised, whether the pending owner is a malicious contract, or whether the timelock delay has been bypassed through other administrative functions. It also cannot see multi-signature requirements, guardian overrides, or other custom ownership mechanisms beyond the standard ownable pattern. The tool reports what the contract says, but does not validate intent, security, or operational readiness of any address involved.

PLEASE NOTE — EVM CHAINS ONLY

This tool supports all EVM-compatible networks that the BotSurf wallet bridge connects to — Ethereum Mainnet, Polygon, Optimism, Arbitrum, Base, and similar chains. Non-EVM chains like Solana, Cosmos, Sui, or Aptos are not supported. The contract must implement the standard ownable interface with owner(), pendingOwner(), transferOwnership(address), acceptOwnership(), and renounceOwnership() — contracts using custom ownership patterns (e.g., multi-sig, timelock controllers, or delegate-based ownership) will not display correctly. The tool is read-write: it signs transactions when you execute ownership actions. Always verify the contract address and new owner address before submitting any transaction.