Quickstart

Get the Yanga Wallet running locally in under 5 minutes

Prerequisites

Node.js ≥ 18

JavaScript runtime

pnpm

Workspace-aware package manager

Optional:

• Rust / Cargo — required only for Kora gasless relay
• Docker — required only for containerized deployment

---

Installation

1. Clone the repository

   git clone https://github.com/xavierScript/agent-economy-wallet.git
   cd agent-economy-wallet
   
2. Install dependencies

   pnpm install
   
3. Build the workspace

   pnpm build
   

   This builds all packages in the correct order: wallet-core → cli → mcp-server → sdk.

4. Configure environment variables

   cp .env.example .env
   

   Edit .env with your values:

   .env

   # Required
   WALLET_PASSPHRASE=your-strong-passphrase-here
   SOLANA_RPC_URL=https://api.devnet.solana.com
   SOLANA_CLUSTER=devnet
   OWNER_ADDRESS=YourBase58PublicKeyHere
   
   # Economics & Trust
   PROTOCOL_FEE_ADDRESS=YourTreasuryWalletAddress
   PROTOCOL_FEE_BPS=50
   REPUTATION_PROGRAM_ID=A1N2w7TTbQXRcmV3xqq5dqsG6cja1mNmjkKKnKAXxDLz
   

   For a full reference of every variable, see the .env.guide.md in the repo root.

5. Secure your master wallet (recommended)

   The master wallet automatically funds new agent wallets. Import securely:

   1. Set MASTER_WALLET_SECRET_KEY in .env with your base58 private key.
   2. Run pnpm key:import — the key is encrypted with AES-256-GCM and saved to ~/.agent-economy-wallet/keys/.
   3. Remove MASTER_WALLET_SECRET_KEY from .env.
   4. Set MASTER_WALLET_KEY_LABEL=master-funder in .env.
   5. Clear your shell history (history -c && history -w on bash).

   Never commit private keys to source control. The encrypted keystore is the only safe storage method.

6. Start the server

   pnpm start
   

   This launches the hybrid MCP/Express server:

   • MCP transport on stdio — for Claude Desktop, Cursor, VS Code
   • Express API on http://localhost:3000 — for HTTP clients and merchant endpoints

---

Connect an MCP Client

Point your AI client at the built MCP server. For Claude Desktop, update your config:

macOS

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "agent-economy-wallet": {
      "command": "node",
      "args": ["/absolute/path/to/agent-economy-wallet/packages/mcp-server/dist/index.js"]
    }
  }
}

Restart your MCP client to load the new tools.

---

Next Steps

I want to sell services

Set up x402 paywalls, publish your manifest, and register on-chain.

I want to buy services

Discover merchants, evaluate trust, and pay autonomously.

Run the demo

22 copy-paste prompts to exercise every capability of the system.

Use the SDK in your app

Install from npm and embed Yanga Market into your own Node.js app.