开发者快速开始

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

先选择一个可运行目标

目标	指南
理解 EVM 开发者预览	EVM 开发者预览
查看 EVM 样本合约	EVM 样本合约
搭建社区 DEX / DAO	社区 DEX / DAO Quickstart
部署社区 DAO	DAO Quickstart
部署 AMM 池	AMM Pool Quickstart
部署 Launchpad	Launchpad Quickstart
部署限价单模块	Limit Order Quickstart
运行核心节点、Indexer、Explorer	基础设施 Quickstart
集成 Wallet SDK	Wallet SDK Quickstart
搭建白标 DEX	White-label DEX
构建 SatoshiNet AI Agent	AI Agent Quickstart
查看合约模板状态	合约模板目录
集成钱包或交易平台	交易平台与钱包接入

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

选择你要构建什么

你要构建	起点
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：

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。

接入 Indexer

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

当前接口仍在快速迭代，先使用 API 源码地图 定位权威源码入口。旧 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 第三方客户端实现验收清单。

页面状态：规划中（Planning）