wallet-btc
Overview of the @tetherto/wdk-wallet-btc module
A simple and secure package to manage BIP-84 (SegWit) wallets for the Bitcoin blockchain. This package provides a clean API for creating, managing, and interacting with Bitcoin wallets using BIP-39 seed phrases and BIP-84 derivation paths for Native SegWit addresses.
Default Derivation Path Change in v1.0.0-beta.4+
The default derivation path was updated in v1.0.0-beta.4 to use BIP-84 (Native SegWit) instead of BIP-44 (Legacy):
Previous path (<= v1.0.0-beta.3):
m/44'/0'/0'/0/{index}(Legacy addresses)Current path (v1.0.0-beta.4+):
m/84'/0'/0'/0/{index}(Native SegWit addresses)
If you're upgrading from an earlier version, existing wallets created with the old path will generate different addresses. Make sure to migrate any existing wallets or use the old path explicitly if needed for compatibility.
Use getAccountByPath to supply an explicit derivation path when importing or recreating legacy wallets.
Features
BIP-39 Seed Phrase Support: Generate and validate BIP-39 mnemonic seed phrases
Bitcoin Derivation Paths: Support for BIP-84 standard derivation paths for Bitcoin (m/84'/0')
Multi-Account Management: Create and manage multiple accounts from a single seed phrase
Address Types Support: Generate and manage Legacy, SegWit, and Native SegWit addresses
UTXO Management: Track and manage unspent transaction outputs
Transaction Management: Create, sign, and broadcast Bitcoin transactions
Fee Estimation: Dynamic fee calculation with different priority levels
Electrum Support: Connect to Electrum servers for network interaction
TypeScript Support: Full TypeScript definitions included
Memory Safety: Secure private key management with memory-safe implementation
Network Flexibility: Support for both mainnet and testnet
Transaction Building: Support for complex transaction construction with multiple inputs/outputs
Supported Networks
This package works with Bitcoin networks:
Bitcoin Mainnet (
"bitcoin")Bitcoin Testnet (
"testnet")Bitcoin Regtest (
"regtest")
Electrum Server Configuration
Important: While the package defaults to electrum.blockstream.info:50001 for convenience, we strongly recommend configuring your own Electrum server for production use.
Recommended Approach:
For Production:
Set up your own Fulcrum server for optimal performance and reliability
Use recent Fulcrum versions that support pagination for high-transaction addresses
For Development/Testing:
fulcrum.frznode.com:50001- Generally faster than defaultelectrum.blockstream.info:50001- Default fallback