Bitcoin Safe
Bitcoin Accounting
Bitcoin Safe + Clams
DescriptorBitcoin Safe is desktop software for managing your cold storage wallets. Free and open source on macOS, Windows, and Linux, it is a newer arrival in the Sparrow mold, pairing step-by-step single sig and multisig setup with broad hardware signer support. Clams tracks any Bitcoin Safe wallet through its descriptor: full address discovery, UTXO tracking, and cost basis calculations, all watch-only.
What Clams tracks
- All addresses from your wallet derivation paths
- Incoming and outgoing transactions
- Individual UTXOs with cost basis
- Transaction fees paid
- Capital gains on each spend
How it works
Copy the descriptor from Bitcoin Safe
Open your wallet in Bitcoin Safe and navigate to the Descriptor tab, then copy the wallet descriptor. This works the same way for both single sig and multisig wallets.
Add connection in Clams
Create a descriptor connection with the Clams CLI, replacing the placeholder with the descriptor you copied.
$ clams connections create --label my-bitcoin-safe --kind Descriptor --configuration '{"descriptor":"YOUR_DESCRIPTOR"}'
Sync transaction history
Run the sync command below to discover all addresses and import your full transaction history.
$ clams connections sync --label my-bitcoin-safe
Generate journal entries
Process your imported transactions into accounting journals with the command below.
$ clams journals process
Frequently asked questions
What data does Clams import from Bitcoin Safe?
Clams imports all addresses, incoming and outgoing transactions, UTXOs, and calculates cost basis per UTXO. Both single sig and multisig wallets are supported.
Does Clams access my private keys?
No. Clams uses watch-only access via the wallet descriptor. Your signing keys stay on your hardware signer. Clams can only view transactions, not spend funds.
Do single sig and multisig wallets connect differently?
No. Bitcoin Safe exposes a descriptor for every wallet. Open the Descriptor tab, copy the descriptor, and create one descriptor connection in Clams, the same way for single sig and multisig.
Can I track multiple Bitcoin Safe wallets?
Yes. Add each Bitcoin Safe wallet separately in Clams. Each wallet gets its own entry with independent syncing and reporting.
How do I get capital gains reports from my Bitcoin Safe transactions?
Connect your Bitcoin Safe wallet to Clams via descriptor. Clams calculates cost basis for every UTXO and tracks capital gains when you spend. Export reports for tax preparation from the Exports widget.
Does Clams discover all addresses automatically?
Yes. Clams scans the derivation paths from your descriptor and automatically discovers all used addresses. New addresses are detected when you sync.
Start tracking your Bitcoin Safe wallet
Install Clams and connect your wallet in minutes.