wallet

Initialize new wallet with randomly generated seed

Initializes a brand new wallet by generating a fresh BIP-39 mnemonic seed phrase on the server. The seed is encrypted on disk with pass and the returned mnemonic is the ONLY copy — the caller must back it up, the node will not show it again. Fails if a wallet file already exists; use /wallet/restore to overwrite from a known mnemonic instead.

post/wallet/init

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /wallet/init
Auth: API key in header api_key

Request body

passstring required

Spending password used to encrypt the wallet secret storage on disk. Required on every /wallet/unlock afterwards. Not recoverable — losing it means restoring from the mnemonic.

mnemonicPassstring

Optional BIP-39 passphrase (a.k.a. 25th word) that is mixed into the seed derivation. Distinct from pass: it is NOT stored by the node and MUST be supplied again on restore. Empty/omitted means no passphrase.

Response

New wallet with randomly generated seed created successfully

mnemonicstring required

Mnemonic seed phrase

Changes

No recorded changes to this operation across all 9 revisions of this API.