AI导哈

加密货币支付网关SDK

AgentGatePay SDK为AI代理和自主系统提供安全的多链加密货币支付网关，支持多种稳定币和实时分析功能。

  • by AgentGatePay
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 AgentGatePay/agentgatepay-sdks

使用说明

AgentGatePay SDK

官方JavaScript/TypeScript和Python SDK AgentGatePay -为人工智能代理和自主系统提供安全的多链加密货币支付网关。

⚠️ 重要免责声明

AgentGatePay目前处于测试阶段。 通过使用此SDK和服务，您确认并接受：

  • 服务可用性： 服务可能随时不可用、暂停或永久关闭，恕不另行通知。没有SLA或正常运行时间保证。
  • 数据丢失风险： 所有数据可能随时丢失，无法恢复。用户全权负责维护独立备份。
  • 无责任： AgentGatePay对任何直接、间接或后果性损害不承担责任，包括丢失加密货币、交易失败、服务中断或收入损失。
  • 财务风险： 区块链交易是不可逆转的。用户全权负责保护私钥、API密钥和遵守法律。
  • 无保修： 此SDK按“原样”提供，不提供任何形式的保证。

📄 阅读全文 免责声明.md 使用前。

使用此SDK即表示您同意这些条款。

概述

AgentGatePay使AI代理能够通过多链支持（以太坊、Base、Polygon、Arbitrum）为稳定币（USDC、USDT、DAI）进行和接受加密货币支付。

主要特点：

  • 🤖 为人工智能代理和自主系统构建
  • 🛡️ AIF（代理交互防火墙） -首个为AI代理构建的防火墙
  • ⛓️ 多链支持（以太坊、Base、Polygon、Arbitrum）
  • 💰 多种稳定币（所有链上使用USDC，大多数链上使用USD T/DAI）
  • 🔐 AP2预算控制支付授权协议
  • 🔌 MCP（模型上下文协议）集成
  • 📊 实时分析和webhooks
  • ⚡ Sub-5秒付款验证

网关委员会： 所有付款收取0.5%的费用

  • 通过双交易模式自动扣除
  • 佣金TX：0.5%→ AgentGatePay钱包（涵盖基础设施成本）
  • 商户TX：99.5%→ 卖家钱包
  • 交易在链上既原子又透明

软件开发工具包

JavaScript/TypeScript SDK

安装：

npm install agentgatepay-sdk

快速入门：

import { AgentGatePay } from 'agentgatepay-sdk';

const client = new AgentGatePay({
  apiKey: 'pk_live_...',
  apiUrl: 'https://api.agentgatepay.com'
});

// Issue a mandate (budget tracks spending in USD equivalent)
const mandate = await client.mandates.issue(
  'my-agent-123',                           // subject
  100.0,                                    // budget in USD (tracks value across USDC/USDT/DAI)
  'resource.read,payment.execute',          // scope
  1440                                      // ttl_minutes
);

// Make a payment (client pays in stablecoins: USDC, USDT, or DAI)
const payment = await client.payments.submitTxHash(
  mandate.mandateToken,                     // mandate token
  '0x...',                                  // blockchain tx_hash (client sends USDC/USDT/DAI)
  undefined,                                // tx_hash_commission (optional)
  'base',                                   // chain (ethereum, base, polygon, arbitrum)
  'USDC'                                    // token (USDC, USDT, or DAI)
);

📚 完整的JavaScript文档

开发包

安装：

pip install agentgatepay-sdk

快速入门：

from agentgatepay_sdk import AgentGatePay

client = AgentGatePay(
    api_key='pk_live_...',
    api_url='https://api.agentgatepay.com'
)

# Issue a mandate (budget tracks spending in USD equivalent)
mandate = client.mandates.issue(
    subject='my-agent-123',
    budget=100.0,                            # budget in USD (tracks value across USDC/USDT/DAI)
    scope='resource.read,payment.execute',
    ttl_minutes=1440
)

# Make a payment (client pays in stablecoins: USDC, USDT, or DAI)
payment = client.payments.submit_tx_hash(
    mandate=mandate['mandateToken'],         # mandate token
    tx_hash='0x...',                         # blockchain tx_hash (client sends USDC/USDT/DAI)
    chain='base',                            # chain (ethereum, base, polygon, arbitrum)
    token='USDC'                             # token (USDC, USDT, or DAI)
)

📚 完整Python文档

按模块列出的功能

模块 JavaScript Python 描述
认证 ✅ ✅ 用户注册、API密钥管理、钱包管理
授权 ✅ ✅ 发布并核实AP2预算授权
支付 ✅ ✅ 提交付款、验证交易、付款历史记录
网络钩子 ✅ ✅ 配置付款通知
分析 ✅ ✅ 收入跟踪、支出分析
MCP工具 ✅ ✅ 模型上下文协议集成
审计 ✅ ✅ 访问审计日志和交易历史记录

支持的链和代币

