> 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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://eckowallet.gitbook.io/docs/getting-started/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.