On this page
  1. §0 The area in one paragraph
  2. §1 Where a value comes from: the parameter table, defaults, changes
  3. §2 Units, sizes and fixed identities
  4. §3 Participation-score constants
  5. §4 Block timing and size
  6. §5 Transaction limits and fee constants
  7. §6 Node registry, admission, liveness and the queue
  8. §7 Coinbase and maturity
  9. §8 Receipts and topology
  10. §9 Snapshots, pruning and the confirmed tail
  11. §10 Feature constants
  12. §11 Ledger event types
  13. §12 The consensus-parameter table
  14. §13 Governable parameters and their bounds
  15. §14 Chain types
  16. §15 The TestNet genesis inputs
  17. §16 Survival-mode and network-protocol constants
  18. §17 Local constants
  19. §18 Consensus and local; summary of defects

32 — Constants and consensus parameters: every value, where it comes from, which one the TestNet uses

Edition 0.6.1 · verified against the reference implementation, version 0.6.1 and the TestNet, DevNet and mainnet-template genesis files it ships

Out of scope how a value is applied (the owning document is named in every row); the genesis build procedure and the committed-config hash (06); the rule heights (29)

§0 The area in one paragraph

A value the protocol depends on comes from one of two places, and an implementation must know which. Consensus parameters are rows of the chain's parameter table, one integer per name, written once at height 0 from the chain's genesis file (06) and changed afterwards only by an applied governance vote (§13), every change logged so a popped block restores the old value; when a chain's genesis does not name a parameter, the implementation uses the default when absent given in §12 (a genesis that omits a value runs with that default, which is often not the TestNet value: an implementation that hard-codes defaults instead of reading the table forks at block 1). Compiled constants are the protocol's fixed numbers: sizes, prefixes and tags, scoring units, ledger event numbers, feature limits, windows. This chapter lists every value: the parameter table with its TestNet and DevNet-file values (§12), the eight governable prices and their bounds (§13), every compiled constant grouped by the document that applies it (§2–§11, §16), the ledger event numbers (§11), the TestNet genesis inputs (§15), and the local constants that decide nothing about validity but shape a node's behaviour on the network (§17).

§1 Where a value comes from: the parameter table, defaults, changes

Purpose. An implementation must resolve every parameter to the same number as every other node on the same chain, at every height.

Inputs. The chain's parameter table; the defaults of §12; applied governance votes (§13).

