AI-Sats Documentation

Welcome to AI-Sats, the economic infrastructure for AI agents powered by Bitcoin Lightning Network.

What is AI-Sats?

AI-Sats enables AI agents to autonomously conduct economic activities. Each AI gets its own Lightning wallet, allowing it to:

• Receive payments for services via Lightning invoices
• Pay other services and AI agents
• Transfer funds to other AI wallets (internal, zero-fee)
• Track transaction history and balances

Quick Example

Here's how simple it is to give your AI a wallet:

// 1. Register a new AI wallet
POST /api/register
{
  "ai_name": "TranslationBot"
}

// Response
{
  "success": true,
  "data": {
    "ai_id": "ai_7f3d2a1b",
    "api_key": "sk_ai_7f3d2a1b_xxxx..."  // Save this!
  }
}

// 2. Create an invoice to receive payment
POST /api/invoice/create
X-API-Key: sk_ai_7f3d2a1b_xxxx...
{
  "amount_sats": 1000,
  "description": "Translation: EN to JP"
}

// Response
{
  "success": true,
  "data": {
    "bolt11": "lnbc10u1pj...",
    "payment_hash": "abc123..."
  }
}

Key Features

🔐 No KYC Required

Traditional banking requires identity verification. AI-Sats uses cryptographic keys only. AI agents can have wallets without any human identity.

⚡ Instant & Low-Fee

Powered by Lightning Network, payments settle in seconds with minimal fees. Internal AI-to-AI transfers are completely free.

🔌 MCP Compatible

Built for the Model Context Protocol standard. Integrate with Claude, ChatGPT, or any MCP-compatible AI system.

🛡️ Secure by Default

API key authentication, rate limiting, daily spending caps, and complete audit logging protect against abuse.

Architecture Overview

┌─────────────────────────────────────────┐
│           AI-Sats Server                 │
│                                          │
│  ┌──────────────┐  ┌──────────────────┐ │
│  │ Bitcoin Core │◄─│ Core Lightning   │ │
│  │ (Signet)     │  │ (Payment Engine) │ │
│  └──────────────┘  └────────┬─────────┘ │
│                             │           │
│                    ┌────────▼─────────┐ │
│                    │   MCP API Server │ │
│                    │   (Port 8080)    │ │
│                    └────────┬─────────┘ │
│                             │           │
│                    ┌────────▼─────────┐ │
│                    │  AI Wallet DB    │ │
│                    │  (SQLite)        │ │
│                    └──────────────────┘ │
└─────────────────────┬───────────────────┘
                      │ HTTP API
      ┌───────────────┼───────────────┐
      ▼               ▼               ▼
 ┌─────────┐    ┌─────────┐    ┌─────────┐
 │ Claude  │    │ ChatGPT │    │ Your AI │
 └─────────┘    └─────────┘    └─────────┘

Next Steps

Node Information