dig_constants/lib.rs
1//! DIG Network Constants
2//!
3//! Defines network parameters for the DIG L2 blockchain. This crate exists
4//! separately so that any DIG crate can import network constants without
5//! pulling in the full CLVM engine or other heavy dependencies.
6//!
7//! The core type is [`NetworkConstants`], which wraps `chia-consensus`'s
8//! `ConsensusConstants` with DIG-specific values (genesis challenge,
9//! AGG_SIG additional data, cost limits, etc.).
10//!
11//! # Chia L1 vs DIG L2 (do not mix)
12//!
13//! [`DIG_MAINNET`] / [`DIG_TESTNET`] describe the DIG **L2** network. Separately,
14//! [`CHIA_L1_MAINNET_AGG_SIG_ME`] / [`CHIA_L1_TESTNET11_AGG_SIG_ME`] hold the
15//! **Chia L1 (foreign chain)** genesis challenge that DIG wallet code needs as
16//! AGG_SIG_ME additional data when signing L1 spends. They live here as the
17//! ecosystem's single source of truth, but are DELIBERATELY distinct from the DIG
18//! L2 genesis — signing an L1 spend with the DIG L2 genesis produces an invalid
19//! signature. The `CHIA_L1_` prefix is the anti-mixup guard.
20//!
21//! # Usage
22//!
23//! ```rust,ignore
24//! use dig_constants::DIG_MAINNET;
25//!
26//! let genesis = DIG_MAINNET.genesis_challenge();
27//! let consensus = DIG_MAINNET.consensus();
28//! ```
29
30use chia_consensus::consensus_constants::ConsensusConstants;
31use chia_protocol::Bytes32;
32use hex_literal::hex;
33
34/// DIG network constants.
35///
36/// Wraps `chia-consensus::ConsensusConstants` with accessors for the fields
37/// that DIG validators and wallet code commonly need. The underlying
38/// `ConsensusConstants` is available via [`consensus()`](Self::consensus)
39/// for direct use with `chia-consensus` functions like `run_spendbundle()`.
40#[derive(Debug, Clone)]
41pub struct NetworkConstants {
42 inner: ConsensusConstants,
43}
44
45impl NetworkConstants {
46 /// The underlying `chia-consensus` constants, for passing directly to
47 /// `run_spendbundle()`, `validate_clvm_and_signature()`, etc.
48 pub fn consensus(&self) -> &ConsensusConstants {
49 &self.inner
50 }
51
52 /// DIG genesis challenge.
53 pub fn genesis_challenge(&self) -> Bytes32 {
54 self.inner.genesis_challenge
55 }
56
57 /// AGG_SIG_ME additional data (== genesis_challenge on Chia L1).
58 pub fn agg_sig_me_additional_data(&self) -> Bytes32 {
59 self.inner.agg_sig_me_additional_data
60 }
61
62 /// Maximum CLVM cost per block.
63 pub fn max_block_cost_clvm(&self) -> u64 {
64 self.inner.max_block_cost_clvm
65 }
66
67 /// Cost per byte of generator program.
68 pub fn cost_per_byte(&self) -> u64 {
69 self.inner.cost_per_byte
70 }
71
72 /// Maximum coin amount (u64::MAX).
73 pub fn max_coin_amount(&self) -> u64 {
74 self.inner.max_coin_amount
75 }
76}
77
78// =============================================================================
79// AGG_SIG additional data derivation
80//
81// On Chia L1, each AGG_SIG_* variant's additional_data is:
82// sha256(genesis_challenge || opcode_byte)
83// except AGG_SIG_ME which uses genesis_challenge directly.
84//
85// See: condition_tools.py:58-71
86// https://github.com/Chia-Network/chia-blockchain/blob/main/chia/consensus/condition_tools.py#L58
87// =============================================================================
88
89// ---------------------------------------------------------------------------
90// DIG Mainnet
91//
92// The genesis challenge is the 32-byte consensus anchor for the DIG L2 network.
93// It doubles as the gossip `network_id` gate: `dig-gossip` REJECTS an all-zero
94// network_id, so this value MUST be non-zero for the node's gossip pool / DHT /
95// PEX to start.
96//
97// DIG_MAINNET L2 genesis = the Chia mainnet header hash @ height 9,021,277
98// (0af981...1abf), pinned 2026-07-17 — anchors the DIG L2 genesis to a real,
99// verifiable Chia block (captured via coinset.org get_blockchain_state).
100//
101// DIG_MAINNET_GENESIS_CHALLENGE
102// = 0af981862a4df51f51ec59c312315d959931d917c375730b89b9e2b0854d1abf
103//
104// This is the PRE-LAUNCH canonical DIG mainnet genesis. Per CLAUDE.md §3.7 the
105// ecosystem is pre-release with no live users, so this value is revisable at
106// true mainnet launch — re-anchor to the launch-time Chia header hash and
107// recompute every derived value below if it is ever changed.
108//
109// All `agg_sig_*_additional_data` values are derived from this genesis as
110// `sha256(genesis_challenge || opcode_byte)` (AGG_SIG_ME = genesis directly),
111// so they were all recomputed for this genesis.
112// ---------------------------------------------------------------------------
113
114/// Canonical DIG mainnet genesis challenge.
115///
116/// The Chia mainnet header hash at block height 9,021,277 (`0af981…1abf`),
117/// pinned 2026-07-17 — a real, verifiable, fixed 32-byte value anchoring the
118/// DIG L2 genesis to a real Chia block. This is the pre-launch canonical value;
119/// per §3.7 it is revisable at true mainnet launch. All
120/// `agg_sig_*_additional_data` fields are derived from this.
121const DIG_MAINNET_GENESIS_CHALLENGE: [u8; 32] =
122 hex!("0af981862a4df51f51ec59c312315d959931d917c375730b89b9e2b0854d1abf");
123
124/// DIG mainnet constants.
125///
126/// Uses DIG's own genesis challenge and AGG_SIG domain separation.
127/// Proof-of-space and VDF fields are set to neutral values since DIG L2
128/// does not use Chia's proof-of-space consensus.
129pub const DIG_MAINNET: NetworkConstants = NetworkConstants {
130 inner: ConsensusConstants {
131 // -- DIG-specific values --
132 genesis_challenge: Bytes32::new(DIG_MAINNET_GENESIS_CHALLENGE),
133
134 // AGG_SIG additional data: derived from genesis_challenge.
135 // AGG_SIG_ME = genesis_challenge directly.
136 // Others = sha256(genesis_challenge || opcode_byte).
137 // Derivation: condition_tools.py:58-71
138 // https://github.com/Chia-Network/chia-blockchain/blob/main/chia/consensus/condition_tools.py#L58
139 // Opcode bytes: AGG_SIG_PARENT=43, PUZZLE=44, AMOUNT=45,
140 // PUZZLE_AMOUNT=46, PARENT_AMOUNT=47, PARENT_PUZZLE=48
141 // NOTE: Recompute ALL values when genesis_challenge is finalized.
142 agg_sig_me_additional_data: Bytes32::new(DIG_MAINNET_GENESIS_CHALLENGE),
143 agg_sig_parent_additional_data: Bytes32::new(hex!(
144 "196d63b6dfbd4440656f9c1eadc686cacfaae771c565762a8cd6e51c892a0077"
145 )),
146 agg_sig_puzzle_additional_data: Bytes32::new(hex!(
147 "9ca719659b5e2355a91ff330c8612cb58c74f1063eaff99e507602d450b1f71f"
148 )),
149 agg_sig_amount_additional_data: Bytes32::new(hex!(
150 "d13767da4a8bd9520dbd9e039e68b3eb4b16fdcbb7e7755b5064840eaeb553ce"
151 )),
152 agg_sig_puzzle_amount_additional_data: Bytes32::new(hex!(
153 "73eea3473bd0daa28793d4bcd218ade462b634b53af97f9a01a91f3059ac75df"
154 )),
155 agg_sig_parent_amount_additional_data: Bytes32::new(hex!(
156 "eb7302224e77c0f269d0c8b105d4cc786775ae012ed2db49751c33c244c3f647"
157 )),
158 agg_sig_parent_puzzle_additional_data: Bytes32::new(hex!(
159 "ccac5983685257d50ee7b439bbb502128ddb262813dde4e4a11ac6cdfc66fa8e"
160 )),
161
162 // DIG L2 cost limits
163 max_block_cost_clvm: 11_000_000_000, // per-spend limit, same as Chia L1
164 cost_per_byte: 12_000,
165 max_coin_amount: u64::MAX,
166
167 // Block generator limits
168 max_generator_size: 1_000_000,
169 max_generator_ref_list_size: 512,
170
171 // Hard fork heights — set to 0 to always use latest consensus rules.
172 // DIG L2 starts with all features enabled from block 0.
173 hard_fork_height: 0,
174 hard_fork2_height: 0,
175
176 // Pre-farm puzzle hashes — not used by DIG L2, set to zero.
177 genesis_pre_farm_pool_puzzle_hash: Bytes32::new([0u8; 32]),
178 genesis_pre_farm_farmer_puzzle_hash: Bytes32::new([0u8; 32]),
179
180 // -- Proof-of-space / VDF fields (not used by DIG L2) --
181 // These must be valid values since ConsensusConstants is passed to
182 // chia-consensus functions, but DIG does not use PoS consensus.
183 slot_blocks_target: 32,
184 min_blocks_per_challenge_block: 16,
185 max_sub_slot_blocks: 128,
186 num_sps_sub_slot: 64,
187 sub_slot_iters_starting: 1 << 27,
188 difficulty_constant_factor: 1 << 67,
189 difficulty_starting: 7,
190 difficulty_change_max_factor: 3,
191 sub_epoch_blocks: 384,
192 epoch_blocks: 4608,
193 significant_bits: 8,
194 discriminant_size_bits: 1024,
195 number_zero_bits_plot_filter_v1: 9,
196 number_zero_bits_plot_filter_v2: 9,
197 min_plot_size_v1: 32,
198 max_plot_size_v1: 50,
199 min_plot_size_v2: 28,
200 max_plot_size_v2: 32,
201 sub_slot_time_target: 600,
202 num_sp_intervals_extra: 3,
203 max_future_time2: 120,
204 number_of_timestamps: 11,
205 max_vdf_witness_size: 64,
206 mempool_block_buffer: 10,
207 weight_proof_threshold: 2,
208 blocks_cache_size: 4608 + (128 * 4),
209 weight_proof_recent_blocks: 1000,
210 max_block_count_per_requests: 32,
211 pool_sub_slot_iters: 37_600_000_000,
212 plot_filter_128_height: 0xffff_ffff,
213 plot_filter_64_height: 0xffff_ffff,
214 plot_filter_32_height: 0xffff_ffff,
215 plot_difficulty_initial: 2,
216 plot_difficulty_4_height: 0xffff_ffff,
217 plot_difficulty_5_height: 0xffff_ffff,
218 plot_difficulty_6_height: 0xffff_ffff,
219 plot_difficulty_7_height: 0xffff_ffff,
220 plot_difficulty_8_height: 0xffff_ffff,
221 },
222};
223
224// =============================================================================
225// NAT-traversal relay endpoint
226//
227// A DIG Node behind NAT cannot accept inbound dials, so it holds a constant
228// reservation with a publicly-reachable relay to stay discoverable. The
229// canonical public relay is `relay.dig.net`, serving the `RelayMessage`
230// WebSocket wire (RLY-001..RLY-007) on port 9450.
231//
232// This constant is the single source of truth for that endpoint so consumers
233// (`dig-node`, `dig-gossip`) don't each hardcode it. It MUST stay byte-identical
234// to `dig-node`'s `relay::DEFAULT_RELAY_URL` (the string a node actually dials
235// when `DIG_RELAY_URL` is unset) and to the `dig-relay` server's documented
236// client endpoint.
237//
238// Port 443: the live `relay.dig.net` NLB exposes its public TLS listener on the
239// standard HTTPS port 443 (the earlier :9450 listener is closed). Using 443 also
240// maximizes reachability from restrictive networks that only allow outbound 443.
241// =============================================================================
242
243/// Canonical DIG NAT-traversal relay endpoint.
244///
245/// This is the WebSocket URL a DIG Node dials by default to obtain a relay
246/// reservation (so NAT'd peers stay reachable). It is the value used unless an
247/// operator overrides it via the `DIG_RELAY_URL` environment variable (or
248/// disables the reservation with `DIG_RELAY_URL=off`).
249///
250/// Format: `wss://<host>:<port>` — the relay protocol (`RelayMessage`,
251/// RLY-001..RLY-007) is JSON over a secure WebSocket. Mainnet uses the canonical
252/// public deployment `relay.dig.net` on port 443 (the live NLB public TLS
253/// listener; the earlier :9450 listener is closed).
254///
255/// Kept byte-identical to `dig-node`'s `relay::DEFAULT_RELAY_URL` and the
256/// `dig-relay` server's documented client endpoint.
257pub const DIG_RELAY_URL: &str = "wss://relay.dig.net:443";
258
259// =============================================================================
260// DIG Node localhost endpoint
261//
262// A client connecting to a local DIG node (§5.3 client→node connection order)
263// resolves `dig.local` or `localhost` to reach the node via localhost TCP on
264// port 9778. This constant is the single source of truth for that port so
265// consumers (dig-node, dig-dns, dig-installer, SDK, CLI) don't each hardcode it.
266// =============================================================================
267
268/// The default localhost port a client uses to reach the local DIG node.
269///
270/// This is used to implement §5.3 client→node connection order: when a client
271/// needs to connect to a DIG node, it tries `dig.local` and `localhost` on this
272/// port before falling back to the public `rpc.dig.net` gateway. This constant
273/// ensures all consumers (dig-node, dig-dns, dig-installer, dig-sdk, digstore CLI)
274/// use an identical port, preventing port-mismatch bugs. It MUST stay byte-identical
275/// to `dig-node`'s documented localhost serve port and the installer's registered
276/// `dig.local` address.
277pub const DIG_NODE_PORT: u16 = 9778;
278
279// =============================================================================
280// DIG CAT asset id ($DIG token)
281//
282// $DIG is a Chia CAT (CHIP-0004); its asset id is the TAIL program's hash,
283// fixed for the token's lifetime. This is the single canonical home for that
284// value — `chip35_dl_coin`, `dig-cat-decoder`, and any DIG-aware wallet/
285// balance/spend code import it from HERE rather than each hardcoding a copy.
286// =============================================================================
287
288/// Canonical $DIG CAT asset id (TAIL hash) on Chia mainnet.
289///
290/// The single token every capsule (commit) payment is denominated in
291/// (`chip35_dl_coin::build_dig_store_payment`) and the value a wallet/decoder
292/// checks a CAT coin's `asset_id` against to recognize $DIG.
293///
294/// CONTRACT: byte-identical to `chip35_dl_coin::DIG_ASSET_ID`, digstore-chain's
295/// `DIG_ASSET_ID`, and DataLayer-Driver's. Do not change without changing every
296/// consumer in lockstep (SYSTEM.md → Shared contracts → DIG CAT payment).
297pub const DIG_ASSET_ID: Bytes32 = Bytes32::new(hex!(
298 "a406d3a9de984d03c9591c10d917593b434d5263cabe2b42f6b367df16832f81"
299));
300
301// =============================================================================
302// DIG treasury recipient (destination of $DIG payments + dev-tips)
303//
304// Every $DIG capsule/commit payment and dev-tip is created-coin'd to the DIG
305// treasury. This section is the single canonical home for that recipient in two
306// equivalent forms: the on-chain inner (standard) puzzle hash and its bech32m
307// address. A WRONG value here silently MISDIRECTS funds to an attacker/void —
308// a custody break — so both forms are pinned byte-for-byte by tests, and a KAT
309// proves the address decodes to the puzzle hash (they cannot drift apart).
310//
311// CONTRACT: dig-constants is the intended canonical LOWEST-level home for this
312// value. The existing higher-level copies (`digstore_chain::dig`,
313// `chip35_dl_coin`, `dighub-core`) SHOULD later converge to re-export from HERE.
314// That convergence is a SEPARATE follow-up — this change only introduces the
315// canonical constants; it does not touch those crates. Until convergence, this
316// value stays byte-identical to `digstore_chain::dig` (the current source of
317// truth: `TREASURY_ADDRESS` at `crates/digstore-chain/src/dig.rs:41`, from which
318// it derives `treasury_inner_puzzle_hash()`, pinned by its test at dig.rs:206-209).
319// =============================================================================
320
321/// Canonical DIG treasury inner (standard) puzzle hash.
322///
323/// The on-chain recipient every $DIG capsule/commit payment and dev-tip is
324/// created-coin'd to. A wrong value silently misdirects treasury funds (a
325/// custody break), so it is pinned byte-for-byte by a test.
326///
327/// CONTRACT: byte-identical to what `digstore_chain::dig::treasury_inner_puzzle_hash()`
328/// decodes to (pinned by that crate's test at `crates/digstore-chain/src/dig.rs:206-209`).
329/// dig-constants is the intended canonical lowest-level home; higher copies
330/// (`digstore_chain::dig`, `chip35_dl_coin`, `dighub-core`) should later
331/// re-export from here (a separate follow-up — see the section note above).
332pub const DIG_TREASURY_INNER_PUZZLE_HASH: Bytes32 = Bytes32::new(hex!(
333 "ec7c304708c7d59c078d5ae098d0dea004decf47fa1cafebb266c10ad6466ce8"
334));
335
336/// Canonical DIG treasury address (bech32m form of [`DIG_TREASURY_INNER_PUZZLE_HASH`]).
337///
338/// The human-readable `xch1…` form of the same treasury recipient — the
339/// destination of $DIG payments and dev-tips. A wrong value misdirects funds
340/// (a custody break), so it is pinned by a test AND a KAT proves it decodes to
341/// [`DIG_TREASURY_INNER_PUZZLE_HASH`] (the two forms cannot silently drift).
342///
343/// CONTRACT: digstore-chain's source-of-truth form (`digstore_chain::dig::TREASURY_ADDRESS`,
344/// `crates/digstore-chain/src/dig.rs:41`), from which it derives the puzzle hash
345/// at runtime. dig-constants is the intended canonical lowest-level home; higher
346/// copies should later re-export from here (a separate follow-up).
347pub const DIG_TREASURY_ADDRESS: &str =
348 "xch1a37rq3cgcl2ecpudttsf35x75qzdan68lgw2l6ajvmqs44jxdn5qv6pk3y";
349
350// =============================================================================
351// Chia L1 (foreign chain) AGG_SIG_ME additional data
352//
353// The DIG wallet signs and validates spends on the Chia L1 chain. On Chia L1 the
354// AGG_SIG_ME additional data IS the network genesis challenge, so every L1 spend
355// signature is bound to it. This is a FOREIGN chain's value — completely distinct
356// from the DIG L2 genesis (`DIG_MAINNET_GENESIS_CHALLENGE`, 0af98186…).
357//
358// Both the wallet's signer seam AND the engine's message-binding seam MUST read
359// the SAME 32 bytes from here, or a spend the engine builds is signed with a
360// different domain than it binds — a custody break (invalid, unspendable
361// signatures on mainnet). This crate is the single source of truth for those
362// bytes; the `[u8; 32]` shape matches the signer field directly (the engine wraps
363// it once via `Bytes32::new(...)`).
364//
365// The value is invariant-forced: it is exactly Chia's well-known mainnet genesis
366// (ccd5bb71…) / testnet11 genesis (37a90eb5…), the same values
367// `chia-wallet-sdk`'s `MAINNET_CONSTANTS` / `TESTNET11_CONSTANTS` carry (asserted
368// by an anti-drift dev-dependency test).
369// =============================================================================
370
371/// Chia **L1 mainnet** genesis challenge, used as AGG_SIG_ME additional data.
372///
373/// The 32-byte domain every Chia L1 mainnet spend signature is bound to. This is
374/// the foreign-chain (Chia) value — DISTINCT from the DIG L2 genesis
375/// ([`DIG_MAINNET`]); signing an L1 spend with the DIG L2 genesis yields an
376/// invalid signature.
377///
378/// CONTRACT: DIG wallet consumers (the client signer AND the engine's
379/// message-binding path) MUST both use this constant so signer == engine,
380/// producing byte-identical, valid signatures. Equals Chia's canonical mainnet
381/// genesis `ccd5bb71…` (== `chia_sdk_types::MAINNET_CONSTANTS.agg_sig_me_additional_data`).
382pub const CHIA_L1_MAINNET_AGG_SIG_ME: [u8; 32] =
383 hex!("ccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb");
384
385/// Chia **L1 testnet11** genesis challenge, used as AGG_SIG_ME additional data.
386///
387/// The 32-byte domain every Chia L1 testnet11 spend signature is bound to. As
388/// with [`CHIA_L1_MAINNET_AGG_SIG_ME`], this is the foreign-chain (Chia) value,
389/// DISTINCT from the DIG L2 genesis ([`DIG_TESTNET`]).
390///
391/// CONTRACT: DIG wallet consumers (signer AND engine) MUST both use this constant
392/// so signer == engine on testnet11. Equals Chia's canonical testnet11 genesis
393/// `37a90eb5…` (== `chia_sdk_types::TESTNET11_CONSTANTS.agg_sig_me_additional_data`).
394pub const CHIA_L1_TESTNET11_AGG_SIG_ME: [u8; 32] =
395 hex!("37a90eb5185a9c4439a91ddc98bbadce7b4feba060d50116a067de66bf236615");
396
397// ---------------------------------------------------------------------------
398// DIG Testnet
399// ---------------------------------------------------------------------------
400
401/// Canonical DIG testnet genesis challenge.
402///
403/// Deterministically derived as `sha256(b"DIG_TESTNET:genesis:v1")` — distinct
404/// from mainnet so the two networks never share a `network_id`. Non-zero so the
405/// gossip network_id gate accepts it. Pre-launch canonical value (§3.7),
406/// revisable at true launch; all derived agg_sig data below follows it.
407/// = 088c18d6b7859d885dc2f03166e862c958f74b63b6353c3df71d103b9b806c3b
408const DIG_TESTNET_GENESIS_CHALLENGE: [u8; 32] =
409 hex!("088c18d6b7859d885dc2f03166e862c958f74b63b6353c3df71d103b9b806c3b");
410
411/// DIG testnet constants.
412///
413/// Same structure as mainnet but with a different genesis challenge.
414/// Useful for testing without risking mainnet state.
415pub const DIG_TESTNET: NetworkConstants = NetworkConstants {
416 inner: ConsensusConstants {
417 genesis_challenge: Bytes32::new(DIG_TESTNET_GENESIS_CHALLENGE),
418 // AGG_SIG_ME = genesis_challenge. Others = sha256(genesis || opcode_byte).
419 agg_sig_me_additional_data: Bytes32::new(DIG_TESTNET_GENESIS_CHALLENGE),
420 agg_sig_parent_additional_data: Bytes32::new(hex!(
421 "85b3963bdeb9848af970a9bbd1d36809ae41491ffd67aee7f27e8883936d495c"
422 )),
423 agg_sig_puzzle_additional_data: Bytes32::new(hex!(
424 "66aba1939e128e1465d58fde414325630e891747c1428d76ebce193cbe966301"
425 )),
426 agg_sig_amount_additional_data: Bytes32::new(hex!(
427 "eccab86920a6d982a68898b2dcb7c150383529fcd532fe84c693fb4592c38ae3"
428 )),
429 agg_sig_puzzle_amount_additional_data: Bytes32::new(hex!(
430 "eb088fad0d4caba66e29130fb07407e60a7545d035d19a188fef0855c874084e"
431 )),
432 agg_sig_parent_amount_additional_data: Bytes32::new(hex!(
433 "232aec0a351ba4936b04920e074aebcc621a458f6b1461c4b28c658552f2f35d"
434 )),
435 agg_sig_parent_puzzle_additional_data: Bytes32::new(hex!(
436 "96263ac395703ab9b3b0f0587e79185f4a9898574a28b4491015ddcf9d321873"
437 )),
438 // All other fields same as mainnet
439 max_block_cost_clvm: 11_000_000_000,
440 cost_per_byte: 12_000,
441 max_coin_amount: u64::MAX,
442 max_generator_size: 1_000_000,
443 max_generator_ref_list_size: 512,
444 hard_fork_height: 0,
445 hard_fork2_height: 0,
446 genesis_pre_farm_pool_puzzle_hash: Bytes32::new([0u8; 32]),
447 genesis_pre_farm_farmer_puzzle_hash: Bytes32::new([0u8; 32]),
448 slot_blocks_target: 32,
449 min_blocks_per_challenge_block: 16,
450 max_sub_slot_blocks: 128,
451 num_sps_sub_slot: 64,
452 sub_slot_iters_starting: 1 << 27,
453 difficulty_constant_factor: 1 << 67,
454 difficulty_starting: 7,
455 difficulty_change_max_factor: 3,
456 sub_epoch_blocks: 384,
457 epoch_blocks: 4608,
458 significant_bits: 8,
459 discriminant_size_bits: 1024,
460 number_zero_bits_plot_filter_v1: 9,
461 number_zero_bits_plot_filter_v2: 9,
462 min_plot_size_v1: 32,
463 max_plot_size_v1: 50,
464 min_plot_size_v2: 28,
465 max_plot_size_v2: 32,
466 sub_slot_time_target: 600,
467 num_sp_intervals_extra: 3,
468 max_future_time2: 120,
469 number_of_timestamps: 11,
470 max_vdf_witness_size: 64,
471 mempool_block_buffer: 10,
472 weight_proof_threshold: 2,
473 blocks_cache_size: 4608 + (128 * 4),
474 weight_proof_recent_blocks: 1000,
475 max_block_count_per_requests: 32,
476 pool_sub_slot_iters: 37_600_000_000,
477 plot_filter_128_height: 0xffff_ffff,
478 plot_filter_64_height: 0xffff_ffff,
479 plot_filter_32_height: 0xffff_ffff,
480 plot_difficulty_initial: 2,
481 plot_difficulty_4_height: 0xffff_ffff,
482 plot_difficulty_5_height: 0xffff_ffff,
483 plot_difficulty_6_height: 0xffff_ffff,
484 plot_difficulty_7_height: 0xffff_ffff,
485 plot_difficulty_8_height: 0xffff_ffff,
486 },
487};
488
489#[cfg(test)]
490mod tests {
491 use super::*;
492
493 /// The canonical relay endpoint must equal exactly what a DIG Node dials by
494 /// default. This pins the value byte-for-byte against `dig-node`'s
495 /// `relay::DEFAULT_RELAY_URL` (`wss://relay.dig.net:9450`) and the
496 /// `dig-relay` server's documented client endpoint. If either side ever
497 /// changes the scheme, host, or port, this guard fails so the shared
498 /// contract can't silently drift.
499 #[test]
500 fn dig_relay_url_is_canonical_endpoint() {
501 assert_eq!(DIG_RELAY_URL, "wss://relay.dig.net:443");
502 }
503
504 /// The relay endpoint is a secure-WebSocket URL pointing at the canonical
505 /// public host on the relay protocol port.
506 #[test]
507 fn dig_relay_url_is_well_formed() {
508 assert!(
509 DIG_RELAY_URL.starts_with("wss://"),
510 "relay must use secure WebSocket"
511 );
512 assert!(
513 DIG_RELAY_URL.contains("relay.dig.net"),
514 "relay must point at the canonical host"
515 );
516 assert!(
517 DIG_RELAY_URL.ends_with(":443"),
518 "relay must use the live NLB public TLS port 443"
519 );
520 }
521
522 /// The DIG node localhost port must equal the expected default.
523 ///
524 /// This guards against accidental mutations and ensures all consumers
525 /// (dig-node, dig-dns, dig-installer, dig-sdk, digstore) use a consistent
526 /// port when connecting to the local node on `dig.local` or `localhost`.
527 #[test]
528 fn dig_node_port_is_canonical() {
529 assert_eq!(DIG_NODE_PORT, 9778);
530 }
531
532 // -- Genesis challenge canonical-value guards --------------------------
533 //
534 // These pin the pre-launch canonical genesis challenges byte-for-byte AND
535 // prove they are reproducible from their documented preimages, so the
536 // values can never silently drift (a drift changes every derived signature
537 // domain + the gossip network_id — a cross-repo breaking event).
538
539 use sha2::{Digest, Sha256};
540
541 /// AGG_SIG opcode bytes, per §4.2 of `SPEC.md` (Chia L1 `condition_tools`).
542 const AGG_SIG_OPCODES: [u8; 6] = [43, 44, 45, 46, 47, 48];
543
544 fn sha256(bytes: &[u8]) -> [u8; 32] {
545 let mut hasher = Sha256::new();
546 hasher.update(bytes);
547 hasher.finalize().into()
548 }
549
550 /// The genesis MUST be non-zero: `dig-gossip` rejects an all-zero
551 /// `network_id`, so a zero genesis would stop the node's gossip pool / DHT /
552 /// PEX from ever starting. This is the connect-enabler invariant.
553 #[test]
554 fn genesis_challenges_are_non_zero() {
555 assert_ne!(DIG_MAINNET.genesis_challenge(), Bytes32::new([0u8; 32]));
556 assert_ne!(DIG_TESTNET.genesis_challenge(), Bytes32::new([0u8; 32]));
557 }
558
559 /// The mainnet genesis is pinned to the Chia mainnet header hash @ height
560 /// 9,021,277 (a real anchored value), and the testnet genesis is the
561 /// reproducible `sha256` of its documented preimage. These pin both values
562 /// byte-for-byte so neither can silently drift.
563 #[test]
564 fn genesis_challenges_are_the_pinned_values() {
565 assert_eq!(
566 DIG_MAINNET_GENESIS_CHALLENGE,
567 hex_literal::hex!("0af981862a4df51f51ec59c312315d959931d917c375730b89b9e2b0854d1abf"),
568 );
569 assert_eq!(
570 DIG_TESTNET_GENESIS_CHALLENGE,
571 sha256(b"DIG_TESTNET:genesis:v1"),
572 );
573 }
574
575 /// Mainnet and testnet MUST NOT share a genesis (no cross-network replay).
576 #[test]
577 fn mainnet_and_testnet_genesis_differ() {
578 assert_ne!(
579 DIG_MAINNET.genesis_challenge(),
580 DIG_TESTNET.genesis_challenge(),
581 );
582 }
583
584 /// Pins the $DIG CAT asset id byte-for-byte against the value shipped in
585 /// `chip35_dl_coin::DIG_ASSET_ID` — a drift here silently breaks $DIG
586 /// recognition across every consumer (wallets, decoders, payment builders).
587 #[test]
588 fn dig_asset_id_is_canonical() {
589 assert_eq!(
590 DIG_ASSET_ID,
591 Bytes32::new(hex_literal::hex!(
592 "a406d3a9de984d03c9591c10d917593b434d5263cabe2b42f6b367df16832f81"
593 )),
594 );
595 }
596
597 // -- Chia L1 AGG_SIG_ME anti-drift guards ------------------------------
598
599 /// Literal pin: the Chia L1 AGG_SIG_ME constants equal Chia's well-known
600 /// mainnet / testnet11 genesis challenges byte-for-byte. This catches any
601 /// accidental mutation independently of any external crate.
602 #[test]
603 fn chia_l1_agg_sig_me_constants_are_the_pinned_values() {
604 assert_eq!(
605 CHIA_L1_MAINNET_AGG_SIG_ME,
606 hex_literal::hex!("ccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb"),
607 );
608 assert_eq!(
609 CHIA_L1_TESTNET11_AGG_SIG_ME,
610 hex_literal::hex!("37a90eb5185a9c4439a91ddc98bbadce7b4feba060d50116a067de66bf236615"),
611 );
612 }
613
614 /// Source KAT: the Chia L1 constants MUST equal the values `chia-wallet-sdk`
615 /// (via `chia-sdk-types`) uses in its `MAINNET_CONSTANTS` / `TESTNET11_CONSTANTS`.
616 /// This is the primary anti-drift guard — the wallet engine binds spends with
617 /// those SDK constants, so if a future SDK version ever changed the value, this
618 /// fails and forces a deliberate re-pin instead of a silent custody break.
619 #[test]
620 fn chia_l1_agg_sig_me_matches_chia_sdk_types() {
621 use chia_sdk_types::{MAINNET_CONSTANTS, TESTNET11_CONSTANTS};
622 assert_eq!(
623 CHIA_L1_MAINNET_AGG_SIG_ME.as_slice(),
624 MAINNET_CONSTANTS.agg_sig_me_additional_data.as_ref(),
625 );
626 assert_eq!(
627 CHIA_L1_TESTNET11_AGG_SIG_ME.as_slice(),
628 TESTNET11_CONSTANTS.agg_sig_me_additional_data.as_ref(),
629 );
630 }
631
632 /// The Chia L1 (foreign chain) AGG_SIG_ME MUST NOT equal the DIG L2 genesis —
633 /// this is the whole reason the constants exist. Signing an L1 spend with the
634 /// DIG L2 genesis would be a custody break.
635 #[test]
636 fn chia_l1_agg_sig_me_differs_from_dig_l2_genesis() {
637 assert_ne!(
638 Bytes32::new(CHIA_L1_MAINNET_AGG_SIG_ME),
639 DIG_MAINNET.genesis_challenge(),
640 );
641 assert_ne!(
642 Bytes32::new(CHIA_L1_TESTNET11_AGG_SIG_ME),
643 DIG_TESTNET.genesis_challenge(),
644 );
645 }
646
647 // -- DIG treasury recipient anti-drift guards --------------------------
648
649 /// Literal pin: the treasury inner puzzle hash equals the value
650 /// `digstore_chain::dig::treasury_inner_puzzle_hash()` decodes to
651 /// (byte-identical, pinned by that crate's own test at
652 /// `crates/digstore-chain/src/dig.rs:206-209`). A drift here silently
653 /// MISDIRECTS every $DIG capsule/commit payment and dev-tip to the wrong
654 /// on-chain recipient — a custody break.
655 #[test]
656 fn dig_treasury_inner_puzzle_hash_is_canonical() {
657 assert_eq!(
658 DIG_TREASURY_INNER_PUZZLE_HASH,
659 Bytes32::new(hex_literal::hex!(
660 "ec7c304708c7d59c078d5ae098d0dea004decf47fa1cafebb266c10ad6466ce8"
661 )),
662 );
663 }
664
665 /// Literal pin: the treasury address equals digstore-chain's
666 /// source-of-truth bech32m form (`digstore_chain::dig::TREASURY_ADDRESS`,
667 /// `crates/digstore-chain/src/dig.rs:41`). A drift misdirects funds.
668 #[test]
669 fn dig_treasury_address_is_canonical() {
670 assert_eq!(
671 DIG_TREASURY_ADDRESS,
672 "xch1a37rq3cgcl2ecpudttsf35x75qzdan68lgw2l6ajvmqs44jxdn5qv6pk3y",
673 );
674 }
675
676 /// KAT: the bech32m address and the inner puzzle hash cannot silently drift
677 /// apart. Decodes `DIG_TREASURY_ADDRESS` (HRP `xch`, bech32m) and asserts
678 /// the 32 decoded bytes equal `DIG_TREASURY_INNER_PUZZLE_HASH`, proving the
679 /// two constants encode the SAME on-chain recipient.
680 #[test]
681 fn dig_treasury_address_decodes_to_inner_puzzle_hash() {
682 use bech32::Hrp;
683 let (hrp, data) = bech32::decode(DIG_TREASURY_ADDRESS).expect("valid bech32m");
684 assert_eq!(hrp, Hrp::parse("xch").unwrap(), "HRP must be xch");
685 assert_eq!(
686 data.as_slice(),
687 DIG_TREASURY_INNER_PUZZLE_HASH.to_bytes(),
688 "address must decode to the pinned inner puzzle hash",
689 );
690 }
691
692 /// Every baked-in AGG_SIG additional-data value MUST equal the §4.1 rule
693 /// applied to the network's genesis: AGG_SIG_ME == genesis, and each other
694 /// variant == `sha256(genesis || opcode_byte)`. This regenerates the values
695 /// independently and asserts the constants match — so a genesis change that
696 /// forgets to recompute a derived value is caught.
697 #[test]
698 fn agg_sig_additional_data_matches_derivation_rule() {
699 for net in [&DIG_MAINNET, &DIG_TESTNET] {
700 let genesis = net.genesis_challenge();
701 assert_eq!(net.agg_sig_me_additional_data(), genesis);
702
703 let c = net.consensus();
704 let derived: Vec<Bytes32> = AGG_SIG_OPCODES
705 .iter()
706 .map(|&op| {
707 let mut preimage = genesis.as_ref().to_vec();
708 preimage.push(op);
709 Bytes32::new(sha256(&preimage))
710 })
711 .collect();
712 assert_eq!(c.agg_sig_parent_additional_data, derived[0]);
713 assert_eq!(c.agg_sig_puzzle_additional_data, derived[1]);
714 assert_eq!(c.agg_sig_amount_additional_data, derived[2]);
715 assert_eq!(c.agg_sig_puzzle_amount_additional_data, derived[3]);
716 assert_eq!(c.agg_sig_parent_amount_additional_data, derived[4]);
717 assert_eq!(c.agg_sig_parent_puzzle_additional_data, derived[5]);
718 }
719 }
720}