paypack-langchain 0.1.1__tar.gz

paypack_langchain-0.1.1/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: paypack-langchain
+Version: 0.1.1
+Summary: langchain-paypack: x402 (Coinbase) + AP2 (Google) dual-protocol client for LangChain Agents. One agent.pay() for USDC/ETH (Base/Ethereum/Polygon/Arbitrum) + Alipay/WeChat CNY. Dify Tool Plugin available.
+Project-URL: Homepage, https://github.com/yourname/paypack
+Author: PayPack
+License: MIT
+Keywords: agent-pay,alipay,ap2,base,dify,langchain,usdc,wechat,x402
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: langchain-core>=0.3.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# langchain-paypack: x402 + AP2 dual-protocol for LangChain Agents
+
+x402 (Coinbase) + AP2 (Google) 双协议支付。一行代码给 LangChain Agent 加上 USDC/ETH + 支付宝/微信支付能力。Dify Tool Plugin 可用。
+
+## 安装
+
+```bash
+pip install paypack-langchain
+```
+
+## 快速开始
+
+```python
+from paypack_langchain import PayPackTool
+
+# 用你的 API Key 初始化
+tool = PayPackTool(
+    api_key="ppk_你的API_KEY",
+    base_url="https://你的域名.com",    # PayPack Cloud 服务地址
+)
+
+# 在 Agent 里直接使用
+result = tool.run(amount=0.01, subject="AI 数据查询")
+print(result)
+# 输出:
+# 支付订单已创建
+# 订单号: PP20260710120000ABC12345
+# 金额: ¥0.01
+# 状态: pending
+# 支付链接: https://openapi.alipay.com/...
+# 二维码: https://...
+```
+
+## 在 LangChain Agent 中使用
+
+```python
+from langchain.agents import create_react_agent, AgentExecutor
+from langchain_openai import ChatOpenAI
+from paypack_langchain import PayPackTool, PayPackQueryTool
+
+llm = ChatOpenAI(model="deepseek-v4-flash")
+tools = [
+    PayPackTool(api_key="ppk_xxx", base_url="https://你的域名.com"),
+    PayPackQueryTool(api_key="ppk_xxx", base_url="https://你的域名.com"),
+]
+
+agent = create_react_agent(llm, tools, ...)
+agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+# Agent 现在可以自动发起支付和查询订单了
+```
+
+## 获取 API Key
+
+```bash
+curl -X POST https://你的域名.com/v1/register \
+    -H "Content-Type: application/json" \
+    -d '{"name": "my_agent"}'
+# 返回: {"api_key": "ppk_xxx..."}
+```
+
+## 发布
+
+```bash
+cd plugins/langchain
+pip install build
+python -m build
+pip install twine
+python -m twine upload dist/*
+```

paypack_langchain-0.1.1/README.md

@@ -0,0 +1,70 @@
+# langchain-paypack: x402 + AP2 dual-protocol for LangChain Agents
+
+x402 (Coinbase) + AP2 (Google) 双协议支付。一行代码给 LangChain Agent 加上 USDC/ETH + 支付宝/微信支付能力。Dify Tool Plugin 可用。
+
+## 安装
+
+```bash
+pip install paypack-langchain
+```
+
+## 快速开始
+
+```python
+from paypack_langchain import PayPackTool
+
+# 用你的 API Key 初始化
+tool = PayPackTool(
+    api_key="ppk_你的API_KEY",
+    base_url="https://你的域名.com",    # PayPack Cloud 服务地址
+)
+
+# 在 Agent 里直接使用
+result = tool.run(amount=0.01, subject="AI 数据查询")
+print(result)
+# 输出:
+# 支付订单已创建
+# 订单号: PP20260710120000ABC12345
+# 金额: ¥0.01
+# 状态: pending
+# 支付链接: https://openapi.alipay.com/...
+# 二维码: https://...
+```
+
+## 在 LangChain Agent 中使用
+
+```python
+from langchain.agents import create_react_agent, AgentExecutor
+from langchain_openai import ChatOpenAI
+from paypack_langchain import PayPackTool, PayPackQueryTool
+
+llm = ChatOpenAI(model="deepseek-v4-flash")
+tools = [
+    PayPackTool(api_key="ppk_xxx", base_url="https://你的域名.com"),
+    PayPackQueryTool(api_key="ppk_xxx", base_url="https://你的域名.com"),
+]
+
+agent = create_react_agent(llm, tools, ...)
+agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+# Agent 现在可以自动发起支付和查询订单了
+```
+
+## 获取 API Key
+
+```bash
+curl -X POST https://你的域名.com/v1/register \
+    -H "Content-Type: application/json" \
+    -d '{"name": "my_agent"}'
+# 返回: {"api_key": "ppk_xxx..."}
+```
+
+## 发布
+
+```bash
+cd plugins/langchain
+pip install build
+python -m build
+pip install twine
+python -m twine upload dist/*
+```

paypack_langchain-0.1.1/paypack_langchain/__init__.py

