spraay-payments：AI Agent 工具实践指南

面对实际交付，我看spraay-payments的重点不在星标，而在这项能力：为 OpenClaw 代理启用多链批量加密支付、工资、掉期、发票、价格反馈和 AI- 支持的交易工具。这类市场与研究工具真正难在数据时效、指标口径和风险解释容易混在一起，仓库说明只能作为第一层证据。与其反复读介绍，不如用一只熟悉标的回放一段历史区间，再依据数据来源、计算口径、风险提示和结果可追溯性做取舍。对需要辅助研究而非自动替代决策的使用者来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

名称： 喷雾支付 描述：“使用 Spraay Protocol x402 网关发送批量加密付款、工资单、发票、代币交换、价格反馈和 AI 推理。当用户要求‘发送付款’、‘批量’、‘支付多个资产账户’、‘加密工资单’、‘交换代币’、‘获取代币价格’、‘创建发票’、‘检查余额’时使用， 'resolve ENS'、'resolve basename'，或提及Spraay、x402支付或多链批量交易支持11条链：Base、Ethereum、Arbitrum、Polygon、BNB、Avalanche、Solana、Unichain、Plasma、BOB、Bittensor。 版本：1.0.0 主页：https://spraay.app 元数据：{"openclaw":{"emoji":"","requires":{"bins":["curl","jq"],"env":["SPRAAY_GATEWAY_URL"]},"primaryEnv":"SPRAAY_GATEWAY_URL"}}

喷雾付款

多链批量加密支付、工资、掉期、价格反馈、发票和 AI 推理 — 全部通过一个 API 完成。

Spraay 是一种在单笔交易中将加密货币发送到多个资产账户的协议。 x402 网关公开 57 个付费端点和 5 个免费端点。每次付费通话都需要通过 x402 HTTP 支付协议进行小额支付。免费端点无需付费。

设置

网关位于 https://gateway.spraay.app。设置你的环境：

export SPRAAY_GATEWAY_URL="https://gateway.spraay.app"

不需要 API 密钥。通过 x402 按请求进行付款（HTTP 402 → 付款 → 重试）。如果您有 Coinbase CDP 资产账户或任何 x402 兼容的服务商，您的代理资产账户会自动处理此问题。

支持的链条

Base、以太坊、Arbitrum、Polygon、BNB 链、Avalanche、Solana、Unichain、Plasma、BOB、Bittensor。

支付合约（基础）：0x1646452F98E36A3c9Cfc3eDD8868221E207B5eEC

Core Workflows

1. 批量支付（主要用例）

在一笔交易中将代币发送到多个资产账户。

curl -X POST "$SPRAAY_GATEWAY_URL/api/batch-payment" 
  -H "Content-Type: application/json" 
  -d '{
    "recipients": [
      {"address": "0xABC...123", "amount": "10"},
      {"address": "0xDEF...456", "amount": "25"},
      {"address": "0xGHI...789", "amount": "15"}
    ],
    "token": "USDC",
    "chain": "base"
  }'

如果您收到 HTTP 402，则响应包含付款说明。向服务商付款，然后使用付款证明标头重试。

2. 代币价格

# Free endpoint — no x402 payment needed
curl "$SPRAAY_GATEWAY_URL/api/price?symbol=ETH"

返回当前 USD 价格。适用于任何主要代币符号。

3. 代币余额

curl "$SPRAAY_GATEWAY_URL/api/balance?address=0xABC...&chain=base"

4. 代币互换

curl -X POST "$SPRAAY_GATEWAY_URL/api/swap-quote" 
  -H "Content-Type: application/json" 
  -d '{
    "tokenIn": "ETH",
    "tokenOut": "USDC",
    "amount": "1.0",
    "chain": "base"
  }'

5. ENS / 基本名称解析

# Free endpoint
curl "$SPRAAY_GATEWAY_URL/api/resolve?name=vitalik.eth"

将 ENS 名称和基本名称解析为地址。

6. 发票

curl -X POST "$SPRAAY_GATEWAY_URL/api/create-invoice" 
  -H "Content-Type: application/json" 
  -d '{
    "recipient": "0xABC...123",
    "amount": "500",
    "token": "USDC",
    "chain": "base",
    "memo": "March consulting invoice"
  }'

