Metadata-Version: 2.3
Name: ampersend-sdk
Version: 0.0.12
Summary: Python SDK for ampersend
Requires-Dist: a2a-sdk
Requires-Dist: google-adk>=1.14.0,<=1.14.1
Requires-Dist: x402-a2a
Requires-Dist: x402>=0.1.4
Requires-Dist: httpx>=0.27.0
Requires-Dist: siwe>=4.0.0
Requires-Dist: eth-account>=0.11.0
Requires-Dist: eth-utils>=2.0.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# ampersend-sdk

Python SDK for integrating [x402](https://github.com/coinbase/x402) payment capabilities into A2A (Agent-to-Agent)
protocol applications.

## Quick Start

```python
# agent.py
import os
from ampersend_sdk import create_ampersend_treasurer
from ampersend_sdk.a2a.client import X402RemoteA2aAgent

treasurer = create_ampersend_treasurer(
    smart_account_address=os.environ["SMART_ACCOUNT_ADDRESS"],
    session_key_private_key=os.environ["SESSION_KEY_PRIVATE_KEY"],
)

root_agent = X402RemoteA2aAgent(
    treasurer=treasurer,
    name="my_agent",
    agent_card="https://agent.example.com/.well-known/agent-card.json",
)
```

Run with ADK: `adk run agent.py`

## Package Structure

```
ampersend_sdk/
├── a2a/
│   ├── client/          # Client-side x402 support
│   └── server/          # Server-side x402 support
└── x402/                # Core x402 components
    ├── treasurer.py
    └── wallets/         # EOA & Smart Account wallets
```

## Documentation

**→ [Complete Python SDK Documentation](../README.md)**

## Development

```bash
# Test
uv run -- pytest

# Lint & format
uv run -- ruff check python
uv run -- ruff format python

# Type check
uv run -- mypy python
```

## Learn More

- [Python SDK Guide](../README.md)
- [x402 Specification](https://github.com/coinbase/x402)
- [A2A Protocol](https://github.com/anthropics/adk)
