PyPI - paynode-sdk-python - Versions diffs - 1.1.0__py3-none-any.whl → 1.1.2__py3-none-any.whl - Mend

paynode-sdk-python 1.1.0py3-none-any.whl → 1.1.2py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

paynode_sdk/__init__.py +7 -0
paynode_sdk/client.py +128 -130
paynode_sdk/constants.py +22 -1
paynode_sdk/errors.py +1 -0
paynode_sdk/middleware.py +9 -4
paynode_sdk/verifier.py +23 -5
paynode_sdk_python-1.1.2.dist-info/METADATA +107 -0
paynode_sdk_python-1.1.2.dist-info/RECORD +13 -0
paynode_sdk_python-1.1.2.dist-info/licenses/LICENSE +21 -0
paynode_sdk_python-1.1.0.dist-info/METADATA +0 -67
paynode_sdk_python-1.1.0.dist-info/RECORD +0 -12
{paynode_sdk_python-1.1.0.dist-info → paynode_sdk_python-1.1.2.dist-info}/WHEEL +0 -0
{paynode_sdk_python-1.1.0.dist-info → paynode_sdk_python-1.1.2.dist-info}/top_level.txt +0 -0

paynode_sdk/__init__.py CHANGED Viewed

@@ -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/client.py CHANGED Viewed

@@ -2,6 +2,7 @@ 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
@@ -11,14 +12,20 @@ from .errors import PayNodeException, ErrorCode
 logger = logging.getLogger("paynode_sdk.client")
 class PayNodeAgentClient:
