package relay

Get desktop application:
View/edit binary Protocol Buffers messages

Relay is a service that provides access to public relay functionality.

• rpc GetBlob (GetBlobRequest, GetBlobReply)

  relay.proto:9

  GetBlob retrieves a blob stored by the relay.

  message GetBlobRequest

  relay.proto:20

  A request to fetch one or more blobs.

  • bytes blob_key = 1

    The key of the blob to fetch.

  message GetBlobReply

  relay.proto:26

  The reply to a GetBlobs request.

  • bytes blob = 1

    The blob requested.

• rpc GetChunks (GetChunksRequest, GetChunksReply)

  relay.proto:12

  GetChunks retrieves chunks from blobs stored by the relay.

  message GetChunksRequest

  relay.proto:32

  Request chunks from blobs stored by this relay.

  • repeated ChunkRequest chunk_requests = 1

    The chunk requests. Chunks are returned in the same order as they are requested.

  • bytes operator_id = 2

    If this is an authenticated request, this should hold the ID of the operator. If this is an unauthenticated request, this field should be empty. Relays may choose to reject unauthenticated requests.

  • 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 operator_signature = 4

    If this is an authenticated request, this field will hold a BLS signature by the requester on the hash of this request. Relays may choose to reject unauthenticated requests. The following describes the schema for computing the hash of this request This algorithm is implemented in golang using relay.auth.HashGetChunksRequest(). All integers are encoded as unsigned 4 byte big endian values. Perform a keccak256 hash on the following data in the following order: 1. the length of the operator ID in bytes 2. the operator id 3. the number of chunk requests 4. for each chunk request: a. if the chunk request is a request by index: i. a one byte ASCII representation of the character "i" (aka Ox69) ii. the length blob key in bytes iii. the blob key iv. the start index v. the end index b. if the chunk request is a request by range: i. a one byte ASCII representation of the character "r" (aka Ox72) ii. the length of the blob key in bytes iii. the blob key iv. each requested chunk index, in order 5. the timestamp (seconds since the Unix epoch encoded as a 4 byte big endian value)

• rpc GetValidatorChunks (GetValidatorChunksRequest, GetChunksReply)

  relay.proto:16

  GetValidatorChunks retrieves all chunks allocated to a validator. The relay computes which chunks to return based on the deterministic chunk allocation algorithm.

  message GetValidatorChunksRequest

  relay.proto:111

  Request all chunks allocated to a specific validator. The relay determines which chunks to return based on deterministic allocation.

  • bytes validator_id = 1

    The ID of the validator requesting chunks.

  • bytes blob_key = 2

    The key of the blob to retrieve chunks for.

  • uint32 timestamp = 3

    Timestamp of the request in seconds since the Unix epoch.

  • bytes validator_signature = 4

    BLS signature by the requester on the hash of this request. Signing algorithm: Perform a keccak256 hash on the following data in order: 1. the domain separator string "relay.GetValidatorChunksRequest" 2. the length of the validator ID in bytes (4 byte big endian) 3. the validator ID bytes 4. the length of the blob key in bytes (4 byte big endian) 5. the blob key bytes 6. the timestamp (4 byte big endian)

A request for chunks within a specific blob. Requests are fulfilled in all-or-nothing fashion. If any of the requested chunks are not found or are unable to be fetched, the entire request will fail.

Used in: GetChunksRequest

• oneof request

  • ChunkRequestByIndex by_index = 1

    Request chunks by their individual indices.

  • ChunkRequestByRange by_range = 2

    Request chunks by a range of indices.

A request for chunks within a specific blob. Each chunk is requested individually by its index.

Used in: ChunkRequest

• bytes blob_key = 1

  The blob key.

• repeated uint32 chunk_indices = 2

  The index of the chunk within the blob.

A request for chunks within a specific blob. Each chunk is requested a range of indices.

Used in: ChunkRequest

• bytes blob_key = 1

  The blob key.

• uint32 start_index = 2

  The first index to start fetching chunks from.

• uint32 end_index = 3

  One past the last index to fetch chunks from. Similar semantics to golang slices.

The reply to a GetChunks request.

Used as response type in: Relay.GetChunks, Relay.GetValidatorChunks

• repeated bytes data = 1

  The chunks requested. The order of these chunks will be the same as the order of the requested chunks. data is the raw data of the bundle (i.e. serialized byte array of the frames)