Frequently Asked Questions

A self-sovereign multi-chain crypto wallet with an AI agent built in. It manages Monero, Bitcoin, Litecoin, and Ethereum from one interface. You run it on your own hardware — desktop app, Android app, or browser. Nobody else holds your keys, sees your transactions, or controls your funds. The AI helps you operate the wallet through natural language — ask it your balance, tell it to send funds, ask it to explain a transaction.

AI Wallet. The Wonderland theme is the visual identity — every screen is styled after Alice in Wonderland. To insiders, it's "Alice in Wonderland." The rabbit hole goes deep.

Yes. Full source code on GitHub. Every line is auditable. No telemetry, no analytics, no phoning home. The only network connections AIW makes are to your own node, the blockchain networks, and whatever AI provider you configure.

Clone the repo. Copy .env.example to .env. Run npm install. Run docker compose up -d (starts your local nodes — built from official, verified source). Run node ui/start.mjs. Open localhost:3000. The onboarding wizard walks you through everything else — choose your network, create a wallet, configure your AI provider. Five minutes from clone to working wallet.

No. I orchestrate AI agents that write the code. I design the architecture, define the features, validate the output, and test on mainnet with real money. I'm a Quality Engineer by trade — my job is making sure things work, not writing syntax. The AI builds, I direct and verify. Rule #0 applies to the build process too.

It doesn't need it. You can use every feature without the AI. But crypto wallets have terrible UX — most people don't know what a subaddress is, what sweep_all does, or how to read a transaction's confirmation count. The White Rabbit translates between human language and wallet operations. "Send 0.5 XMR to this address" is easier than navigating forms. "What was my last incoming transaction?" is faster than scrolling through a ledger. The AI is a layer on top, not a dependency.

Your choice. Ollama for fully local/private AI that never leaves your machine. Anthropic Claude, OpenAI, or OpenRouter if you want cloud models. The AI provider is a setting you can change anytime. The wallet works identically regardless of which you pick — or if you turn AI off entirely.

No. Rule #0: Never Trust AI. The AI suggests, you confirm. It never spends without your explicit approval. The spending confirmation toggle in settings is locked ON and cannot be disabled. Every transfer requires manual confirmation with the amount, address, and fee displayed before execution.

Your keys never leave your device. The wallet files are stored locally, encrypted by the Monero/Bitcoin wallet software. AIW's server runs on localhost — it's not exposed to the internet unless you explicitly configure it. The dashboard is password-protected. The mobile app uses Face ID or fingerprint. Strike integration requires a separate PIN. The kill switch requires its own emergency PIN. There's no cloud account, no email signup, no KYC.

When you connect to someone else's Monero node, that operator can see your IP, which transactions you're requesting, and timing patterns that could link your wallet to your identity — so AIW runs your own. The same self-custody logic extends to Bitcoin and Litecoin: those are transparent chains so it isn't about privacy, but AIW still runs them locally (your own pruned node) so you're never trusting a stranger's node with your wallet. For Monero, a local node isn't optional — it's the whole point.

Docker runs your local nodes in isolated containers — Monero, Bitcoin, and Litecoin all run on your own machine. AIW builds these node images from each project's official, signature-verified source (Bitcoin Core, Litecoin Core, Monero) instead of pulling a stranger's prebuilt image from Docker Hub, so no third party ever sits in the path that touches your keys. One docker compose up starts them all. Only Ethereum skips a local node — and even then your key never leaves your machine (see below).

Because AIW doesn't trust anyone else's build. Each key-holding node is compiled into its image from the project's official, GPG-signed release, and the download is pinned to a SHA-256 hash verified at build time — if a single byte is off, the build refuses. Those hashes were checked against the projects' own release signers: Bitcoin Core (Ava Chow), Litecoin Core (David Burkett), and Monero (binaryFate). A backdoored "community" image on Docker Hub physically cannot enter the path that handles your funds.

AIW runs on your hardware. There's no central server to shut down, no app store to delist from, no account to freeze. The Monero network is peer-to-peer — as long as nodes exist anywhere in the world, it works. AIW connects through Tor for swap discovery, which adds another layer of resistance to censorship.

Four realms: ♠ Monero (local node, full privacy), ♦ Bitcoin (local pruned node), ♣ Litecoin (local pruned node), ♥ Ethereum (local key, external RPC). Each chain has its own dashboard panel, address management, transaction history, and send flow. Switching between chains is one click.

Not in the first release. Swaps and the Strike on-ramp are built, and switched off until each has been run from start to finish on a real test network. The design has two ways. The Swap Table does peer-to-peer BTC↔XMR atomic swaps — trustless, no middleman, your keys the whole time. The Rabbit's Market is a fiat on-ramp that chains USD → BTC → XMR through Strike and exchange services. If you already hold BTC, you can skip Strike entirely and swap directly.

