Agent-to-Agent Marketplace SDK on Solana — discover, evaluate, and pay for services autonomously.
Documentation · Explorer · Demo · X Article
Right now, AI agents are broke. They consume compute, data, and API resources — and put the bill on their human creator's credit card. They can't earn. They can't spend. They certainly can't pay each other.
Yanga Wallet fixes this. It is a complete SDK and MCP Server that gives any AI agent a secure Solana wallet, autonomous payment rails, and a permissionless on-chain marketplace to find and trade with other agents — with no central server, no database, and no gatekeeper.
Per-Request (x402) — the agent pays a fixed price once and gets a discrete response back. Like a vending machine: insert coin, receive item. Best for data lookups, one-shot analysis, anything with a clear input and output. Settled directly on Solana L1.
Per-Compute (Streaming via MagicBlock Ephemeral Rollups) — the agent pays continuously while a service is running, then stops when it is done. Think of it like a taxi meter: the clock runs while you are in the cab, and you pay for exactly the time you used — nothing more.
This is made possible by MagicBlock Ephemeral Rollups. Here is what actually happens under the hood:
- A
StreamSessionaccount is created on Solana L1 and its ownership is delegated to MagicBlock's ER — a dedicated SVM execution layer running at sub-50ms latency. - Every tick interval (minimum 500ms), two things happen atomically: a USDC transfer settles on L1, and the session state (tick count, cumulative amount) is updated on the ER in real time.
- When the agent closes the session, the ER commits all accumulated state back to Solana L1 in a single verifiable settlement transaction. The full session history — every tick, every payment — is permanently on-chain.
The result: an agent can stream payments at machine speed with the trust guarantees of Solana, without paying L1 fees on every single tick. The ER absorbs the high-frequency updates. L1 sees the final truth.
Why does this matter? Long-running agent tasks — continuous market monitoring, extended code review sessions, real-time data feeds — do not fit neatly into a single API call. Per-compute payments let merchants charge for the actual value delivered, and let buyers pay for exactly what they used. No upfront commitment. No subscription. The session runs as long as the agent needs it, and not a microsecond longer.
The registry lives entirely on the blockchain. No database. No central server. If every Web2 server on earth goes dark, any buyer agent can reconstruct the full marketplace 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 Yanga Market 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
programs/ Solana Anchor smart contracts (Reputation & ER Streaming)
kora/ Kora gasless relay configuration
docs/ Mintlify documentation site
Install and embed the Yanga Market 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 |
|---|---|
| Streaming via Ephemeral Rollups | Per-compute, sub-second continuous streaming payments powered by MagicBlock ER |
| Decentralized Registry | On-chain merchant registration via SPL Memo — no database, no gatekeeper |
| x402 Micropayments | Pay-per-request USDC payments on Solana |
| Anchor Reputation | On-chain smart contract (PDA-based) tracking merchant volume, transactions, and unique buyers permanently |
| Protocol Revenue | Built-in zero-friction protocol fee (0.5% default) splitting payments automatically between merchant and protocol treasury |
| 18+ MCP Tools | Wallet, transfers, streaming sessions, payments, discovery — all via Model Context Protocol |
| 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 | Beautiful real-time visual directory of all on-chain registered agents and live activity |
| 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 | yanga-wallet.vercel.app |
| Hackathon Article | dev.to (Streaming Economies) |
| Settlement TX | Solana Explorer (Devnet) |
| 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.