开发者文档
从一个网站文件夹,到一个人人可访问的链接。
新应用 · TapeKit 链上发布
准备文件与更新规则
选择构建后的静态网站文件夹,根目录必须有 index.html;文件引用使用相对路径。不能把后端程序、私钥或 .env 放进网站。单文件最多 8,400,000 字节,最多 5,000 条路径;网页会核对翻译与应用图标。 文件以最多 24,000 字节分块上链,资源先写、index.html 最后写,再设置首页回退。更新逐个文件生效,没有整站原子切换;未选择的旧路径继续保留。
谁保管私钥、谁自动签名
主钱包首次通常确认两笔交易:充值手续费、授权文件编辑。随后当前网页使用临时私钥自动签署上传交易。默认授权 24 小时,剩余不足 2 小时会重新授权。预充按官方算法及 X Layer 当前 Gas 费率估算,含余额余量,不是实际总费用。私钥仅保存在当前标签页 sessionStorage,刷新可恢复;关闭后恢复标签页也可能恢复密钥。上传完成后退回余额,退款确认后删除密钥;撤销授权需另签一笔交易。操作员能编辑、删除该容器的网站文件,不能凭此转移主钱包资金或 NFT。
费用、授权与网站启用
容器开通费、网站启用月费和交易 Gas 分开计算;费用以签名前读取的官方合约状态为准。预充余额留给临时钱包支付上传 Gas,并非平台收费;实际使用后可退回剩余金额。预充不足时上传会停止,重新核对文件后可以补充并续传。 充值、操作员授权、容器开通、网站启用和撤销授权是不同交易。首次上传通常只需主钱包确认充值和授权两笔;开通或启用网站时仍需另外确认。启用按当前页面支持的 30 天周期办理,到期需手动续费,不自动扣费。
TapeKit 访问与流量奖励
新应用使用 TapeOut 官方容器、SiteRegistry 文件合约与 DomainBinding 启用记录。处理器必须同时被官方工厂和 FABX 工厂登记;网站管理权跟随电路 NFT,挂单时暂停编辑。 上传并启用后,使用页面提供的 FABX HTTPS 链接访问;网关核对容器身份、启用状态和文件 SHA-256。X Layer 名称格式为 <电路编号>.2.<官方处理器序号>.tape;官方网关形式为 https://<电路编号>-2-<官方处理器序号>.tapekit.org,其可用性由官方维护。 只有经过 FABX 网关且符合现有防刷与奖励规则的访问才计入本平台流量。官方或第三方入口访问不计入;上传网站不会自动开启矿机。原有 DeWEB 与质押加速规则继续适用。
中断、刷新与余额处理
保持上传标签页运行。刷新后切回同一账号、同一容器并重选相同文件夹;页面核对链上已有字节后跳过已完成的块。待确认交易先在交易栏核实,不要重复提交。账号或网络切换会暂停后续自动签名。 上传完成或中止后,都可退回临时钱包余额;退款仅转回该会话绑定的主钱包。退款确认后才删除私钥;失败或待确认时保留密钥。余额不足退款 Gas 时可先备份私钥。撤销操作员授权是独立操作,不代表余额已退回。 关闭标签页后可能失去私钥,浏览器恢复标签页也可能恢复它。不要把关页当作清理;需要离开前先退款,必要时自行安全备份。没有整站历史版本回滚,恢复旧站需重新上传保存好的旧文件。
已有 IPFS 应用
已有 IPFS 应用继续使用原容器、CID 版本绑定、网址和签名上传流程,不会自动迁到 TapeKit,也不使用这次临时钱包自动签名。下面的原发布与更新手册适用于这些旧应用。
已有 IPFS 应用 · 继续使用原发布与更新流程
发布你的第一个应用
跟着四步走;已有网站也可以更新。
先准备这三样
- 持有电路 NFT 的钱包
- 已构建的静态网站文件夹
- 用于链上交易的 OKB
- 01
选择你的电路
连接持有人钱包,选中要发布网站的电路。
未开通容器?先核对费用,再签名开通。
- 02
上传网站文件夹
选择构建产物文件夹,签署一次性上传授权。
平台上传至 IPFS、Pin 并逐文件读回校验。
- 03
预览并确认发布
预览可用时先检查网站,再核对电路、CID 和版本。
钱包确认链上交易后,等待发布成功。
- 04
分享你的应用
复制访问链接,或在 DeWEB 目录找到应用。
访客打开普通 HTTPS 链接,无需钱包或插件。
上传哪个文件夹?
上传构建结果,不是项目源码。
website/
├── index.html
├── deweb-icon.png
└── assets/
├── app.js
├── style.css
└── logo.svgindex.html
入口文件,必须在根目录
脚本、样式和图片可以放子目录
资源引用使用相对路径,例如 ./assets/app.js。
不要上传私钥、服务密钥或 .env 文件。
让应用有自己的图标
在部署页面选择 PNG 图标,平台会预览并校验,再与网站一起上传至 IPFS。也可在网站根目录放置 deweb-icon.png;通过本平台部署时自动写入声明。
PNG · 256 × 256 像素 · 最大 128 KiB · 8-bit RGB/RGBA 静态非交错图片。发布时保存为 deweb-icon.png。
未提供或加载失败时显示默认图标。下方三款示例可下载;现有测试应用暂用对应示例,上传自有图标后优先展示。
图标随 CID 和版本固定。修改图标后需由当前电路 NFT 持有人重新发布并支付链上 gas,不能直接替换已发布版本的文件。
还没有网站?下载 ZIP,解压后选择里面的网站文件夹。
什么时候需要签名、支付 Gas?
- 操作
- 授权上传
- 钱包确认内容
- 消息签名:证明你同意上传这些文件
- 费用
- 无需 Gas
- 操作
- 首次开通容器
- 钱包确认内容
- 链上交易
- 费用
- 合约显示的开通费 + Gas
- 操作
- 发布或重新绑定网站
- 钱包确认内容
- 链上交易
- 费用
- 网络 Gas
只有上传成功还不算发布;必须完成最后的链上确认。
文件、权限和访问分别在哪里?
IPFS 保存文件
HTML、JS、CSS;CID 标识这一份内容。
合约登记绑定
保存 CID、版本与容器关联;NFT 决定发布权。
网关读取网站
按链上 CID 取文件,再返回浏览器。
浏览器运行应用
例如五子棋:棋盘、规则和电脑算法都在本地执行。
访问量如何转换成加速
加速已接入 · 实际生效以链上结算为准
怎么算访问量
奖励访问需先通过当天 Cloudflare Turnstile 验证,再成功打开本平台网关的应用 HTML,缓存命中也计入。同一应用、同一浏览器凭证每个 UTC+8 自然日最多计 1 次。失败、跳过验证、资源请求、刷新、预加载、嵌入页面和可识别自动化不计奖励;其他网关和直接 IPFS 访问不计入。旧观察计数单独保留,不转换为奖励计数。
什么时候更新
自动结算以每天 UTC+8 02:00 为周期边界,使用截至前一天的7天计数。报告上链并应用到活动矿机后才生效,不追溯补发。加成到次日02:00自动失效;结算失败不会延长旧加成。矿机未开启时不会自动开挖。NFT转让后领取收益归当前持有人。总发行曲线不变,加成改变池内分配份额,不承诺固定收益。
加速公式 · reward v1
T 为此前 7 个完整自然日的合格访问总量,S=T÷7;bps=floor(2000×T÷(T+7000)),比例=bps÷100%。缺失日为0,7天7000次对应10.00%。只放大基础权重 b*×P,不放大设计溢价,与 OKB 加成相加。每个矿池原权重为B,申请加成总和为R,实际加成为min(R,floor(B÷20)),各应用按申请权重比例分摊。矿机退出、迁移或权重变化时实时重新缩放,始终不超过当前池原权重5%。实际份额按合约整数精度计算,页面权重向下取整。
T = sum(daily[].eligibleVisits) S = T / 7 bps = floor(2000 × T / (T + 7000)) percent = bps / 100
公开数据与独立复算
应用的 /__fab/reward/summary 公开合格访问逐日计数;/__fab/traffic 保留观察数据。应用ID由链、网站登记合约和容器组成。结算服务先保存不可覆盖的报告,再提交其 Merkle 根及内容哈希;报告含公式版本、域、逐日计数及证明。将公开报告哈希和根与链上 reports(epoch) 核对,再核对 verifiedBoost 和矿池 dewebWeights,可验证输入、公式及链上执行的一致性;无法证明每条网关观察都是真人。
下载复算脚本node verify-deweb-traffic.mjs https://YOUR-APP/
更新、权限与问题排查
按问题展开,不必一次读完。