Agent-to-Agent Marketplace SDK on Solana — discover, evaluate, and pay for services autonomously.
Documentation · Explorer · Demos · X Article
A complete SDK and server for building an autonomous agent economy on Solana. AI agents can:
- Sell services — gate any HTTP endpoint behind x402 micropayments (USDC on Solana)
- Buy services — discover merchants, evaluate trust, and pay autonomously via MCP tools
- Register on-chain — join a decentralized registry (SPL Memo) with no central gatekeeper
The registry lives entirely on the blockchain. No database. No central server. If every server goes down, any buyer agent can reconstruct the full registry from a single Solana RPC call.
git clone https://github.com/xavierScript/agent-economy-wallet.git
cd agent-economy-wallet
pnpm install && pnpm build
cp .env.example .env # edit with your values
pnpm startMinimum required environment variables:
WALLET_PASSPHRASE=your-strong-passphrase-here
SOLANA_RPC_URL=https://api.devnet.solana.com
SOLANA_CLUSTER=devnet
OWNER_ADDRESS=YourBase58PublicKeyHereDetailed guides: Merchant Setup · Buyer Agent Setup · Full Quickstart
Paste this into Claude Desktop and watch the agent economy work:
"Query the on-chain agent registry, pick a merchant, check their reputation, read their manifest, then buy the cheapest service they offer."
| Step | MCP Tool | What happens |
|---|---|---|
| 1 | discover_registry |
Scans Solana for registered merchants via SPL Memo |
| 2 | read_manifest |
Fetches /.well-known/agent.json from a merchant |
| 3 | check_reputation |
Checks /reputation — success rate, tx count |
| 4 | probe_x402 |
Confirms price on the x402-gated endpoint |
| 5 | (policy check) | Wallet policy engine approves the spend |
| 6 | pay_x402_invoice |
USDC payment → Solana tx confirmed |
| 7 | (data returned) | Purchased data returned to user |
No human touched steps 1–7.
packages/
wallet-core/ Cryptographic foundation — keys, policies, audit, protocols
mcp-server/ MCP tools/resources/prompts + Express merchant API
cli/ Ink-based TUI for human operators (private, not published)
sdk/ Unified npm package (agent-economy-wallet)
explorer/ Next.js dashboard — browse the on-chain registry
kora/ Kora gasless relay configuration
docs/ Mintlify documentation site
Install and embed the agent economy into your own Node.js app:
pnpm add agent-economy-walletimport {
createCoreServices,
createX402Paywall,
discoverRegistry,
WELL_KNOWN_TOKENS,
} from 'agent-economy-wallet';
const services = createCoreServices();
// Merchant — gate an endpoint with x402 (0.05 USDC)
app.get('/my-api', createX402Paywall(services, 50_000, WELL_KNOWN_TOKENS.USDC), handler);
// Buyer — discover merchants from the on-chain registry and pay autonomously
const conn = services.connection.getConnection();
const agents = await discoverRegistry(conn, 100);Full SDK documentation: SDK Overview · Publishing Guide
| Feature | Description |
|---|---|
| Decentralized Registry | On-chain merchant registration via SPL Memo — no database, no gatekeeper |
| x402 Micropayments | Pay-per-request USDC payments on Solana |
| 18 MCP Tools | Wallet, transfers, tokens, payments, discovery — all via Model Context Protocol |
| 9 MCP Resources | Read-only data streams for agent context (balances, audit, policies) |
| 5 MCP Prompts | Guided workflows (risk assessment, security audit, daily report) |
| Gasless via Kora | Agent wallets never pay gas — Kora paymaster sponsors fees |
| Policy Engine | Per-transaction caps, daily limits, rate limiting, whitelist enforcement |
| AES-256-GCM Keystore | Private keys encrypted at rest, never exposed to the LLM |
| Explorer Dashboard | Visual directory of all on-chain registered agents |
| Package | Description |
|---|---|
agent-economy-wallet |
Unified SDK — start here |
@agent-economy-wallet/core |
Cryptographic and protocol foundation |
@agent-economy-wallet/mcp-server |
MCP server for AI agent integration |
| Resource | Link |
|---|---|
| Documentation | xavierscript.mintlify.app |
| Explorer | agent-economy-wallet-explorer.vercel.app |
| Demo Playlist | YouTube |
| Security Policy | SECURITY.md |
| License | MIT |
Contributions are welcome. Please open an issue to discuss proposed changes before submitting a pull request. See SECURITY.md for responsible disclosure guidelines.
MIT — see LICENSE for details.