7. AI 聊天推断

curl -X POST "$SPRAAY_GATEWAY_URL/api/ai/ch@t" 
  -H "Content-Type: application/json" 
  -d '{
    "message": "Explain DeFi yield farming",
    "model": "openrouter/auto"
  }'

由 OpenRouter 提供支持。通过 x402 按查询付费。

8. 薪资

curl -X POST "$SPRAAY_GATEWAY_URL/api/batch-payment" 
  -H "Content-Type: application/json" 
  -d '{
    "recipients": [
      {"address": "alice.eth", "amount": "3000"},
      {"address": "bob.base", "amount": "2500"},
      {"address": "0xCCC...999", "amount": "4000"}
    ],
    "token": "USDC",
    "chain": "base",
    "memo": "March 2026 payroll"
  }'

ENS 和基本名称地址自动解析。

通信端点（付费）

电子邮件

curl -X POST "$SPRAAY_GATEWAY_URL/api/email/send" 
  -H "Content-Type: application/json" 
  -d '{
    "to": "[email protected]",
    "subject": "Payment Confirmation",
    "body": "Batch payment of 50,000 USDC sent to 12 recipients on Base."
  }'

XMTP 消息传递

curl -X POST "$SPRAAY_GATEWAY_URL/api/xmtp/send" 
  -H "Content-Type: application/json" 
  -d '{
    "to": "0xRecipient...",
    "message": "Your payment of 500 USDC has been sent via Spraay."
  }'

网络钩子

curl -X POST "$SPRAAY_GATEWAY_URL/api/webhook/send" 
  -H "Content-Type: application/json" 
  -d '{
    "url": "https://your-app.com/webhook",
    "payload": {"event": "payment_complete", "txHash": "0x..."}
  }'

基础设施端点（付费）

RPC 继电器（通过 Alchemy 的 7 条链）

curl -X POST "$SPRAAY_GATEWAY_URL/api/rpc/relay" 
  -H "Content-Type: application/json" 
  -d '{
    "chain": "base",
    "method": "eth_blockNumber",
    "params": []
  }'

IPFS 上传（通过 Pinata）

curl -X POST "$SPRAAY_GATEWAY_URL/api/ipfs/pin" 
  -H "Content-Type: application/json" 
  -d '{
    "content": "Hello from Spraay!",
    "name": "my-file.txt"
  }'

免费端点（无需付款）

这 5 个端点无需 x402 付款即可工作：

• GET /api/price?symbol=ETH — 代币价格
• GET /api/resolve?name=vitalik.eth — ENS/Basename 分辨率
• GET /api/health — 网关健康检查
• GET /api/chains — 列出支持的链
• GET /api/endpoints — 列出所有可用端点

x402 支付流程

1. 呼叫任意付费端点
2. 接收 HTTP 402 以及付款详细信息（金额、服务商地址、代币）
3. 向协调员发送小额付款
4. 使用包含付款证明的 X-PAYMENT 标头重试原始请求
5. 收到您的回复

每次调用的典型成本：Base 上 USDC 的几分之一。

错误处理

• 402 — 需要付款。按照响应正文中的付款说明进行操作。
• 400 — 错误请求。检查你的参数。
• 404 — 未找到端点。
• 500 — 服务器错误。稍后重试。

在处理响应正文之前，请务必检查 HTTP 状态代码。

温馨提示

• 与单独相比，批量支付可节省 60-80% 的 Gas 费。
• 在发送之前使用免费的 /api/price 端点计算 USD 值。
• 在批处理之前解析 ENS/Basenames 以验证所有地址。
• 如果未指定，链默认为“base”。
• 如果未指定，令牌默认为“USDC”。
• 该网关支持任何 ERC-20 令牌以及本机 ETH。

友情链接

• 应用程序：https://spraay.app
• 网关：https://gateway.spraay.app
• 文件：https://docs.spraay.app
• GitHub: https://github.com/plagtech
• X 平台：https://twitter.com/Spraay_app
• MCP 服务器：https://smithery.ai/server/@plagtech/spraay-x402-mcp