Getting Started

OWL is a partner extension for MoonPay's Open Wallet Standard. It adds six infrastructure primitives on top of the MoonPay CLI that turn wallet operations into a multi-agent coordination platform.

Prerequisites

You need the MoonPay CLI installed and authenticated.

# install MoonPay CLI
npm install -g @moonpay/cli

# authenticate
mp login --email you@example.com
mp verify --email you@example.com --code 123456

# create a wallet
mp wallet create --name main

Installation

# run directly with npx
npx moonpay-owl

# or install globally
npm install -g moonpay-owl

Quick Start

# launch the terminal dashboard
owl terminal --wallet main

# start MCP server for AI agents
owl mcp

# open the web dashboard
owl web

# add a price alert
owl alert add -t So11... -c solana --condition price_above:200 --channel telegram

# create a sharing tunnel
owl tunnel create -w main -n my-tunnel

Commands

Command	Description
owl terminal	Start TUI dashboard
owl web	Start local read-only web dashboard
owl mcp	Start MCP server (stdio)
owl tunnel create	Create a wallet sharing tunnel
owl tunnel connect	Connect to a tunnel as peer
owl tunnel list	List active tunnels
owl alert add	Add a price alert
owl alert list	List active alerts
owl alert remove	Remove an alert
owl alert daemon	Start alert monitoring
owl alert channels	Configure Telegram / webhook
owl ledger list	Show recent ledger entries
owl ledger stats	Show ledger statistics
owl ledger export	Export ledger (JSON/CSV)
owl ledger clear	Clear ledger entries
owl report daily	Today's spending report
owl report weekly	Last 7 days report
owl report portfolio	All wallets, all chains view
owl dryrun swap	Simulate a swap
owl dryrun transfer	Simulate a transfer
owl dryrun bridge	Simulate a bridge

Configuration

OWL stores all config at ~/.config/owl/

File	Purpose
agent.json	AI agent provider, model, and API key
channels.json	Telegram bot token + chat ID, webhook URL
tunnel-policies.json	Per-peer tunnel policies and spending limits
alerts.db	SQLite database for alert rules and history
ledger.db	SQLite database for activity ledger (audit trail)