协议参数

所有协议参数都集中在 crates/ksana-primitives/src/params.rs 这一个文件里：结构体 Params，以及每个网络各一个常量 DEVNET、SIGNET 和 MAINNET。本页对每个参数的称呼与规范和代码注释相同（CHAIN_ID、ANCHOR_DEPTH）。Params 里的字段就是同一个名字的小写形式，其中六个另带单位后缀（target_block_time_secs、asert_half_life_secs、max_future_block_time_secs、max_timestamp_ahead_of_anchor_secs、min_settlement_feerate_sat_vb、max_wasm_memory_bytes）。

金额以最小单位计：KSA 有 8 位小数，所以 1 KSA 等于 100,000,000 个最小单位。以秒或年给出的时间，都假定 DAA 分数按目标每 5 秒前进一个单位。主网尚未上线：它的取值就是规范所冻结的那些，规范第 13.1 节逐一给出了理由，并标出了上线前仍需实测的少数几项，例如 Argon2id 的参数。

三个网络

项目在 signet.ksana.network 上托管 signet 的两个种子节点、索引器和网页钱包（见公开 signet）。节点和索引器用 --chain devnet|signet|mainnet 选择网络，默认是 devnet。ksana-cli 按它所连节点的链 ID 确定网络，它的 --chain 只用来声明你预期的网络。

链 ID 写在每个 VmOp 里，所以为一个网络签名的操作，在其他网络上都无效。它也是工作量证明所用 Argon2id 盐的一部分。

各网络之间的差异

本页的其他参数在三个网络上取值都相同。signet 与 devnet 只在 CHAIN_ID 和 ANCHOR_DEPTH 上不同，params.rs 里有一个测试检查这一点。

路径 C 交易有了 NATIVE_CONFIRMATIONS + ANCHOR_DEPTH 个比特币确认，就会被强制收录：devnet 上 1 个，signet 上 2 个，主网上 5 个。锚定在比特币高度 A 的区块，必须收录直到高度 A − NATIVE_CONFIRMATIONS + 1 为止的原生交易，而出块者锚定在自己的比特币链顶之下 ANCHOR_DEPTH 个区块处（crates/ksana-btc/src/native.rs）。

工作量证明与难度

在普通 CPU 的一个核心上，一次 Argon2id 哈希约需 1 毫秒。在主网上，0x1f00ffff 对应约 2^240 的目标值：在这个最低难度下，每块约需 65,536 次哈希，所以大约 13 个核心就能每 5 秒找到一个区块。创世配置可以设定更难的 bits，与上线时预期的算力相匹配。devnet 和 signet 用的是 0x207fffff，即比特币 regtest 最容易的目标值。

两速难度。有条目的区块权重为 1。选定链上连续的第 s 个空块，权重为 min(N × 2^(s − 1), N_MAX)，其中 N = EMPTY_BLOCK_DIFFICULTY，N_MAX = MAX_EMPTY_BLOCK_WEIGHT：依次是 12、24、48、96，之后每个都是 120（Params::empty_block_weight）。区块的 PoW 目标值要除以它的权重，权重还计入 DAA 分数，也决定区块占几个奖励槽，所以空闲的链大约每 1、2、4、8 分钟出一块，之后每 10 分钟一块。见挖矿。

时间戳

节点只在收到新区块时检查接收规则。共识规则对每个区块都成立，包括从历史中同步来的区块，以及从比特币重建的区块。

区块 DAG

剪枝让节点的内存占用保持有界。剪枝点的蓝分数比剪枝根至少低 GhostdagParams::min_pruning_depth = 3 × (MERGE_DEPTH + GHOSTDAG_K) + 1 = 2,209（crates/ksana-consensus/src/ghostdag.rs）。剪枝根取在多深、节点多久剪枝一次，则属于本地设置，列在本地策略的默认值中。

比特币锚定与最终性

这些数字对一笔操作多久能最终意味着什么，见确认与最终性。

数据上限

最后三项在 crates/ksana-primitives/src/lib.rs 里。这些上限同样是共识规则：改动其中任何一项都是共识变更，和改动 Params 的字段一样。

gas 与执行上限

虚拟机在 crates/ksana-vm/src/limits.rs 里另有一组固定上限（MAX_CALL_INPUT_BYTES 在 engine.rs 里）：

为每个宿主函数定价的 gas 表，见宿主函数。

奖励与总量

KSA 只以出块奖励的形式发行。每个区块占用的奖励槽数等于它的权重，也就是它所覆盖的那些 DAA 分数，每个槽按所在减半周期的奖励发放。第 k 个周期持续 REWARD_HALVING_INTERVAL × 2^min(k, REWARD_INTERVAL_DOUBLINGS) 个 DAA 分数，每槽发放 BLOCK_REWARD / 2^k，向下取整到整数个最小单位（Params::reward_period_at、block_reward_at）。

在主网上，最后一个最小单位在第 28 周期发放；从 DAA 分数 1,387,500,000 起（约第 220 年），奖励为 0。主网所有的槽合计发放 20,999,999,600,000,000 个最小单位，比上限少 4 KSA。奖励总额的上界 Params::max_total_rewards = BLOCK_REWARD × REWARD_HALVING_INTERVAL × (REWARD_INTERVAL_DOUBLINGS + 2) 在主网上恰好等于 KSA_MAX_SUPPLY，所以主网没有创世分配。

