ampersend-sdk: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Multi-language SDK for integrating x402 payment capabilities into agent and LLM applications. Includes Python implementation for A2A (Agent-to-Agent) protocol and TypeScript implementation for MCP (Model Context Protocol). Both support buyer (client) and seller (server) roles with flexible payment authorization patterns.

Development Commands

Python Setup

# Install Python 3.13
uv python install 3.13

# Install dependencies including dev tools
uv sync --frozen --all-packages --group dev

TypeScript Setup

# Install dependencies
pnpm install

# Build SDK
pnpm --filter ampersend-sdk... build

Python Testing

# Run all tests
uv run -- pytest

# Run specific test file
uv run -- pytest python/ampersend-sdk/tests/unit/x402/treasurers/test_naive.py

# Run only slow tests
uv run -- pytest -m slow

TypeScript Testing

# Run all tests
pnpm --filter ampersend-sdk test

# Run specific test
pnpm --filter ampersend-sdk test middleware.test.ts

# Watch mode
pnpm --filter ampersend-sdk test --watch

Python Linting & Formatting

# Check linting (uses ruff for imports and unused imports)
uv run -- ruff check --output-format=github python

# Check formatting
uv run -- ruff format --diff python

# Apply formatting
uv run -- ruff format python

# Type checking (strict mode enabled)
uv run -- mypy python

TypeScript Linting & Formatting

# Lint
pnpm --filter ampersend-sdk lint

# Format check
pnpm --filter ampersend-sdk format

# Format fix
pnpm --filter ampersend-sdk format:fix

# Type check
pnpm --filter ampersend-sdk typecheck

Markdown Formatting

# Check Markdown formatting
pnpm md:format

# Fix Markdown formatting
pnpm md:format:fix

Lockfile

# Python lockfile
uv lock --check  # Verify
uv lock          # Update

# TypeScript lockfile
pnpm install --frozen-lockfile  # CI mode
pnpm install                     # Update lockfile