跳到主要内容

API 源码参考

以下是 src/worker.ts 中的 HTTP 路由。路径中的 :id 传入项目的 agentId, 不是 E2B 返回的底层 sandbox ID。本文不提供生产 base URL。

方法路径输入 / 结果
GET/health状态与时间戳
POST/api/v1/sandboxes创建;必填 agentIdwalletAddress;成功 201
GET/api/v1/sandboxes可选 statechainStatusagentName 查询;返回 sandboxestotal
GET/api/v1/sandboxes/:id查询详情;不存在返回 404
POST/api/v1/sandboxes/:id/pause暂停
POST/api/v1/sandboxes/:id/resume恢复
POST/api/v1/sandboxes/:id/renew可选 JSON timeoutMs
DELETE/api/v1/sandboxes/:id发起销毁;202
POST/api/v1/sandboxes/:id/exec必填 command,可选 timeoutMs
GET/api/v1/sandboxes/:id/logslogs
GET/api/v1/sandboxes/:id/eventsevents

请求语义

创建接口还读取 agentNametokenAddressgenome。 当前实现也接受私钥字段,但公开示例不应填入任何真实钱包秘密; 该设计需要完成凭据与资源权限审查后才能用于生产集成。

执行接口缺少 command 返回 400。当前顶层错误处理会返回 500 和错误消息, 客户端应处理非成功状态,而不是假设所有失败都是支付不足。

x402 范围

X402_PAY_TO 非空时,Worker 对创建和续期的 POST 请求应用 x402 中间件。 为空时这两个接口直接进入业务处理,因此不能把缺省配置当作“支付已强制开启”。

支付挑战、网络、资产和金额以所配置部署的实际响应为准。 不要把代码里的说明文字“1 USDT”当作已经确认的跨网络价格合同。

两个入口的差异

src/api.ts 是另一个 API 构造入口,包含 /api/v1/transactions; 当前 Worker 入口没有挂载该路由。选择入口时须核对实际路由与中间件, 不能把一个文件中的功能视为所有部署都支持。