API 源码参考
以下是 src/worker.ts 中的 HTTP 路由。路径中的 :id 传入项目的 agentId,
不是 E2B 返回的底层 sandbox ID。本文不提供生产 base URL。
| 方法 | 路径 | 输入 / 结果 |
|---|---|---|
| GET | /health | 状态与时间戳 |
| POST | /api/v1/sandboxes | 创建;必填 agentId、walletAddress;成功 201 |
| GET | /api/v1/sandboxes | 可选 state、chainStatus、agentName 查 询;返回 sandboxes 和 total |
| 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/logs | logs |
| GET | /api/v1/sandboxes/:id/events | events |
请求语义
创建接口还读取 agentName、tokenAddress 和 genome。
当前实现也接受私钥字段,但公开示例不应填入任何真实钱包秘密;
该设计需要完成凭据与资源权限审查后才能用于生产集成。
执行接口缺少 command 返回 400。当前顶层错误处理会返回 500 和错误消息,
客户端应处理非成功状态,而不是假设所有失败都是支付不足。
x402 范围
当 X402_PAY_TO 非空时,Worker 对创建和续期的 POST 请求应用 x402 中间件。
为空时这两个接口直接进入业务处理,因此不能把缺省配置当作“支付已强制开启”。
支付挑战、网络、资产和金额以所配置部署的实际响应为准。 不要把代码里的说明文字“1 USDT”当作已经确认的跨网络价格合同。
两个入口的差异
src/api.ts 是另一个 API 构造入口,包含 /api/v1/transactions;
当前 Worker 入口没有挂载该路由。选择入口时须核对实际路由与中间件,
不能把一个文件中的功能视为所有部署都支持。