Sync Module
Spec

Sync Module

AnyChainBlock

FieldTypeLabelDescription
native_bytesbytesOriginal bytes as defined by the chain
cardanoutxorpc.v1alpha.cardano.BlockA parsed Cardano block.

BlockRef

Represents a reference to a specific block

FieldTypeLabelDescription
indexuint64Height or slot number (depending on the blockchain)
hashbytesHash of the content of the block

DumpHistoryRequest

Request to dump the block history.

FieldTypeLabelDescription
start_tokenBlockRefStarting point for the block history dump.
max_itemsuint32Maximum number of items to return.
field_maskgoogle.protobuf.FieldMaskField mask to selectively return fields.

DumpHistoryResponse

Response containing the dumped block history.

FieldTypeLabelDescription
blockAnyChainBlockrepeatedList of blocks in the history.
next_tokenBlockRefNext token for pagination.

FetchBlockRequest

Request to fetch a block by its reference.

FieldTypeLabelDescription
refBlockRefrepeatedList of block references.
field_maskgoogle.protobuf.FieldMaskField mask to selectively return fields.

FetchBlockResponse

Response containing the fetched blocks.

FieldTypeLabelDescription
blockAnyChainBlockrepeatedList of fetched blocks.

FollowTipRequest

Request to follow the tip of the blockchain.

FieldTypeLabelDescription
intersectBlockRefrepeatedList of block references to find the intersection.
field_maskgoogle.protobuf.FieldMaskField mask to selectively return fields.

FollowTipResponse

Response containing the action to perform while following the tip.

FieldTypeLabelDescription
applyAnyChainBlockApply this block.
undoAnyChainBlockUndo this block.
resetBlockRefReset to this block reference.

ReadTipRequest

Request to read the current tip of the blockchain.

ReadTipResponse

Response containing the current tip of the blockchain.

FieldTypeLabelDescription
tipBlockRefThe current tip of the blockchain.

SyncService

Service definition for syncing chain data.

Method NameRequest TypeResponse TypeDescription
FetchBlockFetchBlockRequestFetchBlockResponseFetch a block by its reference.
DumpHistoryDumpHistoryRequestDumpHistoryResponseDump the block history.
FollowTipFollowTipRequestFollowTipResponse streamFollow the tip of the blockchain.
ReadTipReadTipRequestReadTipResponseRead the current tip of the blockchain.