> 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/quickstart.md).

# 开发者快速开始

本文给出开发者进入 SAT20 / 聪网生态的最短路径。

## 先选择一个可运行目标

| 目标                      | 指南                                                                           |
| ----------------------- | ---------------------------------------------------------------------------- |
| 理解 EVM 开发者预览            | [EVM 开发者预览](/kai-fa-zhe-zhong-xin/evm-quickstart.md)                         |
| 查看 EVM 样本合约             | [EVM 样本合约](/kai-fa-zhe-zhong-xin/evm-sample-contracts.md)                    |
| 搭建社区 DEX / DAO          | [社区 DEX / DAO Quickstart](/kai-fa-zhe-zhong-xin/community-dex-quickstart.md) |
| 部署社区 DAO                | [DAO Quickstart](/kai-fa-zhe-zhong-xin/dao-quickstart.md)                    |
| 部署 AMM 池                | [AMM Pool Quickstart](/kai-fa-zhe-zhong-xin/amm-pool-quickstart.md)          |
| 部署 Launchpad            | [Launchpad Quickstart](/kai-fa-zhe-zhong-xin/launchpad-quickstart.md)        |
| 部署限价单模块                 | [Limit Order Quickstart](/kai-fa-zhe-zhong-xin/limit-order-quickstart.md)    |
| 运行核心节点、Indexer、Explorer | [基础设施 Quickstart](/kai-fa-zhe-zhong-xin/infrastructure-quickstart.md)        |
| 集成 Wallet SDK           | [Wallet SDK Quickstart](/kai-fa-zhe-zhong-xin/wallet-sdk-quickstart.md)      |
| 搭建白标 DEX                | [White-label DEX](/kai-fa-zhe-zhong-xin/white-label-dex.md)                  |
| 构建 SatoshiNet AI Agent  | [AI Agent Quickstart](/kai-fa-zhe-zhong-xin/ai-agent-quickstart.md)          |
| 查看合约模板状态                | [合约模板目录](/kai-fa-zhe-zhong-xin/contract-template-catalog.md)                 |
| 集成钱包或交易平台               | [交易平台与钱包接入](/kai-fa-zhe-zhong-xin/exchange-and-wallet.md)                    |

带状态标签的页面表示内容仍在规划或对应系统仍在开发。未达到可运行标准前，页面会保留状态说明和待补清单。

## 选择你要构建什么

| 你要构建           | 起点                                            |
| -------------- | --------------------------------------------- |
| STP 钱包或客户端     | `sat20-agent-wallet` skill 与 adapter contract |
| Indexer / 数据服务 | L1/L2 indexer、资产事实层和多协议资产状态                   |
| 聪网应用           | 智能合约文档与测试网                                    |
| 交易平台接入         | Indexer、STP 状态和充值提现流程                         |
| AI Agent       | SAT20 Agent Wallet skill、PWA adapter、安全验证矩阵   |
| 区块浏览器或数据服务     | L1/L2 indexer 和交易状态模型                         |

## 安装钱包与 Agent Skill

面向普通用户和主网场景，先安装并初始化 SAT20 PWA Wallet，再安装 SAT20 Agent Wallet skill。PWA 钱包是私钥、助记词、签名、授权弹窗和通道数据库的安全边界；skill 是 Agent 的操作知识和工作流。

安装 SAT20 PWA Wallet：

```
https://sat20.org/pwa/?install=1
```

在 PWA 内创建或导入钱包、完成备份并解锁后，再安装 skill：

```bash
curl -fsSL https://raw.githubusercontent.com/sat20-labs/docs/main/ai/sat20-agent-wallet/skills/sat20-agent-wallet/scripts/install.sh | bash
```

安装后，Agent 应通过 `SAT20_ADAPTER_URL` 或 `SAT20_CLIENT_CMD` 调用钱包 adapter。

## 实现一个 Adapter

最小 adapter 应支持：

1. `wallet.status`
2. `stp.status`
3. `stp.safety_snapshot`
4. `stp.open`
5. `stp.splicing_in`
6. `stp.unlock`
7. `stp.lock`
8. `stp.splicing_out`
9. `stp.transaction`

完整契约见 [adapter contract](https://github.com/sat20-labs/docs/blob/main/ai/sat20-agent-wallet/skills/sat20-agent-wallet/references/adapter-contract.md)。

## 接入 Indexer

如果你构建钱包、交易平台、浏览器或 Agent，先阅读 [Indexer 接入与资产事实层](/kai-fa-zhe-zhong-xin/indexer.md)。最小实现应能查询 L1 UTXO 资产、交易确认、花费状态、L2 UTXO、ascend / descend 事件和通道相关状态。

当前接口仍在快速迭代，先使用 [API 源码地图](/kai-fa-zhe-zhong-xin/api-source-map.md) 定位权威源码入口。旧 Swagger 只覆盖早期 ORDX indexer 的一部分接口，不作为当前 SAT20 / 聪网完整 API 文档。

## 测试网验收

开发者至少应在测试网上验证：

1. 打开普通 client-core 通道。
2. splicing-in 一种协议资产。
3. unlock / lock 往返。
4. splicing-out 回 BTC L1。
5. 导出承诺交易。
6. 验证 punish coverage。
7. 处理未知网络结果。
8. 通过 indexer 复核 L1/L2 资产证据链。
9. 部署或调用至少一个测试网智能合约，例如 Prediction，或在 PWA `工具 -> 智能合约` 中测试模板 AMM、模板限价单、EVM `ConstantProductAMM`、EVM `LimitOrderBook`。

验收清单见 [STP 第三方客户端实现验收清单](/xie-yi-yu-an-quan/stp/implementation-checklist.md)。

**页面状态：规划中（Planning）**