ampersend-sdk
Health Gecti
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 23 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
This SDK provides tooling for building applications that use the x402 payment protocol. It supports both buyer and seller roles, enabling AI agents and LLM applications to handle pay-per-request transactions via A2A, MCP, and HTTP transports.
Security Assessment
The overall risk is rated as Low. Because this is a financial SDK designed to handle cryptocurrency payments, it inherently deals with sensitive data. It requires an Ethereum wallet private key to sign payments, which must be securely managed via the `.env` file and never committed to version control. The code makes network requests by design to verify and route payments, but the automated code scan found no dangerous patterns, hardcoded secrets, or hidden shell execution exploits.
Quality Assessment
The project demonstrates strong maintenance health, with repository activity reported as recent as today. It uses the standard, permissive Apache-2.0 license, making it suitable for most development projects. While the repository is relatively new and has a modest community footprint (23 GitHub stars), the codebase is clean, well-documented, and organized following standard package structures for both Python and TypeScript.
Verdict
Safe to use, provided you follow standard security practices for managing your private keys and wallet credentials.
Tooling for building applications with x402 payment capabilities. Supports buyer and seller roles.
Ampersend SDK
Multi-language SDK for building applications with 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 repository.
📦 Language Support
Python - A2A protocol integration with wallet implementations and payment middleware
TypeScript - MCP protocol integration with client, proxy, and server implementations
🚀 Quick Start
Python
# Install Python 3.13
uv python install 3.13
# Install dependencies
uv sync --frozen --all-packages --group dev
TypeScript
# Install dependencies
pnpm install
pnpm build
# Configure environment
cp .env.example .env
# Edit .env with your credentials
# Run MCP proxy server
pnpm --filter ampersend-sdk proxy:dev
# Or run FastMCP example server
pnpm --filter fastmcp-x402-server dev
→ Full TypeScript documentation
📚 Documentation
Core Concepts
x402 Protocol - Transport-agnostic payment protocol for agent and LLM applications that enables pay-per-request
patterns. See x402 specification.
Supported Transports:
- A2A (Agent-to-Agent) - Transport protocol for agent communication with payment capabilities
- MCP (Model Context Protocol) - Transport protocol for LLM-tool integration with payment capabilities
- HTTP - Standard HTTP client with x402 payment capabilities (TypeScript)
Key Components:
- Treasurer - Authorizes and tracks payments
- Wallet - Creates and signs payment proofs (EOA and Smart Account support)
- Client - Initiates requests with payment handling
- Server - Verifies payments and processes requests
Repository Structure
ampersend-sdk/
├── python/
│ ├── ampersend-sdk/ # Python SDK package
│ └── langchain-ampersend/ # LangChain integration
└── typescript/
└── packages/
└── ampersend-sdk/ # TypeScript SDK package
🔧 Prerequisites
Python
- uv - Dependency management (install)
- Python 3.13+
TypeScript
- Node.js 18+
- pnpm - Package manager
Development
- Test USDC - For payment testing (Circle faucet)
- Private Key - Ethereum wallet for signing payments
📄 License
Apache 2.0 - See LICENSE
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi