Bankr Agent - Sign & Submit API

签名与提交 API

用于直接签名消息和提交交易的同步端点——无需轮询。

概览

端点	用途	返回内容
POST /agent/sign	签名消息、类型化数据或交易	签名
POST /agent/submit	向链提交原始交易	交易哈希

与 /agent/prompt（异步，需要轮询任务）不同，这些端点会立即返回。

POST /agent/sign

签名数据，但不将其广播到网络。

签名类型

类型	使用场景
personal_sign	签名纯文本消息（身份验证、校验）
eth_signTypedData_v4	签名 EIP-712 类型化数据（许可、订单）
eth_signTransaction	签名交易，以便之后广播

提示词示例

签名消息：

• “签名这条消息：Hello World”
• “使用 nonce abc123 登录 MyApp”

签名类型化数据（EIP-712 许可）：

• “签署这份 USDC 授权的 EIP-712 许可”

签名交易但不广播：

• “签名这笔交易，但不要发送”

成功响应

{
  "success": true,
  "signature": "0x...",
  "signer": "0xYourWalletAddress",
  "signatureType": "personal_sign"
}

常见错误

状态	错误	原因
400	缺少必填字段	缺少 message、typedData 或 transaction
401	需要身份验证	缺少或无效的 API 密钥
403	只读 API 密钥	密钥没有写入权限

POST /agent/submit

直接向区块链提交原始交易。

交易字段

字段	必填	描述
to	是	目标地址
chainId	是	链 ID（8453=Base、1=Ethereum、137=Polygon）
value	否	以 wei 为单位的值（字符串）
data	否	调用数据（十六进制字符串）
gas	否	Gas 限额
waitForConfirmation	否	等待链上确认（默认：true）

提示词示例

提交原始交易：

• “在 Base 上提交这笔交易：{to: 0x..., data: 0x..., value: 0}”

简单 ETH 转账：

• “向 0x... 转账 1 ETH”

成功响应

确认后：

{
  "success": true,
  "transactionHash": "0x...",
  "status": "success",
  "blockNumber": "12345678",
  "gasUsed": "21000",
  "signer": "0xYourWalletAddress",
  "chainId": 8453
}

交易状态值

状态	描述
success	已确认且成功
reverted	已确认但已回滚
pending	已提交，尚未确认

使用场景

• 身份验证：签名消息以验证钱包所有权
• 免 Gas 授权：签名 EIP-2612 许可，无需 Gas
• 预构建交易：提交来自外部工具的调用数据
• 多步工作流：依次执行授权 + 兑换

与 /agent/prompt 的比较

功能	/agent/prompt	/agent/sign	/agent/submit
输入	自然语言	结构化数据	交易对象
响应	异步（任务 ID）	同步（签名）	同步（交易哈希）
在链上执行	通过 AI Agent	否	是
最适用于	一般查询	身份验证、许可	原始交易

安全说明

• /agent/submit 会立即执行，不会提示确认
• 提交前请验证所有交易参数
• 对重要交易使用 waitForConfirmation: true
• 只读 API 密钥无法使用这些端点（403）