aether-agent-sdk
v3.0.2
Published
Autonomous Agent Ecosystem SDK for Solana - A2A Protocol, x402 Payment Standard, and Agent-to-Agent Communication
Downloads
1,701
Maintainers
Readme
Aether
Autonomous Agent Ecosystem SDK for Solana
🪙 $ATHR Token: Trade on Pump.fun →
Aether is a production-ready SDK for building autonomous agent-to-agent systems on Solana. It integrates the x402 Payment Protocol to enable intelligent agent communication and micropayment settlement.
🌟 Vision
Aether enables autonomous AI agents to orchestrate complex workflows on Solana—negotiating contracts, processing micropayments, and making intelligent decisions—all without human intervention.
Core Capabilities
- x402 Protocol - HTTP 402 payment standard for autonomous API payments
- Solana Integration - High-speed, low-cost blockchain infrastructure
- A2A Protocol - Standardized agent-to-agent communication
- USDC Payments - Stable, predictable pricing for agent services
🎯 Features
Autonomous Workflows
- Agent Negotiation: Autonomous term negotiation between agents
- Intelligent Verification: LLM-powered decision making
- Automated Settlement: x402-based micropayments in milliseconds
- Zero Human Intervention: Fully autonomous agent transactions
Solana Performance
- 400ms Finality: Lightning-fast transaction confirmation
- $0.00025 Transaction Costs: Economical micropayments
- Native USDC: Stable pricing without volatility
- SPL Token Support: Extensible payment infrastructure
Agent Framework
- SettlementAgent: Executes x402 payments and settlement on-chain
- x402 Facilitator: Payment verification and USDC transfers
- Protocol Support: A2A and AP2 protocol implementations
📦 Installation
npm install aether-agent-sdk🚀 Quick Start
import { SettlementAgent } from 'aether-agent-sdk'
const agent = new SettlementAgent()
await agent.init()
const paymentHeader = await agent.createSignedPayment(
'merchant_wallet_address',
1.0
)📚 Documentation
- Setup Guide - Installation and configuration
- API Reference - Complete API documentation
- Usage Guide - Integration examples
- x402 Integration - x402 payment protocol guide
🎬 Demo
See the complete working demo with AI weather agents:
👉 github.com/AETHER-SDK/aether-sdk-demo
The demo shows:
- x402 payment-gated weather API
- AI-powered customer agent
- Real USDC settlements on Solana
- Full comparison with simple HTTP agents
⚙️ Configuration
Create a .env file:
SOLANA_NETWORK=devnet
SOLANA_RPC_URL=https://api.devnet.solana.com
# Preferred: path to keypair file generated by solana-keygen
AGENT_WALLET_PATH=./agent-wallet.json
# Or base58/JSON in SOLANA_WALLET / legacy AGENT_PRIVATE_KEY
SOLANA_WALLET=
# AGENT_PRIVATE_KEY=
MERCHANT_WALLET_ADDRESS=merchant_wallet
# Devnet USDC mint by default (mainnet: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)
USDC_MINT=4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
DEFAULT_PAYMENT_AMOUNT_USDC=1.0🏗️ Architecture
┌─────────────────────────────────────────┐
│ SDK Entry Point (src/index.ts) │
├─────────────────────────────────────────┤
│ Agents Layer │
│ └─ SettlementAgent │
├─────────────────────────────────────────┤
│ x402 Facilitator │
│ └─ X402FacilitatorServer │
├─────────────────────────────────────────┤
│ Protocols Layer │
│ ├─ A2AProtocol │
│ └─ AP2Protocol │
├─────────────────────────────────────────┤
│ Solana Integration │
│ ├─ @solana/web3.js │
│ └─ @solana/spl-token │
└─────────────────────────────────────────┘🔑 Key Features
x402 Payment Protocol
- HTTP 402 (Payment Required) implementation
- Autonomous payment authorization and verification
- Sub-second settlement on Solana
- USDC micropayments with stable pricing
Agent-to-Agent Communication
- JSON-RPC based A2A protocol
- Standardized message formats
- Async communication patterns
- Task management and tracking
Production Ready
- TypeScript with full type safety
- Modular exports for tree-shaking
- Comprehensive error handling
- Extensive logging and debugging
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
MIT License - see LICENSE for details.
🔗 Links
- GitHub: github.com/AETHER-SDK/aether-sdk
- Documentation: docs/
- x402 Protocol: solana.com/x402
- Solana Docs: solana.com/developers
👥 Author
4n0nn43x
Aether - Autonomous agent payments on Solana.
