Paymaster Deposit Withdrawal Tool

WHAT IT DOES

The Paymaster Deposit Withdrawal Tool enables secure withdrawal of funds from paymaster contracts used for account abstraction gas sponsorship. It reads comprehensive state from paymaster and entry point contracts including deposit balance, stake amount, withdrawal eligibility, withdrawal limits (minimum and maximum), withdrawal windows, withdrawal frequency, deposit status, stake status, paymaster owner, platform fees, and withdrawal history. Users can withdraw deposits using multiple methods: withdrawPaymaster with stake option, withdrawDeposit for standard withdrawals, reclaimFunds with force option, or withdrawStake for stake-only withdrawals. The tool displays current balance, stake, withdrawal eligibility, limits, windows, and withdrawal history, providing full visibility before withdrawing paymaster funds.

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 withdrawing from. Select the withdrawal method, enter the amount in native currency, and optionally specify a recipient address (defaults to connected wallet). Check "Approve token spending" if using token-based withdrawal, "Force withdrawal" to bypass eligibility checks, or "Withdraw stake" to withdraw staked funds separately. Click "Fetch paymaster state" to view deposit balance, stake amount, withdrawal eligibility, withdrawal limits, withdrawal window, deposit status, stake status, paymaster owner, platform fee, and withdrawal history. Review the displayed state carefully—withdrawing from a paymaster may affect its ability to sponsor gas. Click "Withdraw" to submit the withdrawal transaction. Transaction status, gas costs, and confirmation are displayed upon completion.

MECHANICAL ADVANTAGE: COMPREHENSIVE PAYMASTER STATE AGGREGATION WITH WITHDRAWAL HISTORY DISCOVERY

Unlike hardcoded withdrawal 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 withdrawal history by iterating through withdrawal event indices until it hits empty entries (capped at 10 for performance), displaying withdrawer addresses, amounts, and status for full transparency. The tool dynamically selects the appropriate withdrawal method based on user input—withdrawPaymaster with stake option, withdrawDeposit for standard withdrawals, reclaimFunds with force option, and withdrawStake for stake-only withdrawals. Gas estimation factors in withdrawal method complexity and the tool uses receipt.effectiveGasPrice post-transaction for accurate cost reporting rather than relying on the pre-EIP-1559 gasPrice cap. Withdrawal limits and windows are displayed prominently to ensure compliance with contract restrictions.

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 withdrawal parameters have been manipulated or if the contracts have been upgraded or modified. Withdrawal 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 withdrawal parameters are valid, predict gas prices during congestion, or detect if the withdrawal has been front-run. The tool cannot ensure that the paymaster will continue to operate after withdrawal, provide financial or security advice, guarantee that the withdrawal will be processed, verify off-chain withdrawal tracking, ensure that all conditions for withdrawal are met, or track withdrawal status outside of the tool. Withdrawing from a paymaster reduces its ability to sponsor gas—ensure the paymaster retains sufficient funds for operations.

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 withdrawal decisions remain your responsibility. Always verify contract addresses, withdrawal amounts, and recipient addresses before submitting transactions. The tool displays current state but does not automatically withdraw—you must review and confirm each transaction through your wallet. Gas costs vary by network conditions; the tool estimates but cannot guarantee optimal pricing. Withdrawals may be subject to minimum and maximum limits, windows, and frequency restrictions enforced by the contract. Understanding the specific withdrawal rules for your paymaster implementation is essential before attempting a withdrawal.