Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 0 additions & 12 deletions .env.example
Original file line number Diff line number Diff line change
@@ -1,16 +1,4 @@
# Ampersend SDK Environment Variables
# Copy this file to .env and fill in your values

GOOGLE_API_KEY=
OPENAI_API_KEY=

EXAMPLES_A2A_BUYER__PRIVATE_KEY=
EXAMPLES_A2A_BUYER__SELLER_AGENT_URL=http://localhost:8001
EXAMPLES_A2A_SELLER__PAY_TO_ADDRESS=

TS__EXAMPLES__FASTMCP_X402_SERVER__PAY_TO_ADDRESS=

TS__MCP_PROXY__BUYER_PRIVATE_KEY=

TS__EXAMPLES__LANGCHAIN_MCP__PRIVATE_KEY=
TS__EXAMPLES__LANGCHAIN_MCP__MCP_SERVER_URL=http://localhost:8080/mcp
18 changes: 0 additions & 18 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,13 +119,11 @@ This is a multi-language monorepo with both workspace at the repository root:
**Python** (uv workspace):

- `python/ampersend-sdk/`: Python SDK with A2A protocol integration
- `python/examples/`: A2A buyer and seller agent examples
- Configured via `pyproject.toml`

**TypeScript** (pnpm workspace):

- `typescript/packages/ampersend-sdk/`: TypeScript SDK with MCP protocol integration
- `typescript/examples/`: MCP server examples (FastMCP)
- Configured via `pnpm-workspace.yaml` and `package.json`

### Core Components (Python)
Expand Down Expand Up @@ -209,22 +207,6 @@ be used without inheritance.
- `onExecute`: Callback to determine payment requirements
- `onPayment`: Callback to verify payments

## Environment Variables

**Python Examples** (see `.env.example`):

- `EXAMPLES_A2A_BUYER__PRIVATE_KEY`: Private key for buyer's EOA wallet
- `EXAMPLES_A2A_BUYER__SELLER_AGENT_URL`: URL of seller agent (default: <http://localhost:8001>)
- `GOOGLE_API_KEY`: Required for seller's google_search tool
- `EXAMPLES_A2A_SELLER__PAY_TO_ADDRESS`: Ethereum address to receive payments

**TypeScript Examples**:

- `BUYER_PRIVATE_KEY`: Wallet private key (must start with 0x) for EOA mode
- `BUYER_SMART_ACCOUNT_ADDRESS`: Smart account address (Smart Account mode)
- `BUYER_SMART_ACCOUNT_KEY_PRIVATE_KEY`: Signer key (Smart Account mode)
- `BUYER_SMART_ACCOUNT_VALIDATOR_ADDRESS`: Validator contract (Smart Account mode)

## Important Notes

**Python:**
Expand Down
22 changes: 5 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@
Multi-language SDK for building applications with [x402](https://github.com/coinbase/x402) payment capabilities.
Supports both buyer (client) and seller (server) roles with flexible payment verification and authorization patterns.

> **Looking for examples?** See the [ampersend-examples](https://github.com/edgeandnode/ampersend-examples) repository.

## 📦 Language Support

- **Python** - A2A protocol integration with wallet implementations and payment middleware
Expand All @@ -21,16 +23,6 @@ uv python install 3.13

# Install dependencies
uv sync --frozen --group dev

# Configure environment
cp .env.example .env
# Edit .env with your credentials

# Run example seller
uv --directory=python/examples run -- uvicorn examples.a2a.seller.adk.agent:a2a_app --host localhost --port 8001

# Run example buyer (in another terminal)
echo "your query" | uv --directory=python/examples run -- adk run src/examples/a2a/buyer/adk
```

**→ [Full Python documentation](./python/README.md)**
Expand Down Expand Up @@ -79,12 +71,10 @@ patterns. See [x402 specification](https://github.com/coinbase/x402).
```
ampersend-sdk/
├── python/
│ ├── ampersend-sdk/ # Python SDK package
│ └── examples/ # A2A buyer/seller examples
│ └── ampersend-sdk/ # Python SDK package
└── typescript/
├── packages/
│ └── ampersend-sdk/ # TypeScript SDK package
└── examples/ # MCP server examples
└── packages/
└── ampersend-sdk/ # TypeScript SDK package
```

## 🔧 Prerequisites
Expand All @@ -101,8 +91,6 @@ ampersend-sdk/

### Development

- **Google API Key** - Required for examples ([get key](https://aistudio.google.com/app/apikey))
- **OpenAI API Key** - Required for examples ([get key](https://platform.openai.com/api-keys))
- **Test USDC** - For payment testing ([Circle faucet](https://faucet.circle.com))
- **Private Key** - Ethereum wallet for signing payments

Expand Down
Loading