Compact Block Filters

Compact Block Filters (CBF) let Bitcoin-Safe scan the blockchain without asking an Electrum server which addresses belong to you.

Bitcoin-Safe downloads compact block filters from several random Bitcoin Core peers.

Instead of querying a central server, Bitcoin-Safe downloads a small filter for each block from random Bitcoin Core peers. Your wallet checks those filters locally and only downloads full blocks when needed.

CBF vs Electrum

FeatureCompact Block FiltersElectrum server
PrivacyGood - Wallet data stays localBad - Server can learn your addresses and history
Data sourceGood - Random Bitcoin Core peersNeutral - One chosen server
Initial syncNeutral - Usually slowerGood - Usually faster
Ongoing syncGood - Very fast after the first syncGood - Usually quick
Best forGood - Privacy-focused usersGood - Fastest setup and recovery

Why use CBF

What to expect

You can choose how many peers Bitcoin-Safe connects to. More peers improve redundancy, but usually increase bandwidth use and sync time. The default is 2 peers.

Unconfirmed transactions

CBF covers confirmed blocks only. To also get alerts for incoming unconfirmed payments, leave Instant transaction notifications enabled, which is the default.

Technical note

Compact block filters are defined in BIP158. Bitcoin-Safe uses the open-source Kyoto compact block filter module for BDK.

You can also use your own Bitcoin Core node as an initial peer in the Bitcoin network monitoring settings.

Initial node setting