task_create_new_account

If you have activated a coin with the task::enable_utxo::init or task::enable_qtum::init and are using HD Mode, your funds may be spread across a range of addresses under a specified account index. The methods below will return the combined balance of your account, detailing the balance for each active account address.

API-v2init

init

Use the task::create_new_account::init method to initialise a HD account.

Arguments

Parameter	Type	Description
coin	string	Ticker of coin you would like to initialise a HD account for.
account_id	string	Optional. If not defined, will increment to the next unused account id in the wallet.
scan	string	Optional. If `true`, will scan the account for funded addresses. Defaults to `true`.
gap_limit	string	Optional. The maximum number of empty addresses in a row. Defaults to the value provided on activation, or 20 if no value was provided.

Response

Parameter	Type	Description
task_id	integer	An identifying number which is used to query task status.

📌 Examples

Command

init

POST

task::create_new_account::init

{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "task::create_new_account::init",
  "params": {
    "coin": "KMD",
    "account_id": 77,
    "scan": true,
    "gap_limit": 20
  }
}

API-v2status

status

Use the task::create_new_account::status method to query the status of a HD account creation task.

Arguments

Parameter	Type	Description
task_id	integer	The identifying number returned when initiating the withdrawal process.
forget_if_finished	boolean	If `false`, will return final response for completed tasks. Optional, defaults to `true`.

Response

Parameter	Type	Description
status	string	Status of the task. `Ok`, `InProgress` or `Error`.
details	string or object	If in progress, either `Preparing` or `RequestingAccountBalance`. Once complete, a standard WalletAccountInfo object.

📌 Examples

Command

POST

status

{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "task::create_new_account::status",
  "params": {
    "task_id": 1
  }
}

On this page

task_create_new_account

init