10.1 Introduction
- They hold users’ balances in their own accounts.
- Users interact with internal databases, not public blockchains.
- Funds are moved between users internally unless external payouts are needed.
10.2 Understanding custodial wallet constraints
10.3 Bitcoin in custodial contexts
Bitcoin is not a balance in an internal database by default. It consists of:- UTXOs controlled by private keys.
- Transactions needing fee estimation and broadcasting.
- Finality depending on confirmations.
- Internally model Bitcoin balances for users.
- Externally manage real Bitcoin funds on the blockchain.
- Handle real blockchain delays, fee fluctuations, and security risks.
10.4 Key architecture principles for adding Bitcoin support
10.5 Design models for exposing Bitcoin to users
There are different ways to introduce Bitcoin functionality into a custodial wallet:-
Buy/Sell Only (No Send/Receive)
- Allow users to buy bitcoin using their fiat balance.
- Allow users to sell bitcoin into fiat.
- Bitcoin stays inside the company’s custody.
-
On-Chain Send and Receive
- Allow users to send and receive real Bitcoin addresses.
- Real blockchain transactions are made.
- Users experience real fees, real confirmations, real delays.
-
Lightning Network Support (Optional Layer)
- Allow fast Bitcoin payments over the Lightning Network.
- Users can send or receive bitcoin with minimal fees and instant finality.
-
Hybrid Approaches
- Internal custodial Bitcoin accounts.
- Withdrawal to on-chain Bitcoin addresses available for advanced users.
- Optional Lightning withdrawals for small amounts.
10.6 Compliance and risk considerations
Adding Bitcoin to a custodial platform triggers serious legal and operational questions.Even if you abstract Bitcoin behind your app UI, the regulators see your company as the custodian. Meaning you carry responsibility for Bitcoin user funds.
10.7 Building the right user experience
Bitcoin behaves differently than fiat:- Transaction settlement is not instant.
- Network congestion can delay confirmations.
- Fees fluctuate minute to minute.
- Privacy expectations are higher.
- Explain confirmations (pending → confirming → finalized).
- Explain network fees transparently.
- Show real-time balances even if pending transactions exist.
- Warn about volatility if users are holding bitcoin as an asset.
- Provide clear backup/recovery pathways if users are allowed custody (rare in custodial models).
10.8 Infrastructure options
You must decide:
Most fintechs prefer starting with partnerships, then migrating to partial self-custody later once operational experience grows.
10.9 Case study models
You can choose models based on:
- User sophistication
- Regulatory environment
- Strategic goals (full Bitcoin experience vs Bitcoin-as-payments-rail)
10.10 PM reflection points
If you are planning Bitcoin support in a custodial platform:- Decide early: Buy/sell only? Full send/receive? Lightning?
- Understand that Bitcoin custody is serious. You are now securing real, irreversible money.
- Plan user flows that explain confirmations, fees, and volatility gently but honestly.
- Handle real Bitcoin transaction fees gracefully, especially for microtransactions.
- Ensure operational teams understand blockchain monitoring, transaction broadcasting, and mempool dynamics.
10.11 Summary of module 10
Adding Bitcoin support into custodial wallets requires:- Abstracting UTXO-based Bitcoin reality into account-like user experiences.
- Building real security and compliance infrastructure behind simple frontends.
- Choosing whether to manage Bitcoin yourself or partner with serious infrastructure providers.
- Handling transaction settlement, fee dynamics, and privacy expectations properly.