Alby Hub
Bitcoin Accounting
Alby Hub + Clams
NWCAlby Hub is a simplified way of running your own self-custodial Lightning node, either hosted in the cloud or on your own hardware. Clams connects via Nostr Wallet Connect (NWC) to track your transactions, including zaps.
What Clams tracks
- Lightning payments and invoices
- Nostr zaps sent and received
- Automatic cost basis tracking for income and spending
- Timestamps and amounts for all transactions
How it works
Create a connection in Alby Hub
In Alby Hub, go to Connections > Add a Connection. Name your connection and click Next to generate an NWC connection string.
Copy the NWC connection string
Copy the NWC connection secret to your clipboard. This string lets Clams connect directly to your Alby Hub.
Add NWC wallet in Clams
Create an NWC connection with the Clams CLI. Replace the URI in the command below with your connection string.
$ clams connections create --label my-alby-hub --kind Nwc --configuration '{"uri":"YOUR_NWC_URI"}'
Sync transaction history
Import your full payment history. Re-run anytime to pull the latest activity.
$ clams connections sync --label my-alby-hub
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 Alby Hub?
Clams imports all Lightning payments and invoices from Alby Hub including zaps, tips, and purchases. Each transaction includes timestamp, amount, and any available metadata.
Does Clams access my private keys?
No. Clams connects via Nostr Wallet Connect (NWC) with read-only permissions. NWC is an open protocol that lets apps request specific capabilities from your wallet. You control exactly what Clams can access.
What is Nostr Wallet Connect?
Nostr Wallet Connect (NWC) is an open protocol built on Nostr that allows applications to request specific permissions from Bitcoin Lightning wallets. It enables secure, permissioned connections without exposing your keys.
How do I get capital gains reports from my Alby Hub transactions?
Connect Alby Hub to Clams via NWC. Clams imports your transaction history and calculates cost basis. Export capital gains reports for tax preparation from the Exports widget.