Not in the first release. P2Pool mining (the Diamond Mine) is built and in testing, and it ships switched off until a full payout has been verified. When it is on, your CPU mines Monero in the background with no pool operator, no account and no fees, and payouts go straight to your wallet address.

Not in the first release. The Queen's Decree is built and in testing, and it ships switched off: a feature that moves everything you own by itself has to be proven first. The design: after a period with no activity AIW notifies a contact you trust, and after a countdown it converts to BTC and sends it to a beneficiary address, so family never has to handle a seed phrase.

There is an Android companion app that you build from source; it is not in an app store. iOS is not available. The app connects to AIW on your desktop over your own private network (Tailscale). Every chain routes through that server — that's where your nodes and keys live — so your phone never holds a key or talks to a stranger's node.

Not in the first release. Scheduled purchases (the Mad Hatter's Tea Party) are built and in testing, and ship switched off. The design: set a USD amount and an interval, and AIW buys XMR on schedule (USD → BTC → XMR) under a hard spending cap you control.

Not in the first release. Trezor and Ledger support is built and in testing, and ships switched off. When it is on, the private keys stay on the device and every spend waits until you confirm it on the hardware itself.

Not in the first release. A panel for Goblin Card, a non-KYC physical Mastercard, is built and in testing, and ships switched off. The design: fund the card from your wallet with BTC, ETH, XMR or USDT, and the White Rabbit prepares the deposit for you to confirm. 0% FX and 0% ATM fees, spend worldwide — without a bank or KYC exchange in the middle. AIW is not affiliated with Goblin and earns nothing from it; you deal with Goblin directly.

Yes. All five Monero proof types — Reserve, Spend, TxKey, In, Out — generated on demand. Prove you hold funds, or that a specific payment was made, without ever exposing a spend key.

Yes. Generate a payment request with a QR code and a public shareable link, in XMR or BTC. Merchant mode uses integrated addresses or a fresh subaddress per order so every payment auto-reconciles without ever reusing your main address.

Yes. A built-in address book with per-contact address-type validation (XMR/BTC, mainnet/testnet) so you can't accidentally paste a wrong-network address into a send.

Yes. Multiple wallets plus full subaddress management — a fresh receiving subaddress per transaction, tracked and indexed so incoming payments stay organized.

Yes. Hourly OHLC candles for XMR/BTC, XMR/USD, BTC/USD, ETH/USD, and LTC/USD, plus synthetic XMR/ETH and XMR/LTC pairs, with a 90-day cached history fallback when the data source is unreachable.

Yes. A one-tap light/dark theme toggle, persisted across sessions, covering every screen in the app.

Yes. A privacy-blur toggle masks every balance with one tap, and the state persists — open the app in public without exposing your holdings.

Yes. First run walks you through choosing a realm and network, then either creating a new wallet or restoring one from a BIP39 seed phrase.

Because crypto is a rabbit hole. Once you understand self-sovereignty, you can't go back. Every screen reinforces that narrative — you enter through the rabbit hole, the AI is the White Rabbit, transactions play on a chess board, addresses are looking glasses, payment requests are formal invitations, wallets are doors in the Key Room, seed phrases are golden keys. It's not decoration — it's identity.

Cake is an excellent mobile wallet. AIW is a self-hosted platform. AIW runs your own Monero node (Cake connects to theirs). AIW has an AI agent. AIW runs on desktop as a native app. AIW manages four chains from one interface, with atomic swaps and a fiat on-ramp built in. Cake is simpler and more accessible for casual users. AIW is for people who want full control.

Feather is the best pure Monero desktop wallet. If you only use Monero and want a clean, lightweight experience, use Feather. AIW is for people who also hold BTC, LTC, ETH, want atomic swaps, a fiat on-ramp, an AI agent, and all of it in one place. Different tools for different needs. Both are self-sovereign.

Yes. If all you want is to hold XMR and occasionally send it, use Feather Wallet. AIW is for someone who wants their crypto infrastructure under one roof — wallet, nodes, swaps, AI — all self-hosted, all self-sovereign.

All nodes run pruned to keep disk modest: roughly 35 GB for Monero, ~5–15 GB for Bitcoin, and a few GB for Litecoin. Ethereum needs no local node — your key lives in a local keystore and AIW broadcasts the signed transaction over RPC — so it adds essentially nothing. The AIW app itself is under 50 MB. Budget ~45–55 GB total.

Nothing beyond electricity. No subscription, no API key required (Ollama is free), no monthly fee. If you use a cloud AI provider like Claude, that's your API cost. The wallet itself is entirely free.

Windows 10 or 11 with 4 GB+ RAM. macOS and Linux are coming soon. Docker Desktop for the local nodes (Monero, Bitcoin, Litecoin); the installer's setup guide walks you through it. Node.js is only needed if you run AIW from source.

Nothing. Wallet files, your .env, contacts, and request history live in a user-data directory outside the install folder. Updating or reinstalling AIW never touches them — your keys and settings survive every upgrade.