eckoWALLETRunOnFlux
Edit

Managing Accounts

eckoWALLET makes it easy to manage multiple Kadena accounts from a single wallet. This guide covers everything you need to know about creating, organizing, and managing your accounts.

Understanding Accounts

What is a Kadena Account?

A Kadena account consists of:

  • Account Name: Your unique identifier (e.g., k:a1b2c3...xyz789)

  • Public Key: Used to receive funds (64-character hex string)

  • Private Key: Encrypted and stored securely, proves ownership

  • Chains: Your account can exist on multiple Kadena chains (0-19)

See Kadena Account Concepts for more details.

Account Types in eckoWALLET

eckoWALLET supports three types of accounts:

  1. Standard Accounts: Regular accounts secured by your password and recovery phrase

  2. Ledger Accounts: Hardware wallet accounts for maximum security

  3. SpireKey Accounts: Advanced accounts using WebAuthn authentication

Creating New Accounts

Creating a Standard Account

All accounts from the same recovery phrase are deterministically generated in order:

Browser Extension:

  1. Click on your current account at the top of the wallet

  2. Click the "+" icon or "Create Account" button

  3. Your new account is generated automatically

  4. (Optional) Give it a custom alias/name

Mobile App:

  1. Tap on the account dropdown

  2. Tap "Add Account" or the "+" button

  3. Select "Create New Account"

  4. (Optional) Name your account

Important Notes:

  • Each new account is generated from your recovery phrase

  • Accounts are created sequentially (Account 1, Account 2, etc.)

  • All accounts are backed up by the same 12-word recovery phrase

  • No additional backup is needed for new accounts

Adding a Ledger Account

To use a hardware wallet with eckoWALLET:

  1. Connect your Ledger device to your computer

  2. Unlock the Ledger with your PIN

  3. Open the Kadena app on your Ledger

  4. In eckoWALLET:

    • Click account dropdown

    • Select "Add Ledger Account"

    • Follow the on-screen prompts

  5. Approve the connection on your Ledger device

See Hardware Wallets (Ledger) for detailed instructions.

Adding a SpireKey Account

SpireKey accounts use WebAuthn for authentication:

  1. In eckoWALLET, go to account management

  2. Select "Add SpireKey Account"

  3. Follow the SpireKey authentication flow

  4. Complete WebAuthn verification (fingerprint, Face ID, etc.)

Switching Between Accounts

Browser Extension

Method 1: Account Dropdown

  1. Click on your current account name at the top

  2. Select the account you want to switch to from the list

Method 2: Account List View

  1. Click the menu icon (≡)

  2. Navigate to "Accounts"

  3. Click on the account you want to use

Mobile App

  1. Tap the account name at the top of the screen

  2. Scroll through your accounts

  3. Tap the account you want to switch to

Active Account

  • The currently selected account is marked with a checkmark or highlight

  • All transactions will use this account unless specified otherwise

Customizing Accounts

Renaming Accounts (Aliases)

Give your accounts friendly names to easily identify them:

Browser Extension:

  1. Go to the Accounts section

  2. Click the pencil/edit icon next to the account

  3. Enter a new name (e.g., "Savings", "Trading", "Main")

  4. Save changes

Mobile App:

  1. Go to Accounts

  2. Long-press on an account or tap the info icon

  3. Tap "Edit" or the pencil icon

  4. Enter a new alias

  5. Save

Naming Tips:

  • Use descriptive names: "DEX Trading", "Long-term Hold", "Daily Use"

  • Keep names short for easy viewing

  • Names are local only (not stored on blockchain)

  • Names are not restored when you restore your wallet on a new device

Viewing Account Details

To see full details about an account:

  1. Select the account

  2. Click/tap on the account name or info icon

  3. View:

    • Full account name (k:...)

    • Public key

    • Balance on each chain

    • Account type (Standard, Ledger, SpireKey)

    • Connected dApps

Managing Account Balances

Viewing Balances

Your account balance is displayed prominently in the wallet:

Total Balance: Shows combined balance across all chains Per-Chain Balance: Click "Chains" to see balance on each chain (0-19)

Why multiple chains?

  • Kadena is a multi-chain network (20 chains)

  • Your account can exist independently on each chain

  • Funds on chain 0 are separate from funds on chain 1, etc.

  • You can transfer between chains (see Cross-Chain Transfers)

Checking Which Chains Have Funds

To see where your funds are located:

  1. Open your account

  2. Navigate to "Chains" or chain selector

  3. Review balance for each chain (0-19)

  4. Chains with 0.000 balance are either unfunded or the account doesn't exist there yet

Refreshing Balances

If your balance seems incorrect:

Browser Extension:

  • Balances refresh automatically every few seconds

  • You can force refresh by closing and reopening the popup

  • Or switch to a different account and back

Mobile App:

  • Pull down on the main screen to refresh

  • Or navigate away and return to the account

Organizing Multiple Accounts

Use Cases for Multiple Accounts

Consider creating separate accounts for:

  1. Savings: Long-term holding, rarely accessed

  2. Trading: Active trading on DEXs

  3. dApp Interactions: Connecting to decentralized applications

  4. Testing: Experimenting with new protocols (use testnet)

  5. Business: Separating personal and business transactions

Account Organization Tips

  1. Name them clearly: Use descriptive aliases

  2. Limit active accounts: Only keep accounts you actively use

  3. Separate high-value accounts: Keep large holdings in dedicated accounts

  4. Use Ledger for savings: Store long-term funds in hardware wallet accounts

