Coinbase Wallet Agent

Create an XMTP Bitte Agent Message Listener

A Bun-based Node.js service that continuously listens for XMTP messages and processes them through the Bitte AI API.

LogoGitHub - BitteProtocol/core-agent-tbaGitHub

✨ Features

  • Real-time XMTP Integration: Continuously listens for new XMTP messages

  • Bitte AI Processing: Routes messages through Bitte AI agents for intelligent responses

  • Automatic Error Handling: Handles errors gracefully and sends fallback responses

  • Key Generation Utility: Script to generate wallet and encryption keys for setup

🛠️ Use Cases

  • XMTP Message Processing: Real-time automated response to XMTP messages

  • AI Agent Proxy: Bridge between XMTP and Bitte AI agents

  • Continuous Service: Long-running service for persistent message handling

📦 Requirements

  • Bun (v1.0+)

  • Node.js v20+

⚙️ Setup

1. Install Dependencies

bun install

2. Generate Keys (Optional for First-Time Setup)

bun scripts/gen-keys.ts

This creates or appends to a .env file with WALLET_KEY and ENCRYPTION_KEY.

3. Configure Environment Variables

Create a .env file in your project root:

WALLET_KEY=your_wallet_private_key
ENCRYPTION_KEY=your_encryption_key
BITTE_API_KEY=your_bitte_api_key
BITTE_AGENT_ID=your_bitte_agent_id
XMTP_ENV=dev

Variable Reference:

Variable
Description

WALLET_KEY

EVM private key (hex string, with or without 0x)

ENCRYPTION_KEY

32-byte hex string for local DB encryption

BITTE_API_KEY

Your Bitte API key (get from Bitte platform)

BITTE_AGENT_ID

Agent ID to route messages to (e.g. coingecko-ai.vercel.app)

XMTP_ENV

XMTP environment (dev, production, etc.)

▶️ Run the Service

Production

bun start

Development

bun dev

📜 Scripts

Command
Description

bun start / bun dev

Start the XMTP message listener

bun scripts/gen-keys.ts

Generate wallet + encryption keys and update .env

🧠 How It Works

  1. XMTP Setup: Initializes XMTP client with wallet + encryption key

  2. Message Streaming: Listens to incoming XMTP messages in real-time

  3. Message Processing: Validates message sender + type

  4. AI Response: Sends message to Bitte AI agent and gets a reply

  5. Reply: Sends response back to original XMTP conversation

  6. Error Handling: Logs errors and sends fallback replies if needed

🚀 Deployment

This is a long-running process. Recommended platforms:

  • VPS / Dedicated server

  • Docker container

  • Railway, Fly.io, or DigitalOcean App Platform

🧰 Troubleshooting

  • ✅ Check Environment Variables: Ensure .env is correctly configured

  • 🔐 Generate Keys: Use bun scripts/gen-keys.ts if keys are missing

  • 🧾 Monitor Logs: Console output gives insight into runtime behavior

  • 🔑 Bitte API Errors: Double-check your API key + agent ID

  • ♻️ Restart on Failures: Service continues running, but restart if persistent errors occur

📘 Notes

  • This project uses Bun as the runtime.

  • Use .env.example as a starting point for your configuration.

  • See XMTP_docs.md for further XMTP details.

PreviousSui Agent Building

Last updated