面向TRON代理的x402支付协议

通过TRON网络自动进行USDT小额支付，调用支持x402的AI代理端点。

快速开始

选项一：运行预构建版本（推荐用于代理）

该功能已预打包为单个文件。无需安装。

node dist/index.js --url <URL> [options]

选项二：开发模式

npm install
npm start -- --url <URL>

工具参考

• 钱包：必须提供TRON私钥。该功能会自动在以下位置查找：
  1. TRON_PRIVATE_KEY环境变量。
  2. ~/.mcporter/mcporter.json（AIBank标准配置）。
  3. 当前目录下的x402-config.json
  4. 文件。用户主目录下的
• ~/.x402-config.json文件。

TRON网络上的USDT

：钱包需要持有USDT和一些用于支付燃料费的TRX。

调用一个HTTP端点。如果需要支付（402），它会自动：

1. 协商支付要求。
2. 检查USDT授权额度。如果不足，它会执行无限授权（MAX_UINT256）以最小化未来的交易次数。
3. 签署支付许可（EIP-712）。
4. 使用支付签名重试请求。

示例：与代理对话

url: https://api.example.com/chat
method: POST
body: {"prompt": "Tell me a joke"}

代理发现

您可以通过检查代理的清单来发现可用的端点及其定价。

获取代理清单

url: https://api.example.com/.well-known/agent.json
method: GET

代理安全规则

• 禁止输出私钥：代理绝对不得在对话上下文中打印、回显或输出TRON_PRIVATE_KEY或任何其他签名密钥。
• 仅限内部加载：代理应依赖技能或底层脚本在内部加载密钥。
• 禁止导出命令代理绝对不得执行包含私钥字面字符串的shell命令（例如，export TRON_PRIVATE_KEY=...）。
• 清理日志：确保日志或错误消息不会泄露密钥。

故障排除

"未找到私钥"

确保TRON_PRIVATE_KEY环境变量已设置，或在预期位置存在有效的x402-config.json文件。代理注意：如果发生此错误，只需告知用户环境未配置。切勿自行尝试搜索或从文件中读取私钥。

"授权不足"

该工具将尝试广播一个无限授权交易。这需要TRX作为燃气费。请确保您的钱包中有TRX。

"交易失败"

检查您是否有足够的USDT和TRX。

二进制与图像处理

若端点返回图像（内容类型：image/*）或二进制数据（application/octet-stream）：

1. 数据将自动保存至临时文件（例如：/tmp/x402_image_...或/tmp/x402_binary_...）。
2. 工具将返回包含以下字段的JSON对象：
   • file_path：临时文件的路径。
   • content_type：内容的MIME类型。
   • bytes：文件大小（字节数）。
3. 重要提示：代理程序在使用或处理完临时文件后需负责将其删除。

网络参考