How urriki1502/wam-silent-wallet works
WAM Silent Wallet is an experimental, regtest-only PySide6 desktop wallet. The user-facing flow runs from the Qt application and its pages through wallet/session and payment orchestration; the wallet delegates Silent Payments protocol work to the separate WSP engine, while node access goes through the WAM SDK to local WAM Core. The graph also preserves receive, recovery, sync, configuration, fees, and privacy inspection. Some domain links are documented in the README; source excerpts are partial, so unsampled implementation details and uncertain call paths are omitted.
Main entry points: main_window.py Main window · wallet_service.py Wallet service · node_service.py Node service · payment_service.py Payment orchestration
Components 26
Desktop interface
- Qt application entry
app.py - Main window
src/wam_silent_wallet/main_window.py - Lock and unlock
src/wam_silent_wallet/pages/lock_page.py - Receive page
src/wam_silent_wallet/pages/receive_page.py - Send page
src/wam_silent_wallet/pages/send_page.py - Payments page
src/wam_silent_wallet/pages/payments_page.py - Backup page
src/wam_silent_wallet/pages/backup_page.py - Node page
src/wam_silent_wallet/pages/node_page.py - Privacy page
src/wam_silent_wallet/pages/privacy_page.py - Settings page
src/wam_silent_wallet/pages/settings_page.py - Shared UI components
src/wam_silent_wallet/ui_components.py
Wallet orchestration
- Unlock session
src/wam_silent_wallet/services/session_service.py - Wallet service
src/wam_silent_wallet/services/wallet_service.py - Payment orchestration
src/wam_silent_wallet/services/payment_service.py - Fee policy
src/wam_silent_wallet/services/fee_service.py - Background sync
src/wam_silent_wallet/services/sync_service.py - Sync worker
src/wam_silent_wallet/services/sync_worker.py - Runtime configuration
src/wam_silent_wallet/services/config_service.py - Wallet state store
Payment protocol
- WSP-1 protocol engine
Node and privacy
- Node service
src/wam_silent_wallet/services/node_service.py - Network privacy checks
src/wam_silent_wallet/services/privacy_service.py - WAM SDK
- Local WAM Core
- WAM regtest chain
Other components
- Wallet user
Connections 34
- Wallet user → Qt application entry: launches
README.md - Qt application entry → Main window: creates
app.py - Main window → Lock and unlock: hosts
src/wam_silent_wallet/main_window.py - Main window → Receive page: hosts
src/wam_silent_wallet/main_window.py - Main window → Send page: hosts
src/wam_silent_wallet/main_window.py - Main window → Payments page: hosts
src/wam_silent_wallet/main_window.py - Main window → Backup page: hosts
src/wam_silent_wallet/main_window.py - Main window → Node page: hosts
src/wam_silent_wallet/main_window.py - Main window → Privacy page: hosts
src/wam_silent_wallet/main_window.py - Main window → Settings page: hosts
src/wam_silent_wallet/main_window.py - Main window → Unlock session: uses
src/wam_silent_wallet/main_window.py - Main window → Wallet service: uses
src/wam_silent_wallet/main_window.py - Main window → Node service: uses
src/wam_silent_wallet/main_window.py - Main window → Runtime configuration: uses
src/wam_silent_wallet/main_window.py - Main window → Background sync: coordinates
src/wam_silent_wallet/main_window.py - Main window → Sync worker: starts
src/wam_silent_wallet/main_window.py - Unlock session → Wallet service: verifies passphrase
src/wam_silent_wallet/services/session_service.py - Send page → Payment orchestration: requests review
src/wam_silent_wallet/pages/send_page.py - Payment orchestration → Wallet service: constructs payment
src/wam_silent_wallet/services/payment_service.py - Payment orchestration → Node service: scans and broadcasts
src/wam_silent_wallet/services/payment_service.py - Payment orchestration → Fee policy: quotes fees
src/wam_silent_wallet/services/payment_service.py - Fee policy → Node service: queries node
src/wam_silent_wallet/services/fee_service.py - Wallet service → WSP-1 protocol engine: uses protocol
README.md - Wallet service → Wallet state store: persists wallet state
README.md - Backup page → Wallet service: supports recovery
- Background sync → Wallet service: scans wallet
src/wam_silent_wallet/services/sync_service.py - Background sync → Node service: checks readiness
src/wam_silent_wallet/services/sync_service.py - Sync worker → Background sync: runs cycles
- Privacy page → Network privacy checks: refreshes status
src/wam_silent_wallet/pages/privacy_page.py - Network privacy checks → Node service: inspects network
src/wam_silent_wallet/services/privacy_service.py - Node service → WAM SDK: uses RPC client
README.md - WAM SDK → Local WAM Core: sends RPC
README.md - Local WAM Core → WAM regtest chain: validates chain
README.md - Main window → Shared UI components: renders
src/wam_silent_wallet/main_window.py