Output and effect.

  • Data model. Table consensus_parameters: parameter_name (text, the key), parameter_value (64-bit signed integer; booleans 0/1), description (text: the genesis builder's text of 06 §13, which a change of the value leaves in place; null on coinbase_total_distribution and on a row a change creates). Rule activation heights are rows of the same table named rule.<name> (and rule_off.<name>), resolved by 29. Log table consensus_parameter_change: parameter_name (text), had_row (0/1), old_value, new_value (64-bit), block_height (32-bit); one row per applied change. Both are created at genesis; the parameter table is snapshot state (26).
  • Resolution. value(name) = the row's integer when the row exists and holds an integer; else the default when absent (§12). A row that exists but is not an integer, read while a block is applied, is an error that fails that block on this node (never a silent default). Values that the protocol stores in 32-bit fields (max_priority_blocksmiths, max_transactions_per_block, max_block_size_bytes, max_rollback_height, topology_period_blocks, max_assigned_peers, receipt_batch_size, max_node_admittance_per_cycle, min_registry_size, linked_receipt_score, unlinked_receipt_score, batch_receipt_lookback_height, decrease_score_divider, the snapshot intervals and heights, spine_min_signatures, spine_signature_threshold_percent, spine_finality_depth, spine_level, spine_fallback_periods, survival_min_producers) take the low 32 bits of the row.
  • Derived values. blocks_per_week = 604,800 div block_time_interval (block_time_interval ≤ 0 → 15) = 40,320. When main_snapshot_interval = 0 and spine_snapshot_interval ≠ 0, the main snapshot interval and minimum height take the spine values. The priority-peer count P = max(2, max_assigned_peers) (23).
  • Changes. An applied governance count (§13) writes the new value at block h: the row is replaced and one consensus_parameter_change row is appended (had_row says whether a row existed, old_value the value before). A pop-off to target walks the log rows with block_height > target, newest first, restoring old_value (or deleting the row when had_row = 0), and deletes those log rows. Only the eight governable prices (§13) ever change; every other parameter is fixed for the chain's life, and an implementation may read it once.
  • Validation at genesis. The genesis builder refuses a parameter set (and a node refuses to start on a table) when any of: max_assigned_peers < 2; cumulative_difficulty_divisor ≤ 0; decrease_score_divider ≤ 0; block_time_interval ≤ 0; min_block_interval ≤ 0; coinbase_total_distribution, coinbase_number_rewards_per_second, coinbase_max_number_rewards_per_block ≤ 0; max_node_admittance_per_cycle < 1; receipt_batch_size < 1; max_priority_blocksmiths < 1; max_transactions_per_block < 1; max_rollback_height = 0; not (node_admission_min_delay > 0 and node_admission_max_delay > 0 and min ≤ max); node_admission_base_delay ≤ 0; node_admission_genesis_delay ≤ 0; with main_snapshot_interval > 0: main_snapshot_min_height = 0 or main_snapshot_interval < 3 × main_snapshot_min_height; with the spine enabled: spine_signature_threshold_percent (the required spine signatures as a percentage of the spine signers) outside (0, 100]. The builder alone also refuses: spine_signature_collection_timeout ≤ 0; max_block_size_bytes < 4,096; survival_min_producers (the fewest distinct blocksmiths before survival mode) outside 0…10,000, or, with two or more genesis registered nodes, above their number − 2 (with one, above 1); spine_late_vote_after_seconds outside 0…31,536,000; exit_cooldown_blocks < 2 × score_unit_floor_blocks; roll_call_blocks < 2; spine_fallback_periods < 1; main_snapshot_min_height < max_rollback_height + 20; and, for a new chain, a file whose rule_activation leaves out any rule of the activation table (29; its --check-rules mode reports each missing rule with the rule's compiled default height).

How to compute it. Read the table once at start-up for the fixed parameters; read the eight governable prices from the table whenever a charge or a count uses them.

Rule activation. None: the table exists from height 0.

Rejections and errors. The builder prints consensus params failed validation (n): …, listing every failure.

Vector. computed (TestNet file). INPUT: the TestNet table, name spine_fallback_periods (no row) → EXPECTED OUTPUT: 3. INPUT: block_time_interval row 15 → blocks_per_week 40,320. INPUT: survival_min_producers row 5 → N = 5; the mainnet template, which has no row → 0 (survival mode off). INVALID INPUT: a genesis with main_snapshot_interval 2,000 and main_snapshot_min_height 760 → refused (2,000 < 3 × 760 = 2,280); a genesis with 11 registered nodes and survival_min_producers 10 → refused (10 > 11 − 2). computed (the TestNet file as GET /api/v1/blockchain/fee-params echoes it before any vote): dataset_storage_cost_per_mib 5000000, storage_oracle_multiplier_ppm 1000000, min_payload_persistence_blocks 17280, block_time_interval 15, token_persist_period_cost 10000000, token_free_persist_blocks 172800, account_rent_period_cost 1000000, node_registration_minimum 10000000000.

Test cases · §1

8 cases · 6 valid · 2 invalid · 3 reference

spine_fallback_periods has no row on the testnet: its default applies32-1-absent-fallback-periodsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

value
3
The TestNet's survival_min_producers row 5: N = 532-1-survival-nvalid

Loading the test widget…

The mainnet template has no survival_min_producers row: N = 0, survival mode off32-1-survival-n-absentvalid

Loading the test widget…

blocks_per_week from a 15-second block_time_interval32-1-blocks-per-weekvalid

Loading the test widget…

A genesis with main_snapshot_interval 2,000 and main_snapshot_min_height 760 is refused (2,000 < 2,280)32-1-cadence-refusedinvalid

Loading the test widget…

The testnet cadence (172,800 and 760) passes32-1-cadence-testnetvalid

Loading the test widget…

A genesis with 11 registered nodes and survival_min_producers 10 is refused (10 > 11 − 2)32-1-survival-over-nodesinvalidreference

The same test as case 06-10-survival-over-nodes of chapter 06; the text is the genesis builder's.

A stated value: there is nothing to compute. The statement is a refusal: the exact text a compatible node answers.

same_as
06-10-survival-over-nodes
refusal
survival_min_producers (10) must not exceed node_count - 2 (9).
The values GET /api/v1/blockchain/fee-params echoes from the TestNet file before any vote32-1-testnet-readsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

dataset_storage_cost_per_mib
5000000
storage_oracle_multiplier_ppm
1000000
min_payload_persistence_blocks
17280
block_time_interval
15
token_persist_period_cost
10000000
token_free_persist_blocks
172800
account_rent_period_cost
1000000
node_registration_minimum
10000000000

Defects to match. The 32-bit fields truncate a row silently (a row of 2³² reads as 0).

§2 Units, sizes and fixed identities

Purpose. The numbers every byte layout and amount assumes.

Inputs. None; compiled.

Output and effect.

  • ONE_ZBC = 100,000,000: every ZBC amount is an int64 count of 10⁻⁸ ZBC.
  • PUBLIC_KEY_SIZE 32, SIGNATURE_SIZE 64, HASH_SIZE 32. A native account is 36 bytes: 4-byte little-endian account type ‖ 32-byte key (01).
  • The envelope signature of a sender, by account type (02, 03): 64 bytes for ZooBC (0), Solana (11), Polkadot (12) and Taproot (9; the parser takes every byte left and the verifier refuses anything but 64); 65 bytes (r ‖ s ‖ v, v 27 or 28 under eth_signature_canonical_v) for Ethereum (4) and Tron (15); 98 bytes (20 00 ‖ 32-byte key ‖ 64-byte signature) for Cardano (13) and Tezos (16); the carried-key form, every byte left in the envelope, [2-byte LE key length][33- or 65-byte secp256k1 key][64-byte compact ECDSA] = 99 or 131 bytes (never fewer than 99), for Bitcoin legacy (1), P2PKH (5), P2SH (6), P2WPKH (7) and Ripple (14) (P2WSH (8) parses the same way and cannot sign); 96 bytes for Estonia eID (3), which nothing verifies, so it cannot send; Empty (2), the dataset address (10) and unknown types 64 (none can send).
  • The account forms of 01 under canonical_account_forms: an Ethereum or Tron account is the type ‖ 20 Keccak bytes (24 bytes), a Bitcoin legacy, P2PKH or P2WPKH account the type ‖ 20 HASH160 bytes; the full-key forms (type ‖ 64-byte key; type ‖ 33- or 65-byte key) are refused wherever a transaction names an account.
  • The genesis sender account (exempt from balance checks, 03/06) = 00000000 ‖ 042643fd5c5f3b64bd6b38882f7727fdc5d6eee3c354f3ab9d7b8ff7c1840140 (ZBC_ODR3YPWN_FQBDD6SV_OJ3YO3PK_E5UVSXW3_5DYQ3PTL_AXSJKNQ4_UDLNXYXC); only an exact 36-byte match is that account.
  • The apps-pool account (16, 06) = 00000000 ‖ ASCII ZBCAPPS ‖ 00 ‖ 24 × 00.
  • CONFIRMATION_DEPTH 3: user-facing balance reads are served at max(0, tip − 3) (07, 31).
  • Time units: 604,800 s a week, 86,400 s a day, 3,600 s an hour, a year 31,536,000 s (365 days). Block units at 15-s blocks: a week 40,320 blocks, a day 5,760, an hour 240, a minute 4.

How to compute it. Nothing to compute.

Rule activation. None.

Rejections and errors. None here (01, 03).

Vector. computed: GET /api/v1/blockchain/fee-params echoes one_zbc = 100000000 on every chain. INPUT the 36 bytes 00000000042643fd…0140 → EXPECTED: the genesis sender; INPUT the 32-byte key alone → not the genesis sender. INPUT a Tron sender (type 15) → EXPECTED a 65-byte envelope signature; a Ripple sender (type 14) with a compressed key → 99 bytes; with an uncompressed key → 131. INVALID INPUT: a recipient 04000000 ‖ a 64-byte key (68 bytes) → refused a full-key account form (an Ethereum or Tron key, a Bitcoin key) is not an account: no transaction can be sent from it; name the 20-byte address (rule canonical_account_forms).

Test cases · §2

13 cases · 12 valid · 1 invalid · 4 reference

One ZBC is 100,000,000 atomic units32-2-one-zbcvalidreference

GET /api/v1/blockchain/fee-params echoes it on every chain.

A stated value: there is nothing to compute. A compatible node shows the same value.

one_zbc
100000000
Key, signature and hash sizes; the native account32-2-sizesvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

public_key
32
signature
64
hash
32
native_account
36
The 36-byte genesis sender account32-2-genesis-sendervalid

Loading the test widget…

Its 32-byte key alone is not the genesis sender32-2-genesis-key-alonevalid

Loading the test widget…

A Tron sender (type 15) signs with 65 bytes32-2-sig-tronvalid

Loading the test widget…

A Ripple sender (type 14) with a compressed key: 99 bytes32-2-sig-ripple-compressedvalid

Loading the test widget…

A Ripple sender with an uncompressed key: 131 bytes32-2-sig-ripple-uncompressedvalid

Loading the test widget…

A ZooBC sender signs with 64 bytes32-2-sig-zbcvalid

Loading the test widget…

A Cardano sender (type 13): 20 00 ‖ key ‖ signature, 98 bytes32-2-sig-cardanovalid

Loading the test widget…

The 24-byte form of an Ethereum account is an account32-2-form-eth-20valid

Loading the test widget…

A recipient 04000000 ‖ a 64-byte key (68 bytes) is refused32-2-form-eth-full-keyinvalid

Loading the test widget…

The apps-pool account32-2-apps-poolvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

account
000000005a42434150505300000000000000000000000000000000000000000000000000
Time units and block units at 15-second blocks32-2-time-unitsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

week_s
604800
day_s
86400
hour_s
3600
year_s
31536000
week_blocks
40320
day_blocks
5760
hour_blocks
240
minute_blocks
4
confirmation_depth
3

Defects to match. None.

§3 Participation-score constants

Purpose. The units by which a node's score moves (21, 23, 36).

Inputs. max_assigned_peers, block_time_interval, decrease_score_divider and the score-road parameters of §12.

Output and effect. MAX_PARTICIPATION_SCORE 10,000,000,000,000 (10¹³); default_participation_score 2,000,000,000,000 (20 %: every registered node starts there, genesis registered nodes included); linked_receipt_score = unlinked_receipt_score = 1; batch_receipt_lookback_height 40. The score road's numbers are parameters (36; default when absent in brackets): score_loss_per_unit_bps (500: 5 points of 100 per unit while missing), score_unit_floor_blocks (2,880), score_climb_ratio (8), maturity_units (4), liveness_miss_limit (4), node_lock_at_risk_bps (1,000), admission_genesis_seat_cap (11, the most genesis registered nodes counted in the admission pace). The receipt drift below the pivot is drift = 10¹³ div blocks_per_week div max(1, decrease_score_divider) = 10¹³ div 40,320 div 2 = 124,007,936 at 15-s blocks. loss_per_unit = 10¹³ div 10,000 × 500 = 5 × 10¹¹; climb_per_unit = loss_per_unit div 8 = 62,500,000,000; the unit clock advances 10¹² div unit per block (36). The receipt values used when the receipt cap is 0 (36 §2): the pivot P − 1 and the maximum receipt count P, with P = max(2, max_assigned_peers) (TestNet: 11 and 12).

How to compute it. Integer division toward zero.

Rule activation. None.

Rejections and errors. max_assigned_peers < 2 is refused (§1).

Vector. computed. INPUT: block_time_interval 15, decrease_score_divider 2 → EXPECTED: blocks_per_week 40,320, 10¹³ div 40,320 = 248,015,873, div 2 = 124,007,936. INPUT: score_loss_per_unit_bps 500, score_climb_ratio 8 → 500,000,000,000 and 62,500,000,000.

Test cases · §3

3 cases · 3 valid · 1 reference

The receipt drift, the loss and the climb per unit at 15-second blocks32-3-score-unitsvalid

Loading the test widget…

A chain without a block_time_interval row derives the drift from a 10-second block32-3-drift-no-rowvalid

Loading the test widget…

The score constants32-3-score-constantsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

max_participation_score
10000000000000
default_participation_score
2000000000000
linked_receipt_score
1
unlinked_receipt_score
1
batch_receipt_lookback_height
40
testnet_pivot
11
testnet_max_receipts
12

Defects to match. A chain without a block_time_interval row derives the drift from a 10-s block (10¹³ div 60,480 div 2).

§4 Block timing and size

Purpose. The timing and size numbers 05, 19, 20 and 24 apply.

Inputs. The parameters smithing_period, blocksmith_time_gap, blocksmith_network_tolerance, blocksmith_block_creation_time, min_block_interval, block_time_interval, max_priority_blocksmiths, cumulative_difficulty_divisor, max_block_size_bytes, max_transactions_per_block, max_rollback_height.

Output and effect. TestNet (§12): smithing period 15 s, time gap 15 s, network tolerance 5 s, block creation time 15 s, minimum block interval 15 s, block time interval 15 s, max_priority_blocksmiths 10 (also the round from which the previous blocksmith may produce, 36 §10), difficulty divisor 1,000,000, block size limit 524,288 bytes, 2,000 transactions per block, rollback limit 720 blocks. Compiled: MAX_BLOCK_SIZE 2,097,152 (the wire, queue and pool cap of a block message, 27; never the validity limit, which is max_block_size_bytes); at most max(500, max_transactions_per_block) transactions (2,000 on both chains) and 65,536 published receipts in a block message (27); the incomplete-block wait 120 s; the milestone jump 720 blocks; selection seeds ASCII zbc-blocksmith, turn salt ASCII saltbcs (7 bytes), coinbase seed ASCII zbc-coinbase (20, 21). The serialized block size (rule block_size_serialized, 05/19): size = |unsigned header bytes| + 64 + Σ |signed transaction bytes| + 1,288 × receipts, with 64 = the blocksmith signature, 1,288 = 232 (a published receipt's hashed bytes: sender 32 + recipient 32 + reference height 4 + reference hash 32 + datum type 4 + datum hash 32 + rmr 32 + signature 64) + a 1,056-byte proof allowance (intermediate_hashes at most 32 × 32 = 1,024 bytes + rmr_linked at most 32 bytes); a block above max_block_size_bytes is invalid (BlockTooLarge).

How to compute it. Read the parameters; apply them as 19/20 specify.

Rule activation. block_size_serialized, active from height 0 on every chain.

Rejections and errors. §1; BlockTooLarge (19).

Vector. computed. INPUT: unsigned header bytes 220, two transactions of 180 and 300 signed bytes, 3 published receipts → EXPECTED: 220 + 64 + 480 + 3 × 1,288 = 4,628 bytes; valid under the 524,288 limit. INVALID INPUT: the same block with one receipt whose intermediate_hashes holds 33 hashes (1,056 bytes, over the 1,024 bound) beside a 32-byte rmr_linked → BlockTooLarge: a receipt's proof fields are over their bound (1056 + 32 bytes); the measured size is still 4,628 (a receipt counts 1,288 whatever its proof carries).

Test cases · §4

4 cases · 3 valid · 1 invalid · 1 reference

A 220-byte header, transactions of 180 and 300 bytes and 3 receipts32-4-size-formulavalid

Loading the test widget…

The same block with one receipt whose intermediate_hashes holds 33 hashes beside a 32-byte rmr_linked32-4-proof-overinvalid

Loading the test widget…

A published receipt counts 232 + 1,056 = 1,288 bytes32-4-receipt-allowancevalid

Loading the test widget…

The testnet's timing and size parameters32-4-testnet-timingvalidreference

A block message carries at most max(500, max_transactions_per_block) transactions: 2,000 on both chains.

A stated value: there is nothing to compute. A compatible node shows the same value.

smithing_period
15
blocksmith_time_gap
15
blocksmith_network_tolerance
5
blocksmith_block_creation_time
15
min_block_interval
15
block_time_interval
15
max_priority_blocksmiths
10
cumulative_difficulty_divisor
1000000
max_block_size_bytes
524288
max_transactions_per_block
2000
max_rollback_height
720
MAX_BLOCK_SIZE
2097152
block_message_transactions
2000
block_message_receipts
65536

Defects to match. None.

§5 Transaction limits and fee constants

Purpose. The caps and fee units 03, 04, 12 and 17 apply.

Inputs. None; compiled, plus the fee-scale state (17).

Output and effect. MIN_FEE 2,500,000; MIN_NODE_REGISTRATION_FEE 2,500,000 (04); ONE_FEE_PER_BYTE_TRANSACTION 10,000; INITIAL_FEE_SCALE 1,000,000; the transfer fee's bounds 1 … 100,000,000 (17); MAX_TRANSACTION_BODY_LENGTH 65,536; the plain message cap 256 bytes and MAX_MESSAGE_LENGTH 64,000 where 03/12 say; MAX_ESCROW_INSTRUCTION_LENGTH 128,000; ESCROW_REQUEST_DECLINE_REASON_MAX 512 (12); TRANSACTION_EXPIRATION_OFFSET 3,600 s (the default expiry); TRANSACTION_FUTURE_TOLERANCE 3,600 s; TRANSACTION_EXPIRY_CAP 86,400 s (the longest a version-3 transaction's expiry may be, 03); TRANSACTION_REPLAY_WINDOW_SECONDS = 86,400 + 3,600 = 90,000 (the one replay window; in blocks at the fastest pace ⌈90,000 / max(1, min_block_interval − 2)⌉ = 6,924 at 15 s; the snapshot carries it, 26); COMPLETE_MINUTES_UNIT 60; TX_VERSION_SURVIVAL 2; the cancel tag ASCII ZBC-CANCEL (31); POOWN_EXPIRATION_BLOCKS 720 (09). The pools (local, 04): a transaction's minimum age before selection 10 s, the pool's expiry check every 300 s, at most 25,000 pool entries, 50 pending per sender, staging at most 500,000 entries and 256 MiB, staging expiry 3,600 s.

How to compute it. Nothing; apply as 03/04/17 state.

Rule activation. None here.

Rejections and errors. 03, 04.

Vector. computed: GET /api/v1/blockchain/fee-params on a fresh chain echoes min_fee 2500000, min_node_registration_fee 2500000, effective_min_fee 2500000 (the fee scale at its initial value), initial_fee_scale 1000000. INPUT min_block_interval 15 → EXPECTED replay window ⌈90,000 / 13⌉ = 6,924 blocks.

Test cases · §5

3 cases · 3 valid · 2 reference

The replay window at a 15-second minimum block interval32-5-replay-windowvalid

Loading the test widget…

The fee constants GET /api/v1/blockchain/fee-params echoes on a fresh chain32-5-fee-paramsvalidreference

effective_min_fee at the fee scale's initial value.

A stated value: there is nothing to compute. A compatible node shows the same value.

min_fee
2500000
min_node_registration_fee
2500000
effective_min_fee
2500000
initial_fee_scale
1000000
Transaction limits32-5-limitsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

ONE_FEE_PER_BYTE_TRANSACTION
10000
MAX_TRANSACTION_BODY_LENGTH
65536
plain_message_cap
256
MAX_MESSAGE_LENGTH
64000
MAX_ESCROW_INSTRUCTION_LENGTH
128000
ESCROW_REQUEST_DECLINE_REASON_MAX
512
TRANSACTION_EXPIRATION_OFFSET
3600
TRANSACTION_FUTURE_TOLERANCE
3600
TRANSACTION_EXPIRY_CAP
86400
COMPLETE_MINUTES_UNIT
60
TX_VERSION_SURVIVAL
2
POOWN_EXPIRATION_BLOCKS
720
fee_scale_bounds
1..100000000

Defects to match. None.

§6 Node registry, admission, liveness and the queue

Purpose. The numbers 09, 20, 21 and 36 apply to who may produce.

Inputs. The parameters node_admission_base_delay, node_admission_min_delay, node_admission_max_delay, node_admission_genesis_delay, max_node_admittance_per_cycle, min_node_registration_balance, min_node_registration_balance_ceiling, queue_median_fraction_bps, admission_genesis_seat_cap, exit_cooldown_blocks, roll_call_blocks, min_registry_size and those of §3; max_recovery_interval_seconds (no row on any chain: 3,600).

Output and effect. TestNet admission: base 51,840,000 s (600 days), minimum 604,800 s (7 days), maximum 7,776,000 s (90 days), genesis 604,800 s (the first admission 7 days after genesis); one admittance per cycle; genesis registered nodes count as at most admission_genesis_seat_cap 11 in the pace. The queue minimum (a votable price): min_node_registration_balance 10,000,000,000 (100 ZBC), votes within 1 … min_node_registration_balance_ceiling 25,000,000,000 (250 ZBC; 25,000,000,000 when absent); at entry a stake must also reach queue_median_fraction_bps 5,000 (half) of the median queued stake. Exit hold exit_cooldown_blocks 40,320. Roll call roll_call_blocks 20. The registry floor of the quorum rules: max(3, min_registry_size) = 7 on the TestNet. The lock share lost on an expulsion, an exit while missing or suspended, a queue drop or leaving the queue: node_lock_at_risk_bps 1,000 (10 %), credited to the longevity pool (ledger event 76).

Constant Value Meaning (document)
LIVENESS_FLOOR_ACTIVE 3 the fewest registered nodes expulsion leaves (36)
LIVENESS_SUSPENSION_FLOOR_BLOCKS 20 no suspension within this many blocks of a node's last own block (36)
EXIT_COOLDOWN_BLOCKS 40,320 exit_cooldown_blocks when absent (09, 36)
SEAT_CHANGE_DELAY_BLOCKS 120 a registered node's key rotation delay (09)
ROLL_CALL_BLOCKS_DEFAULT / minimum 20 / 2 the roll call (36)
NODE_CLAIM_DELAY_BLOCKS 40,320 the delay of a claim on a registered node (09)
QUEUE_ATTENDANCE_WINDOW_BLOCKS 5,760 a queued node's attendance window (09)
QUEUE_ATTENDANCE_MAX_AGE_BLOCKS 120 the oldest block an attendance may cite (09)
QUEUE_ATTENDANCE_MISSES_ALLOWED 2 the floor of the allowed missed attendance windows: allowed = max(2, node_admission_max_delay div (5,760 × smithing_period)) = 90 on the TestNet, 2 on the DevNet (09 §9)
ADMISSION_SMALL_REGISTRY_MAX_DELAY_SECONDS 604,800 the admission delay cap below the registry floor (09)
LIVENESS_ATTESTATION_WINDOW_BLOCKS 120 a ping's reference reach (09, 36)
LIVENESS_ATTESTATION_WINDOW_BASE 1,073,741,824 (2³⁰) (09)
EQUIVOCATION_EVIDENCE_MAX_AGE_BLOCKS 720 an EquivocationReport's evidence window (35)
SNAPSHOT_BLOCK_REFERENCE_REACH 720 the oldest block a transaction may cite (a proof of ownership's block, an equivocation report's parent, a queue attendance's block, a published receipt's reference block, a Solana carrier's recent block hash); a snapshot carries headers this far back (26, 34 §10)
MIN_ROLLBACK_BLOCKS 1,440 the blocks every node holds below its tip (the prune keeps them; a snapshot carries them, 26)
SIGNAL_WINDOW_BLOCKS 720 the floor of the readiness window (29)
SIGNAL_WINDOW_MAX_BLOCKS 1,440 (= MIN_ROLLBACK_BLOCKS) the cap of the readiness window under rule readiness_registry_schedule: W = min(max(720, 5 × counted registered nodes), 1,440), so a joiner, a pruned node and a full node tally the same headers (29)
ACTIVATION_FLOOR_BLOCKS 5,760 the readiness gate's floor: a release's registration plus one day is a gated bundle's whole schedule (29)
LIVENESS_STALL_ROUNDS 10 a block more than this many rounds after the previous one is a resume after a stall: no miss, no skip penalty (20, 36)
MAX_RECOVERY_INTERVAL_SECONDS 3,600 max_recovery_interval_seconds when absent (19, 24, 35)
ABSOLUTE_MIN_REGISTRY 3 the registry floor's minimum (17, 34)

A bridge attestation (fee-free duty, 34): an AttestEvent whose body starts with a uint32 LE length len, 1 ≤ len ≤ BRIDGE_DEPOSIT_EVENT_ID_MAX 200, 4 + len ≤ the body length, and an event id beginning with ASCII ZBRDEP1: or ZBWDR1:.

How to compute it. Parameters first, then the defaults of §12.

Rule activation. The liveness and queue rules of 09/29, active from height 0 on every chain; the numbers do not change by height.

Rejections and errors. §1.

Vector. computed. INPUT: a 100 ZBC lock (10,000,000,000), node_lock_at_risk_bps 1,000 → EXPECTED: 1,000,000,000 to the longevity pool, 9,000,000,000 back. INPUT: 11 counted registered nodes → signal_window_blocks = min(max(720, 55), 1,440) = 720 on /blockchain/rules; 300 counted registered nodes → min(1,500, 1,440) = 1,440.

Test cases · §6

7 cases · 7 valid · 1 reference

A 100 ZBC lock at 1,000 bps32-6-lock-at-riskvalid

Loading the test widget…

The signal window of 11 counted registered nodes: min(max(720, 55), 1,440)32-6-signal-windowvalid

Loading the test widget…

The signal window of 300 counted registered nodes: min(1,500, 1,440)32-6-signal-window-capvalid

Loading the test widget…

Allowed attendance misses on the testnet32-6-misses-testnetvalid

Loading the test widget…

Allowed attendance misses on the devnet file32-6-misses-devnetvalid

Loading the test widget…

Registry and liveness constants32-6-constantsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

LIVENESS_FLOOR_ACTIVE
3
LIVENESS_SUSPENSION_FLOOR_BLOCKS
20
EXIT_COOLDOWN_BLOCKS
40320
SEAT_CHANGE_DELAY_BLOCKS
120
ROLL_CALL_BLOCKS_DEFAULT
20
roll_call_minimum
2
NODE_CLAIM_DELAY_BLOCKS
40320
QUEUE_ATTENDANCE_WINDOW_BLOCKS
5760
QUEUE_ATTENDANCE_MAX_AGE_BLOCKS
120
QUEUE_ATTENDANCE_MISSES_ALLOWED
2
ADMISSION_SMALL_REGISTRY_MAX_DELAY_SECONDS
604800
LIVENESS_ATTESTATION_WINDOW_BLOCKS
120
EQUIVOCATION_EVIDENCE_MAX_AGE_BLOCKS
720
SNAPSHOT_BLOCK_REFERENCE_REACH
720
MIN_ROLLBACK_BLOCKS
1440
SIGNAL_WINDOW_BLOCKS
720
SIGNAL_WINDOW_MAX_BLOCKS
1440
ACTIVATION_FLOOR_BLOCKS
5760
LIVENESS_STALL_ROUNDS
10
MAX_RECOVERY_INTERVAL_SECONDS
3600
ABSOLUTE_MIN_REGISTRY
3
BRIDGE_DEPOSIT_EVENT_ID_MAX
200
testnet_registry_floor
7
LIVENESS_ATTESTATION_WINDOW_BASE is 2^3032-6-window-basevalid

Loading the test widget…

Defects to match. None.

§7 Coinbase and maturity

Purpose. The emission constants 21 applies.

Inputs. The chain metadata's coinbase_total_distribution (the derived pool, 06), coinbase_number_rewards_per_second, coinbase_max_number_rewards_per_block (the metadata values are used first; the parameters of §12 when the metadata has none).

Output and effect. TestNet pool 2,068,282,231,333,333 (computed by the genesis builder from the TestNet file, 06 §8); COINBASE_TIME = 15 × 31,536,000 = 473,040,000 s; COINBASE_SIGMOID_START 3.0, COINBASE_SIGMOID_END 6.0 (doubles; the curve in 21); rewards per second 1; at most 600 rewards per block; COINBASE_SMOOTHING_PER_WINNER 100,000,000. Maturity is the score road's (36 §7): maturity_units 4 units after admission plus one own block.

How to compute it. 21.

Rule activation. None.

Rejections and errors. §1.

Vector. computed: INPUT COINBASE_TIME = 15 years of 365 days → EXPECTED 473,040,000 s.

Test cases · §7

2 cases · 2 valid · 1 reference

COINBASE_TIME is 15 years of 365 days32-7-coinbase-timevalid

Loading the test widget…

The testnet's coinbase pool and emission constants32-7-poolvalidreference

Computed by the genesis builder from the testnet file (06 §8).

A stated value: there is nothing to compute. A compatible node shows the same value.

pool
2068282231333333
COINBASE_SIGMOID_START
3.0
COINBASE_SIGMOID_END
6.0
rewards_per_second
1
max_rewards_per_block
600
COINBASE_SMOOTHING_PER_WINNER
100000000
maturity_units
4

Defects to match. None: the pool itself is not a committed entry, but every input it is derived from is (TS: total supply, NOB: node operating balance, the funded accounts and stipends, 06 §3, §8).

§8 Receipts and topology

Purpose. The numbers 23 applies.

Inputs. receipt_batch_size (100), batch_receipt_lookback_height (40), linked_receipt_score/unlinked_receipt_score (1/1), receipt_lifecycle (TestNet 518,400 blocks), topology_period_blocks (40), max_assigned_peers (TestNet 12).

Output and effect. The topology period is 40 blocks; the scramble gap 40 and the scramble domain ASCII zbc-topology-v2 (23). Rule receipt_once (19, 23): a published receipt (identified by its recipient signature) may appear once in a block and not again in a main-chain block at a height in [h − 40, h); the window is the compiled 40, not the parameter. Rule receipt_reference_in_window (19, 23): a published receipt's reference block lies in the 720 blocks before the block (SNAPSHOT_BLOCK_REFERENCE_REACH) and must be held by the node and match its hash; an unheld reference is invalid on pruned and full-history nodes alike. The receipt-request digest (27): SHA3-256(ASCII ZBC-RCPT (8 bytes) ‖ genesis hash (32) ‖ datum type (1 byte: 1 block, 2 transaction, 3 batch) ‖ datum hash ‖ recipient node key (32)).

How to compute it. 23.

Rule activation. receipt_once, receipt_reference_in_window, active from height 0 on every chain.

Rejections and errors. §1 (receipt_batch_size ≥ 1); DuplicateReceiptInBlock, ReceiptAlreadyPublished (19).

Vector. computed. INPUT: a receipt published in the main-chain block at height 1,000 and the same recipient signature in a block at 1,040 → EXPECTED: ReceiptAlreadyPublished (1,000 lies in [1,000, 1,040)); the same receipt in a block at 1,041 → not refused by this rule (window [1,001, 1,041)). INVALID INPUT: one block carrying the same recipient signature twice → DuplicateReceiptInBlock.

Test cases · §8

4 cases · 2 valid · 2 invalid · 2 reference

A receipt published at 1,000 and again at 1,04032-8-once-1040invalid

Loading the test widget…

The same receipt in a block at 1,04132-8-once-1041valid

Loading the test widget…

One block carrying the same recipient signature twice32-8-twice-in-blockinvalidreference

A stated value: there is nothing to compute. The statement is a refusal: the exact text a compatible node answers.

refusal
DuplicateReceiptInBlock
Receipt and topology constants32-8-topologyvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

topology_period_blocks
40
scramble_gap
40
scramble_domain
zbc-topology-v2
receipt_batch_size
100
receipt_lifecycle_testnet
518400
receipt_request_tag
ZBC-RCPT

Defects to match. None.

§9 Snapshots, pruning and the confirmed tail

Purpose. The numbers 13, 25 and 26 apply.

Inputs. main_snapshot_interval (TestNet 172,800), main_snapshot_min_height (760), snapshot_manifest_expiration_seconds (0), spine_snapshot_interval (0), spine_snapshot_min_height (1,440), min_payload_persistence_blocks (17,280), max_rollback_height (720); block_time_interval 15.

Output and effect. Snapshot chunk size 102,400 bytes; snapshot format version 3 (a node refuses any other format, 26); the snapshot names 65 state tables (26; five of them travel only while their rule is active at the snapshot height, which on every chain is always: survival_state under survival_mode, readiness_bundle_decision under readiness_decision_state, spine_equivocation_charge under spine_equivocation_report, bridge_withdrawal_request under bridge_withdrawal_credit, chain_metadata under escrow_commission_nonnegative); manifest lifetime = max(the override, 3 × interval × block time, 2,592,000 s) = 7,776,000 s on the TestNet (the newest manifest never expires, 26); pruning deletes at most 500 rows per statement (13, 22); a node keeps 3 snapshot generations locally; SNAPSHOT_BLOCK_REFERENCE_REACH 720 (§6); the replay window 6,924 blocks (§5); the minimum rollback depth for pruning 1,440 blocks (13); CONFIRMATION_DEPTH 3. Fast sync needs at least 100 blocks of distance; a failed snapshot recovery backs off 120 s (26). The archive (26): snapshot_reward_share_ppm 100,000 (bounded 0…500,000), 64 chunks sampled per storage epoch, at most 2²² chunks in a snapshot, event prefix ASCII ZBCSNAP1:, chunk-name tag ASCII ZBC-ARCHIVE-CHUNK, piece-request tag ASCII ZBC-PIECE-REQ with a 300-s window (local), a minimum hold of 3,600 s (local). A chain without a main_snapshot_interval row uses 172,800.

How to compute it. 25, 26, 13.

Rule activation. 26/29.

Rejections and errors. §1.

Vector. computed. INPUT: interval 172,800, block time 15, override 0 → EXPECTED manifest lifetime max(0, 3 × 172,800 × 15, 2,592,000) = 7,776,000 s.

Test cases · §9

2 cases · 2 valid · 1 reference

The manifest lifetime on the testnet32-9-manifest-lifetimevalid

Loading the test widget…

Snapshot and archive constants32-9-snapshot-constantsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

chunk_size
102400
format_version
3
state_tables
65
prune_rows_per_statement
500
generations_kept
3
pruning_min_rollback
1440
fast_sync_min_distance
100
recovery_backoff_s
120
snapshot_reward_share_ppm
100000
chunks_sampled_per_epoch
64
max_chunks
4194304
event_prefix
ZBCSNAP1:
chunk_name_tag
ZBC-ARCHIVE-CHUNK
piece_request_tag
ZBC-PIECE-REQ
default_main_snapshot_interval
172800

Defects to match. The prune height is the newest manifest's height minus one interval (13).

§10 Feature constants

Purpose. Every remaining number a transaction or a periodic step applies, by owning document.

Inputs. The parameters named per group (§12).

Output and effect.

  • Datasets (10, 13, 22): dataset_storage_cost_per_mib (TestNet 5,000,000; 100,000,000 when absent); storage_oracle_multiplier_ppm 1,000,000; the billing period and the account-rent period are the snapshot cycle (main_snapshot_interval).
  • Tokens (14, 13): token_persist_period_cost (TestNet 10,000,000); token_free_persist_blocks (TestNet 172,800; one snapshot cycle when absent); MIN_TOKEN_PERSIST_BLOCKS 5,760.
  • Rent (13, 22): account_rent_period_cost (TestNet 1,000,000); at most 2,000 due rows read per block (the rent-exempt and group-member rows among them count toward the 2,000); rent draws from prepaid storage first, then the balance (ledger event 83).
  • Longevity (13): LONGEVITY_BILLING_PERIOD_BLOCKS 5,760; LONGEVITY_MIN_DEPOSIT 10,000,000.
  • Stored files and proofs (11, 22): STORE_FILE_MIN_DEPOSIT 1,000,000; STORE_FILE_MAX_PIECES 100,000; STORE_FILE_MAX_ALLOWED 16; storage_proof_epoch_blocks 240; storage_replication 5; piece size 1,048,576.
  • DFS (10): chunk size 1,048,576; file size at most 10,485,760; path at most 1,024 bytes; property prefixes ASCII dfs: and dfs:dir:.
  • Gateways (17, 22): the lock is the voted gateway_registration_cost (1,000,000,000 when absent); gateway_heartbeat_interval 240 (5,760 when absent); gateway_prune_grace 480 (11,520 when absent); the heartbeat freshness window 20.
  • Markets (15): exchange_taker_fee_bps 10 (held to 1…100 on every read); market_creation_cost 5,000,000,000 (held to its governance bounds on every read); MARKET_DEPOSIT_REFUND_FILLS 100; PRICE_SCALE 100,000,000.
  • Apps (16): APP_RAKE_BPS 100; APP_MAX_PAYOUT_FRAC_BPS 500; APP_MOVE_WINDOW 240; SETTLE_CHALLENGE_WINDOW 240; APPS_PAYOUT_INFLOW_WINDOW_BLOCKS 5,760; app_open_timeout_blocks 161,280 (28 days); app_unused_share_bps 1,000.
  • Batches (08, 14, 11): at most 25 payments, 32 token transfers, 1,000 storage proofs per batch.
  • Account groups (18): account_group_max_members 100; consent window 5,760 blocks; longest spend period 2,102,400 blocks; record base 96 bytes + 40 per member; at most 1,000 moved items; permission bits spend 0x01, tokens 0x02.
  • Split policy (08): at most 10 recipients; scale 10,000.
  • Oracle (17, 22): oracle_quorum 3.
  • Bridge (34): bridge_quorum_num/den 2/3; prefixes ASCII ZBRDEP1:, ZBWDR1:; memo ASCII ZBW1| (the withdrawal message is the memo and the destination, nothing else); event id at most 200 bytes; idle window 720 blocks; daily mint cap 1,000 bps (10 %) of supply, never below 100,000,000 units; custody account domain ASCII ZBC-BRIDGE-CUSTODY (custody = 00000000 ‖ SHA3-256(domain ‖ LE64(token id)), ZETH's 00000000b070ddf6…4df2); withdrawals open only for chain ethereum, asset native; one ZooBC unit of a coin = 10⁻⁸ of it, so one ZETH unit = 10¹⁰ wei (a release pays units × 10¹⁰ wei, a deposit mints floor(wei / 10¹⁰) units rounded to the coin's grain; keeper-side).
  • Schedules and vesting (08, 22): at most 520 fires; 4 consecutive skips; at most 3,153,600,000 s (100 years of 365 days).
  • Governance (17): vote prefix ASCII ZBCGOV1:; a release-veto vote counts for 172,800 blocks (30 days); an authority proposal applies once its oldest counted vote is 40,320 blocks old (a week).

How to compute it. Parameter first where one exists, else the default; the owning documents.

Rule activation. Per owning document.

Rejections and errors. Per owning document.

Vector. computed (the TestNet file as GET /api/v1/governance/params echoes it before any vote): gateway_registration_cost current 1000000000, exchange_taker_fee_bps 10, market_creation_cost 5000000000, min_node_registration_balance 10000000000. INPUT ZETH supply 450,000,000,000 → EXPECTED daily mint cap max(100,000,000, 45,000,000,000) = 45,000,000,000.

Test cases · §10

4 cases · 4 valid · 2 reference

Governed prices GET /api/v1/governance/params echoes from the TestNet file before any vote32-10-governedvalidreference

The current values.

A stated value: there is nothing to compute. A compatible node shows the same value.

gateway_registration_cost
1000000000
exchange_taker_fee_bps
10
market_creation_cost
5000000000
min_node_registration_balance
10000000000
The daily mint cap of ZETH at a supply of 450,000,000,00032-10-mint-capvalid

Loading the test widget…

A small supply mints at least 100,000,000 a day32-10-mint-cap-floorvalid

Loading the test widget…

Feature constants32-10-featuresvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

MIN_TOKEN_PERSIST_BLOCKS
5760
LONGEVITY_BILLING_PERIOD_BLOCKS
5760
LONGEVITY_MIN_DEPOSIT
10000000
STORE_FILE_MIN_DEPOSIT
1000000
STORE_FILE_MAX_PIECES
100000
STORE_FILE_MAX_ALLOWED
16
piece_size
1048576
dfs_file_max
10485760
dfs_path_max
1024
MARKET_DEPOSIT_REFUND_FILLS
100
PRICE_SCALE
100000000
APP_RAKE_BPS
100
APP_MAX_PAYOUT_FRAC_BPS
500
APP_MOVE_WINDOW
240
SETTLE_CHALLENGE_WINDOW
240
APPS_PAYOUT_INFLOW_WINDOW_BLOCKS
5760
batch_payments
25
batch_token_transfers
32
batch_storage_proofs
1000
account_group_max_members
100
group_consent_window
5760
group_longest_spend_period
2102400
split_max_recipients
10
split_scale
10000
oracle_quorum
3
schedule_max_fires
520
schedule_max_skips
4
schedule_max_seconds
3153600000
governance_vote_prefix
ZBCGOV1:

Defects to match. gateway_heartbeat_freshness_window is committed but read by nothing.

§11 Ledger event types

Purpose. The event_type numbers of ledger rows (07); an implementation must write the same number for the same cause.

Inputs. None; compiled.

Output and effect. Types 1–16 are the base types of 07; type 100 is an app payout (16). The others:

Type Name Written by (document)
17 DATASET_STORAGE_FEE 13, 22
18 DATASET_PRUNED 13, 22
19 DATASET_RENT_REWARD 22
20 TOKEN_EXPIRED 13
21 TOKEN_BACKING_RETURNED 13, 14
22 FEE_REFUND 04, 21
23 TRIGGER_FIRED 08
24 ACCOUNT_RENT_PAID 13
25 ACCOUNT_PRUNED 13
26 ORACLE_RESOLVED 17, 22 — written by nothing
27 BRIDGE_MINT 22 — written by nothing
28 VESTING_RELEASE 08, 22
29 SCHEDULE_PAID 08, 22
30 SCHEDULE_SKIPPED 22
31 GATEWAY_PRUNED 22
32 DATASET_DEPOSIT_REFUND 10, 13
33 DATASET_TRANSFERRED 10
34 SCHEDULE_CANCELLED 08
35 CONSENSUS_PARAM_CHANGED 17 — written by nothing
36 BRIDGE_BURN 22 — written by nothing
37 LONGEVITY_FUNDED 13
38 LONGEVITY_RENT 13
39 LONGEVITY_PAYOUT 13
40 LONGEVITY_REFUND 13
41 SPLIT_OUT 08
42 SPLIT_IN 08
43 ESCROW_FEE_HELD_RESERVED (never emitted) —
44 ESCROW_FEE_REFUND_RESERVED (never emitted) —
45 SURVIVAL_PAID 13
46 FEE_REFUND_IN_TOKEN 04
47 FEE_NOT_COLLECTED 04
48 GROUP_JOIN_OUT 18
49 GROUP_JOIN_IN 18
50 SURVIVAL_TO_POOL 13; 22 and 08 (rule failed_credit_to_pool: a credit the chain refuses for a state reason — an expired token's backing to a holder or its issuer, a fired trigger, a pruned gateway's stake, a schedule's remainder — is credited to the longevity pool under this event instead of being lost; the rows 21, 23, 31 and 34 are then not written for that credit)
51 STORED_FILE_FUNDED 11
52 TOKEN_BACKING_LOCKED 14
53 TOKEN_REDEEMED 14
54 SWAP_OFFER_LOCKED 15
55 SWAP_OFFER_RELEASED 15
56 EXCHANGE_TRADE 15
57 MARKET_CREATION_COST 15
58 ORDER_LOCKED 15
59 ORDER_RELEASED 15
60 EXCHANGE_TAKER_FEE 15
61 TRIGGER_LOCKED 08
62 TRIGGER_CANCELLED 08
63 SCHEDULE_LOCKED 08
64 GATEWAY_STAKE_LOCKED 17
65 GATEWAY_STAKE_RETURNED 17
66 APP_STAKE 16
67 APP_RAKE 16
68 PREPAID_STORAGE_FUNDED 10
69 STORED_FILE_RENT 11
70 MULTISIG_INNER_FEE 12
71 MARKET_DEPOSIT_REFUNDED 15 (not written under rule market_rent)
72 MARKET_RENT_FED 15 (a PlaceOrder/CancelOrder sender's fee share fed to the market's rent deposit, rule market_rent)
73 MARKET_PRUNED 15, 22 — written by nothing
74 BURN written by nothing (ZBC is never burned; lock shares go to the pool as 76). /blockchain/status sums it as burned_total, always 0; a wrapper coin's or user token's burn lowers that token's own supply, with no ZBC ledger row
75 LOTTERY_CARRY 21 (one row per movement on the lottery carry account: + what a block's lottery could pay to nobody, − what the next block's lottery takes in)
76 LOCK_SHARE_TO_POOL 09, 36 (the at-risk share of a lock lost on an expulsion, an exit while missing or suspended, a queue drop or leaving the queue, credited to the longevity pool; one positive row on the pool, transaction_id = the exit's transaction or the node's id)
77 ARCHIVE_REWARD 26 §10b (the storage-epoch reward of the honest archive holders; the pool's row negative, each owner's positive, transaction_id 0)
80 LOCK_FEE_TO_POOL 09, 04 (a fee a node pays out of its lock — a queued node's attendance, the fee of an exit or a claim whose lock is held — credited to the longevity pool; one positive row on the pool)
83 PREPAID_STORAGE_SPENT 13 (what an account's prepaid storage paid toward its own rent; positive, on the account; the rent row 24 / 17 carries the whole rent)
84 APP_UNUSED_TO_POOL 16 (the share kept from the stakes of a multiplayer app nobody started, credited to the pool; transaction_id = the app; each player's refund is an app payout, 100)

EVENT_TYPE_RENT_TO_POOL is another name for 19. 43 and 44 are reserved and never written; 78, 79, 81 and 82 are unused.

How to compute it. Copy the table.

Rule activation. Each event appears when its mechanism is active (29).

Rejections and errors. None.

Vector. computed: INPUT a lottery share of 17,954,340 atomic units paid to a node owner at height 12,507 in a block stamped 1,793,715,727 → EXPECTED OUTPUT: GET /api/v1/accounts/<owner>/movements?limit=1 answers {"movements":[{"balance_change":17954340,"block_height":12507,"direction":"in","event":"block_reward","event_type":8,"reference_id":"0","timestamp":1793715727}]} (07 names the base events; a coinbase share is type 8 with reference id 0).

Test cases · §11

2 cases · 2 valid · 2 reference

The ledger event type numbers beyond the base types 1-16 (100 is an app payout)32-11-event-typesvalidreference

43 and 44 are reserved and never written; 78, 79, 81 and 82 are unused; EVENT_TYPE_RENT_TO_POOL is another name for 19.

A stated value: there is nothing to compute. A compatible node shows the same value.

17
DATASET_STORAGE_FEE
18
DATASET_PRUNED
19
DATASET_RENT_REWARD
20
TOKEN_EXPIRED
21
TOKEN_BACKING_RETURNED
22
FEE_REFUND
23
TRIGGER_FIRED
24
ACCOUNT_RENT_PAID
25
ACCOUNT_PRUNED
26
ORACLE_RESOLVED
27
BRIDGE_MINT
28
VESTING_RELEASE
29
SCHEDULE_PAID
30
SCHEDULE_SKIPPED
31
GATEWAY_PRUNED
32
DATASET_DEPOSIT_REFUND
33
DATASET_TRANSFERRED
34
SCHEDULE_CANCELLED
35
CONSENSUS_PARAM_CHANGED
36
BRIDGE_BURN
37
LONGEVITY_FUNDED
38
LONGEVITY_RENT
39
LONGEVITY_PAYOUT
40
LONGEVITY_REFUND
41
SPLIT_OUT
42
SPLIT_IN
43
ESCROW_FEE_HELD_RESERVED
44
ESCROW_FEE_REFUND_RESERVED
45
SURVIVAL_PAID
46
FEE_REFUND_IN_TOKEN
47
FEE_NOT_COLLECTED
48
GROUP_JOIN_OUT
49
GROUP_JOIN_IN
50
SURVIVAL_TO_POOL
51
STORED_FILE_FUNDED
52
TOKEN_BACKING_LOCKED
53
TOKEN_REDEEMED
54
SWAP_OFFER_LOCKED
55
SWAP_OFFER_RELEASED
56
EXCHANGE_TRADE
57
MARKET_CREATION_COST
58
ORDER_LOCKED
59
ORDER_RELEASED
60
EXCHANGE_TAKER_FEE
61
TRIGGER_LOCKED
62
TRIGGER_CANCELLED
63
SCHEDULE_LOCKED
64
GATEWAY_STAKE_LOCKED
65
GATEWAY_STAKE_RETURNED
66
APP_STAKE
67
APP_RAKE
68
PREPAID_STORAGE_FUNDED
69
STORED_FILE_RENT
70
MULTISIG_INNER_FEE
71
MARKET_DEPOSIT_REFUNDED
72
MARKET_RENT_FED
73
MARKET_PRUNED
74
BURN
75
LOTTERY_CARRY
76
LOCK_SHARE_TO_POOL
77
ARCHIVE_REWARD
80
LOCK_FEE_TO_POOL
83
PREPAID_STORAGE_SPENT
84
APP_UNUSED_TO_POOL
A lottery share of 17,954,340 paid to a node owner at 12,507 is a block reward (type 8)32-11-movementvalidreference

In a block stamped 1,793,715,727; a coinbase share is type 8 with reference id 0 (07 names the base events).

A stated value: there is nothing to compute. A compatible node shows the same value.

request
GET /api/v1/accounts/<owner>/movements?limit=1
body
{"movements":[{"balance_change":17954340,"block_height":12507,"direction":"in","event":"block_reward","event_type":8,"reference_id":"0","timestamp":1793715727}]}

Defects to match. The numbering is historical (32/33 between 31 and 34; 70 before 71); never renumber.

§12 The consensus-parameter table

Purpose. One row per parameter name with the value of the TestNet genesis file and of the DevNet file at this commit, and the default an implementation uses when a genesis omits it.

Inputs. §1; the genesis files (a spine file's spine_* values override the main file's, 25).

Output and effect. The TestNet file names 83 parameters (every row below but max_recovery_interval_seconds, spine_fallback_periods and spine_late_vote_after_seconds), the DevNet file 84 (the TestNet's plus spine_late_vote_after_seconds), the mainnet template 82 (neither survival_min_producers nor spine_late_vote_after_seconds); the three rule_activation objects name the 125 rules of 29, all at 0, and their rule_off objects are empty (the builder refuses a new chain whose file omits a rule). The committed map of a chain holds its parameters + 125 rule.* entries; survival_min_producers and spine_late_vote_after_seconds are committed and stored only when the file names them. Both relaunched chains name survival_min_producers 5. Booleans are 0/1.

Parameter Default when absent TestNet DevNet file Governable Note Documents
account_group_max_members 100 100 100 06,18
account_rent_period_cost 100,000,000 1,000,000 100,000,000 yes 04,06,07,13,17,18,22,29,31
admission_genesis_seat_cap 11 11 11 the most genesis registered nodes counted in the admission pace 09,36
app_open_timeout_blocks 161,280 161,280 200 16
app_unused_share_bps 1,000 1,000 1,000 16
batch_receipt_lookback_height 40 40 40 06,13,22,23,26
block_time_interval 10 15 15 04,06,21,25,26,31
blocksmith_block_creation_time 30 15 15 06,19,20
blocksmith_network_tolerance 15 5 5 06,19,20
blocksmith_time_gap 10 15 15 06,19,20
bridge_quorum_den 3 3 3 06,17
bridge_quorum_num 2 2 2 06,17,22
chunk_replicas — 5 5 committed, never read 06
chunk_size_blocks — 1,440 1,440 committed, never read 06
coinbase_max_number_rewards_per_block 600 600 600 the chain metadata value is used first (21) 06,21
coinbase_number_rewards_per_second 1 1 1 the chain metadata value is used first (21) 06,21
coinbase_total_distribution 3,300,000,000,000,000 3,333,333,333,333,333 3,333,333,333,333,333 the chain metadata value is used first (21) 06,21
cumulative_difficulty_divisor 1,000,000 1,000,000 1,000,000 05,06,25
dataset_storage_cost_per_mib 100,000,000 5,000,000 100,000,000 yes 04,06,10,11,12,13,17,18,22,29,31
decrease_score_divider 2 2 2 06,21
default_participation_score 2,000,000,000,000 2,000,000,000,000 2,000,000,000,000 06,09,21
exchange_taker_fee_bps 10 10 10 yes 06,15,17,29
exit_cooldown_blocks 40,320 (builder: ≥ 2 × score_unit_floor_blocks) 40,320 1,680 09,36
gateway_heartbeat_freshness_window 20 20 20 committed, never read 06
gateway_heartbeat_interval 5,760 240 240 the genesis builder writes 240 when the file omits it 06,17,22
gateway_prune_grace 11,520 480 480 the genesis builder writes 480 when the file omits it 06,17,22
gateway_registration_cost 1,000,000,000 1,000,000,000 1,000,000,000 yes 04,06,17,29
linked_receipt_score 1 1 1 06,21
liveness_miss_limit 4 4 4 09,20,36
main_snapshot_interval 0 172,800 240 06,12,13,22,25,26,30
main_snapshot_min_height 1,440 760 80 06,25,26
market_creation_cost 5,000,000,000 5,000,000,000 5,000,000,000 yes 04,06,15,17,29
maturity_units 4 4 4 21,36
max_assigned_peers 5 12 8 06,21,23,28
max_block_size_bytes 88,000 (the compiled payload ceiling, 05 §10; the relay's pre-check reads the same row with the same fallback) 524,288 524,288 the genesis builder writes 2,097,152 when the file omits it and refuses a value under 4,096 04,05,06,19
max_node_admittance_per_cycle 1 1 1 06,09,21
max_priority_blocksmiths 4 10 10 05,06,19,20,24
max_recovery_interval_seconds 3,600 — — no row on any chain 19,24
max_rollback_height 720 720 60 06,13,19,22,24
max_transactions_per_block 500 (05 §10) 2,000 2,000 the genesis builder writes 1,000 when the file omits it 04,05,06,19
min_block_interval 10 15 15 06,19,20,25
min_node_registration_balance_ceiling 25,000,000,000 25,000,000,000 250,000,000 09,17
min_node_registration_balance 100,000,000 10,000,000,000 100,000,000 yes 06,09
min_payload_persistence_blocks see 04 17,280 240 04,06,31
min_registry_size 3 7 3 09,17,22,36
node_admission_base_delay 259,200,000 51,840,000 180 06,09
node_admission_genesis_delay 604,800 604,800 600 06,09,21
node_admission_max_delay 2,592,000 7,776,000 300 06,09
node_admission_min_delay 86,400 604,800 60 06,09
node_lock_at_risk_bps 1,000 1,000 1,000 09,36
node_operating_balance 1,000,000,000 (builder) 1,000,000,000 1,000,000,000 genesis only; committed to the config hash, not stored 06
oracle_quorum 3 3 3 06,11,17,22
queue_median_fraction_bps 5,000 (clamped 0…10,000) 5,000 5,000 09
receipt_batch_size 100 100 100 06,23
receipt_lifecycle none 518,400 1,440 06,13,22,23
roll_call_blocks 20 (builder ≥ 2) 20 20 36
score_climb_ratio 8 8 8 21,36
score_loss_per_unit_bps 500 500 500 36
score_unit_floor_blocks 2,880 2,880 120 36
smithing_period 15 15 15 06,20
snapshot_manifest_expiration_seconds 0 (override only) 0 0 06,25,26
snapshot_reward_share_ppm 100,000 (bounded 0…500,000) 100,000 100,000 26
spine_blocksmith_block_creation_time 300 300 300 06,25
spine_blocksmith_network_tolerance 150 150 150 06,25
spine_blocksmith_time_gap 100 100 100 06,25
spine_enabled 1 true true 06,30
spine_fallback_periods 3 (builder ≥ 1) — (3) — (3) 25
spine_finality_depth 3 3 3 06,25
spine_hierarchy_enabled 0 false false 06,25
spine_late_vote_after_seconds 10,800 — (10,800) 10,800 rule spine_late_vote: a spine block stamped this long after it was due is late (25); builder range 0…31,536,000; committed and stored only when named 25
spine_level 1 1 1 06,25
spine_min_signatures 2 5 5 06,25
spine_parent_period_multiplier 10 10 10 06,25
spine_signature_collection_timeout 60 60 60 06,25
spine_signature_threshold_percent 67 67 67 the required spine signatures as a percentage of the spine signers 06,25
spine_smithing_period 86,400 86,400 3,600 06,25
spine_snapshot_interval 0 0 0 06,25
spine_snapshot_min_height 1,440 1,440 1,440 06,25
storage_oracle_multiplier_ppm 1,000,000 1,000,000 1,000,000 yes 04,06,10,12,17,18,22,29,31
storage_proof_epoch_blocks 240 240 10 06,11,22,30
storage_replication see 11 5 5 06,11,22,30
survival_min_producers 0 (off) 5 5 the fewest distinct blocksmiths before survival mode (the mainnet template has no row: off); committed and stored only when the genesis names it; builder range 0…10,000 and at most the genesis registered nodes − 2 (§1) 36, 31
token_free_persist_blocks one snapshot cycle 172,800 240 04,06,13,31
token_persist_period_cost 100,000,000 10,000,000 100,000,000 yes 04,06,13,17,29,31
topology_period_blocks 40 40 40 06,23
unlinked_receipt_score 1 1 1 06,21

How to compute it. value = the row if present, else the default when absent; rule.<name> rows are resolved by 29.

Rule activation. None.

Rejections and errors. §1.

Vector. computed (the TestNet file at this commit): 83 parameters, every value above; the DevNet file 84; GET /api/v1/blockchain/fee-params and GET /api/v1/governance/params echo the file's rows on a fresh chain (§1, §10).

Test cases · §12

87 cases · 87 valid · 87 reference

The parameter account_group_max_members32-12-param-account-group-max-membersvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100
testnet
100
devnet_file
100
governable
no
The parameter account_rent_period_cost32-12-param-account-rent-period-costvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100,000,000
testnet
1,000,000
devnet_file
100,000,000
governable
yes
The parameter admission_genesis_seat_cap32-12-param-admission-genesis-seat-capvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
11
testnet
11
devnet_file
11
governable
no
The parameter app_open_timeout_blocks32-12-param-app-open-timeout-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
161,280
testnet
161,280
devnet_file
200
governable
no
The parameter app_unused_share_bps32-12-param-app-unused-share-bpsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,000
testnet
1,000
devnet_file
1,000
governable
no
The parameter batch_receipt_lookback_height32-12-param-batch-receipt-lookback-heightvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
40
testnet
40
devnet_file
40
governable
no
The parameter block_time_interval32-12-param-block-time-intervalvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
10
testnet
15
devnet_file
15
governable
no
The parameter blocksmith_block_creation_time32-12-param-blocksmith-block-creation-timevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
30
testnet
15
devnet_file
15
governable
no
The parameter blocksmith_network_tolerance32-12-param-blocksmith-network-tolerancevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
15
testnet
5
devnet_file
5
governable
no
The parameter blocksmith_time_gap32-12-param-blocksmith-time-gapvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
10
testnet
15
devnet_file
15
governable
no
The parameter bridge_quorum_den32-12-param-bridge-quorum-denvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
3
testnet
3
devnet_file
3
governable
no
The parameter bridge_quorum_num32-12-param-bridge-quorum-numvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
2
testnet
2
devnet_file
2
governable
no
The parameter chunk_replicas32-12-param-chunk-replicasvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
—
testnet
5
devnet_file
5
governable
no
The parameter chunk_size_blocks32-12-param-chunk-size-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
—
testnet
1,440
devnet_file
1,440
governable
no
The parameter coinbase_max_number_rewards_per_block32-12-param-coinbase-max-number-rewards-per-blockvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
600
testnet
600
devnet_file
600
governable
no
The parameter coinbase_number_rewards_per_second32-12-param-coinbase-number-rewards-per-secondvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1
testnet
1
devnet_file
1
governable
no
The parameter coinbase_total_distribution32-12-param-coinbase-total-distributionvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
3,300,000,000,000,000
testnet
3,333,333,333,333,333
devnet_file
3,333,333,333,333,333
governable
no
The parameter cumulative_difficulty_divisor32-12-param-cumulative-difficulty-divisorvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,000,000
testnet
1,000,000
devnet_file
1,000,000
governable
no
The parameter dataset_storage_cost_per_mib32-12-param-dataset-storage-cost-per-mibvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100,000,000
testnet
5,000,000
devnet_file
100,000,000
governable
yes
The parameter decrease_score_divider32-12-param-decrease-score-dividervalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
2
testnet
2
devnet_file
2
governable
no
The parameter default_participation_score32-12-param-default-participation-scorevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
2,000,000,000,000
testnet
2,000,000,000,000
devnet_file
2,000,000,000,000
governable
no
The parameter exchange_taker_fee_bps32-12-param-exchange-taker-fee-bpsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
10
testnet
10
devnet_file
10
governable
yes
The parameter exit_cooldown_blocks32-12-param-exit-cooldown-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
40,320 (builder: ≥ 2 × `score_unit_floor_blocks`)
testnet
40,320
devnet_file
1,680
governable
no
The parameter gateway_heartbeat_freshness_window32-12-param-gateway-heartbeat-freshness-windowvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
20
testnet
20
devnet_file
20
governable
no
The parameter gateway_heartbeat_interval32-12-param-gateway-heartbeat-intervalvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
5,760
testnet
240
devnet_file
240
governable
no
The parameter gateway_prune_grace32-12-param-gateway-prune-gracevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
11,520
testnet
480
devnet_file
480
governable
no
The parameter gateway_registration_cost32-12-param-gateway-registration-costvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,000,000,000
testnet
1,000,000,000
devnet_file
1,000,000,000
governable
yes
The parameter linked_receipt_score32-12-param-linked-receipt-scorevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1
testnet
1
devnet_file
1
governable
no
The parameter liveness_miss_limit32-12-param-liveness-miss-limitvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
4
testnet
4
devnet_file
4
governable
no
The parameter main_snapshot_interval32-12-param-main-snapshot-intervalvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
0
testnet
172,800
devnet_file
240
governable
no
The parameter main_snapshot_min_height32-12-param-main-snapshot-min-heightvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,440
testnet
760
devnet_file
80
governable
no
The parameter market_creation_cost32-12-param-market-creation-costvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
5,000,000,000
testnet
5,000,000,000
devnet_file
5,000,000,000
governable
yes
The parameter maturity_units32-12-param-maturity-unitsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
4
testnet
4
devnet_file
4
governable
no
The parameter max_assigned_peers32-12-param-max-assigned-peersvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
5
testnet
12
devnet_file
8
governable
no
The parameter max_block_size_bytes32-12-param-max-block-size-bytesvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
88,000 (the compiled payload ceiling, `05` §10; the relay's pre-check reads the same row with the same fallback)
testnet
524,288
devnet_file
524,288
governable
no
The parameter max_node_admittance_per_cycle32-12-param-max-node-admittance-per-cyclevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1
testnet
1
devnet_file
1
governable
no
The parameter max_priority_blocksmiths32-12-param-max-priority-blocksmithsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
4
testnet
10
devnet_file
10
governable
no
The parameter max_recovery_interval_seconds32-12-param-max-recovery-interval-secondsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
3,600
testnet
—
devnet_file
—
governable
no
The parameter max_rollback_height32-12-param-max-rollback-heightvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
720
testnet
720
devnet_file
60
governable
no
The parameter max_transactions_per_block32-12-param-max-transactions-per-blockvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
500 (`05` §10)
testnet
2,000
devnet_file
2,000
governable
no
The parameter min_block_interval32-12-param-min-block-intervalvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
10
testnet
15
devnet_file
15
governable
no
The parameter min_node_registration_balance_ceiling32-12-param-min-node-registration-balance-ceilingvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
25,000,000,000
testnet
25,000,000,000
devnet_file
250,000,000
governable
no
The parameter min_node_registration_balance32-12-param-min-node-registration-balancevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100,000,000
testnet
10,000,000,000
devnet_file
100,000,000
governable
yes
The parameter min_payload_persistence_blocks32-12-param-min-payload-persistence-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
see 04
testnet
17,280
devnet_file
240
governable
no
The parameter min_registry_size32-12-param-min-registry-sizevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
3
testnet
7
devnet_file
3
governable
no
The parameter node_admission_base_delay32-12-param-node-admission-base-delayvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
259,200,000
testnet
51,840,000
devnet_file
180
governable
no
The parameter node_admission_genesis_delay32-12-param-node-admission-genesis-delayvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
604,800
testnet
604,800
devnet_file
600
governable
no
The parameter node_admission_max_delay32-12-param-node-admission-max-delayvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
2,592,000
testnet
7,776,000
devnet_file
300
governable
no
The parameter node_admission_min_delay32-12-param-node-admission-min-delayvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
86,400
testnet
604,800
devnet_file
60
governable
no
The parameter node_lock_at_risk_bps32-12-param-node-lock-at-risk-bpsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,000
testnet
1,000
devnet_file
1,000
governable
no
The parameter node_operating_balance32-12-param-node-operating-balancevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,000,000,000 (builder)
testnet
1,000,000,000
devnet_file
1,000,000,000
governable
no
The parameter oracle_quorum32-12-param-oracle-quorumvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
3
testnet
3
devnet_file
3
governable
no
The parameter queue_median_fraction_bps32-12-param-queue-median-fraction-bpsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
5,000 (clamped 0…10,000)
testnet
5,000
devnet_file
5,000
governable
no
The parameter receipt_batch_size32-12-param-receipt-batch-sizevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100
testnet
100
devnet_file
100
governable
no
The parameter receipt_lifecycle32-12-param-receipt-lifecyclevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
none
testnet
518,400
devnet_file
1,440
governable
no
The parameter roll_call_blocks32-12-param-roll-call-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
20 (builder ≥ 2)
testnet
20
devnet_file
20
governable
no
The parameter score_climb_ratio32-12-param-score-climb-ratiovalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
8
testnet
8
devnet_file
8
governable
no
The parameter score_loss_per_unit_bps32-12-param-score-loss-per-unit-bpsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
500
testnet
500
devnet_file
500
governable
no
The parameter score_unit_floor_blocks32-12-param-score-unit-floor-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
2,880
testnet
2,880
devnet_file
120
governable
no
The parameter smithing_period32-12-param-smithing-periodvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
15
testnet
15
devnet_file
15
governable
no
The parameter snapshot_manifest_expiration_seconds32-12-param-snapshot-manifest-expiration-secondsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
0 (override only)
testnet
0
devnet_file
0
governable
no
The parameter snapshot_reward_share_ppm32-12-param-snapshot-reward-share-ppmvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100,000 (bounded 0…500,000)
testnet
100,000
devnet_file
100,000
governable
no
The parameter spine_blocksmith_block_creation_time32-12-param-spine-blocksmith-block-creation-timevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
300
testnet
300
devnet_file
300
governable
no
The parameter spine_blocksmith_network_tolerance32-12-param-spine-blocksmith-network-tolerancevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
150
testnet
150
devnet_file
150
governable
no
The parameter spine_blocksmith_time_gap32-12-param-spine-blocksmith-time-gapvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100
testnet
100
devnet_file
100
governable
no
The parameter spine_enabled32-12-param-spine-enabledvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1
testnet
true
devnet_file
true
governable
no
The parameter spine_fallback_periods32-12-param-spine-fallback-periodsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
3 (builder ≥ 1)
testnet
— (3)
devnet_file
— (3)
governable
no
The parameter spine_finality_depth32-12-param-spine-finality-depthvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
3
testnet
3
devnet_file
3
governable
no
The parameter spine_hierarchy_enabled32-12-param-spine-hierarchy-enabledvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
0
testnet
false
devnet_file
false
governable
no
The parameter spine_late_vote_after_seconds32-12-param-spine-late-vote-after-secondsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
10,800
testnet
— (10,800)
devnet_file
10,800
governable
no
The parameter spine_level32-12-param-spine-levelvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1
testnet
1
devnet_file
1
governable
no
The parameter spine_min_signatures32-12-param-spine-min-signaturesvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
2
testnet
5
devnet_file
5
governable
no
The parameter spine_parent_period_multiplier32-12-param-spine-parent-period-multipliervalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
10
testnet
10
devnet_file
10
governable
no
The parameter spine_signature_collection_timeout32-12-param-spine-signature-collection-timeoutvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
60
testnet
60
devnet_file
60
governable
no
The parameter spine_signature_threshold_percent32-12-param-spine-signature-threshold-percentvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
67
testnet
67
devnet_file
67
governable
no
The parameter spine_smithing_period32-12-param-spine-smithing-periodvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
86,400
testnet
86,400
devnet_file
3,600
governable
no
The parameter spine_snapshot_interval32-12-param-spine-snapshot-intervalvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
0
testnet
0
devnet_file
0
governable
no
The parameter spine_snapshot_min_height32-12-param-spine-snapshot-min-heightvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,440
testnet
1,440
devnet_file
1,440
governable
no
The parameter storage_oracle_multiplier_ppm32-12-param-storage-oracle-multiplier-ppmvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1,000,000
testnet
1,000,000
devnet_file
1,000,000
governable
yes
The parameter storage_proof_epoch_blocks32-12-param-storage-proof-epoch-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
240
testnet
240
devnet_file
10
governable
no
The parameter storage_replication32-12-param-storage-replicationvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
see 11
testnet
5
devnet_file
5
governable
no
The parameter survival_min_producers32-12-param-survival-min-producersvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
0 (off)
testnet
5
devnet_file
5
governable
no
The parameter token_free_persist_blocks32-12-param-token-free-persist-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
one snapshot cycle
testnet
172,800
devnet_file
240
governable
no
The parameter token_persist_period_cost32-12-param-token-persist-period-costvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
100,000,000
testnet
10,000,000
devnet_file
100,000,000
governable
yes
The parameter topology_period_blocks32-12-param-topology-period-blocksvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
40
testnet
40
devnet_file
40
governable
no
The parameter unlinked_receipt_score32-12-param-unlinked-receipt-scorevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

default_when_absent
1
testnet
1
devnet_file
1
governable
no
The parameters and rules the three genesis files name32-12-countsvalidreference

TestNet: every parameter of the table but max_recovery_interval_seconds, spine_fallback_periods and spine_late_vote_after_seconds; DevNet: the TestNet's plus spine_late_vote_after_seconds; the mainnet template names neither survival_min_producers nor spine_late_vote_after_seconds. GET /api/v1/blockchain/fee-params and /governance/params echo the file's rows on a fresh chain.

A stated value: there is nothing to compute. A compatible node shows the same value.

testnet_parameters
83
devnet_parameters
84
mainnet_template_parameters
82
rules
125
rule_heights
0
rule_off
empty

Defects to match. Several defaults when absent differ from the TestNet file (blocksmith_time_gap 10 vs 15, blocksmith_network_tolerance 15 vs 5, blocksmith_block_creation_time 30 vs 15, min_block_interval and block_time_interval 10 vs 15, max_priority_blocksmiths 4 vs 10, max_transactions_per_block 1,000 vs 2,000, max_block_size_bytes 2,097,152 vs 524,288, max_assigned_peers 5 vs 12, the four admission delays, main_snapshot_interval 0 vs 172,800, main_snapshot_min_height 1,440 vs 760): a genesis must name them. coinbase_number_rewards_per_second, coinbase_max_number_rewards_per_block and snapshot_manifest_expiration_seconds are committed to the config hash and used through the metadata or as an override; node_operating_balance is committed but not stored.

§13 Governable parameters and their bounds

Purpose. Which parameters a vote may move, within which bounds, how a vote is encoded and how a cycle's votes are counted.

Inputs. A SetConsensusParam vote's event id (17); the current value; the table below; the snapshot cycle L (main_snapshot_interval, 172,800 when absent); the counted registered nodes (registered, not suspended) at the block before the count; min_registry_size; the survival flag of the count block (36 §12).

Output and effect. Exactly eight names are governable; every other name is refused. Bounds are inclusive:

Name Floor Ceiling
storage_oracle_multiplier_ppm 100,000 10,000,000
dataset_storage_cost_per_mib 1 10,000,000,000
account_rent_period_cost 1 1,000,000,000 (10 ZBC; rule governance_window)
token_persist_period_cost 1 1,000,000,000 (rule governance_window)
gateway_registration_cost 1 1,000,000,000,000
exchange_taker_fee_bps 1 100
market_creation_cost 1 1,000,000,000,000
min_node_registration_balance (the queue minimum) 1 the chain's min_node_registration_balance_ceiling (TestNet 25,000,000,000; a stated ceiling below the floor is ignored)

The transfer fee (fee_scale, 17) is counted the same way with bounds 1 … 100,000,000 but keeps its commit-reveal casting (FeeVoteCommitment in the first half of the cycle, FeeVoteReveal in the second).

How to compute it.

  1. A vote. Event id = ASCII ZBCGOV1: ‖ name ‖ : ‖ decimal value (an optional leading -, then digits only; split at the last :; parsed as int64, overflow → not a vote). The name must be governable and the value within its bounds at the height (no step check at casting). Only a registered node key votes, fee 0.
  2. The count, at the end of the cycle's last block k × L + L (a cycle is blocks k × L + 1 … (k + 1) × L; a vote in that block counts for the cycle it closes). Skipped entirely when the block's survival flag is true (the cycle's votes lapse, 36 §12) or when the counted registered nodes are fewer than max(3, min_registry_size) nodes or distinct owners. For each of the eight prices: in_force = its row, or its default when absent; take each counted registered node's latest vote of the cycle; when no registered node voted, nothing moves; otherwise t = clamp(in_force, floor, ceiling), each vote limited to clamp(v, max(floor, ⌈t / 2⌉), min(ceiling, t + max(1, t div 5))) (+20 % up and at least one unit, half down), every silent counted registered node counts as t, and next = clamp(round_half_up(Σ / n), floor, ceiling) with n = the number of counted registered nodes; the parameter is written (§1, a change row appended) only when next ≠ in_force.
  3. Two reads hold the value on every read: the taker fee to [1, 100] and every governed charge to its bounds.

Rule activation. governance_window, quorum_floor, release_registry_veto, survival_mode (the skip), active from height 0 on every chain.

Rejections and errors. parameter is not governable: <name>, <name> below its floor (<v> < <floor>), <name> above its ceiling (<v> > <ceiling>); a vote beyond the step is accepted and limited at the count; in survival mode the transaction itself is refused (36 §12).

Vector. computed. INPUT: account_rent_period_cost = 1,000,000, 7 counted registered nodes, votes 2,000,000 and 400,000 from two of them → EXPECTED: limited to 1,200,000 and 500,000; Σ = 1,200,000 + 500,000 + 5 × 1,000,000 = 6,700,000; next = round(6,700,000 / 7) = 957,143. INPUT: a price of 1 unit with one vote of 10 and 7 counted registered nodes → limited to 2; next = round(8 / 7) = 1. INPUT: event id ZBCGOV1:exchange_taker_fee_bps:12 → name exchange_taker_fee_bps, value 12. INVALID INPUT: ZBCGOV1:max_block_size_bytes:600000 → parameter is not governable: max_block_size_bytes; ZBCGOV1:exchange_taker_fee_bps:101 → exchange_taker_fee_bps above its ceiling (101 > 100).

Test cases · §13

6 cases · 4 valid · 2 invalid · 1 reference

Two votes on account_rent_period_cost among 7 counted registered nodes32-13-count-rentvalid

Loading the test widget…

A price of 1 unit with one vote of 10 among 7 registered nodes32-13-count-one-unitvalid

Loading the test widget…

Read the vote ZBCGOV1:exchange_taker_fee_bps:1232-13-votevalid

Loading the test widget…

A vote on max_block_size_bytes32-13-not-governableinvalid

Loading the test widget…

A taker fee of 101 bps32-13-above-ceilinginvalid

Loading the test widget…

The eight governable prices and their bounds32-13-boundsvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

storage_oracle_multiplier_ppm
100000..10000000
dataset_storage_cost_per_mib
1..10000000000
account_rent_period_cost
1..1000000000
token_persist_period_cost
1..1000000000
gateway_registration_cost
1..1000000000000
exchange_taker_fee_bps
1..100
market_creation_cost
1..1000000000000
min_node_registration_balance
1..min_node_registration_balance_ceiling (testnet 25000000000)

Defects to match. None.

§14 Chain types

Purpose. The two chains a node keeps and how they are named.

Inputs. None; compiled.

Output and effect. Chain type 0 = the main chain, 1 = the spine chain; on the wire a ChainType field ≠ 1 means the main chain (27). The block tables are main_block and spine_block (07, 25). The main chain has transactions and snapshots; the spine chain has neither. The genesis of each chain is its block 0 built from its genesis file (06, 25); no other genesis value exists.

How to compute it. Nothing.

Rule activation. None.

Rejections and errors. None.

Vector. computed: GET /api/v1/spine/blocks/0 answers the spine genesis block of the spine file (25), height 0 and timestamp = the file's genesis_timestamp (1,793,509,027 in both shipped spine files); a ChainType of 1 on the wire names that chain, any other value the main chain.

Test cases · §14

1 case · 1 valid · 1 reference

GET /api/v1/spine/blocks/0 answers the spine file's block 032-14-spine-genesisvalidreference

The timestamp is the spine file's genesis_timestamp (both shipped spine files); a ChainType of 1 on the wire names the spine chain, any other value the main chain.

A stated value: there is nothing to compute. A compatible node shows the same value.

height
0
timestamp
1793509027
main_chain_type
0
spine_chain_type
1

Defects to match. None.

§15 The TestNet genesis inputs

Purpose. What the TestNet's genesis file committed, so an implementation can rebuild its block 0 and height-0 state (06) and recognise the chain.

Inputs. The TestNet genesis-config.json and spine-genesis-config.json at this commit.

Output and effect.

Field TestNet
chain_id zoobc-test
timestamp 1,793,509,027 (2026-11-01 04:57:07 UTC); the spine file's genesis_timestamp the same
total_supply 3,333,333,333,333,333
Genesis hash (block 0) the builder's output over this file (06 §3: the config hash commits every parameter and rule height, so the hash is fixed by the file alone)
Spine genesis hash the spine file's block 0 (25)
accounts 61: the treasury ZBC_CIHOJSU5_…_5ADSND7R 100,000,000,000,000 first (every genesis token's issuer); the market maker 10,000,000,000,000; the release authority 100,000,000,000; the 11 node owners 10,000,000,000,000 each; FAUCET 0; Vest-Funder 5,000,000,000,000, Vest-Dry 2,500,000,000,000, Vest-R1…R6 0; 38 test wallets (Storage-Payer 10,000,000,000,000; Token-Issuer 5,000,000,000,000; Stress-01…10, Multisig-1…3, Bridge-Tester 100,000,000,000; Rent-Low 100,000,000; Rent-Dust 2,000,000; the rest 1,000,000,000,000); Σ ZBC 264,000,102,000,000; the page authority has no row
Token stipends 27 accounts hold the 14 genesis coins: the treasury and the market maker ZUSD/ZEUR/ZCNY 100,000,000,000,000, ZBTC 10,000,000,000, ZETH 100,000,000,000, ZSOL/ZDOT 1,000,000,000,000, ZBNB 100,000,000,000, ZADA/ZXRP/ZTRX 100,000,000,000,000, ZXTZ 10,000,000,000,000, ZUSDC/ZUSDT 10,000,000,000,000; 25 others one tenth of each (ZBTC supply 45,000,000,000, observed)
genesis_tokens 14, ids 1–14: ZUSD, ZEUR, ZCNY (no chain); ZBTC bitcoin, ZETH ethereum, ZSOL solana, ZDOT polkadot, ZBNB bsc, ZADA cardano, ZXRP ripple, ZTRX tron, ZXTZ tezos (asset native); ZUSDC and ZUSDT ethereum ERC-20 (asset = the contract address); ZBTC/ZETH/ZUSDC/ZUSDT carry a deposit_address (34)
nodes 11 (node_public_key, owner_account)
vesting 6: treasury → FAUCET 160,000,000,000 × 600 every 86,400 s, cliff 0, cancel policy 1, funding mode 1 (pull); Vest-Funder → Vest-R1 (mint, revocable), R2 (mint, irrevocable), R4 (pull, irrevocable), each 10,000,000,000 × 52 every 86,400 s with cliff 86,400; → R3 (pull, revocable) the same with cliff 172,800; → R5 token 1 (ZUSD) 100,000,000,000 × 24, pull, revocable, cliff 86,400
gateways 1: ZBG_SPF4XQ7D_…_SCFK2UQO, domain zoobc.network
archival_nodes 1 (one of the 11 nodes), same owner and domain
relays 1: ZBR_G4AI7SMF_…, same owner, relay.zoobc.network
release_authority ZBC_PWF5RJA5_Z3VETBWR_5GO75GOK_SMBYOS34_HKWH53WN_MCUC6YMQ_EVZAAFOQ (1,000 ZBC, no coin)
page_authority ZBC_HA74WBYC_IIU6WTAN_FL4OIDCX_P5OIC7U5_JVOHP2JJ_3KYANFVK_66CTTMJF (holds nothing)
treasury ZBC_CIHOJSU5_EWGXKZLJ_AHWEQNZX_HYDXMM3J_VV263DLD_7IY4PYFX_5ADSND7R
market_maker ZBC_UTDINPWS_FOYVCPDG_6GVSTMPS_TB6AQBIK_RJ5FVIGL_6XA2DQPZ_I2YCZ5PO
apps_treasury ZBC 1,000,000,000,000,000; ZUSD, ZEUR, ZCNY 100,000,000; ZBTC 10,000,000,000; ZETH 1,000,000,000,000; ZSOL, ZDOT 10,000,000,000,000; ZBNB, ZADA, ZXRP, ZTRX 1,000,000,000,000; ZXTZ 100,000,000,000; ZUSDC, ZUSDT 1,000,000,000,000
rule_activation the 125 names of 29, all 0; rule_off empty
consensus_params the 83 parameters of §12
Spine spine_chain_id / version zoobc-spine-test / 1
Spine initial_blocksmiths 11 = exactly the 11 registry node keys
Spine consensus_params 14 keys, spine_smithing_period 86,400

The DevNet file (chain_id zoobc-dev, spine zoobc-spine-dev) carries the same timestamp, total supply, 61 accounts, 14 tokens and 11 nodes, the DevNet column of §12 (84 parameters) and the same 125 rules at 0.

How to compute it. 06 (the build procedure, the committed config data, the pool). The TestNet pool is 2,068,282,231,333,333 (§7).

Rule activation. 29.

Rejections and errors. 06 (a node whose block 0 hash differs from its peers' never completes a handshake, 27).

Vector. computed: the account sums above; GET /api/v1/blockchain/rules on either chain lists 125 rules, each with "height":0,"source":"consensus_parameters". INVALID INPUT: the TestNet file with survival_min_producers removed builds to another config hash, so a node built from it never completes a handshake with the chain's nodes; the file with one rule name removed is refused by the builder (§1).

Test cases · §15

8 cases · 6 valid · 2 invalid · 8 reference

The TestNet genesis inputs32-15-identityvalidreference

The genesis hash is the builder's output over this file (06 §3); the spine genesis hash is the spine file's block 0 (25).

A stated value: there is nothing to compute. A compatible node shows the same value.

chain_id
zoobc-test
timestamp
1793509027
total_supply
3333333333333333
rules
125
parameters
83
spine_chain_id
zoobc-spine-test
spine_version
1
spine_initial_blocksmiths
11
spine_consensus_params
14
The DevNet file32-15-devnetvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

chain_id
zoobc-dev
spine_chain_id
zoobc-spine-dev
timestamp
1793509027
total_supply
3333333333333333
accounts
61
genesis_tokens
14
nodes
11
parameters
84
rules
125
The testnet genesis accounts and their ZBC sum32-15-accountsvalidreference

23 named accounts and 38 test wallets, as the testnet genesis file lists them.

A stated value: there is nothing to compute. A compatible node shows the same value.

accounts
61
sum_zbc
264000102000000
test_wallets
38
The testnet coinbase pool32-15-poolvalidreference

The declared total supply less every genesis allocation counted against it (06 §8).

A stated value: there is nothing to compute. A compatible node shows the same value.

pool
2068282231333333
The testnet's named accounts32-15-authoritiesvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

release_authority
ZBC_PWF5RJA5_Z3VETBWR_5GO75GOK_SMBYOS34_HKWH53WN_MCUC6YMQ_EVZAAFOQ
page_authority
ZBC_HA74WBYC_IIU6WTAN_FL4OIDCX_P5OIC7U5_JVOHP2JJ_3KYANFVK_66CTTMJF
treasury
ZBC_CIHOJSU5_EWGXKZLJ_AHWEQNZX_HYDXMM3J_VV263DLD_7IY4PYFX_5ADSND7R
market_maker
ZBC_UTDINPWS_FOYVCPDG_6GVSTMPS_TB6AQBIK_RJ5FVIGL_6XA2DQPZ_I2YCZ5PO
nodes
11
genesis_tokens
14
vesting
6
gateways
1
archival_nodes
1
relays
1
GET /api/v1/blockchain/rules on either chain lists 125 rules at 032-15-rules-routevalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

rules
125
each
"height":0,"source":"consensus_parameters"
The TestNet file with survival_min_producers removed builds another chain32-15-survival-removedinvalidreference

It builds to another config hash, so a node built from it never completes a handshake with the chain's nodes (27).

A stated value: there is nothing to compute. The statement is a refusal: the exact text a compatible node answers.

refusal
*
The TestNet file with one rule name removed is refused by the genesis builder32-15-rule-removedinvalidreference

§1: the builder refuses a new chain whose file omits a rule.

A stated value: there is nothing to compute. The statement is a refusal: the exact text a compatible node answers.

refusal
*

Defects to match. None.

§16 Survival-mode and network-protocol constants

Purpose. The fixed numbers of survival mode, the spine signing commitment and the P2P protections that every implementation must use identically.

Inputs. None; compiled.

Output and effect.

Constant Value Meaning (document)
survival window 120 blocks the window [max(1, h − 120), h − 1] whose distinct blocksmiths decide the survival flag (36 §12)
survival_min_producers parameter, 0 = off the fewest distinct blocksmiths in the survival window before survival mode; 36 §12, §12 above
receipt-once window 40 blocks [h − 40, h) (§8, 19)
receipt-request tag ASCII ZBC-RCPT (8 bytes) the receipt-request digest (27)
spine non-signing tag ASCII ZBC-SPINE-REFUSE (16 bytes) the digest of a non-signing statement: SHA3-256(tag ‖ genesis hash (32) ‖ spine height (uint32 LE) ‖ candidate identity (32)) (25)
non-signing statements that release a signing commitment the number of spine signers − the required spine signatures + 1 (at least 1) (25)
signed spine block candidates remembered per height 1,024 a registered node never makes a non-signing statement on a candidate it signed (25)
capped required spine signatures min(required spine signatures, spine signers − 1) for exactly 3, 4 or 5 spine signers (2 of 3, 3 of 4, 4 of 5); every other count unchanged rule spine_threshold_capped, the cap on the required spine signatures (25)
handshake freshness ±600 s a handshake request's and response's timestamp (27)
signed P2P calls domain ASCII ZBC-P2P-RPC-V3; message = domain ‖ 00 ‖ method name ‖ 00 ‖ len(receiver key) (1 byte) ‖ receiver key ‖ stamp (int64 LE) ‖ SHA3-256(request) ‖ nonce (8 bytes); stamp within ±600 s; the replay ring remembers 120,000 signatures (200 calls/s over the window), forgetting the oldest; only a Handshake may name no receiver every call a node makes (27, 28)
per-host ceilings a host = the IPv4 address or the IPv6 /64; 8 callers' worth of budget per host; a caller's block read budget 200 calls per 10 s and 8 MiB of block transactions per 10 s (4,096 identities tracked); 8 unregistered peer-table entries per host (an entry counts at its address's host and, when its key handshook from another host with no routable address, at that observed host too; the handshake that would make a ninth is refused Too many unregistered peers from host <host>) RequestBlockTransactions, GetNextBlockIDs, GetNextBlocks, GetStateSample, GetMorePeers (27, 28)
transport caps of a block message max(500, max_transactions_per_block) transactions or transaction ids (2,000 on both chains); 65,536 published receipts, spine public keys, spine manifests or spine non-signing statements; a Block above either is refused where a node serves and decodes to an empty block in every answer a node reads (27 §2, 05 §11, 24 §2)
introduction limiter 5 failures in 300 s → 900-s ban; 4,096 addresses tracked, the oldest evicted (27)
invalid-block sources 4,096; 5 invalid blocks in 60 s; a bound registered sender is never charged (27)
validation-failure records 64 per height, 200 heights (cut back to 100) (28)
in-flight block wait 10 s; one copy per signed hash in flight, one bound-registered copy may wait, every other copy is dropped meanwhile (27)
early-block hold 900 s, 64 blocks (27)
sync block ahead of its round 900 s (24, 27)
equivocation ledger [tip − 720, tip + 2], 256 pairs per height, 4,096 reported pairs (35)
SpineEquivocationReport type 62, fee exactly 0; body = spine height (uint32 LE) ‖ node key (32) ‖ header length (uint32 LE; 204 or 284) ‖ the candidate's signed header bytes ‖ the spine signature (64) ‖ the non-signing statement's signature (64): 372 bytes with a 204-byte header (35 §7)
non-signing statements remembered per pending spine height 1,024, in a node-local table, recorded before the statement is signed (25, 35 §7)
block bundle id 601 (= 0 × 10,000 + 6 × 100 + 1, from the version 0.6.1) block.version of a 0.6.1 blocksmith (05, 29)
bundle 601 its 24 rules (29), all at 0 on every chain: receipt_once, readiness_decision_state, readiness_registry_schedule, spine_threshold_capped, cosign_promise_binds, survival_mode, block_size_serialized, escrow_commission_nonnegative, foreign_carrier_bound, eth_signature_canonical_v, canonical_account_forms, bridge_burn_supply_first, bridge_withdrawal_credit, admission_checks_in_block, receipt_reference_in_window, failed_credit_to_pool, one_node_per_owner, dataset_rent_object_clock, spine_bar_follows_registry, claim_notifies_owner, spine_late_vote, spine_equivocation_report, fee_collected_explicit, liquid_chain_clock (29)

How to compute it. As the owning documents state.

Rule activation. The 24 rules of bundle 601, active from height 0 on every chain; the signed P2P call is protocol policy without a rule.

Rejections and errors. Per owning document.

Vector. computed. INPUT: version text 0.6.1 → EXPECTED bundle id 601; INPUT 0.6.0 → 600; INPUT v0.5.9 → 509. INPUT: 4 spine signers at 67 % → ⌈4 × 0.67⌉ = 3 required; 3 spine signers → ⌈3 × 0.67⌉ = 3 (or spine_min_signatures 5 when higher), capped to 2; 6 spine signers with spine_min_signatures 5 → 5 (no cap).

Test cases · §16

9 cases · 8 valid · 1 invalid · 4 reference

The bundle id of version 0.6.132-16-bundle-061valid

Loading the test widget…

The bundle id of version 0.6.032-16-bundle-060valid

Loading the test widget…

The bundle id of version v0.5.932-16-bundle-059valid

Loading the test widget…

Required spine signatures for 3, 4 and 6 spine signers at 67 % with spine_min_signatures 532-16-spine-thresholdvalid

Loading the test widget…

4 spine signers at 67 % with spine_min_signatures 2: ⌈4 × 0.67⌉ = 332-16-spine-threshold-4valid

Loading the test widget…

Survival-mode and network-protocol constants32-16-protocolvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

survival_window
120
receipt_once_window
40
receipt_request_tag
ZBC-RCPT
spine_refusal_tag
ZBC-SPINE-REFUSE
signed_proposals_remembered
1024
handshake_freshness_s
600
p2p_call_domain
ZBC-P2P-RPC-V3
p2p_call_stamp_window_s
600
p2p_replay_ring
120000
host_callers
8
block_read_budget
200 calls and 8 MiB of block transactions per 10 s
unregistered_peers_per_host
8
block_message_transactions
max(500, max_transactions_per_block) = 2000
block_message_list_items
65536
introduction_limiter
5 failures in 300 s, 900-s ban
invalid_block_sources
4096; 5 in 60 s
validation_failure_records
64 per height, 200 heights
in_flight_block_wait_s
10
early_block_hold
900 s, 64 blocks
sync_block_ahead_s
900
equivocation_ledger
[tip − 720, tip + 2], 256 pairs per height, 4096 reported pairs
non_signing_statements_remembered
1024
block_bundle_id
601
The handshake that would make a ninth unregistered peer-table entry of a host32-16-host-refusalinvalidreference

A stated value: there is nothing to compute. The statement is a refusal: the exact text a compatible node answers.

refusal
Too many unregistered peers from host <host>
The SpineEquivocationReport body32-16-spine-equivocation-reportvalidreference

35 §7.

A stated value: there is nothing to compute. A compatible node shows the same value.

type
62
fee
0
layout
spine height (uint32 LE) ‖ node key (32) ‖ header length (uint32 LE; 204 or 284) ‖ header ‖ spine signature (64) ‖ non-signing statement's signature (64)
bytes_with_204_byte_header
372
Bundle 601 and its 24 rules, all at 0 on every chain32-16-bundle-601validreference

A stated value: there is nothing to compute. A compatible node shows the same value.

rules
receipt_once readiness_decision_state readiness_registry_schedule spine_threshold_capped cosign_promise_binds survival_mode block_size_serialized escrow_commission_nonnegative foreign_carrier_bound eth_signature_canonical_v canonical_account_forms bridge_burn_supply_first bridge_withdrawal_credit admission_checks_in_block receipt_reference_in_window failed_credit_to_pool one_node_per_owner dataset_rent_object_clock spine_bar_follows_registry claim_notifies_owner spine_late_vote spine_equivocation_report fee_collected_explicit liquid_chain_clock
count
24

Defects to match. None.

§17 Local constants

Purpose. Named numbers that shape a node's behaviour on the network and at its API without deciding any block's validity; an implementation may choose others, but these are the reference node's.

Inputs. None; compiled.

Output and effect.

Area Constants (value) Document
Peer discovery and health discovery every 60 s, 1,800 s cooldown per peer; address announcement every 30 s; 3 connected peers for stability; health check every 30 s, 120 s cooldown after a resolution; height-difference threshold 10; sample of 5 peers, agreement 0.6; sync sample 3 peers; sync loop every 10 s ± 2 s; circuit breaker after 5 failures, 60 s recovery 24, 28
Peer manager ban levels 300 / 900 / 2,100 / 3,600 s; offence reset 86,400 s; 10 bad blocks in 600 s; 5 invalid transactions in 300 s; 10 consecutive failures; stale peer 600 s (registered 3,600 s); health check every 60 s; retry backoff 15 s base, 120 s max (registered 600 s); 3 active peers minimum; 3 validation failures in 60 s; chain-state query every 30 s (10 s stressed); transaction rate per source address: registered 2,000 / 60 s, queued 20 / 60 s, stray 10 / 60 s, 4,096 sources; stray blocks 1 / 60 s; disconnected-peer retry 60 s (registry 30 s); 256 known items per peer; 1,024 tracked peers; pending-address retry 30 s, 10 attempts 28
RPC client timeouts 8,000 ms (critical 10,000; block propagation 8,000; candidates 10,000; heartbeat 5,000) 27
Topology 20 resolved peers, 40 unresolved, 5 priority, 3 hops 23, 28
Fork resolution attempt budget max(120, ⌈(2 × max_rollback_height + 100) / 100⌉ × 15) s (TestNet 240 s); 10 common-block trials; download segments of 10 blocks; 720-block fork window; 3…5 peers to confirm at 0.66 24
Block ranges and queues 1,000 hashes per request; 100 incomplete blocks queued; 100 peers per request; candidates at most 4 heights ahead and 8 MiB (or max_priority_blocksmiths × max_block_size_bytes when larger); one copy of a block in flight per signed hash, a second bound-registered copy waiting at most 10 s 24, 26, 27
HTTP API §1 of 31; uploads 256 MiB unanchored budget, 2 GiB free disk, 10 uploads / 600 s and 32 MiB / 3,600 s per client, 10,000 clients; 1,000 pending transactions per answer; mempool back-pressure at 10,000 31, 11
Load monitor levels at 30 / 60 / 80 / 100 %; samples every 4 s (4 minimum, 50 kept); 700 threads; 1,000 P2P requests; CPU 98 %; memory 95 %; file descriptors 800 soft / 950 hard, 80 %; high load 0.8, low 0.5; abuse after 100 requests at a 0.5 throttle ratio, 5-minute block; retry-after 100 ms (throttle) / 1,000 ms (overload) 27
Storage maintenance minimum hold 3,600 s; unanchored grace 3,600 s, sweep every 600 s 11
Duty relay 64 remembered duties, re-sent every 120 s 28
Release notice every 5,760 blocks 30
Spine fast sync manifest unavailable for 600 s; at most 8 manifests walked 26
Validation at most 16 parallel validation workers; at most 2 candidate rebuilds 19, 20

How to compute it. Nothing.

Rule activation. None.

Rejections and errors. Per owning document.

Vector. none (local).

Test cases · §17

1 case · 1 valid · 1 reference

Local constants carry no test32-17-localvalidreference

A stated value: there is nothing to compute. A compatible node shows the same value.

value
none (local)

Defects to match. None.

§18 Consensus and local; summary of defects

Consensus: §1 (resolution, defaults, changes and their rollback), §2–§10 wherever a value is applied by 03–26, the event numbers of §11, the parameters of §12, the governance bounds and count of §13, the chain types of §14, the genesis inputs of §15 and the protocol constants of §16. Local: §17.

Defects an implementation must reproduce or know about: (1) the 32-bit parameter fields truncate a row (§1); (2) a chain without a block_time_interval row derives the drift from a 10-s block (§3); (3) many defaults when absent differ from the TestNet values, so a genesis must name every parameter (§12); (4) gateway_heartbeat_freshness_window is committed but unused (§10); (5) node_operating_balance is committed but not stored (§12); (6) the prune height is the newest manifest's height minus one interval (§9); (7) the ledger event numbering is historical and never renumbered (§11).

A question about this chapter, or a statement that does not match the network? Discuss on zoobc.pro.