Programmatic DUST
A local, terminal-first walkthrough of the Midnight Foundation tutorial. It creates a wallet, prints the shielded / unshielded / dust addresses, waits for tNIGHT from the faucet, then explicitly registers NIGHT UTXOs for DUST generation — the same step Lace performs when you click Generate tDUST, but exposed through the wallet SDK.
bun scripts/dust-demo-preprod.mjs
The script writes its scratch wallet to .midnight-wallet-preprod-demo.local (0600, gitignored) and polls the wallet state until spendable DUST coins appear.
- Creates or restores a hex wallet seed.
- Derives shielded, unshielded, and DUST addresses.
- Prompts you to fund the unshielded address with the preprod tNIGHT faucet.
- Registers NIGHT UTXOs for DUST generation to a target DUST address.
- Polls until
state.dust.availableCoins.length >= 1— the true spendable signal.
- Bun runtime.
- A local Midnight proof server on port 6300.
- Preprod tNIGHT from the faucet to the unshielded address.
- Patience — DUST generation can take 1–20 minutes.
The deploy script for the Midnight Ledger demo assumes tDUST is already available. That usually happens inside Lace, but the docs also show how to do it entirely in code. This script mirrors that guide so you can automate the full flow from wallet creation to spendable DUST without leaving the terminal.
Preprod-specific gotchas (fresh-wallet sync stalls, DustSpendProcessed decode errors, DUST-regeneration concurrency caps): see known issues →