Topo 开发者文档
Topo 开发者文档面向生态合作方、DApp 团队、技术评审方和交付团队，说明如何在 Topo 链上设计可信 DApp，并把真实业务贡献接入 POC 贡献到 power 的周期性清算机制。
这套文档把业务白皮书、POC 机制说明、开发者架构、参考案例和上线清单放在同一个阅读路径中。读者可以先理解 Topo DApp 的可信闭环，再进入合约、后端、事件同步、POC 结算和上线治理细节。
文档定位
Topo DApp 的核心目标不是把所有业务逻辑都放到链上，而是让影响资产、权限、状态、贡献和权重的关键事实具备可验证、可审计、可组合的边界。
本文档集重点回答四个问题：
- DApp 的哪些事实应该由 Topo 链保护。
- 链下服务如何提供体验、查询、风控和对账，而不替代链上事实。
- DApp 贡献如何通过可信路径进入 POC，并在周期结算后成为 PowerStore 中的 committed power。
- 一个生产级 DApp 在合约、后端、前端、事件消费者、测试和上线阶段需要满足哪些工程要求。
适用读者
| 读者 | 关心的问题 | 建议入口 |
|---|---|---|
| 生态合作方和业务方 | Topo DApp 的业务价值、合作接入方式和验收边界 | 生态合作与 POC 接入白皮书 |
| DApp 产品和技术负责人 | 如何把业务事实映射为链上状态、可信事件和 POC 贡献 | 生态合作与 POC 接入白皮书、开发者架构指南 |
| 合约、后端、前端和消费者开发者 | Move 合约、signed transaction、事件同步、读模型和 POC 发放如何分工 | 开发者架构指南 |
| 技术评审方和治理参与方 | POC 为什么可信，链下计算如何审计，PowerStore 如何成为最终承诺 | POC 机制、合约与架构白皮书 |
| 交易型 DApp 团队 | 支付、履约、退款、结算和贡献成熟如何接入 Topo 与 POC | Web3 商城接入参考方案 |
| 安全、测试、运维和交付团队 | 上线前要验证哪些安全、测试、监控和对账项 | 安全、测试、可观测性与上线清单 |
推荐阅读路径
-
Topo 链 DApp 生态合作与 POC 接入白皮书
先理解 Topo DApp 的可信闭环、核心概念、推荐架构、合作接入路径和验收清单。 -
POC 机制、合约与架构白皮书
再理解 ContributionEvent、Registry、PowerStore、价格快照、周期结算、信任边界和故障恢复。 -
Topo DApp 开发者架构指南
进入工程实现层，设计合约模块、状态机、事件契约、signed transaction 入口、消费者和读模型。 -
Web3 商城接入参考方案
用交易型 DApp 案例理解支付、履约、结算、贡献发放和退款路径如何落地。 -
安全、测试、可观测性与上线清单
上线前检查安全基线、测试矩阵、监控指标、对账视图、反模式和发布顺序。
核心边界
| 边界 | 对外口径 |
|---|---|
| 链上事实边界 | 资产、权限、关键状态机、可信事件和最终 power 承诺应由链上合约保护 |
| 链下服务边界 | 后端、消费者、搜索和读模型负责体验、查询、风控和对账，不覆盖链上事实 |
| DApp 贡献边界 | 支付成功、前端积分、本地日志和普通事件不能直接等同于 POC power |
| POC 可信边界 | POC 只认可可信路径产生的 ContributionEvent，并通过周期结算写入 PowerStore |
| Power 生效边界 | staged power 是下一周期写入结果；committed power 才是当前周期可读取、可组合的生效权重 |
一句话总览
DApp 真实业务行为
-> 链上状态和可信事件
-> DApp equity token 发放
-> POC ContributionEvent
-> 周期价格、权重和历史状态结算
-> PowerStore committed power
-> 治理、激励、权益或其他生态模块使用