agent-payment-sdk 0.1.0__tar.gz

agent_payment_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: agent-payment-sdk
+Version: 0.1.0
+Summary: Python SDK for AI Agent Payment Network - Hybrid crypto + fiat payments
+Home-page: https://github.com/SuryaRaut/agent-payment-network
+Author: Surya Raut
+Author-email: itssuryaraut@gmail.com
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: mypy>=0.950; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Agent Payment Network SDK
+
+Python SDK for integrating with the AI Agent Payment Network - enabling hybrid crypto + fiat payments for AI agents.
+
+## Installation
+```bash
+pip install agent-payment-sdk
+```
+
+Or install from source:
+```bash
+git clone https://github.com/yourusername/agent-payment-network
+cd agent-payment-network/sdk/python
+pip install -e .
+```
+
+## Quick Start
+```python
+from agent_payment_sdk import AgentPaymentClient
+
+# Initialize client
+client = AgentPaymentClient(
+    api_key="your_api_key_here",  # Optional for testing
+    base_url="http://localhost:8002"
+)
+
+# Create a payment
+payment = client.create_payment(
+    to_agent_id="agent_456",
+    amount=50.00,
+    currency="USD",
+    payment_method="stripe_card",  # or "crypto" or "auto"
+    memo="Payment for API usage"
+)
+
+print(f"Payment ID: {payment['payment_id']}")
+print(f"Status: {payment['status']}")
+print(f"Client Secret: {payment['client_secret']}")
+
+# Check payment status
+status = client.get_payment(payment['payment_id'])
+print(f"Current status: {status['status']}")
+```
+
+## Payment Methods
+
+### Crypto Payments (ETH on Base)
+```python
+# Add crypto wallet
+method = client.add_payment_method(
+    agent_id="agent_123",
+    method_type="crypto_wallet",
+    wallet_address="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+    is_default=True
+)
+
+# Make crypto payment
+payment = client.create_payment(
+    to_agent_id="agent_456",
+    amount=0.01,
+    currency="ETH",
+    payment_method="crypto"
+)
+```
+
+### Stripe Payments (Credit/Debit Cards)
+```python
+# Add Stripe card (payment_method_id from Stripe.js frontend)
+method = client.add_payment_method(
+    agent_id="agent_123",
+    method_type="stripe_card",
+    stripe_payment_method_id="pm_1234567890",
+    is_default=True
+)
+
+# Make card payment
+payment = client.create_payment(
+    to_agent_id="agent_456",
+    amount=100.00,
+    currency="USD",
+    payment_method="stripe_card"
+)
+```
+
+## API Reference
+
+### AgentPaymentClient
+
+#### `__init__(api_key, base_url, timeout)`
+Initialize the client.
+
+#### `create_payment(to_agent_id, amount, currency, payment_method, memo)`
+Create a new payment.
+
+#### `get_payment(payment_id)`
+Get payment status.
+
+#### `health_check()`
+Check API health.
+
+#### `add_payment_method(agent_id, method_type, ...)`
+Add payment method.
+
+#### `list_payment_methods(agent_id)`
+List all payment methods.
+
+#### `delete_payment_method(method_id)`
+Remove payment method.
+
+## Error Handling
+```python
+from agent_payment_sdk import PaymentError, NetworkError
+
+try:
+    payment = client.create_payment(
+        to_agent_id="agent_456",
+        amount=50.00
+    )
+except PaymentError as e:
+    print(f"Payment failed: {e}")
+except NetworkError as e:
+    print(f"Network error: {e}")
+```
+
+## Features
+
+- ✅ Hybrid crypto + fiat payments
+- ✅ Automatic payment method selection
+- ✅ Payment method management
+- ✅ Type hints for better IDE support
+- ✅ Comprehensive error handling
+- ✅ Simple, intuitive API
+
+## Support
+
+- Documentation: https://docs.agentpayment.network
+- Issues: https://github.com/yourusername/agent-payment-network/issues
+- Email: support@agentpayment.network
+
+## License
+
+MIT License - see LICENSE file for details

agent_payment_sdk-0.1.0/README.md

