Bundler API
Learn more about the Bundler API for Account Abstraction on Boba Network
ChainID | 9728 |
AA bundler |
This section lists the Ethereum JSON-RPC API endpoints for a basic EIP-4337 "bundler".
eth_sendUserOperation
eth_supportedEntryPoints
eth_chainId
eth_estimateUserOperationGas
eth_sendUserOperation
Submit your userOperations to the bundler.
Parameters
UserOperation
, a full user operation struct.EntryPoint
, address the request should be sent through.
Return value
Returns userOpHash
if the UserOperation is valid.
Otherwise it returns an error object with code
and message
. (and sometimes data
)
Code | Message |
-32602 | Invalid UserOperation struct/fields |
-32500 | Transaction rejected by entryPoint's simulateValidation, during wallet creation or validation |
-32501 | Transaction rejected by paymaster's validatePaymasterUserOp |
-32502 | Transaction rejected because of opcode validation |
-32503 | UserOperation out of time-range: either wallet or paymaster returned a time-range, and it is already expired (or will expire soon) |
-32504 | Transaction rejected because paymaster (or signature aggregator) is throttled/banned |
-32505 | Transaction rejected because paymaster (or signature aggregator) stake or unstake-delay is too low |
-32506 | Transaction rejected because wallet specified unsupported signature aggregator |
-32507 | Transaction rejected because of wallet signature check failed (or paymaster siganture, if the paymaster uses its data as signature) |
-32508 | UserOperation not in valid time-range: either wallet or paymaster returned a time-range, and it is valid in the future |
Usage
Example request
Example response:
Example failure response:
eth_supportedEntryPoints
Returns an array of the entryPoint addresses supported by the client.
Request:
Response:
eth_chainId
Returns EIP-155 Chain ID.
Request:
Response:
eth_getUserOperationByHash
Get a UserOperation based on a userOperation hash
Parameters
userOpHash
, a userOperation hash value
Return value
Returns a full UserOperation, with the addition of entryPoint
, blockNumber
, blockHash
and transactionHash
if the UserOperation is included in a block.
Otherwise it returns null
if the operation is yet to be included. For an invalid userOpHash returns an error object with code
: -32601 and message
: Missing/invalid userOpHash
Example request
Example response:
Example failure response:
eth_getUserOperationReceipt
Get a UserOperation based on a userOperation hash
Parameters
userOpHash
, a userOperation hash value
Return value
Returns a receipt that includes
userOpHash
, the request hash sender
nonce
actualGasCost
, actual amount paid (by account or paymaster) for this UserOperation actualGasUsed
, total gas used by this UserOperation (including preVerification, creation, validation and execution) success
, boolean - if this execution completed without revert logs
, the logs generated by this UserOperation (not including logs of other UserOperations in the same bundle) receipt
, the TransactionReceipt object.
Otherwise it returns null
if the operation is yet to be included.
Example request
Example response:
Last updated