How hathornetwork/hathor-wallet-lib works
Hathor Wallet Library is a client-side SDK for managing Hathor wallets and transactions. Its principal workflow is to configure a network and persistent storage, create/use a wallet, synchronize wallet state, construct and sign transactions, then submit them through API clients. The repository also includes shielded-address processing, Nano Contract parsing, token/transaction primitives, and wallet/swap service integrations. The README documents storage as a required setup step; some subsystem paths and connections are supported only by the source index, not sampled implementation excerpts.
Main entry points: wallet.ts Wallet API · sendTransaction.ts Transaction creation · storage.ts Wallet scanning · sendTransactionWalletService.ts Wallet-service sending
Components 22
Wallet lifecycle
- Network configuration
src/config.ts - Wallet API
src/new/wallet.ts
Transaction lifecycle
- Transaction creation
src/new/sendTransaction.ts - Wallet-service sending
src/wallet/sendTransactionWalletService.ts - Transaction model
src/models/transaction.ts - Transaction operations
src/utils/transaction.ts
Protocol features
- Address model
src/models/address.ts - Address derivation
src/utils/address.ts - Token operations
src/utils/tokens.ts - Transaction headers
src/headers/parser.ts - Shielded processing
src/shielded/processing.ts - Nano Contract parsing
src/nano_contracts/parser.ts
Network connectivity
- Wallet connection
src/new/connection.ts - Wallet synchronization
src/sync/stream.ts - WebSocket client
src/websocket/index.ts - Transaction API
src/api/txApi.ts - Wallet API client
src/api/wallet.ts - Swap service
src/wallet/api/swapService.ts
Wallet state
- Wallet storage
src/storage/storage.ts - Wallet scanning
src/utils/storage.ts
Other components
- SDK caller
- Hathor node and services
Connections 28
- SDK caller → Network configuration: configures
- SDK caller → Wallet API: uses
- Wallet API → Network configuration: reads settings
src/new/wallet.ts - Wallet API → Wallet connection: opens connection
src/new/wallet.ts - Wallet connection → WebSocket client: uses
src/new/connection.ts - Wallet connection → Wallet synchronization: coordinates
src/new/connection.ts - Wallet API → Transaction creation: creates transactions
src/new/wallet.ts - Wallet API → Wallet-service sending: delegates sending
src/wallet/sendTransactionWalletService.ts - Transaction creation → Transaction API: submits transactions
src/new/sendTransaction.ts - Transaction creation → Transaction model: builds
src/new/sendTransaction.ts - Transaction creation → Transaction operations: uses transaction operations
src/new/sendTransaction.ts - Wallet-service sending → Transaction API: uses transaction API
- Wallet-service sending → Transaction model: uses transaction model
src/wallet/sendTransactionWalletService.ts - Transaction model → Transaction headers: parses headers
src/models/transaction.ts - Wallet API → Wallet storage: persists wallet state
src/new/wallet.ts - Wallet scanning → Wallet API client: fetches address history
src/utils/storage.ts - Wallet scanning → Address derivation: derives addresses
src/utils/storage.ts - Wallet scanning → Shielded processing: processes outputs
src/utils/storage.ts - Wallet API → Token operations: uses token operations
src/new/wallet.ts - Transaction creation → Address model: uses address model
src/new/sendTransaction.ts - Transaction creation → Token operations: uses token operations
src/new/sendTransaction.ts - Wallet API → Wallet API client: uses wallet API
src/new/wallet.ts - Wallet API → Shielded processing: supports shielded features
- Wallet API → Nano Contract parsing: supports Nano Contracts
- Wallet API → Swap service: supports swaps
- Transaction API → Hathor node and services: requests node data
- Wallet API client → Hathor node and services: requests wallet data
- Swap service → Hathor node and services: connects to service