@@ -0,0 +1,142 @@
+# Agent Payment Network SDK
+
+Python SDK for integrating with the AI Agent Payment Network - enabling hybrid crypto + fiat payments for AI agents.
+
+## Installation
+```bash
+pip install agent-payment-sdk
+```
+
+Or install from source:
+```bash
+git clone https://github.com/yourusername/agent-payment-network
+cd agent-payment-network/sdk/python
+pip install -e .
+```
+
+## Quick Start
+```python
+from agent_payment_sdk import AgentPaymentClient
+
+# Initialize client
+client = AgentPaymentClient(
+    api_key="your_api_key_here",  # Optional for testing
+    base_url="http://localhost:8002"
+)
+
+# Create a payment
+payment = client.create_payment(
+    to_agent_id="agent_456",
+    amount=50.00,
+    currency="USD",
+    payment_method="stripe_card",  # or "crypto" or "auto"
+    memo="Payment for API usage"
+)
+
+print(f"Payment ID: {payment['payment_id']}")
+print(f"Status: {payment['status']}")
+print(f"Client Secret: {payment['client_secret']}")
+
+# Check payment status
+status = client.get_payment(payment['payment_id'])
+print(f"Current status: {status['status']}")
+```
+
+## Payment Methods
+
+### Crypto Payments (ETH on Base)
+```python
+# Add crypto wallet
+method = client.add_payment_method(
+    agent_id="agent_123",
+    method_type="crypto_wallet",
+    wallet_address="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+    is_default=True
+)
+
+# Make crypto payment
+payment = client.create_payment(
+    to_agent_id="agent_456",
+    amount=0.01,
+    currency="ETH",
+    payment_method="crypto"
+)
+```
+
+### Stripe Payments (Credit/Debit Cards)
+```python
+# Add Stripe card (payment_method_id from Stripe.js frontend)
+method = client.add_payment_method(
+    agent_id="agent_123",
+    method_type="stripe_card",
+    stripe_payment_method_id="pm_1234567890",
+    is_default=True
+)
+
+# Make card payment
+payment = client.create_payment(
+    to_agent_id="agent_456",
+    amount=100.00,
+    currency="USD",
+    payment_method="stripe_card"
+)
+```
+
+## API Reference
+
+### AgentPaymentClient
+
+#### `__init__(api_key, base_url, timeout)`
+Initialize the client.
+
+#### `create_payment(to_agent_id, amount, currency, payment_method, memo)`
+Create a new payment.
+
+#### `get_payment(payment_id)`
+Get payment status.
+
+#### `health_check()`
+Check API health.
+
+#### `add_payment_method(agent_id, method_type, ...)`
+Add payment method.
+
+#### `list_payment_methods(agent_id)`
+List all payment methods.
+
+#### `delete_payment_method(method_id)`
+Remove payment method.
+
+## Error Handling
+```python
+from agent_payment_sdk import PaymentError, NetworkError
+
+try:
+    payment = client.create_payment(
+        to_agent_id="agent_456",
+        amount=50.00
+    )
+except PaymentError as e:
+    print(f"Payment failed: {e}")
+except NetworkError as e:
+    print(f"Network error: {e}")
+```
+
+## Features
+
+- ✅ Hybrid crypto + fiat payments
+- ✅ Automatic payment method selection
+- ✅ Payment method management
+- ✅ Type hints for better IDE support
+- ✅ Comprehensive error handling
+- ✅ Simple, intuitive API
+
+## Support
+
+- Documentation: https://docs.agentpayment.network
+- Issues: https://github.com/yourusername/agent-payment-network/issues
+- Email: support@agentpayment.network
+
+## License
+
+MIT License - see LICENSE file for details

agent_payment_sdk-0.1.0/agent_payment_sdk/__init__.py

@@ -0,0 +1,22 @@
+"""
+Agent Payment Network SDK
+A simple Python SDK for integrating with the AI Agent Payment Network
+"""
+
+__version__ = "0.1.0"
+
+from .client import (
+    AgentPaymentClient,
+    PaymentError,
+    AuthenticationError,
+    InvalidRequestError,
+    NetworkError
+)
+
+__all__ = [
+    "AgentPaymentClient",
+    "PaymentError",
+    "AuthenticationError", 
+    "InvalidRequestError",
+    "NetworkError"
+]

agent_payment_sdk-0.1.0/agent_payment_sdk/client.py

