package op_pool

Get desktop application:
View/edit binary Protocol Buffers messages

Defines the gRPC endpoints for a UserOperation mempool service

• rpc AddOp (AddOpRequest, AddOpResponse)

  op_pool.proto:238

  Adds a UserOperation to the mempool

  message AddOpRequest

  op_pool.proto:304

  • optional UserOperation op = 1

    The UserOperation to add to the mempool

  • optional UserOperationPermissions permissions = 2

    The permissions to use for the UserOperation

  message AddOpResponse

  op_pool.proto:310

  • oneof result

    • AddOpSuccess success = 1

    • MempoolError failure = 2

• rpc AdminSetTracking (AdminSetTrackingRequest, AdminSetTrackingResponse)

  op_pool.proto:292

  Clears the bundler mempool and reputation data of paymasters/accounts/factories/aggregators

  message AdminSetTrackingRequest

  op_pool.proto:590

  • bytes entry_point = 1

    The serialized entry point address via which the UserOperation is being submitted

  • bool paymaster = 2

  • bool reputation = 3

  message AdminSetTrackingResponse

  op_pool.proto:596

  • oneof result

    • AdminSetTrackingSuccess success = 1

    • MempoolError failure = 2

• rpc DebugClearState (DebugClearStateRequest, DebugClearStateResponse)

  op_pool.proto:265

  Clears the bundler mempool and reputation data of paymasters/accounts/factories/aggregators

  message DebugClearStateRequest

  op_pool.proto:492

  • bool clear_mempool = 1

  • bool clear_reputation = 2

  • bool clear_paymaster = 3

  message DebugClearStateResponse

  op_pool.proto:497

  • oneof result

    • DebugClearStateSuccess success = 1

    • MempoolError failure = 2

• rpc DebugDumpMempool (DebugDumpMempoolRequest, DebugDumpMempoolResponse)

  op_pool.proto:268

  Dumps the current UserOperations mempool

  message DebugDumpMempoolRequest

  op_pool.proto:505

  • bytes entry_point = 1

  message DebugDumpMempoolResponse

  op_pool.proto:508

  • oneof result

    • DebugDumpMempoolSuccess success = 1

    • MempoolError failure = 2

• rpc DebugDumpPaymasterBalances (DebugDumpPaymasterBalancesRequest, DebugDumpPaymasterBalancesResponse)

  op_pool.proto:279

  Dumps the paymaster balances

  message DebugDumpPaymasterBalancesRequest

  op_pool.proto:546

  • bytes entry_point = 1

  message DebugDumpPaymasterBalancesResponse

  op_pool.proto:549

  • oneof result

    • DebugDumpPaymasterBalancesSuccess success = 1

    • MempoolError failure = 2

• rpc DebugDumpReputation (DebugDumpReputationRequest, DebugDumpReputationResponse)

  op_pool.proto:276

  Returns the reputation data of all observed addresses. Returns an array of reputation objects, each with the fields described above in debug_bundler_setReputation

  message DebugDumpReputationRequest

  op_pool.proto:532

  • bytes entry_point = 1

    The serialized entry point address.

  message DebugDumpReputationResponse

  op_pool.proto:536

  • oneof result

    • DebugDumpReputationSuccess success = 1

    • MempoolError failure = 2

• rpc DebugSetReputation (DebugSetReputationRequest, DebugSetReputationResponse)

  op_pool.proto:271

  Sets reputation of given addresses.

  message DebugSetReputationRequest

  op_pool.proto:518

  • bytes entry_point = 1

    The serialized entry point address via which the UserOperation is being submitted

  • repeated Reputation reputations = 2

    An array of reputation entries to add/replace

  message DebugSetReputationResponse

  op_pool.proto:524

  • oneof result

    • DebugSetReputationSuccess success = 1

    • MempoolError failure = 2

• rpc GetOpByHash (GetOpByHashRequest, GetOpByHashResponse)

  op_pool.proto:250

  Get a UserOperation by its hash

  message GetOpByHashRequest

  op_pool.proto:373

  • bytes hash = 1

    The serialized UserOperation hash

  message GetOpByHashResponse

  op_pool.proto:377

  • oneof result

    • GetOpByHashSuccess success = 1

    • MempoolError failure = 2

