paynode-sdk-python 1.1.0__tar.gz → 1.1.1__tar.gz

paynode_sdk_python-1.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PayNode Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

paynode_sdk_python-1.1.1/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: paynode-sdk-python
+Version: 1.1.1
+Summary: PayNode Protocol Python SDK for AI Agents
+Author-email: PayNodeLabs <contact@paynode.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/PayNodeLabs/paynode-sdk-python
+Keywords: paynode,x402,base,agentic-web3,payments
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: web3>=6.15.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: fastapi>=0.111.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: responses>=0.23.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Dynamic: license-file
+
+# PayNode Python SDK
+
+[![Official Documentation](https://img.shields.io/badge/Docs-docs.paynode.dev-00ff88?style=for-the-badge&logo=readthedocs)](https://docs.paynode.dev)
+[![PyPI Version](https://img.shields.io/pypi/v/paynode-sdk-python.svg?style=for-the-badge)](https://pypi.org/project/paynode-sdk-python/)
+
+The official Python SDK for the **PayNode Protocol**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol.
+
+## 📖 Read the Docs
+
+**For complete installation guides, advanced usage, API references, and architecture details, please visit our official documentation:**
+👉 **[docs.paynode.dev](https://docs.paynode.dev)**
+
+## ⚡ Quick Start
+
+### Installation
+
+```bash
+pip install paynode-sdk-python web3
+```
+
+### Agent Client (Payer)
+
+```python
+from paynode_sdk import PayNodeAgentClient
+
+agent = PayNodeAgentClient(
+    private_key="YOUR_AGENT_PRIVATE_KEY",
+    rpc_urls=["https://mainnet.base.org", "https://rpc.ankr.com/base"]
+)
+
+# Automatically handles the 402 challenge, executes the Base L2 transaction, and gets the data.
+response = agent.request_gate("https://api.merchant.com/premium-data", method="POST", json={"agent": "PythonAgent"})
+
+print(response.json())
+```
+
+## 🚀 Run the Demo
+
+The SDK includes a complete Merchant/Agent demo in the `examples/` directory.
+
+### 1. Setup Environment
+
+Copy the example environment file and fill in your keys:
+
+```bash
+cp .env.example .env
+# Edit .env with your private key and RPC URLs
+```
+
+### 2. Run the Merchant Server (FastAPI)
+
+```bash
+python examples/fastapi_server.py
+```
+
+### 3. Run the Agent Client
+
+In another terminal:
+
+```bash
+python examples/agent_client.py
+```
+
+The demo will perform a full loop: `402 Handshake -> On-chain Payment -> 200 Verification`.
+
+---
+
+## 📦 Publishing to PyPI
+
+To publish a new version of the SDK:
+
+1. **Install build tools**:
+   ```bash
+   pip install build twine
+   ```
+2. **Build the package**:
+   ```bash
+   python -m build
+   ```
+3. **Upload to PyPI**:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+---
+
+_Built for the Autonomous AI Economy by PayNodeLabs._

paynode_sdk_python-1.1.1/README.md

@@ -0,0 +1,87 @@
+# PayNode Python SDK
+
+[![Official Documentation](https://img.shields.io/badge/Docs-docs.paynode.dev-00ff88?style=for-the-badge&logo=readthedocs)](https://docs.paynode.dev)
+[![PyPI Version](https://img.shields.io/pypi/v/paynode-sdk-python.svg?style=for-the-badge)](https://pypi.org/project/paynode-sdk-python/)
+
+The official Python SDK for the **PayNode Protocol**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol.
+
+## 📖 Read the Docs
+
+**For complete installation guides, advanced usage, API references, and architecture details, please visit our official documentation:**
+👉 **[docs.paynode.dev](https://docs.paynode.dev)**
+
+## ⚡ Quick Start
+
+### Installation
+
+```bash
+pip install paynode-sdk-python web3
+```
+
+### Agent Client (Payer)
+
+```python
+from paynode_sdk import PayNodeAgentClient
+
+agent = PayNodeAgentClient(
+    private_key="YOUR_AGENT_PRIVATE_KEY",
+    rpc_urls=["https://mainnet.base.org", "https://rpc.ankr.com/base"]
+)
+
+# Automatically handles the 402 challenge, executes the Base L2 transaction, and gets the data.
+response = agent.request_gate("https://api.merchant.com/premium-data", method="POST", json={"agent": "PythonAgent"})
+
+print(response.json())
+```
+
+## 🚀 Run the Demo
+
+The SDK includes a complete Merchant/Agent demo in the `examples/` directory.
+
+### 1. Setup Environment
+
+Copy the example environment file and fill in your keys:
+
+```bash
+cp .env.example .env
+# Edit .env with your private key and RPC URLs
+```
+
+### 2. Run the Merchant Server (FastAPI)
+
+```bash
+python examples/fastapi_server.py
+```
+
+### 3. Run the Agent Client
+
+In another terminal:
+
+```bash
+python examples/agent_client.py
+```
+
+The demo will perform a full loop: `402 Handshake -> On-chain Payment -> 200 Verification`.
+
+---
+
+## 📦 Publishing to PyPI
+
+To publish a new version of the SDK:
+
+1. **Install build tools**:
+   ```bash
+   pip install build twine
+   ```
+2. **Build the package**:
+   ```bash
+   python -m build
+   ```
+3. **Upload to PyPI**:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+---
+
+_Built for the Autonomous AI Economy by PayNodeLabs._

{paynode_sdk_python-1.1.0 → paynode_sdk_python-1.1.1}/paynode_sdk/__init__.py

@@ -1,3 +1,10 @@
+import warnings
+import logging
+
+# Silence upstream library deprecation warnings from web3's websocket dependency
+# to ensure a clean experience for PayNode SDK users.
+warnings.filterwarnings("ignore", category=DeprecationWarning, module="websockets.legacy")
+
 from .middleware import PayNodeMiddleware
 from .verifier import PayNodeVerifier
 from .errors import ErrorCode, PayNodeException

paynode_sdk_python-1.1.1/paynode_sdk/client.py

@@ -0,0 +1,216 @@
+import time
+import logging
+import threading
+import requests
+from eth_account.messages import encode_typed_data
+from web3 import Web3
+from requests.adapters import HTTPAdapter
+from urllib3.util.retry import Retry
+from .constants import PAYNODE_ROUTER_ADDRESS, BASE_USDC_ADDRESS, BASE_USDC_DECIMALS
+from .errors import PayNodeException, ErrorCode
+
+logger = logging.getLogger("paynode_sdk.client")
+
+class PayNodeAgentClient:
+    """
+    The main PayNode Client for AI Agents (v1.1.1).
+    Automatically handles the x402 'Payment Required' handshake.
+    Supports RPC redundancy and EIP-2612 Permit-First payments.
+    """
+    def __init__(self, private_key: str, rpc_urls: list | str = "https://mainnet.base.org"):
+        self.rpc_urls = rpc_urls if isinstance(rpc_urls, list) else [rpc_urls]
+        self.w3 = self._init_w3()
+        
+        # Initialize account and discard private key string
+        self.account = self.w3.eth.account.from_key(private_key)
+        self.nonce_lock = threading.Lock()
+        
+        # Setup session
+        self.session = requests.Session()
+        retry_strategy = Retry(
+            total=3,
+            status_forcelist=[429, 500, 502, 503, 504],
+            allowed_methods=["HEAD", "GET", "POST", "PUT", "DELETE", "OPTIONS", "TRACE"]
+        )
+        adapter = HTTPAdapter(max_retries=retry_strategy)
+        self.session.mount("https://", adapter)
+        self.session.mount("http://", adapter)
+
+    def _init_w3(self):
+        """Finds a working RPC from the list."""
+        for rpc in self.rpc_urls:
+            try:
+                w3 = Web3(Web3.HTTPProvider(rpc, request_kwargs={'timeout': 5}))
+                if w3.is_connected():
+                    return w3
+            except Exception as e:
+                logger.warning(f"⚠️ [PayNode-PY] RPC {rpc} failed: {str(e)}")
+                continue
+        raise PayNodeException("Failed to connect to any provided RPC nodes.", ErrorCode.RPC_ERROR)
+
+    def request_gate(self, url: str, method: str = "GET", **kwargs):
+        """The high-level autonomous method handling 402 loop."""
+        return self._request_with_402_retry(method.upper(), url, **kwargs)
+
+    def get(self, url, **kwargs):
+        return self.request_gate(url, "GET", **kwargs)
+
+    def post(self, url, **kwargs):
+        return self.request_gate(url, "POST", **kwargs)
+
+    def _request_with_402_retry(self, method, url, max_retries=3, **kwargs):
+        for _ in range(max_retries):
+            response = self.session.request(method, url, **kwargs)
+            if response.status_code == 402:
+                logger.info("💡 [PayNode-PY] 402 Detected. Handling payment...")
+                try:
+                    kwargs = self._handle_402(response.headers, **kwargs)
+                except Exception as e:
+                    if isinstance(e, PayNodeException): raise
+                    raise PayNodeException(f"An unexpected error occurred: {str(e)}", ErrorCode.INTERNAL_ERROR)
+                continue
+            return response
+        return response
+
+    def _handle_402(self, headers, **kwargs):
+        router_addr = headers.get('x-paynode-contract')
+        merchant_addr = headers.get('x-paynode-merchant')
+        amount_raw = int(headers.get('x-paynode-amount', 0))
+        token_addr = headers.get('x-paynode-token-address')
+        order_id = headers.get('x-paynode-order-id')
+
+        if not all([router_addr, merchant_addr, amount_raw, token_addr, order_id]):
+            raise PayNodeException("Malformed 402 headers: missing metadata", ErrorCode.INTERNAL_ERROR)
+
+        # v1.3 Constraint: Min payment protection
+        if amount_raw < 1000:
+            raise PayNodeException("Payment amount is below the protocol minimum (1000).", ErrorCode.AMOUNT_TOO_LOW)
+
+        # Protocol v1.3: Permit-First Execution
+        try:
+            # Check allowance first to decide if we need Permit
+            allowance = self._get_allowance(token_addr, router_addr)
+            if allowance >= amount_raw:
+                tx_hash = self._execute_pay(router_addr, token_addr, merchant_addr, amount_raw, order_id)
+            else:
+                logger.info("⚡ [PayNode-PY] Insufficient allowance. Attempting Permit-First payment...")
+                tx_hash = self.pay_with_permit_auto(router_addr, token_addr, merchant_addr, amount_raw, order_id)
+            
+            logger.info(f"✅ [PayNode-PY] Payment successful: {tx_hash}")
+        except Exception as e:
+            if isinstance(e, PayNodeException): raise
+            raise PayNodeException(f"On-chain transaction reverted or failed: {str(e)}", ErrorCode.TRANSACTION_FAILED)
+
+        retry_headers = kwargs.get('headers', {}).copy()
+        retry_headers.update({'x-paynode-receipt': tx_hash, 'x-paynode-order-id': order_id})
+        kwargs['headers'] = retry_headers
+        return kwargs
+
+    def _get_allowance(self, token_addr, spender_addr):
+        abi = [{"constant": True, "inputs": [{"name": "o", "type": "address"}, {"name": "s", "type": "address"}], "name": "allowance", "outputs": [{"name": "", "type": "uint256"}], "type": "function"}]
+        token = self.w3.eth.contract(address=Web3.to_checksum_address(token_addr), abi=abi)
+        return token.functions.allowance(self.account.address, Web3.to_checksum_address(spender_addr)).call()
+
+    def sign_permit(self, token_addr, spender_addr, amount, deadline=None):
+        """Signs EIP-2612 Permit data."""
+        if deadline is None:
+            deadline = int(time.time()) + 3600
+        
+        token_addr = Web3.to_checksum_address(token_addr)
+        spender_addr = Web3.to_checksum_address(spender_addr)
+        
+        # Get nonce and domain separator
+        abi = [
+            {"inputs": [{"name": "o", "type": "address"}], "name": "nonces", "outputs": [{"name": "", "type": "uint256"}], "stateMutability": "view", "type": "function"},
+            {"inputs": [], "name": "name", "outputs": [{"name": "", "type": "string"}], "stateMutability": "view", "type": "function"}
+        ]
+        token = self.w3.eth.contract(address=token_addr, abi=abi)
+        nonce = token.functions.nonces(self.account.address).call()
+        name = token.functions.name().call()
+        chain_id = self.w3.eth.chain_id
+
+        domain = {
+            "name": name,
+            "version": "1",
+            "chainId": chain_id,
+            "verifyingContract": token_addr,
+        }
+        message = {
+            "owner": self.account.address,
+            "spender": spender_addr,
+            "value": amount,
+            "nonce": nonce,
+            "deadline": deadline,
+        }
+        types = {
+            "EIP712Domain": [
+                {"name": "name", "type": "string"},
+                {"name": "version", "type": "string"},
+                {"name": "chainId", "type": "uint256"},
+                {"name": "verifyingContract", "type": "address"},
+            ],
+            "Permit": [
+                {"name": "owner", "type": "address"},
+                {"name": "spender", "type": "address"},
+                {"name": "value", "type": "uint256"},
+                {"name": "nonce", "type": "uint256"},
+                {"name": "deadline", "type": "uint256"},
+            ],
+        }
+        
+        structured_data = {
+            "types": types,
+            "domain": domain,
+            "primaryType": "Permit",
+            "message": message,
+        }
+        
+        signed = self.account.sign_typed_data(full_message=structured_data)
+        return {"v": signed.v, "r": signed.r, "s": signed.s, "deadline": deadline}
+
+    def pay_with_permit_auto(self, router_addr, token_addr, merchant_addr, amount, order_id):
+        """Combines sign_permit and on-chain submission."""
+        sig = self.sign_permit(token_addr, router_addr, amount)
+        router_abi = [{"inputs": [{"name": "p", "type": "address"}, {"name": "t", "type": "address"}, {"name": "m", "type": "address"}, {"name": "a", "type": "uint256"}, {"name": "o", "type": "bytes32"}, {"name": "d", "type": "uint256"}, {"name": "v", "type": "uint8"}, {"name": "r", "type": "bytes32"}, {"name": "s", "type": "bytes32"}], "name": "payWithPermit", "outputs": [], "stateMutability": "nonpayable", "type": "function"}]
+        router = self.w3.eth.contract(address=Web3.to_checksum_address(router_addr), abi=router_abi)
+        order_id_bytes = self.w3.keccak(text=order_id)
+        
+        current_gas_price = int(self.w3.eth.gas_price * 1.2)
+        with self.nonce_lock:
+            nonce = self.w3.eth.get_transaction_count(self.account.address, 'pending')
+            tx = router.functions.payWithPermit(
+                self.account.address,
+                Web3.to_checksum_address(token_addr),
+                Web3.to_checksum_address(merchant_addr),
+                amount,
+                order_id_bytes,
+                sig["deadline"], sig["v"], sig["r"], sig["s"]
+            ).build_transaction({
+                'from': self.account.address,
+                'nonce': nonce,
+                'gas': 300000,
+                'gasPrice': current_gas_price
+            })
+            signed_tx = self.account.sign_transaction(tx)
+            tx_h = self.w3.eth.send_raw_transaction(signed_tx.raw_transaction)
+        
+        self.w3.eth.wait_for_transaction_receipt(tx_h, timeout=60)
+        return self.w3.to_hex(tx_h)
+
+    def _execute_pay(self, router_addr, token_addr, merchant_addr, amount, order_id):
+        """Standard pay method (fallback)."""
+        router_abi = [{"inputs": [{"name": "t", "type": "address"}, {"name": "m", "type": "address"}, {"name": "a", "type": "uint256"}, {"name": "o", "type": "bytes32"}], "name": "pay", "outputs": [], "stateMutability": "nonpayable", "type": "function"}]
+        router = self.w3.eth.contract(address=Web3.to_checksum_address(router_addr), abi=router_abi)
+        order_id_bytes = self.w3.keccak(text=order_id)
+        current_gas_price = int(self.w3.eth.gas_price * 1.2)
+        
+        with self.nonce_lock:
+            nonce = self.w3.eth.get_transaction_count(self.account.address, 'pending')
+            tx = router.functions.pay(Web3.to_checksum_address(token_addr), Web3.to_checksum_address(merchant_addr), amount, order_id_bytes).build_transaction({
+                'from': self.account.address, 'nonce': nonce, 'gas': 200000, 'gasPrice': current_gas_price
+            })
+            signed_tx = self.account.sign_transaction(tx)
+            tx_h = self.w3.eth.send_raw_transaction(signed_tx.raw_transaction)
+        
+        self.w3.eth.wait_for_transaction_receipt(tx_h, timeout=60)
+        return self.w3.to_hex(tx_h)

paynode_sdk_python-1.1.1/paynode_sdk/constants.py

@@ -0,0 +1,35 @@
+# Generated by scripts/sync-config.py
+PAYNODE_ROUTER_ADDRESS = "0x92e20164FC457a2aC35f53D06268168e6352b200"
+PAYNODE_ROUTER_ADDRESS_SANDBOX = "0xB587Bc36aaCf65962eCd6Ba59e2DA76f2f575408"
+BASE_USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+BASE_USDC_ADDRESS_SANDBOX = "0xeAC1f2C7099CdaFfB91Aa3b8Ffd653Ef16935798"
+BASE_USDC_DECIMALS = 6
+
+PROTOCOL_TREASURY = "0x598bF63F5449876efafa7b36b77Deb2070621C0E"
+PROTOCOL_FEE_BPS = 100
+MIN_PAYMENT_AMOUNT = 1000
+
+BASE_RPC_URLS = ["https://mainnet.base.org", "https://base.meowrpc.com", "https://1rpc.io/base"]
+BASE_RPC_URLS_SANDBOX = ["https://sepolia.base.org", "https://base-sepolia-rpc.publicnode.com"]
+
+ACCEPTED_TOKENS = {
+    8453: ["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],
+    84532: ["0xeAC1f2C7099CdaFfB91Aa3b8Ffd653Ef16935798"]
+}
+
+PAYNODE_ROUTER_ABI = [
+    {
+        "anonymous": False,
+        "inputs": [
+            {"indexed": True, "name": "orderId", "type": "bytes32"},
+            {"indexed": True, "name": "merchant", "type": "address"},
+            {"indexed": True, "name": "payer", "type": "address"},
+            {"indexed": False, "name": "token", "type": "address"},
+            {"indexed": False, "name": "amount", "type": "uint256"},
+            {"indexed": False, "name": "fee", "type": "uint256"},
+            {"indexed": False, "name": "chainId", "type": "uint256"}
+        ],
+        "name": "PaymentReceived",
+        "type": "event"
+    }
+]

{paynode_sdk_python-1.1.0 → paynode_sdk_python-1.1.1}/paynode_sdk/errors.py

@@ -14,6 +14,7 @@ class ErrorCode(str, Enum):
     WRONG_MERCHANT = 'PAYNODE_WRONG_MERCHANT'
     WRONG_TOKEN = 'PAYNODE_WRONG_TOKEN'
     TOKEN_NOT_ACCEPTED = 'PAYNODE_TOKEN_NOT_ACCEPTED'
+    AMOUNT_TOO_LOW = 'PAYNODE_AMOUNT_TOO_LOW'
     INSUFFICIENT_FUNDS = 'PAYNODE_INSUFFICIENT_FUNDS'
     ORDER_MISMATCH = 'PAYNODE_ORDER_MISMATCH'
     PERMIT_FAILED = 'PAYNODE_PERMIT_FAILED'

{paynode_sdk_python-1.1.0 → paynode_sdk_python-1.1.1}/paynode_sdk/middleware.py

@@ -6,9 +6,12 @@ from .verifier import PayNodeVerifier
 from .errors import ErrorCode
 from .idempotency import IdempotencyStore
 
-class PayNodeMiddleware:
+from starlette.middleware.base import BaseHTTPMiddleware
+
+class PayNodeMiddleware(BaseHTTPMiddleware):
     def __init__(
         self,
+        app: Any,
         rpc_url: str,
         contract_address: str,
         merchant_address: str,
@@ -20,6 +23,7 @@ class PayNodeMiddleware:
         store: Optional[IdempotencyStore] = None,
         generate_order_id: Optional[Callable[[Request], str]] = None
     ):
+        super().__init__(app)
         # The Verifier holds the state of the idempotency store
         self.verifier = PayNodeVerifier(rpc_url, contract_address, chain_id, store=store)
         self.merchant_address = merchant_address
@@ -34,7 +38,7 @@ class PayNodeMiddleware:
         # Calculate raw amount (integer)
         self.amount_int = int(float(price) * (10 ** decimals))
 
-    async def __call__(self, request: Request, call_next):
+    async def dispatch(self, request: Request, call_next):
         receipt_hash = request.headers.get('x-paynode-receipt')
         order_id = request.headers.get('x-paynode-order-id')
 
@@ -78,6 +82,7 @@ class PayNodeMiddleware:
         else:
             # Validation Failed
             err = result.get("error")
+            print(f"❌ [PayNode-PY] Verification Failed for Order: {order_id}. Reason: {str(err)}")
             return JSONResponse(
                 status_code=403,
                 content={

{paynode_sdk_python-1.1.0 → paynode_sdk_python-1.1.1}/paynode_sdk/verifier.py

@@ -1,5 +1,5 @@
 from .errors import ErrorCode, PayNodeException
-from .constants import PAYNODE_ROUTER_ABI, ACCEPTED_TOKENS
+from .constants import PAYNODE_ROUTER_ABI, ACCEPTED_TOKENS, MIN_PAYMENT_AMOUNT
 from .idempotency import MemoryIdempotencyStore
 from web3 import Web3
 
@@ -26,7 +26,15 @@ class PayNodeVerifier:
         if not self.w3:
             return {"isValid": False, "error": PayNodeException("Verifier Provider Missing", ErrorCode.RPC_ERROR)}
 
-        # 0. Token Whitelist Check (Anti-FakeToken)
+        # 0. Dust Exploit Check (Minimum Payment)
+        amount = int(expected.get("amount", 0))
+        if amount < MIN_PAYMENT_AMOUNT:
+             return {"isValid": False, "error": PayNodeException(
+                f"Payment amount {amount} is below the minimum threshold of {MIN_PAYMENT_AMOUNT}.",
+                ErrorCode.AMOUNT_TOO_LOW
+            )}
+
+        # 1. Token Whitelist Check (Anti-FakeToken)
         expected_token = expected.get("tokenAddress", "").lower()
         if self.accepted_tokens and expected_token not in self.accepted_tokens:
             return {"isValid": False, "error": PayNodeException(

paynode_sdk_python-1.1.1/paynode_sdk_python.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: paynode-sdk-python
+Version: 1.1.1
+Summary: PayNode Protocol Python SDK for AI Agents
+Author-email: PayNodeLabs <contact@paynode.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/PayNodeLabs/paynode-sdk-python
+Keywords: paynode,x402,base,agentic-web3,payments
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: web3>=6.15.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: fastapi>=0.111.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: responses>=0.23.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Dynamic: license-file
+
+# PayNode Python SDK
+
+[![Official Documentation](https://img.shields.io/badge/Docs-docs.paynode.dev-00ff88?style=for-the-badge&logo=readthedocs)](https://docs.paynode.dev)
+[![PyPI Version](https://img.shields.io/pypi/v/paynode-sdk-python.svg?style=for-the-badge)](https://pypi.org/project/paynode-sdk-python/)
+
+The official Python SDK for the **PayNode Protocol**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol.
+
+## 📖 Read the Docs
+
+**For complete installation guides, advanced usage, API references, and architecture details, please visit our official documentation:**
+👉 **[docs.paynode.dev](https://docs.paynode.dev)**
+
+## ⚡ Quick Start
+
+### Installation
+
+```bash
+pip install paynode-sdk-python web3
+```
+
+### Agent Client (Payer)
+
+```python
+from paynode_sdk import PayNodeAgentClient
+
+agent = PayNodeAgentClient(
+    private_key="YOUR_AGENT_PRIVATE_KEY",
+    rpc_urls=["https://mainnet.base.org", "https://rpc.ankr.com/base"]
+)
+
+# Automatically handles the 402 challenge, executes the Base L2 transaction, and gets the data.
+response = agent.request_gate("https://api.merchant.com/premium-data", method="POST", json={"agent": "PythonAgent"})
+
+print(response.json())
+```
+
+## 🚀 Run the Demo
+
+The SDK includes a complete Merchant/Agent demo in the `examples/` directory.
+
+### 1. Setup Environment
+
+Copy the example environment file and fill in your keys:
+
+```bash
+cp .env.example .env
+# Edit .env with your private key and RPC URLs
+```
+
+### 2. Run the Merchant Server (FastAPI)
+
+```bash
+python examples/fastapi_server.py
+```
+
+### 3. Run the Agent Client
+
+In another terminal:
+
+```bash
+python examples/agent_client.py
+```
+
+The demo will perform a full loop: `402 Handshake -> On-chain Payment -> 200 Verification`.
+
+---
+
+## 📦 Publishing to PyPI
+
+To publish a new version of the SDK:
+
+1. **Install build tools**:
+   ```bash
+   pip install build twine
+   ```
+2. **Build the package**:
+   ```bash
+   python -m build
+   ```
+3. **Upload to PyPI**:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+---
+
+_Built for the Autonomous AI Economy by PayNodeLabs._

{paynode_sdk_python-1.1.0 → paynode_sdk_python-1.1.1}/paynode_sdk_python.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 paynode_sdk/__init__.py
@@ -13,5 +14,4 @@ paynode_sdk_python.egg-info/SOURCES.txt
 paynode_sdk_python.egg-info/dependency_links.txt
 paynode_sdk_python.egg-info/requires.txt
 paynode_sdk_python.egg-info/top_level.txt
-tests/test_mainnet_live.py
-tests/test_verifier.py
+tests/test_client.py