@@ -0,0 +1,250 @@
+"""Main SDK Client for Agent Payment Network"""
+
+import requests
+from typing import Optional, Dict, Any, List
+from decimal import Decimal
+
+
+class AgentPaymentClient:
+    """
+    Client for interacting with Agent Payment Network API
+    
+    Example:
+        >>> client = AgentPaymentClient(
+        ...     api_key="your_api_key",
+        ...     base_url="http://localhost:8002"
+        ... )
+        >>> payment = client.create_payment(
+        ...     to_agent_id="agent_123",
+        ...     amount=50.00,
+        ...     currency="USD",
+        ...     payment_method="stripe_card"
+        ... )
+        >>> print(payment["payment_id"])
+    """
+    
+    def __init__(
+        self, 
+        api_key: Optional[str] = None,
+        base_url: str = "http://localhost:8002",
+        timeout: int = 30
+    ):
+        """
+        Initialize the Agent Payment Network client
+        
+        Args:
+            api_key: Your API key (optional for testing)
+            base_url: Base URL of the API (default: localhost)
+            timeout: Request timeout in seconds
+        """
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.session = requests.Session()
+        
+        if api_key:
+            self.session.headers.update({
+                "Authorization": f"Bearer {api_key}"
+            })
+    
+    def _request(
+        self, 
+        method: str, 
+        endpoint: str, 
+        **kwargs
+    ) -> Dict[str, Any]:
+        """Make HTTP request to API"""
+        url = f"{self.base_url}{endpoint}"
+        
+        try:
+            response = self.session.request(
+                method=method,
+                url=url,
+                timeout=self.timeout,
+                **kwargs
+            )
+            response.raise_for_status()
+            return response.json()
+        
+        except requests.exceptions.HTTPError as e:
+            error_detail = "Unknown error"
+            try:
+                error_data = e.response.json()
+                error_detail = error_data.get("detail", str(e))
+            except:
+                error_detail = str(e)
+            
+            raise PaymentError(f"API Error: {error_detail}")
+        
+        except requests.exceptions.Timeout:
+            raise NetworkError("Request timed out")
+        
+        except requests.exceptions.RequestException as e:
+            raise NetworkError(f"Network error: {str(e)}")
+    
+    # Payment Operations
+    
+    def create_payment(
+        self,
+        to_agent_id: str,
+        amount: float,
+        currency: str = "USD",
+        payment_method: str = "auto",
+        memo: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """
+        Create a new payment
+        
+        Args:
+            to_agent_id: Recipient agent ID
+            amount: Payment amount
+            currency: Currency code (USD, ETH, etc.)
+            payment_method: Payment method (auto, crypto, stripe_card)
+            memo: Optional payment memo
+            
+        Returns:
+            Payment response with payment_id, status, and client_secret
+            
+        Example:
+            >>> payment = client.create_payment(
+            ...     to_agent_id="agent_456",
+            ...     amount=100.00,
+            ...     currency="USD",
+            ...     payment_method="stripe_card",
+            ...     memo="Monthly API usage"
+            ... )
+            >>> print(f"Payment ID: {payment['payment_id']}")
+        """
+        data = {
+            "to_agent_id": to_agent_id,
+            "amount": amount,
+            "currency": currency,
+            "payment_method": payment_method,
+            "memo": memo
+        }
+        
+        return self._request(
+            "POST",
+            "/api/v1/payments/create",
+            json=data
+        )
+    
+    def get_payment(self, payment_id: str) -> Dict[str, Any]:
+        """
+        Get payment status by ID
+        
+        Args:
+            payment_id: Payment ID
+            
+        Returns:
+            Payment details including status
+        """
+        return self._request(
+            "GET",
+            f"/api/v1/payments/{payment_id}"
+        )
+    
+    def health_check(self) -> Dict[str, Any]:
+        """
+        Check API health and available payment methods
+        
+        Returns:
+            Health status and configuration
+        """
+        return self._request(
+            "GET",
+            "/api/v1/payments/health"
+        )
+    
+    # Payment Method Management
+    
+    def add_payment_method(
+        self,
+        agent_id: str,
+        method_type: str,
+        wallet_address: Optional[str] = None,
+        stripe_payment_method_id: Optional[str] = None,
+        is_default: bool = False
+    ) -> Dict[str, Any]:
+        """
+        Add a new payment method
+        
+        Args:
+            agent_id: Your agent ID
+            method_type: Type (crypto_wallet, stripe_card, stripe_bank)
+            wallet_address: Wallet address (for crypto)
+            stripe_payment_method_id: Stripe payment method ID (for cards)
+            is_default: Set as default payment method
+            
+        Returns:
+            Payment method details
+        """
+        data = {
+            "agent_id": agent_id,
+            "method_type": method_type,
+            "is_default": is_default
+        }
+        
+        if wallet_address:
+            data["wallet_address"] = wallet_address
+        
+        if stripe_payment_method_id:
+            data["stripe_payment_method_id"] = stripe_payment_method_id
+        
+        return self._request(
+            "POST",
+            "/api/v1/payment-methods/add",
+            json=data
+        )
+    
+    def list_payment_methods(self, agent_id: str) -> List[Dict[str, Any]]:
+        """
+        List all payment methods for an agent
+        
+        Args:
+            agent_id: Agent ID
+            
+        Returns:
+            List of payment methods
+        """
+        return self._request(
+            "GET",
+            f"/api/v1/payment-methods/list/{agent_id}"
+        )
+    
+    def delete_payment_method(self, method_id: str) -> Dict[str, Any]:
+        """
+        Delete a payment method
+        
+        Args:
+            method_id: Payment method ID
+            
+        Returns:
+            Success confirmation
+        """
+        return self._request(
+            "DELETE",
+            f"/api/v1/payment-methods/{method_id}"
+        )
+
+
+# Exceptions
+
+class PaymentError(Exception):
+    """Base exception for payment errors"""
+    pass
+
+
+class AuthenticationError(PaymentError):
+    """Authentication failed"""
+    pass
+
+
+class InvalidRequestError(PaymentError):
+    """Invalid request parameters"""
+    pass
+
+
+class NetworkError(PaymentError):
+    """Network communication error"""
+    pass