• rpc GetOpById (GetOpByIdRequest, GetOpByIdResponse)

  op_pool.proto:253

  Get a UserOperation by its id

  message GetOpByIdRequest

  op_pool.proto:392

  • bytes sender = 1

  • bytes nonce = 2

  message GetOpByIdResponse

  op_pool.proto:396

  • oneof result

    • GetOpByIdSuccess success = 1

    • MempoolError failure = 2

• rpc GetOps (GetOpsRequest, GetOpsResponse)

  op_pool.proto:241

  Get up to `max_ops` from the mempool.

  message GetOpsRequest

  op_pool.proto:321

  • bytes entry_point = 1

    The serialized entry point address

  • uint64 max_ops = 2

    The maximum number of UserOperations to return

  • string filter_id = 3

    The filter ID to apply to the UserOperations

  message GetOpsResponse

  op_pool.proto:329

  • oneof result

    • GetOpsSuccess success = 1

    • MempoolError failure = 2

• rpc GetOpsByHashes (GetOpsByHashesRequest, GetOpsByHashesResponse)

  op_pool.proto:247

  Get operations by their hashes.

  message GetOpsByHashesRequest

  op_pool.proto:357

  • bytes entry_point = 1

    The serialized entry point address

  • repeated bytes hashes = 2

    The serialized UserOperation hashes to get

  message GetOpsByHashesResponse

  op_pool.proto:363

  • oneof result

    • GetOpsByHashesSuccess success = 1

    • MempoolError failure = 2

• rpc GetOpsSummaries (GetOpsSummariesRequest, GetOpsSummariesResponse)

  op_pool.proto:244

  Get summaries of up to `max_ops` from the mempool.

  message GetOpsSummariesRequest

  op_pool.proto:339

  • bytes entry_point = 1

    The serialized entry point address

  • uint64 max_ops = 2

    The maximum number of UserOperations to return

  • string filter_id = 3

    The filter ID to apply to the UserOperations

  message GetOpsSummariesResponse

  op_pool.proto:347

  • oneof result

    • GetOpsSummariesSuccess success = 1

    • MempoolError failure = 2

• rpc GetReputationStatus (GetReputationStatusRequest, GetReputationStatusResponse)

  op_pool.proto:282

  Get reputation status of address

  message GetReputationStatusRequest

  op_pool.proto:413

  • bytes entry_point = 1

  • bytes address = 2

  message GetReputationStatusResponse

  op_pool.proto:406

  • oneof result

    • GetReputationStatusSuccess success = 1

    • MempoolError failure = 2

• rpc GetStakeStatus (GetStakeStatusRequest, GetStakeStatusResponse)

  op_pool.proto:285

  Get stake status of address

  message GetStakeStatusRequest

  op_pool.proto:429

  • bytes entry_point = 1

  • bytes address = 2

  message GetStakeStatusResponse

  op_pool.proto:422

  • oneof result

    • GetStakeStatusSuccess success = 1

    • MempoolError failure = 2

• rpc GetSupportedEntryPoints (GetSupportedEntryPointsRequest, GetSupportedEntryPointsResponse)

  op_pool.proto:235

  Returns an array of the entry point addresses supported by the client. The first element of the array SHOULD be the entry point addressed preferred by the client

  message GetSupportedEntryPointsRequest

  op_pool.proto:295

  (message has no fields)

  message GetSupportedEntryPointsResponse

  op_pool.proto:296

  • uint64 chain_id = 1

    Chain ID as defined in EIP-155. https://eips.ethereum.org/EIPS/eip-155

  • repeated bytes entry_points = 2

    The set of serialized entry point addresses supported

• rpc RemoveOpById (RemoveOpByIdRequest, RemoveOpByIdResponse)

  op_pool.proto:259

  Remove a UserOperation by its id

  message RemoveOpByIdRequest

  op_pool.proto:462

  • bytes entry_point = 1

  • bytes sender = 2

  • bytes nonce = 3

  message RemoveOpByIdResponse

  op_pool.proto:467

  • oneof result

    • RemoveOpByIdSuccess success = 1

    • MempoolError failure = 2

