跳到主要内容

面向应用开发者

发布一个你真正拥有的网站或应用 —— 作为你自己的链上资产铸造出来,而不是租来的。构建与预览完全免费;只有在发布时才需要支付少量统一 $DIG 价格,文件在你的浏览器中加密,因此任何主机都无法读取它们。

心智模型

store 是你网站的永久身份 —— 一个由你掌控的链上 singleton。每次发布时,你都会铸造一个不可变的 capsule = storeId:rootHash。一个 store 只是你随时间发布的一系列 capsule 的集合。

有两个入口通向同一个免费构建 → 付费发布的流程:

搭建脚手架、构建和预览完全免费。你只有在发布一个 capsule 时才需要付费。

你在做什么费用
搭建脚手架、构建、预览草稿免费
发布你的第一个 capsule(铸造一个 store)以 $DIG 计价的统一 capsule 价格 + 少量 XCH 手续费
发布每一次更新(一个新的 capsule)以 $DIG 计价的统一 capsule 价格 + 少量 XCH 手续费

从这里开始

从网页发布 —— DIGHUb

在 DIGHUb 中新建一个 store ↗。放入你构建好的站点(你的 dist/build/ 文件夹),在真实读取路径上获得免费的草稿预览,只在发布这一步才需要连接钱包。参见快速开始 → 从网页发布中的网页流程演示。

从 CLI 发布 —— digstore

这是 Git 形态的流程:newdevinitcommit

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

CLI 快速入门 · 完整的项目工作流

搭建应用脚手架 —— 5 种模板

从一个可运行、已接入钱包的初始项目开始 —— staticvite-reactnext-staticnft-dropdapp-window-chia —— 通过 digstore new <template>npm create dig-app 均可创建。

搭建应用脚手架

使用 digstore dev 免费预览

digstore dev 会通过真实的 DIG 读取路径(加密 → 编译 → 验证 → 解密)为你的项目提供服务,支持热重载,并注入一个开发用的 window.chia。你看到的就是访客将会看到的效果 —— 而且不会铸造任何内容,也不会有任何花费。

CLI 快速入门 → 开发与预览

dig.toml —— 可提交的清单文件

项目根目录下的 dig.toml 保存 store-idoutput-dirbuild-commandremote 及其他配置 —— 由 digstore devdigstore 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 防护,使字节完全相同的构建不做任何操作(不产生花费)。

从 GitHub Actions 部署

添加一个 *.on.dig.net 网址(可选)

你的 store 一经确认即可通过其 URN / chia:// 地址访问 —— 无需额外花费。一个人类友好的 <name>.on.dig.net handle 是在此基础上,于 DIGHUb 中进行的可选付费注册。

我可以使用自己的域名吗?


深入了解:协议

上面这套用大白话讲解的模型,已经足够让你完成发布。当你想了解完整设计时: