Metadata-Version: 2.4
Name: paynode-sdk-python
Version: 1.1.3
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._