• rpc RemoveOps (RemoveOpsRequest, RemoveOpsResponse)

  op_pool.proto:256

  Removes UserOperations from the mempool

  message RemoveOpsRequest

  op_pool.proto:448

  • bytes entry_point = 1

    The serialized entry point address

  • repeated bytes hashes = 2

    The serialized UserOperation hashes to remove

  message RemoveOpsResponse

  op_pool.proto:454

  • oneof result

    • RemoveOpsSuccess success = 1

    • MempoolError failure = 2

• rpc SubscribeNewHeads (SubscribeNewHeadsRequest, stream SubscribeNewHeadsResponse)

  op_pool.proto:289

  Streaming API to subscribe to be updated upon a new block being added to (or reorged onto) the chain.

  message SubscribeNewHeadsRequest

  op_pool.proto:564

  • repeated bytes to_track = 1

    The addresses to track

  message SubscribeNewHeadsResponse

  op_pool.proto:568

  • optional NewHead new_head = 1

    The new chain head

• rpc UpdateEntities (UpdateEntitiesRequest, UpdateEntitiesResponse)

  op_pool.proto:262

  Handles a list of updates to be performed on entities

  message UpdateEntitiesRequest

  op_pool.proto:477

  • bytes entry_point = 1

    The serilaized entry point address

  • repeated EntityUpdate entity_updates = 2

    A list of updates that should be performed on the entities

  message UpdateEntitiesResponse

  op_pool.proto:484

  • oneof result

    • UpdateEntitiesSuccess success = 1

    • MempoolError failure = 2

Used in: SimulationViolationError

• optional Entity entity = 1

• bytes contract_address = 2

Used in: SimulationViolationError

• string contract_type = 1

• bytes contract_address = 2

Used in: AddOpResponse

• bytes hash = 1

  The serialized UserOperation hash

Used in: NewHead

• bytes address = 1

  The address

• optional uint64 nonce = 2

  The new nonce (if any)

• bytes balance = 3

  The new balance

• repeated bytes mined_tx_hashes = 4

  The mined tx hashes

Used in: AdminSetTrackingResponse

(message has no fields)

Used in: MempoolError

• string reason = 1

Used in: SimulationViolationError

• bytes expected = 1

• bytes actual = 2

Used in: SimulationViolationError

• optional Entity entity = 1

• bytes contract_address = 2

• bytes slot = 3

Used in: MempoolError

(message has no fields)

Protocol Buffer representation of an 7702 authorization tuple. See the official specification at https://eips.ethereum.org/EIPS/eip-7702

Used in: UserOperationV06, UserOperationV07

• uint64 chain_id = 1

• uint64 nonce = 2

• bytes address = 3

• uint32 y_parity = 4

  signed authorization tuple.

• bytes r = 5

• bytes s = 6

Data associated with a user operation for Bedrock DA gas calculations

Used in: DaGasData

• bytes units = 1

Used in: UserOperationPermissions

• bytes max_cost = 1

• uint64 valid_until = 2

Used in: PrecheckViolationError

• bytes actual_gas_limit = 1

• bytes min_gas_limit = 2

Used in: SimulationViolationError

• optional Entity entity = 1

Used in: SimulationViolationError

• optional Entity entity = 1

Used in: SimulationViolationError

(message has no fields)

Data associated with a user operation for DA gas calculations

Used in: MempoolOp

• oneof data

  • EmptyGasData empty = 1

  • NitroDaGasData nitro = 2

  • BedrockDaGasData bedrock = 3

Used in: DebugClearStateResponse

(message has no fields)

Used in: DebugDumpMempoolResponse

• repeated MempoolOp ops = 1

Used in: DebugDumpPaymasterBalancesResponse

• repeated PaymasterBalance balances = 1

Used in: DebugDumpReputationResponse

• repeated Reputation reputations = 1

Used in: DebugSetReputationResponse

(message has no fields)

Used in: SimulationViolationError

(message has no fields)

Used in: MempoolError

(message has no fields)

Used in: DaGasData

(message has no fields)

Used in: AccessedUndeployedContract, AssociatedStorageDuringDeploy, CallHadValue, CalledBannedEntryPointMethod, EntityThrottledError, EntityUpdate, InvalidStorageAccess, MaxOperationsReachedError, MultipleRolesViolation, NotStaked, OutOfGas, UnintendedRevert, UnintendedRevertWithMessage, UsedForbiddenOpcode, UsedForbiddenPrecompile

• EntityType kind = 1

• bytes address = 2

  A 20 byte serialized binary format representation of the address

