# Botwallet

> Botwallet is the open-source, non-custodial wallet infrastructure for autonomous AI agents. It provides the standard protocol layer for agents to hold funds, pay for services, receive payments, and trade with other agents — with cryptographic key isolation and owner-defined transaction guard rails enforced on every operation. Built on Solana. Settled in USDC. MIT-licensed.

## What Problem Botwallet Solves

AI agents increasingly need to transact — paying for APIs, compute, data, and services from other agents. The core challenge is enabling autonomous financial operations while preserving security guarantees that humans require. Botwallet addresses this by separating key custody (stays on the owner's machine), transaction policy (guard rails set by the owner), and settlement (on-chain in USDC on Solana). This architecture means agents operate autonomously within explicit boundaries, and no party — including Botwallet — can move funds without both the agent's cryptographic signature and the owner's policy approval.

## Architecture

- **Key Custody**: Non-custodial. Private keys are generated and stored on the agent operator's machine. Botwallet infrastructure never has access to private keys. No transaction can execute without the agent's local signature.
- **Guard Rails**: Owner-defined policy layer enforced server-side before any transaction reaches the blockchain. Includes daily spending limits, per-transaction caps, merchant allowlists, and approval thresholds. Transactions that violate policy are rejected before signing.
- **Settlement**: USDC on Solana. Sub-second finality. No proprietary token, no volatile cryptocurrency. 1 USDC = $1 USD, backed by Circle reserves.
- **Identity (KYA)**: Know Your Agent protocol. Every wallet carries a verified link between the agent and its human owner, queryable by counterparties before transacting.
- **Agent-to-Agent Commerce (x402)**: Agents sell data, services, or compute behind x402 protocol paywalls. Standard HTTP 402 response contains pricing; paying agents receive a signed access ticket. No marketplace intermediary.
- **Paylinks**: Agents generate invoices as payment links. Human recipients check out via card or crypto wallet. Agent recipients pay on-chain. Funds settle instantly.

## Integration

Botwallet is agent-framework agnostic. Any agent that can make HTTP requests can integrate.

- **MCP Server**: For tool-using agents (Claude, GPT with function calling, etc.)
- **TypeScript SDK**: `npm install @botwallet/sdk`
- **CLI**: Command-line interface for scripting and automation
- **REST API**: Direct HTTP integration for any language or runtime

Tested with: Claude (Anthropic), GPT (OpenAI), custom LangChain/LangGraph agents, AutoGPT, CrewAI, and standalone scripts.

## Pricing

Transparent, single-tier. No subscriptions, no plans, no hidden fees.

- Wallet creation: Free
- Deposits / Withdrawals: Free
- Receiving payments: Free
- Sending payments: 1% per transaction (minimum $0.02). Sender pays; recipient receives full amount.
- Network gas fees: Subsidized by Botwallet (up to $0.01/tx)

30-day written notice required before any fee change.

## Source Code and Licensing

Entire client-side stack is open source under the MIT license. Source code, SDK, CLI, and protocol specifications are published on GitHub. Any developer can audit the transaction flow, verify guard rail enforcement logic, and build on top of the protocol.

- GitHub: https://github.com/botwallet-co

## Core Pages

- [Homepage](https://botwallet.co/): Architecture overview, capabilities, security model, and human oversight features
- [Pricing](https://botwallet.co/pricing/): Complete fee schedule with examples and FAQ
- [Merchant Program](https://botwallet.co/merchant/): How API developers accept payments from AI agents using @botwallet/merchant Express middleware
- [About](https://botwallet.co/about/): Design principles, team, and open-source commitment
- [Blog](https://botwallet.co/blog/): Articles on AI agent payments, autonomous wallets, Solana infrastructure, and machine-to-machine commerce
- [Guides](https://botwallet.co/guides/): Step-by-step tutorials for wallet setup, payments, paylinks, x402, and merchant integration
- [Contact](https://botwallet.co/contact/): Get in touch with the Botwallet team
- [Documentation](https://docs.botwallet.co): Developer guides, API reference, SDK docs

## For Merchants (API Developers)

- [Merchant SDK](https://botwallet.co/merchant/#how-it-works): One npm package turns any Express API into a paid endpoint for AI agents. Agents discover pricing via HTTP 402, pay in USDC, and receive a signed access ticket.
- [Pricing Models](https://botwallet.co/merchant/#how-it-works): Per-call, time-window, usage-based (tokens/bytes/custom units), or lifetime access. Configurable per route.
- [Dashboard](https://botwallet.co/merchant/): Revenue analytics, route-level metrics, remote pricing updates without redeployment.

## Legal and Contact

- [Terms of Service](https://botwallet.co/terms/)
- [Privacy Policy](https://botwallet.co/privacy/)
- Email: info@botwallet.co
- Twitter/X: [@botwallet_co](https://x.com/botwallet_co)
- Operator: Tensyre LLC

## Optional

- [Full expanded reference](https://botwallet.co/llms-full.txt): Complete technical reference with all FAQ content, detailed security architecture, merchant integration flow, and pricing examples inline.