Everything you need to install, secure, and use FIO Wallet. Practical steps, concepts, and best practices with a clean, readable layout.
FIO Wallet replaces unreadable public keys with FIO Handles like you@fio, while keeping assets on their native chains. Nothing custodial, nothing centralized.
# Concept FIO Handle: you@fio Maps to: BTC, ETH, USDT, ... addresses you control Benefits: Fewer mistakes, readable identity, cross-wallet support
The app is a local, non-custodial client. Private keys are derived from a recovery phrase and stay on your device.
# Components UI Layer → renders balances, requests, and FIO mapping Wallet Core → key mgmt, signing, address book Network Adapters→ query endpoints, broadcast transactions FIO Module → register handle, map addresses, payment requests
Choose Windows, macOS, or Linux builds from the Downloads page, then follow the on-screen setup.
# System requirements
OS: Windows 10/11 · macOS 12+ · Ubuntu 20.04+/Fedora 38+
RAM: 4 GB minimum · Disk: ~500 MB free
Net: Stable connection for updates
Pick a passcode, write down the recovery phrase on paper, confirm each word, enable biometric unlock if available.
Select Restore, enter the phrase, set a new local passcode. Keep the app open until balances appear.
A FIO Handle is your human-readable identity. It’s decentralized, NFT-owned, and can point to multiple blockchain addresses.
Choose a handle like alex@fio. The wallet checks availability and submits an on-chain registration.
Link BTC, ETH and other addresses. Funds remain on their native chains; mappings can be updated anytime.
Send to a FIO Handle or request crypto with an invoice-like flow. The wallet resolves the right chain/address automatically.
# Safety checklist ✔ Double-check amount & asset ✔ Ensure handle spelling is correct ✔ Wait for confirmations
Recovery phrase never leaves your device. Keys are derived locally. You control your assets.
Restore the wallet with your recovery phrase on any supported OS. Mappings and settings resync after launch.
Optional mode minimizes network chatter and UI telemetry. Works behind VPN/firewall and respects system DNS rules.
# Example config { "privacyMode": true, "fiat": "USD", "priceUpdates": "manual" }
Power users can override non-critical defaults via a local JSON file. Invalid fields are ignored safely.
# config.override.json { "autoUpdate": true, "fiat": "EUR", "language": "en", "expertMode": false }
Boost your speed with global shortcuts.
Ctrl/⌘ + K → Quick actions Ctrl/⌘ + F → Search Ctrl/⌘ + , → Settings
Check connectivity, leave the app open for resync, verify system time. Restart if needed.
Name may be taken or pending. Try a variant or wait for chain confirmation.
Restore with the recovery phrase and choose a new local passcode.
FIO Handle — readable identity like you@fio mapping to your addresses.
Mapping — association between a handle and a specific chain address.
Request — an invoice-like on-chain ask to pay a certain amount/asset.
Replace these entries with your real releases when ready.