Paymaster Deposit Top-Up Tool

WHAT IT DOES

The Paymaster Deposit Top-Up Tool enables management of paymaster contract deposits for account abstraction gas sponsorship. It reads comprehensive state from paymaster and entry point contracts including deposit balance, stake amount, minimum deposit requirements, deposit status, stake status, paymaster owner, authorization status, platform fees, and deposit history. Users can top up deposits using multiple methods: topUpPaymaster with stake option, depositPaymaster for standard deposits, addFunds with stake support, or increaseStake for stake-only increases. The tool displays current balance, stake, minimum deposit, and deposit history, providing full visibility into paymaster funding status.

HOW TO USE

Connect your Web3 wallet and paste the paymaster contract address and optionally the entry point contract address. The tool never hardcodes addresses—you specify the contract you're vouching for. Select the top-up method, enter the amount in native currency, and optionally check "Stake deposit" to increase the paymaster's stake (required for certain account abstraction features) or "Approve token spending" if using token-based deposits. Click "Fetch paymaster state" to view deposit balance, stake amount, minimum deposit, deposit status, stake status, paymaster owner, authorization status, platform fee, and deposit history. Review the displayed state carefully—topping up a paymaster ensures it has sufficient funds to sponsor gas for user operations. Click "Top up deposit" to submit the deposit transaction. The transaction sends the specified amount to the paymaster contract. Transaction status, gas costs, and confirmation are displayed upon completion.

MECHANICAL ADVANTAGE: COMPREHENSIVE PAYMASTER STATE AGGREGATION WITH DEPOSIT HISTORY DISCOVERY

Unlike hardcoded deposit tools that only show current balance, 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 deposit history by iterating through deposit event indices until it hits empty entries (capped at 10 for performance), displaying depositor addresses, amounts, and status for full transparency. The tool dynamically selects the appropriate deposit method based on user input—topUpPaymaster with stake option, depositPaymaster for standard deposits, addFunds with stake support, and increaseStake for stake-only increases. Gas estimation factors in deposit method complexity and value transfer, and the tool uses receipt.effectiveGasPrice post-transaction for accurate cost reporting rather than relying on the pre-EIP-1559 gasPrice cap. Native balance checks ensure sufficient funds before sending, preventing failed transactions due to insufficient balance.

WHAT IT CANNOT SEE

This tool cannot verify that the paymaster contract or entry point contract is legitimate or has not been compromised. It cannot detect if the top-up parameters have been manipulated or if the contracts have been upgraded or modified. Top-up 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 top-up parameters are valid, predict gas prices during congestion, or detect if the top-up has been front-run. The tool cannot ensure that the deposit will be used for gas sponsorship, provide financial or security advice, guarantee that the paymaster will operate correctly, verify off-chain deposit tracking, ensure that the paymaster has sufficient funds for operations, or track deposit status outside of the tool. Deposits are sent to the paymaster contract and become contract funds—they may not be directly withdrawable.

PLEASE NOTE

This tool operates on EVM-compatible chains only. It reads from and writes to paymaster contracts but provides no financial or security advice. All top-up decisions remain your responsibility. Always verify contract addresses and deposit amounts before submitting transactions. The tool displays current state but does not automatically top up—you must review and confirm each transaction through your wallet. Gas costs vary by network conditions; the tool estimates but cannot guarantee optimal pricing. Deposits are made in native currency—ensure you have sufficient balance to cover both the deposit and gas. Staking may be required for certain paymaster features—verify the stake requirements for your specific paymaster implementation.