Used in: MempoolError

• optional Entity entity = 1

Used in: Entity, NotStaked

• ENTITY_TYPE_UNSPECIFIED = 0

• ENTITY_TYPE_ACCOUNT = 1

• ENTITY_TYPE_PAYMASTER = 2

• ENTITY_TYPE_AGGREGATOR = 3

• ENTITY_TYPE_FACTORY = 4

A tuple consisting of an entity and what kind of update to perform on it

Used in: UpdateEntitiesRequest

• optional Entity entity = 1

• EntityUpdateType update_type = 2

• uint64 value = 3

The type of update to perform on an entity

Used in: EntityUpdate

• ENTITY_UPDATE_TYPE_UNSPECIFIED = 0

• ENTITY_UPDATE_TYPE_UNSTAKED_INVALIDATION = 1

• ENTITY_UPDATE_TYPE_STAKED_INVALIDATION = 2

• ENTITY_UPDATE_TYPE_PAYMASTER_OPS_SEEN_DECREMENT = 3

Used in: ValidationRevert

• string reason = 1

Used in: MempoolError

• double required = 1

• double actual = 2

Used in: PrecheckViolationError

• bytes sender_address = 1

Used in: SimulationViolationError

• bytes factory_address = 1

Used in: PrecheckViolationError

• bytes factory_address = 1

Used in: PrecheckViolationError

• bytes factory_address = 1

Used in: GetOpByHashResponse

• optional MempoolOp op = 1

• optional PreconfInfo preconf_info = 2

Used in: GetOpByIdResponse

• optional MempoolOp op = 1

Used in: GetOpsByHashesResponse

• repeated MempoolOp ops = 1

Used in: GetOpsResponse

• repeated MempoolOp ops = 1

Used in: GetOpsSummariesResponse

• repeated PoolOperationSummary summaries = 1

Used in: GetReputationStatusResponse

• ReputationStatus status = 1

Used in: GetStakeStatusResponse

• optional StakeStatus status = 1

• uint64 length = 1

Used in: MempoolError

• string reason = 1

Used in: SimulationViolationError

(message has no fields)

Used in: SimulationViolationError

(message has no fields)

Used in: SimulationViolationError

(message has no fields)

Used in: MempoolError

(message has no fields)

Used in: SimulationViolationError

• optional Entity entity = 1

• bytes contract_address = 2

• bytes slot = 3

Used in: SimulationViolationError

• uint64 valid_until = 1

• uint64 valud_after = 2

Used in: PrecheckViolationError

• bytes actual_fee = 1

• bytes min_fee = 2

Used in: MempoolError

• uint64 num_ops = 1

• optional Entity entity = 2

Used in: PrecheckViolationError

• bytes actual_fee = 1

• bytes min_fee = 2

MEMPOOL ERRORS

Used in: AddOpResponse, AdminSetTrackingResponse, DebugClearStateResponse, DebugDumpMempoolResponse, DebugDumpPaymasterBalancesResponse, DebugDumpReputationResponse, DebugSetReputationResponse, GetOpByHashResponse, GetOpByIdResponse, GetOpsByHashesResponse, GetOpsResponse, GetOpsSummariesResponse, GetReputationStatusResponse, GetStakeStatusResponse, RemoveOpByIdResponse, RemoveOpsResponse, UpdateEntitiesResponse

• oneof error

  • string internal = 1

  • OperationAlreadyKnownError operation_already_known = 2

  • ReplacementUnderpricedError replacement_underpriced = 3

  • MaxOperationsReachedError max_operations_reached = 4

  • EntityThrottledError entity_throttled = 5

  • DiscardedOnInsertError discarded_on_insert = 6

  • PrecheckViolationError precheck_violation = 7

  • SimulationViolationError simulation_violation = 8

  • InvalidSignatureError invalid_signature = 10

  • UnknownEntryPointError unknown_entry_point = 11

  • MultipleRolesViolation multiple_roles_violation = 12

  • SenderAddressUsedAsAlternateEntity sender_address_used_as_alternate_entity = 13

  • AssociatedStorageIsAlternateSender associated_storage_is_alternate_sender = 14

  • PaymasterBalanceTooLow paymaster_balance_too_low = 15

  • OperationDropTooSoon operation_drop_too_soon = 16

  • VerificationGasLimitEfficiencyTooLow verification_gas_limit_efficiency_too_low = 17

  • ExecutionGasLimitEfficiencyTooLow execution_gas_limit_efficiency_too_low = 18

  • TooManyExpectedStorageSlots too_many_expected_storage_slots = 19

  • UseUnsupportedEIP use_unsupported_eip = 20

  • AggregatorError aggregator = 21

  • Invalid7702AuthSignature invalid_7702_auth_signature = 22

