Paymaster

Paymaster Addresses and Events

This page contains information on the addresses of the Circle Paymaster contracts, and the events the contracts emit during operation.

You can access the permissionless paymaster contracts at the following addresses on supported blockchains:

  • Paymaster v0.7
  • Paymaster v0.8
BlockchainSymbolPaymaster contract address
ArbitrumARB0x6C973eBe80dCD8660841D4356bf15c32460271C9
BaseBASE0x6C973eBe80dCD8660841D4356bf15c32460271C9
BlockchainSymbolPaymaster contract address
Arbitrum SepoliaARB-SEPOLIA0x31BE08D380A21fc740883c0BC434FcFc88740b58
Base SepoliaBASE-SEPOLIA0x31BE08D380A21fc740883c0BC434FcFc88740b58

This section explains the events from the Circle Paymaster and when they are emitted. You can use these events to debug or track the state after submitting a user operation (user op) to a bundler.

These files are the main contract of the Circle Paymaster that support EntryPoint v0.7 and v0.8. The primary functions they integrate are:

  • _validatePaymasterUserOp: validates the user op and charges the prefund token from the sender before execution.
  • _postOp: refunds the token back to the sender when the actual amount of tokens needed is known after execution.

The contract emits this event after the _postOp is executed and the prefund token (if any) is refunded.

Attributes

NameTypeDescription
tokenIERC20The ERC-20 token paid by the sender
senderaddressThe sender address
userOpHashbytes32The hash of the user op
nativeTokenPriceuint256The price of 1 ether = 1e18 wei, denominated in token
actualTokenNeededuint256The final transaction cost to the smart contract account (SCA), denominated in token
feeTokenAmountuint256The fee spread used to cover the slippage from exchanging USDC for ETH, denominated in token

Example

Using this transaction as an example, the userOperationSponsored event contains the following data:

NameTypeValue
tokenIERC200x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c7238
senderaddress0x000000000000000000000000148cab4b1a7e8c23ae62967cfc8df6292ecf27a8
userOpHashbytes32cc6f71a0ba8d9b72e75c45fae7b830c403b46964eb1d3f8daa0b73d14e6c5b0d
nativeTokenPriceuint2563000000000
actualTokenNeededuint2564551712
feeTokenAmountuint2560
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.