package validator

Get desktop application:
View/edit binary Protocol Buffers messages

Dispersal is utilized to disperse chunk data.

• rpc StoreChunks (StoreChunksRequest, StoreChunksReply)

  node_v2.proto:18

  StoreChunks instructs the validator to store a batch of chunks. This call blocks until the validator either acquires the chunks or the validator determines that it is unable to acquire the chunks. If the validator is able to acquire and validate the chunks, it returns a signature over the batch header. This RPC describes which chunks the validator should store but does not contain that chunk data. The validator is expected to fetch the chunk data from one of the relays that is in possession of the chunk.

  message StoreChunksRequest

  node_v2.proto:35

  Request that the Node store a batch of chunks.

  • optional common.v2.Batch batch = 1

    batch of blobs to store

  • uint32 disperserID = 2

    ID of the disperser that is requesting the storage of the batch.

  • uint32 timestamp = 3

    Timestamp of the request in seconds since the Unix epoch. If too far out of sync with the server's clock, request may be rejected.

  • bytes signature = 4

    Signature using the disperser's ECDSA key over keccak hash of the batch. The purpose of this signature is to prevent hooligans from tricking validators into storing data that they shouldn't be storing. Algorithm for computing the hash is as follows. All integer values are serialized in big-endian order (unsigned). A reference implementation (golang) can be found at https://github.com/Layr-Labs/eigenda/blob/master/disperser/auth/request_signing.go 1. digest len(batch.BatchHeader.BatchRoot) (4 bytes, unsigned big endian) 2. digest batch.BatchHeader.BatchRoot 3. digest batch.BatchHeader.ReferenceBlockNumber (8 bytes, unsigned big endian) 4. digest len(batch.BlobCertificates) (4 bytes, unsigned big endian) 5. for each certificate in batch.BlobCertificates: a. digest certificate.BlobHeader.Version (4 bytes, unsigned big endian) b. digest len(certificate.BlobHeader.QuorumNumbers) (4 bytes, unsigned big endian) c. for each quorum_number in certificate.BlobHeader.QuorumNumbers: i. digest quorum_number (4 bytes, unsigned big endian) d. digest len(certificate.BlobHeader.Commitment.Commitment) (4 bytes, unsigned big endian) e. digest certificate.BlobHeader.Commitment.Commitment f digest len(certificate.BlobHeader.Commitment.LengthCommitment) (4 bytes, unsigned big endian) g. digest certificate.BlobHeader.Commitment.LengthCommitment h. digest len(certificate.BlobHeader.Commitment.LengthProof) (4 bytes, unsigned big endian) i. digest certificate.BlobHeader.Commitment.LengthProof j. digest certificate.BlobHeader.Commitment.Length (4 bytes, unsigned big endian) k. digest len(certificate.BlobHeader.PaymentHeader.AccountId) (4 bytes, unsigned big endian) l. digest certificate.BlobHeader.PaymentHeader.AccountId m. digest certificate.BlobHeader.PaymentHeader.Timestamp (4 bytes, signed big endian) n digest len(certificate.BlobHeader.PaymentHeader.CumulativePayment) (4 bytes, unsigned big endian) o. digest certificate.BlobHeader.PaymentHeader.CumulativePayment p digest len(certificate.BlobHeader.Signature) (4 bytes, unsigned big endian) q. digest certificate.BlobHeader.Signature r. digest len(certificate.Relays) (4 bytes, unsigned big endian) s. for each relay in certificate.Relays: i. digest relay (4 bytes, unsigned big endian) 6. digest disperserID (4 bytes, unsigned big endian) 7. digest timestamp (4 bytes, unsigned big endian) Note that this signature is not included in the hash for obvious reasons.

  message StoreChunksReply

  node_v2.proto:87

  StoreChunksReply is the message type used to respond to a StoreChunks() RPC.

  • bytes signature = 1

    The validator's BSL signature signed on the batch header hash.

• rpc GetNodeInfo (GetNodeInfoRequest, GetNodeInfoReply)

  node_v2.proto:20

  GetNodeInfo fetches metadata about the node.

Retrieval is utilized to retrieve chunk data.

• rpc GetChunks (GetChunksRequest, GetChunksReply)

  node_v2.proto:27

  GetChunks retrieves the chunks for a blob custodied at the Node. Note that where possible, it is generally faster to retrieve chunks from the relay service if that service is available.

  message GetChunksRequest

  node_v2.proto:93

  The parameter for the GetChunks() RPC.

  • bytes blob_key = 1

    The unique identifier for the blob the chunks are being requested for. The blob_key is the keccak hash of the rlp serialization of the BlobHeader, as computed here: https://github.com/Layr-Labs/eigenda/blob/0f14d1c90b86d29c30ff7e92cbadf2762c47f402/core/v2/serialization.go#L30

  • uint32 quorum_id = 2

    Which quorum of the blob to retrieve for (note: a blob can have multiple quorums and the chunks for different quorums at a Node can be different). The ID must be in range [0, 254].

  message GetChunksReply

  node_v2.proto:134

  The response to the GetChunks() RPC.

  • repeated bytes chunks = 1

    All chunks the Node is storing for the requested blob per GetChunksRequest.

  • ChunkEncodingFormat chunk_encoding_format = 2

    The format how the above chunks are encoded.

• rpc GetNodeInfo (GetNodeInfoRequest, GetNodeInfoReply)

  node_v2.proto:29

  Retrieve node info metadata

This describes how the chunks returned in GetChunksReply are encoded. Used to facilitate the decoding of chunks.

Used in: GetChunksReply

• UNKNOWN = 0

  A valid response should never use this value. If encountered, the client should treat it as an error.

• GNARK = 1

  A chunk encoded in GNARK has the following format: [KZG proof: 32 bytes] [Coeff 1: 32 bytes] [Coeff 2: 32 bytes] ... [Coeff n: 32 bytes] The KZG proof is a point on G1 and is serialized with bn254.G1Affine.Bytes(). The coefficients are field elements in bn254 and serialized with fr.Element.Marshal(). References: - bn254.G1Affine: github.com/consensys/gnark-crypto/ecc/bn254 - fr.Element: github.com/consensys/gnark-crypto/ecc/bn254/fr Golang serialization and deserialization can be found in: - Frame.SerializeGnark() - Frame.DeserializeGnark() Package: github.com/Layr-Labs/eigenda/encoding

Node info reply

Used as response type in: Dispersal.GetNodeInfo, Retrieval.GetNodeInfo

• string semver = 1

  The version of the node.

• string arch = 2

  The architecture of the node.

• string os = 3

  The operating system of the node.

• uint32 num_cpu = 4

  The number of CPUs on the node.

• uint64 mem_bytes = 5

  The amount of memory on the node in bytes.

The parameter for the GetNodeInfo() RPC.

Used as request type in: Dispersal.GetNodeInfo, Retrieval.GetNodeInfo

(message has no fields)