Welcome to the EtherFlyer Wallet documentation. This comprehensive guide will help you understand and utilize all features of our multi-chain cryptocurrency wallet.
EtherFlyer Wallet is a fully non-custodial, multi-chain wallet designed to run locally on your device. Private keys never leave your machine, and all sensitive operations—such as signing transactions or generating recovery phrases—are performed offline. The application connects directly to supported blockchain networks to ensure accurate balances, real-time fee estimates, and reliable transaction history.
Whether you're setting up your first crypto wallet or migrating from another provider, this documentation walks you through each step of the process. You’ll learn how to create or import a wallet, manage multiple chains, interact with decentralized exchanges, and integrate additional tools that extend the functionality of EtherFlyer.
Before you begin, ensure you are using the latest version of EtherFlyer Wallet downloaded from the official website. This guarantees access to the newest features, security patches, and improved network stability.
Installation
EtherFlyer Wallet is available for Windows, macOS, and Linux. Installation takes only a few minutes and does not require additional dependencies. Before installing, ensure your system meets the minimum hardware and OS requirements listed on the download page.
System Requirements
Windows: Windows 8 / 10 / 11 (32-bit & 64-bit)
macOS: macOS 11 Big Sur or later (Intel & Apple Silicon)
Visit the official EtherFlyer download page and choose the installer for your operating system. Each release is signed and verified to ensure authenticity.
2
Run the installer
Launch the .exe, .dmg, or .AppImage file. Follow the on-screen instructions to complete the setup. No additional drivers or frameworks are required.
3
Launch EtherFlyer
Open the application from your Start menu, Applications folder, or executable path. On the first launch, the wallet will automatically begin synchronizing with supported networks.
Initial sync may take several minutes depending on your connection. Do not close the app until synchronization is complete.
Updating EtherFlyer
The wallet checks for updates automatically and notifies you when a new version is available.
Updates include improvements to:
network sync
performance
security patches
token lists
UI components
You can update from inside the app or download the latest build manually.
Always download updates from the official EtherFlyer website. Third-party sources may contain modified or unsafe binaries.
First Launch & Sync
When you open EtherFlyer for the first time, the app performs an initial synchronization step. This ensures that network data, token lists, fee presets, and connection settings are all up-to-date before you create or import a wallet. Completing this step first helps avoid missing balances, outdated gas estimates, and incorrect network states later.
What Happens During Sync
Latest chain configurations and RPC endpoints are loaded
Token lists and metadata are refreshed
Gas presets and recommended fee levels are pulled
The app checks network connectivity and service availability
Internal modules are initialized so transactions and swaps behave correctly
If the app cannot sync, wallet creation and import will remain locked. This is intentional to prevent setting up a wallet on incomplete or outdated network data. Once synchronization succeeds, all onboarding options will become available automatically.
How Long It Takes
In most cases, the initial sync finishes within 10–60 seconds, depending on your network speed and the number of supported chains being updated.
If you're launching the app on a slower or unstable connection, the process may extend to a couple of minutes, especially when downloading full token lists or RPC presets for the first time.
Longer sync times can occur when:
You’re on public Wi-Fi or a weak mobile hotspot
DNS or VPN routing slows down requests
A large token-list update was recently published
The connection briefly drops and the app retries
The sync bar will update in real time so you can see progress.
Tips for Smooth Sync
Do not close the app until the progress bar reaches 100% — this prevents partial configuration.
If your internet connection drops, EtherFlyer will retry automatically without losing progress.
On subsequent launches, sync is much faster because only incremental updates are fetched.
If the app appears stuck, switching networks (Wi-Fi → cable, or turning off VPN) often resolves the issue.
You can always check the sync status in the footer after onboarding — background refreshes happen automatically.
Create or Import a Wallet
EtherFlyer allows you to set up a wallet in two ways: creating a new one or restoring an existing one through a standard recovery method. These options become available only after the initial network sync, ensuring that token lists, RPC connections, and supported chains are fully loaded before setup. The wallet operates on a non-custodial model, meaning keys and sensitive data stay encrypted locally on your device at all times. This approach ensures that you maintain full control over your assets without relying on third-party storage.
The setup process is designed to be straightforward, even for users managing multiple wallets or moving from another provider. Once your wallet is created or imported, the app automatically prepares your environment, loads balances, and configures network settings so you can start working without manual adjustments.
Creating a New Wallet
To create a new wallet, choose Create Wallet during the first-time setup. You will be prompted to set a secure password that protects access to your local wallet file and encrypts stored keys. After confirming your password, EtherFlyer generates a 12- or 24-word recovery phrase, which acts as your offline backup. The app includes a short verification step to ensure the phrase is saved correctly before you continue.
Once the wallet is created, EtherFlyer loads supported networks and token lists in the background, giving you immediate access to balances, transfers, and swapping features. New wallets follow widely used standards, making them compatible with hardware wallets and other non-custodial tools should you decide to migrate or expand your setup later.
Additional notes
New wallets use BIP39 mnemonic formatting for broad compatibility across the ecosystem.
All sensitive data is encrypted locally, ensuring that the wallet remains secure even on shared machines.
You can enable hardware wallet support or configure read-only access after setup if needed.
Importing an Existing Wallet
If you already use another non-custodial wallet, you can restore it by selecting Import Wallet and entering your 12- or 24-word BIP39 recovery phrase or the corresponding private key. Upon import, EtherFlyer rebuilds your addresses locally and performs a short network scan to refresh balances, approvals, and token visibility. This ensures the restored wallet behaves consistently with your previous setup.
Imported wallets have access to the same features as newly created ones, including transfers, swaps, and hardware wallet connection. You can switch between multiple imported wallets inside the app, allowing you to separate trading, long-term storage, or testing environments without maintaining multiple installations.
Additional notes
Importing works with most major wallets, including Ledger, Trezor, MetaMask, and Trust Wallet.
EtherFlyer does not alter imported data; all keys remain stored exactly as provided.
Multiple wallets can be imported and managed within the same installation.
Your recovery phrase is the only way to restore access to your funds. EtherFlyer cannot view, retrieve, or reset your phrase, and losing it means permanently losing access to the assets stored in that wallet. Always write the phrase down, avoid digital storage such as screenshots or cloud notes, and keep the physical copy in a safe, private location. Proper handling of the phrase ensures your wallet remains secure even in case of device loss or hardware failure.
Backup & Recovery
Protecting your wallet through proper backup procedures is essential for maintaining access to your digital assets.
Recovery Phrase
Your recovery phrase is the master key to your wallet. It consists of 12 or 24 randomly generated words that can restore your entire wallet on any device.
Recommended ways to store your phrase:
1
Write it on paper and keep it in a private location.
2
Create a second copy stored in a separate place.
3
Avoid digital formats like screenshots, cloud notes, or messaging apps.
Keeping your phrase offline protects it from accidental exposure or unauthorized access.
Additional Backup Options
EtherFlyer also creates an encrypted local wallet file that stores your addresses and settings. This file is protected by your password and allows quick access on the same device. While it helps with everyday use, it cannot restore your wallet on a new machine without the recovery phrase.
If you use a hardware wallet, the device itself acts as a secondary backup. Keys remain stored on the hardware wallet, and you can reconnect it to EtherFlyer at any time.
These options increase convenience, but they do not replace the recovery phrase.
Restoring Access
To restore your wallet, choose Import Wallet on the startup screen and enter your 12- or 24-word recovery phrase. EtherFlyer rebuilds your wallet locally, reloads balances, and updates token lists based on current network data. This works the same whether you are recovering after a reinstall, switching systems, or moving to a new computer.
After restoration, all features—transfers, swaps, integrations, and hardware wallet support—work without additional configuration.
EtherFlyer cannot recover a lost recovery phrase and cannot reset or regenerate keys. If the phrase is lost, access to the wallet is permanently lost as well. Storing at least one secure offline copy is mandatory, and keeping a second backup is recommended for long-term safety.
Send & Receive
Sending and receiving assets in EtherFlyer is designed to be clear and predictable, even when working across different networks. The wallet loads your balances, recent activity, and supported assets automatically, so transfers require only a few basic inputs. Every transaction is signed locally, and EtherFlyer shows all relevant details before you confirm anything on-chain. Receiving assets is even simpler, as each wallet address is generated deterministically from your recovery phrase and remains consistent across devices.
Transfers rely on network conditions, so fees and confirmation times vary depending on the chain you are using. EtherFlyer displays estimated gas usage, the current load, and the expected cost before you submit a transaction. This helps you choose the right moment to send funds or switch networks if needed.
Sending Assets
To send cryptocurrency, open the Send tab on the asset you want to transfer. Enter the recipient’s address, select the amount, and review the transaction summary. EtherFlyer shows network fees, the total cost, and any required approvals if you are sending a token for the first time. You can adjust the gas level to match current conditions or accept the recommended option for typical use.
Steps to send:
1
Choose a network and asset
2
Enter the destination address
3
Set the amount you want to transfer
4
Review fees, approvals, and final totals
5
Confirm the transaction to sign and broadcast it
Once submitted, the transaction appears in your activity list with a real-time status indicator.
Receiving Assets
Receiving funds does not require additional configuration. Select Receive to view your address for the active network. EtherFlyer automatically generates and displays the correct address and QR code for quick sharing. Each network uses a separate address format, so it’s important to verify you are sharing the correct one for the asset being sent.
Key points for receiving:
Always confirm you selected the correct network.
Share the QR code or copy the address directly.
Incoming transactions appear automatically once confirmed on-chain.
You do not need to approve or sign anything to receive funds.
Tips for Reliable Transfers
Double-check the network before sending; using the wrong one may result in lost funds.
If fees are unusually high, wait for network conditions to improve.
For ERC20 tokens, an approval may be required before the first transfer.
Large transfers should be tested with a small amount first when sending to a new address.
Swaps on EtherFlyer DEX
EtherFlyer Wallet includes built-in swap functionality that lets you trade assets directly through the EtherFlyer DEX without leaving the app. Swaps run on smart contracts, and every trade is signed locally on your device, ensuring full control over approvals and execution. The interface presents rates, fees, and liquidity details in a clear format so you understand what will happen before confirming a swap. Balances update automatically once the transaction is confirmed on-chain.
Swaps depend on market liquidity, network congestion, and your chosen slippage settings. EtherFlyer highlights any conditions that may affect execution, such as large price impact or low liquidity, and allows you to adjust parameters before submitting the transaction.
Performing a Swap
To swap tokens, open the Swap tab and select the asset you want to trade and the asset you want to receive. The app automatically retrieves current pricing and route options based on what the EtherFlyer DEX supports. Before executing the trade, you will see a summary that includes estimated output, network fees, and any required approvals.
Steps to complete a swap:
1
Choose the token you want to swap from.
2
Select the token you want to receive.
3
Review estimated output, fees, and route details.
4
Adjust slippage or gas settings if needed.
5
Confirm the trade and sign the transaction.
If a token requires approval, the app will ask for it once before the first swap.
Price Impact, Slippage, and Fees
Swaps include several adjustable parameters that affect execution. EtherFlyer shows these values clearly and updates them based on market activity so you can make informed decisions.
Key elements:
Price Impact: Indicates how much your trade size affects the market price.
Slippage Tolerance: A limit that defines how much the final price may differ from the quoted one.
Network Fees: Gas costs based on current network conditions.
DEX Fees: Standard fees applied by the EtherFlyer DEX smart contracts.
Lower liquidity and high volatility may require adjusting slippage for the trade to succeed.
After the Swap
Once your swap is submitted, you can monitor its status in the activity section. The wallet updates your balances as soon as the transaction is confirmed. If a swap fails due to slippage or network issues, EtherFlyer provides a clear error message so you can retry with updated settings.
Networks & Fees
EtherFlyer supports multiple networks so you can manage assets and perform swaps across different ecosystems without switching tools. Each network has its own fee model, confirmation speed, and token formats, and the wallet presents these details clearly before you sign a transaction. Balances, gas estimates, and network status update automatically, allowing you to choose the best time and chain for your activity.
Network switching does not require re-importing your wallet or changing any settings. EtherFlyer loads network configurations during the initial sync and keeps them updated with each launch. When you change networks, the app switches addresses, token lists, and fee parameters instantly, ensuring the correct environment is always used for your actions.
Supported Networks
EtherFlyer works with Ethereum-compatible networks and other supported chains, depending on your configuration. Each network has its own address format and fee model, and EtherFlyer adjusts the interface accordingly.
Key points:
Network selection automatically updates your active address.
Token availability depends on the chain you select.
Fees and confirmation times vary by network load.
Switching networks affects how assets and transactions appear, so always verify you’re on the correct chain before sending funds or initiating swaps.
Understanding Fees
Each transaction on a blockchain requires a fee paid to network validators. EtherFlyer shows fee estimates in real time and updates them based on current network activity. Fees differ between sending tokens, approving a smart contract, and executing swaps.
Types of fees you may see:
Gas Fees: Required for all transactions; based on network congestion.
Approval Fees: One-time cost when using a token with a smart contract for the first time.
Swap Fees: Applied by the EtherFlyer DEX smart contracts for executing trades.
Fees are always shown before you sign, and the wallet never adds its own hidden charges.
Gas Settings
You can adjust gas settings when sending or swapping assets. EtherFlyer provides recommended values based on current load, but you can fine-tune them if needed.
Gas options include:
Standard: Balanced cost and confirmation speed.
Fast: Higher fee for quicker confirmation.
Custom: Manual gas limit and fee options for advanced users.
Setting gas too low may cause the transaction to stall or fail, while higher fees improve priority during busy periods.
Tips for Network Reliability
Reliable network performance ensures your transactions are processed smoothly and show the correct status inside the wallet. Different chains experience varying levels of congestion, so it’s normal for fees and confirmation times to fluctuate throughout the day. EtherFlyer updates network conditions automatically, but understanding a few practical guidelines can help you avoid delays, stuck transactions, or sending assets to the wrong chain.
Recommendations for stable operation:
Always confirm that the selected network matches the asset you plan to send.
If fees rise sharply, consider waiting for more stable conditions before submitting a transaction.
ERC20 and similar tokens may require a one-time approval before the first swap or transfer.
When a transaction seems stuck, check the current gas prices to see if they are higher than your submitted fee.
Avoid switching networks mid-action; complete or cancel the current operation first.
These tips help reduce failed or delayed transactions and ensure smoother interaction with all supported chains.
Add a Custom Token
Not all tokens appear in EtherFlyer by default, especially newer assets, small-cap projects, or tokens deployed on less active networks. If a token is missing from your balance list, you can add it manually using its contract address. Once added, the token behaves like any other supported asset and updates its balance automatically based on on-chain data.
Custom tokens are tied to the network you currently have selected. This means a token added on one chain will not appear on another unless you add it there as well. EtherFlyer reads all information directly from the contract, including the token name, symbol, and decimals, so the wallet displays accurate details without needing external metadata sources.
How to Add a Custom Token
To add a custom token, open the Add Token section inside the wallet and paste a valid contract address. EtherFlyer automatically fetches required metadata and previews the token before you confirm.
Steps to add a custom token:
Select the correct network where the token exists.
Open the Add Token panel.
Paste the token’s contract address.
Verify the name, symbol, and decimals loaded by the wallet.
Confirm the addition to make the token appear in your list.
Once added, balances update in real time based on your wallet’s address.
Where to Find Contract Addresses
To avoid mistakes, always use reliable sources when copying contract addresses. Fake or incorrect contracts may lead to displaying the wrong token or no token at all. Most legitimate projects provide address information on official channels.
Trusted sources include:
Official project websites or documentation
Verified listings on explorers like Etherscan or similar services
Reputable DEX interfaces that show contract details
Hardware wallet or multi-sig documentation pages
Avoid copying contracts from random posts, screenshots, or unverified channels.
Troubleshooting Token Visibility
If a token does not appear after being added, check the following:
Make sure you selected the correct network for that token.
Confirm that your wallet address actually holds the token.
Re-check the contract address for typos or extra characters.
Verify that the token uses a standard interface compatible with EtherFlyer.
Some niche or experimental tokens may use non-standard contracts that display balances differently. These can still be added, but visibility or metadata may vary based on implementation.
Hardware Wallets
Hardware wallets provide an extra layer of protection by keeping your private keys fully offline, even while interacting with EtherFlyer. When connected, they allow you to review and approve every transaction directly on a secure physical device. This setup is ideal for users who prioritize maximum security, regularly move large amounts, or simply prefer signing sensitive actions on isolated hardware rather than a desktop environment.
EtherFlyer integrates with leading hardware wallets to offer safe signing, smooth account management, and a consistent experience across supported networks. The app never accesses, stores, or transfers your private keys — all critical operations remain inside the hardware device, while EtherFlyer only relays the transaction data that requires approval.
Supported Hardware Devices
EtherFlyer currently supports the most widely used hardware wallets.
Compatibility includes:
Ledger devices (Nano S, Nano S Plus, Nano X) — recommended for multi-chain activity
Trezor devices (Model One, Model T) — ideal for clear transaction review
Any HID-compatible device using standard signing protocols
Support may expand over time as more devices adopt open signing interfaces.
Connecting a Hardware Wallet
Connecting a hardware wallet to EtherFlyer is straightforward. Once recognized by the app, your accounts and balances become visible, but the keys never leave the device.
Steps to connect:
1
Plug in your hardware wallet and unlock it.
2
Open the appropriate app on the device (Ethereum, Bitcoin, etc.).
3
In EtherFlyer, open Hardware Wallets → Connect Device.
4
Select your device when it appears in the list.
5
Approve the connection request on your hardware wallet if prompted.
After approval, your addresses load automatically, and you can select them just like regular software wallet accounts.
Using Hardware Wallet Accounts
Once connected, you can use your hardware-secured accounts across EtherFlyer:
Send and receive assets across supported networks
Sign swaps, approvals, and cross-chain operations
View balances and historical transactions
Add custom tokens to your hardware-managed addresses
Every action requiring authorization will appear on your device’s screen for confirmation.
A few best practices help ensure stable operation:
Keep your hardware wallet firmware up to date.
Make sure the correct blockchain app is open on your device before sending or signing.
Use a high-quality USB cable to prevent intermittent disconnects.
Avoid running multiple wallet apps simultaneously, as they may conflict.
If a device is not detected, reconnect it or restart EtherFlyer.
Hardware wallet integration is designed to be reliable, but USB permission issues or outdated firmware can occasionally interrupt the process.
Integration Hub
Overview
The Integration Hub expands EtherFlyer by providing optional tools, automations, and community-built utilities that enhance what the wallet can do out of the box. Instead of overwhelming users with built-in complexity, EtherFlyer keeps the core experience clean and fast, while integrations handle more specialized workflows such as analytics, monitoring, exporting data, or automating repetitive tasks. This creates a flexible environment where
How Integrations Work
Integrations connect to EtherFlyer without ever accessing private keys or modifying the wallet’s internal security model. The wallet provides the necessary network data, event feeds, and transaction interfaces, while each tool adds its own functionality on top. Many integrations run independently from the wallet UI, acting as lightweight helpers that read asset information, evaluate market conditions, or prepare insights for the user. Others work more closely with the app, adding visual dashboards or quick-action utilities that improve navigation or decision-making.
Types of Integrations
Most integrations fall into several core categories. While each tool has its own purpose, they generally align with one of the following workflows:
Automation Tools — handle routine operations such as balance syncing, gas-price watching, or scheduled exports.
Trading Utilities — support price monitoring, swap analysis, liquidity tracking, and chain-to-chain comparisons.
Data & Analytics — generate dashboards, historical overviews, portfolio summaries, and real-time activity charts.
Community Extensions — user-built add-ons like scripts, UI helpers, or micro-apps that enhance navigation or add shortcuts.
Connectivity Tools — link EtherFlyer to external services such as GMGN, DexScreener, Telegram bots, or portfolio trackers.
Developer Tools — SDK helpers, wrappers, or libraries that allow builders to create new features using EtherFlyer data.
These categories help users quickly understand what each integration does and choose the tools that best fit their workflow, whether they want automation, insight, or extended connectivity.
Built by the Community
A significant portion of EtherFlyer’s ecosystem is created by independent developers experimenting with ideas that later evolve into tools used at scale. Many integrations begin as lightweight prototypes—something as small as a price-alert script or a personal data-export utility—and grow into stable, community-endorsed additions. EtherFlyer highlights impactful tools, provides reference materials, and supports contributors with optional grants or rewards to encourage continued development.
A Growing Ecosystem
The Integration Hub is intentionally designed to remain open-ended. New integrations appear as networks evolve, as user needs expand, and as builders propose creative solutions to everyday problems. Some tools eventually receive official support or enhanced visibility inside the wallet, while others serve niche workflows within smaller communities. This fluid and community-driven growth ensures EtherFlyer stays flexible without forcing unnecessary features on every user.
Troubleshooting & Logs
General Troubleshooting
If EtherFlyer behaves unexpectedly — slows down, fails to sync, displays outdated balances, or refuses to broadcast a transaction — most issues can be resolved without reinstalling the wallet. Many problems are caused by poor network connectivity, temporary RPC delays, or outdated cache data. Restarting the app triggers a fresh attempt to sync networks and token lists, which often resolves temporary inconsistencies. Before applying deeper fixes, ensure your internet connection is stable and that no firewall or VPN is blocking access to blockchain nodes.
When Sync Issues Occur
Sync problems typically appear as empty balances, delayed updates, or networks stuck on “Refreshing…”. These situations are usually the result of overloaded RPC endpoints or local cache conflicts. EtherFlyer retries requests automatically, but if syncing remains stalled, you can manually reset the network data through the Settings panel. This clears cached metadata, token lists, and temporary files without affecting your wallet or keys. After a reset, the app performs a clean synchronization cycle.
Common sync fixes:
Toggle the affected network off and on again.
Clear the wallet’s cache from Settings → Maintenance.
Restart the app to trigger a fresh sync cycle.
Check your internet connection or try switching networks/VPN.
UI or Performance Problems
Visual glitches, missing buttons, or sluggish performance are often related to corrupted interface cache or outdated GPU rendering data. EtherFlyer uses a lightweight UI layer but may still experience display issues after system updates or GPU driver resets. If the interface behaves incorrectly, restarting the application usually reloads all components. For persistent issues, you can reset the UI layout through the Maintenance section without losing your wallet or settings.
Failed or Stuck Transactions
Most failed broadcasts are related to incorrect gas settings, non-finalized approvals, or temporary network congestion. When a transaction is stuck, EtherFlyer provides details such as pending duration, nonce, network latency, and suggested actions. If the transaction cannot be sped up or replaced, the wallet will mark it as expired and allow sending a new one with a higher fee. You do not need to reinstall or recreate your wallet — the issue is always network-side.
Reset Options
EtherFlyer includes several safe reset tools that do not affect wallet access or private keys:
Network Reset: clears RPC cache and token metadata.
UI Reset: restores default layouts and visuals.
Data Refresh: forces new balance scans and activity logs.
Log Export: prepares a file for debugging or support requests.
These tools are designed to fix most issues without requiring manual file deletion or complex troubleshooting steps.
Working With Logs
Logs help identify the cause of sync failures, UI freezes, or error messages. EtherFlyer stores logs locally on your device and never transmits them unless you intentionally export them. The log viewer inside the app displays recent events such as network requests, RPC responses, and contract interactions. If you contact community support or submit a GitHub issue, you can attach your exported log file to provide additional context.
Log export includes:
Network status and sync attempts
RPC request/response summaries
UI load events and errors
Transaction broadcast history
Integration-related events (if used)
Personal data, private keys, and sensitive wallet information are never included in logs.
When to Reinstall
Reinstallation is rarely required, but may help if internal files become corrupted or missing due to system cleaners, antivirus actions, or incomplete OS updates. Before reinstalling, always ensure you have your recovery phrase stored offline. After installation, EtherFlyer will sync all networks again and restore your balances automatically.
When to Seek Help
If issues persist after resets and sync attempts, you can reach out through the official community channels. Providing logs, system details, and a short description of what happened greatly speeds up support. Most problems are environmental (network, OS, firewalls) and can be diagnosed quickly with proper logs.
Need More Help?
Join our community or contact our support team for personalized assistance.
