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
BlockCypher dashboard showing how to create an API 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

Navigating to Ecosystem Master Wallet in Bicrypto
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.

Generate Master Wallet button Master Wallet creation process

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.

List of tokens in Bicrypto Ecosystem
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.
Coin edit form showing fee and limit configuration

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.