> For the complete documentation index, see [llms.txt](https://eckowallet.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eckowallet.gitbook.io/docs/getting-started/readme.md).

# Introduction

Welcome to the comprehensive documentation for eckoWALLET, the leading wallet for the Kadena blockchain ecosystem.

## What is eckoWALLET?

eckoWALLET is a non-custodial cryptocurrency wallet that allows you to securely store, send, and receive KDA and other Kadena-based tokens. With over 35,000 users, it's the most popular wallet in the Kadena ecosystem.

**Available on:**

* Browser Extension (Chrome, Edge, Brave, Opera)
* iOS Mobile App
* Android Mobile App

**Download:** <https://eckowallet.com>

## Key Features

✅ **Non-Custodial Security** - You control your private keys and funds ✅ **Multi-Chain Support** - Access all 20 Kadena chains ✅ **Hardware Wallet Integration** - Ledger support for maximum security ✅ **dApp Connectivity** - Seamlessly interact with Kadena decentralized applications ✅ **WalletConnect** - Connect mobile wallet to desktop dApps ✅ **NFT Support** - View and manage your Kadena NFTs ✅ **Cross-Chain Transfers** - Move assets between Kadena chains ✅ **Multi-Language** - Support for 35+ languages

## Documentation Overview

This documentation is organized for three audiences:

### 👤 For Users

New to eckoWALLET? Start here:

1. [**Installation & Setup**](/docs/getting-started/installation-and-setup.md) - Download and install eckoWALLET
2. [**Creating Your First Wallet**](/docs/getting-started/creating-your-first-wallet.md) - Step-by-step wallet creation
3. [**Sending KDA**](/docs/user-guides/sending-kda-and-tokens.md) - How to send transactions
4. [**Receiving KDA**](/docs/user-guides/receiving-kda-and-tokens.md) - How to receive funds
5. [**Security Best Practices**](/docs/user-guides/security-best-practices.md) - Keep your wallet safe

**User Guides:**

* [Managing Accounts](/docs/user-guides/managing-accounts.md)
* [Cross-Chain Transfers](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/user-guides/cross-chain-transfers.md)
* [Using WalletConnect](/docs/user-guides/walletconnect.md)
* [Hardware Wallets (Ledger)](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/user-guides/hardware-wallets.md)
* [Troubleshooting](/docs/reference/troubleshooting.md)
* [FAQ](/docs/reference/faq.md)

### 👨‍💻 For Developers

Building dApps on Kadena? Integrate with eckoWALLET:

1. [**dApp Integration Guide**](/docs/developer-documentation/dapp-integration-guide.md) - Complete integration tutorial
2. [**API Reference**](/docs/developer-documentation/api-reference.md) - Full API documentation
3. [**Transaction Signing**](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/developers/transaction-signing.md) - Sign transactions with eckoWALLET
4. [**QuickSign (KIP-0015)**](/docs/developer-documentation/quicksign-kip-0015.md) - Batch transaction signing
5. [**Code Examples**](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/developers/code-examples.md) - Ready-to-use code samples

**Developer Resources:**

* [WalletConnect Integration](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/developers/walletconnect-integration.md)
* [Testing Your Integration](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/developers/testing-your-integration.md)
* [Best Practices](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/developers/best-practices.md)

### 🔧 For Contributors

Want to contribute to eckoWALLET development?

1. [**Development Setup**](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/contributors/development-setup.md) - Set up your development environment
2. [**Architecture Overview**](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/contributors/architecture-overview.md) - Understand the codebase
3. [**Building from Source**](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/contributors/building-from-source.md) - Compile eckoWALLET
4. [**Contributing Guidelines**](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/contributors/contributing-guidelines.md) - How to contribute

## Quick Start Guides

### I'm a New User

**Goal: Get started with eckoWALLET in 10 minutes**

1. [Install eckoWALLET](/docs/getting-started/installation-and-setup.md) from eckowallet.com
2. [Create your wallet](/docs/getting-started/creating-your-first-wallet.md) and save your recovery phrase
3. [Receive KDA](/docs/user-guides/receiving-kda-and-tokens.md) from an exchange or friend
4. Start using Kadena dApps!

### I'm a Developer

**Goal: Integrate eckoWALLET in 30 minutes**

1. Check if [eckoWALLET is installed](/docs/developer-documentation/dapp-integration-guide.md#detecting-eckowallet)
2. [Connect to user's wallet](/docs/developer-documentation/dapp-integration-guide.md#connecting-to-wallet)
3. [Request transaction signatures](/docs/developer-documentation/api-reference.md#transaction-signing)
4. Send signed transactions to Kadena blockchain

**Example:**

```javascript
// Detect eckoWALLET
if (window.kadena?.isKadena) {
  // Connect
  const result = await window.kadena.request({
    method: 'kda_connect',
    networkId: 'mainnet01'
  });

  console.log('Connected:', result.account);
}
```

See [dApp Integration Guide](/docs/developer-documentation/dapp-integration-guide.md) for complete tutorial.

## Understanding Kadena

New to Kadena? These resources will help:

* [**Kadena Account Concepts**](/docs/reference/kadena-account-concepts.md) - How Kadena accounts work
* [**Supported Networks**](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/reference/supported-networks.md) - Mainnet, Testnet, and custom networks
* [Kadena Official Docs](https://docs.kadena.io) - Learn about Kadena blockchain
* [Pact Language](https://pact-language.readthedocs.io) - Kadena's smart contract language

## Key Concepts

### Non-Custodial Wallet

eckoWALLET is non-custodial, meaning:

* ✅ **You control your funds** - Your keys, your crypto
* ✅ **No intermediary** - Direct blockchain interaction
* ⚠️ **You're responsible** - No password reset or recovery service

**Important:** Always back up your 12-word recovery phrase!

### Multi-Chain Architecture

Kadena has 20 parallel chains (0-19):

* Each chain operates independently
* Your account can exist on multiple chains
* Balances are separate per chain
* Transfer between chains with cross-chain transfers

Learn more: [Kadena Account Concepts](/docs/reference/kadena-account-concepts.md)

## Common Tasks

### As a User

* **Sending KDA**: [Sending Guide](/docs/user-guides/sending-kda-and-tokens.md)
* **Receiving KDA**: [Receiving Guide](/docs/user-guides/receiving-kda-and-tokens.md)
* **Cross-chain Transfer**: [Cross-Chain Guide](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/user-guides/cross-chain-transfers.md)
* **Connect to dApp**: [Connected dApps Guide](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/user-guides/connected-dapps.md)
* **Restore Wallet**: [Restoration Guide](/docs/getting-started/restoring-an-existing-wallet.md)
* **Security**: [Security Best Practices](/docs/user-guides/security-best-practices.md)

### As a Developer

* **Connect Wallet**: [API Reference - Connection](/docs/developer-documentation/api-reference.md#connection-management)
* **Sign Transaction**: [API Reference - Signing](/docs/developer-documentation/api-reference.md#transaction-signing)
* **Get Account Info**: [API Reference - Account Info](/docs/developer-documentation/api-reference.md#account-information)
* **Listen to Events**: [API Reference - Events](/docs/developer-documentation/api-reference.md#events)
* **Handle Errors**: [Integration Guide - Error Handling](/docs/developer-documentation/dapp-integration-guide.md#error-handling-best-practices)

## Support & Community

### Need Help?

* **Documentation**: You're here! Use search to find what you need
* **Troubleshooting**: [Troubleshooting Guide](/docs/reference/troubleshooting.md)
* **FAQ**: [Frequently Asked Questions](/docs/reference/faq.md)

### Connect with Us

* **Discord**: <https://discord.com/invite/runonflux> - Join our community
* **Twitter**: [@eckoWALLET](https://twitter.com/eckoWALLET) - Follow for updates
* **Website**: <https://eckowallet.com> - Official website

### Security

🔐 **Important Security Reminders:**

* Never share your recovery phrase with anyone
* eckoWALLET support will NEVER ask for your recovery phrase
* Always verify you're on the official eckowallet.com website
* Be cautious of phishing attempts

Read more: [Security Best Practices](/docs/user-guides/security-best-practices.md)

## Contributing

eckoWALLET is powered by RunOnFlux and welcomes contributions from the community.

* **Report Issues**: Found a bug? Report it on GitHub
* **Suggest Features**: Share your ideas with the team
* **Contribute Code**: See [Contributing Guidelines](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/contributors/contributing-guidelines.md)
* **Improve Docs**: Help make this documentation better

## What's New

### Latest Features

* ✨ QuickSign (KIP-0015) support for batch transactions
* ✨ Ledger hardware wallet integration
* ✨ SpireKey WebAuthn authentication
* ✨ Enhanced NFT viewing and management
* ✨ WalletConnect v2 support
* ✨ Multi-language support (35+ languages)

### Mobile App

The eckoWALLET mobile app brings the full wallet experience to iOS and Android:

* All web extension features
* Biometric authentication (fingerprint, Face ID)
* WalletConnect for connecting to desktop dApps
* Push notifications
* Native mobile performance

**Download:**

* iOS: App Store
* Android: Google Play Store

Visit [eckowallet.com](https://eckowallet.com) for direct links.

## Resources

### Official Links

* **Website**: <https://eckowallet.com>
* **Documentation**: You're here!
* **Brand Assets**: [eckoWALLET Brand Assets](/docs/reference/eckowallet-brand-assets.md)

### Kadena Resources

* [Kadena Website](https://kadena.io)
* [Kadena Documentation](https://docs.kadena.io)
* [Kadena Block Explorer](https://explorer.chainweb.com/mainnet)
* [Pact Documentation](https://pact-language.readthedocs.io)

### Community Projects

* [Kaddex](https://kaddex.com) - Decentralized exchange
* [Marmalade](https://marmalade.art) - NFT standard and marketplace
* [Kadena Ecosystem](https://kadena.io/ecosystem) - Full list of projects

## License & Credits

eckoWALLET is powered by **RunOnFlux**.

For licensing information and attribution, visit [eckowallet.com](https://eckowallet.com).

***

**Ready to get started?**

* 👤 Users: [Install eckoWALLET](/docs/getting-started/installation-and-setup.md)
* 👨‍💻 Developers: [Integrate eckoWALLET](/docs/developer-documentation/dapp-integration-guide.md)
* 🔧 Contributors: [Development Setup](https://github.com/RunOnFlux/ecko-wallet-docs/blob/main/contributors/development-setup.md)