Defines a UserOperation persisted in a local mempool

Used in: DebugDumpMempoolSuccess, GetOpByHashSuccess, GetOpByIdSuccess, GetOpsByHashesSuccess, GetOpsSuccess

• optional UserOperation uo = 1

• bytes aggregator = 2

  Optional address of the signature aggregator to be used for this UO signature

• uint64 valid_after = 3

  Time in seconds since epoch after which a UO is considered valid

• uint64 valid_until = 4

  Time in seconds since epoch until which a UO is considered valid

• bytes expected_code_hash = 5

  A hash of all contracts who's code a UserOperation touches as computed during validation before the UserOperation enters the mempool. As per ERC-4337 requirements, it is later compared against an equivalent hash computed before being added to a Bundle. Specifically, a bundler should reject a UserOperation if, between the time if it was added to the pool and the time it’s taken out to be added to a bundle, any of the code that it touches during validation changes. Therefore, before any UserOperation is added to the pool, validation is run once, keeping track every contract whose code it touches. This hash is computed based on the code of all those contracts. When the second validation runs later, the hash is computed again to verify the code has not changed. See rule (5) here: https://github.com/ethereum/EIPs/blob/master/EIPS/eip-4337.md#specification-1

• bytes sim_block_hash = 6

  Block hash at which the UserOperation was simulated

• bool account_is_staked = 7

  Indicates if the account is staked. Staked accounts are allowed to have multiple UserOperations in the mempool, otherwise just one UserOperation is permitted

• bytes entry_point = 8

  The entry point address of this operation

• optional DaGasData da_gas_data = 9

  The DA gas data for the UO

• string filter_id = 10

  The filter ID to apply to the UserOperation

• optional UserOperationPermissions permissions = 11

  The permissions for the UserOperation

Used in: MempoolError

• optional Entity entity = 1

Used in: SubscribeNewHeadsResponse

• bytes block_hash = 1

  The block hash

• uint64 block_number = 2

  The block number

• repeated AddressUpdate address_updates = 3

  Address Updates

Data associated with a user operation for Nitro DA gas calculations

Used in: DaGasData

• bytes units = 1

Used in: SimulationViolationError

• optional Entity needs_stake = 1

• EntityType accessing_entity = 2

• EntityType accessed_entity = 3

• bytes accessed_address = 4

• bytes slot = 5

• bytes min_stake = 6

• uint32 min_unstake_delay = 7

Used in: MempoolError

(message has no fields)

Used in: MempoolError

• uint64 added_at = 1

• uint64 attempted_at = 2

• uint64 must_wait = 3

Used in: ValidationRevert

• string entry_point_reason = 1

• bytes inner_revert_data = 2

• string inner_revert_reason = 3

Used in: SimulationViolationError

• optional Entity entity = 1

Used in: PrecheckViolationError

• bytes actual_cost = 1

• bytes max_cost = 2

Used in: ValidationRevert

• bytes code = 1

Used in: DebugDumpPaymasterBalancesSuccess

• bytes address = 1

• bytes pending_balance = 2

• bytes confirmed_balance = 3

Used in: MempoolError

• bytes current_balance = 1

• bytes required_balance = 2

Used in: PrecheckViolationError

• bytes actual_deposit = 1

• bytes min_deposit = 2

Used in: PrecheckViolationError

• bytes paymaster_address = 1

• uint64 length = 1

Used in: GetOpsSummariesSuccess

• bytes hash = 1

  The serialized UserOperation hash

• bytes entry_point = 2

  The serialized entry point address

• bytes sender = 3

  The sender of the UserOperation

Used in: PrecheckViolationError

• bytes actual_gas = 1

• bytes min_gas = 2

PRECHECK VIOLATIONS

Used in: MempoolError