Account Security

Protecting Your Accounts

All standard accounts in eckoWALLET are protected by:

  • Your password (local encryption)

  • Your recovery phrase (master backup)

Security best practices:

  • ✅ Use a strong, unique password

  • ✅ Keep recovery phrase offline and secure

  • ✅ Enable auto-lock

  • ✅ Use biometric authentication (mobile)

  • ✅ Consider hardware wallets for large holdings

Compromised Account?

If you believe an account's private key is compromised:

  1. Transfer funds immediately to a new, secure account

  2. Create a new wallet with a new recovery phrase if needed

  3. Never reuse the compromised account for important transactions

  4. Review transactions to identify any unauthorized activity

See Security Best Practices for more information.

Deleting or Removing Accounts

Hiding Accounts

Currently, eckoWALLET does not support deleting accounts from the interface. However:

  • You can stop using an account (simply don't select it)

  • Empty accounts (0 balance) can be ignored

  • Focus on the accounts you actively use

Account Restoration

Remember:

  • All accounts generated from your recovery phrase can be restored

  • Even if you could delete an account from the UI, it would reappear when restoring

  • Account names (aliases) are local only and not restored

Advanced Account Features

Understanding Derivation Paths

eckoWALLET uses hierarchical deterministic (HD) wallet technology:

  • One recovery phrase → Multiple accounts

  • Each account uses a different derivation path

  • Standard path: m/44'/626'/0'/0/{index}

  • Index starts at 0 and increments for each new account

What this means:

  • Account 1 is always the same for a given recovery phrase

  • Account 2 is always the same for that recovery phrase

  • You can restore accounts on any device in the same order

Multi-Signature Accounts

While eckoWALLET primarily manages single-key accounts (k:...), Kadena supports multi-signature accounts:

  • Not directly supported in UI: eckoWALLET doesn't have a UI for creating multi-sig accounts

  • Can interact: You can send funds TO multi-sig accounts

  • Advanced users: Use Pact code and command-line tools to create multi-sig accounts

Learn more in Kadena Account Concepts.

Account on Multiple Chains

Your account name (e.g., k:abc123...) can exist on multiple chains:

  • Same account name, different chains

  • Separate balances on each chain

  • Separate keyset definitions can exist per chain

  • Most users use the same keyset across all chains

Account Permissions and dApp Connections

Viewing Connected dApps

To see which dApps have access to your account:

  1. Go to Settings or Accounts section

  2. Select "Connected Sites" or "dApp Connections"

  3. Review the list of connected applications

Managing dApp Permissions

For each connected dApp, you can:

  • View when it was connected

  • See what account it's connected to

  • Disconnect it if no longer needed

See Connected dApps for more details.

Account Switching and dApps

When you switch accounts in eckoWALLET:

  • Connected dApps see the account change event

  • Most dApps will update to show the new account

  • Some dApps may require you to reconnect

Troubleshooting

Account not showing balance

Possible causes:

  1. Wrong network: Ensure you're on Mainnet (not Testnet)

  2. Wrong chain: Check other chains (0-19)

  3. Account not funded: The account needs to receive funds first

  4. Blockchain sync delay: Wait 30-60 seconds for sync

Solutions:

  • Switch to the correct network in Settings

  • Check all chains for your balance

  • Verify transactions were sent to the correct account name

  • Refresh the wallet

Can't create new account

Possible causes:

  • Wallet is locked (enter password)

  • Software glitch

Solutions:

  • Unlock your wallet

  • Refresh the browser extension or restart the app

  • Try again after a few seconds

Accounts appear in different order after restoration

Explanation:

  • Accounts are generated in deterministic order

  • If you created Account 1, then Account 3, then Account 2 originally

  • After restoration, they appear as Account 1, 2, 3 in order

  • This is normal behavior

Solution:

  • Check account addresses (k:...) to identify which is which

  • Rename them with your preferred aliases

Lost custom account names

Explanation:

  • Account aliases are stored locally on each device

  • They are not backed up to the blockchain or recovery phrase

  • When restoring, you need to rename accounts again

Solution:

  • Keep a separate note of your account names if they're important

  • Or use a consistent naming scheme that's easy to remember

Frequently Asked Questions

How many accounts can I have?

Practically unlimited. Your recovery phrase can generate millions of accounts.

Do I need to backup each account separately?

No! Your 12-word recovery phrase backs up all accounts. Just keep that one phrase secure.

Can I use the same account on desktop and mobile?

Yes! Restore your wallet on both devices using your recovery phrase. The same account names will be generated.

What happens if I send funds to an account that doesn't exist yet?

On Kadena, accounts are created upon first use. If you send funds to an account name that doesn't exist yet:

  • The transaction will create the account automatically

  • The account must have a valid keyset defined

  • For k: accounts, this is handled automatically

Can I merge accounts?

Account merging is not a built-in feature. However, you can:

  • Transfer all funds from one account to another

  • Stop using the old account

  • The old account can remain empty

Should I use one account or multiple?

It depends on your needs:

One Account:

  • ✅ Simpler to manage

  • ✅ All funds in one place

  • ❌ Less privacy

  • ❌ Higher risk if compromised

Multiple Accounts:

  • ✅ Better organization

  • ✅ Separate concerns (trading vs holding)

  • ✅ Better privacy

  • ❌ More complex to manage

Next Steps

Now that you understand account management:

Need Help?

PreviousRestoring an Existing WalletNextSending KDA and Tokens

Last updated