midnight-wallet:wallet-sdk

What problem does it solve?

Developers integrating the Midnight Wallet SDK need a clear, authoritative reference to construct wallets, derive keys securely, observe sync state, and drive end-to-end transaction flows without misconfiguring services or mishandling secrets. This Skill centralizes patterns, examples, and configuration guidance to reduce integration errors and speed development.

Core Features & Use Cases

• Wallet construction: step-by-step guidance for deriving HD keys, converting to shielded/unshielded/dust keys, and initializing WalletFacade with proper configuration.
• Sync and state observation: how to monitor SyncProgress, use waitForSyncedState, and safely read balances across shielded, unshielded, and dust wallets.
• Transaction lifecycle: create, balance, sign, prove, submit, revert, and estimate fees; includes dust registration workflows and synchronous signing callbacks.
• Infrastructure clients & encoding: connecting indexer/node/prover clients and Bech32m address encoding/decoding practices.
• Use Case: implement a local devnet wallet that derives keys from a mnemonic, waits for sync, registers UTXOs for dust generation, and performs shielded and unshielded transfers.

Quick Start

Construct a WalletFacade from a seed, start it with the derived secret keys, and wait for a fully synced state before reading balances or submitting transactions.