On this page
- §0 The area in one paragraph
- §1 Where a value comes from: the parameter table, defaults, changes
- §2 Units, sizes and fixed identities
- §3 Participation-score constants
- §4 Block timing and size
- §5 Transaction limits and fee constants
- §6 Node registry, admission, liveness and the queue
- §7 Coinbase and maturity
- §8 Receipts and topology
- §9 Snapshots, pruning and the confirmed tail
- §10 Feature constants
- §11 Ledger event types
- §12 The consensus-parameter table
- §13 Governable parameters and their bounds
- §14 Chain types
- §15 The TestNet genesis inputs
- §16 Survival-mode and network-protocol constants
- §17 Local constants
- §18 Consensus and local; summary of defects
32 — Constants and consensus parameters: every value, where it comes from, which one the TestNet uses
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.
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 of06§13, which a change of the value leaves in place; null oncoinbase_total_distributionand on a row a change creates). Rule activation heights are rows of the same table namedrule.<name>(andrule_off.<name>), resolved by29. Log tableconsensus_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. Whenmain_snapshot_interval= 0 andspine_snapshot_interval≠ 0, the main snapshot interval and minimum height take the spine values. The priority-peer countP = max(2, max_assigned_peers)(23). - Changes. An applied governance count (§13) writes the new value at block
h: the row is replaced and oneconsensus_parameter_changerow is appended (had_rowsays whether a row existed,old_valuethe value before). A pop-off totargetwalks the log rows withblock_height > target, newest first, restoringold_value(or deleting the row whenhad_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 andnode_admission_max_delay> 0 and min ≤ max);node_admission_base_delay≤ 0;node_admission_genesis_delay≤ 0; withmain_snapshot_interval> 0:main_snapshot_min_height= 0 ormain_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_secondsoutside 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 whoserule_activationleaves out any rule of the activation table (29; its--check-rulesmode 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 applies
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 = 5
Loading the test widget…
The mainnet template has no survival_min_producers row: N = 0, survival mode off
Loading the test widget…
blocks_per_week from a 15-second block_time_interval
Loading the test widget…
A genesis with main_snapshot_interval 2,000 and main_snapshot_min_height 760 is refused (2,000 < 2,280)
Loading the test widget…
The testnet cadence (172,800 and 760) passes
Loading the test widget…
A genesis with 11 registered nodes and survival_min_producers 10 is refused (10 > 11 − 2)
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 vote
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_SIZE32,SIGNATURE_SIZE64,HASH_SIZE32. 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 undereth_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
01undercanonical_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‖ ASCIIZBCAPPS‖00‖ 24 ×00. CONFIRMATION_DEPTH3: user-facing balance reads are served atmax(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.
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 units
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 account
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 account
Loading the test widget…
Its 32-byte key alone is not the genesis sender
Loading the test widget…
A Tron sender (type 15) signs with 65 bytes
Loading the test widget…
A Ripple sender (type 14) with a compressed key: 99 bytes
Loading the test widget…
A Ripple sender with an uncompressed key: 131 bytes
Loading the test widget…
A ZooBC sender signs with 64 bytes
Loading the test widget…
A Cardano sender (type 13): 20 00 ‖ key ‖ signature, 98 bytes
Loading the test widget…
The 24-byte form of an Ethereum account is an account
Loading the test widget…
A recipient 04000000 ‖ a 64-byte key (68 bytes) is refused
Loading the test widget…
The apps-pool account
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 blocks
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
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 blocks
Loading the test widget…
A chain without a block_time_interval row derives the drift from a 10-second block
Loading the test widget…
The score constants
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
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).
Rule activation. block_size_serialized, active from height 0 on every chain.
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 receipts
Loading the test widget…
The same block with one receipt whose intermediate_hashes holds 33 hashes beside a 32-byte rmr_linked
Loading the test widget…
A published receipt counts 232 + 1,056 = 1,288 bytes
Loading the test widget…
The testnet's timing and size parameters
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
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.
Rule activation. None here.
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 interval
Loading the test widget…
The fee constants GET /api/v1/blockchain/fee-params echoes on a fresh chain
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 limits
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
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 bps
Loading the test widget…
The signal window of 11 counted registered nodes: min(max(720, 55), 1,440)
Loading the test widget…
The signal window of 300 counted registered nodes: min(1,500, 1,440)
Loading the test widget…
Allowed attendance misses on the testnet
Loading the test widget…
Allowed attendance misses on the devnet file
Loading the test widget…
Registry and liveness constants
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^30
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 days
Loading the test widget…
The testnet's coinbase pool and emission constants
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,040
Loading the test widget…
The same receipt in a block at 1,041
Loading the test widget…
One block carrying the same recipient signature twice
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 constants
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
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.
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 testnet
Loading the test widget…
Snapshot and archive constants
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_ppm1,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_BLOCKS5,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_BLOCKS5,760;LONGEVITY_MIN_DEPOSIT10,000,000. - Stored files and proofs (
11,22):STORE_FILE_MIN_DEPOSIT1,000,000;STORE_FILE_MAX_PIECES100,000;STORE_FILE_MAX_ALLOWED16;storage_proof_epoch_blocks240;storage_replication5; 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 ASCIIdfs:anddfs:dir:. - Gateways (
17,22): the lock is the votedgateway_registration_cost(1,000,000,000 when absent);gateway_heartbeat_interval240 (5,760 when absent);gateway_prune_grace480 (11,520 when absent); the heartbeat freshness window 20. - Markets (
15):exchange_taker_fee_bps10 (held to 1…100 on every read);market_creation_cost5,000,000,000 (held to its governance bounds on every read);MARKET_DEPOSIT_REFUND_FILLS100;PRICE_SCALE100,000,000. - Apps (
16):APP_RAKE_BPS100;APP_MAX_PAYOUT_FRAC_BPS500;APP_MOVE_WINDOW240;SETTLE_CHALLENGE_WINDOW240;APPS_PAYOUT_INFLOW_WINDOW_BLOCKS5,760;app_open_timeout_blocks161,280 (28 days);app_unused_share_bps1,000. - Batches (
08,14,11): at most 25 payments, 32 token transfers, 1,000 storage proofs per batch. - Account groups (
18):account_group_max_members100; 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 spend0x01, tokens0x02. - Split policy (
08): at most 10 recipients; scale 10,000. - Oracle (
17,22):oracle_quorum3. - Bridge (
34):bridge_quorum_num/den2/3; prefixes ASCIIZBRDEP1:,ZBWDR1:; memo ASCIIZBW1|(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 ASCIIZBC-BRIDGE-CUSTODY(custody =00000000 ‖ SHA3-256(domain ‖ LE64(token id)), ZETH's00000000b070ddf6…4df2); withdrawals open only for chainethereum, assetnative; 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 ASCIIZBCGOV1:; 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 vote
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,000
Loading the test widget…
A small supply mints at least 100,000,000 a day
Loading the test widget…
Feature constants
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)
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)
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.
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_members
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_cost
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_cap
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_blocks
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 batch_receipt_lookback_height
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_interval
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_time
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_tolerance
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_gap
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_den
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_num
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_replicas
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_blocks
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_block
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_second
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_distribution
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_divisor
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_mib
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_divider
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_score
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_bps
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_blocks
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_window
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_interval
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_grace
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_cost
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_score
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_limit
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_interval
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_height
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_cost
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_units
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_peers
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_bytes
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_cycle
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_blocksmiths
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_seconds
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_height
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_block
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_interval
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_ceiling
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_balance
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_blocks
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_size
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_delay
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_delay
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_delay
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_delay
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_bps
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_balance
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_quorum
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_bps
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_size
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_lifecycle
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_blocks
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_ratio
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_bps
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_blocks
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_period
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_seconds
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 spine_blocksmith_block_creation_time
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_tolerance
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_gap
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_enabled
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_periods
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_depth
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_enabled
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_seconds
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_level
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_signatures
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_multiplier
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_timeout
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_percent
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_period
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_interval
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_height
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_ppm
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_blocks
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_replication
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_producers
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_blocks
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_cost
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_blocks
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_score
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 name
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.
- 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. - The count, at the end of the cycle's last block
k × L + L(a cycle is blocksk × 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 thanmax(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; otherwiset = clamp(in_force, floor, ceiling), each vote limited toclamp(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 ast, andnext = clamp(round_half_up(Σ / n), floor, ceiling)withn= the number of counted registered nodes; the parameter is written (§1, a change row appended) only whennext ≠ in_force. - 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 nodes
Loading the test widget…
A price of 1 unit with one vote of 10 among 7 registered nodes
Loading the test widget…
Read the vote ZBCGOV1:exchange_taker_fee_bps:12
Loading the test widget…
A vote on max_block_size_bytes
Loading the test widget…
A taker fee of 101 bps
Loading the test widget…
The eight governable prices and their bounds
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 0
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 inputs
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 file
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 sum
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 pool
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 accounts
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 0
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 chain
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 builder
§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.1
Loading the test widget…
The bundle id of version 0.6.0
Loading the test widget…
The bundle id of version v0.5.9
Loading the test widget…
Required spine signatures for 3, 4 and 6 spine signers at 67 % with spine_min_signatures 5
Loading the test widget…
4 spine signers at 67 % with spine_min_signatures 2: ⌈4 × 0.67⌉ = 3
Loading the test widget…
Survival-mode and network-protocol constants
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 host
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 body
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 chain
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 test
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.