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文档

______________________________________________________________________

按模块列出的功能

______________________________________________________________________

支持的链和代币

链条细节：

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

______________________________________________________________________

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

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

速率限制

每个端点限制：

• /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/*

______________________________________________________________________

支持

• GitHub问题: AgentGatePay/AgentGatePay-sdks
• 示例存储库: AgentGatePay/AgentGatePay示例
• 电子邮件: support@agentgatepay.com

______________________________________________________________________

许可证

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

______________________________________________________________________

贡献

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

______________________________________________________________________

为代理经济而建 🤖⚡💰