跳至主要内容

开发者文档

从一个网站文件夹,到一个人人可访问的链接。

新应用 · TapeKit 链上发布

  1. 1.选择官方处理器的电路 NFT,开通 TapeOut 官方容器。
  2. 2.选择静态网站文件夹,核对翻译与图标。单文件最多 8.4 MB。
  3. 3.核对预充金额,主钱包确认充值与 24 小时文件编辑授权;后续分块由临时钱包自动签名。也可取消自动上传,逐笔确认。
  4. 4.启用网站 30 天,再通过应用链接访问;费用以签名前链上读取为准。

准备文件与更新规则

选择构建后的静态网站文件夹,根目录必须有 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
  1. 01

    选择你的电路

    连接持有人钱包,选中要发布网站的电路。

    未开通容器?先核对费用,再签名开通。

  2. 02

    上传网站文件夹

    选择构建产物文件夹,签署一次性上传授权。

    平台上传至 IPFS、Pin 并逐文件读回校验。

  3. 03

    预览并确认发布

    预览可用时先检查网站,再核对电路、CID 和版本。

    钱包确认链上交易后,等待发布成功。

  4. 04

    分享你的应用

    复制访问链接,或在 DeWEB 目录找到应用。

    访客打开普通 HTTPS 链接,无需钱包或插件。

上传哪个文件夹?

上传构建结果,不是项目源码。

示例文件结构
website/
├── index.html
├── deweb-icon.png
└── assets/
    ├── app.js
    ├── style.css
    └── logo.svg

index.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

还没有网站?下载 ZIP,解压后选择里面的网站文件夹。

什么时候需要签名、支付 Gas?

操作
授权上传
钱包确认内容
消息签名:证明你同意上传这些文件
费用
无需 Gas
操作
首次开通容器
钱包确认内容
链上交易
费用
合约显示的开通费 + Gas
操作
发布或重新绑定网站
钱包确认内容
链上交易
费用
网络 Gas

只有上传成功还不算发布;必须完成最后的链上确认。

文件、权限和访问分别在哪里?

IPFS 保存文件

HTML、JS、CSS;CID 标识这一份内容。

合约登记绑定

保存 CID、版本与容器关联;NFT 决定发布权。

网关读取网站

按链上 CID 取文件,再返回浏览器。

浏览器运行应用

例如五子棋:棋盘、规则和电脑算法都在本地执行。

访问量如何转换成加速

加速已接入 · 实际生效以链上结算为准

01

怎么算访问量

奖励访问需先通过当天 Cloudflare Turnstile 验证,再成功打开本平台网关的应用 HTML,缓存命中也计入。同一应用、同一浏览器凭证每个 UTC+8 自然日最多计 1 次。失败、跳过验证、资源请求、刷新、预加载、嵌入页面和可识别自动化不计奖励;其他网关和直接 IPFS 访问不计入。旧观察计数单独保留,不转换为奖励计数。

02

什么时候更新

自动结算以每天 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/ 

更新、权限与问题排查

按问题展开,不必一次读完。