createwallet

Back to wallet

Wallet

Summary

Creates and loads a new wallet.

Description

Creates and loads a new wallet.

Arguments

  • wallet_name (STR, required): The name for the new wallet. If this is a path, the wallet will be created at the path location.
  • disable_private_keys (BOOL): Disable the possibility of private keys (only watchonlys are possible in this mode).
  • blank (BOOL): Create a blank wallet. A blank wallet has no keys.
  • passphrase (STR): Encrypt the wallet with this passphrase.
  • avoid_reuse (BOOL): Keep track of coin reuse, and treat dirty and clean coins differently with privacy considerations in mind.
  • descriptors (BOOL): If set, must be "true"
  • load_on_startup (BOOL): Save wallet name to persistent settings and load on startup. True to add wallet to startup list, false to remove, null to leave unchanged.
  • external_signer (BOOL): Use an external signer such as a hardware wallet. Requires -signer to be configured. Wallet creation will fail if keys cannot be fetched. Requires disable_private_keys and descriptors set to true.

Results

  • value (OBJ): No description.
  • name (STR): The wallet name if created successfully. If the wallet was created using a full path, the wallet_name will be the full path.
  • warnings (ARR, optional): Warning messages, if any, related to creating and loading the wallet.
    • value (STR): No description.

Examples

qbit-cli createwallet "testwallet"

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "createwallet", "params": ["testwallet"]}' -H 'content-type: application/json' http://127.0.0.1:8352/

qbit-cli -named createwallet wallet_name=descriptors avoid_reuse=true load_on_startup=true

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "createwallet", "params": {"wallet_name":"descriptors","avoid_reuse":true,"load_on_startup":true}}' -H 'content-type: application/json' http://127.0.0.1:8352/