# Overview

## EpixChain Documentation

Welcome to the comprehensive documentation for EpixChain - the world's first blockchain designed to power a completely decentralized internet.

### 🌟 What is EpixChain?

EpixChain is a high-performance EVM-compatible blockchain built on the Cosmos SDK that combines the power of Ethereum smart contracts with the interoperability of the Cosmos ecosystem. Our mission is to create the infrastructure for a truly decentralized web where websites are hosted by everyone and controlled by no one.

### 🚀 Key Features

* **EVM Compatibility**: Full Ethereum Virtual Machine support for seamless dApp migration
* **Cosmos SDK Foundation**: Built on proven, secure blockchain infrastructure
* **IBC Connectivity**: Native cross-chain communication with 50+ blockchain networks
* **Custom Tokenomics**: Dynamic minting with 25% annual reduction reaching 42B max supply
* **Low Fees**: Optimized for everyday use and microtransactions
* **Community Governance**: Decentralized decision-making for protocol evolution

### 📚 Documentation Sections

#### 🔍 Overview

Learn about EpixChain's architecture, tokenomics, and vision for the decentralized internet.

#### 🏁 Getting Started

Quick setup guides for users, developers, and validators to begin using EpixChain.

#### 👥 For Users

Wallet setup, governance participation, staking, and cross-chain transfers.

#### 💻 For Developers

Smart contract development, API references, precompiles, and integration guides.

#### 🔒 For Validators

Complete validator setup, operations, security, and monitoring guides.

#### 🧩 Modules

Deep dive into EpixChain's core modules including EpixMint, EVM, IBC, and governance.

#### 🤝 Community

Contributing guidelines, support channels, and frequently asked questions.

### 🌐 Network Information

| Network     | Chain ID | RPC Endpoint                | REST API                    | Explorer                 |
| ----------- | -------- | --------------------------- | --------------------------- | ------------------------ |
| **Mainnet** | 1916     | `https://rpc.epixchain.com` | `https://api.epixchain.com` | `https://scan.epix.zone` |
| **Devnet**  | 1917     | `http://localhost:8545`     | `http://localhost:1317`     | `http://localhost:8080`  |

### 💎 EPIX Token

* **Symbol**: EPIX
* **Decimals**: 18
* **Base Denomination**: aepix (1 EPIX = 10^18 aepix)
* **Maximum Supply**: 42,000,000,000 EPIX
* **Genesis Supply**: 23,689,538 EPIX (airdropped to snapshot holders)
* **Annual Emission**: Starts at 10.527B EPIX, reduces by 25% annually

### 🔗 Quick Links