-    def __init__(self, rpc_urls: list, private_key: str):
-        self.rpc_urls = rpc_urls
+    """
+    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 to prevent Traceback leaks
+        # Initialize account and discard private key string
         self.account = self.w3.eth.account.from_key(private_key)
         self.nonce_lock = threading.Lock()
-        # Setup session with standard HTTP retries for non-402 errors
+        # Setup session
         self.session = requests.Session()
         retry_strategy = Retry(
             total=3,
@@ -30,33 +37,37 @@ class PayNodeAgentClient:
         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': 10}))
+                w3 = Web3(Web3.HTTPProvider(rpc, request_kwargs={'timeout': 5}))
                 if w3.is_connected():
                     return w3
-            except Exception:
+            except Exception as e:
+                logger.warning(f"⚠️ [PayNode-PY] RPC {rpc} failed: {str(e)}")
                 continue
-        raise PayNodeException("Failed to connect to any RPC URL", ErrorCode.RPC_ERROR)
+        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_with_402_retry("GET", url, **kwargs)
+        return self.request_gate(url, "GET", **kwargs)
     def post(self, url, **kwargs):
-        return self._request_with_402_retry("POST", url, **kwargs)
+        return self.request_gate(url, "POST", **kwargs)
     def _request_with_402_retry(self, method, url, max_retries=3, **kwargs):
-        for attempt in range(max_retries):
+        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"Payment execution failed: {str(e)}", ErrorCode.INTERNAL_ERROR)
-                time.sleep(1) # Backoff before retry
+                    if isinstance(e, PayNodeException): raise
+                    raise PayNodeException(f"An unexpected error occurred: {str(e)}", ErrorCode.INTERNAL_ERROR)
                 continue
             return response
         return response
@@ -68,151 +79,138 @@ class PayNodeAgentClient:
         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:
-            self._ensure_allowance(token_addr, router_addr, amount_raw)
-            tx_hash = self._execute_pay(router_addr, token_addr, merchant_addr, amount_raw, order_id)
+            # 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 ValueError as e:
-            err_msg = str(e).lower()
-            if "insufficient funds" in err_msg:
-                raise PayNodeException("Insufficient funds for gas or token.", ErrorCode.INSUFFICIENT_FUNDS)
-            raise PayNodeException(f"Transaction failed: {str(e)}", ErrorCode.TRANSACTION_FAILED)
         except Exception as e:
-            if isinstance(e, PayNodeException):
-                raise
-            raise PayNodeException(f"Unknown error during payment: {str(e)}", ErrorCode.INTERNAL_ERROR)
+            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
-        })
+        retry_headers.update({'x-paynode-receipt': tx_hash, 'x-paynode-order-id': order_id})
         kwargs['headers'] = retry_headers
         return kwargs
-    def _ensure_allowance(self, token_addr, spender_addr, amount):
-        token_abi = [
-            {"constant": True, "inputs": [{"name": "o", "type": "address"}, {"name": "s", "type": "address"}], "name": "allowance", "outputs": [{"name": "", "type": "uint256"}], "type": "function"},
-            {"constant": False, "inputs": [{"name": "s", "type": "address"}, {"name": "a", "type": "uint256"}], "name": "approve", "outputs": [{"name": "", "type": "bool"}], "type": "function"}
+    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=Web3.to_checksum_address(token_addr), abi=token_abi)
-        allowance = token.functions.allowance(self.account.address, Web3.to_checksum_address(spender_addr)).call()
+        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"},
+            ],
+        }
-        if allowance < amount:
-            logger.info("🔐 [PayNode-PY] Allowance too low. Granting Infinite Approval...")
-            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 = token.functions.approve(Web3.to_checksum_address(spender_addr), 2**256 - 1).build_transaction({
-                    'from': self.account.address,
-                    'nonce': nonce,
-                    'gas': 100000,
-                    'gasPrice': current_gas_price
-                })
-                signed_tx = self.account.sign_transaction(tx)
-                tx_h = self.w3.eth.send_raw_transaction(signed_tx.raw_transaction)
-            logger.info(f"⏳ Waiting for approval confirmation: {self.w3.to_hex(tx_h)}...")
-            self.w3.eth.wait_for_transaction_receipt(tx_h, timeout=60)
+        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 _execute_pay(self, router_addr, token_addr, merchant_addr, amount, order_id):
-        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"},
-            {"inputs": [{"name": "payer", "type": "address"}, {"name": "token", "type": "address"}, {"name": "merchant", "type": "address"}, {"name": "amount", "type": "uint256"}, {"name": "orderId", "type": "bytes32"}, {"name": "deadline", "type": "uint256"}, {"name": "v", "type": "uint8"}, {"name": "r", "type": "bytes32"}, {"name": "s", "type": "bytes32"}], "name": "payWithPermit", "outputs": [], "stateMutability": "nonpayable", "type": "function"}
-        ]
+    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": "payer", "type": "address"}, {"name": "token", "type": "address"}, {"name": "merchant", "type": "address"}, {"name": "amount", "type": "uint256"}, {"name": "orderId", "type": "bytes32"}, {"name": "deadline", "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.pay(
+            tx = router.functions.payWithPermit(
+                self.account.address,
                 Web3.to_checksum_address(token_addr),
                 Web3.to_checksum_address(merchant_addr),
                 amount,
-                order_id_bytes
+                order_id_bytes,
+                sig["deadline"], sig["v"], sig["r"], sig["s"]
             ).build_transaction({
                 'from': self.account.address,
                 'nonce': nonce,
-                'gas': 200000,
+                '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 pay_with_permit(
-        self,
-        router_addr: str,
-        payer_address: str,
-        token_addr: str,
-        merchant_addr: str,
-        amount: int,
-        order_id: str,
-        deadline: int,
-        v: int,
-        r: bytes,
-        s: bytes
-    ) -> str:
-        """
-        Execute payment using EIP-2612 Permit — single-tx approve + pay.
-        The payer signs the permit offline, and this Agent relays it on-chain.
-        Args:
-            router_addr: PayNode Router contract address
-            payer_address: The address that holds the tokens and signed the permit
-            token_addr: ERC20 token address (must support EIP-2612)
-            merchant_addr: Merchant receiving 99% of payment
-            amount: Token amount in smallest unit (e.g. 1000000 = 1 USDC)
-            order_id: Order identifier string
-            deadline: Unix timestamp after which the permit is invalid
-            v: ECDSA recovery id
-            r: ECDSA signature r component (bytes32)
-            s: ECDSA signature s component (bytes32)
-        """
-        router_abi = [
-            {"inputs": [{"name": "payer", "type": "address"}, {"name": "token", "type": "address"}, {"name": "merchant", "type": "address"}, {"name": "amount", "type": "uint256"}, {"name": "orderId", "type": "bytes32"}, {"name": "deadline", "type": "uint256"}, {"name": "v", "type": "uint8"}, {"name": "r", "type": "bytes32"}, {"name": "s", "type": "bytes32"}], "name": "payWithPermit", "outputs": [], "stateMutability": "nonpayable", "type": "function"}
-        ]
+    def _execute_pay(self, router_addr, token_addr, merchant_addr, amount, order_id):
+        """Standard pay method (fallback)."""
+        router_abi = [{"inputs": [{"name": "token", "type": "address"}, {"name": "merchant", "type": "address"}, {"name": "amount", "type": "uint256"}, {"name": "orderId", "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)
-        try:
-            with self.nonce_lock:
-                nonce = self.w3.eth.get_transaction_count(self.account.address, 'pending')
-                tx = router.functions.payWithPermit(
-                    Web3.to_checksum_address(payer_address),
-                    Web3.to_checksum_address(token_addr),
-                    Web3.to_checksum_address(merchant_addr),
-                    amount,
-                    order_id_bytes,
-                    deadline,
-                    v,
-                    r,
-                    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)
-            logger.info(f"✅ [PayNode-PY] Permit payment confirmed: {self.w3.to_hex(tx_h)}")
-            return self.w3.to_hex(tx_h)
-        except ValueError as e:
-            err_msg = str(e).lower()
-            if "insufficient funds" in err_msg:
-                raise PayNodeException("Insufficient funds for gas.", ErrorCode.INSUFFICIENT_FUNDS)
-            raise PayNodeException(f"Permit transaction failed: {str(e)}", ErrorCode.PERMIT_FAILED)
-        except Exception as e:
-            if isinstance(e, PayNodeException):
-                raise
-            raise PayNodeException(f"Permit payment error: {str(e)}", ErrorCode.INTERNAL_ERROR)
+        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/constants.py CHANGED Viewed

@@ -7,8 +7,29 @@ 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", "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2"],
+    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/errors.py CHANGED Viewed

@@ -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/middleware.py CHANGED Viewed

@@ -6,10 +6,13 @@ 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,
-        rpc_url: str,
+        app: Any,
+        rpc_urls: list | str,
         contract_address: str,
         merchant_address: str,
         chain_id: int,
@@ -20,8 +23,9 @@ 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.verifier = PayNodeVerifier(rpc_urls=rpc_urls, contract_address=contract_address, chain_id=chain_id, store=store)
         self.merchant_address = merchant_address
         self.contract_address = contract_address
         self.currency = currency
@@ -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/verifier.py CHANGED Viewed

@@ -1,13 +1,23 @@
 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
 class PayNodeVerifier:
-    def __init__(self, rpc_url=None, contract_address=None, chain_id=None, w3=None, store=None, accepted_tokens=None):
+    def __init__(self, rpc_urls=None, contract_address=None, chain_id=None, w3=None, store=None, accepted_tokens=None):
         self.w3 = w3
-        if not self.w3 and rpc_url:
-            self.w3 = Web3(Web3.HTTPProvider(rpc_url))
+        if not self.w3 and rpc_urls:
+            urls = rpc_urls if isinstance(rpc_urls, list) else [rpc_urls]
+            for rpc in urls:
+                try:
+                    temp_w3 = Web3(Web3.HTTPProvider(rpc, request_kwargs={'timeout': 5}))
+                    if temp_w3.is_connected():
+                        self.w3 = temp_w3
+                        break
+                except Exception:
+                    continue
+            if not self.w3:
+                raise PayNodeException("Failed to connect to any provided RPC nodes.", ErrorCode.RPC_ERROR)
         self.contract_address = contract_address
         self.chain_id = int(chain_id) if chain_id else None
         self.store = store or MemoryIdempotencyStore()
@@ -26,7 +36,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.2.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: paynode-sdk-python
+Version: 1.1.2
+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.2.dist-info/RECORD ADDED Viewed

@@ -0,0 +1,13 @@
+paynode_sdk/__init__.py,sha256=p6URBqxFz1AErG7rIRWKnfwnzAC19qrMURtG7YhVR1I,821
+paynode_sdk/client.py,sha256=rwn6bTSyIuIXd8aLnK5Nnd7R5p8Hx25ETzfNQil6y1k,10639
+paynode_sdk/constants.py,sha256=puqz09qeKcMoigWrqdIzkhtAzFpECxEwHGLvDd3U_CQ,1429
+paynode_sdk/errors.py,sha256=GN0qycgjATT47dF4yZ6Ulg18jf2OwholvYl0pgCvuzo,1121
+paynode_sdk/idempotency.py,sha256=od7HuSxFdejBP0oE4QCzbJdrDZWvziiu09d3BRErU2k,999
+paynode_sdk/middleware.py,sha256=KAcSVaVyApO4evby4vnv1erifqi3VzSBFbWelGGSF_w,3563
+paynode_sdk/verifier.py,sha256=V7VXWqXzkObfN9v9agb7CWiLLwKbX1f2gsIWQE0qDdk,5274
+paynode_sdk/webhook.py,sha256=KxlXGkXe3wpR8ueO8FMW2iypJgWaLwMfxAAZLNRvNDo,8302
+paynode_sdk_python-1.1.2.dist-info/licenses/LICENSE,sha256=U8RjGlEBtXN6PA-qN_N3Uh60jyu3qe26ZBmgt-LAHc4,1069
+paynode_sdk_python-1.1.2.dist-info/METADATA,sha256=_qVjPReImedgxEqo1w4FlZVgead-vXFxAGvR3nZVyx4,2858
+paynode_sdk_python-1.1.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+paynode_sdk_python-1.1.2.dist-info/top_level.txt,sha256=c6Skc1Xx-9O-JJ7sHghLW8Kyn4hyJoVPUawH1Mu8iTU,12
+paynode_sdk_python-1.1.2.dist-info/RECORD,,

paynode_sdk_python-1.1.2.dist-info/licenses/LICENSE ADDED Viewed

@@ -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.0.dist-info/METADATA DELETED Viewed

@@ -1,67 +0,0 @@
-Metadata-Version: 2.4
-Name: paynode-sdk-python
-Version: 1.1.0
-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
-Requires-Dist: requests>=2.31.0
-Requires-Dist: web3>=6.15.0
-Requires-Dist: python-dotenv>=1.0.1
-# 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 Client
-agent = Client(private_key="YOUR_AGENT_PRIVATE_KEY")
-# Automatically handles the 402 challenge, executes the Base L2 transaction, and gets the data.
-response = agent.get("https://api.merchant.com/premium-data")
-print(response.json())
-```
-### Merchant Middleware (FastAPI Receiver)
-```python
-from fastapi import FastAPI, Depends
-from paynode_sdk.middleware import PayNodeMiddleware
-app = FastAPI()
-# Protect routes with a 1.50 USDC fee requirement
-require_payment = PayNodeMiddleware(
-    price=1.50,
-    merchant_wallet="0xYourWalletAddress..."
-)
-@app.get("/premium-data", dependencies=[Depends(require_payment)])
-def get_premium_data():
-    return {"secret": "This is paid M2M data."}
-```
----
-*Built for the Autonomous AI Economy by PayNodeLabs.*

paynode_sdk_python-1.1.0.dist-info/RECORD DELETED Viewed

@@ -1,12 +0,0 @@
-paynode_sdk/__init__.py,sha256=dK8m7FfOsWUJakKqHaY44x-xC-uUWVwDrXa0G_zUs8E,562
-paynode_sdk/client.py,sha256=NWzsb9OryI5EEld-L-svQHk6sVwbCulepB7xSIAVr6A,10777
-paynode_sdk/constants.py,sha256=kmE45nR7XKUwn-FEt8CvcvzH3VoQbT-MD2mt71LPVEk,621
-paynode_sdk/errors.py,sha256=LaTwDJxinKYd2UD58lyANRm-rLXF3KSb1XHvIKOcgt0,1075
-paynode_sdk/idempotency.py,sha256=od7HuSxFdejBP0oE4QCzbJdrDZWvziiu09d3BRErU2k,999
-paynode_sdk/middleware.py,sha256=dg3hSmHAjW8wTF3AH3id8LFxbN2kXKKUsBRp1gyc6qw,3292
-paynode_sdk/verifier.py,sha256=huMXbBF361Yj9HLehaY34ToGBrYSuy5Uy8Jau3Seg7k,4414
-paynode_sdk/webhook.py,sha256=KxlXGkXe3wpR8ueO8FMW2iypJgWaLwMfxAAZLNRvNDo,8302
-paynode_sdk_python-1.1.0.dist-info/METADATA,sha256=_18F4H7sRGtdYA9-lA7kdEiO_n2Xnrv6Y_8XN-nj1VQ,2087
-paynode_sdk_python-1.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-paynode_sdk_python-1.1.0.dist-info/top_level.txt,sha256=c6Skc1Xx-9O-JJ7sHghLW8Kyn4hyJoVPUawH1Mu8iTU,12
-paynode_sdk_python-1.1.0.dist-info/RECORD,,

{paynode_sdk_python-1.1.0.dist-info → paynode_sdk_python-1.1.2.dist-info}/WHEEL RENAMED Viewed

File without changes

{paynode_sdk_python-1.1.0.dist-info → paynode_sdk_python-1.1.2.dist-info}/top_level.txt RENAMED Viewed

File without changes

paynode-sdk-python 1.1.0__py3-none-any.whl → 1.1.2__py3-none-any.whl

paynode-sdk-python 1.1.0py3-none-any.whl → 1.1.2py3-none-any.whl