跳到主要内容

面向集成开发者

一个完全机器可读的平台 —— OpenAPI/OpenRPC、一套完整分类的错误体系、实时定价、JWKS、逐页 JSON,以及一个类型化的 @dignetwork/dig-sdk —— 让你无需抓取一行人类阅读的文字说明,就能将钱包与已验证的读取能力接入你的应用。

心智模型 —— 两个相互独立的接口平面

  1. 一个 REST 控制平面 —— hub.dig.net/v1,使用 bearer-JWT —— 用于管理 store、域名、团队和 NFT。
  2. 一个与节点无关的 dig JSON-RPC 2.0 读取路径 —— rpc.dig.net —— 用于流式传输已验证的密文

一个钱包接口(CHIP-0002 window.chia)覆盖两种传输方式 —— 注入式(DIG Browser)或 WalletConnect → Sage —— 由 SDK 的 ChiaProvider 统一封装。所有支出都由规范的 CHIP-0035 wasm 构建,并由用户的钱包签名 —— 绝不手工拼装。始终基于稳定的错误码进行分支判断,而不是基于文字说明。

构建一个 dapp —— 端到端

从脚手架到一个具备钱包能力的应用上线,一条完整的线索贯穿始终。

在 Chia 上构建一个 dapp

DIG SDK

@dignetwork/dig-sdk —— ChiaProvider + DigClient + Paywall,以及在 /spend 子路径下重新导出的规范支出构建器。安装方式、子路径与 capabilities()

DIG SDK

连接钱包 —— window.chia

检测已注入的 provider,调用 connect()(按来源逐一授权),并使用 CHIP-0002 方法。

使用 window.chia · 规范文档:window.chia provider

读取已验证的内容 —— DigClient + dig RPC 方法

DigClient 会流式传输密文和包含性证明,并在客户端先验证再解密。需要时也可以直接调用这些方法。

什么是 dig RPC? · 方法列表

流式传输与重组

分块模型、检索键,以及先验证再解密的顺序。

流式传输

构建支出 —— 规范的 CHIP-0035 构建器

构建 → 签名 → 广播的分离流程:wasm 构建支出包(spend bundle),钱包完成签名,由你负责广播。hub 从不手工拼装支出,你也不应该这么做。

构建支出

hub 的 /v1 控制平面

通过 REST 完成认证(JWT / OIDC / 设备配对)、store、域名、分析数据和 webhook。

机器可读接口 查看 OpenAPI 文档。

CI 部署 —— dig-network/deploy-action

各种模式、无密钥 OIDC、结果枚举,以及供下游步骤使用的 --json 输出。

从 GitHub Actions 部署

机器可读接口

/openapi.json/openrpc.json/error-codes.json/llms.txt/knowledge-graph.json —— 无需抓取文字说明即可发现并完成集成。

机器可读接口

错误码 —— 基于错误码进行分支判断

一份统一的参考文档,涵盖 dig RPC、CLI、DIGHUb、dig loader 以及 SDK。

错误码


深入了解:协议