手册

简介

Tape Out 一个电路,它的容器就是你的 API。 TapeAPI 是 BNB Chain 上 TapeOut 生态的服务与通信层: DeWEB 是网站,TapeSend 是消息,TapeAPI 是服务。

今天的 API 等于一个网址、一个账号,再加上信任。TapeAPI 用链上身份取代账号,用任何人都能核对的签名取代信任:

  • 服务就是电路。 谁持有电路 NFT,谁就拥有这个服务。转让 NFT,服务随之转移。
  • 每个回答都有签名,并与你的请求绑定。 客户端用电路持有者在链上授权的密钥核对签名。被篡改、被重放或没有签名的回答一律报错,绝不会当作结果返回。
  • 无需注册,没有 API 密钥。 免费方法直接调用。付费方法使用链下凭证,批量在链上结算。没有强制协议费:默认从提供者的所得中划出 1% 作为维护贡献,任何提供者都可以把它设为 0。今天没有任何调用收费,托管合约还没有部署。
  • 容器之间可以私密通信。 容器之间的端到端加密通道与群聊,由中继或链本身承载。

工作原理

  1. 身份。 提供者在 TapeOut 上 Tape Out 一个电路。电路的容器(一个 ERC-6551 账户)就是服务的地址。
  2. 清单。 提供者把 .well-known/tapeapi.json 写进容器的站点:端点、方法、价格、签名密钥,以及持有者对该密钥的 EIP-712 委托。
  3. 解析。 客户端通过多个必须一致的 RPC 节点从链上读取清单,核对其哈希,并对照电路当前的持有者核对委托。
  4. 调用。 客户端发出请求;服务用被委托的密钥签名回答,签名与这次请求绑定。SDK 只在核对通过后才返回结果。

选择你的路径

我想要阅读
现在就免费读取有签名的 BNB Chain 数据,或使用公共中继公共 API
给 Claude、Cursor 或其他 MCP 客户端提供有签名的工具MCP
在应用里调用 TapeAPI 服务调用服务
把我的代码或现有 API 变成服务运行服务
在容器之间发送加密消息私密通道
让 AI 代理安全地使用服务AI 代理
让一个容器凭签名授权书替另一个容器办事(实验性)容器代理
排查错误常见问题
查极限参数、费用、隐私、路线图或规范索引参考

状态

最新发布的版本是 3.0.0(2026-11-06)。遵循语义化版本:按 3.0 文档写的代码在所有 3.x 版本里都能继续工作(按 2.0 文档写的代码在所有 2.x 版本里同样如此),破坏性修改只在新的大版本里出现。 2.0 默认按 TapeOut 官方 TAP(TAP-10、TAP-11 §2)解析服务,有一个已知例外;2.0.0 发布后 1.x 继续获得 6 个月的安全修复(升级到 2.0;1.0 承诺什么)。免费层运行在 TapeOut 已部署的合约之上。我们自己的合约未经第三方审计;付费调用的托管合约尚未部署。TAPI-20 到 TAPI-27 是 TapeAPI 自己的规范,不是 TAP:TAP 由 TapeOutProtocol/TAPs 的编辑编号,其中我们的 7 份草稿已合并为 Draft(TAP-11、TAP-13、TAP-14、TAP-15、TAP-16、TAP-17、TAP-18;合并不等于被采纳),另有 7 份已提交(评审中),没有编号。

链上地址

BNB Smart Chain,chainId 56。

合约地址所有者
DeWebHub0xe61A9C7213a6Aa616C246a2B569e555B417b25eeTapeOut
SiteRegistry0xd006ffdd5Ae313B17729621A00999cD3C71CE5e6TapeOut
处理器工厂0x68224F668083c29e9800Be2a646d42d18cedF7e2TapeOut
BEM 代币0x5ce033b2bfca3af30b3e8c8457deaf776a8b695aTapeOut
ChannelBus0x486110c35d9b90a9d6D85c8063A065f9e7b6b707TapeAPI:无所有者、无状态、不可升级
TapeAPIEscrow、ServiceDirectory未部署TapeAPI

公共服务

由本项目运行的免费 TapeAPI 服务,各自对应处理器 1013(0xe02c26c7432A7121168AA9B610DE24eCf9a1a414)上的一个电路。它们是服务,不是合约;见公共 API。

服务身份容器网址
公共 API(8 个读取方法)11.1013.tape0x1b2A657BcBa9D3229f57aC2f4FcbEE2AA756aAe8https://api.tapeapi.fun
公共中继(relaySend、relayHandshake、relayRecv)12.1013.tape0x9cD838625251576c199B2DeF7A17e50266843185https://relay.tapeapi.fun

公共 API 的方法也以 MCP 工具的形式提供,地址是 https://api.tapeapi.fun/mcp,适用于 Claude、Cursor 和任何 MCP 客户端。每个结果都有签名,并附带任何人都能核验的回执;见 MCP。

规范

协议以 TapeAPI 自己的规范(TAPI)写成,中英双语(以英文为准),采用 CC0。这些规范不是 TAP。我们就其中部分内容向 TapeOutProtocol/TAPs 提交了 14 份 TAP 草稿(8 份在 2026-09-30 至 10-01,2 份关于容器代理格式,在 2026-10-04 与 10-05,2 份在 2026-10-08,2 份在 2026-10-13):7 份已合并为 Draft(合并不等于被采纳):服务身份与清单 TAP-11(#8,2026-10-01)、签名响应 TAP-13(#10,2026-10-04),以及 2026-11-03 合并的私密通道 TAP-14(#12)、MCP 工具作为服务方法 TAP-15(#16)、多家交叉验证读取 TAP-16(#18)、AI 用量回执 TAP-17(#26)、容器代理授权书与任务消息(阶段 0)TAP-18(#47);另 7 份已提交(评审中):#20、#28、#49、#52、#54、#59、#60(#60 目前转为 draft PR)。另有 1 份 Information 草稿 #61(隐私地图),已提交(评审中)。TAPI-20 至 TAPI-27(含 TAPI-26、TAPI-27 的第 2 版)仍是兼容承诺的依据。

规范标题
TAPI-20服务身份与清单
TAPI-21签名响应信封
TAPI-22计量支付
TAPI-23带证明的跨链读取
TAPI-24意图询价(已撤回)
TAPI-25可由电路验证的方法
TAPI-26私密通道
TAPI-27私密群聊

源代码、示例和一致性测试套件都在 GitHub 上。

致谢

为 TapeOut 做一个服务层的想法来自 @Theairresearch。 TapeAPI 的收入自 2026-10-05 起,按季度扣除第三方现金成本后,余额的 10% 永久归他们(口径见 BUSINESS.md)。

在 GitHub 上编辑此页