Wallet Recovery Tools Offline

About

Wallet Recovery Tools Offline is a self-contained, air-gapped build of Wallet Recovery Tools. It is intended for offline derivation and recovery utilities:

• derive public addresses + metadata offline and export a file
• restore a mnemonic when exactly one word is missing

Then you can move the exported file to an online session and scan balances via Import Offline in the online app.

What this app can and can’t do

Works offline:

• Address derivation and address preview
• Export an offline file with public addresses + metadata
• Restore mnemonic (exactly 1 missing word) and download found candidates

Not available offline:

• Balance scanning (credits / API key operations)

Key features

• Truly offline after download
• Exportable offline file with public addresses + metadata (no secrets)
• Restore mnemonic when exactly 1 word is missing
• Same security approach as the web app (secrets are not kept in memory across screens; explicit password prompts are used where required)

Choose the right distribution

Your system	CPU architecture	Download (example filename)
macOS (Intel)	x86_64	wallet-recovery-tools-offline-darwin-amd64.zip
macOS (Apple Silicon M1/M2/M3)	arm64	wallet-recovery-tools-offline-darwin-arm64.zip
Linux (most PCs/servers)	x86_64	wallet-recovery-tools-offline-linux-amd64.zip
Linux (ARM64)	arm64	wallet-recovery-tools-offline-linux-arm64.zip
Windows 10/11 (64-bit PCs)	x86_64	wallet-recovery-tools-offline-windows-amd64.zip

Check your architecture

• macOS: uname -m → x86_64 or arm64
• Linux: uname -m → x86_64 or aarch64/arm64
• Windows: most devices are x86_64

How to use

Step 1: Install and run

1. Download the bundle for your OS (see table above).

2. Unarchive it. Ensure the wallet-recovery-tools and signer folders sit in the same directory as the executable. After downloading the ZIP for your platform:

   • Windows: Right-click the .zip → "Extract All..." → choose a directory → "Extract"
   • MacOS/Linux: Use built-in archive manager or run unzip in terminal

   This will create a folder like:

   wallet-recovery-tools-offline-windows-amd64/
   ├── wallet-recovery-tools-offline-windows-amd64.exe
   ├── wallet-recovery-tools/
   └── signer/

3. Run the executable.

• Windows: double-click wallet-recovery-tools-offline-windows-amd64.exe. A terminal window should open.
• macOS / Linux:

chmod +x wallet-recovery-tools-offline-<your-arch>
./wallet-recovery-tools-offline-<your-arch>

Example (Linux amd64):

./wallet-recovery-tools-offline-linux-amd64

A local server starts and your default browser opens:

• wallet-recovery-tools at http://localhost:5174
• signer iframe at http://localhost:5001

Air-gap hygiene

Use a dedicated browser profile with no extensions and disable the network when possible.

---

Offline address derivation

This flow is the offline equivalent of the online Balance scan → Start flow, but instead of scanning, it ends with exporting an offline file.

If you need the full online scanning flow, see Wallet Recovery Tools.

Step 1: Follow the standard setup flow

The steps are the same as Balance scan → Start:

• choose wallet preset
• select chains
• set address range
• enter mnemonic (words / Secure QR / plain QR)
• create a password (local session)

Offline behavior

In offline mode, paid operations are disabled, so you won’t see balance scanning.

Step 2: Derive addresses

In the final step you will only be able to proceed with Preview Addresses (derivation output).

Step 3: Preview and download the offline file

On the preview screen you can still:

• review derived addresses per network
• remove networks
• adjust per-network ranges (filter icon)
• adjust derivation settings (gear icon)

When ready, click Download Addresses to export the offline file.

Set advanced settings before exporting

If you need non-standard derivation parameters, open Advanced settings (gear icon) and adjust them before exporting. Once exported, the file is meant to be scanned later and derivation settings can’t be modified during Import Offline.

Exported file contents

The exported file contains only public addresses and address metadata. No private keys, no mnemonics, and no passwords are exported.

Step 4: Scan balances later (online)

Move the exported file to an online device/session and use:

• Balance scan → Import Offline

From there, scanning works like the online flow (API key + credits may be required).

---

Restore Mnemonic (offline)

Overview

Restore Mnemonic works offline as well, but without any balance scanning.

For the full Restore Mnemonic feature description, see Restore mnemonic.

Step 1: Enter the mnemonic with 1 blank word

• enter the seed phrase
• leave exactly one word empty
• enable 24-word mode if applicable
• click Next

Limitation

This tool is designed for one missing word only. If more than one word is unknown, the tool won’t allow you to proceed.

Step 2: Create passwords (security model)

You will see two password prompts. This is intentional: the app does not persist the mnemonic between isolated contexts/screens and requires explicit unlock steps.

Step 3: Review and download found mnemonics

You can:

• select one or more candidates
• download selected mnemonics to a file

Handle restored mnemonics carefully

Treat exported mnemonic files as highly sensitive. Store them securely and avoid moving them to online systems unless necessary.

Step 4: Derive addresses for restored mnemonic (optional)

Hover a specific mnemonic row to reveal Derive Addresses, then click it.

You’ll be taken to the same Offline derivation flow for that mnemonic.

---

Security and privacy notes

• All operations run locally in your environment.
• The app is designed to avoid persisting secrets between steps; you may be asked to re-unlock flows with a password.
• Your data (e.g., session state) is stored locally in the browser profile (e.g., IndexedDB).

Limitations

Malware or untrusted browser extensions can defeat local security. Use a clean machine/profile.

Troubleshooting

Problem	Solution
index.html not found	Ensure wallet-recovery-tools/ and signer/ are present next to the binary.
App doesn’t open in browser	Open http://localhost:5174 manually.
Binary won’t run (macOS/Linux)	Run chmod +x <binary> and try again.
macOS: “App can’t be opened…”	Right-click → Open → Allow once.
Port already in use	Make sure nothing else is using port 5174 or 5001.