On this page

latest contributor to this doc

Last Edit:

@smk762

Check Lightning Activation Status

API-v2task::enable_lightning::status

The task::enable_lightning::status method checks the status of lightning node initialization.

ParameterTypeRequiredDefaultDescription
task_idinteger-The task id returned from task::enable_lightning::init.
forget_if_finishedbooleantrueIf false, the status of the task_id will still be available after the task has completed.

task::enable_lightning::status

POST
task::enable_lightning::status
{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "task::enable_lightning::status",
  "params": {
    "task_id": 1,
    "forget_if_finished": false
  },
  "id": 2
}

In the above response, spendable will always be 0 since the balance is unspendable until connections with lightning channel counterparties are established. Using the my_balance method after the coin is activated will get the spendable balance depending on how many channel counterparties are online. For exact channel balances and which channels are usable, use lightning::channels::list_open_channels_by_filter.