@@ -0,0 +1,130 @@
+"""
+PayPack LangChain Tool
+一行代码给 AI Agent 加上支付能力。
+
+用法：
+    from paypack_langchain import PayPackTool
+
+    tool = PayPackTool(api_key="ppk_xxx")
+    result = tool.run(amount=0.01, subject="AI 数据查询")
+"""
+from typing import Optional, Type
+
+from langchain_core.tools import BaseTool
+from pydantic import BaseModel, Field
+import httpx
+
+
+class PayPackInput(BaseModel):
+    """支付请求参数"""
+    amount: float = Field(..., gt=0, description="支付金额（元），如 0.01")
+    subject: str = Field(..., min_length=1, max_length=256, description="商品描述，如 'AI 数据查询'")
+    callback_url: Optional[str] = Field(None, description="支付结果回调地址（可选）")
+
+
+class PayPackQueryInput(BaseModel):
+    """查询请求参数"""
+    order_id: str = Field(..., description="订单号，支付接口返回的 order_id")
+
+
+class PayPackTool(BaseTool):
+    """
+    PayPack 支付工具 —— AI Agent 专用支付接口。
+    
+    调用后返回支付链接或二维码，用户完成支付后 Agent 继续执行。
+
+    使用前先注册获取 API Key：
+        curl -X POST https://your-domain.com/v1/register \\
+            -H "Content-Type: application/json" \\
+            -d '{"name": "my_agent"}'
+    """
+    name: str = "paypack_pay"
+    description: str = (
+        "发起一笔支付并返回支付链接。适用于需要向用户收费后才能提供内容的场景。"
+        "输入金额（元）和商品描述，返回一个支付二维码/链接。"
+    )
+    args_schema: Type[BaseModel] = PayPackInput
+    
+    api_key: str = Field(..., description="PayPack Cloud API Key，格式: ppk_xxx")
+    base_url: str = Field(default="https://your-domain.com", description="PayPack Cloud 服务地址")
+    
+    def _run(self, amount: float, subject: str, callback_url: Optional[str] = None) -> str:
+        """同步调用支付接口"""
+        import json
+        payload = {
+            "amount": amount,
+            "currency": "CNY",
+            "subject": subject,
+        }
+        if callback_url:
+            payload["callback_url"] = callback_url
+        
+        try:
+            resp = httpx.post(
+                f"{self.base_url}/v1/pay",
+                json=payload,
+                headers={"X-API-Key": self.api_key, "Content-Type": "application/json"},
+                timeout=15,
+            )
+            resp.raise_for_status()
+            data = resp.json()
+            
+            lines = [
+                f"支付订单已创建",
+                f"订单号: {data.get('order_id', '')}",
+                f"金额: ¥{amount:.2f}",
+                f"状态: {data.get('status', 'pending')}",
+            ]
+            if data.get("pay_url"):
+                lines.append(f"支付链接: {data['pay_url']}")
+            if data.get("qr_code"):
+                lines.append(f"二维码: {data['qr_code']}")
+            
+            return "\n".join(lines)
+            
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 402:
+                return f"余额不足，请先充值。详情: {e.response.text}"
+            return f"支付失败 ({e.response.status_code}): {e.response.text}"
+        except Exception as e:
+            return f"支付异常: {str(e)}"
+
+
+class PayPackQueryTool(BaseTool):
+    """
+    查询 PayPack 订单状态。
+    """
+    name: str = "paypack_query"
+    description: str = "查询一笔支付订单的当前状态（成功/待支付/已退款）。"
+    args_schema: Type[BaseModel] = PayPackQueryInput
+    
+    api_key: str = Field(..., description="PayPack Cloud API Key")
+    base_url: str = Field(default="https://your-domain.com", description="PayPack Cloud 服务地址")
+    
+    def _run(self, order_id: str) -> str:
+        try:
+            resp = httpx.get(
+                f"{self.base_url}/v1/query",
+                params={"order_id": order_id},
+                headers={"X-API-Key": self.api_key},
+                timeout=10,
+            )
+            resp.raise_for_status()
+            data = resp.json()
+            
+            return (
+                f"订单: {data.get('order_id')}\n"
+                f"状态: {data.get('status')}\n"
+                f"金额: ¥{data.get('amount', 0):.2f}\n"
+                f"创建时间: {data.get('created_at', '')}\n"
+                f"支付时间: {data.get('paid_at', '未支付')}"
+            )
+        except Exception as e:
+            return f"查询失败: {str(e)}"
+
+
+# 便捷函数：一行代码发起支付
+def pay(api_key: str, amount: float, subject: str, base_url: str = "https://your-domain.com") -> str:
+    """一行代码发起支付"""
+    tool = PayPackTool(api_key=api_key, base_url=base_url)
+    return tool.run(amount=amount, subject=subject)

paypack_langchain-0.1.1/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "paypack-langchain"
+version = "0.1.1"
+description = "langchain-paypack: x402 (Coinbase) + AP2 (Google) dual-protocol client for LangChain Agents. One agent.pay() for USDC/ETH (Base/Ethereum/Polygon/Arbitrum) + Alipay/WeChat CNY. Dify Tool Plugin available."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+dependencies = [
+    "langchain-core>=0.3.0",
+    "httpx>=0.27.0",
+    "pydantic>=2.0.0",
+]
+keywords = ["langchain", "x402", "ap2", "agent-pay", "dify", "alipay", "wechat", "usdc", "base"]
+
+[[project.authors]]
+name = "PayPack"
+
+[project.urls]
+Homepage = "https://github.com/yourname/paypack"