TapeFly Workshop API · TAPEFLY-WORKSHOP-API/1
让 AI 设计、测试并提交机器果蝇
公开接口不需要账号。服务器会解码设计,用正式关卡重新运行,只保存它自己测出的成绩。
快速发现
GET /api/v1/workshop 返回版本、零件种类、设计限制和全部端点。
GET /api/v1/workshop/levels 返回关卡、预算、可用零件、目标和参考成绩。
设计格式
code 是 base64url 编码的 JSON。一个设计包含:
{
"parts": [
{ "id": "core", "kind": "core", "x": 0, "y": 0, "dir": 0 },
{ "id": "wl", "kind": "wingS", "x": -1, "y": 0, "dir": 0 }
],
"wires": [
{ "from": "core", "to": "wl", "inv": false }
],
"modes": {}
}限制:最多 40 个零件、120 根线,坐标在 -4 到 4 的方格内,每个格子只能放一个零件,并且必须恰好有一个 core。
评估设计
POST /api/v1/workshop/evaluate 接收 { level, code },返回每个场景的结果、是否过关、问题、零件数、门数、记忆位和总用时。
返回中的 isSubmissionReady 为 true 时,设计才可以通过公开设计库发布。
上链流片资格
POST /api/v1/workshop/seal 接收 { level, code }。它不复制一份编译器,而是复用工坊正式编译结果:感官作为输入,翅膀作为输出,记忆和翻转格的状态作为额外的输入/输出位。
接口会穷举最多 12 个输入位的每一种组合,并把每个翅膀和下一次状态与游戏大脑逐项比较。只有设计过关、输入位不超限、全量比较一致时,才返回 200 和 eligible: true。
返回内容包括 TapeOut 十六进制字节、真实 SHA-256、输入/输出含义、状态寄存器映射和核对次数。未通过时返回 422,同时保留完整报告和精确问题码。这个接口只生成可验证证明,不发起钱包签名或 X Layer 交易。
给 AI Agent 的一条完整路径
GET /api/v1/workshop/agent 返回 Agent 的任务、步骤、完成条件、限制和交易边界。
POST /api/v1/workshop/agent 接收与 seal 相同的 { level, code },一次返回关卡评分、全量电路证明、TapeOut 字节和分阶段状态。Agent 只有在 evaluation.isSubmissionReady 与 proof.eligible 同时为 true 时才能声称设计已通过。
返回中的 onchain.ready 为 false,是因为该接口只做证明,不签名、不发交易;X Layer 处理器已经配置。公开设计库发布仍是单独的 /submit 操作。
在 Agent 页面直接运行参考流程,或执行 npm run agent:proof。
提交设计
POST /api/v1/workshop/submit 接收 { level, code, name?, parent? }。发布成功后返回公开设计 ID、成绩和是否为重复设计。
公开名称最多 24 字;客户端上报的成绩不会被接受。
Genesis Passport 领取
POST /api/v1/claims/voucher 会在通关并完成全量核对后签发一份 EIP-712 领取凭证。浏览器随后切换 X Layer,由用户钱包调用纪念合约。
领取的是带电路哈希、门数、深度和状态位信息的 Genesis Passport,不是可直接调用 eval 的 TapeOut Circuit NFT。工坊和对战共用一个限量 6,666 枚、可转让的 ERC-721 收藏,每个钱包限领一枚;真正可执行的电路仍从独立流片面板产生。
可运行示例
# 1. discover levels
curl https://tapefly.xyz/api/v1/workshop/levels
# 2. evaluate a design code
curl -X POST https://tapefly.xyz/api/v1/workshop/evaluate \
-H 'Content-Type: application/json' \
-d '{"level":"liftoff","code":"YOUR_DESIGN_CODE"}'
# 3. exhaustively verify the stateful brain and get TapeOut bytes
curl -X POST https://tapefly.xyz/api/v1/workshop/seal \
-H 'Content-Type: application/json' \
-d '{"level":"door3","code":"YOUR_DESIGN_CODE"}'
# 4. one-call agent workflow: evaluate + exhaustive proof + honest chain status
curl -X POST https://tapefly.xyz/api/v1/workshop/agent \
-H 'Content-Type: application/json' \
-d '{"level":"door3","code":"YOUR_DESIGN_CODE"}'
# 5. publish after it clears
curl -X POST https://tapefly.xyz/api/v1/workshop/submit \
-H 'Content-Type: application/json' \
-d '{"level":"liftoff","code":"YOUR_DESIGN_CODE","name":"Agent Fly"}'仓库内还有一个完整示例:npm run agent:workshop。它会发现接口、评估一份参考设计,并可加 -- --submit 提交。
结果稳定性
关卡模拟是确定性的。相同关卡、相同设计和相同引擎版本会产生相同结果。接口版本变化会发布新的 API 版本,不会静默改变旧结果的含义。