Bitcoin • Litecoin • Dogecoin • Dash
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.).
# 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...
mainnet is supported for all UTXO coinsblockcypher or haskoin (if supported)regular or priority for transaction speedIf you're using BlockCypher for LTC, DOGE, DASH (and optionally BTC):
BLOCKCYPHER_TOKEN
If you prefer haskoin or run your own node:
BTC_NODE accordinglyUnlike 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.
Go to Admin → Extensions → Ecosystem → Master Wallet
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.
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.
Click the 3 dots next to a coin and select Edit to configure:
Storing private keys for UTXO coins is a critical responsibility. Always secure your wallet seeds/keys in a safe environment with proper backup procedures.
BTC has a BTC_FEE_RATE_PRIORITY setting. If you notice slow confirmations, consider priority. For LTC, DOGE, and DASH, typical fees are lower.
Check your Master Wallet balances regularly to ensure you have enough coin for withdrawal fees (especially if BTC_FEE_RATE_PRIORITY is priority).
If high volume is expected, explore solutions like batching withdrawals or using a separate hot/cold wallet architecture for better security.
UTXO coins generate new addresses for each transaction, enhancing privacy but requiring different tracking mechanisms.
Transactions are built from unspent outputs (UTXOs) rather than account balances, requiring specialized handling logic.
These coins don't support complex smart contracts or permit-style transactions like EVM chains.