在 devnet 和 signet 上，每个周期都是 25,228,800 DAA 分数（约 4 年），第一个周期每槽发放 9.9 KSA；从 DAA 分数 756,864,000（第 30 周期）起，奖励为 0。它们的奖励上界是 499,530,240 KSA，所以在 1,000,000,000 KSA 的上限之下，最多还能留给创世分配 500,469,760 KSA。

携带者那份，在主网上是一个 4.2 KSA 的槽里的 0.21 KSA，在 signet 上是一个 9.9 KSA 的槽里的 0.495 KSA；没有谁够格成为携带者时，这份留给出块者。

奖励和手续费在解锁时发放，也就是等这个区块及其每个祖先区块的数据都写入比特币之后。KSA 与奖励一页讲解发行时间表、携带者和解锁。

升级

三个网络的 Params::upgrades 都是空的：区块的协议版本是 2（BLOCK_VERSION），接受版本 2 的 VmOp。一个升级项从指定的 DAA 分数起提高协议版本，并可以为这些规则设定新值：BLOCK_GAS_LIMIT、NATIVE_MAX_GAS、接受的 VmOp 版本、BLOCK_SHARE_BPS、BLOCK_SHARE_END、CARRIER_BPS 和 CARRIER_FEE_BPS。其他改动，比如新的执行规则或编码，在代码里按协议版本分支，并随同一个升级项激活。

有些参数在一个网络的整个生命期内固定不变，不进升级表：ASERT_HALF_LIFE、EMPTY_BLOCK_DIFFICULTY、MAX_EMPTY_BLOCK_WEIGHT、Argon2id 的参数、REWARD_INTERVAL_DOUBLINGS 和 CARRIER_REPOST_DELAY。节点通过 ksana_getChainInfo 报告它的链 ID、协议版本和下一个排期中的升级：

curl -s -H 'content-type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"ksana_getChainInfo","params":[]}' \
  https://signet.ksana.network/rpc | jq .result

{
  "chain_id": 1002,
  "tip": {
    "height": "281",
    "hash": "d18e91c9383400d27166695177decadb89399456e55d79eb6e6164d625edaf95"
  },
  "daa_score": "12199",
  "protocol_version": 2,
  "next_upgrade": null,
  "max_known_version": 2,
  "finalized": {
    "height": "241",
    "hash": "0cb65c0a51c1200757560f9ed1a2aa28f5a01a236bbdda8005120eb609a8ae6b"
  }
}

DAA 分数远远跑在高度前面，因为 signet 大部分时间都处于空闲：它的空块每个权重 12 到 120。

创世配置

一个网络的每个节点和索引器，都从同一份创世配置启动，那是一个 JSON 文件（crates/ksana-execution/src/genesis_file.rs）。数据目录会记下这份配置的指纹，换了别的配置就拒绝打开。

• devnet 没有提交到仓库的文件：每次 devnet 从头启动，devnet/init.sh 都会写一份新的，带着新的随机密钥。
• signet 使用仓库中的 signet/genesis.json。它的 bits 预期每块约 10,000 次 Argon2id 哈希，这是按两个各用一个线程挖矿的种子节点定的（signet/ksana-signet.sh）。第一笔分配 100,000,000 KSA 供水龙头发放；第二笔 10,000,000 KSA 属于运营方。
• 主网只有模板 mainnet/genesis.json。区块分享账户是占位符 KSANA_BLOCK_SHARE_ACCOUNT_TBD___ 的配置，节点和索引器一律拒绝；在主网上，它们还要求设定区块分享账户、不得有分配，并且锚定块和时间戳都必须是真实的。

{
  "timestamp": "1791922279",
  "btc_anchor": {
    "height": 326234,
    "hash": "125a733363723ca64466266cabd12c462c62480b346330560ac79ef801000000"
  },
  "bits": 520523192,
  "allocations": [
    {
      "account": "de6603f052fd5bfaae5678a2a20ae6ae4fe4ae00c89db70a2efea7429851afc0",
      "amount": "10000000000000000"
    },
    {
      "account": "6431409abb9b8434defe68b0e066cf76610ac7b1cf49f2d02bc807543877dc0e",
      "amount": "1000000000000000"
    }
  ],
  "block_share_account": "0073719af1ae0718ca4fde1055e6c5c34157eefd54302c9b19deb28927ce8d8c"
}

锚定块的哈希按比特币的内部字节序书写，与 bitcoin-cli getblockhash 打印的顺序相反。主网上线之前，共识一旦改动，signet 就会换一份新的创世配置从头开始，余额不会带过去。

本地策略的默认值

这些是节点自己的设置，不是共识规则：每个运营者都可以修改，设置不同的节点，认定的仍是同一条链。运行节点一页讲解这些选项。

只读的 ksana_call 最多用 BLOCK_GAS_LIMIT 的 gas 运行，一个节点同时最多运行 4 个。

默认端口

Docker Compose 中的 devnet 把 bitcoind 发布在 18443（P2P 在 18444），三个节点在 18545 到 18547，索引器在 18548。signet 的第一个种子节点是 {{signet.p2p}}，其他服务地址列在公开 signet 一页。