> 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/kai-fa-zhe-zhong-xin/exchange-and-wallet.md).

# 交易平台与钱包接入

交易平台和钱包是聪网生态的重要入口。它们需要的不只是转账接口，还需要能解释资产处于 BTC L1、通道、聪网个人地址、合约或 pending 状态中的哪一种。

对交易平台和钱包来说，indexer 是资产事实层。充值、提现、splicing、unlock、lock、余额展示和风控都必须建立在 L1/L2 indexer 可复核的 txid、vout、资产协议、确认数和通道状态之上。

## 接入目标

| 角色      | 目标                          |
| ------- | --------------------------- |
| 钱包      | 管理私钥、授权、签名、通道状态和用户安全提示      |
| 交易平台    | 支持充值、提现、资产识别、确认数和异常处理       |
| Indexer | 提供 L1/L2 资产、交易、UTXO、通道和合约状态 |
| Agent   | 读取证据，解释风险，调用钱包 adapter      |

## 钱包必须保护什么

钱包必须保护：

1. 助记词和私钥。
2. 通道数据库。
3. 最新承诺交易。
4. 已撤销状态的惩罚材料。
5. 未完成 reservation。
6. 用户授权记录。

Agent 不直接接触这些秘密材料。

## 交易平台必须理解什么

交易平台接入聪网时，应区分：

1. BTC L1 确认。
2. 聪网 L2 确认。
3. STP 通道状态。
4. anchor / deAnchor 状态。
5. 资产是否可花费。
6. 是否存在 pending 操作。

如果只看余额，不看状态，容易在跨层过程中产生错误判断。

如果只看单个 indexer 响应，不看 txid、vout、确认数、reorg、mempool 和跨层对应关系，也容易产生错误判断。关键资产移动应保留可复核证据。

## 推荐接口

1. L1 / L2 地址 summary。
2. 交易详情。
3. UTXO 资产详情。
4. channel ledger。
5. anchor / deAnchor 记录。
6. STP transaction / reservation 查询。
7. safety snapshot。
8. reorg / mempool / not indexed 状态。

后续交易平台接入文档会在此基础上继续拆分为充值、提现、风控、对账和异常恢复章节。