Mukan Erkin Törük
ef24c0b67e
Some checks are pending
docker-build-cometbft / vars (push) Waiting to run
docker-build-cometbft / build-images (amd64, ubuntu-24.04) (push) Blocked by required conditions
docker-build-cometbft / build-images (arm64, ubuntu-24.04-arm) (push) Blocked by required conditions
docker-build-cometbft / merge-images (push) Blocked by required conditions
docker-build-e2e-node / vars (push) Waiting to run
docker-build-e2e-node / build-images (amd64, ubuntu-24.04) (push) Blocked by required conditions
docker-build-e2e-node / build-images (arm64, ubuntu-24.04-arm) (push) Blocked by required conditions
docker-build-e2e-node / merge-images (push) Blocked by required conditions
70 lines
3.2 KiB
Markdown
70 lines
3.2 KiB
Markdown
---
|
|
order: 2
|
|
---
|
|
|
|
# Block Sync
|
|
|
|
## Channel
|
|
|
|
Block sync has one channel.
|
|
|
|
| Name | Number |
|
|
|-------------------|--------|
|
|
| BlocksyncChannel | 64 |
|
|
|
|
## Message Types
|
|
|
|
There are multiple message types for Block Sync
|
|
|
|
### BlockRequest
|
|
|
|
BlockRequest asks a peer for a block at the height specified.
|
|
|
|
| Name | Type | Description | Field Number |
|
|
|--------|-------|---------------------------|--------------|
|
|
| Height | int64 | Height of requested block | 1 |
|
|
|
|
### NoBlockResponse
|
|
|
|
NoBlockResponse notifies the peer requesting a block that the node does not contain it.
|
|
|
|
| Name | Type | Description | Field Number |
|
|
|--------|-------|---------------------------|--------------|
|
|
| Height | int64 | Height of requested block | 1 |
|
|
|
|
### BlockResponse
|
|
|
|
BlockResponse contains the block requested.
|
|
It also contains an extended commit _iff_ vote extensions are enabled at the block's height.
|
|
|
|
| Name | Type | Description | Field Number |
|
|
|-----------|----------------------------------------------------------------|---------------------------------|--------------|
|
|
| Block | [Block](../../../core/data_structures.md#block) | Requested Block | 1 |
|
|
| ExtCommit | [ExtendedCommit](../../../core/data_structures.md#extendedcommit) | Sender's LastCommit information | 2 |
|
|
|
|
### StatusRequest
|
|
|
|
StatusRequest is an empty message that notifies the peer to respond with the highest and lowest blocks it has stored.
|
|
|
|
> Empty message.
|
|
|
|
### StatusResponse
|
|
|
|
StatusResponse responds to a peer with the highest and lowest heights of any block it has in its blockstore.
|
|
|
|
| Name | Type | Description | Field Number |
|
|
|--------|-------|-------------------------------------------------------------------|--------------|
|
|
| Height | int64 | Current Height of a node | 1 |
|
|
| Base | int64 | First known block, if pruning is enabled it will be higher than 1 | 2 |
|
|
|
|
### Message
|
|
|
|
Message is a [`oneof` protobuf type](https://developers.google.com/protocol-buffers/docs/proto#oneof). The `oneof` consists of five messages.
|
|
|
|
| Name | Type | Description | Field Number |
|
|
|-------------------|-------------------------------------|--------------------------------------------------------------|--------------|
|
|
| block_request | [BlockRequest](#blockrequest) | Request a block from a peer | 1 |
|
|
| no_block_response | [NoBlockResponse](#noblockresponse) | Response saying it doe snot have the requested block | 2 |
|
|
| block_response | [BlockResponse](#blockresponse) | Response with requested block + (optionally) vote extensions | 3 |
|
|
| status_request | [StatusRequest](#statusrequest) | Request the highest and lowest block numbers from a peer | 4 |
|
|
| status_response | [StatusResponse](#statusresponse) | Response with the highest and lowest block numbers the store | 5 |
|