* **Website**: [epix.zone](https://epix.zone)
* **GitHub**: [EpixZone/EpixChain](https://github.com/EpixZone/EpixChain)
* **Discord**: [Join our community](https://discord.gg/epix)
* **Twitter**: [@zone\_epix](https://x.com/zone_epix)
* **Base layer Explorer**: [explorer.epix.zone](https://explorer.epix.zone/)
* **EVM Block Explorer**: [scan.epix.zone](https://scan.epix.zone)

### 🆘 Need Help?

* **Community Support**: Join our [Discord](https://discord.gg/bF2GKHgrfv) for real-time help
* **GitHub Issues**: Report bugs or request features on [GitHub](https://github.com/EpixZone/EpixChain/issues)
* **Documentation Issues**: Help us improve these docs by submitting PRs

### 📄 License

EpixChain is open-source software licensed under the [Apache 2.0 License](https://github.com/EpixZone/EpixChain/blob/main/LICENSE).

***

*Built with ❤️ by the EpixChain community*


# Introduction

## Introduction to EpixChain

### Vision: The Decentralized Internet

EpixChain represents a revolutionary leap forward in blockchain technology, designed specifically to power the world's first completely decentralized internet. Our vision is to create a web where websites are hosted by everyone and controlled by no one, making the internet as unstoppable as Bitcoin itself.

### What Makes EpixChain Special?

#### 🌐 Built for the Decentralized Web

Unlike traditional blockchains that focus primarily on financial transactions, EpixChain is architected from the ground up to support **EpixNet** - a revolutionary decentralized web infrastructure that reimagines how websites and applications are hosted and accessed.

#### ⚡ High Performance & Low Costs

* **Fast block times** for near-instant transactions
* **Ultra-low fees** enabling microtransactions and everyday use
* **Optimized for utility** with 42 billion coin supply
* **EVM compatibility** for seamless Ethereum dApp migration

#### 🔗 True Interoperability

Built on the Cosmos SDK with native IBC (Inter-Blockchain Communication) support, EpixChain connects seamlessly to:

* Cosmos Hub
* Osmosis
* 50+ other IBC-enabled chains

#### 🏛️ Community-Driven Governance

EpixChain is not just a technology; it's a living, evolving organism shaped by its community:

* **Decentralized governance** through EPIX token holders
* **Transparent decision-making** with on-chain voting
* **Community proposals** for protocol improvements
* **Fair launch** with no investor or team allocations

### The EpixChain Ecosystem

#### Core Infrastructure

1. **Base Layer**: Cosmos SDK foundation ensuring security, stability, and governance
2. **EVM Layer**: Full Ethereum compatibility for smart contracts and dApps
3. **IBC Layer**: Cross-chain communication and asset transfers
4. **EpixNet Layer**: Decentralized internet and content delivery

#### Key Components

* **EpixMint Module**: Custom tokenomics with dynamic emission rates
* **Precompiled Contracts**: 10+ optimized contracts for enhanced functionality
* **Governance System**: On-chain voting and proposal mechanisms
* **Validator Network**: Secure, decentralized consensus mechanism

### Fair Launch Philosophy

EpixChain launched with a commitment to fairness and decentralization:

* **No Investors**: Zero venture capital or private investor allocations
* **No Team Funds**: No pre-allocated tokens for the development team
* **Community First**: 23 million EPIX airdropped to snapshot holders
* **Transparent Tokenomics**: Clear emission schedule reaching 42B max supply over 20 years

### Technical Excellence

#### Proven Foundation

Built on the battle-tested Cosmos SDK, EpixChain inherits:

* **Tendermint Consensus**: Byzantine fault-tolerant consensus mechanism
* **Modular Architecture**: Pluggable modules for extensibility
* **Proven Security**: Years of production use across the Cosmos ecosystem

#### EVM Compatibility

Full Ethereum Virtual Machine support means:

* **Seamless Migration**: Existing Ethereum dApps work without modification
* **Developer Familiarity**: Use existing Ethereum tools and frameworks
* **Rich Ecosystem**: Access to the entire Ethereum developer ecosystem

#### Advanced Features

* **Custom Gas Mechanics**: Optimized fee structures for different transaction types
* **Cross-Chain Assets**: Native support for assets from other blockchains
* **Governance Integration**: Protocol parameters controlled by token holders
* **Upgrade Mechanisms**: Seamless protocol upgrades through governance

### Getting Started

Ready to explore EpixChain? Here's how to begin:

1. **Set up your wallet** - Connect MetaMask or other EVM wallets
2. **Get EPIX tokens** - Acquire EPIX for transactions and governance
3. **Explore dApps** - Discover applications built on EpixChain
4. **Join governance** - Participate in protocol decision-making
5. **Build on EpixChain** - Start developing your own applications

### Community & Support

Join the growing EpixChain community:

* **Discord**: [Join our community](https://discord.gg/bF2GKHgrfv) for real-time discussions
* **Twitter**: [@zone\_epix](https://x.com/zone_epix) for updates and announcements
* **GitHub**: [EpixZone/EpixChain](https://github.com/EpixZone/EpixChain) for technical contributions
* **Website**: [epix.zone](https://epix.zone) for the latest information

***

*EpixChain: Building the infrastructure for a truly decentralized internet, one block at a time.*


# Architecture

## EpixChain Architecture

EpixChain's architecture is designed as a multi-layered system that combines the best of Cosmos SDK's modularity with Ethereum's smart contract capabilities, all optimized for the decentralized web.

### System Overview

### Core Layers

#### 1. Consensus Layer (**BFT**)

The foundation of Epix Chain's security and performance:

* **BFT Consensus**: Byzantine fault-tolerant consensus with instant finality
* **6-Second Block Times**: Optimized for fast transaction processing
* **Validator Network**: Decentralized set of validators securing the network
* **ABCI Interface**: Application Blockchain Interface connecting consensus to application logic

**Key Features:**

* Instant finality (no confirmation delays)
* Up to 1/3 Byzantine fault tolerance
* Deterministic block production
* Efficient state synchronization

#### 2. Cosmos SDK Layer (Application Logic)

Modular blockchain framework providing core functionality:

**Core Modules**

**Bank Module**

* Token transfers and balance management
* Multi-denomination support
* Supply tracking and controls

**Staking Module**

* Validator delegation and rewards
* Slashing for misbehavior
* Governance voting power calculation

**Governance Module**

* On-chain proposal submission
* Community voting mechanisms
* Parameter change proposals

**IBC Module**

* Cross-chain communication
* Asset transfers between chains
* Interchain accounts

**Custom Modules**

**EpixMint Module**

* Dynamic token emission with exponential decay
* Block-time aware minting calculations
* Maximum supply protection (42B EPIX cap)
* Governance-controlled parameters

#### 3. EVM Layer (Smart Contract Execution)

Full Ethereum Virtual Machine compatibility:

* **Solidity Support**: Deploy existing Ethereum contracts without modification
* **Web3 Compatibility**: Standard Ethereum JSON-RPC endpoints
* **Gas Optimization**: Efficient gas mechanics for lower transaction costs
* **State Management**: EVM state integrated with Cosmos SDK state

**Precompiled Contracts**

EpixChain includes 10+ precompiled contracts for enhanced functionality:

1. **Bank Precompile**: Native token operations
2. **Staking Precompile**: Validator delegation through EVM
3. **Distribution Precompile**: Reward claiming and management
4. **Governance Precompile**: Proposal voting from smart contracts
5. **IBC Precompile**: Cross-chain transfers via EVM
6. **ERC20 Precompile**: Native token wrapping
7. **Bech32 Precompile**: Address format conversion
8. **P256 Precompile**: Cryptographic operations
9. **Slashing Precompile**: Validator penalty information
10. **Callbacks Precompile**: Event-driven contract interactions

#### 4. Network Layer

Communication and API interfaces:

* **P2P Networking**: Tendermint's gossip protocol for block and transaction propagation
* **JSON-RPC**: Ethereum-compatible API for dApp integration
* **REST API**: Cosmos SDK's REST interface for blockchain queries
* **gRPC**: High-performance API for advanced integrations
* **WebSocket**: Real-time event streaming

### Data Flow

#### Transaction Processing

1. **Transaction Submission**: Users submit transactions via JSON-RPC or REST
2. **Mempool**: Transactions enter the mempool for validation
3. **Block Proposal**: Validators propose blocks with selected transactions
4. **Consensus**: Tendermint consensus validates and commits blocks
5. **State Update**: Application state is updated across all modules
6. **Event Emission**: Events are emitted for indexing and notifications

#### Cross-Chain Communication

1. **IBC Packet Creation**: Source chain creates IBC packet
2. **Relayer Submission**: Relayers submit packet to destination chain
3. **Verification**: Destination chain verifies packet authenticity
4. **Execution**: Packet is executed on destination chain
5. **Acknowledgment**: Success/failure acknowledgment sent back

### Security Model

#### Validator Security

* **Proof of Stake**: Economic security through staked EPIX tokens
* **Slashing Conditions**: Penalties for double-signing (5%) and downtime (1%)
* **Minimum Stake**: Dynamic minimum based on network participation
* **Delegation**: Token holders can delegate to validators

#### Smart Contract Security

* **EVM Isolation**: Smart contracts run in isolated EVM environment
* **Gas Limits**: Prevent infinite loops and resource exhaustion
* **Access Controls**: Module-level permissions and restrictions
* **Upgrade Governance**: Protocol upgrades require community approval

#### Network Security

* **Byzantine Fault Tolerance**: Up to 1/3 of validators can be malicious
* **Cryptographic Verification**: All transactions cryptographically signed
* **State Verification**: Merkle proofs for state integrity
* **Peer Authentication**: Secure P2P communication

### Performance Characteristics

#### Throughput

* **Block Time**: 6 seconds (configurable via governance)
* **Transaction Throughput**: \~1000 TPS (varies by transaction type)
* **Finality**: Instant (single block confirmation)
* **State Size**: Optimized for efficient storage and retrieval

#### Scalability Solutions

* **IBC Scaling**: Horizontal scaling through connected chains
* **Module Optimization**: Efficient state management and caching
* **Gas Optimization**: Reduced computational overhead
* **Pruning**: Historical state pruning for storage efficiency

### Integration Points

#### For Developers

* **Ethereum Tools**: Use existing Ethereum development tools
* **Cosmos SDK**: Access to native blockchain modules
* **Cross-Chain**: Build applications spanning multiple chains
* **Custom Logic**: Implement custom business logic in modules

#### For Users

* **MetaMask**: Connect with familiar Ethereum wallets
* **Cosmos Wallets**: Use Cosmos ecosystem wallets (Keplr, Cosmostation)
* **Cross-Chain**: Seamlessly move assets between chains
* **Governance**: Participate in protocol governance

#### For Validators

* **Standard Setup**: Use standard Cosmos SDK validator setup
* **Monitoring**: Comprehensive metrics and alerting
* **Upgrades**: Coordinated network upgrades through governance
* **Rewards**: Earn rewards through block production and delegation

***

*This architecture enables EpixChain to serve as the foundation for a truly decentralized internet while maintaining compatibility with existing blockchain ecosystems.*


# Tokenomics

## EpixChain Tokenomics

EpixChain features a carefully designed tokenomics model that balances fair distribution, sustainable growth, and long-term value creation. Our custom EpixMint module implements dynamic token emission with exponential decay to reach a maximum supply of 42 billion EPIX over 20 years.

### Token Overview

#### EPIX Token Specifications

| Property                    | Value                            |
| --------------------------- | -------------------------------- |
| **Symbol**                  | EPIX                             |
| **Name**                    | EpixChain                        |
| **Decimals**                | 18                               |
| **Base Denomination**       | aepix (1 EPIX = 10^18 aepix)     |
| **Maximum Supply**          | 42,000,000,000 EPIX (42 billion) |
| **Genesis Supply**          | 23,689,538 EPIX                  |
| **Initial Annual Emission** | 10.527 billion EPIX (Year 1)     |
| **Emission Reduction**      | 25% annually                     |

### Fair Launch Model

#### No Investors, No Team Funds

EpixChain launched with a commitment to true decentralization:

* **0% Investor Allocation**: No venture capital or private investor tokens
* **0% Team Allocation**: No pre-allocated tokens for the development team
* **100% Community**: All tokens distributed to the community through fair mechanisms

#### Genesis Distribution

**Total Genesis Supply: 23,689,538 EPIX**

1. **Airdrop to Snapshot Holders**: 11,844,769 EPIX (50%)
   * Distributed to holders captured in the snapshot
   * Fair distribution based on historical participation
2. **Community Pool**: 11,844,769 EPIX (50%)
   * Controlled by governance for ecosystem development
   * Funding for grants, partnerships, and community initiatives

### EpixMint Dynamic Emission Schedule

#### Annual Emission Breakdown

| Year        | Annual Emission (EPIX) | Cumulative Supply (EPIX) | Reduction Rate |
| ----------- | ---------------------- | ------------------------ | -------------- |
| 0 (Genesis) | -                      | 23,689,538               | -              |
| 1           | 10,527,000,000         | 10,550,689,538           | -              |
| 2           | 7,895,250,000          | 18,445,939,538           | 25%            |
| 3           | 5,921,437,500          | 24,367,377,038           | 25%            |
| 4           | 4,441,078,125          | 28,808,455,163           | 25%            |
| 5           | 3,330,808,594          | 32,139,263,757           | 25%            |
| 10          | 1,113,586,426          | 39,234,567,890           | 25%            |
| 15          | 372,195,476            | 41,456,789,123           | 25%            |
| 20          | 124,398,492            | 42,000,000,000           | 25%            |

#### Key Features

**Block-Time Awareness**

* Emission calculations adjust for actual block times
* Maintains consistent annual emission regardless of consensus changes
* Governance can modify block time parameters

**Maximum Supply Protection**

* Hard cap at 42 billion EPIX
* Automatic emission reduction as cap approaches
* No possibility of exceeding maximum supply

**Smooth Exponential Decay**

* 25% annual reduction in emission rate
* Predictable long-term supply schedule
* Balances early adoption incentives with long-term sustainability

### Token Distribution Mechanisms

#### Staking Rewards

**Validator Rewards**

* Block production rewards from newly minted tokens
* Commission from delegator rewards
* Slashing penalties for misbehavior

**Delegator Rewards**

* Proportional share of validator rewards
* Compound through automatic re-delegation
* Liquid staking compatibility

#### Community Pool

**Funding Sources**

* 2% community tax on staking rewards (configurable)
* Genesis allocation of 11.8M EPIX
* Governance-directed allocations

**Usage**

* Developer grants and bounties
* Marketing and ecosystem development
* Infrastructure and tooling support
* Community events and initiatives

### Governance Economics

#### Voting Power

* **1 EPIX = 1 Vote** (when staked)
* Delegated tokens inherit voting power
* Validators can vote on behalf of delegators
* Delegators can override validator votes

#### Proposal Economics

| Parameter           | Value                        |
| ------------------- | ---------------------------- |
| **Minimum Deposit** | 1,000 EPIX                   |
| **Voting Period**   | 7 days                       |
| **Quorum**          | 33.4% of staked tokens       |
| **Pass Threshold**  | 50% of participating votes   |
| **Veto Threshold**  | 33.4% of participating votes |

#### Governance Parameters

**Modifiable via Governance**

* Block time (currently 6 seconds)
* Community tax rate (currently 2%)
* Staking parameters
* Slashing conditions
* IBC parameters

### Economic Incentives

#### Staking Economics

**Annual Percentage Rate (APR)**

* Variable based on total staked percentage
* Target: 60-70% of total supply staked
* Higher rewards when less tokens are staked
* Lower rewards when more tokens are staked

**Slashing Conditions**

* **Double Sign**: 5% of staked tokens slashed
* **Downtime**: 1% of staked tokens slashed
* **Tombstoning**: Permanent exclusion for severe violations

#### Transaction Economics

**Gas Fees**

* Paid in EPIX tokens
* Dynamic pricing based on network congestion
* Burned or redistributed to validators
* Optimized for low-cost transactions

**Cross-Chain Fees**

* IBC transfer fees in EPIX
* Relayer incentivization
* Cross-chain security deposits

### Utility and Use Cases

#### Network Utility

1. **Transaction Fees**: Pay for all network operations
2. **Staking**: Secure the network and earn rewards
3. **Governance**: Vote on protocol upgrades and parameters
4. **IBC Transfers**: Cross-chain asset movement
5. **Smart Contract Gas**: Execute EVM transactions

#### EpixNet Integration

1. **Hosting Fees**: Pay for decentralized web hosting
2. **Content Delivery**: Incentivize content distribution
3. **Storage Payments**: Decentralized storage services
4. **Bandwidth Rewards**: Compensate network participants

#### DeFi Integration

1. **Liquidity Provision**: DEX and AMM participation
2. **Lending/Borrowing**: Collateral for DeFi protocols
3. **Yield Farming**: Earn additional rewards
4. **Cross-Chain DeFi**: Participate in multi-chain protocols

### Long-Term Sustainability

#### Deflationary Mechanisms

* **Transaction Fee Burning**: Reduce circulating supply
* **Slashing**: Remove tokens from circulation
* **Lost Keys**: Natural supply reduction over time

#### Value Accrual

* **Network Growth**: Increased demand for EPIX
* **EpixNet Adoption**: Utility-driven demand
* **Cross-Chain Activity**: IBC ecosystem growth
* **DeFi Integration**: Expanded use cases

#### Economic Security

* **High Staking Ratio**: Strong network security
* **Validator Diversity**: Decentralized consensus
* **Governance Participation**: Community-driven decisions
* **Transparent Tokenomics**: Predictable supply schedule

***

*EpixChain's tokenomics are designed to create a sustainable, fair, and valuable ecosystem that grows with adoption while maintaining strong economic incentives for all participants.*


# Getting Started

Quick setup guides for users, developers, and validators to begin using EpixChain.

## Quick Start Guide

Get up and running with EpixChain in just a few minutes! This guide will help you connect to the network, set up your wallet, and make your first transaction.

### Prerequisites

Before you begin, ensure you have:

* A modern web browser (Chrome, Firefox, Safari, or Edge)
* MetaMask or another EVM-compatible wallet installed
* Basic understanding of blockchain and cryptocurrency concepts

### Step 1: Add EpixChain to Your Wallet

#### MetaMask Configuration

1. **Open MetaMask** and click on the network dropdown (usually shows "Ethereum Mainnet")
2. **Add Custom Network** with the following details:

**Mainnet Configuration**

```
Network Name: EpixChain Mainnet
RPC URL: https://rpc.epixchain.com
Chain ID: 1916
Currency Symbol: EPIX
Block Explorer: https://scan.epix.zone
```

**Devnet Configuration (for development)**

```
Network Name: EpixChain Devnet
RPC URL: http://localhost:8545
Chain ID: 1917
Currency Symbol: EPIX
Block Explorer: http://localhost:8080
```

3. **Save** the network configuration
4. **Switch** to the EpixChain network

#### Alternative Wallets

EpixChain is compatible with any EVM wallet:

* **Trust Wallet**: Use the same network configuration
* **WalletConnect**: Connect through supported dApps
* **Coinbase Wallet**: Add as custom network
* **Brave Wallet**: Built-in support for custom networks

### Step 2: Get EPIX Tokens

#### For Mainnet

1. **Claim Airdrop** (if eligible):
   * Visit [epix.zone](https://epix.zone)
   * Connect your wallet
2. **Purchase EPIX**:
   * Use supported exchanges
   * Cross-chain bridges from other networks
   * DEX trading on EpixChain
3. **Earn EPIX**:
   * Stake tokens with validators
   * Participate in governance
   * Provide liquidity to DEXs

#### For Testnet

1. **Faucet** (development only):

   ```bash
   # Request testnet tokens
   curl -X POST https://faucet.epix.zone/request \
     -H "Content-Type: application/json" \
     -d '{"address": "YOUR_WALLET_ADDRESS"}'
   ```
2. **Local Development**:

   ```bash
   # If running local node
   epixd tx bank send validator YOUR_ADDRESS 1000000000000000000aepix \
     --chain-id epix_1917-1 \
     --keyring-backend test
   ```

### Step 3: Make Your First Transaction

#### Simple Transfer

1. **Open your wallet** and ensure you're on the EpixChain network
2. **Send EPIX** to another address:
   * Click "Send" in your wallet
   * Enter recipient address
   * Enter amount (remember: 1 EPIX = 10^18 aepix)
   * Confirm transaction
3. **Check transaction** on the block explorer

#### Interact with Smart Contracts

1. **Visit a dApp** built on EpixChain
2. **Connect your wallet** when prompted
3. **Approve transactions** as needed
4. **Monitor gas fees** (should be very low!)

### Step 4: Explore the Ecosystem

#### EVM Block Explorer

Visit [scan.epix.zone](https://scan.epix.zone) to:

* View transaction history
* Explore blocks and validators
* Check contract interactions
* Monitor network statistics

#### Governance Participation

1. **Stake your EPIX** with a validator
2. **View active proposals** on governance platforms
3. **Vote on proposals** that interest you
4. **Submit proposals** for network improvements

#### Cross-Chain Activities

1. **IBC Transfers**: Move assets to/from other Cosmos chains
2. **Bridge Assets**: Use bridges to connect with Ethereum and other networks
3. **Multi-Chain DeFi**: Participate in cross-chain protocols

### Common Commands

#### Using epixd CLI

```bash
# Check balance
epixd query bank balances YOUR_ADDRESS

# Send tokens
epixd tx bank send YOUR_ADDRESS RECIPIENT_ADDRESS 1000000000000000000aepix \
  --chain-id epix_1916-1 \
  --gas auto \
  --gas-adjustment 1.5

# Delegate to validator
epixd tx staking delegate VALIDATOR_ADDRESS 1000000000000000000aepix \
  --from YOUR_KEY \
  --chain-id epix_1916-1

# Vote on proposal
epixd tx gov vote 1 yes \
  --from YOUR_KEY \
  --chain-id epix_1916-1
```

#### Using Web3 Libraries

```javascript
// Connect to EpixChain
const Web3 = require('web3');
const web3 = new Web3('https://rpc.epixchain.com');

// Check balance
const balance = await web3.eth.getBalance('YOUR_ADDRESS');
console.log('Balance:', web3.utils.fromWei(balance, 'ether'), 'EPIX');

// Send transaction
const tx = {
  from: 'YOUR_ADDRESS',
  to: 'RECIPIENT_ADDRESS',
  value: web3.utils.toWei('1', 'ether'),
  gas: 21000
};

const signedTx = await web3.eth.accounts.signTransaction(tx, 'YOUR_PRIVATE_KEY');
const receipt = await web3.eth.sendSignedTransaction(signedTx.rawTransaction);
```

### Troubleshooting

#### Common Issues

**"Transaction Failed"**

* Check you have enough EPIX for gas fees
* Verify you're on the correct network
* Ensure recipient address is valid

**"Network Not Found"**

* Double-check RPC URL and Chain ID
* Try switching networks and back
* Clear browser cache if needed

**"Insufficient Funds"**

* Verify your EPIX balance
* Account for gas fees in transactions
* Check if tokens are staked/locked

#### Getting Help

* **Discord**: [Join our community](https://discord.gg/bF2GKHgrfv) for real-time support
* **Documentation**: Browse these docs for detailed guides
* **GitHub**: [Report issues](https://github.com/EpixZone/EpixChain/issues) or contribute
* **Twitter**: [@zone\_epix](https://x.com/zone_epix) for updates

### Next Steps

Now that you're connected to EpixChain:

1. **Set up staking** to earn rewards
2. **Explore governance** to participate in decisions
3. **Try cross-chain transfers** to other networks
4. **Build applications** on EpixChain
5. **Run a validator** to secure the network

Welcome to the EpixChain ecosystem! 🚀


# Wallet Guide

## Wallet Guide for EpixChain

This comprehensive guide will help you set up, configure, and use various wallets with EpixChain. Whether you're new to crypto or an experienced user, this guide covers everything you need to know.

### Supported Wallets

EpixChain supports both EVM-compatible wallets and Cosmos ecosystem wallets, giving you flexibility in how you interact with the network.

#### EVM Wallets (Recommended for Beginners)

* Easy click and add Epix to your EVM wallet: <https://explorer.epix.zone/wallet/suggest?wallet=evm>&#x20;
  * **MetaMask** - Most popular browser extension wallet
  * **Trust Wallet** - Mobile wallet with built-in dApp browser
  * **Coinbase Wallet** - User-friendly with institutional backing
  * **Brave Wallet** - Built into Brave browser
  * **WalletConnect** - Connect to dApps with mobile wallets

#### Cosmos Wallets (Advanced Features)

* Easy click and add Epix to your Keplr wallet: [https://explorer.epix.zone/wallet/suggest](https://explorer.epix.zone/wallet/suggest?wallet=evm)
  * **Keplr** - Leading Cosmos ecosystem wallet
  * **Cosmostation** - Mobile and web wallet for Cosmos chains
  * **Leap Wallet** - Modern Cosmos wallet with advanced features

### MetaMask Setup (Recommended)

#### Installation

1. **Download MetaMask**:
   * Visit [metamask.io](https://metamask.io)
   * Install browser extension or mobile app
   * Create new wallet or import existing one
2. **Secure Your Wallet**:
   * Write down your seed phrase securely
   * Never share your seed phrase with anyone
   * Use a strong password
   * Enable biometric authentication (mobile)

#### Adding EpixChain Network

1. **Open MetaMask** and click the network dropdown
2. **Add Network** and select "Add a network manually"
3. **Enter Network Details**:

**Mainnet Configuration**

```
Network Name: EpixChain Mainnet
New RPC URL: https://rpc.epixchain.com
Chain ID: 1916
Currency Symbol: EPIX
Block Explorer URL: https://scan.epix.zone
```

**Testnet Configuration**

```
Network Name: EpixChain Testnet
New RPC URL: http://localhost:8545
Chain ID: 1917
Currency Symbol: EPIX
Block Explorer URL: http://localhost:8080
```

4. **Save** and switch to EpixChain network

#### Importing EPIX Token

If EPIX doesn't appear automatically:

1. **Click "Import tokens"** in MetaMask
2. **Enter token details**:
   * Token Contract Address: `0x...` (native token)
   * Token Symbol: `EPIX`
   * Token Decimal: `18`
3. **Add Token**

### Keplr Setup (Advanced)

#### Installation and Setup

1. **Install Keplr**:
   * Visit [keplr.app](https://keplr.app)
   * Install browser extension
   * Create or import wallet
2. **Manually Configure Chain**:
   * Chain ID: `epix_1916-1` (mainnet) or `epix_1917-1` (testnet)
   * RPC: `https://rpc.epixchain.com`
   * REST: `https://api.epixchain.com`

### Getting EPIX Tokens

#### Airdrop Claim (If Eligible)

1. **Check Eligibility**:
   * Visit [epix.zone](https://epix.zone)
   * Connect your wallet
   * Check if you're eligible for the airdrop
2. **Claim Process**:
   * Click "Claim Airdrop"
   * Sign the transaction
   * Wait for confirmation
   * Tokens will appear in your wallet

#### Purchasing EPIX

**From Exchanges (Coming Soon)**

* Centralized exchanges will list EPIX
* Decentralized exchanges on EpixChain
* Cross-chain DEXs with IBC support

**Cross-Chain Bridges**

```bash
# Example: Bridge from Ethereum
1. Use supported bridge (coming soon)
2. Connect source wallet (Ethereum)
3. Connect destination wallet (EpixChain)
4. Bridge tokens with small fee
```

#### Earning EPIX

**Staking Rewards**

* Delegate EPIX to validators
* Earn \~8-15% APR (varies by network conditions)
* Compound rewards automatically

**Governance Participation**

* Vote on proposals
* Some proposals may include reward distributions
* Active participation benefits the ecosystem

**Liquidity Provision**

* Provide liquidity to DEXs
* Earn trading fees and liquidity rewards
* Higher risk but potentially higher returns

### Basic Wallet Operations

#### Sending EPIX

**Using MetaMask**

1. **Open MetaMask** and ensure you're on EpixChain network
2. **Click "Send"**
3. **Enter recipient address** (starts with `0x` for EVM or `epix` for Cosmos)
4. **Enter amount** in EPIX
5. **Review gas fee** (should be very low)
6. **Confirm transaction**

**Using Keplr**

1. **Open Keplr** and select EpixChain
2. **Click "Send"**
3. **Enter recipient address** (Cosmos format: `epix1...`)
4. **Enter amount** and select EPIX
5. **Set gas fee** (usually auto-calculated)
6. **Confirm transaction**

#### Receiving EPIX

1. **Copy your address**:
   * MetaMask: Click account name to copy address
   * Keplr: Click "Copy Address" button
2. **Share address** with sender
3. **Wait for confirmation**:
   * EpixChain has 6-second block times
   * Transactions are final after 1 block

#### Checking Balance and History

**MetaMask**

* Balance shown on main screen
* Click "Activity" tab for transaction history
* Use block explorer for detailed information

**Keplr**

* Balance displayed prominently
* Transaction history in "Activity" section
* Detailed view available through explorer links

### Advanced Features

#### Cross-Chain Transfers (IBC)

**Using Keplr**

1. **Navigate to IBC transfer** in supported dApps
2. **Select source and destination chains**
3. **Enter amount** to transfer
4. **Confirm transaction**
5. **Wait for relayer** to complete transfer (1-5 minutes)

**Supported Chains**

* Cosmos Hub
* Osmosis
* Juno
* Stargaze
* 50+ other IBC-enabled chains

#### Staking Operations

**Delegate to Validator**

1. **Choose validator** from list
2. **Check commission rate** and performance
3. **Enter delegation amount**
4. **Confirm transaction**
5. **Start earning rewards** immediately

**Claim Rewards**

1. **View accumulated rewards**
2. **Click "Claim Rewards"**
3. **Choose to restake** or withdraw
4. **Confirm transaction**

**Undelegate (Unbond)**

1. **Select validator** to undelegate from
2. **Enter amount** to undelegate
3. **Confirm transaction**
4. **Wait 21 days** for unbonding period
5. **Tokens return** to available balance

#### Governance Participation

**Viewing Proposals**

1. **Navigate to governance** section
2. **Browse active proposals**
3. **Read proposal details** carefully
4. **Check voting deadline**

**Voting Process**

1. **Select proposal** to vote on
2. **Choose vote option**:
   * Yes: Support the proposal
   * No: Oppose the proposal
   * Abstain: Participate without taking a side
   * No with Veto: Strong opposition (burns deposit)
3. **Confirm vote transaction**

### Security Best Practices

#### Wallet Security

1. **Seed Phrase Protection**:
   * Write down on paper, never digital
   * Store in multiple secure locations
   * Never share with anyone
   * Test recovery process
2. **Password Security**:
   * Use strong, unique passwords
   * Enable biometric authentication
   * Don't save passwords in browsers
   * Use password managers
3. **Device Security**:
   * Keep devices updated
   * Use antivirus software
   * Avoid public WiFi for transactions
   * Lock devices when not in use

#### Transaction Security

1. **Verify Addresses**:
   * Double-check recipient addresses
   * Use address book for frequent recipients
   * Be aware of address poisoning attacks
2. **Gas Fee Awareness**:
   * Understand gas fees before confirming
   * Don't overpay for simple transactions
   * Be cautious of extremely high gas estimates
3. **Smart Contract Interactions**:
   * Only interact with verified contracts
   * Understand what you're signing
   * Revoke unnecessary approvals
   * Use reputable dApps only

#### Common Scams to Avoid

1. **Fake Websites**: Always verify URLs
2. **Phishing Emails**: Never click suspicious links
3. **Social Engineering**: No legitimate support asks for seed phrases
4. **Fake Airdrops**: Be cautious of unexpected token claims
5. **Impersonation**: Verify official social media accounts

### Troubleshooting

#### Common Issues

**"Transaction Failed"**

* **Check gas fees**: Ensure sufficient EPIX for gas
* **Network congestion**: Try again later or increase gas
* **Wrong network**: Verify you're on EpixChain

**"Insufficient Funds"**

* **Check balance**: Ensure you have enough EPIX
* **Account for gas**: Reserve EPIX for transaction fees
* **Unstaked tokens**: Check if tokens are staked

**"Network Error"**

* **Check internet**: Ensure stable connection
* **Try different RPC**: Use alternative RPC endpoint
* **Clear cache**: Reset wallet cache if needed

#### Getting Help

1. **Documentation**: Check these docs first
2. **Community Discord**: <https://discord.gg/bF2GKHgrfv>
3. **GitHub Issues**: [github.com/EpixZone/EpixChain](https://github.com/EpixZone/EpixChain)
4. **EVM Block Explorer**: [scan.epix.zone](https://scan.epix.zone)

#### Emergency Recovery

If you lose access to your wallet:

1. **Use seed phrase** to recover in new wallet
2. **Import private keys** if available
3. **Contact support** if funds are stuck
4. **Never share recovery information** with anyone

***

*Remember: Your wallet security is your responsibility. Always verify information and never share sensitive details with anyone.*