BitBox02
Bitcoin Accounting

BitBox02 + Clams

xPub

BitBox02 is a Swiss-made hardware wallet known for its minimalist design and security-first approach. The Bitcoin-only edition removes altcoin code entirely for a reduced attack surface. Clams tracks your BitBox02 using an xPub exported via BitBoxApp. Your signing keys never leave the device.

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

01

Export xPub from BitBoxApp

Open BitBoxApp, connect your BitBox02, and export your account's xPub from account settings. Your signing keys stay secure on your device.

02

Add connection in Clams

Create an xPub connection with the Clams CLI. Replace the xpub value in the command below with your exported key.

$ clams connections create --label my-bitbox02 --kind XPub --configuration '{"xpub":"YOUR_XPUB","address_types":["bech32"]}'
03

Sync transaction history

Run the sync command below to discover all addresses and import your full transaction history.

$ clams connections sync --label my-bitbox02
04

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 BitBox02?

Clams imports all addresses derived from your xPub, incoming and outgoing transactions, UTXOs, and calculates cost basis per UTXO. Your signing keys never leave the BitBox02.

Does Clams access my private keys?

No. Clams uses watch-only access via xPub. Your signing keys stay secure on your BitBox02 device. The xPub only allows Clams to view addresses and transactions, not spend funds.

Which BitBox02 editions are supported?

Both BitBox02 Multi edition and Bitcoin-only edition are fully supported. Export your xPub from BitBoxApp and add it to Clams.

How do I get capital gains reports from my BitBox02 transactions?

Export your xPub from BitBoxApp and add it to Clams. Clams calculates cost basis for every UTXO and tracks capital gains when you spend. Export reports from the Exports widget.

Do I need my BitBox02 connected to sync new transactions?

No. Once you've added the xPub to Clams, you can sync at anytime. Your BitBox02 can stay safely disconnected.

Start tracking your BitBox02 wallet

Install Clams and connect your wallet in minutes.