公告

!!! 注意 “关于本页面”

本页面由社区成员维护和更新。

如需发布公告（例如您发起的治理投票相关公告），请在 gonka-docs 仓库中提交 Pull Request：[https://github.com/gonka-ai/gonka-docs](https://github.com/gonka-ai/gonka-docs)

本页面内容不保证完全覆盖所有信息。有关最新信息（包括治理投票的发起及当前状态），请参考链上数据或查看相关浏览器与仪表盘。

2026年5月26日

升级已执行：v0.2.13 现已在主网上线

Upgrade Proposal v0.2.13（proposal id 54）的链上治理投票已结束。该提案已被批准（APPROVED），并且升级已在区块 4267300时成功于主网上执行。

2026年5月25日

升级 v0.2.13：预下载二进制文件与 MiniMax-M2.7 权重

v0.2.13 升级提案（proposal id 54） (https://github.com/gonka-ai/gonka/pull/1143)54)已通过链上治理，升级现已排期。

• 升级高度：4267300 • 预计升级时间：2026年5月26日 14:42 UTC（07:42 PDT）

提前预下载二进制文件和权重，有助于避免在升级窗口期间依赖 GitHub / Hugging Face 的可用性。

# 1. 创建目录
sudo mkdir -p .dapi/cosmovisor/upgrades/v0.2.13/bin \
              .inference/cosmovisor/upgrades/v0.2.13/bin && \
# 2. DAPI: 下载 -> 校验 -> 直接解压到 bin -> 添加可执行权限
wget -q -O decentralized-api.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.13/decentralized-api-amd64.zip" && \
echo "cf31fa4d715e721d1e17b7e2b46d628a0b66b6ef603d352d587abe1d57c40925 decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.13/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.13/bin/decentralized-api && \
echo "DAPI Installed and Verified" && \
# 3. Inference: 下载 -> 校验 -> 直接解压到 bin -> 添加可执行权限
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.13/bin/ && \
wget -q -O inferenced.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.13/inferenced-amd64.zip" && \
echo "ea7dea6c4e8d96ed61005bed196768cc9f44e5fb17f0714cb64d1d00a485be0c inferenced.zip" | sha256sum --check && \
sudo unzip -o -j inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.13/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.13/bin/inferenced && \
echo "Inference Installed and Verified" && \
# 4. 清理与最终检查
rm decentralized-api.zip inferenced.zip && \
echo "--- Final Verification ---" && \
sudo ls -l .dapi/cosmovisor/upgrades/v0.2.13/bin/decentralized-api && \
sudo ls -l .inference/cosmovisor/upgrades/v0.2.13/bin/inferenced && \
echo "f93d579ef9c46ade9f28c73c339df2f7ae73607115b7efeb849316984924f68d .dapi/cosmovisor/upgrades/v0.2.13/bin/decentralized-api" | sudo sha256sum --check && \
echo "e52b86c4f64a47f0ea9bdb3327feb321b8a4208a76b35d52a7e9ddd1b9d6eed5 .inference/cosmovisor/upgrades/v0.2.13/bin/inferenced" | sudo sha256sum --check

2026年5月22日

v0.2.13 投票已结束——准备在高度 4267300 进行升级

链上治理投票升级提案 v0.2.13 (提案 id 54) 已结束。该提案已被批准。

升级将在主网上于 区块高度 4267300 (约为 2026年5月26日星期二 14:42 UTC / 07:42 PDT ）。

提醒事项

请确保你的 bridge 容器为最新版本并已同步。Ethereum 主网 bridge 合约 (0x972a7a92d92796a98801a8818bcf91f1648f2f68)、USDC/USDT token metadata，以及 CW20 wrapped_token code id 105 ，都会通过 upgrade handler 本身完成注册，因此 bridge 会在升级高度时于主网上激活。验证说明详见https://gonka.ai/docs/network-updates/#may-7-2026.
如果你计划运行 MiniMaxAI/MiniMax-M2.7，请现在预下载约 230 GB 的 FP8 权重。在 bootstrap window 期间，Hugging Face 的限速和带宽拥堵可能会导致错过首次 eligibility check。
升级完成后，每个host都需要为每一个治理批准模型声明 participation mode —— Qwen/Qwen3-235B-A22B-Instruct-2507-FP8、moonshotai/Kimi-K2.6以及MiniMaxAI/MiniMax-M2.7 。即使 host 只运行其中一个或两个模型，也仍然需要为其他模型设置 DELEGATE 或 REFUSE。MiniMax 的截止时间为 chain epoch 278 (约为2026年5月29日星期五 UTC — 或 5月28日星期四晚 PDT). 如果 host 不进行任何操作，则从 epoch 278 开始，其全部 weight 每 epoch 将受到 15% 的惩罚。
请计划在升级窗口期间保持在线，以便及时执行任何后续步骤或缓解措施。请确保 .inference/data 有足够的可用空间用于 cosmovisor 状态备份；如果 application.db 较大，请考虑在升级前应用 cosmovisor backup guide 中的 cleanup techniques 。
v0.2.13 的 calibration 将 Kimi K2.6 的 WeightScaleFactor 从 1.26 调整为 0.78 ，以反映 vLLM-0.20.1 之后 Qwen-on-B200 reference 的吞吐基准。该调整仅影响你 consensus weight 中来源于 Kimi 的部分；你的 Qwen-derived weight 以及 Kimi 内部 PoC 分配不会改变。在 B200/B300 上，Kimi 仍然是收益最高的选项；在 H100/H200 上，MiniMax-M2.7 将成为与 Qwen 相近、但高于 Kimi 的选项。
提案: https://github.com/gonka-ai/gonka/pull/1143
迁移逻辑: upgrades.go

2026年5月20日

v0.2.13 升级提案进入治理投票阶段

The v0.2.13 proposal 已重新上链并开放投票。这是此前已发布但未通过的提案的重新提交版本，目前包含了若干更新内容。

包含内容：重新校准 Kimi 的权重 (0.78)、新增模型 MiniMaxAI/MiniMax-M2.7、验证阈值更新、devshard 存储重构，以及多个 PoC / 奖励修复。
在主网上激活 Ethereum bridge（详见下方专门章节）。
提案将升级后的宽限窗口扩展至 3000 个区块，以便新的 snapshot 逻辑稳定期间，host 不会受到惩罚。
Governance: 将 genesis-guardian 的投票权降低至约 25%，并将全链 quorum 设置为 0.25。如果 guardian 不投票，则非 guardian 节点需要在剩余 75% 投票权中达到约 1/3 的参与率才能满足 quorum（详见 inference-chain 部分）。
必需准备：检查 bridge 容器、决定是否参与 MiniMax、更新 dashboard、完成投票。
在提案通过之前，链上不会发生任何变化。

PR 地址: https://github.com/gonka-ai/gonka/pull/1143

关键变更

模型

新增 MiniMaxAI/MiniMax-M2.7 作为 governance 批准模型及 PoC 模型。
更新 inference 验证阈值：
- Qwen 235B: 0.940
- Kimi K2.6: 0.900
- MiniMax-M2.7: 0.922
基于 vLLM 0.20.1 发布后，以 Qwen-on-B200 为参考重新校准 WeightScaleFactor ：
- Qwen 235B: 0.359 （无变化）
- Kimi K2.6: 0.78 （从 1.26 下调，在相同 PoC 权重下，Kimi 每 epoch 的共识权重大约下降 38%）
- MiniMax-M2.7: 0.3024

参考数据： https://docs.google.com/spreadsheets/d/1dHHlbhW1_hVgd7Q6MtmcVSOpmnl7NnynoTzPHJ1oU-g/edit?gid=0#gid=0

inference-chain

将 devshard nonce 限制从 20_000 提升至 1_000_000。
将每 epoch 最大 devshards 数量从 100 提升至 500_000。
修复新模型 bootstrap 期间 confirmation PoC 奖励计算问题。
在升级 epoch 剩余时间内禁用 confirmation PoC，使新的 snapshot 逻辑能够从下一个 epoch 干净启动。
当参与者重新变为 active 状态时，重置 ConsecutiveInvalidInferences。
为在 v0.2.12 之前加入的 DAPI 回填缺失的 MsgRespondDealerComplaints authz 授权。
修复 bridge 与 liquidity-pool 合约调用中可能导致间歇性权限错误的 wiring 问题。
将 genesis guardian 调整后的投票权降低至约 25%，并将全链治理 quorum 设置为 0.25。如果 guardian 不参与投票，则剩余 75% 投票权中的有效 quorum 为约 1/3 (0.25 / 0.75 = 0.334)。
向 allowed_creator_addresses新增 4 个早期 host 与 broker。

Ethereum bridge 主网激活

通过 upgrade handler 激活 Ethereum 主网 bridge 配置。
注册 Ethereum bridge 合约地址 0x972a7a92d92796a98801a8818bcf91f1648f2f68、USDC 与 USDT token metadata、bridge trading approvals，以及 CW20 wrapped_token code ID 105。
活后，bridge 将支持 Gonka 主网与 Ethereum 之间的跨链转账（包括 Ethereum 上的 GNK wrapping，以及 USDC / USDT bridge）。Wrap / unwrap 脚本及 operator 工作流文档将后续单独提供。

decentralized-api & devshard

默认启用 NodeManagerGrpcPort ，端口为 9400。
为 devshard state 新增 Postgres 支持。
为 SQLite 与 Postgres devshard 数据库新增 pruning 功能。
新增 state snapshot，用于更快的 devshard 启动与恢复。
修复 OpenAI-compatible API response parsing。
修复长时间启动行为以及 devshard invalidation flow 的边缘情况。

升级计划

如果提案通过，binary 版本将通过链上升级提案进行更新。更多升级流程信息请参考 /docs/upgrades.md.

升级前需要准备的操作

如果提案通过，建议提前完成以下准备。

MiniMaxAI/MiniMax-M2.7 参与选择（需在 epoch 278 前完成，届时开始惩罚）

对于每一个 governance 批准模型，多模型 PoC 要求每个 host 必须明确选择参与方式（DIRECT / DELEGATE / REFUSE）。如果在模型的 PenaltyStartEpoch 之后仍未操作，将会受到惩罚。现阶段，建议提前决定自己的选择，以便在提案通过且升级成功应用于主网后，能够快速完成配置。

Bridge 容器更新 / 验证

所有 host 都需要确认自己的 bridge 容器已经部署、运行最新版本，并且同步正常。部分 host 可能已经部署了 bridge 容器。在这种情况下，请先确认当前运行的是最新版本，再执行后续操作。请参考说明 https://gonka.ai/docs/network-updates/#may-7-2026

Dashboard / Explorer 更新（升级前后均可）

请 host 更新 dashboard / explorer。请在 gonka/deploy/join 目录下执行以下命令：如果本地尚未 clone gonka 仓库，请先按照 join-network guide 操作。该 dashboard 更新只是 container pull，无论投票结果如何，均可安全地在投票结束前或结束后执行。

docker compose -f docker-compose.mlnode.yml -f docker-compose.yml pull explorer
docker compose -f docker-compose.mlnode.yml -f docker-compose.yml up -d explorer

如何投票

如果你没有直接访问持有投票权 key 的权限，或者希望由其他 key 代为投票，请参考该指南，通过 cold key 向 warm key 授予 governance voting 权限：the guide 提案详情与投票可通过 inferenced 查看。任意 active node 均可使用。可用节点：

http://node1.gonka.ai:8000
http://node2.gonka.ai:8000
https://node3.gonka.ai

进行投票 (yes, no, abstain, no_with_veto): --unordered 与 --timeout-duration 参数要求 inferenced 版本为 v0.2.12 或更高。

export NODE_URL=https://node3.gonka.ai/
./inferenced tx gov vote 54 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

查看投票状态：

export NODE_URL=https://node3.gonka.ai/
./inferenced query gov votes 54 -o json --node $NODE_URL/chain-rpc/

时间节点

投票结束时间：2026年5月22日 22:12:25 UTC
提议升级高度：4267300
预计升级时间：2026年5月26日 14:42:02 UTC
Operator 时间线：投票于 5 月 22 日 22:12 UTC 结束 → 升级高度预计约为 5 月 26 日 14:42 UTC → 升级 epoch 剩余时间内跳过 confirmation PoC（≤ 10000 区块宽限窗口）→ MiniMax bootstrap snapshot 将在 start_poc 前 500 个区块进行（约提前 43 分钟）→ 第一个 MiniMax PoC 阶段将在升级后的下一个 epoch 边界启动 → MiniMax 惩罚机制将在链 epoch 278 开始执行。

注意事项

请确保在升级窗口期间在线，以便能够及时执行任何后续步骤或缓解措施。
升级期间，Cosmovisor 会在 .inference/data目录中创建完整状态备份；请确保磁盘空间充足（主网上 application.db 的 Cosmovisor 备份通常为数十 GB，请提前确认）。关于如何安全删除 .inference 目录中的旧备份，请参考文档
如果 application.db 占用了大量磁盘空间，可参考 cosmovisor backup guide 中描述的清理方法： guide 。
提案将故意从升级高度开始，到升级 epoch 结束期间跳过 Confirmation PoC（10000 区块宽限窗口）。如果提案通过，该跳过行为属于预期情况，并非故障；新的 snapshot 逻辑将从下一个 epoch 开始生效。
如果提案通过，升级后 devshard storage 可以选择使用共享 Postgres 实例作为后端（环境变量与 payload storage 相同）。本地 SQLite 仍然是默认方案，并会自动 pruning（仅保留最近 3 个 epoch）。
如果提案未通过（未达到 quorum，或 no_with_veto 超过 1/3），链上不会发生任何变化，升级也不会执行。Operator 可能会看到 PROPOSAL_FAILED 状态，这是正常现象，无需采取任何操作。

2026年5月18日

proxy 容器可能会全局限制到 devshards 的并行连接数量，而不是按客户端分别限制。

修复该问题的 PR： https://github.com/gonka-ai/gonka/pull/1183

应用修复方法：

在 docker-compose.yml 中设置容器版本

...
  proxy:
    container_name: proxy
    image: ghcr.io/product-science/proxy:0.2.12-post5
...

重启容器：

source config.env && docker compose up -d proxy --force-recreate --no-deps

在 PoC / Confirmation PoC 阶段之外更新容器会更加安全。检查是否存在 Confirmation PoC：

curl "https://node3.gonka.ai/v1/epochs/latest" | jq '.is_confirmation_poc_active'

2026年5月17日

Epoch #267：PoC 验证已恢复

PoC 验证已在 epoch #267 成功完成，受影响的 hosts 已能够重新返回 active set。

epoch #266 中的问题是由一次影响运行 Kimi 模型 hosts 的攻击所导致。网络本身仍持续运行，但该攻击结合多个相关条件，导致许多参与者无法进入 epoch #266。

在额外保护措施应用期间，Inference 可能会暂时不可用。预计访问会逐步恢复，并首先通过部分社区 proxy 与 broker endpoints 提供。

发生了什么

在 epoch #266 中，网络的 active weight 出现了明显下降。

问题已被追踪到带有非标准语义（non-standard semantics）的 inference 请求。该攻击向量影响了运行 Kimi 模型的 hosts，并干扰了许多 host 的 PoC 参与。

在 epoch #267 中，hosts 已能够恢复，PoC 验证也已成功完成。

Inference 可用性

使用受影响的非标准语义的请求，网络现在应不再接受。

在相关保护措施应用期间，Inference 可能暂时不可用。预计访问会逐步恢复，并首先通过部分社区 proxy 与 broker endpoints 恢复。

Epoch #267 中的 Kimi 权重

Kimi 在 epoch #267 中的 active weight 较低，是由于现有协议规则所导致：单个模型的总权重不能超过前一个 epoch 中所有模型总权重的 75%。

由于 epoch #266 的总 active weight 明显较低，该规则也限制了 Kimi 在 epoch #267 中的权重。

随着未来 epochs 中正常 PoC 参与持续进行，权重可能需要数天时间才能恢复稳定。

Hosts 需要执行的操作

尽可能保持 API 节点在线并可访问。这有助于保留 host 参与情况的可见性，并支持后续审查。
监控后续 epochs 中的 PoC 参与情况。确认你的节点能够正常进入 PoC，并且 active weight 被正确反映。
仅使用受支持的 inference 请求格式。不要发送或转发带有非标准请求语义的 inference 流量。
预期会存在临时 inference 中断。访问可能不会立即在所有地方恢复，预计会通过社区 proxy 与 broker endpoints 逐步恢复。
在社区频道或当前帖子中分享相关日志或观察结果。如果你的 host 在 epoch #266 中受到影响，或者在后续 epochs 中表现异常，这一点尤其重要。

2026年5月16日

Epoch #266：PoC 权重下降调查

在当前 Epoch（#266）期间，网络的活跃权重出现了明显下降。目前看来，本轮 Epoch 的 PoC 投票未能收集到所需票数。具体原因尚未最终确认，社区正在积极调查该情况。

针对受影响的参与者

如果你的节点未能进入本轮 Epoch，请尽可能保持你的 API 节点在线并可访问。这可能有助于 Restitution Committee 收集 PoC 参与证据，并更准确地统计受影响的贡献。

调查进行中

社区成员目前正在审查 Epoch #266 期间发生的情况。一旦对根本原因有更多明确结论，将会分享进一步更新。如果你有相关观察、日志、假设或其他可能有助于调查的技术背景信息，请在这里分享。

2026年5月15日

v0.2.13 升级提案进入治理流程

v0.2.13 proposal 现已上链并开放投票。

包含内容：Kimi (0.78) 重新校准权重、新模型 MiniMaxAI/MiniMax-M2.7、验证阈值更新、devshard 存储重构，以及多个 PoC / 奖励修复、Ethereum bridge 主网激活。
提案增加了升级后的宽限窗口，以避免升级完成后 3000 个区块内对主机进行惩罚。
所需准备：检查 bridge 容器、决定是否参与 MiniMax、更新 dashboard、进行投票。
在提案获得批准之前，链上不会发生任何变化。

PR 地址：https://github.com/gonka-ai/gonka/pull/1143

关键变更

Models

新增 MiniMaxAI/MiniMax-M2.7 作为治理批准模型及 PoC 模型。
在 vLLM 0.20.1 发布后，基于 Qwen-on-B200 参考重新校准 WeightScaleFactor ：
- Qwen 235B: 0.359
- Kimi K2.6: 0.78
- MiniMax-M2.7: 0.3024
- 参考数据： https://docs.google.com/spreadsheets/d/1dHHlbhW1_hVgd7Q6MtmcVSOpmnl7NnynoTzPHJ1oU-g/edit?gid=0#gid=0
更新推理验证阈值。

inference-chain

将 devshard nonce 限制从 20_000 提升至 1_000_000。
将每个 Epoch 最大 devshards 数量从 100 提升至 500_000。
修复新模型 bootstrap 期间 confirmation PoC 奖励统计问题。
在升级 Epoch 剩余期间禁用 confirmation PoC，以便新的 snapshot 逻辑从下一个 Epoch 开始干净启动。
当参与者重新变为 active 状态时，重置 ConsecutiveInvalidInferences 。
为在 v0.2.12 之前加入的 DAPI 补全缺失的 MsgRespondDealerComplaints authz 授权。
修复 bridge 和 liquidity-pool 合约权限检查中的 Wasm keeper 访问问题。
将 genesis guardian 调整后的投票权降低至约 25%，并将全链治理 quorum 设置为 0.25。在 guardian 不投票的情况下，这意味着剩余 75% 投票权中的有效 quorum 为约 1/3（ 0.25 / 0.75 = 0.334）。

Ethereum bridge 主网激活

通过升级处理程序激活 Ethereum 主网 bridge 配置。
注册 Ethereum bridge 合约地址 0x972a7a92d92796a98801a8818bcf91f1648f2f68、USDC 与 USDT token 元数据、bridge 交易授权，以及 CW20 wrapped_token code ID 105。

decentralized-api & devshard

默认启用 NodeManagerGrpcPort ，端口为 9400。
为 devshard 状态新增 Postgres 支持。
为 SQLite 与 Postgres devshard 数据库新增 pruning 功能。
新增 state snapshots，以加快 devshard 启动与恢复速度。
修复 OpenAI-compatible API 响应解析问题。
修复长时间启动行为及 devshard invalidation 流程中的边缘情况。

升级计划

如果提案获得批准，二进制版本将通过链上升级提案进行更新。关于升级流程的更多信息，请参考 /docs/upgrades.md.

为升级所需进行的准备工作

如果提案获得批准，建议提前完成以下准备。

请在 Epoch 278 前完成 MiniMaxAI/MiniMax-M2.7 的参与选择

对于每个治理批准模型，多模型 PoC 要求每个 host 明确选择参与方式（DIRECT / DELEGATE / REFUSE）。如果在模型的 PenaltyStartEpoch 之后未进行任何操作，将会受到惩罚。因此，建议你提前决定首选方案，以便在提案通过并成功应用于主网后能够快速操作。

Bridge 容器更新 / 验证

所有 host 都需要确认其 bridge 容器已部署、运行最新版本并正确同步。部分 host 可能已经部署了 bridge 容器。在这种情况下，请先确认你运行的是当前版本，再进行后续操作。请参考说明：https://gonka.ai/docs/network-updates/#may-7-2026

Dashboard / explorer 更新（升级前或升级后）

请 host 更新 dashboard/explorer。请在 gonka/deploy/join 目录下执行以下命令：

docker compose -f docker-compose.mlnode.yml -f docker-compose.yml pull explorer
docker compose -f docker-compose.mlnode.yml -f docker-compose.yml up -d explorer

如何投票

如果你无法直接访问持有投票权的 key，或者希望其他 key 代为投票，请参考指南，了解如何将治理投票权限从 cold key 授权给 warm key。

提案详情与投票可通过 inferenced 完成。任何 active 节点均可使用。可用节点包括：

http://node1.gonka.ai:8000
http://node2.gonka.ai:8000
https://node3.gonka.ai

进行投票 (yes, no, abstain, no_with_veto):

export NODE_URL=https://node3.gonka.ai/
./inferenced tx gov vote 52 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

查看投票状态：

export NODE_URL=https://node3.gonka.ai/
./inferenced query gov votes 52 -o json --node $NODE_URL/chain-rpc/

截止时间

投票结束时间：2026年5月17日 07:58:37 UTC
提议升级高度：4133422
预计升级时间：2026年5月18日 13:03:17 UTC

注意事项

请尽量在升级窗口期间保持在线，以便及时执行后续步骤或缓解措施。
在升级期间，Cosmovisor 会在 .inference/data 目录中创建完整状态备份；请确保有足够磁盘空间。关于如何安全删除 .inference 目录中的旧备份，可参考文档
如果 application.db 占用了大量磁盘空间，可参考 cosmovisor backup 指南中描述的清理方法。
提案将有意从升级高度开始至升级 Epoch 结束（3000 区块宽限窗口）期间跳过 Confirmation PoC。如果提案通过，这是预期行为，并非故障；新的 snapshot 逻辑将从下一个 Epoch 开始。
如果提案通过，升级后 devshard 存储可选使用共享 Postgres 实例（与 payload storage 使用相同环境变量）。本地 SQLite 仍为默认方案，并会自动 pruning（仅保留最近 3 个 Epoch）。

2026年5月7日

Bridge 容器需要更新/验证

请各 Host 验证 bridge 容器是否已部署并运行最新版本。

部分 Host 可能已经部署了 bridge 容器。在这种情况下，请先检查当前运行的是否为最新版本，再进行后续操作。

最新 bridge 镜像：

ghcr.io/product-science/bridge:0.2.5-post5@sha256:8d2f217115c65b27fcb6fe1497471c30891534f18685bd3007d168aa7f1a9371

检查你的 bridge 是否已经运行正确版本：

docker inspect --format='{{.Image}}' bridge \
    | xargs docker inspect --format='{{range .RepoDigests}}{{.}}{{end}}' \
    | grep -q 'sha256:8d2f217115c65b27fcb6fe1497471c30891534f18685bd3007d168aa7f1a9371' \
    && echo "BRIDGE v0.2.5-post5 is running" || echo "WARNING: OLD BRIDGE"

如果命令返回：

BRIDGE v0.2.5-post5 is running

则表示你的 bridge 容器正在运行预期的镜像版本。

同时请验证 bridge 是否已同步：

docker logs bridge --tail 10000 | grep "Skeleton sync bounds" | tail -1
输出应指向一个近期 finalized 的 Ethereum 区块，并且不应明显落后。

如果命令返回 warning，请从 gonka/deploy/join 目录部署或更新 bridge 容器：

git checkout release/v0.2.5-post5
docker compose down bridge && sudo rm -rf .inference-eth
source config.env && docker compose pull bridge
source config.env && docker compose up bridge -d --force-recreate --no-deps

部署完成后，请再次验证版本：

docker inspect --format='{{.Image}}' bridge \
    | xargs docker inspect --format='{{range .RepoDigests}}{{.}}{{end}}' \
    | grep -q 'sha256:8d2f217115c65b27fcb6fe1497471c30891534f18685bd3007d168aa7f1a9371' \
    && echo "BRIDGE v0.2.5-post5 is running" || echo "WARNING: OLD BRIDGE"

如果 bridge 同步失败，则可能是 Ethereum checkpoint sync endpoint 不可用。在这种情况下，请更新 BEACON_STATE_URL 并重启 bridge：

sudo sed -i 's|- BEACON_STATE_URL=.*|- BEACON_STATE_URL=https://beaconstate.info/|' docker-compose.yml

source config.env && docker compose up bridge -d --force-recreate --no-deps

在更新或重启 bridge 后，请按照上述说明再次验证其是否已完成同步。

2026年5月6日

v0.2.13 升级 PR 审查

用于下一次链上软件升级 v0.2.13 的 The pull request 已开放供审查。

请直接审查该 PR 代码，并针对你发现的任何问题、疑问、建议优化、边界情况或安全漏洞留下评论。

有意义的审查贡献，包括重要评论、Bug 发现以及安全问题，可能会在下一次升级周期中获得社区奖励（bounty）资格。

本次仅为 Pull Request 的审查征集，并不会启动正式投票。治理投票流程将在审查期结束后开始，预计最可能于明天启动。

关键变更

inference-chain

Confirmation PoC 在 measured weight、preserved weight 以及 reward rescaling 中使用了不同的模型集合。在新模型 bootstrap 期间，这可能会错误惩罚同时服务于“符合资格模型”和“尚未符合资格模型”的诚实矿工。
当参与者重新变为 ACTIVE 状态时，ConsecutiveInvalidInferences 未被重置。一次新的错误推理可能会立即再次使其失效。现在该计数器会在重新激活以及即将晋升时被重置。
在 v0.2.12 之前加入的 DAPI，其 cold-to-warm authz grants 中没有 MsgRespondDealerComplaints 权限。本次升级会补充该权限，使其能够响应 dealer complaints。
Devshard settlement 用了硬编码的 20_000 nonce 限制。现在该限制改为 DevshardEscrowParams.MaxNonce，并且 v0.2.13 升级会将其设置为 1_000_000本次升级还会将 MaxEscrowsPerEpoch 提升至 500_000。
本次升级会为当前 epoch 安装一个 grace-epoch 条目，并扩展 UpgradeProtectionWindow (3000 blocks). Confirmation PoC triggers 将从升级高度开始一直到升级 epoch 结束期间被跳过，因此新的 snapshot 逻辑只会从下一个 epoch 开始运行。该机制复用了 v0.2.10 的 grace-epoch primitive。
Wasm keeper access 会在 app wiring 完成后再解析，因此 bridge 和 liquidity-pool 操作中的合约权限检查将正常工作。

decentralized-api

部分 OpenAI-compatible 上游返回的是数值类型的 stop_reason 。现在 Choice.StopReason 可接受任意 JSON 类型，因此这些响应不再会因 unmarshalling 失败。
内部 devshard storage migration 不再阻塞 dapi 启动。在 migration 与 recovery 完成之前，devshard routes 将保持不可用。

devshard

Devshard storage 可能会无限增长，因为旧 escrow 数据一直保存在同一个 SQLite store 中。现在存储改为 epoch-scoped，并会在后台清理旧 epoch，仅保留最近 3 个 epoch。
Devshard 在大型部署场景中需要共享存储方案。现在可使用 Postgres 作为主存储，同时保留 SQLite 作为本地 fallback。
Postgres 数据会按 epoch_id 对 sessions、diffs 和 signatures 进行分区，因此清理旧 epoch 数据时可以直接删除对应分区。
State snapshots 可减少长时间运行 session 的恢复工作量。
Payload lookup 现在会固定到 escrow epoch，同时对 epoch-boundary 与 legacy epoch-0 请求提供 fallback。
当前 epoch 的 shard stats 会暴露 nonce、version、group 以及 per-host counters。

bridge

Bridge tooling 现支持处理 Sepolia flags，并将 Gonka BLS keys/signatures 转换为 Ethereum 合约所要求的 EIP-2537 格式。
新增 GNK 与 wrapped-token bridge 操作脚本。

审查者可在以下链接中查看完整升级提案、迁移细节、测试总结以及提议流程：

2026年5月6日

在 api 容器版本 v0.2.11、v0.2.12 和 v0.2.12-api-post2 中存在一个潜在问题。在容器重启后，9100、9200 和 9400 端口上的服务可能会延迟很长时间才启动。这导致 api 激活延迟，因此部分矿工因此跳过了 Confirmation PoC。

本次修复通过并行加载 devshards，以及从 snapshots 恢复现有 devshard sessions，移除了该阻塞问题。

https://github.com/gonka-ai/gonka/pull/1143

请更新 api 容器的二进制文件。在每次 PoC 开始前，存在一个 500 block 的无 CPoC 窗口 (confirmation_poc_safety_window) ，因此这可能是最安全的部署版本。

更新前，请确保当前没有运行 CPoC 或 PoC。

部署方法（建议一次只更新一台机器以降低风险）：

sudo rm -rf decentralized-api.zip .dapi/cosmovisor/upgrades/v0.2.12-api-post3/ .dapi/data/upgrade-info.json
sudo mkdir -p  .dapi/cosmovisor/upgrades/v0.2.12-api-post3/bin/
wget -q -O  decentralized-api.zip 'https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.12-api-post3/decentralized-api-amd64.zip' && \
echo "3f2bc481b8320c53f0abe428dc262eaac5a86e8f38b8d796c409bd7116ba5017  decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j  decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.12-api-post3/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.12-api-post3/bin/decentralized-api && \
echo "API 已安装并校验完成"

docker stop api && \
sudo rm -rf .dapi/cosmovisor/current && \
sudo ln -sf upgrades/v0.2.12-api-post3 .dapi/cosmovisor/current && \
echo "da495bc4c414ac9a0d416f85c30dd8dfbbcc76883fd71f6c1e969d37fa184b20 .dapi/cosmovisor/current/bin/decentralized-api" && \
docker start api

部署完成后，请再次确认 9100 和 9200 端口上的服务器是否正常运行：

curl http://localhost:9200/admin/v1/nodes # 可能未绑定到 localhost

curl http://localhost:9100/versions # 可能未绑定到 localhost

2026年5月6日

在上一个 epoch 中，发现了在解析某些 Kimi-K2.6 响应时存在一个小问题。

修复：https://github.com/gonka-ai/gonka/pull/1143/changes#diff-4c44fd18f746bca1c63d9bcbb9a73f06bc0172bfb8a33152854920d4dffff0e8

我们建议替换 api 容器的二进制文件。除了该修复之外，新版本还为 devshard 数据库启用了 pruning，并为 devshard 状态增加了 Postgres 支持。

部署方式：

sudo rm -rf decentralized-api.zip .dapi/cosmovisor/upgrades/v0.2.12-api-post2/ .dapi/data/upgrade-info.json
sudo mkdir -p  .dapi/cosmovisor/upgrades/v0.2.12-api-post2/bin/
wget -q -O  decentralized-api.zip 'https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.12-api-post2/decentralized-api-amd64.zip' && \
echo "7bef88106fc3464d0141a2d14245cc06c341be186250f5d096e27e901deb185e  decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j  decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.12-api-post2/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.12-api-post2/bin/decentralized-api && \
echo "API Installed and Verified"

docker stop api && \
sudo rm -rf .dapi/cosmovisor/current && \
sudo ln -sf upgrades/v0.2.12-api-post2 .dapi/cosmovisor/current && \
echo "9882b36ac6e5546fc18e3dd34da293cd5255f311f19e14ace74d3b9190c8ca1d .dapi/cosmovisor/current/bin/decentralized-api" && \
docker start api

此外，如果你有托管 Kimi-K2.6 的 MLNode，请在部署参数中添加部署参数 “--enable-auto-tool-choice”。为此，你可以重复执行命令（B200 示例）：

curl -X POST http://localhost:9200/admin/v1/nodes \
     -H "Content-Type: application/json" \
     -d '{
       "id": "<NODE_ID>",
       "host": "<NODE_IP>",
       "inference_port": 5050,
       "poc_port": 8080,
       "max_concurrent": 500,
       "models": {
         "moonshotai/Kimi-K2.6": {
           "args": [
             "--enable-auto-tool-choice",  #  new parameter
             "--tensor-parallel-size", "4",
             "--enable-expert-parallel",
             "--trust-remote-code",
             "--mm-encoder-tp-mode", "data",
             "--tool-call-parser", "kimi_k2",
             "--reasoning-parser", "kimi_k2",
             "--attention-backend", "FLASHINFER_MLA",
             "--disable-custom-all-reduce",
             "--gpu-memory-utilization", "0.95",
             "--max-num-seqs", "128",
             "--max-model-len", "240000"
           ]
         }
       }
     }'

然后使用 docker restart join-mlnode-308-1 重启 MLNode 容器。

当 PoC / Confirmation PoC 未通过时，应执行上述操作。

2026年5月5日

主机在 Kimi-K2.6 bootstrap 过程中观察到，30% 的最低直接参与门槛在实际中较难达到。为了避免 Kimi-K2.6 在未来某个 epoch 中变为不合格，并进一步简化后续模型的接入，提议将该门槛降低至 10%。

安全模型保持不变：PoC 验证本身没有变化，仍然需要验证算力的超级多数通过才能接受结果。

该提案已加速推进，以便在下一次 PoC 之前生效。投票将持续 12 小时。

投票 (yes, no, abstain, no_with_veto):

export NODE_URL=https://node3.gonka.ai/
./inferenced tx gov vote 48 yes \
  --from <cold_key_name> \
  --keyring-backend file \
  --unordered \
  --timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
  --node $NODE_URL/chain-rpc/ \
  --chain-id gonka-mainnet \
  --yes

查看投票状态：

export NODE_URL=https://node3.gonka.ai/
./inferenced query gov votes 48 -o json --node $NODE_URL/chain-rpc/

投票结束时间: 2026-05-05 19:00:54 UTC

2026年5月4日

Kimi K2.6 已在 Gonka 网络上线

moonshotai/Kimi-K2.6 已完成 bootstrap，并已加入 Gonka 网络的 PoC 参与。

该过程由全网主机协同完成：基础设施已准备就绪、intent 已提交、委托与拒绝已设置，并完成了部署测试。

对于多模型 PoC，这意味着 Kimi 现在作为一个活跃的模型组，拥有独立的参与和奖励跟踪。

运行 Kimi 的主机应继续按常规方式监控其 MLNodes 和 PoC 参与情况。

2026年5月4日

针对已提交 PoCIntent 的主机：需要执行操作：部署 Kimi K2.6

今日已通过 moonshotai/Kimi-K2.6 的预评估检查。

已提交 PoCIntent 的主机，应在 PoC 于区块 3874496 开始前，将至少一个 MLNode 从 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 切换至 moonshotai/Kimi-K2.6 。

在预评估与 PoC 启动之间存在一个 500 区块的窗口期。在此期间不会有 CPoC 任务，因此已声明 intent 的主机可以安全地将其模型节点切换为 Kimi K2.6。

请按照指南完成所需部署步骤： https://gonka.ai/docs/host/kimi-bootstrap/

2026年5月4日

传输代理 node1, node2, 和 node3 已被禁用。所有主网推理现已通过 node4 路由，该节点采用基于 devshard 的新计费方式运行。

这标志着网络的一个里程碑： devshard 已上线并达到生产就绪状态。 node4 是未来推荐使用的公共网关。

需要执行的操作： 将你的 endpoint 更新为 node4。

2026年5月2日

今日预资格验证未通过，对于 PoCIntent 低于 30% 的主机，其权重最低。请继续保持你的 MLNodes 运行 Qwen235B，并在明天为下一轮 epoch 提交 intent。

2026年4月30日

升级已执行：v0.2.12 已在主网上线

关于升级提案 v0.2.12 的链上治理投票已结束。该提案已获得通过，并已成功在主网上执行升级。

当前已生效的关键变更

多模型 PoC（最大变更） (#1039)。将 Proof of Compute 从单一固定模型转变为按模型划分的 PoC 组。每个经治理批准的模型都会生成其自身的本地 PoC 权重，并通过模型特定系数汇总为总共识权重。每个主机必须参与每个模型组（可通过直接参与或委托 PoC 投票权重的方式）。
引入moonshotai/Kimi-K2.6 作为第二个模型： 该模型组将在升级后两个 epoch 启用。该模型的系数为 Qwen235B 的 3.51 倍，该系数基于在相同硬件（8xH200，8xB200）上的模型计算复杂度。
Devshard 独立运行时 (#1045)。将 devshard 发布与 DAPI / 主网发布周期解耦。
Certik 审计修复 (#1020, #1021, #1022, #987, #949, #988, #825, #1011, #1029, #789)。已修复审计中发现的问题。
协议强化。 保留节点 (POC_SLOT=true ）将在单个 PoC / CPoC 时间内随机抽样。其他更新包括：将 mlnode 版本传播到链上的 HardwareNode，修复 DKG dealer 共识，对齐旧版验证者惩罚机制与所需抵押语义，确保 devshard 托管资金的原子性，以及为 inference_finished 事件解析增加零时间戳容错。

主机操作指引

部署、委托或明确拒绝新的经治理批准的模型（该模型将在升级后 2 个 epoch 启用）。参考指南
请主机更新 dashboard/explorer。请在 gonka/deploy/join 目录下运行以下命令：

docker compose -f docker-compose.mlnode.yml -f docker-compose.yml pull explorer
docker compose -f docker-compose.mlnode.yml -f docker-compose.yml up -d explorer

二进制版本：通过链上升级流程进行更新。

-迁移：测试与迁移细节已记录在 v0.2.12 文档中。

有关这些变更的更多详细信息，请参阅治理相关资料： https://github.com/gonka-ai/gonka/tree/upgrade-v0.2.12/proposals/

2026年4月29日

升级 v0.2.12：预下载二进制文件

v0.2.12 升级提案的链上治理流程即将接近结束。

投票结束时间：2026年4月30日 00:12（UTC）
升级高度：3834200
预计升级时间：2026年4月30日上午6:00（UTC）

建议各 Host 在 GitHub 上查看该提案并参与投票。

提前预下载二进制文件，有助于在升级窗口期间避免依赖 GitHub 的可用性。

# 1. 创建目录
sudo mkdir -p .dapi/cosmovisor/upgrades/v0.2.12/bin \
              .inference/cosmovisor/upgrades/v0.2.12/bin && \

# 2. DAPI: 下载 -> 校验 -> 直接解压到 bin -> 添加执行权限
wget -q -O decentralized-api.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.12/decentralized-api-amd64.zip" && \
echo "d0143a95e12e1ada06cfea5e4d3deab13534c3523c967e9a6b87ac9f9bf3247d decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.12/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.12/bin/decentralized-api && \
echo "DAPI 已安装并校验完成" && \

# 3. Inference: 下载 -> 校验 -> 直接解压到 bin -> 添加执行权限
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.12/bin/ && \
wget -q -O inferenced.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.12/inferenced-amd64.zip" && \
echo "df7656503d39f6703767d32d5578d1291e32cb114844d8c1cd0f134d1bf4babd inferenced.zip" | sha256sum --check && \
sudo unzip -o -j inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.12/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.12/bin/inferenced && \
echo "Inference 已安装并校验完成" && \

# 4. 清理及最终检查
rm decentralized-api.zip inferenced.zip && \
echo "--- 最终校验 ---" && \
sudo ls -l .dapi/cosmovisor/upgrades/v0.2.12/bin/decentralized-api && \
sudo ls -l .inference/cosmovisor/upgrades/v0.2.12/bin/inferenced && \
echo "94ce943338d12844028e84fe770106c9d28d866cf0af99f27da30f56d69efa34 .dapi/cosmovisor/upgrades/v0.2.12/bin/decentralized-api" | sudo sha256sum --check && \
echo "642eb9858cd77d182f3e1c4d44553f5379d615983430e1fd8e85f09632af4271 .inference/cosmovisor/upgrades/v0.2.12/bin/inferenced" | sudo sha256sum --check

2026年4月28日

v0.2.12 升级：升级前模型清理

v0.2.12 升级提案目前已进入链上投票周期的一半阶段。

投票结束时间：2026年4月30日 00:12 UTC
升级高度：3834200
预计升级时间：2026年4月30日 06:00 UTC

建议各主机在 GitHub 上查看该提案并进行投票。

升级前所需操作

随着网络逐步接近升级窗口，主机应提前准备其节点，以防该提案通过。

此清理过程 必须在升级发生之前完成。如果在升级时，你的节点配置中包含不受支持的模型， 节点将被拒绝并下线。

版本 0.2.12 会移除所有不在升级后批准列表中的治理模型。在主网上，仅会保留此前已强制执行的模型以及 Kimi。每个 DAPI 会在本地持久化其 MLNode 配置。在启动时，它会根据链上治理列表验证每一个已配置的模型。如果配置中包含至少一个不受支持的模型，则整个节点会被拒绝，主机将下线

版本 0.2.11 通过将运行时视图裁剪为仅保留强制模型来掩盖了这个问题，因此即使持久化配置中仍包含额外模型， /admin/v1/nodes 看起来也依然是干净的。版本 0.2.12 取消了这种裁剪，这意味着持久化配置将被直接加载。

为了解决这个问题，下面的脚本会在 /admin/v1/config 中查找每个包含额外模型的节点，并向 /admin/v1/nodes/<id> 发送带有清理后配置的 PUT 请求。这些更改将在 60 秒内持久化。剩余模型的参数、硬件和端口将被完全保留。未列出强制模型的节点将被跳过，并需要手动修复。

将以下脚本粘贴到主机的 shell 中。默认情况下，它会应用更改。如果仅想预览更改而不执行，请设置 APPLY=dry（或任何不等于 --apply的值）。

仓库中的脚本：

Bash
Python.

ADMIN=${ADMIN:-http://127.0.0.1:9200}
KEEP=${KEEP:-Qwen/Qwen3-235B-A22B-Instruct-2507-FP8}
APPLY=${APPLY:-"--apply"}

curl -sS "$ADMIN/admin/v1/config" | jq -r --arg k "$KEEP" '
  .nodes[] | "\(.id): " + (
    if (.models | has($k) | not) then "skip (\(.models | keys))"
    elif (.models | length) == 1 then "ok"
    else "\(.models | keys) -> [\($k)]" end)'

if [[ "$APPLY" == "--apply" ]]; then
  curl -sS "$ADMIN/admin/v1/config" \
    | jq -c --arg k "$KEEP" \
        '.nodes[] | select((.models | has($k)) and (.models | length > 1)) | .models = {($k): .models[$k]}' \
    | while IFS= read -r p; do
        id=$(jq -r .id <<<"$p")
        curl -sS -f -X PUT -H 'Content-Type: application/json' -d "$p" \
          "$ADMIN/admin/v1/nodes/$id" >/dev/null && echo "$id: updated"
      done
  echo "done; persisted within 60s"
else
  echo "preview only; rerun without APPLY=dry to commit"
fi

在运行脚本后等待 60 秒，以确保更改已被持久化，然后再触发升级。之后，验证配置：

curl -sS http://127.0.0.1:9200/admin/v1/config \
  | jq '.nodes[] | {id, models: (.models | keys)}'

预期输出：

{
  "id": "<nodeId>",
  "models": [
    "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8"
  ]
}

（其他节点将遵循相同格式）

April 27, 2026

v0.2.12 升级提案进入治理阶段

用于下一版本链上软件 v0.2.12 的升级提案现已发布到链上并开放投票。

主要变更

多模型 PoC（最大变更） (#1039). 将计算证明（Proof of Compute）从单一固定模型转变为按模型分组的 PoC 机制。每个经治理批准的模型都会生成其本地 PoC 权重，并通过特定模型系数聚合为总共识权重。每个主机必须参与每个模型组（可直接参与或委托 PoC 投票权重）。
引入**moonshotai/Kimi-K2.6 作为第二个模型：该模型组将在升级后的两个 epoch 后激活。基于相同硬件（8xH200、8xB200）上的计算复杂度，该模型的系数为 Qwen235B 的 3.51 倍。
Devshard 独立运行时 (#1045). 将 devshard 发布与 DAPI / 主网发布周期解耦。
Certik 审计修复 (#1020, #1021, #1022, #987, #949, #988, #825, #1011, #1029, #789). 已修复审计发现的问题。
协议加固 保留节点 (POC_SLOT=true 会被随机抽样用于单次 PoC / CPoC 时间。其他更新包括：将 mlnode 版本同步到链上 HardwareNode，修复 DKG dealer 共识，对齐旧版验证者惩罚机制与所需抵押语义，确保 devshard 托管资金的原子性，以及在 inference_finished 事件解析中加入零时间戳容忍机制。

升级计划

二进制版本将通过链上升级提案进行更新。有关升级流程的更多信息，请参阅 /docs/upgrades.md.

所需操作

升级前

从docker-compose.yml部署 versiond 和 proxy 服务的最新版本（使用 release/v0.2.12 标签的仓库）：

git checkout release/v0.2.12

部署（务必使用 --no-deps）：

source config.env && \
docker compose -f docker-compose.yml up versiond proxy -d --no-deps

这将使 devshard 从 api 服务中独立运行。

升级后

部署、委托或明确拒绝新的经治理批准的模型（该模型将在升级后 2 个 epoch 激活）。参考指南.

升级前或升级后

请更新 dashboard/explorer。请在 gonka/deploy/join 目录中运行以下命令：

docker compose -f docker-compose.mlnode.yml -f docker-compose.yml pull explorer
docker compose -f docker-compose.mlnode.yml -f docker-compose.yml up -d explorer

如何投票

如果您没有直接访问持有投票权的密钥，或希望由其他密钥代为投票，请参考指南，将治理投票权限从冷钱包授权给热钱包。

提案详情及投票可通过 inferenced访问。任何活跃节点均可使用，可用节点包括：

投票 ( yes, no , abstain , no_with_veto ):

export NODE_URL=https://node3.gonka.ai/
./inferenced tx gov vote 44 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

查询投票状态：

export NODE_URL=https://node3.gonka.ai/
./inferenced query gov votes 44 -o json --node $NODE_URL/chain-rpc/

截止时间

投票结束时间： 2026年4月30日 00:12 UTC 升级高度： 3834200 预计升级时间： 2026年4月30日 06:00 UTC

注意事项

请在升级窗口期间保持在线，以便及时执行后续步骤或应对措施。
在升级过程中，Cosmovisor 会在 .inference/data 目录中创建完整的状态备份；请确保有足够的磁盘空间。关于如何安全删除 .inference 目录中的旧备份，可参考文档
如果 application.db 占用了大量磁盘空间，可以采用 cosmovisor 备份指南中描述的清理方法。
升级后，Postgres 可作为本地 payload 存储的一个选项。

2025年4月15日

升级 v0.2.12 的 PR 审查

用于下一次链上软件升级（v0.2.12）的 The pull request 已开放审查：

请直接审阅 PR 代码，并针对您发现的问题、疑问、改进建议、边界情况或潜在漏洞提出评论。

有价值的审查贡献（包括重要评论、漏洞发现及安全问题）在下一个升级周期中可能有资格获得社区赏金。

本次仅为 Pull Request 的审查征集，并不启动正式投票流程。治理投票将在审查期结束后开始。

主要变更

多模型 PoC (最大变更) (#1039)。将计算证明（PoC）从单一固定模型转变为按模型划分的 PoC 组。每个经治理批准的模型将生成其本地 PoC 权重，并通过模型特定系数聚合为总共识权重。
共识层交易费用与自动迁移 (#937, #981)。引入由治理控制的 gas 价格。协议职责类消息（PoC、验证、推理、BLS DKG）通过 NetworkDutyFeeBypassDecorator免除费用。 MsgPoCV2StoreCommit 采用双组件费用结构（基础验证 + 按数量线性增长），作为主要的 Sybil 防护机制。详情参见 docs/host_onboarding.md 。
Devshard 独立运行时 (#1045). 将 devshard 的发布与 DAPI / 主网发布周期解耦。
Certik 审计修复 (#1020, #1021, #1022, #987, #949, #988, #825, #1011, #1029, #789). 所有已知审计问题均已修复。
协议强化 实现更强的 PoC v2 随机数生成器（完整 256 位熵，对比此前 32 位），该功能将通过单独的治理投票激活。其他更新包括：将 mlnode 版本同步至链上 HardwareNode, 修复 DKG dealer 共识，对齐旧版验证者惩罚与抵押要求语义，确保 devshard 托管资金的原子性，以及为 inference_finished 事件解析增加零时间戳容错。

升级计划

二进制版本将通过链上升级提案进行更新。有关升级流程的更多信息，请参阅： /docs/upgrades.md.

升级后需要执行的操作

现有 Hosts：

确保冷账户持有足够余额（例如 100 GNK），以覆盖自动授予的费用额度上限
针对每个经治理批准的新模型，执行部署、委托或明确拒绝（模型将在升级后第 3 个 epoch 激活）
从 docker-compose.yml部署versiond 服务（使用主分支的最新提交）
使用新版本与参数重新创建 proxy 容器（具体命令将由文档提供）

2026年4月1日

ML Node 3.0.12-post6 已发布

新版本 mlnode 已可用： ghcr.io/gonka-ai/mlnode:3.0.12-post6

docker pull ghcr.io/gonka-ai/mlnode:3.0.12-post6
docker pull ghcr.io/gonka-ai/mlnode:3.0.12-post6-blackwell
docker pull ghcr.io/gonka-ai/mlnode:3.0.12-post6-blackwell-sm120

该版本现已设为主分支默认版本： https://github.com/gonka-ai/gonka/commit/ec8f45573149ce5686e8e5fc29f1a8f49a295689

变更内容

该版本已在近期若干 epoch 中被部分矿工使用。初步观察表明，对于接近 PoC 启动时间运行的节点，其稳定性有所提升。

本次更新修复了一个 PoC 启动附近的边界问题，该问题在特定情况下可能导致性能下降。

vLLM 的完整变更： https://github.com/gonka-ai/vllm/compare/release/v0.9.1-pocv2-post5...release/v0.9.1-pocv2-post6

使用建议e

建议升级至该版本
该版本与之前版本完全兼容

2026年3月20日

升级已执行：v0.2.11 现已在主网上线

升级提案 v0.2.11 的链上治理投票已结束。该提案已获得通过，升级已在主网上成功执行。

当前已生效的关键变更

初始扩展架构：基于子网的推理会话

本次升级引入了基于子网的推理会话的初始版本，旨在提升推理的可扩展性。

StartInference 和 FinishInference 性能优化

这些性能优化使每个区块能够承载最多约 100 倍的推理请求，具体取决于工作负载和网络条件。这些以及其他变更的更多细节可查看： https://github.com/gonka-ai/gonka/pull/813

对主机（Hosts）的指引

**二进制版本：已通过链上升级流程完成更新。
迁移： 测试与迁移相关的详细说明已记录在 v0.2.11 文档.

这些变更的更多详细信息可在治理相关资料中查看： https://github.com/gonka-ai/gonka/tree/upgrade-v0.2.11/proposals/

2026年3月19日

升级 v0.2.11：预下载二进制文件

v0.2.11 升级提案的链上治理流程即将结束。

投票结束时间：2026年3月20日 05:59:52（UTC）
升级区块高度：3186100
预计升级时间：2026年3月20日 14:30（UTC）

建议各主机（Hosts）在 GitHub 上查看该提案并参与投票。提前预下载二进制文件有助于在升级窗口期间避免依赖 GitHub 的可用性。

# 1. 创建目录
sudo mkdir -p .dapi/cosmovisor/upgrades/v0.2.11/bin \
              .inference/cosmovisor/upgrades/v0.2.11/bin && \

# 2. DAPI：下载 -> 校验 -> 直接解压到 bin 目录 -> 赋予执行权限
wget -q -O decentralized-api.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.11/decentralized-api-amd64.zip" && \
echo "e574c3d86189daf325cc7008603ee8e952efb028afda5bcd4a154dcd334192d4 decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.11/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.11/bin/decentralized-api && \
echo "DAPI Installed and Verified" && \

# 3. Inference：下载 -> 校验 -> 直接解压到 bin 目录 -> 赋予执行权限
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.11/bin/ && \
wget -q -O inferenced.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.11/inferenced-amd64.zip" && \
echo "c77528bd2e31e86355a6eefddb50e0db7f9600ebf2940ca440a61ea36e7ef7ca inferenced.zip" | sha256sum --check && \
sudo unzip -o -j inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.11/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.11/bin/inferenced && \
echo "Inference Installed and Verified" && \

# 4. 清理并最终检查
rm decentralized-api.zip inferenced.zip && \
echo "--- Final Verification ---" && \
sudo ls -l .dapi/cosmovisor/upgrades/v0.2.11/bin/decentralized-api && \
sudo ls -l .inference/cosmovisor/upgrades/v0.2.11/bin/inferenced && \
echo "8b99e550ddd117a0cb4293b4ae74e0e5dff961a1986f23b58ec7ae6c3f0478f1 .dapi/cosmovisor/upgrades/v0.2.11/bin/decentralized-api" | sudo sha256sum --check && \
echo "6cf186a75782da07156d4d03b4266cefcb36656de89e4a378ae96d8df89ad003 .inference/cosmovisor/upgrades/v0.2.11/bin/inferenced" | sudo sha256sum --check

2026年3月18日

v0.2.11 升级提案进入治理流程

下一版本链上软件 v0.2.11 的升级提案现已在链上发布并开放投票。如果提案获得通过，将引入基于子网的推理会话的初始版本，以提升推理的可扩展性，并对Start/FinishInference 进行显著的性能优化。

关键变更

初始扩展架构：基于子网的推理会话

本次升级引入了基于子网的推理会话的初始版本，旨在提升推理的可扩展性。

当前，通过每次推理都在链上进行交易处理的方式会限制吞吐量。该设计将推理执行和验证移至指定的链下子组中，而链上仅负责会话创建和最终结算。

这是一个有意为之的早期且受限版本设计。之所以提交到主网进行评审和有限生产测试，并不是因为该设计已经完善，而是因为这类系统需要尽早暴露在真实网络环境中。一些问题类型很难仅通过本地测试暴露出来。当前实现已被设计为避免对矿工收益产生负面影响。

StartInference 和 FinishInference 性能优化

减少 MsgStartInference and MsgFinishInference 的不必要状态写入和查询开销。
简化统计处理，并减少推理生命周期中的工作量，从而提高区块执行的稳定性。

在类似主网的条件下，这也使得每个区块最多可容纳约 100 倍的推理请求，具体取决于工作负载和网络条件。这些以及其他变更的更多细节可查看： https://github.com/gonka-ai/gonka/pull/813

升级前建议操作

application.db 清理

强烈建议各主机在升级前按照提供的说明对 application.db 进行清理。

提前执行此操作非常重要。如果大量节点将清理延后到升级之后，可能会在网络中同时触发清理操作，从而造成可避免的运行压力。清理说明见： https://gonka.ai/FAQ/#__tabbed_7_4

浏览器（Explorer）更新

要求各主机更新 dashboard/explorer。请在 gonka/deploy/join 目录下运行以下命令：

docker compose -f docker-compose.mlnode.yml -f docker-compose.yml pull explorer
docker compose -f docker-compose.mlnode.yml -f docker-compose.yml up -d explorer

如何投票

如果你无法直接访问拥有投票权的密钥，或希望使用其他密钥代为投票，请参考以下指南。

P该指南介绍了如何将治理投票权限从冷密钥授予热密钥。提案详情和投票可通过 inferenced 进行。任何活跃节点都可以使用，可用节点包括：

执行投票 ( yes, no , abstain , no_with_veto ):

export NODE_URL=https://node3.gonka.ai/
./inferenced tx gov vote 31 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

查询投票状态：

export NODE_URL=https://node3.gonka.ai/
./inferenced query gov votes 31 -o json --node $NODE_URL/chain-rpc/

时间节点

投票结束时间：2026年3月20日 05:59:52（UTC）
升级区块高度：3186100
预计升级时间：2026年3月20日 14:30（UTC）

注意事项

请在升级窗口期间保持在线，以便能够及时执行后续步骤或应对措施。
在升级过程中，Cosmovisor 会在 .inference/data 目录中创建完整的状态备份，请确保有足够的磁盘空间。关于如何安全删除 .inference 目录中的旧备份，请参考文档。
如果 application.db 占用了大量磁盘空间，可以参考此处的清理方法。
升级后，Postgres 可作为本地 payload 存储的选项。

2026 年 3 月 17 日

升级 v0.2.11 的 PR 审查

下一次链上软件升级 v0.2.11 的 The Pull Request 已开放供审查。欢迎提供反馈和改进建议。

对于在本次 PR 审查中做出有意义贡献的参与者，相关奖励（bounties）可能会在下一次升级中提出。

本次为仅针对 Pull Request 的审查通知，并不代表正式投票的开始。治理投票流程将在审查期结束后启动。

关键变更

初始扩展架构：基于子网的推理会话

本次升级引入了基于子网的推理会话的初始版本，旨在提升推理的可扩展性。

目前，通过逐次推理在链上发起交易的方式会限制吞吐量。该设计将推理的执行与验证转移至指定的链下子组中，而链上仅负责会话创建与最终结算。

这是一个有意设计为早期且受限的版本。之所以将其提交至主网进行审查和有限的生产测试，并不是因为其已经完善，而是因为这类系统需要尽早在真实网络环境中进行验证。有些问题类型很难仅通过本地测试暴露出来。当前实现已被设计为避免对矿工收益产生负面影响。

StartInference 和 FinishInference 性能优化

减少了 MsgStartInference 和 MsgFinishInference 的不必要状态写入与查询开销。
简化了统计处理，并减少推理生命周期中的工作量，从而提升区块执行的稳定性。

在接近主网的运行条件下，这也使得每个区块可容纳的推理数量最高提升至约 100 倍（具体取决于负载与网络条件）。

升级前建议操作

application.db清理（pruning）

强烈建议 Hosts 在升级前对 application.db 进行 pruning，并按照提供的说明执行。提前执行这一操作非常重要。如果大量节点在升级后才开始 pruning，可能会导致全网在同一时间集中进行清理操作，从而带来可避免的运行压力。 pruning 操作说明见这里。

浏览器（Explorer）更新

请 Hosts 更新 dashboard / explorer。请在 gonka/deploy/join 目录下运行以下命令：

docker compose -f docker-compose.mlnode.yml -f docker-compose.yml pull explorer
docker compose -f docker-compose.mlnode.yml -f docker-compose.yml up -d explorer

审查人员可以在这里查看完整的升级提案、迁移细节、测试总结以及建议流程。

2026 年 3 月 16 日

API 二进制版本 v0.2.10-post7 已发布

在 v0.2.10中已发现一个潜在漏洞。为在当前升级前阶段降低风险，建议在下一次 PoC 开始之前，将 API 二进制升级至 v0.2.10-post7 。

完整变更： https://github.com/gonka-ai/gonka/compare/main…release/v0.2.10-post7

应用更新：

# 预检查：确保没有 confirmation PoC 正在运行（如果不为 false，整个脚本将失败）
echo "--- 预检查：Confirmation PoC 状态 ---" && \
CONFIRMATION_POC_ACTIVE=$(curl -sf "https://node3.gonka.ai/v1/epochs/latest" | jq -r '.is_confirmation_poc_active') && \
[ "$CONFIRMATION_POC_ACTIVE" = "false" ] && \
echo "当前没有 confirmation PoC 正在运行" && \

# 下载二进制文件
sudo rm -rf decentralized-api.zip .dapi/cosmovisor/upgrades/v0.2.10-post7/ .dapi/data/upgrade-info.json && \
sudo mkdir -p .dapi/cosmovisor/upgrades/v0.2.10-post7/bin/ && \
wget -q -O decentralized-api.zip 'https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.10-post7/decentralized-api-amd64.zip' && \
echo "71481e6f2c5f9a355ed283a0896833bcc8397e8bcda134a796a46467bd2ff3b0  decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.10-post7/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.10-post7/bin/decentralized-api && \
echo "API Installed and Verified" && \

# 链接二进制文件
echo "--- 最终验证 ---" && \
sudo rm -rf .dapi/cosmovisor/current && \
sudo ln -sf upgrades/v0.2.10-post7 .dapi/cosmovisor/current && \
echo "313df0747e090518ac052918ad23f9d6e70bb60dede2013375e322c23605f3e0  .dapi/cosmovisor/current/bin/decentralized-api" | sudo sha256sum --check && \
# 重启 
source config.env && docker compose up api --no-deps --force-recreate -d

2026 年 3 月 11 日

工具调用

Tool calling 已通过标准的函数调用模式（type: "function"）提供支持

集成流程很简单：

函数由开发者定义
当请求匹配时，模型会返回结构化的调用参数
执行由应用侧负责处理

对于已经在使用代理层的团队来说，这可能是一个简化技术栈、转而依赖原生能力的好机会。在实际应用中，这应当能够带来更清晰的集成模式以及更容易的维护。

2026 年 3 月 6 日

提醒：v0.2.11 升级预计将在下周初进入审核和治理投票阶段。

请留意相关进展并提前做好参与准备。参与投票是支持网络发展、确保升级方向符合网络参与者实际需求的最简单方式之一。如果你没有持有投票权的冷钱包（cold key）的访问权限，建议提前安排投票授权（vote delegation）。请联系该密钥的持有人，请他们授权你代表其进行投票。没有该授权，其他账户无法提交投票。

在该机制中：

Granter = 拥有投票权的账户（冷钱包）
Grantee = 被授权代表 Granter 提交投票的账户（热钱包）

Grantee 仍然可以为自己的账户进行投票。同时，Granter 可以随时撤销该授权。

下面提供用于授权、查询、投票以及撤销授权的命令示例。

1) 授权投票权限（由 Granter 账户执行）

CommandExample response

./inferenced tx authz grant <GRANTEE_GONKA_ADDRESS> generic \
  --msg-type=/cosmos.gov.v1beta1.MsgVote \
  --from=<GRANTER_KEY_NAME> \
  --chain-id=gonka-mainnet \
  --expiration=<UNIX_TIMESTAMP> \
  --home .inference \
  --keyring-backend file

{
    "height": "0",
    "txhash": "8D96FB6FC06FFB928FBC89FE950689CD040C7F338C197BA856175EC7462A3FFA",
    "codespace": "",
    "code": 0,
    "data": "",
    "raw_log": "",
    "logs": [],
    "info": "",
    "gas_wanted": "0",
    "gas_used": "0",
    "tx": null,
    "timestamp": "",
    "events": []
}

2) 确认授权是否成功（任意节点可执行）

CommandExample response

./inferenced query authz grants <GRANTER_GONKA_ADDRESS> <GRANTEE_GONKA_ADDRESS> \
  --node="http://<MAINNET_NODE_URL>:26657" \
  --output=json | jq .

{
    "grants": [
        {
            "authorization": {
                "type": "cosmos-sdk/GenericAuthorization",
                "value": {
                    "msg": "/cosmos.gov.v1beta1.MsgVote"
                }
            },
            "expiration": "2026-12-03T18:38:18Z"
        }
    ],
    "pagination": {
        "total": "1"
    }
}

3) 使用 Grantee 账户进行投票

CommandExample response

# 查询要投票的 proposal ID，在投票内容中使用 <VOTE_PROPOSAL_ID> 
./inferenced query gov proposals --output json

# 创建投票文件
cat > /tmp/authz-vote.json << 'EOF'
{
  "body": {
    "messages": [
      {
        "@type": "/cosmos.authz.v1beta1.MsgExec",
        "grantee": "<GRANTEE_GONKA_ADDRESS>",
        "msgs": [
          {
            "@type": "/cosmos.gov.v1beta1.MsgVote",
            "proposal_id": "<VOTE_PROPOSAL_ID>",
            "voter": "<GRANTER_GONKA_ADDRESS>",
            "option": "VOTE_OPTION_YES"
          }
        ]
      }
    ]
  }
}
EOF


# 使用该文件提交投票 
./inferenced tx authz exec /tmp/authz-vote.json \  --from=<GRANTEE_KEY_NAME> \ 
--chain-id=gonka-mainnet \
--home .inference \
--keyring-backend file \
--node="http://<MAINNET_NODE_URL>:26657" -y

{
    "pagination": {
        "total": "1"
    },
    "proposals": [
        {
            "deposit_end_time": "2026-03-06T10:40:07.016920026Z",
            "final_tally_result": {
                "abstain_count": "0",
                "no_count": "0",
                "no_with_veto_count": "0",
                "yes_count": "0"
            },
            "id": "1",
            "messages": [
                {
                    "type": "cosmos-sdk/MsgSoftwareUpgrade",
                    "value": {
                        "authority": "gonka10d07y265gmmuvt4z0w9aw880jnsr700j2h5m33",
                        "plan": {
                            "height": "406062",
                            "info": "{\n \"binaries\":{\n \"linux/amd64\":\"https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.10-testnet1/inferenced-amd64.zip?checksum=sha256:fb71310427436aebac32813735231882fca420cf0d94b036f8cacd055d0e1c78\"\n },\n \"api_binaries\":{\n \"linux/amd64\":\"https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.10-testnet1/decentralized-api-amd64.zip?checksum=sha256:6fe214f4bb2d831c02ce407682820d95d01e6ae94a33fe9c4617b80e0ca716ce\"\n }\n }",
                            "name": "v0.2.10",
                            "time": "0001-01-01T00:00:00Z"
                        }
                    }
                }
            ],
            "proposer": "gonka1xfvr8mywcrxrcrryvj8c5d2grvyjdj5c90fd88",
            "status": 2,
            "submit_time": "2026-03-04T10:40:07.016920026Z",
            "summary": "Upgrade Proposal v0.2.10",
            "title": "Upgrade Proposal v0.2.10",
            "total_deposit": [
                {
                    "amount": "50000000",
                    "denom": "ngonka"
                }
            ],
            "voting_end_time": "2026-03-04T10:50:07.016920026Z",
            "voting_start_time": "2026-03-04T10:40:07.016920026Z"
        }
    ]
}

投票选项:

VOTE_OPTION_YES（同意）
VOTE_OPTION_ABSTAIN（弃权）
VOTE_OPTION_NO（反对）
VOTE_OPTION_NO_WITH_VETO（否决）

4) 撤销投票授权（由 Granter 执行）

CommandExample response

./inferenced tx authz revoke <GRANTEE_GONKA_ADDRESS> /cosmos.gov.v1beta1.MsgVote \
  --from=<GRANTER_KEY_NAME> \
  --chain-id=gonka-mainnet \
  --home .inference \
  --keyring-backend file

{
    code: 0
    codespace: ""
    data: ""
    events: []
    gas_used: "0"
    gas_wanted: "0"
    height: "0"
    info: ""
    logs: []
    raw_log: ""
    timestamp: ""
    tx: null
    txhash: A2C3CDA9E95DCF143C0D8981A4F573F1E68879ECF4903B25BA97383C3F2FDFBA
}

2026年2月21日

API 二进制版本 v0.2.10-post3 已发布

新版 API 二进制程序已发布。本次更新改进了连接超时处理逻辑，并在 PoC 验证流程中引入了额外的校验机制。

在 v0.2.10 升级中，引入了 Executor → MLNode 连接的严格 5 分钟超时限制，而部分请求的实际执行时间可能明显更长。新的 API 版本不再强制执行该严格限制，而是将超时控制权交还给上层。
之前的请求重试机制在推理因处理超时（而非 TLS 超时）失败时，仍会重新发起推理请求。对于执行时间较长的请求，服务端重试通常是无效的，因为很可能再次触发同样的超时问题，同时还可能导致客户端收到不一致的输出结果。新版 API 在此类情况下将不再重试推理请求。
之前，处于“保留（preserved）”状态、且未参与 PoC 生成的 MLNode，仍可能被用于 PoC 验证，这可能导致推理缺失。新版已将这类节点排除在 PoC 验证流程之外。
PoC 验证流程中新增了多项额外的安全防护措施。

PR: https://github.com/gonka-ai/gonka/pull/785 Build: https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.10-post3/decentralized-api-amd64.zip

应用更新：

#预检查：确认当前没有进行中的 confirmation PoC (若不为 false，脚本将直接失败)
echo "--- Pre-flight Check: Confirmation PoC Status ---" && \
CONFIRMATION_POC_ACTIVE=$(curl -sf "https://node3.gonka.ai/v1/epochs/latest" | jq -r '.is_confirmation_poc_active') && \
[ "$CONFIRMATION_POC_ACTIVE" = "false" ] && \
echo "OK: No confirmation PoC active" && \

# 下载二进制文件
sudo rm -rf decentralized-api.zip .dapi/cosmovisor/upgrades/v0.2.10-post3/ .dapi/data/upgrade-info.json && \
sudo mkdir -p  .dapi/cosmovisor/upgrades/v0.2.10-post3/bin/ && \
wget -q -O  decentralized-api.zip 'https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.10-post3/decentralized-api-amd64.zip' && \
echo "1b75f2785c7884dc24f3c1e39d5ed10f4afcbe5fc677f5569d90d75c752ec150 decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j  decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.10-post3/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.10-post3/bin/decentralized-api && \
echo "API Installed and Verified"  && \

# 链接二进制文件
echo "--- Final Verification ---" && \
sudo rm -rf .dapi/cosmovisor/current && \
sudo ln -sf upgrades/v0.2.10-post3 .dapi/cosmovisor/current && \
echo "de72c665ff71de904210c5472cebb248d163c1398141868e1a1fe198055b5886 .dapi/cosmovisor/current/bin/decentralized-api" | sudo sha256sum --check && \
# 重启服务
source config.env && docker compose up api --no-deps --force-recreate -d

2026年2月19日

抵押参数更新提案 — 投票结果

抵押参数更新提案已结束投票，但未达到法定投票人数（quorum）。因此，根据当前治理规则，该提案被判定为未通过，相应的更新参数不会生效。

如先前所述，Epoch 180 启用抵押机制与本次投票结果无关。

由于该提案未获通过，Genesis 中定义的抵押参数将在 Epoch 180 自动生效。

参与者应注意并完成以下准备：

查阅 Genesis 中定义的抵押参数；
在 Epoch 180 之前准备并存入所需数量的 GNK；
确保已正确设置抵押，否则自 Epoch 180 起，基于 PoC 产生的奖励将被降低 5 倍。

抵押机制的启用，是协议从宽限期（Grace Period）过渡至完全抵押化 PoC 权重模型的重要组成部分。治理仍然是调整参数的正式途径，但在未通过替代方案的情况下，系统将默认采用 Genesis 规则。

!!!"重要提示：请预留抵押缓冲"

强烈建议参与者**不要只存入最低要求的抵押数量**。由于 PoC 权重在不同 epoch 之间可能因归一化机制及网络层调整而发生波动，权重较小的节点，其相对波动幅度可能更大。为避免在 epoch 切换时出现**短暂抵押不足**的情况，建议在当前抵押规模仍较小的阶段，存入**最高可达最低要求 2 倍**的 GNK 作为抵押。这将显著提升运行安全性，并避免因参数微调而导致的非预期权重下降。**协议不会自动补充抵押（auto top-up）**。

如社区希望再次调整抵押参数，后续仍可提出新的治理提案。

2026年2月20日

建议（可选）：在 PoC 开始时中断进行中的请求的 vLLM / mlnode 构建版本

现已提供一个新的 vLLM / mlnode 构建版本，可在 PoC 启动时中断仍在执行中的推理请求，以降低因 PoC 开始时仍存在未完成请求而导致权重下降的风险。

来源：https://github.com/gonka-ai/vllm/tree/release/v0.9.1-pocv2-post5/vllm

建议尝试的镜像版本：

docker pull ghcr.io/gonka-ai/mlnode:3.0.12-post5
docker pull ghcr.io/gonka-ai/mlnode:3.0.12-post5-blackwell
docker pull ghcr.io/gonka-ai/mlnode:3.0.12-post5-blackwell-sm120

注意事项： - 该构建版本旨在与上一版本保持向后兼容。 - 目前已在少量节点上启用，但在正式部署前，仍建议先审阅相关改动内容。

2026年2月19日

PoC 权重归一化更新说明

在最近一次升级完成后，由于引入了 PoC 执行时长归一化机制，节点权重已发生相应调整。

为使 PoC 权重与实际区块生成时间保持一致，系统基于观测到的区块间隔选择了新的校准参数。在当前实现下，有效的 PoC 参考窗口较此前的名义假设延长了约 5 个区块。

由此带来的直接结果包括：

节点平均权重整体下降（归一化效应）
显示的 H100 等效总算力在数值上相应降低
各类 GPU 之间的相对比例保持不变

原因说明

在此之前，PoC 权重计算基于一个固定的名义 epoch 时长假设。引入实时归一化机制后：

PoC 执行时长与实际区块生产时间对齐
权重结果更加真实地反映实际计算耗时

由于当前有效归一化窗口比原先的名义模型长约 5 个区块，因此每个 epoch 重新计算后的权重值在比例上有所下降。

GPU 权重变化示例（Epoch 175 → 176）

GPU 类型	Epoch 175	Epoch 176	变化幅度
A100-PCIE-40GB	11.8	10.0	-15.4%
A100-SXM4-80GB	132.2	107.8	-18.5%
H100 80GB HBM3	305.1	254.5	-16.6%
H100 PCIe	178.9	155.7	-12.9%
H200	319.6	281.3	-12.0%

对 Tracker / Dashboard 维护者的提示

在 PoC 执行时长归一化生效后，自 Epoch 176 起，PoC 权重已基于新的计算模型，有效参考窗口比此前假设长约 5 个区块。因此，所有基于 PoC 权重推导 H100 等效算力或奖励预期的 Tracker 与 Dashboard，应从 Epoch 176 起重新校验并调整转换系数。若仍沿用归一化前的假设，展示的硬件等效值与奖励预测将被高估。

2026年2月18日

升级已执行：v0.2.10 已正式上线主网

v0.2.10 升级提案的链上治理投票已结束，提案已顺利通过，并成功在主网上完成升级执行。本次升级对 PoC 验证流程进行了重要优化，同时引入实时权重归一化机制，以进一步提升网络运行的公平性与整体可扩展能力。

注意事项

为了触发模型重新部署，升级完成后必须重启 ML Node 容器。请执行以下命令：

docker restart join-mlnode-1

本次升级引入了 3000 个区块的宽限期。请务必在该宽限期内完成向 mlnode:3.0.12-post4-* 版本的迁移。

!!! "兼容性说明" 本次升级包含 IBC 协议栈升级至 v8.7.0。请务必检查所有解析 inferenced CLI 输出的脚本： Enums 以及 int64 / uint64 类型的数值现已统一以字符串形式编码输出。

当前已生效的关键变更

PoC 验证采样优化n

本次升级引入了一种全新的 PoC 验证机制：通过为每位参与者分配一组固定采样的验证者，将验证复杂度从 O(N²) 显著降低至 O(N × N_SLOTS)，有效缓解大规模网络下的验证压力。

基于实时执行时间的 PoC 权重归一化

升级后，PoC 参与者的权重将基于 PoC 实际执行耗时进行归一化处理。该机制可有效降低区块时间漂移带来的影响，使权重结果更加真实地反映实际算力贡献。

为 Qwen235B 启用工具调用能力

本次升级为 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 新增工具调用参数（ --enable-auto-tool-choice , --tool-call-parser hermes ），并将验证阈值设置为 0.958。

如需启用工具调用功能，需重启 MLNode 容器内的 vLLM 服务。

其他协议更新

问题修复：修复 PoC 与 CPoC 交集判断相关的 bug（PR #752）
IBC 升级：IBC 协议栈升级至 v8.7.0
惩罚机制优化：惩罚阈值现由链上数据动态推导（PR #688）
归属机制支持：支持在归属期（vesting）进行中的 streamvesting 转账（PR #641）
MLNode 更新：提供更稳定的 MLNode 容器版本：ghcr.io/product-science/mlnode:3.0.12-post4 / ghcr.io/product-science/mlnode:3.0.12-post4-blackwell.

宽限期说明

本次升级引入以下宽限机制：升级完成后的前 3000 个区块内，不执行 Confirmation PoC。在升级所在的 epoch 内，采用更宽松的 miss rate 与 invalidation rate 阈值。

有关上述变更及更多技术细节，请查阅治理材料：https://github.com/gonka-ai/gonka/blob/upgrade-v0.2.10/proposals/governance-artifacts/update-v0.2.10/README.md

2026年2月18日

抵押参数更新提案已开放投票

新的抵押参数更新提案现已发布，并进入社区投票阶段。

拟议参数如下：

每 1 单位算力需抵押 0.032 GNK（约每张 H100 为 10 GNK）
miss rate 或被 jail：0.01% 惩罚
无效推理（invalid inference）：0.5% 惩罚

这意味着，在单个 epoch 内，即使触发惩罚，矿工最多仅会损失 0.5% 的抵押资产。所需抵押金额约为单日奖励的 24%，整体负担相对可控。

重要提醒

无论投票结果如何，抵押机制都会生效。若该提案未通过，Genesis 中定义的抵押参数将于 Epoch 180 自动启用。若提案通过，则以本提案参数为准。

在投票结束且 Epoch 180 到来之前，所有矿工必须按照以下指南完成抵押资金转入操作。否则，自 Epoch 180 起，其奖励将被降低 5 倍。

查询最新参数差异：

export NODE_URL=https://node3.gonka.ai/
diff -u \
  <(./inferenced query inference params -o json --node $NODE_URL/chain-rpc/ | jq '.params') \
  <(./inferenced query gov proposal 28 -o json --node $NODE_URL/chain-rpc/ | jq '.proposal.messages[] | select(."type"=="inference/x/inference/MsgUpdateParams") | .value.params') \
  || true

提交投票 (yes, no , abstain , no_with_veto):

export NODE_URL=https://node3.gonka.ai/
./inferenced tx gov vote 28 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

查询投票状态：

export NODE_URL=https://node3.gonka.ai/
./inferenced query gov votes 28 -o json --node $NODE_URL/chain-rpc/

投票截止时间

2026 年 2 月 19 日 07:27:06（UTC）

2026年2月17日

v0.2.10 升级提案进入治理阶段

下一版本链上软件 v0.2.10 的升级提案现已在链上发布并开放投票。若提案获批，本次升级将引入一项对 PoC 验证的重要优化（默认不启用），并实现实时权重归一化，以提升网络的公平性与可扩展性。

关键变更

PoC 验证采样优化

本次升级引入了一种新的 PoC 验证机制，通过为每个参与者分配一组固定采样的验证者，将复杂度从 O(N²) 降低至 O(N × N_SLOTS)。

PoC 实时权重归一化

本次升级根据实际 PoC 运行耗时对参与者权重进行归一化，以减少区块时间漂移带来的影响，并确保权重结果与真实执行时长保持一致。

为 Qwen235B 启用工具调用

本次升级为 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 增加了工具调用参数（--enable-auto-tool-choice , --tool-call-parser hermes），并将验证阈值设为 0.958。

如需启用工具功能，必须重启 MLNode 容器中的 vLLM。

升级后将引入一个宽限期：在升级完成后的前 3000 个区块内，不执行 Confirmation PoC，同时在升级所在 epoch 内采用更宽松的 miss rate 与 invalidation rate 阈值。

其他协议更新

修复 PoC 与 CPoC 的交集 bug（PR #752）
IBC 协议栈升级至 v8.7.0
惩罚阈值现由链上数据动态推导（PR #688）
支持在归属期（vesting）进行中的 streamvesting 转账（PR #641）
提供更稳定版本的 MLNode 容器：ghcr.io/product-science/mlnode:3.0.12-post4 / ghcr.io/product-science/mlnode:3.0.12-post4-blackwell.

有关上述及其他变更的更多细节，请参阅治理材料： https://github.com/gonka-ai/gonka/blob/upgrade-v0.2.10/proposals/governance-artifacts/update-v0.2.10/README.md

升级执行后主机需要进行的操作

若提案获批并完成升级，必须重启 ML Node 容器以触发模型重新部署。请执行：

docker restart join-mlnode-1

升级至 mlnode:3.0.12-post4-* 必须在本次升级引入的 3000 区块宽限期内完成。

如何投票

提案详情与投票可通过 inferenced 进行，任何活跃节点均可使用。可用节点包括：

提交投票 (yes, no , abstain , no_with_veto):

export NODE_URL=https://node3.gonka.ai/
./inferenced tx gov vote 27 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

查询投票状态：

export NODE_URL=https://node3.gonka.ai/
./inferenced query gov votes 27 -o json --node $NODE_URL/chain-rpc/

关键时间节点

投票截止时间：2026 年 2 月 18 日 09:26:26（UTC）
升级高度：2712600
预计升级时间：2026 年 2 月 18 日 15:30:00（UTC）

注意事项

请检查所有解析 inferenced 输出的脚本。由于 IBC 协议栈升级至 v8.7.0，Enums 以及 int64 / uint64 类型现已被编码为字符串。
请提前安排在升级窗口期间保持在线，以便及时执行后续操作或缓解措施。
升级过程中，Cosmovisor 会在 .inference/data 目录下创建完整的状态备份，请确保磁盘空间充足。有关安全删除.inference 目录中旧备份的指南可参考以下文档。
若 application.db 占用大量磁盘空间，可采用文档中描述的清理方案。
升级完成后，可选择使用 Postgres 作为本地 payload 存储方案。

2026年2月16日

抵押机制启用及初始参数提案说明

距离 Epoch 180 生效仅剩不到 7 天，相关准备工作需同步推进。

基于 AMA 中的讨论以及社区成员提出的意见，本提案建议以较低的初始抵押要求和最小化惩罚机制启动。

拟提交社区投票的参数如下：

每 1 单位算力需抵押 0.032 GNK（约等于每张 H100 约 10 GNK）
漏报率（miss rate）或进入关押状态（jail）的惩罚：0.01%
无效推理（invalid inference）触发的惩罚（slashing）：0.5%

这意味着，在单个 epoch 内，即使触发惩罚，矿工被扣除的抵押金额也不会超过其总抵押的 0.5%。同时，所需抵押金额约等于单日奖励的 24%。

提案正式提交链上投票后，将另行发布公告说明。

重要提醒：无论投票结果如何，抵押机制都将于 Epoch 180 按既定规则正式生效。如果本次提案未通过，系统将于 Epoch 180 自动启用 Genesis 中定义的抵押参数，而非上述提议参数。

未来如需提高抵押要求，将通过单独提案发起投票。当前阶段的目标是观察网络运行的稳定性，并确保非正当惩罚的情况极少发生，且仅在合理情况下执行。在网络稳定性得到验证后，可逐步将抵押水平提高至《Tokenomics 白皮书》中所定义的标准水平（例如每张 H100 约 100 GNK），以支持网络的长期发展。

2026年2月13日

即将到来的 v0.2.10 升级投票与执行时间安排

即将进行的软件升级 v0.2.10 的链上投票期预计将于周日晚上（洛杉矶时间）/ 周一早晨（UTC）开始。如果该提案通过治理投票获得批准，升级计划在周二执行。

大致时间线：

周日晚上（洛杉矶时间）：投票期开始
周一（UTC 早晨）：投票进行中
周二：执行升级（若投票通过）

请在 GitHub 上审阅 v0.2.10 升级 PR 并留下反馈。对有价值的审阅贡献，可能会在下一次升级中提出赏金提案。

https://github.com/gonka-ai/gonka/pull/695

2026年2月13日

如果你的节点未能及时应用最新升级，可能会在区块 2628371 处因共识失败而停止运行。这是因为节点仍在运行过期的二进制文件，已不再与网络兼容。要恢复运行，请按照以下指南操作：恢复指南：因错过升级导致的共识失败

2026年2月12日

网络更新：补丁已发布（PoC / cPoC 重叠）

现已提供补丁，用于处理在当前 epoch 中观察到的事件。

需要采取的操作

请各 Host 尽快应用该补丁，以确保 PoC 验证行为正确，并支持区块生产安全恢复。

# Download Binary
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.9-post3/ .inference/data/upgrade-info.json
sudo mkdir -p  .inference/cosmovisor/upgrades/v0.2.9-post3/bin/
wget -q -O  inferenced.zip 'https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.9-post3/inferenced-amd64.zip' && \
echo "59896da31f4e42564fc0a2f63a9e0bf4f25f240428f21c0d5191b491847553df  inferenced.zip" | sha256sum --check && \
sudo unzip -o -j  inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.9-post3/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.9-post3/bin/inferenced && \
echo "Inference Installed and Verified"

# Link Binary
echo "--- Final Verification ---" && \
sudo rm -rf .inference/cosmovisor/current
sudo ln -sf upgrades/v0.2.9-post3 .inference/cosmovisor/current
echo "aaffbbdc446fbe6832edee8cb7205097b2e5618a8322be4c6de85191c51aca1d .inference/cosmovisor/current/bin/inferenced" | sudo sha256sum --check && \

# Restart 
source config.env && docker compose up node --no-deps --force-recreate -d

https://github.com/gonka-ai/gonka/pull/748

2026年2月12日

网络事件：PoC / cPoC 重叠（区块生产已暂停）

在当前 epoch 中观察到 cPoC（confirmation PoC）与 PoC 出现重叠。在该 epoch 的最后一个区块之前，观察到 is_confirmation_poc_active 为 true。

目前正在评估此次重叠的影响。初步观察显示，没有任何节点记录到 PoC commits，因此该 epoch 累计权重为 0。

作为预防性措施，矿工通过协同行动暂时停止了区块生产。

问题正在定位中。

请保持在线，以便在需要时能够在短时间内应用补丁。更多细节以及补丁操作说明将在准备就绪后发布。

2026年2月12日

推理现已开放

链上推理访问目前已开放，且不再仅限于开发者。推理请求可以通过“允许的 Transfer Agents（传输代理）”发送，该机制已在上一次更新中引入。当前 allowlist（允许名单）可在链上查询：

curl "http://node2.gonka.ai:8000/chain-api/productscience/inference/inference/params" | jq '.params.transfer_agent_access_params.allowed_transfer_addresses'

当前允许的 Transfer Agents（地址）：

 gonka1y2a9p56kv044327uycmqdexl7zs82fs5ryv5le
 gonka1dkl4mah5erqggvhqkpc8j3qs5tyuetgdy552cp
 gonka1kx9mca3xm8u8ypzfuhmxey66u0ufxhs7nm6wc5
 gonka1ddswmmmn38esxegjf6qw36mt4aqyw6etvysy5x
 gonka10fynmy2npvdvew0vj2288gz8ljfvmjs35lat8n
 gonka1v8gk5z7gcv72447yfcd2y8g78qk05yc4f3nk4w
 gonka1gndhek2h2y5849wf6tmw6gnw9qn4vysgljed0u

新的库版本在此获取：https://gonka.ai/zh/developer/quickstart/#3-openai-sdk

注意：如果某个地址不在 allowlist 中，则在当前配置下，通过该地址路由的推理请求将不会被接受。

2026年2月10日

v0.2.10 升级 PR 审查

用于下一次链上软件升级 v0.2.10 的 Pull Request 已开放审查。欢迎提出反馈与改进建议。当前计划将审查窗口开放约 2 天。

针对本次 PR 审查中有意义的贡献，可能会在下一次升级中提出相应的赏金提案。

本通知仅为 Pull Request 的审查征集，并非正式投票的开始。治理投票流程将在审查期结束后启动。

关键变更

PR #710 PoC 验证采样优化

本次升级引入新的 PoC 验证机制：为每个参与者分配一个固定采样的验证者集合，将复杂度从 O(N^2) 降至 O(N × N_SLOTS)。参考设计与分析 https://github.com/gonka-ai/gonka/blob/upgrade-v0.2.10/proposals/poc/optimize.md

PR #725 按真实 PoC 耗时进行 PoC 权重归一化

本次升级按 PoC 实际经过时间对参与者权重进行归一化，以减少区块时间漂移带来的影响，并使权重结果与真实执行时长保持一致。

其他关键变更

PR #708 IBC 升级到 v8.7.0
PR #723 测试网桥接（bridge）部署脚本
PR #666 产物（artifact）存储吞吐优化
PR #688 基于链上数据的惩罚统计
PR #697 用于 macOS 测试构建的可移植 BLST 构建
PR #712 要求 proto-go 生成结果与提交的代码一致
PR #711 从链状态读取 PoC 测试参数
PR #641 带归属（vesting）的 Streamvesting 转账
PR #659 模型分配检查上一 epoch 的奖励
PR #716 重命名 PoC 权重函数，以提升代码清晰度与准确性

API 加固与可靠性修复

PR #634: 增加请求体大小限制，以降低 DoS 风险
PR #727: #634 的后续修复，将 response writer 传入 http.MaxBytesReader 并对齐测试
PR #638: 修复请求处理中的不安全类型断言
PR #644: 避免每次启动都重写静态配置
PR #661: 防止短暂网络中断导致 API 崩溃
PR #640: 为节点版本接口行为添加单元测试
PR #622: 在 InvalidateInference 中传播退款错误
PR #639: 在任务认领路径中，错误处理后补充缺失的 return
PR #643: 在执行器选择过程中清理（sanitize）nil 参与者
PR #545: API 流程中的小型 bug 修复

升级计划

二进制版本预计将通过链上升级提案进行更新。有关升级流程的更多信息，请参阅： https://github.com/gonka-ai/gonka/blob/upgrade-v0.2.10/docs/upgrades.md.

现有主机无需升级其 api 和 node 容器。更新后的容器版本主要面向链上升级完成后新加入的主机。

拟议流程

活跃主机在 GitHub 上审查该提案并留下反馈。
PR 完成社区审查后，预计会从该分支创建 v0.2.10 release，并可为该版本提交链上升级提案，从而启动正式的治理投票流程。
若链上提案获得通过，该 PR 预计将在链上执行升级后进行合并。

从 upgrade-v0.2.10 分支（而非 main）创建 release，可尽量缩短 main 分支 /deploy/join/ 目录中“容器版本与链上二进制版本不匹配”的时间，从而确保新主机加入时的体验更顺畅。

测试与迁移

v0.2.10 的测试指南与迁移细节记录在此处：https://github.com/gonka-ai/gonka/tree/upgrade-v0.2.10/proposals/governance-artifacts/update-v0.2.10. 请仔细阅读。

兼容性说明

如果你有任何脚本会解析 inferenced CLI 的 JSON 输出，请在本次升级后重新检查。由于 ibc-go 升级到 v8.7.0，枚举（enum）现在会以字符串而非数字编码；同时，int64/uint64 数值也会以字符串形式编码。

2026年2月4日

CLI 更新提醒

对于在 v0.2.9 升级之后创建的 warm keys，在授予权限时应使用 CLI v0.2.9。

2026年2月3日

PoC v2 基于推理性能的权重调整

随着 PoC v2 启用，权重分配现已基于当前模型 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 的实测推理性能。因此，GPU 的中位权重以及不同 GPU 类型之间的相对权重比例均已调整。

GPU 权重变化（Epoch 158 → 159）

GPU Type	Epoch 158	Epoch 159	Change
A100-PCIE-40GB	129.05	17.31	-86.6%
A100-SXM4-80GB	204.12	127.75	-37.4%
B200	739.81	300.75	-59.3%
H100 80GB HBM3	424.73	292.88	-31.0%
H100 PCIe	307.03	144.53	-52.9%
H200	512.38	303.88	-40.7%

背景说明

观察到的变化表明，GPU 权重差异现在反映的是特定模型下的推理吞吐能力，而非名义硬件规格。例如，H100 PCIe 的权重下降幅度大于 H100 HBM3，这与在 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 上观测到的推理行为一致。
在当前模型配置下，基于已观测到的推理运行记录，B200 GPU 并未表现出相较于 H100 级 GPU 更高的推理性能。
如果在未来的 epoch 中通过治理引入更大或计算需求更高的模型（例如 DeepSeek V3.2），可能会观察到不同的性能特征。
在 PoC 之外进行的对照推理基准测试中，使用基于 vLLM 的标准推理方式在同一模型 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 上测量，得到的不同 GPU 类型之间的相对性能差异与 PoC v2 中观察到的结果一致。

对 Tracker（Dashboard）维护者的行动建议

在新的权重分配生效后，Tracker（Dashboard）维护者应考虑检查并更新 epoch 159 及之后的系数，以确保与当前 PoC v2 的权重分配保持一致。

2026年2月2日

网络更新 — 补丁已发布

现已发布补丁，用于修复在 PoC 周期中导致区块验证暂停的问题。建议各主机尽快应用该补丁，以确保 PoC 验证行为正确，并使区块生产能够安全恢复。

需要采取的行动

请各主机尽快应用该补丁，以确保 PoC 验证行为正确，并使区块生产能够安全恢复。

# Download Binary
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.9-post2/ .inference/data/upgrade-info.json
sudo mkdir -p  .inference/cosmovisor/upgrades/v0.2.9-post2/bin/
wget -q -O  inferenced.zip 'https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.9-post2/inferenced-amd64.zip' && \
echo "8de51bdd1d2c0af5f1da242e10b39ae0ceefd215f94953b9d95e9276f7aa70c7  inferenced.zip" | sha256sum --check && \
sudo unzip -o -j  inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.9-post2/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.9-post2/bin/inferenced && \
echo "Inference Installed and Verified"

# Link Binary
echo "--- Final Verification ---" && \
sudo rm -rf .inference/cosmovisor/current
sudo ln -sf upgrades/v0.2.9-post2 .inference/cosmovisor/current
echo "75410178a4c3b867c0047d0425b48f590f39b9e9bc0f3cf371d08670d54e8afe .inference/cosmovisor/current/bin/inferenced" | sudo sha256sum --check && \

# Restart 
source config.env && docker compose up node --no-deps --force-recreate -d

2026年2月2日

区块验证已作为预防措施暂停

由于当前 PoC 周期中验证阈值可能无法达到的风险较高，主机参与方通过集体行动，已将区块验证作为预防措施暂停。根据当前评估，用于处理该场景的机制可能无法按预期运行。为防止在不确定或不安全的情况下完成验证者定案，网络已在验证者选择之前被暂停。

后续步骤（Next steps）

目前正在进行以下工作：

验证是否不存在任何验证者集合能够达到所需的验证阈值
确认验证者定案前的网络状态
准备用于解决已识别问题的补丁

需要采取的行动（Action required）

请所有主机运营方做好在短时间内安装补丁的准备。请保持在线状态并密切关注公告。一旦补丁准备就绪，将立即发布进一步指引。

2026年2月1日

升级已完成：v0.2.9 已在主网正式生效

针对升级提案 v0.2.9 的链上治理投票已结束。该提案已被批准（APPROVED），并已在区块高度 2,451,000 成功完成主网升级。本次升级启用了 PoC v2 作为权重分配机制，并完成了从旧版 PoC 机制的全面迁移。

注意事项（Attention)

下一轮 PoC 周期（从 epoch 158 过渡到 epoch 159）至关重要。请相关节点运营方务必保持在线，以便在需要时能够及时执行后续操作或风险缓解指引。
只有运行 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 模型的 ML 节点才有资格进入下一轮（第 159 轮）epoch 并参与 PoC v2 权重分配。运行其他模型的 ML 节点将不会被纳入即将到来的 epoch 参与者集合。

主机准备（Host preparation

建议所有主机运营方确认其所有 ML 节点：

仅配置并提供受支持的模型 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
已将镜像升级至兼容 PoC v2 的版本

关于如何将 ML 节点切换至 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8、升级 ML 节点镜像以及移除其他模型的详细指南，请参阅 FAQ。

当前已生效的关键变更（Key changes now active

PoC v2 启用

PoC v2 现已作为权重分配的主要机制
确认型 PoC（PoC v2 tracking）被用作结果的权威来源
旧版 PoC 逻辑已不再用于权重计算

模型配置（Model configuration)

网络当前运行于单一模型配置
用于 PoC v2 及权重分配的模型为 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
提供其他模型的 ML 节点将不参与 PoC v2 权重分配. 在支持的情况下，系统可能会自动切换模型至 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8

资格条件（Eligibility criteria)

要符合 PoC v2 权重分配资格，ML 节点必须同时满足以下两个条件：

节点提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 模型
节点运行兼容 PoC v2 的镜像版本：
- ghcr.io/product-science/mlnode:3.0.12-post1
- ghcr.io/product-science/mlnode:3.0.12-post1-blackwell

cPoC 场景下的奖励流向修正（Reward flow correction for cPoC cases）

在因 cPoC 处罚导致奖励被减少或取消的情况下，未分配的奖励部分将转入社区池（Community Pool）。此前，这部分奖励会被重新分配给其他参与者。

其他协议更新（Additional protocol updates）

在初始阶段，Transfer Agent 角色被限制在一个已定义的 allowlist 中
对于在生成 PoC 时忽略 PoC 验证的节点，已将其从参与者 allowlist 中移除
当 PoC v2 验证投票未达到阈值时，将应用Guardian 权重作为确定性的兜底机制

有关上述变更的更多详细信息，请参阅治理文档： https://github.com/gonka-ai/gonka/tree/upgrade-v0.2.9/proposals/governance-artifacts/update-v0.2.9

2026 年 2 月 1 日

v0.2.9 升级提案的链上治理流程即将结束。

投票结束时间： 2026 年 2 月 1 日 22:02:58（UTC）
升级高度： 2,451,000
预计升级时间： 2026 年 2 月 2 日 05:10:00（UTC）

建议各位主机（Hosts）在 GitHub 上查看该提案并参与投票。

建议提前下载二进制文件，以避免在升级窗口期间依赖 GitHub 的可用性。

# 1. Create Directories
sudo mkdir -p .dapi/cosmovisor/upgrades/v0.2.9/bin \
              .inference/cosmovisor/upgrades/v0.2.9/bin && \

# 2. DAPI: Download -> Verify -> Unzip directly to bin -> Make Executable
wget -q -O decentralized-api.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.9/decentralized-api-amd64.zip" && \
echo "ac1ad369052a8c3d01af4d463c49cdd16fcbecc365d201232e7a2d08af8501c0 decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.9/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.9/bin/decentralized-api && \
echo "DAPI Installed and Verified" && \

# 3. Inference: Download -> Verify -> Unzip directly to bin -> Make Executable
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.9/bin/ && \
wget -q -O inferenced.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.9/inferenced-amd64.zip" && \
echo "fc628d77aa516896924fbd8f60b8aa6a14161de4582aaef634de62382ea482eb inferenced.zip" | sha256sum --check && \
sudo unzip -o -j inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.9/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.9/bin/inferenced && \
echo "Inference Installed and Verified" && \

# 4. Cleanup and Final Check
rm decentralized-api.zip inferenced.zip && \
echo "--- Final Verification ---" && \
sudo ls -l .dapi/cosmovisor/upgrades/v0.2.9/bin/decentralized-api && \
sudo ls -l .inference/cosmovisor/upgrades/v0.2.9/bin/inferenced && \
echo "52c79f06a8fc175ca6b3819523bb36afbf601d8a8320b1bb5a3cc089ceef62c4 .dapi/cosmovisor/upgrades/v0.2.9/bin/decentralized-api" | sudo sha256sum --check && \
echo "ae20517e4bb38293202f7f5d52439d5315cb32c8f3c34a02fa65feaefadd6193 .inference/cosmovisor/upgrades/v0.2.9/bin/inferenced" | sudo sha256sum --check

2026年1月31日

v0.2.9 升级提案进入治理流程

下一版本链上软件 v0.2.9 的升级提案现已在链上发布并开放投票。若获批准，该提案将启用 PoC v2 作为权重分配机制，并通过链上治理完成从旧版 PoC 机制的过渡。

关键变更

PoC v2 激活

PoC v2 作为权重分配的有效机制投入使用
确认型 PoC（V2 tracking）作为结果的规范来源
旧版 PoC 逻辑不再用于权重计算

模型配置

网络以单模型配置运行
用于 PoC v2 与权重分配的模型为 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
提供其他模型的 ML 节点不纳入 PoC v2 的权重分配。在支持的情况下，可能会自动切换至 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8

资格条件

ML 节点要符合 PoC v2 权重分配资格，必须同时满足以下两项条件：

节点提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
节点运行兼容 PoC v2 的镜像：
- ghcr.io/product-science/mlnode:3.0.12-post1
- ghcr.io/product-science/mlnode:3.0.12-post1-blackwell

cPoC 场景下的奖励流程修正

当因 cPoC 处罚导致奖励减少或被排除时，未计入的部分将转入社区池。此前，这部分奖励会在其他参与者之间重新分配。

其他协议更新

Transfer Agent 角色在初始阶段仅限于一个已定义的 allowlist
参与 PoC 生成但忽略 PoC 验证的节点已从参与者 allowlist 中移除
当未达到 PoC v2 验证投票阈值时，应用 Guardian 权重作为确定性的兜底机制

上述变更的更多细节可在治理工件中查看：https://github.com/gonka-ai/gonka/tree/upgrade-v0.2.9/proposals/governance-artifacts/update-v0.2.9

主机准备

建议主机确认所有 ML 节点：

仅配置并提供受支持的模型 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
镜像已更新至兼容 PoC v2 的版本

关于将 ML 节点切换至 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8、升级 ML 节点镜像以及移除其他模型的指引，请参阅 FAQ。

如何投票

提案详情与投票可通过 inferenced 进行。任何活跃节点均可使用，可用节点包括：

提交投票（ yes 、 no 、 abstain 、 no_with_veto ）：

export NODE_URL=https://node4.gonka.ai/
./inferenced tx gov vote 26 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

查看投票状态：

export NODE_URL=https://node4.gonka.ai/
./inferenced query gov votes 26 -o json --node $NODE_URL/chain-rpc/

截止时间

投票结束时间：2026年2月1日 22:02:58（UTC）
升级高度：2451000
预计升级时间：2026年2月2日 05:10:00（UTC）

建议主机在 GitHub 上查看该提案并参与投票。

注意事项

请计划在升级窗口期间保持在线，以便在需要时及时执行后续步骤或缓解措施。
升级期间，Cosmovisor 会在 .inference/data 目录中创建完整的状态备份。请在升级前确保有足够的磁盘空间。有关如何安全移除 .inference 目录中旧备份的指引，请参阅文档。
如果 application.db 占用大量磁盘空间，可采用此处描述的清理方法。
升级完成后，可选择使用 Postgres 作为本地负载数据存储方案。

2026年1月29日

PoC 验证参与通知

在最近一轮 epoch 期间，大量 ML 节点未获得 PoC 权重。分析显示，这是由于 PoC 验证参与不足所致。在多数情况下，参与者提交了 nonce，但验证要么未执行，要么执行水平显著低于协议要求。以下表格列出了在上一轮 epoch 中拥有权重、在当前 epoch 中提交了 PoC nonce、但未参与或参与不足 PoC 验证阶段的参与者：https://docs.google.com/spreadsheets/d/17agQXP77lATT2bNK12OEOzek5wNSptN2ktiSag3QXB0/

他们的总权重约为 36%。加上完全未参与 PoC 的参与者，PoC 验证参与不足或零参与的总权重约达 48%，已处于临界高位。如果您的节点在该表格中显示 validated 为 0，请检查您的 PoC 验证日志和配置，确保验证正常运行。

此 notebook 展示了用于生成上述表格的处理流程：https://github.com/gonka-ai/gonka/blob/gm/debug-155-1/debug-validation.ipynb。

2026年1月29日

升级已执行：v0.2.8 现已在主网上线

v0.2.8 升级提案的链上治理投票已结束。该提案已获批准并成功在主网上执行。本次升级实现了 PoC v2 架构，精简了模型支持，并应用了关键的安全性和可靠性修复。

现已生效的关键变更

PoC v2 核心集成

vLLM 集成：PoC 已直接集成到 vLLM 中，实现从推理到 PoC 的即时切换，无需卸载模型。
MMR 承诺：工件存储已迁移至链下，使用 Merkle Mountain Range 承诺；链上仅记录 root_hash 和 count。
双模式迁移：支持 V1（常规 PoC）和 V2（确认型 PoC）跟踪模式。

模型可用性更新

支持的模型集现已受到限制。除以下模型外，所有此前支持的模型均已从活跃集中移除：

Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
Qwen/Qwen3-32B-FP8

安全性与可靠性改进

SSRF 与 DoS：验证 InferenceUrl 以拒绝内部 IP，并添加超时以防止请求挂起。
投票篡改：拒绝重复的 PoC 验证以防止覆盖。
身份验证绕过：将 epochId 绑定到签名，以针对正确的 epoch 进行验证。

主机参与 PoC v2 的资格要求

要获得 PoC v2 参与资格，主机必须完成以下操作：

模型配置：将 ML 节点配置为提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
ML 节点升级：使用支持 PoC v2 的版本：
- ghcr.io/product-science/mlnode:3.0.12
- ghcr.io/product-science/mlnode:3.0.12-blackwell

Note

未能同时满足上述两项条件的节点，在网络过渡到单模型配置后将不具备 PoC v2 参与资格。PoC v2 用于权重分配的过渡仍需视观察到的采用阈值和后续治理情况而定。

维护与运营

Cosmovisor：节点和 API 二进制更新将自动处理。现有主机无需对运行中的容器进行手动更新。
磁盘空间：Cosmovisor 会在 .inference/data 目录中创建完整的状态备份。请确保有 250+ GB 的可用空间。
Postgres：升级后可配置 Postgres 作为本地负载存储。

建议在升级后窗口期间监控节点状态并保持 Discord 通讯，以确保稳定性。

2026年1月28日

如何切换至 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8、升级 ML 节点并移除其他模型？

本指南说明主机应如何根据 v0.2.8 模型可用性变更以及即将到来的 PoC v2 更新来更新其 ML 节点。从 Epoch 155 开始观察 ML 节点配置是否符合 PoC v2 要求。建议主机在此之前审查并准备好 ML 节点配置。PoC v2 迁移可在 epoch 155 之后进行调度。迁移阶段结束后，不满足配置要求的 ML 节点的权重可能不会被计入。

1. 背景：模型可用性变更（升级 v0.2.8）

作为 v0.2.8 升级的一部分，活跃模型集已更新。

支持的模型（活跃集）

仅以下模型仍受支持：

Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
Qwen/Qwen3-32B-FP8

Qwen/Qwen3-32B-FP8 在迁移期间受支持，但不计入 PoC v2 就绪状态或权重分配。参与 PoC v2 需要提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8。

已移除的模型

所有此前支持的模型均已从活跃集中移除，不得继续提供服务。

3. PoC v2 就绪标准（重要）

成功参与 PoC v2 过渡需要同时满足以下两项条件：

您的所有 ML 节点均提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8。这是唯一计入 PoC v2 权重的模型。
您的所有 ML 节点均已升级至兼容 PoC v2 的镜像：
- ghcr.io/product-science/mlnode:3.0.12
- ghcr.io/product-science/mlnode:3.0.12-blackwell

重要

仅提供正确的模型而不升级 ML 节点是不够的。
不满足上述两项条件的节点，在网络切换至单模型配置后将不具备资格。
ML 节点升级必须在迁移完成且 PoC v2 通过 v0.2.8 升级后的单独治理提案激活之前完成。
v0.2.8 升级本身不会启用 PoC v2。

3. 检查 ML 节点分配状态（推荐的安全步骤）

在更改模型之前，应检查当前 ML 节点的分配状态。查询您的网络节点管理 API：

curl http://127.0.0.1:9200/admin/v1/nodes

查找以下字段：

"timeslot_allocation": [
  true,
  false
]

解释：

第一个布尔值：节点是否在当前 epoch 中提供推理服务
第二个布尔值：节点是否计划在下一次 PoC 中提供推理服务

推荐做法

优先在第二个值为 false 的节点上更改模型
这可以在 PoC v2 行为仍在观察期间降低风险
建议跨多个 epoch 逐步推进

4. 更新 ML 节点模型：仅保留支持的模型

预下载模型权重（推荐）。为避免启动延迟，请将权重预下载至 HF_HOME：

mkdir -p $HF_HOME
huggingface-cli download Qwen/Qwen3-235B-A22B-Instruct-2507-FP8

使用 ML 节点管理 API 将 ML 节点切换至支持的模型（Qwen/Qwen3-235B-A22B-Instruct-2507-FP8）。

例如：

curl -X PUT "http://localhost:9200/admin/v1/nodes/node1" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "node1",
    "host": "inference",
    "inference_port": 5000,
    "poc_port": 8080,
    "max_concurrent": 800,
    "models": {
      "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8": {
        "args": [
          "--tensor-parallel-size",
          "4",
          "--max-model-len",
          "240000"
        ]
      }
    }
  }'

通过管理 API 应用的更改将在下一个 epoch 生效 https://gonka.ai/host/mlnode-management/#updating-an-existing-mlnode

Note

node-config.json 仅在网络节点 API 首次启动或本地状态/数据库被移除时使用。如需全新重启请编辑该文件。对于现有节点，模型更新应通过管理 API 进行。

5. 升级 ML 节点镜像（PoC v2 必需）

编辑 docker-compose.mlnode.yml 并更新 ML 节点镜像：

标准 GPU

image: ghcr.io/product-science/mlnode:3.0.12

NVIDIA Blackwell GPU

image: ghcr.io/product-science/mlnode:3.0.12-blackwell

应用更改并重启服务。从 gonka/deploy/join 目录执行：

source config.env
docker compose -f docker-compose.yml -f docker-compose.mlnode.yml pull
docker compose -f docker-compose.yml -f docker-compose.mlnode.yml up -d

6. 验证模型服务（在下一个 epoch 生效）

确认 ML 节点仅提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8，这是唯一用于 PoC v2 权重和未来权重分配的模型：

curl http://127.0.0.1:8080/v1/models | jq

可选择重新检查节点分配：

curl http://127.0.0.1:9200/admin/v1/nodes

治理与 PoC v2 激活说明

PoC v2 采用分阶段引入，而非一次性激活。

阶段 1：观察期（v0.2.8 后的当前状态）

v0.2.8 升级后，PoC v2 逻辑可用，但尚未用于权重分配。

在此阶段：

主机可以提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 或 Qwen/Qwen3-32B-FP8
主机必须将其 ML 节点切换至提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 并升级至兼容 PoC v2 的版本，以便计入 PoC v2 权重。
网络将观察采用情况，以评估主机是否准备好过渡到 PoC v2 权重。

阶段 2：治理提案（可选，未来）

一旦在活跃主机中观察到足够的采用水平（约 50%）：

可能会提交一个单独的治理提案
该提案可能请求批准激活 PoC v2 并使用 PoC v2 进行权重分配

采用阈值仅供观察，不会触发任何自动更改。

阶段 3：激活（仅在治理批准后）

PoC v2 成为权重分配的活跃方法，仅在治理提案获得链上批准后生效。在该提案获批之前：

PoC v2 不会用于权重分配
现有的 PoC 机制将继续用于确定权重

总结清单

在 PoC v2 激活之前，请确保：

ML 节点提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
所有其他模型已从配置中移除
ML 节点镜像为 3.0.12（或 3.0.12-blackwell）

2026年1月28日

v0.2.8 升级提案的链上治理流程即将结束。

升级详情

升级高度：区块 2387000
预计时间：2026年1月29日 06:30:00（UTC）

建议提前预下载二进制文件，以避免在升级窗口期间依赖 GitHub 的可用性。

# 1. 创建目录
sudo mkdir -p .dapi/cosmovisor/upgrades/v0.2.8/bin \
              .inference/cosmovisor/upgrades/v0.2.8/bin && \

# 2. DAPI：下载 -> 校验 -> 直接解压至 bin -> 赋予可执行权限
wget -q -O decentralized-api.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.8-post1/decentralized-api-amd64.zip" && \
echo "45f28afba4758e54988f61cc358f0ad683e7832ab121ccd54b684fe4c9381a75 decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.8/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.8/bin/decentralized-api && \
echo "DAPI Installed and Verified" && \

# 3. Inference：下载 -> 校验 -> 直接解压至 bin -> 赋予可执行权限
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.8/bin/ && \
wget -q -O inferenced.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.8-post1/inferenced-amd64.zip" && \
echo "f0f2e3ee8760e40a78087c98c639a7518bf062138141ed4aec2120f5bc622a67 inferenced.zip" | sha256sum --check && \
sudo unzip -o -j inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.8/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.8/bin/inferenced && \
echo "Inference Installed and Verified" && \

# 4. 清理与最终校验
rm decentralized-api.zip inferenced.zip && \
echo "--- Final Verification ---" && \
sudo ls -l .dapi/cosmovisor/upgrades/v0.2.8/bin/decentralized-api && \
sudo ls -l .inference/cosmovisor/upgrades/v0.2.8/bin/inferenced && \
echo "421a761f3a7037d72ee0bd8b3f50a744349f717439c7e0fee28c55948dae9a7c .dapi/cosmovisor/upgrades/v0.2.8/bin/decentralized-api" | sudo sha256sum --check && \
echo "308c63c7bda4fb668632ac3e13f3f6cccacf54c563c8e9fd473bcb48c7389fe0 .inference/cosmovisor/upgrades/v0.2.8/bin/inferenced" | sudo sha256sum --check

2026年1月27日

v0.2.8 升级提案进入治理流程

下一版本链上软件 v0.2.8 的升级提案现已在链上发布并开放投票！您的审查和投票对于确保网络的稳定性和未来能力至关重要。

v0.2.8 中的关键变更

PoC v2（核心升级）

将 PoC 直接集成到 vLLM 中，实现从推理到 PoC 的即时切换，无需卸载模型或加载单独的 PoC 模型。
使用 MMR（Merkle Mountain Range）承诺将工件存储迁移至链下——链上仅记录 root_hash 和 count。
包含双模式迁移策略：V1 用于常规 PoC，V2 跟踪用于部署期间的确认型 PoC。

模型可用性变更

作为 v0.2.8 升级的一部分，支持的模型集已更新。除以下模型外，所有此前支持的模型均已从活跃集中移除：

Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
Qwen/Qwen3-32B-FP8

使用 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 成功参与 PoC v2，结合所需的 ML 节点版本，将用于评估 PoC v2 过渡的就绪状态。一旦在活跃主机中观察到足够的采用水平（约 50%），可能会提交一个单独的治理提案以批准并激活 PoC v2 用于权重分配。此阈值仅供观察，不会触发任何自动的网络变更。

在下一步网络变更通过治理批准后，网络将暂时仅支持 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8。

安全性、正确性和可靠性改进

SSRF 与 DoS：验证 InferenceUrl 以拒绝内部 IP，并添加超时以防止请求挂起。
投票篡改：通过拒绝重复项防止 PoC 验证被覆盖。
PoC 排除：修复 getInferenceServingNodeIds 以正确排除推理服务节点。
身份验证绕过与重放：将 epochId 绑定到签名，并针对正确的 epoch 验证授权。

由于变更量较大，此处仅列出部分要点。其他更新和修复的完整列表可在 GitHub pull request 中查看。

主机需采取的行动

要参与 PoC v2 过渡，主机必须完成以下两个步骤：

确认您的 ML 节点已配置为提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
将 ML 节点升级至支持 PoC v2 的版本：
- ghcr.io/product-science/mlnode:3.0.12
- ghcr.io/product-science/mlnode:3.0.12-blackwell

仅提供 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 而不升级 ML 节点，不足以参与 PoC v2。在网络切换至单模型配置后，不满足上述两项条件的节点将不被视为具备 PoC v2 参与资格。ML 节点升级必须在 PoC v2 通过治理完全启用之前完成。

如何投票

您可以使用 inferenced 命令获取提案详情并投票。请注意，任何活跃节点均可用于查询或投票。当前可用的节点包括：

查看投票状态：

export NODE_URL=https://node4.gonka.ai/
./inferenced query gov votes 25 -o json --node $NODE_URL/chain-rpc/

投票（ yes 、 no 、 abstain 、 no_with_veto ）：

export NODE_URL=https://node4.gonka.ai/
./inferenced tx gov vote 25 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

截止时间

投票结束时间：2026年1月29日 03:02:20（UTC）
升级提议区块高度为 2387000。该区块的预计时间为 2026年1月29日 06:30:00（UTC）

如果您是主机，请查看并投票。

注意事项 1： 请计划在升级窗口期间保持在线，以便在需要时及时执行后续步骤或缓解措施。

注意事项 2： 升级期间，Cosmovisor 会在 .inference/data 目录中创建完整的状态备份。请确保有足够的磁盘空间。有关如何安全移除 .inference 目录中旧备份的说明，请参见此处。如果 application.db 占用大量磁盘空间，可使用此处描述的清理技术。

注意： 升级完成后，可配置 Postgres 作为本地负载存储。

2026年1月19日

提案更新：稳定期延长已获批准

关于延长稳定期的最新治理投票已成功通过。稳定期现已正式延长，以便进行更多测试和网络升级。

主机需采取的行动

随着延期确认，请利用这段时间为新的 PoC 要求做好环境准备。

模型更新：请将您的 ML 节点切换至 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 模型。
逐步部署：如果您运营多个 ML 节点，建议在多个 epoch 中逐步完成这些更新。

如何更新

有关更新现有 ML 节点的说明，请参阅：https://gonka.ai/host/mlnode-management/#updating-an-existing-mlnode

2026年1月16日

稳定期延长

当前有一项新的治理投票正在进行中。

该提案将当前的稳定期延长约两周。延长的时间将用于与即将到来的 PoC 变更及相关网络升级有关的额外测试。关于新的 PoC 开发进展的更多细节可参见此处：https://github.com/gonka-ai/gonka/blob/gm/poc-status/proposals/governance-artifacts/poc-update-status.md。

此次延长也为主机提供了时间，以便为新的 PoC 要求准备其部署环境，包括将其 ML 节点切换到 Qwen/Qwen3-235B-A22B-Instruct-2507-FP8 模型。有关更新现有 ML 节点的说明请参见：https://gonka.ai/host/mlnode-management/#updating-an-existing-mlnode。运行多个 ML 节点的主机建议在多个 epoch 中逐步完成更新。

投票范围

如果提案获得通过，网络将在临时期间继续按照现有的 allowlist 运行（该列表由未表现出非标准硬件行为的主机组成）。

开发者 allowlist 将按相同的时间偏移进行延长，并持续有效至区块 2459375。

未被纳入 allowlist 的主机在延长的稳定期内仍将无法参与 PoC，该稳定期将于区块 2443558 结束。

可复现性与方法论

allowlist：

可在此处获取：https://github.com/product-science/filter/blob/main/artifacts_end2end/allowlist.csv
基于公开可观察的链上数据生成，并使用一组预定义的硬件配置模式。这些模式通过开源脚本进行评估，脚本地址为：https://github.com/product-science/filter

执行特性

若提案获批，allowlist 将自动延长。
无需进行软件升级。
如需进一步调整，仍需通过治理流程决定。

稳定期结束后

allowlist 具有固定的到期时间，不会在延长的稳定期结束后继续生效。当 allowlist 于区块 2443558 到期后：

网络将恢复到稳定期之前生效的标准参与规则，或
任何替代配置都必须通过单独的治理决议来定义。

如何投票

您可以使用 inferenced 命令获取提案详情并进行投票。

请注意，任何正在运行的节点都可用于查询或投票。当前可用的节点包括：

http://node1.gonka.ai:8000/
http://node2.gonka.ai:8000/
http://node3.gonka.ai:8000/
https://node4.gonka.ai/

查询投票状态：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced query gov votes 22 -o json --node $NODE_URL/chain-rpc/

进行投票（ yes 、 no 、 abstain 、 no_with_veto ）：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced tx gov vote 22 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

投票后的下一步

该流程完全通过治理机制处理，不需要进行软件升级。

时间线与截止时间

投票结束时间：2026年1月18日 05:28:01（UTC）

Allowlist 到期时间：在区块 2443558 自动到期。

2026年1月10日

临时参与者 allowlist 修正

目前一项新的治理投票已开启。本提案通过将若干地址加入 allowlist，修复了现有过滤逻辑中的一个边缘问题：这些地址此前因硬件名称为空、且 ML 节点权重为 0，而被错误地过滤。该提案还将少量开发者账户加入允许的开发者列表，并将 allowlist 的过期时间与参与者注册截止区块高度 2,222,222 保持一致。所有参与相关逻辑均保持不变。本提案仅用于修复当前过滤逻辑中的一处轻微问题。

可复现性与方法论

allowlist 基于公开可观察的链上数据生成，并使用一组预定义的硬件配置模式进行筛选。这些模式通过以下开源脚本进行评估：https://github.com/product-science/filter

allowlist 文件地址如下：https://github.com/product-science/filter/blob/main/artifacts_end2end/allowlist.csv

如何投票

您可以使用 inferenced 命令获取提案详情并进行投票。

请注意：任何正在运行的节点均可用于查询或投票。目前可用的节点包括：

http://node1.gonka.ai:8000/
http://node3.gonka.ai:8000/
https://node4.gonka.ai/

查看投票状态：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced query gov votes 21 -o json --node $NODE_URL/chain-rpc/

进行投票（ yes 、 no 、 abstain 、 no_with_veto ）：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced tx gov vote 21 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

投票完成后的后续步骤

本流程完全通过链上治理完成，不需要进行任何软件升级。

时间安排与截止节点

投票结束时间：2026年1月12日 06:04:14（UTC）

Allowlist 过期时间：将在区块高度 2,222,222 时自动失效。

2026年1月10日

临时参与者 allowlist 已通过，于 Epoch 135 生效

针对稳定期设置的临时参与者 allowlist 的链上治理投票已正式结束。

该提案已获通过。本提案定义了一份临时 allowlist，用于反映在最近多个 epoch 中行为保持一致的参与者。

当前已生效的关键调整

1）网络将启用一份由以下条件筛选出的参与者组成的 allowlist。这些参与者在多个 epoch 中：

上报的硬件特征符合常见的配置模式（被过滤的非标准配置字符串列表见此处：https://github.com/product-science/filter/blob/main/filter_strings.txt）
所展示的 PoC 权重不超过同类硬件观测权重的 150%

2）此前持续偏离上述模式的参与者，将在稳定窗口结束（区块高度 2,222,222）之前被暂时排除在 allowlist 之外。

执行特性说明

allowlist 将从下一个 epoch（Epoch 135）开始生效
激活时点为 Epoch 135 的首次 PoC
无需进行任何软件升级
自激活起，allowlist 将持续生效，直至并包含区块高度 2,222,222

可复现性与方法论

allowlist 完全基于公开可观察的链上数据生成
硬件描述信息通过开源脚本，与一组预定义的配置模式进行比对与评估：https://github.com/product-science/filter
最终生成的 allowlist 已发布于以下地址：https://github.com/product-science/filter/blob/main/artifacts_end2end/allowlist.csv

后续步骤

节点主机无需采取任何操作。

2026年1月8日

行动刻不容缓：稳定期临时参与者 allowlist 治理投票现已开启

在成功采用修复 PoC 相关共识故障的补丁之后，一项新的治理投票现已正式激活。

随着正常区块生产恢复，网络将在进一步扩容之前进入一个短暂的稳定期。

本次投票旨在为稳定期定义一份参与者 allowlist（https://github.com/product-science/filter/blob/main/artifacts_end2end/allowlist.csv），该名单反映了一组在此前运行过程中，其行为始终符合网络预期的参与者。

投票范围

若提案通过，网络将在稳定期内基于 allowlist 临时运行。该名单由在过往多个 epoch 中未表现出非标准硬件行为的参与者组成。在实际评估中，allowlist 对应的是这样一组参与者，其在多个 epoch 中同时满足以下条件：

其上报的硬件特征将与一组预定义、常见的硬件配置模式进行比对，用于识别偏差与不一致（用于排除参与者的非标准硬件配置字符串的完整且明确列表见此处：https://github.com/product-science/filter/blob/main/filter_strings.txt），且
其观测到的 PoC 权重不得超过使用可比硬件的其他参与者所展示权重的 150%。此前持续表现出与上述模式存在偏差的参与者，将在稳定期结束（区块 2222222）之前被明确排除在 allowlist 之外。

可复现性与方法论

allowlist 完全基于公开、可观测的链上数据生成，并通过一组预定义的硬件配置模式推导而来。这些模式通过开源脚本进行评估，脚本可在此处获取：https://github.com/product-science/filter

allowlist 名单可在此处查看：https://github.com/product-science/filter/blob/main/artifacts_end2end/allowlist.csv

执行特性

若提案通过，allowlist 将自动生效。
无需进行任何软件升级。
allowlist 将在投票成功后、区块 2089140 对应的下一次 PoC 执行完成后激活。
自激活起，allowlist 将持续生效，直至并包含区块 2222222。
如需进一步调整，仍需通过治理流程决定。

稳定期结束之后

allowlist 设定了固定的到期时间，不会在稳定期结束后继续生效。当 allowlist 于区块 2222222 到期后：

网络要么恢复至稳定期之前生效的标准参与规则，
要么任何替代性配置均需通过单独的治理提案加以定义。

如何投票

可使用 inferenced 命令查询提案详情并提交投票。请注意：任一在线节点均可用于查询或投票。当前可用节点包括：

http://node1.gonka.ai:8000/
http://node2.gonka.ai:8000/
https://node4.gonka.ai/

查看投票状态：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced query gov votes 20 -o json --node $NODE_URL/chain-rpc/

提交投票（ yes 、 no 、 abstain 、 no_with_veto ）：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced tx gov vote 20 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

投票后的下一步

整个流程将完全通过治理机制处理，无需进行任何软件升级。

时间线与截止时间

投票结束时间：2026年1月10日 06:46:52（UTC）
Allowlist 激活时间：区块 2089140 对应的下一次 PoC 执行后
Allowlist 失效时间：区块 2222222 自动失效

如您是主机，请审阅该治理提案并积极参与投票。

2026年1月8日

网络更新 — 共识已恢复

在补丁完成部署之后，网络共识已恢复稳定，目前已在正常参数范围内运行。

2026年1月8日

网络更新 — 补丁已准备就绪，可部署

用于解决在 PoC 期间观察到的共识故障的补丁现已可用。

指引

为恢复可靠的共识推进，需要至少 67% 的活跃网络算力完成补丁安装。

在达到该阈值之前，共识推进可能仍处于不稳定状态。

鼓励主机尽快应用补丁，并在升级完成后保持节点在线。如有需要，将发布进一步指引。

2026年1月8日

网络更新 — 后续说明

用于解决近期共识问题的补丁已准备就绪，详细部署指引将很快发布。每一位活跃主机的参与对于网络继续推进并恢复正常运行都至关重要。请保持节点在线，并在指引发布后准备好应用更新。

2026年1月8日

网络更新 — PoC 期间出现共识故障

在计算证明（Proof-of-Compute，PoC）过程中，网络出现了共识故障。问题已被识别，用于解决根本原因的补丁正在准备中。后续操作说明和技术细节将很快发布。建议主机保持在线并持续关注更新，在补丁发布后可能需要执行进一步操作。

2026年1月8日

v0.2.7 升级提案：创世验证者增强机制已在主网上线

链上治理对 v0.2.7 升级提案：创世验证者增强（Genesis Validator Enhancement）的投票已结束；该提案已获批准并成功部署至主网。

现已生效的关键变更：

创世验证者增强（临时）

临时重新启用创世验证者增强机制——该机制是一项此前使用过、具有明确时效性的防御性机制，本次提案建议重新启用。
用于网络增长阶段的共识保护。在其此前运行期间：
- 三个 Guardian 验证者合计持有约 34% 的共识投票权
- 未向 Guardian 验证者提供任何额外奖励
- 该配置在边缘情形下有效防止了共识停滞
当同时满足以下两个条件时，创世验证者增强机制将自动停用：
- 全网算力达到 15,000,000
- 区块高度达到 3,000,000

协议稳定性修复（全网范围）

本次升级正式纳入此前通过手动 API 更新分发、且已在网络中实际使用的一系列关键修复。这些修复包括：

修复失败推理请求的错误记账问题（包括处理了不受支持格式的请求但未被标记为完成的情形）
提升网络在失败推理处理方面的鲁棒性
为 PoCBatch 和 PoCValidation 交易引入批处理机制

通过将上述修复纳入本次升级，其行为将成为协议级规则，并在全网范围内一致执行。

临时参与与执行限制

主机级注册：新主机注册将暂停至区块 2,222,222（约两周后）。该措施旨在稳定网络状态并为进一步扩展做好准备。
开发者级注册：在稳定期内，新开发者地址注册将被暂停。一份预定义的开发者地址 allowlist 将立即生效。allowlist 中的开发者地址在此期间可以执行推理任务。所有适用于开发者地址的限制（包括注册与推理执行）将持续生效至区块 2,294,222（约 19 天）。

治理可控机制

本次升级包含的预备性改动，使得未来可通过治理机制来控制参与者接入与推理执行，而无需额外的软件升级。本提案本身并未启用任何由治理触发的限制措施，任何此类约束均需通过后续单独的治理投票决定。

第 117 轮奖励分配

本提案涵盖与链暂停（第 117 轮）相关的两项奖励分配：

在第 117 轮期间保持活跃但未收到该轮奖励的节点，将获得该轮奖励的补发。
所有在第 117 轮期间保持活跃的节点，将额外获得一笔等同于第 117 轮奖励 1.083 倍的补发，该补发将统一适用于所有符合条件的节点，包括已收到原始奖励的节点。

关于持续时间与执行

本次升级中重新启用或引入的所有保护机制均为临时措施，并且在满足条件后将自动移除，无需人工治理干预。

后续步骤：

主机无需采取任何进一步操作。
Cosmovisor 在执行更新时，会在 .inference 状态目录中创建完整备份。为安全执行更新，建议预留 250 GB 以上的可用磁盘空间。请参阅此处了解如何安全清理 .inference 目录中的旧备份。

备注：

创世验证者增强机制的完整技术细节： https://github.com/gonka-ai/gonka/tree/main/proposals/early-network-protection
完整技术评审（GitHub PR）：https://github.com/gonka-ai/gonka/pull/503

2026年1月7日

v0.2.7 版本升级提案已通过链上治理批准。

升级详情

升级高度：区块 2,054,000
预计时间：2026年1月8日 08:10:00（UTC）

为避免在升级窗口期间依赖 GitHub 的可用性，建议提前预下载相关二进制文件。

# 1. 创建目录
sudo mkdir -p .dapi/cosmovisor/upgrades/v0.2.7/bin \
              .inference/cosmovisor/upgrades/v0.2.7/bin && \

# 2. DAPI：下载 -> 校验 -> 直接解压至 bin -> 赋予可执行权限
wget -q -O decentralized-api.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.7/decentralized-api-amd64.zip" && \
echo "03555ba60431e72bd01fe1fb1812a211828331f5767ad78316fdd1bcca0e2d52 decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.7/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.7/bin/decentralized-api && \
echo "DAPI Installed and Verified" && \

# 3. Inference：下载 -> 校验 -> 直接解压至 bin -> 赋予可执行权限
sudo rm -rf inferenced.zip .inference/cosmovisor/upgrades/v0.2.7/bin/ && \
wget -q -O inferenced.zip "https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.7/inferenced-amd64.zip" && \
echo "b7c9034a2a4e1b2fdd525bd45aa32540129c55176fd7a223a1e13a7e177b3246 inferenced.zip" | sha256sum --check && \
sudo unzip -o -j inferenced.zip -d .inference/cosmovisor/upgrades/v0.2.7/bin/ && \
sudo chmod +x .inference/cosmovisor/upgrades/v0.2.7/bin/inferenced && \
echo "Inference Installed and Verified" && \

# 4. 清理与最终校验
rm decentralized-api.zip inferenced.zip && \
echo "--- Final Verification ---" && \
sudo ls -l .dapi/cosmovisor/upgrades/v0.2.7/bin/decentralized-api && \
sudo ls -l .inference/cosmovisor/upgrades/v0.2.7/bin/inferenced && \
echo "d07e97c946ba00194dfabeaf0098219031664dace999416658c57b760b470a74 .dapi/cosmovisor/upgrades/v0.2.7/bin/decentralized-api" | sudo sha256sum --check && \
echo "09c0e06f7971be87ab00fb08fc10e21ff86f9dff6fc80d82529991aa631cd0a9 .inference/cosmovisor/upgrades/v0.2.7/bin/inferenced" | sudo sha256sum --check

当所有命令均无错误完成，并显示确认信息时，即可视为二进制已成功安装。

Inference Installed and Verified
--- Final Verification ---
-rwxr-xr-x 1 root root 224376384 Jan  1  2000 .dapi/cosmovisor/upgrades/v0.2.7/bin/decentralized-api
-rwxr-xr-x 1 root root 215172352 Jan  1  2000 .inference/cosmovisor/upgrades/v0.2.7/bin/inferenced
.dapi/cosmovisor/upgrades/v0.2.7/bin/decentralized-api: OK
.inference/cosmovisor/upgrades/v0.2.7/bin/inferenced: OK

注意事项

请在升级窗口前后保持节点在线，以便在出现问题时及时按照指引进行处理。
Cosmovisor 在升级过程中会对 .inference/data 目录创建完整备份。请确保磁盘空间充足。若磁盘占用较高，可安全删除 .inference 目录中的旧备份。
较大的 application.db 文件可通过此处方法进行缩减。

可选项：跳过 Cosmovisor 自动备份

Cosmovisor 支持在升级时通过为 node 容器设置环境变量 UNSAFE_SKIP_BACKUP=true 来跳过自动状态备份。

此选项可能减少磁盘占用并缩短升级时间。但请注意：若升级失败，将没有任何备份可用于恢复此前状态。

2026年1月7日

主机重要提示

在 Cosmovisor 升级过程中，可选择通过为 node 容器设置 UNSAFE_SKIP_BACKUP=true 来跳过自动备份。该选项具有明确风险——一旦升级失败，将无法依赖备份进行状态恢复。

2026年1月6日

v0.2.7 升级提案：创世验证者增强机制进入治理阶段

一项与创世验证者增强机制（Genesis Validator Enhancement）相关的链上治理提案已发布，目前已进入投票阶段。

近期网络规模的快速增长带来了新的运行压力。过去数日内，网络出现了多起问题，其中部分表现为在高负载或异常条件下对系统稳定性的冲击。本提案旨在通过一组临时性措施，在当前网络条件下提升整体韧性与稳定性。

创世验证者增强最初在网络早期阶段作为临时防御机制引入，并在网络运行的前两个月处于启用状态。本次进入治理的提案，拟在当前网络环境下临时重新启用该既有机制，并同时启用若干附加的保护措施。

关键变更

创世验证者增强机制（临时）

临时重新启用创世验证者增强机制——该机制为此前使用过的、具有明确期限的防御措施。
在网络增长阶段提供额外的共识保护。在其此前启用期间：
- 三个 Guardian 验证者合计持有约 34% 的共识投票权
- Guardian 验证者未获得任何额外奖励
- 该配置在部分边缘情况下有助于避免共识停滞
当同时满足以下两个条件时，创世验证者增强将自动停用：
- 全网算力达到 15,000,000
- 区块高度达到 3,000,000

协议稳定性修复（全网范围）

本次升级将正式纳入此前通过手动 API 更新分发、且目前已在网络中实际使用的一组关键修复，包括：

修正失败推理请求的错误记账问题（包括：处理了不受支持格式的请求，但未被正确标记为完成的情形）
提升失败推理处理流程的整体稳定性
为 PoCBatch 与 PoCValidation 交易引入批处理机制

将上述修复纳入协议后，其行为将作为协议级规则，在全网范围内保持一致执行。

临时参与与执行限制

主机级注册限制：新主机注册将暂停至区块 2,222,222（约两周后）。该措施旨在稳定当前网络状态，并为后续扩展做好准备。
开发者级注册与执行限制：新开发者地址注册将在稳定期内暂停。一份预定义的开发者地址白名单（allowlist）将立即生效。白名单内的开发者地址在此期间可继续执行推理。所有适用于开发者地址的限制（包括注册与推理执行）将持续至区块 2,294,222（约 19 天）。

治理可控机制

本次升级包含若干预备性改动，使未来可通过治理方式控制参与者接入与推理执行，而无需再次进行软件升级。本提案本身不会启用任何新的治理触发型限制，相关功能需通过后续治理投票单独激活。

第 117 轮奖励分配

本提案涵盖与链暂停期间（第 117 轮）相关的两项奖励分配：

在第 117 轮期间处于活跃状态但未收到该轮奖励的节点，将补发该轮奖励。
所有在第 117 轮期间处于活跃状态的节点，将获得一次额外奖励，金额为 1.083 × 第 117 轮奖励，该补发将统一适用于所有符合条件的节点，包括已领取原始奖励的节点。

关于持续时间与执行

本次升级中重新启用或引入的所有保护措施均为临时性机制，并将在满足既定条件后自动失效，无需额外的人工治理干预。

如何投票

可使用 inferenced 命令获取提案详情并提交投票。

查看投票状态：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced query gov votes 19 -o json --node $NODE_URL/chain-rpc/

提交投票（ yes 、 no 、 abstain 、 no_with_veto ）：

export NODE_URL=http://node1.gonka.ai:8000
./inferenced tx gov vote 19 yes \
--from <cold_key_name> \
--keyring-backend file \
--unordered \
--timeout-duration=60s --gas=2000000 --gas-adjustment=5.0 \
--node $NODE_URL/chain-rpc/ \
--chain-id gonka-mainnet \
--yes

时间线与关键节点

投票结束时间：2026年1月8日 04:23:14（UTC）
升级提议区块高度：2,054,000
预计升级时间：2026年1月8日 08:10:00（UTC）

主机注意事项

注意事项 1

请主机审阅提案并参与投票。在升级窗口前后保持在线，以便在出现问题时及时按照指引操作。

注意事项 2

Cosmovisor 在执行升级时会在 .inference/data 状态目录创建完整备份。请确保磁盘空间充足。如磁盘占用较高，可安全清理 .inference 目录中的旧备份。若 application.db 文件体积较大，可使用此处方法进行清理。

参考资料

创世验证者增强机制完整技术说明： https://github.com/gonka-ai/gonka/tree/main/proposals/early-network-protection

完整技术评审（GitHub PR）：https://github.com/gonka-ai/gonka/pull/503

2026年1月5日

近期我们在网络运行监控中发现，部分时段的推理（Inference）请求丢失率高于正常水平。在多数情况下，该问题由一个已知 Bug 导致：当推理请求使用了当前版本尚不支持的请求格式时，即使该请求已被成功处理，系统也未能将其正确标记为「已完成」。以下更新修复了该行为。

参阅：https://github.com/gonka-ai/gonka/pull/517

本次 API 版本提升了失败推理处理方面的稳定性，并减少了推理丢失的统计问题。同时还引入了对 PoCBatch 与 PoCValidation 交易的批量处理支持。

升级时机说明

当确认型 PoC（Confirmation PoC）未激活时，可安全进行本次更新。

可通过以下命令验证当前网络状态：

curl "http://136.243.34.19:8000/v1/epochs/latest" | jq '.is_confirmation_poc_active'

在非确认型 PoC 阶段，该字段应返回 false。

安装

下载并安装新的二进制文件，然后重启 API 容器：

# 下载二进制文件
sudo rm -rf decentralized-api.zip .dapi/cosmovisor/upgrades/v0.2.6-post12/ .dapi/data/upgrade-info.json
sudo mkdir -p  .dapi/cosmovisor/upgrades/v0.2.6-post12/bin/
wget -q -O  decentralized-api.zip 'https://github.com/product-science/race-releases/releases/download/release%2Fv0.2.6-post12/decentralized-api-amd64.zip' && \
echo "f0d1172a90ca4653035e964abe4045f049d03d6060d6519742110e181b1b2257  decentralized-api.zip" | sha256sum --check && \
sudo unzip -o -j  decentralized-api.zip -d .dapi/cosmovisor/upgrades/v0.2.6-post12/bin/ && \
sudo chmod +x .dapi/cosmovisor/upgrades/v0.2.6-post12/bin/decentralized-api && \
echo "API Installed and Verified"


# 链接二进制文件
echo "--- Final Verification ---" && \
sudo rm -rf .dapi/cosmovisor/current
sudo ln -sf upgrades/v0.2.6-post12 .dapi/cosmovisor/current
echo "4672a39c3a3a0a2c21464c227a3f36e9ebf096ecc872bf9584ad3ea632752a3e .dapi/cosmovisor/current/bin/decentralized-api" | sudo sha256sum --check && \


# 重启 
source config.env && docker compose up api --no-deps --force-recreate -d