• oneof violation

  • SenderIsNotContractAndNoInitCode sender_is_not_contract_and_no_init_code = 1

  • ExistingSenderWithInitCode existing_sender_with_init_code = 2

  • FactoryIsNotContract factory_is_not_contract = 3

  • TotalGasLimitTooHigh total_gas_limit_too_high = 4

  • VerificationGasLimitTooHigh verification_gas_limit_too_high = 5

  • PreVerificationGasTooLow pre_verification_gas_too_low = 6

  • PaymasterIsNotContract paymaster_is_not_contract = 7

  • PaymasterDepositTooLow paymaster_deposit_too_low = 8

  • SenderFundsTooLow sender_funds_too_low = 9

  • MaxFeePerGasTooLow max_fee_per_gas_too_low = 10

  • MaxPriorityFeePerGasTooLow max_priority_fee_per_gas_too_low = 11

  • CallGasLimitTooLow call_gas_limit_too_low = 12

  • FactoryMustBeEmpty factory_must_be_empty = 13

  • OverMaxCost over_max_cost = 14

Used in: GetOpByHashSuccess

• bytes tx_hash = 1

Used in: RemoveOpByIdResponse

• bytes hash = 1

Used in: RemoveOpsResponse

(message has no fields)

Used in: MempoolError

• bytes current_fee = 1

• bytes current_priority_fee = 2

Used in: DebugDumpReputationSuccess, DebugSetReputationRequest

• bytes address = 1

  The (serialized) address to set the reputation for

• uint64 ops_seen = 2

  number of times a user operations with that entity was seen and added to the mempool

• uint64 ops_included = 3

  number of times a user operations that uses this entity was included on-chain

Used in: GetReputationStatusSuccess

• REPUTATION_STATUS_UNSPECIFIED = 0

• REPUTATION_STATUS_OK = 1

• REPUTATION_STATUS_THROTTLED = 2

• REPUTATION_STATUS_BANNED = 3

Used in: MempoolError

• bytes sender_address = 1

Used in: PrecheckViolationError

• bytes actual_funds = 1

• bytes min_funds = 2

Used in: PrecheckViolationError

• bytes sender_address = 1

SIMULATION VIOLATIONS

Used in: MempoolError

• oneof violation

  • InvalidSignature invalid_signature = 1

  • UnintendedRevertWithMessage unintended_revert_with_message = 2

  • UsedForbiddenOpcode used_forbidden_opcode = 3

  • UsedForbiddenPrecompile used_forbidden_precompile = 4

  • FactoryCalledCreate2Twice factory_called_create2_twice = 5

  • InvalidStorageAccess invalid_storage_access = 6

  • NotStaked not_staked = 7

  • UnintendedRevert unintended_revert = 8

  • DidNotRevert did_not_revert = 9

  • WrongNumberOfPhases wrong_number_of_phases = 10

  • CallHadValue call_had_value = 11

  • OutOfGas out_of_gas = 12

  • AccessedUndeployedContract accessed_undeployed_contract = 13

  • CalledBannedEntryPointMethod called_banned_entry_point_method = 14

  • CodeHashChanged code_hash_changed = 15

  • UnstakedPaymasterContext unstaked_paymaster_context = 17

  • VerificationGasLimitBufferTooLow verification_gas_limit_buffer_too_low = 19

  • ValidationRevert validation_revert = 20

  • InvalidAccountSignature invalid_account_signature = 21

  • InvalidPaymasterSignature invalid_paymaster_signature = 22

  • AssociatedStorageDuringDeploy associated_storage_during_deploy = 23

  • InvalidTimeRange invalid_time_range = 24

  • AccessedUnsupportedContractType accessed_unsupported_contract_type = 25

  • AggregatorMismatch aggregator_mismatch = 26

Used in: StakeStatus

• bytes stake = 1

• uint32 unstake_delay_sec = 2

Used in: GetStakeStatusSuccess

• bool is_staked = 1

• optional StakeInfo stake_info = 2

Used in: MempoolError

• uint64 max_slots = 1

• uint64 expected_slots = 2

Used in: PrecheckViolationError

• bytes actual_gas = 1

• bytes max_gas = 2

Used in: SimulationViolationError

• optional Entity entity = 1

Used in: SimulationViolationError

• optional Entity entity = 1

• string reason = 2

Used in: MempoolError

