package admission_control

Get desktop application:
View/edit binary Protocol Buffers messages

----------------------------------------------------------------------------- ---------------- Service definition -----------------------------------------------------------------------------

• rpc SubmitTransaction (SubmitTransactionRequest, SubmitTransactionResponse)

  admission_control.proto:79

  Public API to submit transaction to a validator.

• rpc UpdateToLatestLedger (types.UpdateToLatestLedgerRequest, types.UpdateToLatestLedgerResponse)

  admission_control.proto:88

  This API is used to update the client to the latest ledger version and optionally also request 1..n other pieces of data. This allows for batch queries. All queries return proofs that a client should check to validate the data. Note that if a client only wishes to update to the latest LedgerInfo and receive the proof of this latest version, they can simply omit the requested_items (or pass an empty list)

The request for submitting a transaction to an upstream validator or full node.

• oneof message

  • SubmitTransactionRequest submit_transaction_request = 1

  • SubmitTransactionResponse submit_transaction_response = 2

AC response status containing code and optionally an error message.

Used in: SubmitTransactionResponse

• AdmissionControlStatusCode code = 1

• string message = 2

Additional statuses that are possible from admission control in addition to VM statuses.

Used in: AdmissionControlStatus

• Accepted = 0

  Validator accepted the transaction.

• Blacklisted = 1

  The sender is blacklisted.

• Rejected = 2

  The transaction is rejected, e.g. due to incorrect signature.

----------------------------------------------------------------------------- ---------------- Submit transaction ----------------------------------------------------------------------------- The request for transaction submission.

Used as request type in: AdmissionControl.SubmitTransaction

Used as field type in: AdmissionControlMsg

• optional types.SignedTransaction transaction = 1

  Transaction submitted by user.

The response for transaction submission. How does a client know if their transaction was included? A response from the transaction submission only means that the transaction was successfully added to mempool, but not that it is guaranteed to be included in the chain. Each transaction should include an expiration time in the signed transaction. Let's call this T0. As a client, I submit my transaction to a validator. I now need to poll for the transaction I submitted. I can use the query that takes my account and sequence number. If I receive back that the transaction is completed, I will verify the proofs to ensure that this is the transaction I expected. If I receive a response that my transaction is not yet completed, I must check the latest timestamp in the ledgerInfo that I receive back from the query. If this time is greater than T0, I can be certain that my transaction will never be included. If this time is less than T0, I need to continue polling.

Used as response type in: AdmissionControl.SubmitTransaction

Used as field type in: AdmissionControlMsg

• oneof status

  The status of a transaction submission can either be a VM status, or some other admission control/mempool specific status e.g. Blacklisted.

  • types.VMStatus vm_status = 1

  • AdmissionControlStatus ac_status = 2

  • mempool_status.MempoolAddTransactionStatus mempool_status = 3

• bytes validator_id = 4

  Public key(id) of the validator that processed this transaction