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:16

  A request to fetch one or more blobs.

  • bytes blob_key = 1

    The key of the blob to fetch.

  message GetBlobReply

  relay.proto:22

  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:28

  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)

  message GetChunksReply

  relay.proto:99

  The reply to a GetChunks request.

  • 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)

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.