• bytes entry_point = 1

Used in: ValidationRevert

• bytes revert_bytes = 1

Used in: SimulationViolationError

(message has no fields)

Used in: UpdateEntitiesResponse

(message has no fields)

Used in: MempoolError

• string eip_name = 1

Used in: SimulationViolationError

• optional Entity entity = 1

• bytes contract_address = 2

• uint32 opcode = 3

Used in: SimulationViolationError

• optional Entity entity = 1

• bytes contract_address = 2

• bytes precompile_address = 3

Used in: AddOpRequest, MempoolOp

• oneof uo

  • UserOperationV06 v06 = 1

  • UserOperationV07 v07 = 2

Used in: AddOpRequest, MempoolOp

• bool trusted = 1

• optional uint64 max_allowed_in_pool_for_sender = 2

• optional uint32 underpriced_accept_pct = 3

• optional uint32 underpriced_bundle_pct = 4

• optional BundlerSponsorship bundler_sponsorship = 5

Protocol Buffer representation of an ERC-4337 UserOperation. See the official specification at https://eips.ethereum.org/EIPS/eip-4337#definitions

Used in: UserOperation

• bytes sender = 1

  The account making the operation

• bytes nonce = 2

  Anti-replay parameter (see “Semi-abstracted Nonce Support” )

• bytes init_code = 3

  The initCode of the account (needed if and only if the account is not yet on-chain and needs to be created)

• bytes call_data = 4

  The data to pass to the sender during the main execution call

• bytes call_gas_limit = 5

  The amount of gas to allocate the main execution call

• bytes verification_gas_limit = 6

  The amount of gas to allocate for the verification step

• bytes pre_verification_gas = 7

  The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata

• bytes max_fee_per_gas = 8

  Maximum fee per gas (similar to EIP-1559 max_fee_per_gas)

• bytes max_priority_fee_per_gas = 9

  Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas)

• bytes paymaster_and_data = 10

  Address of paymaster sponsoring the transaction, followed by extra data to send to the paymaster (empty for self-sponsored transaction)

• bytes signature = 11

  Signature over the hash of the packed representation of the user operation

• optional AuthorizationTuple authorization_tuple = 12

  authorization tuple for 7702 txns

• bytes aggregator = 13

  aggregator

Used in: UserOperation

• bytes sender = 1

  The account making the operation

• bytes nonce = 2

  Anti-replay parameter (see “Semi-abstracted Nonce Support” )

• bytes call_data = 3

  The data to pass to the sender during the main execution call

• bytes call_gas_limit = 4

  The amount of gas to allocate the main execution call

• bytes verification_gas_limit = 5

  The amount of gas to allocate for the verification step

• bytes pre_verification_gas = 6

  The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata

• bytes max_fee_per_gas = 7

  Maximum fee per gas (similar to EIP-1559 max_fee_per_gas)

• bytes max_priority_fee_per_gas = 8

  Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas)

• bytes signature = 9

  Signature over the hash of the packed representation of the user operation

• bytes paymaster = 10

  Address of paymaster sponsoring the transaction, empty if none

• bytes paymaster_data = 11

  Extra data to send to the paymaster, zero if no paymaster

• bytes paymaster_verification_gas_limit = 12

  Paymaster verification gas limit, zero if no paymaster

• bytes paymaster_post_op_gas_limit = 13

  Paymaster post-op gas limit, zero if no paymaster

• bytes factory = 14

  Address of the factory to use to create the sender account, empty if none

• bytes factory_data = 15

  Extra data to send to the factory, empty if no factory

• bytes entry_point = 16

  Extra data to compute the hash of the user operation

• uint64 chain_id = 17

• optional AuthorizationTuple authorization_tuple = 18

  authorization tuple for 7702 txns

• bytes aggregator = 19

  aggregator

Used in: SimulationViolationError

• oneof revert

  • EntryPointRevert entry_point = 1

  • OperationRevert operation = 2

  • UnknownRevert unknown = 3

  • PanicRevert panic = 4

Used in: SimulationViolationError

• bytes limit = 1

• bytes needed = 2

Used in: MempoolError

• double required = 1

• double actual = 2

Used in: PrecheckViolationError

• bytes actual_gas = 1

• bytes max_gas = 2

Used in: SimulationViolationError

• uint32 num_phases = 1