package validator

Get desktop application:
View/edit binary Protocol Buffers messages

Validator API for the Validator component.

• rpc BlockSubscription (BlockSubscriptionRequest, stream BlockSubscriptionResponse)

  validator.proto:29

  Streams signed blocks starting from the given block number (inclusive). Replays backed-up blocks first, then streams live blocks as they are signed. Unlike the RPC block subscription, the blocks streamed here carry no proofs; they must be commissioned separately as part of recovery.

  message BlockSubscriptionRequest

  validator.proto:44

  Request to subscribe to the signed block stream.

  • fixed32 block_from = 1

    The block number to start streaming from (inclusive).

  message BlockSubscriptionResponse

  validator.proto:50

  A signed block streamed to a subscriber.

  • bytes block = 1

    The block encoded using [miden_serde_utils::Serializable] implementation for [miden_protocol::block::SignedBlock].

  • fixed32 committed_chain_tip = 2

    The signed chain tip when this item was emitted.

• rpc GetTransactionEncryptionKey (google.protobuf.Empty, transaction.TransactionEncryptionKey)

  validator.proto:37

  Returns the public key that clients use to encrypt the private inputs of the transactions they submit, attested by this validator's own signing key. The encryption key is shared across the whole validator set, so the returned public key is identical regardless of which validator serves the request. The attestation carried in the response is specific to this validator.

• rpc SignBlock (blockchain.ProposedBlock, blockchain.SignBlockResponse)

  validator.proto:22

  Validates and signs a proposed block, returning the signature and the signed block commitment.

• rpc Status (google.protobuf.Empty, ValidatorStatus)

  validator.proto:16

  Returns the status info of the validator.

  message ValidatorStatus

  validator.proto:63

  Represents the status of the validator.

  • string version = 1

    The validator's running version.

  • string status = 2

    The validator's status.

  • fixed32 chain_tip = 3

    The validator's current chain tip (highest signed block number).

  • fixed64 validated_transactions_count = 4

    The total number of transactions validated by this validator.

  • fixed64 signed_blocks_count = 5

    The total number of blocks signed by this validator.

• rpc SubmitProvenTransaction (transaction.ProvenTransaction, google.protobuf.Empty)

  validator.proto:19

  Submits a transaction to the validator.