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

{paynode_sdk_python-1.1.1 → paynode_sdk_python-1.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paynode-sdk-python
-Version: 1.1.1
+Version: 1.1.3
 Summary: PayNode Protocol Python SDK for AI Agents
 Author-email: PayNodeLabs <contact@paynode.dev>
 License: MIT

{paynode_sdk_python-1.1.1 → paynode_sdk_python-1.1.3}/paynode_sdk/client.py

@@ -46,7 +46,7 @@ class PayNodeAgentClient:
             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)
+        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."""
@@ -67,7 +67,7 @@ class PayNodeAgentClient:
                     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)
+                    raise PayNodeException(f"An unexpected error occurred: {str(e)}", ErrorCode.internal_error)
                 continue
             return response
         return response
@@ -80,11 +80,11 @@ class PayNodeAgentClient:
         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)
+            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)
+            raise PayNodeException("Payment amount is below the protocol minimum (1000).", ErrorCode.amount_too_low)
 
         # Protocol v1.3: Permit-First Execution
         try:
@@ -99,7 +99,7 @@ class PayNodeAgentClient:
             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)
+            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})
@@ -166,12 +166,17 @@ class PayNodeAgentClient:
         }
         
         signed = self.account.sign_typed_data(full_message=structured_data)
-        return {"v": signed.v, "r": signed.r, "s": signed.s, "deadline": deadline}
+        return {
+            "v": signed.v,
+            "r": Web3.to_bytes(signed.r).rjust(32, b'\0'),
+            "s": Web3.to_bytes(signed.s).rjust(32, b'\0'),
+            "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_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)
         
@@ -199,7 +204,7 @@ class PayNodeAgentClient:
 
     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_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)

paynode_sdk_python-1.1.3/paynode_sdk/errors.py

@@ -0,0 +1,23 @@
+from enum import Enum
+from typing import Any, Optional
+
+class ErrorCode(str, Enum):
+    rpc_error = 'rpc_error'
+    insufficient_funds = 'insufficient_funds'
+    amount_too_low = 'amount_too_low'
+    token_not_accepted = 'token_not_accepted'
+    transaction_failed = 'transaction_failed'
+    duplicate_transaction = 'duplicate_transaction'
+    invalid_receipt = 'invalid_receipt'
+    internal_error = 'internal_error'
+    transaction_not_found = 'transaction_not_found'
+    wrong_contract = 'wrong_contract'
+    order_mismatch = 'order_mismatch'
+    missing_receipt = 'missing_receipt'
+
+class PayNodeException(Exception):
+    def __init__(self, message: str, code: ErrorCode, details: Optional[Any] = None):
+        super().__init__(message)
+        self.message = message
+        self.code = code
+        self.details = details

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

@@ -12,7 +12,7 @@ class PayNodeMiddleware(BaseHTTPMiddleware):
     def __init__(
         self,
         app: Any,
-        rpc_url: str,
+        rpc_urls: list | str,
         contract_address: str,
         merchant_address: str,
         chain_id: int,
@@ -25,7 +25,7 @@ class PayNodeMiddleware(BaseHTTPMiddleware):
     ):
         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
@@ -61,7 +61,7 @@ class PayNodeMiddleware(BaseHTTPMiddleware):
                 headers=headers,
                 content={
                     "error": "Payment Required",
-                    "code": ErrorCode.MISSING_RECEIPT,
+                    "code": ErrorCode.missing_receipt,
                     "message": "Please pay to PayNode contract and provide 'x-paynode-receipt' header.",
                     "amount": self.price,
                     "currency": self.currency
@@ -87,7 +87,7 @@ class PayNodeMiddleware(BaseHTTPMiddleware):
                 status_code=403,
                 content={
                     "error": "Forbidden",
-                    "code": err.code if hasattr(err, 'code') else ErrorCode.INVALID_RECEIPT,
+                    "code": err.code if hasattr(err, 'code') else ErrorCode.invalid_receipt,
                     "message": str(err)
                 }
             )

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

@@ -4,10 +4,20 @@ 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()
@@ -24,14 +34,14 @@ class PayNodeVerifier:
 
     async def verify_payment(self, tx_hash, expected):
         if not self.w3:
-            return {"isValid": False, "error": PayNodeException("Verifier Provider Missing", ErrorCode.RPC_ERROR)}
+            return {"isValid": False, "error": PayNodeException("Verifier Provider Missing", ErrorCode.rpc_error)}
 
         # 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
+                ErrorCode.amount_too_low
             )}
 
         # 1. Token Whitelist Check (Anti-FakeToken)
@@ -39,39 +49,39 @@ class PayNodeVerifier:
         if self.accepted_tokens and expected_token not in self.accepted_tokens:
             return {"isValid": False, "error": PayNodeException(
                 f"Token {expected.get('tokenAddress')} is not in the accepted whitelist.",
-                ErrorCode.TOKEN_NOT_ACCEPTED
+                ErrorCode.token_not_accepted
             )}
 
         try:
             is_new = await self.store.check_and_set(tx_hash, 86400) # 24 hour TTL
             if not is_new:
-                return {"isValid": False, "error": PayNodeException("Receipt already used", ErrorCode.RECEIPT_ALREADY_USED)}
+                return {"isValid": False, "error": PayNodeException("Receipt already used", ErrorCode.receipt_already_used)}
         except Exception as e:
-            return {"isValid": False, "error": PayNodeException("Store Error", ErrorCode.INTERNAL_ERROR, details=str(e))}
+            return {"isValid": False, "error": PayNodeException("Store Error", ErrorCode.internal_error, details=str(e))}
 
         try:
             receipt = self.w3.eth.get_transaction_receipt(tx_hash)
         except Exception:
-            return {"isValid": False, "error": PayNodeException("Transaction not found", ErrorCode.TRANSACTION_NOT_FOUND)}
+            return {"isValid": False, "error": PayNodeException("Transaction not found", ErrorCode.transaction_not_found)}
 
         if not receipt:
-            return {"isValid": False, "error": PayNodeException("Transaction not found", ErrorCode.TRANSACTION_NOT_FOUND)}
+            return {"isValid": False, "error": PayNodeException("Transaction not found", ErrorCode.transaction_not_found)}
         
         if receipt.get("status") == 0:
-            return {"isValid": False, "error": PayNodeException("Transaction failed", ErrorCode.TRANSACTION_FAILED)}
+            return {"isValid": False, "error": PayNodeException("Transaction failed", ErrorCode.transaction_failed)}
 
         if not receipt.get("to") or receipt.get("to", "").lower() != self.contract_address.lower():
-            return {"isValid": False, "error": PayNodeException("Wrong contract", ErrorCode.WRONG_CONTRACT)}
+            return {"isValid": False, "error": PayNodeException("Wrong contract", ErrorCode.wrong_contract)}
 
         contract = self.w3.eth.contract(address=Web3.to_checksum_address(self.contract_address), abi=PAYNODE_ROUTER_ABI)
         
         try:
             logs = contract.events.PaymentReceived().process_receipt(receipt)
         except Exception:
-            return {"isValid": False, "error": PayNodeException("Invalid receipt format", ErrorCode.INVALID_RECEIPT)}
+            return {"isValid": False, "error": PayNodeException("Invalid receipt format", ErrorCode.invalid_receipt)}
 
         if not logs:
-            return {"isValid": False, "error": PayNodeException("No valid PaymentReceived event found", ErrorCode.INVALID_RECEIPT)}
+            return {"isValid": False, "error": PayNodeException("No valid PaymentReceived event found", ErrorCode.invalid_receipt)}
 
         # Find the valid log
         merchant = expected.get("merchantAddress", "").lower()
@@ -103,6 +113,6 @@ class PayNodeVerifier:
             break
 
         if not valid:
-            return {"isValid": False, "error": PayNodeException("Payment criteria mismatch", ErrorCode.INVALID_RECEIPT)}
+            return {"isValid": False, "error": PayNodeException("Payment criteria mismatch", ErrorCode.invalid_receipt)}
 
         return {"isValid": True}

{paynode_sdk_python-1.1.1 → paynode_sdk_python-1.1.3}/paynode_sdk/webhook.py

@@ -213,7 +213,7 @@ class PayNodeWebhookNotifier:
                     if resp.status >= 400:
                         raise PayNodeException(
                             f"Webhook returned {resp.status}",
-                            ErrorCode.INTERNAL_ERROR
+                            ErrorCode.internal_error
                         )
 
                     logger.info(f"✅ [PayNode Webhook] Delivered tx {event.tx_hash[:10]}... → {resp.status}")

{paynode_sdk_python-1.1.1 → paynode_sdk_python-1.1.3}/paynode_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paynode-sdk-python
-Version: 1.1.1
+Version: 1.1.3
 Summary: PayNode Protocol Python SDK for AI Agents
 Author-email: PayNodeLabs <contact@paynode.dev>
 License: MIT

{paynode_sdk_python-1.1.1 → paynode_sdk_python-1.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "paynode-sdk-python"
-version = "1.1.1"
+version = "1.1.3"
 description = "PayNode Protocol Python SDK for AI Agents"
 readme = "README.md"
 authors = [{ name = "PayNodeLabs", email = "contact@paynode.dev" }]

paynode_sdk_python-1.1.1/paynode_sdk/errors.py

@@ -1,31 +0,0 @@
-from enum import Enum
-from typing import Any, Optional
-
-class ErrorCode(str, Enum):
-    # Authentication & Receipts
-    MISSING_RECEIPT = 'PAYNODE_MISSING_RECEIPT'
-    INVALID_RECEIPT = 'PAYNODE_INVALID_RECEIPT'
-    RECEIPT_ALREADY_USED = 'PAYNODE_RECEIPT_ALREADY_USED'
-    TRANSACTION_NOT_FOUND = 'PAYNODE_TRANSACTION_NOT_FOUND'
-    TRANSACTION_FAILED = 'PAYNODE_TRANSACTION_FAILED'
-
-    # Validation
-    WRONG_CONTRACT = 'PAYNODE_WRONG_CONTRACT'
-    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'
-    
-    # System
-    RPC_ERROR = 'PAYNODE_RPC_ERROR'
-    INTERNAL_ERROR = 'PAYNODE_INTERNAL_ERROR'
-
-class PayNodeException(Exception):
-    def __init__(self, message: str, code: ErrorCode, details: Optional[Any] = None):
-        super().__init__(message)
-        self.message = message
-        self.code = code
-        self.details = details