> For the complete documentation index, see [llms.txt](https://docs.sat20.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sat20.org/ai-agent-zi-dong-hua-yu-an-quan/sat20-agent-wallet/testnet-drill-summary-2026-06-13.md).

# 测试网演练总结

> 本文保留 2026-06-13 前后测试网演练沉淀出的 Agent 安全规则。由于 SatoshiNet 测试网后来发生回滚，旧 L2 交易和旧 evidence 文件不再作为当前可复核证据列出。当前可复核 txid 以 `testnet-validation.md` 和 `evidence/testnet-minimal-punish-evidence-2026-06-18.json` 为准。

## 演练目标

本轮演练验证三件事：

1. 普通 client 钱包可以连接 Core Node 打开私人 STP 通道，不需要质押资产。
2. BTC L1 原生资产，包括 sats、Runes、BRC20、ORDX，可以通过 splicing / expand 纳入通道，在聪网个人地址和通道之间 unlock / lock 流动。
3. 当测试网 Core Node 广播已经撤销的 Core Node 侧旧 commitment 时，client wallet 能构造并广播 punish tx，证明用户不需要信任 Core Node 才能保护资产。

## 演练过程抽象

### 1. 通道与多资产进入

Agent 先通过 `stp.status` 和 `stp.safety_snapshot` 确认通道安全状态，再执行资产纳入动作：

* sats 通过 open / expand 进入通道。
* Runes 通过 splicing-in 或 expand 进入通道。
* BRC20 通过 adapter 生成 transfer inscription，再用 reveal output 完成 splicing-in。
* ORDX 小额资产通过 stub 白聪满足 L1 输出约束；同一 UTXO 中的 Ordinals NFT 按当前协议忽略，不进入聪网。

关键经验：一个 L1 UTXO 可能携带多种资产，但当前 STP 只 ascend 请求明确指定的一种资产。Agent 不能把未指定资产计入 L2 守恒预期。

### 2. L2 unlock / lock

资产进入通道后，Agent 不直接按 commitment balance 操作，而是检查目标资产是否已经进入 `UtxosL2` / `l2_spendable_balance`。

这证明了一个核心技能：区分“承诺状态安全”和“UTXO 已可花费”。BRC20 / Runes 在聪网上可以由 `Value=0` 的 UTXO 携带，Agent 不能套用 BTC L1 dust 规则。

### 3. Core Node 侧旧 commitment 惩罚

测试网 fault 接口先保留 Core Node-side commitment，再通过一次小额状态更新推动 commit height 前进。此时被保留的 Core Node-side commitment 成为旧状态。

当 Core Node 广播旧 commitment 后，client wallet 使用本地保存的惩罚材料构造 punish package。Agent 的职责是验证 punish tx 是否花费已撤销 commitment 的输出，并在 BTC L1 上确认。

Agent 规则：

1. 旧 commitment 一旦被 peer 广播，优先进入 punish，不再执行普通通道操作。
2. `stp.punish_build` 必须先证明 punish tx 花费的是已撤销 commitment 的输出。
3. `stp.punish_broadcast` 返回后，Agent 必须逐笔查询所有 punish txid，直到 L1 可见或确认。

### 4. 惩罚后的恢复

惩罚确认后，旧通道不再作为普通运行通道继续使用。Agent 的恢复目标是让用户回到一个新的、可证明安全的通道状态：

1. 确认旧 channel point 已被链上交易消费，旧通道不能再作为普通 value-moving 通道使用。
2. 使用 ordinary `stp.open` fresh open，重新建立 client 和 Core Node 的 2-of-2 通道边界。
3. 等 funding 确认和 `READY_SAFE` 后，再推进一次小额状态变化。
4. 确认新的 revoked remote commitment 已有 verified / broadcastable punish coverage。

这说明 Agent 的恢复目标不是“尽量复用旧数据”，而是“让用户重新回到可证明安全的通道状态”。

## 已验证的 Agent 技能

| 技能                               | 结论                                                                           |
| -------------------------------- | ---------------------------------------------------------------------------- |
| 普通 client open                   | 已验证，连接 Core Node 不需要质押资产                                                     |
| `stp.safety_snapshot`            | 已验证，可判断 `READY_SAFE`、commit height、channel point、commitments、punish coverage |
| sats unlock / lock               | 已验证                                                                          |
| Runes splicing / unlock / lock   | 已验证                                                                          |
| BRC20 splicing / unlock / lock   | 已验证                                                                          |
| ORDX 小额 splicing / unlock / lock | 已验证，需遵守 bindingSat 和 Ordinals NFT 忽略规则                                       |
| 结果未知处理                           | 已验证，必须查询 reservation、local/core channel 和 L1/L2 tx 可见性后再决定是否重试               |
| testnet old commitment drill     | 已验证，只能测试网使用，主网必须拒绝                                                           |
| punish build / broadcast         | 已验证，支持多笔依赖 punish package                                                    |
| punish 后恢复                       | 已验证，旧通道不能继续普通运行时 fresh open，重新建立可证明安全的控制边界                                   |

## Agent 必须内化的安全规则

1. `READY` 不等于安全可操作；普通价值移动必须要求 `READY_SAFE`。
2. `READY_SAFE` 不等于某个刚 ascend 的资产已经可花费；unlock/lock 还要检查 `l2_spendable_balance`。
3. `PUNISH_COVERAGE_UNKNOWN` 和 `PUNISH_COVERAGE_MISSING` 都必须阻止普通价值移动。
4. peer 广播旧 commitment 时，Agent 必须优先 punish。
5. timeout、连接中断或服务暂不可用是“结果未知”，不是明确失败。
6. 广播后结果未知时，先查 tx 可见性；不能立即复用 UTXO 重发。
7. 协议资产 splicing-out 需要普通 BTC L1 fee 资金；adapter 内部选择 fee 输入，且不能把通道地址 UTXO 或资产 UTXO 当普通 fee 输入。
8. BRC20 / Runes 在聪网上可以由 `Value=0` 的 UTXO 携带；Agent 不能套用 BTC L1 dust 规则。
9. ORDX 必然绑定聪，应按 `bindingSat` 判断所需 sats。
10. 旧通道不能继续普通运行时，不应为了节省 opening fee 强行 `reopen`；Agent 可以选择 ordinary `open` 重新建立安全边界，再用 `expand` 纳管通道地址中仍属于用户的资产。

## 文档和 skill 的落地要求

后续文档和 skill 的重点是让 Agent 实际证明安全：

1. 接入指南必须要求客户端保存 commitment、revoked state、punish material 和 pending reservation。
2. Agent skill 必须把 `stp.safety_snapshot` 作为价值移动前置门。
3. PWA adapter 必须把私钥、助记词、WASM 和通道数据库留在钱包安全边界内。
4. Agent 操作必须返回 txid、reservation、commit height、safety status、punish coverage 和下一步建议。
5. 真实测试网证据应作为白皮书的一部分，说明 STP 的安全机制不是理论描述，而是可被 Agent 操作和验证的流程。