Mist Wallet Documentation

Intro

Quick Start

1. Install the appGrab your OS build from the homepage.

2. Create or import a walletYour seed phrase stays local. We never see it.

3. Connect networksMainnet / L2 / testnets — default presets or manual config.

Tip: If you prefer calmer UI, enable “Reduced Motion” in your OS/browser — animations will ease automatically.

Install

Installation

Run MistSetup.exe and follow the wizard. On first launch, allow SmartScreen.

choco install mist-wallet --version=1.0.0
powershell -Command "Start-Process 'C:\Program Files\Mist Wallet\Mist.exe'"

Open the .dmg, drag the icon to Applications. Allow Gatekeeper on first run.

brew tap mistlabs/tap
brew install --cask mist-wallet
open -a "Mist Wallet"

We ship .AppImage, .deb and .rpm. Extra flags available for Wayland.

# Debian/Ubuntu
sudo dpkg -i mist-wallet_1.0.0_amd64.deb || sudo apt -f install

# Fedora
sudo rpm -i mist-wallet-1.0.0.x86_64.rpm

# AppImage
chmod +x MistWallet-1.0.0.AppImage
./MistWallet-1.0.0.AppImage --no-sandbox

Config

Configuration

Settings are stored locally. Below are key options and defaults.

Key	Type	Default	Description
`network.default`	string	`ethereum`	Default chain on first run.
`telemetry.enabled`	boolean	`false`	Optional anonymous telemetry opt-in
`rpc.endpoints`	map<chain, url>	—	Custom RPC with multi-provider support.
`security.autoLock`	number	`900`	Auto-lock (seconds).
`backup.reminderDays`	number	`7`	Seed backup reminders cadence.

// config.json (example)
{
  "network": { "default": "ethereum", "chains": ["ethereum","optimism","arbitrum"] },
  "rpc": {
    "ethereum": "https://rpc.ankr.com/eth",
    "optimism": "https://mainnet.optimism.io"
  },
  "telemetry": { "enabled": false },
  "security": { "autoLock": 900 }
}

SDK

Developer SDK

Integrate Mist as a wallet provider in your dApp: EIP-1193 bridge, signing, sending transactions, network switching.

npm i @mistlabs/sdk

import { MistProvider } from "@mistlabs/sdk";

const provider = await MistProvider.detect({ prefer: "desktop" });
const [address] = await provider.request({ method: "eth_requestAccounts" });
const chainId = await provider.request({ method: "eth_chainId" });
// Signing:
const sig = await provider.request({
  method: "personal_sign",
  params: ["0x68656c6c6f", address]
});

EIP-1193 compatibleWorks with major dApp frameworks.

Multi-chainEthereum, key L2s, and testnets.

Secure requestsOn-device signing. Keys never leave local storage.

Security

Security & Backups

Seed phrase stays offline. Don’t photograph it; avoid cloud storage.
Auto-lock. Keep ≤ 15 min if you often step away.
Updates. Keep Mist current — security patches ship regularly.

Important: We cannot recover private keys. You’re the sole custodian of your funds.

CLI

CLI & Automation

The desktop bundle includes a mist utility for scripting and CI.

# List accounts
mist accounts list

# Send a transaction (example)
mist tx send \
  --to 0xAbC...123 \
  --value 0.05eth \
  --gas 21000 --gas-price 18gwei \
  --chain mainnet

# Sign arbitrary data
mist sign --data 0x68656c6c6f --account 0xYourAddress

Recipes

Common Recipes

Switch RPC provider Settings → Networks → Edit → paste URL, save, restart.

Use a hardware wallet Connect Ledger/Trezor via USB and enable “Use hardware wallet”.

Import a “watch-only” address Add a public address to monitor balances without private keys.

Troubleshooting

Diagnostics & Errors

For tricky cases, enable “Diagnostics” (Settings → Advanced), reproduce the issue, then attach the log when contacting support.

# Log locations (example paths)
Windows: %APPDATA%\Mist\logs\
macOS:   ~/Library/Logs/Mist/
Linux:   ~/.config/mist/logs/

Signature	Cause	Resolution
`RPC timeout`	Congested network / provider down	Switch RPC, increase timeout, retry
`Ledger not found`	No USB/WebHID permission	Grant access, replug the device
`Insufficient funds`	Not enough for gas	Fund the wallet, lower gas limit/price

FAQ

Frequently Asked Questions

Where is the seed phrase stored?

Locally on your device in encrypted storage. It’s never transmitted to our servers.

Can I disable telemetry?

Yes. Settings → Privacy → toggle off “Telemetry”. Functionality is unaffected.

Are custom networks supported?

Yes. Add RPC, chainId, currency symbol and a block explorer under Networks.