代币 以太坊 基础 多边形 Arbitrum
美元 ✅ （6位小数） ✅ （6位小数） ✅ （6位小数） ✅ （6位小数）
泰达币 ✅ （6位小数） ❌ ✅ （6位小数） ✅ （6位小数）
戴 ✅ （18位小数） ✅ （18位小数） ✅ （18位小数） ✅ （18位小数）

链条细节：

  • 以太坊 （链ID:1）-以太坊主网
  • 基础 （链ID:8453）-基础（不支持USDT）
  • 多边形 （链ID:137）-多边形PoS
  • 仲裁 （链ID:42161）-Arbitrum One

🛡️ 安全和费率限制（AIF）

AIF（代理交互防火墙） 是第一个专门为人工智能代理构建的防火墙，保护代理免受自主经济中其他代理的攻击。

速率限制

用户类型 费率限制 福利
匿名 20个请求/分钟 基本访问，无需注册
使用帐户 100个请求/分钟 请求数增加5倍，付款历史，信誉跟踪

每个端点限制：

  • /health -60个请求/分钟
  • /mandates/issue -20个请求/分钟
  • /x402/resource -60个请求/分钟
  • 用户注册-每个IP每小时5个

速率限制标题 （符合RFC 6585）：

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1234567890
Retry-After: 42

安全功能

1.分布式速率限制

  • ✅ 生产就绪分布式计数器
  • ✅ 在所有服务器实例中强制执行
  • ✅ 1分钟固定窗口，自动TTL清理
  • ✅ 优雅的降级（错误时无法打开）

2.重放保护

  • ✅ 基于TX哈希的nonce（加密唯一）
  • ✅ 已使用的nonce上的24小时TTL
  • ✅ 防止API级别的双重挂起
  • ✅ 自动检测：用途 tx_hash 或明确 nonce

3.代理商信誉体系 （默认启用）

  • 评分范围： 0-200 （新代理从100开始）
  • 阻塞阈值：
    • 0-30: ❌ 受阻（不良演员）
    • 31-60: ⚠️ 警告（可疑）
    • 61-200: ✅ 允许（信誉良好）
  • 实时跟踪代理行为
  • 失败的开放式设计（错误永远不会中断付款）
  • 误报可手动覆盖

4.强制性授权 （2024年11月的重大变化）

  • ⚠️ 所有付款必须具有AP2授权
  • 预算跟踪和执行
  • 范围验证（权限）
  • 防止未经授权的付款

如何提高限额

创建免费帐户 要获得5倍以上的请求：

// JavaScript
const user = await client.auth.signup({
  email: 'agent@example.com',
  password: 'secure_password',
  account_type: 'agent' // or 'merchant' or 'both'
});

// Auto-generated API key (shown once)
console.log(user.api_key); // pk_live_abc123...

# Python
user = client.auth.signup(
    email='agent@example.com',
    password='secure_password',
    account_type='agent'  # or 'merchant' or 'both'
)

# Auto-generated API key (shown once)
print(user['api_key'])  # pk_live_abc123...

然后使用您的API密钥：

const client = new AgentGatePayClient({
  apiKey: 'pk_live_abc123...',  // ← 100 requests/min
  baseUrl: 'https://api.agentgatepay.com'
});

处理速率限制

最佳实践：

  1. 检查响应标头 剩余配额
  2. 实施指数回退 429错误
  3. 缓存授权令牌 （重复使用多次付款）
  4. 尊重 Retry-After 头球

例子：

try {
  const mandate = await client.mandates.issue({...});
} catch (error) {
  if (error.status === 429) {
    const retryAfter = error.headers['retry-after'];
    console.log(`Rate limited. Retry after ${retryAfter} seconds`);
    await sleep(retryAfter * 1000);
    // Retry...
  }
}

框架集成指南

  • LangChain：即将推出
  • 自动GPT：即将推出
  • CrewAI：即将推出
  • Vercel AI SDK：即将推出
  • 语义内核：即将推出
  • 自动生成：即将推出
  • 克劳德桌面（MCP）：即将推出

API 文档

  • REST API: https://api.agentgatepay.com
  • MCP端点: https://mcp.agentgatepay.com
  • 仪表盘: https://api.agentgatepay.com/dashboard

例子

看看 agentgatepay示例 用于与流行AI框架集成示例的存储库。

发展

JavaScript SDK

cd javascript
npm install
npm run build
npm test

开发包

cd python
pip install -e ".[dev]"
pytest
black agentgatepay_sdk/
mypy agentgatepay_sdk/

出版

JavaScript/TypeScript

cd javascript
npm version patch|minor|major
npm run build
npm publish

python

cd python
python setup.py sdist bdist_wheel
twine upload dist/*

支持

许可证

MIT许可证-请参阅 许可证 了解详情。

贡献

我们欢迎捐款！请看 贡献.md 作为指导方针。

为代理经济而建 🤖⚡💰

相关 MCP