FAQ
Frequently Asked Questions about eckoWALLET - Installation, usage, security, troubleshooting, and more. Find quick answers to common questions.
Quick answers to the most common questions about eckoWALLET. For more detailed information, check the linked guides.
Table of Contents
Getting Started
How do I install eckoWALLET?
Visit https://eckowallet.com to download:
Browser Extension: Chrome, Edge, Brave, Opera (Chrome Web Store)
iOS: Apple App Store
Android: Google Play Store
📖 Detailed Guide: Installation & Setup
Is eckoWALLET free?
Yes! eckoWALLET is completely free to download and use. You only pay:
Blockchain transaction fees (gas) when sending transactions
Network fees are paid to Kadena validators, not to eckoWALLET
What platforms does eckoWALLET support?
Browser Extension:
Chrome, Edge, Brave, Opera
Works on Windows, macOS, Linux
Mobile App:
iOS 13.0 or later
Android 8.0 or later
Do I need to create an account with eckoWALLET?
No! eckoWALLET is non-custodial:
No registration required
No email or personal information needed
You create a wallet locally on your device
You control your keys and funds
Wallet Management
How do I create a new wallet?
Three main steps:
Set Password: Create a strong, unique password for your wallet
Save Recovery Phrase: Write down your 12-word recovery phrase
Verify Recovery Phrase: Confirm you saved it correctly
📖 Detailed Guide: Creating Your First Wallet
Important: Your recovery phrase is the ONLY way to recover your wallet if you forget your password or lose your device.
How do I restore an existing wallet?
Three main steps:
Enter Recovery Phrase: Input your 12-word recovery phrase
Set New Password: Create a new password for this device
Generate Accounts: Recreate your accounts (they appear in the same order)
📖 Detailed Guide: Restoring an Existing Wallet
Tip: When entering your recovery phrase, copy it to a text editor first to ensure proper spacing, then paste into eckoWALLET.
What is a recovery phrase (seed phrase)?
A recovery phrase is a 12-word sequence that:
Acts as the master key to your wallet
Generates all your private keys deterministically
Allows you to restore your wallet on any device
Must be kept secret and secure
Example format: word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12
I forgot my password. Can I reset it?
No, there is no password reset function. eckoWALLET is non-custodial, meaning we don't store your password.
Solution: Restore your wallet using your 12-word recovery phrase:
Click "Restore Wallet"
Enter your recovery phrase
Set a new password
📖 Guide: Restoring an Existing Wallet
I lost my recovery phrase. Can I recover my wallet?
Unfortunately, no. Without your recovery phrase:
Your wallet cannot be recovered if you lose access
No one, including eckoWALLET team, can help recover it
Your funds will be permanently inaccessible
Prevention: Always write down your recovery phrase and store it securely.
📖 Learn More: Security Best Practices
Can I use the same wallet on multiple devices?
Yes! Use your recovery phrase to restore your wallet on any device:
Install eckoWALLET on the new device
Select "Restore Wallet"
Enter your 12-word recovery phrase
Your accounts will appear in the same order
Note: The password can be different on each device.
Can I change my recovery phrase?
No. Your recovery phrase is permanently tied to your wallet. To get a new recovery phrase:
Create a completely new wallet
Transfer your funds to the new wallet
Securely dispose of the old recovery phrase
Accounts & Keys
What is the difference between a wallet and an account?
Wallet: The software (eckoWALLET) that manages your keys
One wallet can have multiple accounts
Protected by a password
Stored on your device
Account: Your on-chain identifier on Kadena blockchain
Has a unique account name (e.g.,
k:5a2afbc...)Holds balances and transaction history
Can exist on multiple chains
📖 Learn More: Kadena Account Concepts
What is my account name vs my public key?
Account Name: Your unique identifier on the blockchain
Example:
k:5a2afbc631fc209296f5b1b9bfd3956048e3bc40ca3cb62afac329c944be08f5f47This is what others send funds to
Format:
k:{publicKey}for most users
Public Key: Your cryptographic public key (the part after k:)
Example:
5a2afbc631fc209296f5b1b9bfd3956048e3bc40ca3cb62afac329c944be08f5f47Used to verify signatures
Part of your account's keyset
Private Key: Your secret key that controls the account
Never share this!
Used to sign transactions
Encrypted in eckoWALLET
📖 Detailed Explanation: Kadena Account Concepts
How do I create a new account?
In eckoWALLET:
Click the account dropdown (top of wallet)
Click "Create Account" or "+"
Choose account type:
Standard Account: Regular keypair account
Ledger Account: Hardware wallet account
SpireKey Account: WebAuthn account
Name your account (optional, for display only)
Your account is created!
📖 Detailed Guide: Managing Accounts
Can I have multiple accounts?
Yes! eckoWALLET supports unlimited accounts:
All derived from the same recovery phrase
Each has unique keys and account name
Manage them from the account dropdown
Each can have different balances per chain
What are account types (Standard, Ledger, SpireKey)?
Standard Account (Most Common):
Regular software wallet account
Keys stored encrypted in eckoWALLET
Full control from the wallet
Ledger Account:
Hardware wallet integration
Keys stored on Ledger device
Maximum security for large holdings
SpireKey Account:
WebAuthn-based authentication
Uses device biometrics or security keys
Modern authentication method
📖 Learn More: Managing Accounts
Can I import a private key from another wallet?
Not directly. eckoWALLET generates accounts from your recovery phrase.
To access funds from another wallet:
Import that wallet's recovery phrase into eckoWALLET (if compatible)
Or transfer funds from the other wallet to your eckoWALLET account
What are keys and predicates?
Keys: The public keys that control an account
Single-key account: One key controls everything
Multi-key account: Multiple keys control together
Predicate: Determines how many signatures are needed
keys-all: Requires ALL keys to signkeys-any: Requires ANY ONE key to signkeys-2: Requires at least 2 keys to sign
Example: A company treasury with 3 keys and keys-2 predicate requires 2 of 3 executives to approve transactions.
📖 Detailed Explanation: Kadena Account Concepts
Sending & Receiving
How do I send KDA?
Open eckoWALLET
Click "Send" on home screen
Enter recipient's account name
Select chain ID
Enter amount
Review gas fee
Click "Send"
Confirm transaction
📖 Detailed Guide: Sending KDA and Tokens
How do I receive KDA?
Open eckoWALLET
Click "Receive" on home screen
Share your account name (the full
k:...address)Specify which chain to send to
Wait for transaction confirmation
📖 Detailed Guide: Receiving KDA and Tokens
Tip: You can show a QR code for easy scanning.
How do I transfer KDA from an exchange to eckoWALLET?
Open eckoWALLET and copy your account name
Go to your exchange (Coinbase, KuCoin, etc.)
Navigate to KDA withdrawal
Paste your eckoWALLET account name
Select chain (usually Chain 1 for exchanges)
Enter amount and withdraw
Wait for confirmations (usually 2-5 minutes)
Important: Always verify the chain ID with the exchange!
📖 Detailed Guide: Receiving KDA and Tokens
What is a chain ID? Why do I need to specify it?
Kadena has 20 parallel chains (Chain 0 to Chain 19). Your account can exist on multiple chains with separate balances.
When receiving:
Tell the sender which chain to send to
Most exchanges use Chain 1
DeFi apps might use Chain 8 or Chain 13
When sending:
You send from a specific chain
Recipient receives on that same chain
Use cross-chain transfer to move between chains
📖 Learn More: Kadena Account Concepts - Multi-Chain
What are gas fees?
Gas fees are transaction fees paid to Kadena validators for processing your transaction.
Gas Price Levels in eckoWALLET:
Economy: 0.00000001 KDA (slowest, cheapest)
Normal: 0.000001 KDA (recommended)
Fast: 0.0001 KDA (fastest, most expensive)
Typical costs: Less than $0.01 USD per transaction (Kadena is very cheap!)
Why is my transaction pending?
Transactions can be pending for several reasons:
Common causes:
Low gas price (transaction waiting in queue)
Network congestion (rare on Kadena)
Incorrect chain ID
Insufficient balance for gas
Check status:
Click on transaction in history
View on Kadena block explorer
Wait 2-5 minutes for confirmation
📖 Troubleshooting: Transaction Issues
Can I cancel a pending transaction?
Unfortunately, no. Once a transaction is submitted to the blockchain, it cannot be cancelled. You must wait for it to either:
Complete successfully
Fail (if there's an error)
Expire (after TTL timeout, default 8 hours)
What is a cross-chain transfer?
A cross-chain transfer moves KDA from one Kadena chain to another.
Example: Transfer 10 KDA from Chain 1 to Chain 8
Process:
Initiate transfer on source chain (Chain 1)
Wait for confirmation
Complete transfer on target chain (Chain 8)
Funds now available on Chain 8
Use cases:
Move funds to chains where specific dApps operate
Consolidate balances
Access different liquidity pools
📖 Detailed Guide: Cross-Chain Transfers (when created)
Security
Is eckoWALLET safe?
Yes, when used properly. eckoWALLET is:
✅ Non-custodial: You control your keys, not us
✅ Open-source: Code is publicly auditable
✅ Encrypted: Private keys encrypted with your password
✅ No data collection: No personal information stored
Security depends on you:
Keep your recovery phrase secret and safe
Use a strong password
Beware of phishing sites
Never share private keys
📖 Essential Reading: Security Best Practices
What should I do with my recovery phrase?
✅ DO:
Write it down on paper with pen
Store in a secure physical location (safe, safety deposit box)
Consider metal backup for fire/water resistance
Keep multiple copies in different secure locations
Tell trusted family members where to find it (in case of emergency)
❌ NEVER:
Screenshot or photograph it
Store in cloud services (iCloud, Google Drive, Dropbox)
Email it to yourself
Save in password manager
Share with anyone (including eckoWALLET support)
Post online or in chat
📖 Comprehensive Guide: Security Best Practices - Recovery Phrase
How do I protect my wallet from hackers?
Essential security measures:
Secure Your Recovery Phrase: Physical storage only
Strong Password: 12+ characters, unique to eckoWALLET
Beware of Phishing: Always verify you're on eckowallet.com
Keep Software Updated: Update eckoWALLET and your OS regularly
Use Hardware Wallet: For large holdings (Ledger support)
Lock Your Wallet: Enable auto-lock after inactivity
📖 Complete Security Guide: Security Best Practices
What is a hardware wallet and should I use one?
A hardware wallet (like Ledger) is a physical device that stores your private keys offline.
Benefits:
Maximum security (keys never touch internet-connected device)
Protection from malware and keyloggers
Physical confirmation required for transactions
When to use:
Storing large amounts of KDA (life-changing money)
Long-term holding (cold storage)
Maximum security requirements
eckoWALLET supports: Ledger hardware wallets
📖 Learn More: Hardware Wallets Guide (when created)
Someone is asking for my recovery phrase. What should I do?
🚨 THIS IS A SCAM! 🚨
NO ONE should ever ask for your recovery phrase, including:
❌ eckoWALLET support team
❌ Kadena team
❌ dApp developers
❌ Exchange support
❌ Anyone on Discord, Telegram, Twitter
If someone asks:
DO NOT share it
Block and report them immediately
End the conversation
Remember: Anyone with your recovery phrase can steal ALL your funds.
📖 Learn More: Security Best Practices - Phishing Protection
I think my wallet is compromised. What should I do?
Act immediately:
Stop using the wallet - Don't make any more transactions
Create a NEW wallet with a new recovery phrase
Transfer funds to the new wallet (if you still have access)
Change passwords on any accounts where you used the same password
Scan for malware on your computer
Never use the old recovery phrase again
If funds are already stolen: Unfortunately, blockchain transactions are irreversible. Report to exchanges and block explorers to track stolen funds.
📖 Prevention Guide: Security Best Practices
Kadena Concepts
What is Kadena?
Kadena is a proof-of-work blockchain with unique features:
20 parallel chains (0-19) for high throughput
Pact smart contract language (human-readable)
Energy efficient proof-of-work
Low gas fees (fractions of a cent)
Scalable architecture
eckoWALLET is the leading wallet for Kadena ecosystem.
Why does Kadena have multiple chains?
Kadena's multi-chain architecture provides:
Higher throughput: More transactions per second
Lower fees: Less congestion per chain
Parallel processing: Transactions don't wait for each other
Scalability: Can add more chains as needed
Your account can exist on multiple chains with separate balances on each.
📖 Learn More: Kadena Account Concepts - Multi-Chain
What is the difference between Mainnet and Testnet?
Mainnet (Production):
Real KDA with real value
Permanent blockchain
Use for actual transactions
Most dApps operate here
Testnet (Testing):
Test KDA with no value
Can be reset
For developers testing applications
Free test KDA from faucets
Important: Funds on Testnet are worthless. Funds on Mainnet have real value.
Can I send from Mainnet to Testnet or vice versa?
No! Mainnet and Testnet are completely separate blockchains. You cannot transfer between them.
Always verify:
Which network your wallet is on
Which network the dApp is using
Which network you're sending to
Sending to wrong network = funds lost!
Tokens & NFTs
Which tokens does eckoWALLET support?
eckoWALLET supports:
KDA (native Kadena token) - automatic
All KDA-based tokens - may need to add manually
NFTs with Marmalade standard
Supported token standards:
coin contract (KDA)
fungible-v2 standard tokens
poly-fungible tokens
Marmalade NFTs
How do I add a custom token?
Click "Manage Tokens" or "+" in token list
Enter token contract information:
Module name (e.g.,
free.my-token)Namespace (if any)
Click "Add Token"
Token will appear in your list
Note: Only add tokens you trust! Verify contract addresses.
How do I view my NFTs?
Open eckoWALLET
Navigate to "NFTs" section (in main menu)
Your NFTs will display with images and metadata
Click on an NFT to see details
Supported: Marmalade standard NFTs
Why don't I see my token balance?
Common reasons:
Token not added: Add the token manually
Wrong chain: Check if your balance is on a different chain
Account doesn't exist on this chain: Receive tokens first to create account
Token contract issue: Verify contract address is correct
📖 Troubleshooting: Balance Not Showing
dApp Connections
How do I connect eckoWALLET to a dApp?
Browser Extension:
Visit the dApp website
Click their "Connect Wallet" button
Select "eckoWALLET"
Review connection request in popup
Click "Approve"
You're connected!
Mobile via WalletConnect:
Use WalletConnect on desktop dApp
Scan QR code with mobile app
Approve connection
Sign transactions on mobile
📖 Detailed Guides:
Connected dApps Guide (when created)
What is WalletConnect?
WalletConnect is a protocol that connects your mobile wallet to desktop dApps:
Keep your keys secure on mobile
Use desktop dApps conveniently
Approve transactions on mobile device
Works with any WalletConnect-enabled dApp
📖 Complete Guide: Using WalletConnect
How do I disconnect from a dApp?
From eckoWALLET:
Go to "Connections" or "Connected dApps"
Find the dApp in your list
Click on it
Select "Disconnect"
Confirm disconnection
From dApp:
Most dApps have a "Disconnect Wallet" button
Best practice: Disconnect from dApps when you're done using them.
Is it safe to connect to dApps?
Generally yes, but be cautious:
✅ Safe practices:
Only connect to trusted, verified dApps
Review what permissions dApp requests
Check the website URL carefully (beware of phishing)
Disconnect when done
⚠️ Risks:
Malicious dApps can request harmful transactions
Always review transaction details before approving
Never sign transactions you don't understand
Remember: Connecting doesn't give access to funds. Every transaction requires your explicit approval.
📖 Security Guide: Security Best Practices - dApp Safety
What transactions can dApps request?
dApps can request:
Account information (read-only)
Transaction signatures
Specific capabilities (coin.TRANSFER, etc.)
dApps CANNOT:
Access your private keys
Sign transactions without your approval
Transfer funds automatically
Change your wallet settings
You must approve every transaction individually.
Hardware Wallets
Does eckoWALLET support Ledger?
Yes! eckoWALLET has full Ledger hardware wallet integration:
Store keys on Ledger device
Sign transactions securely
Maximum security for large holdings
Supported devices:
Ledger Nano S
Ledger Nano S Plus
Ledger Nano X
📖 Setup Guide: Hardware Wallets (when created)
How do I set up Ledger with eckoWALLET?
Quick steps:
Install Kadena app on Ledger device
In eckoWALLET, click "Add Account"
Select "Ledger Account"
Connect Ledger via USB
Unlock Ledger and open Kadena app
Follow prompts in eckoWALLET
Your Ledger account is created!
Every transaction will require physical confirmation on your Ledger device.
Does eckoWALLET support Trezor?
Not currently. eckoWALLET currently only supports Ledger hardware wallets.
WalletConnect
What is WalletConnect used for in eckoWALLET?
WalletConnect allows you to:
Connect mobile eckoWALLET to desktop dApps
Keep keys secure on mobile device
Browse dApps on desktop
Approve transactions on mobile
Use case: Best of both worlds - desktop convenience with mobile security.
📖 Complete Guide: Using WalletConnect
How do I connect mobile eckoWALLET to a desktop dApp?
Two methods available:
Method 1: QR Code (Recommended):
On desktop dApp, click "WalletConnect"
QR code appears
Open eckoWALLET mobile, go to "Connections"
Tap QR scanner
Scan the QR code
Approve connection on mobile
Method 2: Connection Code:
On desktop dApp, click "WalletConnect"
Copy connection code
Open eckoWALLET mobile, go to "Connections"
Paste connection code
Approve connection
📖 Detailed Steps: Using WalletConnect
Why won't my WalletConnect QR code scan?
Common solutions:
Camera permission: Grant eckoWALLET camera access
Lighting: Ensure good lighting
Distance: Not too close, not too far from screen
QR code expired: Refresh the dApp page
Dirty lens: Clean your camera lens
Alternative: Use Connection Code method instead
📖 Troubleshooting: WalletConnect Issues
Can I use WalletConnect with the browser extension?
No. WalletConnect is specifically for connecting mobile wallets to desktop dApps. The browser extension connects directly to dApps.
Troubleshooting
eckoWALLET extension won't install
Solutions:
Clear browser cache and try again
Restart browser completely
Check browser version: Must be up to date
Try different browser: Chrome, Edge, Brave, Opera
Disable conflicting extensions: Other wallet extensions can interfere
Download directly from Chrome Web Store
📖 Full Troubleshooting: Installation Issues
I can't see my balance
Check these:
Correct network: Are you on Mainnet or Testnet?
Correct chain: Your balance might be on a different chain
Account exists: First transaction creates account on a chain
Refresh: Close and reopen eckoWALLET
Network connection: Check internet connection
Block explorer: Verify balance at https://explorer.chainweb.com
📖 Full Troubleshooting: Balance Issues
My transaction failed. What happened?
Common reasons:
Insufficient balance: Not enough KDA to cover amount + gas
Wrong chain: Recipient account doesn't exist on that chain
Incorrect account name: Typo in recipient address
Gas price too low: Transaction rejected by network
Account doesn't exist: Recipient not created on this chain yet
Smart contract error: DeFi transaction failed due to contract logic
Check transaction details: View on Kadena block explorer for specific error message.
📖 Full Troubleshooting: Transaction Issues
eckoWALLET won't connect to a dApp
Solutions:
Refresh the page: Both dApp and wallet
Unlock wallet: Ensure eckoWALLET is unlocked
Correct network: dApp and wallet must be on same network
Clear site permissions: In eckoWALLET settings, disconnect and reconnect
Disable other wallets: Other wallet extensions can interfere
Check dApp status: The dApp itself might be down
Update eckoWALLET: Ensure you have the latest version
📖 Full Troubleshooting: dApp Connection Issues
The eckoWALLET mobile app keeps crashing
Solutions:
Update app: Check App Store/Play Store for updates
Restart app: Force close and reopen
Restart device: Turn phone off and on
Clear cache: In phone settings > Apps > eckoWALLET > Clear cache
Reinstall app: Delete and reinstall (you'll need recovery phrase!)
Check storage: Ensure enough free space on device
OS version: Update iOS/Android to latest version
Before reinstalling: Make sure you have your recovery phrase!
How do I export my transaction history?
Currently, transaction history export is not built into eckoWALLET.
Alternatives:
View on block explorer: https://explorer.chainweb.com
Manual recording: Take screenshots or notes
Third-party tools: Use Kadena blockchain analytics tools
Future feature: Transaction export may be added in future updates.
Technical Questions
What programming language is eckoWALLET built with?
Browser Extension:
JavaScript/TypeScript
React
Manifest V3 Chrome extension
Mobile App:
React Native (cross-platform for iOS and Android)
Is eckoWALLET open source?
Yes! eckoWALLET is powered by RunOnFlux and the code is available for review.
Benefits of open source:
Community can audit code for security
Transparency in how wallet works
Community contributions welcome
What is the API for developers?
eckoWALLET provides window.kadena API for dApp developers:
📖 Complete API Documentation: API Reference
How do I integrate eckoWALLET into my dApp?
Quick integration steps:
Detect eckoWALLET: Check for
window.kadenaConnect: Request connection with
kda_connectSign transactions: Use
kda_requestSignorkda_requestQuickSignSubmit to blockchain: Send signed transaction to Kadena API
📖 Complete Integration Guide: dApp Integration Guide
What is QuickSign (KIP-0015)?
QuickSign is a Kadena standard for batch transaction signing:
Sign multiple transactions at once
Improved user experience for complex DeFi operations
Better performance for multi-step transactions
Use cases:
DEX swaps with multiple steps
Staking operations
Complex DeFi interactions
Batch payments
📖 Implementation Guide: QuickSign (KIP-0015)
Does eckoWALLET have a testnet?
Yes! eckoWALLET supports both Mainnet and Testnet.
Switch networks:
Open eckoWALLET settings
Find "Network" section
Select "Testnet"
Get free test KDA from faucet
Testnet use:
Testing dApps before mainnet launch
Learning without risking real funds
Development and debugging
What blockchains does eckoWALLET support?
Currently, eckoWALLET only supports Kadena blockchain (all 20 chains).
No support for:
Ethereum
Bitcoin
Other blockchains
eckoWALLET is specialized for Kadena ecosystem.
Getting Help
Where can I get support?
Official Support Channels:
📱 Discord: https://discord.com/invite/runonflux
Active community
Quick responses
Technical help
🐦 Twitter/X: @eckoWALLET
Updates and announcements
Community engagement
📖 Documentation: You're here!
Comprehensive guides
Searchable content
🌐 Website: https://eckowallet.com
Official information
Download links
How do I report a bug?
To report bugs:
Join our Discord: https://discord.com/invite/runonflux
Go to support channel
Provide details:
What you were trying to do
What happened instead
Screenshots if possible
Your device/browser version
eckoWALLET version
Never share: Private keys, recovery phrases, passwords
How do I request a new feature?
Feature requests:
Join Discord community
Share your idea in feature requests channel
Community will discuss and vote
Popular feature requests are prioritized by the development team.
Is there a bug bounty program?
Check the official eckoWALLET Discord or website for information about security bug bounties.
For critical security vulnerabilities:
Report privately to the team
Do not disclose publicly until fixed
Responsible disclosure is appreciated
Who develops eckoWALLET?
eckoWALLET is powered by RunOnFlux, a leading decentralized infrastructure project.
About RunOnFlux:
Decentralized cloud infrastructure
Web3 ecosystem development
Strong commitment to Kadena ecosystem
Additional Resources
Useful Links
eckoWALLET:
Website: https://eckowallet.com
Documentation: You're reading it!
Discord: https://discord.com/invite/runonflux
Twitter: @eckoWALLET
Kadena:
Website: https://kadena.io
Documentation: https://docs.kadena.io
Block Explorer: https://explorer.chainweb.com
Ecosystem: https://kadena.io/ecosystem
Developer Resources:
Pact Language: https://pact-language.readthedocs.io
Kadena GitHub: https://github.com/kadena-io
Recommended Reading
For Users:
Security Best Practices ⭐ Essential
For Developers:
For Troubleshooting:
This FAQ
Discord community
Still Have Questions?
If your question isn't answered here:
Search this documentation - Use the search function
Check the troubleshooting guide: Troubleshooting
Join Discord: https://discord.com/invite/runonflux
Follow on Twitter: @eckoWALLET for updates
Remember:
✅ eckoWALLET support will NEVER ask for your recovery phrase or private keys
✅ All support is provided through official channels only
❌ Beware of impersonators on social media
Welcome to the Kadena ecosystem! 🚀
Last updated