Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

FAQ

General

What blockchains does MUTX support?

Solana and the major EVM L1 / L2 peers:

  • Solana (mainnet, devnet, testnet)
  • Ethereum (mainnet, sepolia)
  • Polygon (mainnet, amoy)
  • Base (mainnet, sepolia)
  • Arbitrum One (mainnet, sepolia)
  • BNB Smart Chain (mainnet, testnet)

You pick the chain and network when you create or import a wallet.

How do I use a custom RPC?

Open the wallet details page and set the custom RPC URL field for that wallet. It applies only to that wallet — there is no global per-chain override. Other wallets keep using the managed MUTX RPC proxy.

Why isn’t my balance refreshing?

It is. Balances and token lists refresh automatically in the background every 30 seconds, and accelerate briefly after you submit a transaction. If you want an immediate refresh, press b in the TUI on the selected wallet.

Is MUTX open source?

No. The public product is distributed as binaries and container images.

Where is my data stored?

All wallet data is stored locally in SQLite databases under ~/.local/share/mutx/. Private keys are encrypted with AES-256-GCM.

No. Wallet access stays in MUTX. Link forwards requests to the TUI over a local Unix socket.

Yes. mutx-link depends on the TUI socket and cannot serve wallet operations by itself.

MCP

Yes, using HTTP mode:

mutx-link serve --mode http --bind 0.0.0.0:8000

The MCP endpoint is /mcp and the health endpoint is /health.

What requires human approval?

request_slk — the SLK draft is queued as a Proposal for operator review and the operator approves, narrows, or denies it. Once the SLK is minted, every subsequent agent op is authorized by the SLK itself; no per-call approval. Operator-direct ops in the TUI / Web UI never need approval.

Can an SLK be revoked immediately?

Yes. The holder agent can call slk_revoke (proof-of-possession, permission-reducing, no human approval needed), or the operator can revoke it from the SLKs tab.

TUI

Can I use Docker for the TUI?

Yes, but it must run with an interactive TTY and persistent volumes for config, data, and the shared socket directory.

Which tab should I watch during operation?

  • Proposals to review and approve / deny / narrow SLK drafts from agents
  • SLKs to inspect active keys, usage, and revoke
  • Activity to audit per-dispatch log entries
  • DApps for WalletConnect proposals and sessions
  • Logs for troubleshooting and audit context