How conduition/wos works
wos is a Go client for Wallet of Satoshi’s custodial Bitcoin and Lightning REST API. The principal flow is to create or reopen a wallet, then use its read interface for account data and its signing interface for state-changing calls such as invoice creation and payment. The package also parses BOLT11 invoices and Lightning Addresses; the bundled bech32 implementation supports invoice decoding. Edges are limited to relationships visible in excerpts or the README; other documented capabilities are represented without guessed internal links.
Main entry points: reader.go Read-only access · wallet.go Wallet lifecycle · signer.go Signer interface · bolt11.go BOLT11 amount parsing
Components 18
Wallet access
- Wallet lifecycle
wallet.go - Credentials
wallet.go
WoS API operations
- Read-only access
reader.go - Wallet operations
wallet.go - Addresses and balances
reader.go - Payment history
reader.go - Fee estimates
reader.go - Invoice creation
wallet.go - Payment actions
wallet.go
Payment formats
- BOLT11 amount parsing
bolt11.go - Bech32 codec
bech32/bech32.go - Lightning Address
lnaddress.go
Signing
- Signer interface
signer.go - HMAC signer
signer.go
Other components
- Go client
- WoS REST API
- Remote signer
- Lightning / Bitcoin networks
Connections 22
- Go client → Wallet lifecycle: creates or opens
README.md - Wallet lifecycle → Read-only access: uses for reads
wallet.go - Wallet lifecycle → Signer interface: uses for writes
wallet.go - Credentials → Wallet lifecycle: opens
wallet.go - Credentials → Read-only access: provides token
wallet.go - Credentials → HMAC signer: creates
wallet.go - Wallet lifecycle → Addresses and balances: loads addresses
wallet.go - Read-only access → Addresses and balances: fetches
reader.go - Read-only access → Payment history: fetches
reader.go - Read-only access → Fee estimates: fetches
reader.go - Wallet operations → WoS REST API: sends signed requests
wallet.go - Read-only access → WoS REST API: sends GET requests
reader.go - Wallet operations → Invoice creation: creates
README.md - Wallet operations → Payment actions: sends
README.md - Wallet operations → Signer interface: requests signature
wallet.go - HMAC signer → Signer interface: implements
signer.go - Remote signer → Signer interface: can implement
README.md - Payment actions → BOLT11 amount parsing: parses invoice amount
wallet.go - BOLT11 amount parsing → Bech32 codec: decodes invoice
bolt11.go - Payment actions → Lightning Address: uses address URL
wallet.go - Payment actions → Lightning / Bitcoin networks: initiates payments
- Invoice creation → WoS REST API: creates invoice