package validator
Get desktop application:
View/edit binary Protocol Buffers messages
service Dispersal
node_v2.proto:12Dispersal is utilized to disperse chunk data.
rpc GetNodeInfo (, )
node_v2.proto:20GetNodeInfo fetches metadata about the node.
rpc StoreChunks (, )
node_v2.proto:18StoreChunks 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
node_v2.proto:35Request that the Node store a batch of chunks.
optional 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
node_v2.proto:87StoreChunksReply 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.
service Retrieval
node_v2.proto:24Retrieval is utilized to retrieve chunk data.
rpc GetChunks (, )
node_v2.proto:27GetChunks 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
node_v2.proto:93The 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
node_v2.proto:134The 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 (, )
node_v2.proto:29Retrieve node info metadata
This describes how the chunks returned in GetChunksReply are encoded. Used to facilitate the decoding of chunks.
Used in:
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
message
node_v2.proto:146Node 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.
message
node_v2.proto:143The parameter for the GetNodeInfo() RPC.
Used as request type in: Dispersal.GetNodeInfo, Retrieval.GetNodeInfo
(message has no fields)
message
signing_rate.proto:30Contains signing rate information about a specific quorum.
Used in:
uint32 quorum_id = 1
The unique identifier of the quorum.
repeated validator_signing_rates = 2
The signing rates of individual validators in this quorum.
message
signing_rate.proto:39Signing rate information about validators during a particular time bucket.
Used in:
uint64 start_timestamp = 1
The start time of the bucket in seconds since Unix epoch, inclusive.
uint64 end_timestamp = 2
The end time of the bucket in seconds since Unix epoch, exclusive.
repeated quorum_signing_rates = 3
The signing rates for each quorum during the bucket time period.
message
signing_rate.proto:7Records information about validator signing rate during a time period.
Used in: , ,
bytes validator_id = 1
The unique identifier of the validator (i.e. the operator ID).
uint64 signed_batches = 2
The number of signed batches by the validator during the period.
uint64 unsigned_batches = 3
The number of unsigned batches by the validator during the period.
uint64 signed_bytes = 4
The total number of bytes signed during the period.
uint64 unsigned_bytes = 5
The total number of bytes unsigned during the period.
uint64 signing_latency = 6
Contains the sum of the time spent by the validator waiting for signing requests to be processed, in nanoseconds. Only batches that are signed are considered (i.e. if the validator does not succeed in signing a batch, the time spend in the attempt is not counted).