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 the Monero node). 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 node operator can see your IP address, which transactions you're requesting, and timing patterns that could link your wallet to your identity. With Bitcoin that doesn't matter — Bitcoin transactions are already public. With Monero, the whole point is privacy. Running your own node means nobody else sees your transaction queries.

Docker runs the Monero node and wallet in isolated containers. Monero needs a daemon that syncs the blockchain and a separate wallet process that talks to it — Docker packages both with the right configuration so you can start everything with one command. Bitcoin, Litecoin, and Ethereum connect to remote nodes and don't need Docker at all. Only Monero runs locally because privacy requires it.

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 or remote node), ♣ Litecoin (remote node), ♥ Ethereum (remote node). Each chain has its own dashboard panel, address management, transaction history, and send flow. Switching between chains is one click.

Yes. 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.

Yes. AIW integrates P2Pool decentralized mining. Your CPU mines Monero in the background while the wallet runs. No pool operator, no account, no fees. Payouts go directly to your wallet address in Monero's coinbase transactions. You configure the thread count and CPU priority so mining doesn't interfere with daily use.

The Queen's Decree. If something happens to you, the wallet monitors for inactivity. After a configurable period with no usage, it sends a notification to your trusted contact. After a countdown period, it automatically converts all crypto to BTC and sends it to a beneficiary address. Your family receives Bitcoin and sells it for USD. They never touch a seed phrase, never learn crypto, never interact with a blockchain.

Android app running today. iOS when a Mac build is available. The mobile app connects to your desktop AIW server over your local network. Bitcoin, Litecoin, and Ethereum work standalone from the phone. Monero routes through your server because privacy requires your own node.

Yes — the Mad Hatter's Tea Party. Set a USD amount and an interval and AIW buys XMR on schedule (USD → BTC → XMR) with a hard spending cap you control. Dollar-cost average into Monero without a custodian or a third-party app.

Yes. Trezor and Ledger. The private keys stay on the device — AIW never sees them. Every spend blocks until you physically confirm on the hardware itself.

Yes. A pipeline converts XMR → BTC (atomic swap) → USDC (SideShift, Tor-routed) → an instant virtual Visa card. Spend self-custodied funds anywhere cards are accepted, without a bank or KYC exchange in the middle.

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 has built-in P2Pool mining, the Queen's Decree inheritance system, and manages four chains from one interface. 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, mining, 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, node, swaps, AI, mining, inheritance planning — all self-hosted, all self-sovereign.

About 35 GB for the pruned Monero blockchain. Bitcoin, Litecoin, and Ethereum use remote nodes so they need zero local storage. The AIW application itself is under 50 MB. Total: ~35–40 GB.

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.

Any modern computer with 4 GB+ RAM, running Windows, macOS, or Linux. Docker Desktop for the Monero node. Node.js 20+. That's it.

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.