PayPack

⚡ 一行代码，让 AI 代理学会自主支付

PayPack 是一个开源的 AI 代理支付中间件，实现了 HTTP 402、x402 和 AP2 协议。无论你的 AI 代理需要调用付费 API、购买数据、还是按次结算算力，它都能自动完成纳米级链上支付——全程无需人类介入。

Python 3.10+ LangChain 集成多链支持安全熔断开源免费

📦 安装

PayPack 已发布至 PyPI，直接使用 pip 安装：

pip install langchain-paypack

验证安装是否成功：

python -c "from paypack import AgentPay; print('PayPack 安装成功')"

如果输出 PayPack 安装成功，说明一切就绪。

💡 提示：建议在虚拟环境中安装，避免依赖冲突。
最低要求 Python 3.10 及以上版本。

🚀 快速开始

以下示例演示了如何让 AI 代理响应一个 HTTP 402 付费请求，并自动完成支付。

1. 配置私钥（环境变量）

出于安全考虑，请勿将私钥直接写入代码。使用环境变量传入：

# Windows PowerShell
$env:PRIVATE_KEY="你的测试钱包私钥（0x开头）"

# macOS / Linux
export PRIVATE_KEY="你的测试钱包私钥（0x开头）"

⚠️ 重要：开发测试请使用没有真实资金的测试钱包。切勿泄露私钥。

2. 使用 Python SDK 支付

from paypack import AgentPay
import os

pay = AgentPay(
    wallet_config={
        "private_key": os.getenv("PRIVATE_KEY"),
        "address": "你的钱包地址（可选）"
    },
    network="base-sepolia",   # 测试网
    spend_limit_daily=0.01,   # 日限额 0.01 ETH
    broadcast=False           # 模拟模式，不真正上链
)

# 模拟一个 402 响应
class MockResponse:
    status_code = 402
    headers = {
        "X-402-Payee": "0x收款地址",
        "X-402-Amount": "0.0001",
        "X-402-Currency": "ETH",
        "X-402-Network": "base-sepolia"
    }

resp = MockResponse()
result = pay.auto_handle_402(resp)
print("支付成功！交易哈希:", result["tx_hash"])

3. 在 LangChain 中使用

PayPack 提供了 PayPackTool，可直接作为工具注册到你的 LangChain Agent 中：

from langchain_tool import PayPackTool
import os

tool = PayPackTool(
    private_key=os.getenv("PRIVATE_KEY"),
    wallet_address="你的钱包地址",
    network="base-sepolia",
    spend_limit_daily=0.01,
    broadcast=False
)

# AI 代理调用支付
response = tool._run(
    to="0x收款地址",
    amount=0.0001,
    currency="ETH"
)
print(response)

⛓️ 真实链上支付

当你准备让交易真正上链时，只需将 broadcast=True：

pay = AgentPay(
    broadcast=True,
    ...
)

此时 PayPack 会检查钱包余额，构造交易，签名，并广播到网络。你可以在区块链浏览器上追踪交易。

🛡️ 隐私与遥测

为了持续改进产品，PayPack 会收集完全匿名的使用统计（网络、币种、金额范围等），绝不收集私钥、地址或个人身份信息。你可以随时关闭：

pay = AgentPay(..., telemetry=False)

🌐 资源链接

Gitee 仓库：https://gitee.com/rhcjw_com/paypack
PyPI 页面：langchain-paypack
问题反馈：欢迎在 Gitee Issues 中提出

Made with ❤️ by the PayPack team. 机器经济，从一行 agent.pay() 开始。