不要只是旁观下一个去中心化生态系统的成长。动手参与构建它。
ZooBC 通过网关和 API 开放区块链，而钱包则展示了已经围绕它构建的兑换、支付、应用、通信、存储、商业工具和基础设施控制等功能。
为什么是这个象征？
河狸把原材料变成可用的环境。它代表那些把协议转化为工具、桥梁、应用以及人们可以使用的场所的开发者和产品团队。
基于真实存在的协议进行构建，包括它的棘手之处。
ZooBC 提供了广泛的交易和应用接口，但集成工作要从确切的传输层行为开始：哪个服务接收请求，哪些字段属于签名信封，哪些金额以原子单位表示，手续费如何计算，以及哪种结果才能证明成功。
选择正确的服务
/api/v1/ 下的链读取请求可能由归档历史提供。交易 POST 请求必须到达全节点，因为它们需要内存池。部分应用状态路由是节点端点，而不是归档端点。
为签名信封建模
每笔交易都会把一个类型化的主体包装在通用信封中。接收方和备注可能位于信封中，而不在类型主体里。请使用该账户类型所要求的签名方案，对完整的未签名信封进行签名。
保持数值精确
API 金额使用原子单位：1 ZBC 等于 100,000,000 个原子单位。请读取当前的手续费参数，或对确切的交易进行估算，而不要照搬旧界面中的手续费算法。
验证效果
提交成功并不是工作流程的终点。请保留交易标识符，找到它被打包的位置，查看由此产生的资金变动或状态，并区分节点的接收响应与已确认的链状态。
把这些视为技术契约。
大多数集成失败，都源于违反了用户界面所隐藏的某条边界。
| 契约 | 要求的行为 | 常见错误 |
|---|---|---|
| 读取与写入路由 | GET 请求使用可读取的链端点，交易 POST 请求使用全节点的内存池路由。 | 把交易广播到归档历史，并把它的拒绝误解为交易无效。 |
| 原子单位金额 | 以整数原子单位表示 ZBC 和代币数值；代币小数位只在显示时应用。 | 把带小数的显示数值当作传输金额发送。 |
| 手续费计算 | 在公共 TestNet 网关上读取 https://zoobc.network/api/v1/blockchain/fee-params，或针对序列化后的交易使用精确的手续费估算器。 | 硬编码一个已不再匹配交易大小、存储、时长或网络手续费比例的手续费。 |
| 信封与主体 | 序列化通用信封，以及精确的小端序类型化主体和可选修饰符。 | 把接收方、备注、代币 ID 或时间数据放在错误的层级中。 |
| 密钥处理 | 在本地签名，并确保私密材料不出现在 URL、日志、进程列表、分析数据和服务器中。 | 把私钥作为可见的命令行参数或远程表单字段传递。 |
| 状态解读 | 用交易表示已签名的操作，用资金变动或应用状态表示由此产生的协议效果。 | 以为每一笔奖励、退款、解锁释放或应用结果都是一笔新的用户交易。 |
先构建一个可验证的端到端切片。
在设计大型界面之前，先让一次读取、一次签名的 TestNet 操作和一个已确认的结果端到端地跑通。
- 01
证明连接可用
查询区块链状态并保留返回的高度。在创建账户或申请测试币之前，确认目标网络和网关行为。
- 02
选定一种确切的交易类型
阅读它的信封、主体布局、账户类型、手续费行为、修饰符和结果。不要仅仅因为界面看起来相似，就从一种交易格式推断另一种。
- 03
在本地构建并签名
序列化整数原子单位金额，估算确切的手续费，并在签名时不把私钥暴露给服务器、日志、URL、分析事件或 shell 历史记录。
- 04
提交、确认并对账
提交到全节点，保留返回的标识符，通过区块浏览器或 API 找到它被打包的位置，并在报告成功之前查看由此产生的资金变动或应用状态。
只要集成仍可能泄露密钥、混淆显示单位与原子单位、硬编码过时的手续费假设、提交到错误的服务，或把节点接收当作最终确认，就不要从 TestNet 转向涉及真实价值的使用。
使用最贴近该行为的参考资料。
开发者指南解释拓扑结构；API 文档描述路由；手册记录序列化和应用规则；在线工具让你测试完整路径。
让失败清晰可见，让密钥平淡无奇。
一个有用的集成，对状态精确，对攻击者毫无吸引力。
- 将私密签名材料保留在本地，并排除在遥测之外。
- 在整个数据层使用整数原子单位。
- 根据实时协议接口估算手续费。
- 保留交易 ID，并对由此产生的资金变动进行对账。
- 清晰区分不可用、待处理、已拒绝、已打包和已确认等状态。
- 硬编码旧的手续费、高度、节点列表或版本哈希。
- 向只读的归档路由发送写入请求。
- 不读取响应体、不追踪交易，就把 200 响应当作已确认状态的证据。
- 编造未记录在文档中的交易字段或应用行为。
- 把私钥放进查询字符串、日志、截图或支持消息中。
这说的是你吗？
面向开发者、应用团队、协议工程师、测试人员和技术贡献者.
你构建应用、协议、集成、基础设施或开发者工具。
你想测试新兴功能、发现漏洞或改进文档。
你关心开放系统、本地签名、可验证的行为和用户所有权。
你能把技术能力变成其他人真正可以使用的东西。
从一扇真实的门进入。
下面每条路线都通向一个现有的 ZooBC 页面、工具或当前的社区目的地。
跟着证据走。
针对不同问题，使用相应的信息来源，而不是只依赖某一个营销页面。
从兴趣到参与。
- 01阅读技术模型
- 02使用 API 和 TestNet 工具
- 03带来一个构建成果、漏洞报告、测试或技术提案
不要只是旁观下一个去中心化生态系统的成长。动手参与构建它。
ZooBC 通过网关和 API 开放区块链，而钱包则展示了已经围绕它构建的兑换、支付、应用、通信、存储、商业工具和基础设施控制等功能。