面向应用开发者
发布一个你真正拥有的网站或应用 —— 作为你自己的链上资产铸造出来,而不是租来的。构建与预览完全免费;只有在发布时才需要支付少量统一 $DIG 价格,文件在你的浏览器中加密,因此任何主机都无法读取它们。
心智模型
store 是你网站的永久身份 —— 一个由你掌控的链上 singleton。每次发布时,你都会铸造一个不可变的 capsule = storeId:rootHash。一个 store 只是你随时间发布的一系列 capsule 的集合。
有两个入口通向同一个免费构建 → 付费发布的流程:
- 网页路径 —— hub.dig.net 上的 DIGHUb:放入一个构建好的文件夹,免费预览,只在发布时连接钱包。
- CLI / CI 路径 ——
digstoreCLI +create-dig-app+ GitHub 部署 Action。
搭建脚手架、构建和预览完全免费。你只有在发布一个 capsule 时才需要付费。
| 你在做什么 | 费用 |
|---|---|
| 搭建脚手架、构建、预览草稿 | 免费 |
| 发布你的第一个 capsule(铸造一个 store) | 以 $DIG 计价的统一 capsule 价格 + 少量 XCH 手续费 |
| 发布每一次更新(一个新的 capsule) | 以 $DIG 计价的统一 capsule 价格 + 少量 XCH 手续费 |
从这里开始
- 快速开始 —— 10 分钟内发布一个站点 —— 最快的路径,网页或 CLI 均可。
从网页发布 —— DIGHUb
在 DIGHUb 中新建一个 store ↗。放入你构建好的站点(你的 dist/ 或 build/ 文件夹),在真实读取路径上获得免费的草稿预览,只在发布这一步才需要连接钱包。参见快速开始 → 从网页发布中的网页流程演示。
从 CLI 发布 —— digstore
这是 Git 形态的流程:new → dev → init → commit。
digstore new vite-react # scaffold a runnable project — free, no mint
digstore dev # preview on the real chia:// read path, live-reload — free
digstore init site --dir dist # mint the store's first capsule (uniform price + XCH fee)
digstore commit -m "v1.1" # publish an update — a new capsule
搭建应用脚手架 —— 5 种模板
从一个可运行、已接入钱包的初始项目开始 —— static、vite-react、next-static、nft-drop 或 dapp-window-chia —— 通过 digstore new <template> 或 npm create dig-app 均可创建。
→ 搭建应用脚手架
使用 digstore dev 免费预览
digstore dev 会通过真实的 DIG 读取路径(加密 → 编译 → 验证 → 解密)为你的项目提供服务,支持热重载,并注入一个开发用的 window.chia。你看到的就是访客将会看到的效果 —— 而且不会铸造任何内容,也不会有任何花费。
dig.toml —— 可提交的清单文件
项目根目录下的 dig.toml 保存 store-id、output-dir、build-command、remote 及其他配置 —— 由 digstore dev、digstore deploy 和脚手架模板共用。它不包含任何机密信息(那些来自环境变量),因此可以提交它。
更新与版本 —— 每次发布都是一个新的 capsule
每一次发布都会将当前构建封装为一个新的不可变 capsule,并推进你 store 的链上根哈希。旧的 capsule 依然可读;除非读取方固定了某个具体的 rootHash,否则该 store 始终解析到其最新版本。
→ 链上锚定
费用一览
构建和预览免费;每发布一个 capsule 需要支付以 $DIG 计价的统一价格,外加少量 XCH 网络手续费 —— 两者原子性地包含在同一笔链上支出中。该价格按 capsule 统一计价,这是有意为之的设计(从而使 capsule 长度不会泄露任何有关你内容的信息)。可在 TibetSwap、dexie.space 或 9mm.pro 上获取 $DIG。
→ 如何获取 DIG · 为什么每个 capsule 价格都一样?
从 GitHub Actions 实现 push-to-deploy
接入 dig-network/deploy-action,让每次推送都发布一个新的 capsule —— 并带有 if-changed 防护,使字节完全相同的构建不做任何操作(不产生花费)。
添加一个 *.on.dig.net 网址(可选)
你的 store 一经确认即可通过其 URN / chia:// 地址访问 —— 无需额外花费。一个人类友好的 <name>.on.dig.net handle 是在此基础上,于 DIGHUb 中进行的可选付费注册。
深入了解:协议
上面这套用大白话讲解的模型,已经足够让你完成发布。当你想了解完整设计时:
- "一个 store 是一系列 capsule 的集合" → 概念与术语表 · capsule 与 store 模型
- "文件在你的浏览器中加密" → URN 与加密
- "统一价格 + 原子性的 $DIG 支出" → 链上锚定 · CHIP-0035 store-coin 支出
- 完整内容 → 协议深度解析