StellarAgent 🤖⚡

AI Agent Payment Rails built on the Stellar blockchain.
The fastest, cheapest way to give AI agents autonomous payment capabilities.

---

Why StellarAgent?

AI agents need money. Today, giving an agent a wallet means dealing with:

• 🔴 Ethereum gas fees that cost more than the payment itself
• 🔴 Slow finality that breaks real-time workflows
• 🔴 No spend controls — agents can drain wallets
• 🔴 No audit trail for compliance

StellarAgent fixes all of this. Stellar's 2.5s finality and near-zero fees mean an agent can pay $0.001 per API call without the fee eating the payment. Our Soroban contracts add spend limits, escrow, and full audit trails on top.

---

What's Inside

stellaragent/
├── contracts/        # Soroban smart contracts (Rust)
│   ├── agent_wallet_factory/
│   ├── payment_channel/
│   ├── escrow/
│   └── rate_limiter/
├── sdk/              # TypeScript SDK
│   └── src/
├── dashboard/        # React + Tailwind business dashboard
│   └── src/
└── docs/             # Documentation

---

Architecture

┌─────────────────────────────────────────────────────┐
│                   Your AI Agent                      │
└──────────────────────┬──────────────────────────────┘
                       │ stellaragent SDK
┌──────────────────────▼──────────────────────────────┐
│              SDK Layer (TypeScript/Python)            │
│  createAgentWallet() │ payForAPI() │ requestWork()   │
└──────────────────────┬──────────────────────────────┘
                       │ Soroban RPC
┌──────────────────────▼──────────────────────────────┐
│           Soroban Smart Contracts (Rust)              │
│  AgentWalletFactory │ PaymentChannel │ Escrow        │
│  RateLimiter        │ AuditLog                       │
└──────────────────────┬──────────────────────────────┘
                       │ Stellar Network
┌──────────────────────▼──────────────────────────────┐
│              Stellar Blockchain                       │
│         USDC · XLM · 2.5s finality · ~$0             │
└─────────────────────────────────────────────────────┘

---

Quick Start

SDK (TypeScript)

npm install @stellaragent/sdk

import { StellarAgent } from '@stellaragent/sdk';

const agent = await StellarAgent.create({
  network: 'testnet',
  spendLimit: { amount: '10', asset: 'USDC', period: 'hourly' },
});

// Pay for an API call
await agent.payForAPI({
  endpoint: 'https://api.example.com/inference',
  amount: '0.001',
  asset: 'USDC',
});

// Agent-to-agent escrow job
const job = await agent.requestWork({
  workerAgent: 'G...AGENT_ADDRESS',
  task: 'Summarize this document',
  escrowAmount: '0.05',
  asset: 'USDC',
});

Contracts (Rust/Soroban)

cd contracts
cargo build --target wasm32-unknown-unknown --release
stellar contract deploy --wasm target/wasm32-unknown-unknown/release/agent_wallet_factory.wasm --network testnet

Dashboard

cd dashboard
npm install
npm run dev

---

Roadmap

• Project scaffolding & architecture
• AgentWalletFactory Soroban contract
• PaymentChannel Soroban contract
• Escrow Soroban contract
• RateLimiter Soroban contract
• TypeScript SDK core
• Python SDK
• Business dashboard (React + Tailwind)
• Stellar Community Fund grant application
• Mainnet deployment

---

Contributing

We welcome contributors! See CONTRIBUTING.md for how to get started.

Good first issues are labeled good first issue.

---

License

MIT © StellarAgent Contributors