Data Structures
# | Field Name | Type | Length |
1 | Version (0x01) | Byte | 1 |
2 | Address scheme (0x54 for Testnet 0x57 for Mainnet) | Byte | 1 |
3 | Public key hash | Bytes | 20 |
4 | Checksum | Bytes | 4 |
Public key hash is first 20 bytes of SecureHash of public key bytes. Checksum is first 4 bytes of SecureHash of version, scheme and hash bytes. SecureHash is hash function sha256(Blake2b256(data)).
# | Field Name | Type | Length |
1 | Proof size (N) | Short | 2 |
2 | Proof | Bytes | N |
# | Field Name | Type | Length |
1 | Version (0x02 for Genesis block, 0x03 for common block) | Byte | 0 |
2 | Timestamp | Long | 1 |
3 | Parent block signature | Bytes | 64 |
4 | Consensus block length (always 40 bytes) | Int | 4 |
5 | Base target | Long | 8 |
6 | Generation signature* | Bytes | 32 |
7 | Transactions block length (N) | Int | 8 |
8 | Transaction #1 bytes | Bytes | M1 |
... | ... | ... | ... |
8 + (K - 1) | Transaction #K bytes | Bytes | MK |
9 + (K - 1) | Generator's public key | Bytes | 32 |
10 + (K - 1) | Block's signature | Bytes | 64 |
Generation signature is calculated as Blake2b256 hash of the following bytes:
# | Field Name | Type | Length |
1 | Previous block's generation signature | Bytes | 32 |
2 | Generator's public key | Bytes | 32 |
Block's signature is calculated from the following bytes:
# | Field Name | Type | Length |
1 | Version (0x02 for Genesis block, 0x03 for common block) | Byte | 0 |
2 | Timestamp | Long | 1 |
3 | Parent block signature | Bytes | 64 |
4 | Consensus block length (always 40 bytes) | Int | 4 |
5 | Base target | Long | 8 |
6 | Generation signature* | Bytes | 32 |
7 | Transactions block length (N) | Int | 8 |
8 | Transaction #1 bytes | Bytes | M1 |
... | ... | ... | ... |
8 + (K - 1) | Transaction #K bytes | Bytes | MK |
9 + (K - 1) | Generator's public key | Bytes | 32 |
All network messages shares the same structure except the Handshake.
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Payload | Bytes | N |
Magic Bytes are 0x12 0x34 0x56 0x78. Payload checksum is first 4 bytes of FastHash of Payload bytes. FastHash is hash function Blake2b256(data).
Handshake is used to start communication between two nodes.
# | Field name | Type | Length in Bytes |
1 | Application name length (N) | Byte | 1 |
2 | Application name (UTF-8 encoded bytes) | Bytes | N |
3 | Application version major | Int | 4 |
4 | Application version minor | Int | 4 |
5 | Application version patch | Int | 4 |
6 | Node name length (M) | Byte | 1 |
7 | Node name (UTF-8 encoded bytes) | Bytes | M |
8 | Node nonce | Long | 8 |
9 | Declared address length (K) or 0 if no declared address was set | Int | 4 |
10 | Declared address bytes (if length is not 0) | Bytes | K |
11 | Timestamp | Long | 8 |
GetPeers message is sent when sending node wants to know of other nodes on network.
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x01) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
Peers message is a reply on GetPeers message.
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x02) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Peers count (N) | Int | 4 |
7 | Peer #1 IP address | Bytes | 4 |
8 | Peer #1 port | Int | 4 |
... | ... | ... | ... |
6 + 2 * N - 1 | Peer #N IP address | Bytes | 4 |
6 + 2 * N | Peer #N port | Int | 4 |
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x14) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Block IDs count (N) | Int | 4 |
7 | Block #1 ID | Bytes | 64 |
... | ... | ... | ... |
6 + N | Block #N ID | Bytes | 64 |
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x15) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Block signatures count (N) | Int | 4 |
7 | Block #1 signature | Bytes | 64 |
... | ... | ... | ... |
6 + N | Block #N signature | Bytes | 64 |
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x16) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Block ID | Bytes | 64 |
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x17) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Block bytes (N) | Bytes | N |
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x18) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Score (N bytes) | BigInt | N |
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x19) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Transaction (N bytes) | Bytes | N |
# | Field name | Type | Length in Bytes |
1 | Packet length (BigEndian) | Int | 4 |
2 | Magic Bytes | Bytes | 4 |
3 | Content ID (0x64) | Byte | 1 |
4 | Payload length | Int | 4 |
5 | Payload checksum | Bytes | 4 |
6 | Checkpoint items count (N) | Int | 4 |
7 | Checkpoint #1 height | Long | 8 |
8 | Checkpoint #1 signature | Bytes | 64 |
... | ... | ... | ... |
6 + 2 * N - 1 | Checkpoint #N height | Long | 8 |
6 + 2 * N | Checkpoint #N signature | Bytes | 64 |
