createwallet

createwallet "wallet_name" ( disable_private_keys blank "passphrase" avoid_reuse descriptors load_on_startup )

Creates and loads a new wallet.

Argument #1 – wallet_name

Type: string, required

Specifies the name of the new wallet. If a path is provided, the wallet will be created at the specified location.

Argument #2 – disable_private_keys

Type: boolean, optional, default=false

Disables the use of private keys, allowing only watch-only addresses in this mode.

Argument #3 – blank

Type: boolean, optional, default=false

Creates a blank wallet with no keys or HD seed. A seed can be set later using sethdseed.

Argument #4 – passphrase

Type: string

Encrypts the wallet with the provided passphrase.

Argument #5 – avoid_reuse

Type: boolean, optional, default=false

Tracks coin reuse and differentiates between “dirty” and “clean” coins, with privacy considerations in mind.

Argument #6 – descriptors

Type: boolean, optional, default=false

Creates a native descriptor-based wallet, which uses descriptors internally for address creation.

Argument #7 – load_on_startup

Type: boolean, optional, default=null

Determines if the wallet is saved to persistent settings and loaded on startup. Set to true to add the wallet to the startup list, false to remove it, or null to leave unchanged.

Result

{                       (json object)
  "name" : "str",       (string) The wallet name if created successfully. If the wallet was created using a full path, the wallet_name will be the full path.
  "warning" : "str"     (string) Warning message if wallet was not loaded cleanly.
}

Examples

bitcoinevo-cli createwallet "testwallet"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "createwallet", "params": ["testwallet"]}' -H 'content-type: text/plain;' http://127.0.0.1:7332/