79 lines
6.7 KiB
Markdown
79 lines
6.7 KiB
Markdown
# Igneum public testnet: identity, parameters and reset policy (PROPOSED, 4 October 2026, night)
|
|
|
|
Every value in this file is PROPOSED. The project signs the parameters off in the morning; the genesis is not final
|
|
until then, and a signed-off genesis is recomputed from the final values with the fork's `print_genesis_hashes` test.
|
|
The code lives on the node fork's branch `testnet-params` (worktree `vendor/igneum-node-testnet`, forked from
|
|
`finality-fixes` at `6aa69a45`), unit-tested, not merged, not deployed.
|
|
|
|
## 1. Identity
|
|
|
|
| Field | Devnet (live today) | Testnet (proposed) | Where |
|
|
|---|---|---|---|
|
|
| Network id (handshake string, data directory) | `igneum-devnet` | `igneum-testnet-1` | `consensus/core/src/network.rs`, `NetworkId::to_prefixed` |
|
|
| Network type and suffix | Devnet, none | Testnet, suffix 1 | `config/params.rs`, `From<NetworkId>`: only suffix 1 resolves; any other suffix is refused |
|
|
| EVM chain id | 4463 | 4462 | `consensus/core/src/evm.rs`, `evm_chain_id` (mainnet 4461) |
|
|
| Address prefix | `igneumdev` | `igneumtest` | `crypto/addresses` |
|
|
| gRPC port | 26610 | 26810 | `network.rs`, `default_rpc_port` |
|
|
| P2P port | 26611 | 26811 | `network.rs`, `default_p2p_port` (a later suffix takes the next port) |
|
|
| wRPC Borsh, JSON | 27610, 28610 | 27810, 28810 | `network.rs` |
|
|
| EVM JSON-RPC port | 26790 | 26890 | `igneum/exec/src/config.rs`, `default_evm_rpc_port` |
|
|
| DNS seeders | none | none (the list is filled when the seed nodes exist, `docs/plans/seed-nodes.md`) | `TESTNET_PARAMS.dns_seeders` |
|
|
| Override file (`--override-params-file`) | allowed | refused, as on mainnet | `kaspad/src/daemon.rs` |
|
|
| `IGNEUM_POW_*` environment | ignored by the node from this branch (G12: the params' schedule is installed on every start) | ignored | `kaspad/src/daemon.rs` |
|
|
|
|
Start a node on it: `igneumd --testnet --netsuffix 1` (the flag `--testnet` is "Use the Igneum test network";
|
|
`--netsuffix` defaults to 10 in `kaspad/src/args.rs` and must be set to 1 until the default is changed, which is
|
|
one line and waits for the sign-off).
|
|
|
|
## 2. Genesis
|
|
|
|
| Field | Value | Note |
|
|
|---|---|---|
|
|
| Timestamp | 1,791,158,400,000 ms = 2026-10-05T00:00:00Z (`0x1a1095c3400`) | frozen; proposed |
|
|
| Bits | `0x1d100000` (2^28 expected hashes per block) | the devnet's launch difficulty, sized for a few hundred MH/s; the DAA takes over after 150 samples (600 blocks); re-size to the announced launch fleet |
|
|
| Nonce, DAA score | 0, 0 | |
|
|
| UTXO commitment | empty | |
|
|
| Coinbase payload message | `igneum-testnet-1 \| 2026-10-05 \| proposed, not final \| coins here have no value \| resets are announced` | after the OP-FALSE script, as the devnet's `igneum-devnet` |
|
|
| Hash | `52a3e6a9ddd79d603ff9e3a27487fb5d0ca5ca6f633fe20ca727e1faa355fc7e` | computed 4 October 2026 by `print_genesis_hashes` on the branch (pinned by `test_genesis_hashes`); changes with any field above |
|
|
| Merkle root | `3060aab78494de3cbda68619c0132300aa486dc3153dbb78b50a430f053b3a84` | same |
|
|
|
|
## 3. Consensus parameters
|
|
|
|
| Parameter | Testnet (proposed) | Devnet today | Why |
|
|
|---|---|---|---|
|
|
| Block rate | 1 per second | 1 per second | spec 02 |
|
|
| Difficulty rule | Igneum dual-lane, v2 from genesis | dual-lane, v2 from DAA 33,000 | a fresh chain has no pre-switch history |
|
|
| Finality parameters | `FinalityParams::MAINNET`: 30-day weight window (2,592,000 DAA), dust 100, presence 240, 8 aggregators, 30-day equivocation ban, min DAA 2,592,000, certificate fold 6 | `DEVNET`: 2-hour window, dust 5, presence 20, fold 3 | the testnet runs the rule the mainnet will run; the first lock needs 30 days of weight, which is the point of a testnet |
|
|
| Finality rule v3 | from genesis | from the override file | fresh chain |
|
|
| Proving v0 payouts | from genesis | from the override file | fresh chain |
|
|
| PoW schedule | epoch 3,600 DAA, lead 600, day 86,400,000 ms (the defaults) | same | |
|
|
| Coinbase payload limit | 16,384 (the finality section) | same | |
|
|
| Fees | `FeeParams::CALIBRATED_V1` (`docs/analysis/base-fee-floor.md`): `B_p` 120,000 pgas, `S_p` 30,000, intrinsic 300, modexp 10 + 1 per 10 bytes, floors 100 gwei per gas and 10,000 gwei per pgas | the same set on this branch; the live devnet runs the prototype (`B_p` 30 M, 1 gwei) | spec 05 section 5.10 |
|
|
| Emission | the mainnet schedule: 31.69 IGN per block in year one, halving every two years, cap 4 billion | same | the testnet coins have no value whatever the schedule says |
|
|
|
|
Everything else (mass limits, GHOSTDAG k, merge depth, pruning) is the devnet's set, unchanged.
|
|
|
|
## 4. Reset policy
|
|
|
|
| Rule | Proposed |
|
|
|---|---|
|
|
| Coins | Testnet IGN has no value, cannot be bought, sold or redeemed, and is not a claim on anything at mainnet. Mainnet starts from an empty genesis. No airdrop, no points, no promise tied to a testnet balance |
|
|
| When the chain resets | When a consensus rule changes (the lottery hash, the difficulty rule, finality, the fee table, the execution rules) and a height switch is not the right tool; or when the chain is broken beyond a height switch |
|
|
| Notice | At least N = 7 days ahead, on igneum.network (the download page and the live page), in the app through the update manifest's note, and in the engineering log. A reset without notice is a bug report, not a policy |
|
|
| What carries over | Nothing. Balances, contracts, nonces and history start again. Addresses stay valid (an address is a key) |
|
|
| Identity after a reset | A consensus-changing reset takes the next suffix (`igneum-testnet-2`, chain id unchanged at 4462, P2P port 26812), so a node on the old rules never completes a handshake with the new chain |
|
|
| The devnet | Keeps resetting without notice; it is a developer network. Its chain id 4463 stays separate |
|
|
| Who decides | The project, by the sign-off that this file records; the parameters the genesis rules leave to miners (`B_p`, the floors) move by 60% signalling once the testnet has miners (spec 5.5) |
|
|
|
|
## 5. What stands between this file and a public testnet
|
|
|
|
| Item | State |
|
|
|---|---|
|
|
| Sign-off of every value above | waits for the morning |
|
|
| `--netsuffix` default 1 under `--testnet` | one line in `kaspad/src/args.rs`, after the sign-off |
|
|
| Seed nodes and the DNS seeder list | `docs/plans/seed-nodes.md`; the list in `TESTNET_PARAMS` is empty on purpose |
|
|
| The public RPC and explorer | `site/wallet.html` carries a placeholder RPC URL until they exist |
|
|
| The prover's table mirror and fixtures | `docs/analysis/base-fee-floor.md` section 4 |
|
|
| The app's testnet build | the app's packaged config names the network; `igneum-testnet-1` needs the network and ports there (`app/igneum-app/src/config.rs`, `Runtime.network`) |
|
|
| The params digest in the handshake (X18) | separate work, before the testnet |
|
|
| Terms on the download page | `site/index.html#testnet-terms`, on branch `testnet-prep` with this file |
|