₿

# UTXO Networks Integration Guide

Bitcoin • Litecoin • Dogecoin • Dash

Bitcoin (BTC) Litecoin (LTC) Dogecoin (DOGE) Dash (DASH) Provider: BlockCypher

This guide shows you how to integrate UTXO-based networks—Bitcoin (BTC), Litecoin (LTC), Dogecoin (DOGE), and Dash (DASH)—into your Bicrypto Ecosystem. You'll add UTXO credentials in `.env`, specify node providers (e.g., BlockCypher), and then configure master wallets and tokens in the admin panel. Unlike EVM-compatible chains, UTXO networks handle transactions differently (no "permit" tokens, different address management, etc.).

1

### Configure Environment Variables

Add to .env file

    # UTXO Networks (mainnet only)
    BTC_NETWORK="mainnet"
    LTC_NETWORK="mainnet"
    DOGE_NETWORK="mainnet"
    DASH_NETWORK="mainnet"

    # BTC Node Provider (blockcypher, haskoin)
    BTC_NODE="blockcypher"
    # BTC FEE RATE PRIORITY (regular, priority) *priority uses higher fees for faster mining
    BTC_FEE_RATE_PRIORITY="regular"

    # LTC, DOGE, DASH Node Provider (blockcypher)
    LTC_NODE="blockcypher"
    DOGE_NODE="blockcypher"
    DASH_NODE="blockcypher"

    # BlockCypher API (For UTXO Networks websocket)
    BLOCKCYPHER_TOKEN="YOUR_BLOCKCYPHER_TOKEN"  # e.g., 7f7a58e15fe34d18bcfce0...

#### 🔑 Environment Variables

- Network Settings: Currently, only `mainnet` is supported for all UTXO coins
- BTC_NODE: Choose `blockcypher` or `haskoin` (if supported)
- BTC_FEE_RATE_PRIORITY: Set `regular` or `priority` for transaction speed
- BLOCKCYPHER_TOKEN: Your API token from BlockCypher

2

### Acquire Node Provider & API Tokens

#### 🔗 BlockCypher Account

If you're using BlockCypher for LTC, DOGE, DASH (and optionally BTC):

- Create an account at BlockCypher
- Navigate to your dashboard
- Generate an API token
- Insert it into `BLOCKCYPHER_TOKEN`

#### 🏗️ Optional BTC Node Provider

If you prefer `haskoin` or run your own node:

- Adapt `BTC_NODE` accordingly
- Check your provider's documentation for setup instructions
- Ensure proper authentication and endpoint configuration

⚠️ Fee Priority: Priority mode uses higher fees for faster confirmations but increases operational costs.
3

### Apply Environment Updates

4

### Configure Master Wallet

Unlike EVM chains, UTXO-based coins (BTC, LTC, DOGE, DASH) manage addresses differently. However, Bicrypto's Master Wallet concept still applies for deposit and withdrawal flows.

1

#### Navigate to Master Wallet

Go to Admin → Extensions → Ecosystem → Master Wallet

2

#### Generate Master Wallets

Generate a New Master Wallet for each UTXO coin you want to enable (BTC, LTC, DOGE, DASH). These wallets hold addresses and manage incoming/outgoing transactions for each coin.

Important: Each UTXO coin requires its own master wallet due to different address formats and transaction structures.

5

### Enable UTXO Coins and Configure Fees

1

#### Enable UTXO Coins

Go to Admin → Extensions → Ecosystem → Tokens and enable the UTXO coins (BTC, LTC, DOGE, DASH) you plan to support. They appear as "native" tokens since they're not ERC-20 or token contracts.

2

#### Configure Fees and Limits

Click the 3 dots next to a coin and select Edit to configure:

##### 💰 Fee Configuration

- Minimum Fee: If your percentage fee (e.g., 1%) results in a very low fee (like $1 on $100 withdrawal), set a minimum fee (e.g., $5) to ensure you cover network transaction fees or operational overhead.
- Percentage Fee: The standard withdrawal fee based on a percentage of the withdrawn amount.

##### 📊 Limits

- Deposit Limits: The minimum/maximum amount a user can deposit for that coin.
- Withdraw Limits: The minimum/maximum amount a user can withdraw for that coin.

✅

### Final Notes & Best Practices

#### 🔐 Security

Storing private keys for UTXO coins is a critical responsibility. Always secure your wallet seeds/keys in a safe environment with proper backup procedures.

#### ⛽ Fee Rate Priority

BTC has a `BTC_FEE_RATE_PRIORITY` setting. If you notice slow confirmations, consider `priority`. For LTC, DOGE, and DASH, typical fees are lower.

#### 💰 Monitoring Balances

Check your Master Wallet balances regularly to ensure you have enough coin for withdrawal fees (especially if `BTC_FEE_RATE_PRIORITY` is `priority`).

#### 📈 Scaling

If high volume is expected, explore solutions like batching withdrawals or using a separate hot/cold wallet architecture for better security.

#### 🔄 UTXO vs EVM Differences

##### Address Management

UTXO coins generate new addresses for each transaction, enhancing privacy but requiring different tracking mechanisms.

##### Transaction Structure

Transactions are built from unspent outputs (UTXOs) rather than account balances, requiring specialized handling logic.

##### No Smart Contracts

These coins don't support complex smart contracts or permit-style transactions like EVM chains.

By configuring these UTXO environment variables, generating Master Wallets for BTC, LTC, DOGE, or DASH, and adjusting deposit/withdrawal fees and limits, you can effectively manage UTXO-based coins within your Bicrypto Ecosystem.