package mempool

Get desktop application:
View/edit binary Protocol Buffers messages

----------------------------------------------------------------------------- ---------------- Mempool Service Definition -----------------------------------------------------------------------------

• rpc AddTransactionWithValidation (AddTransactionWithValidationRequest, AddTransactionWithValidationResponse)

  mempool.proto:22

  Adds a new transaction to the mempool with validation against existing transactions in the mempool. Note that this function performs additional validation that AC is unable to perform. (because AC knows only about a single transaction, but mempool potentially knows about multiple pending transactions)

  message AddTransactionWithValidationRequest

  mempool.proto:41

  • optional types.SignedTransaction signed_txn = 1

    Transaction from a wallet

  • uint64 max_gas_cost = 2

    Max amount of gas required to execute the transaction Without running the program, it is very difficult to determine this number, so we use the max gas specified by the signed transaction. This field is still included separately from the signed transaction so that if we have a better methodology in the future, we can more accurately specify the max gas.

  • uint64 latest_sequence_number = 3

    Latest sequence number of the involved account from state db.

  • uint64 account_balance = 4

    Latest account balance of the involved account from state db.

  message AddTransactionWithValidationResponse

  mempool.proto:57

  • uint64 current_version = 1

    The ledger version at the time of the transaction submitted. The submitted transaction will have version bigger than this 'current_version'

  • optional MempoolAddTransactionStatus status = 2

    The result of the transaction submission

• rpc CommitTransactions (CommitTransactionsRequest, CommitTransactionsResponse)

  mempool.proto:29

  Remove committed transactions from Mempool

  message CommitTransactionsRequest

  mempool.proto:83

  ----------------------------------------------------------------------------- ---------------- CommitTransactions -----------------------------------------------------------------------------

  • repeated CommittedTransaction transactions = 1

  • uint64 block_timestamp_usecs = 2

    agreed monotonic timestamp microseconds since the epoch for a committed block used by Mempool to GC expired transactions

  message CommitTransactionsResponse

  mempool.proto:90

  (message has no fields)

• rpc GetBlock (GetBlockRequest, GetBlockResponse)

  mempool.proto:26

  Fetch ordered block of transactions

  message GetBlockRequest

  mempool.proto:68

  ----------------------------------------------------------------------------- ---------------- GetBlock -----------------------------------------------------------------------------

  • uint64 max_block_size = 1

  • repeated TransactionExclusion transactions = 2

  message GetBlockResponse

  mempool.proto:73

  • optional types.SignedTransactionsBlock block = 1

• rpc HealthCheck (HealthCheckRequest, HealthCheckResponse)

  mempool.proto:33

  Check the health of mempool

  message HealthCheckRequest

  mempool.proto:101

  ----------------------------------------------------------------------------- ---------------- HealthCheck -----------------------------------------------------------------------------

  (message has no fields)

  message HealthCheckResponse

  mempool.proto:104

  • bool is_healthy = 1

    Indicate whether Mempool is in healthy condition.

Used in: CommitTransactionsRequest

• bytes sender = 1

• uint64 sequence_number = 2

• bool is_rejected = 3

Used in: admission_control.SubmitTransactionResponse, AddTransactionWithValidationResponse

• MempoolAddTransactionStatusCode code = 1

• string message = 2

Used in: MempoolAddTransactionStatus

• Valid = 0

  Transaction was sent to Mempool

• InsufficientBalance = 1

  The sender does not have enough balance for the transaction.

• InvalidSeqNumber = 2

  Sequence number is old, etc.

• MempoolIsFull = 3

  Mempool is full (reached max global capacity)

• TooManyTransactions = 4

  Account reached max capacity per account

• InvalidUpdate = 5

  Invalid update. Only gas price increase is allowed

Used in: GetBlockRequest

• bytes sender = 1

• uint64 sequence_number = 2