Open a wallet
The spending key stays on the device: opening the wallet asks for three confirmations on it (spending key, viewing key, viewing pubkey), and every transfer or unshield is a blind-sign review. Unlock the device and open the ZKNOX Railgun app first — over USB plug it in; over Bluetooth pair it and turn Bluetooth on.
The spending key stays on the dabao (railgun-signer app), but it is a burner: it has no screen and signs everything at once, without review, for anyone who can reach its USB port. Test networks and small amounts only. The account index is the Railgun engine's, as for a recovery phrase. The emulator option reaches cargo xtask dabao-emu on 127.0.0.1:7600 (or RAILGUN_DABAO_EMULATOR) and works with the local daemon only.
Prefilled with the public test phrase (“yellow” twelve times). Anyone can spend from it: test networks only.
Use raw spending and viewing keys instead
Leave empty to use the Ethereum account of the same phrase (m/44'/60'/0'/0/index, as MetaMask or Rabby derive it). It pays the gas for shielding. A key entered here replaces it. The accounts of the test phrase are public too: anything sent to them can be taken by anyone.
Shields are signed by the Ledger's Ethereum app (m/44'/60'/index'/0/0: account index + 1 in Ledger Live), over USB. The device runs one app at a time: when you shield, the wallet asks you to open the Ethereum app, then to reopen the Railgun app. Enable Blind signing in the Ethereum app's settings: it cannot decode the shield call.
Shields are signed by the dabao's Ethereum key (m/44'/60'/0'/0/index, as for a recovery phrase), at once and without review.
Broadcasters are only used when their rate is between 10% under and 30% over the rate these signers announce (averaged). Prefilled with the four signers of the Railway wallet: using them means trusting that team for the reference rate. Required on mainnet. On Sepolia, write “none” to accept any authenticated offer if these signers announce nothing there.
Keys stay in the memory of the local daemon and are never written to disk. Synced notes and pending proofs are stored under the data directory.
Addresses
Public address
Private address
Balances
Public balances
Shielded balances
Unspent notes
Proofs of innocence waiting for submission
Each private transaction needs a follow-up proof before its change notes become spendable. Proofs are generated and submitted during sync, once the transaction is indexed. Transactions made before this wallet was opened here, or with another wallet, are detected and proved the same way. An entry whose transaction never reached the chain (a relayer that did not answer) is removed at the first sync 15 minutes after the proof.
Send through
By default the proof is regenerated until the fee matches the bundler's estimate within 1%, which asks the signer up to five times. Proving once asks the bundler for its estimate first: the exact operation is sent to it with a dummy proof and a state override under which the Railgun verifier accepts that proof, so nothing is signed and the limits are the bundler's own figures, with no margin added. The bundler must support state overrides in eth_estimateUserOperationGas; if it does not, the wallet falls back to the default path unless the box above is ticked, in which case it stops before any signature. If the limits turn out too low after proving, the operation stops before anything is sent.
The fee is paid in the wrapped chain currency, so a fair broadcaster charges the gas cost plus a margin: 1.1 to 1.3. Offers above the rate are ignored, and the operation stops before proving if the fee exceeds the maximum. Both apply with or without trusted signers.
“native” wraps and shields the chain currency. Otherwise an ERC-20 address; an approval is sent first when needed.
Shielding is always sent from the public account, whatever the transport.
Railgun keeps 0.25% of the unshielded amount. With 4337 and legacy the network fee is taken from the shielded wrapped-currency balance.