getdeploymentinfo

Back to blockchain

Summary

Returns an object containing various state info regarding deployments of consensus changes.

Description

Returns an object containing various state info regarding deployments of consensus changes.

Arguments

  • blockhash (STR_HEX): The block hash at which to query deployment state

Results

  • value (OBJ): No description.
  • hash (STR): requested block hash (or tip)
  • height (NUM): requested block height (or tip)
  • deployments (OBJ_DYN): No description.
    • xxxx (OBJ): name of the deployment
    • type (STR): one of "buried", "bip9"
    • height (NUM, optional): height of the first block which the rules are or will be enforced (only for "buried" type, or "bip9" type with "active" status)
    • active (BOOL): true if the rules are enforced for the mempool and the next block
    • bip9 (OBJ, optional): status of bip9 softforks (only for "bip9" type)
      • bit (NUM, optional): the bit (0-28) in the block version field used to signal this softfork (only for "started" and "locked_in" status)
      • start_time (NUM_TIME): the minimum median time past of a block at which the bit gains its meaning
      • timeout (NUM_TIME): the median time past of a block at which the deployment is considered failed if not yet locked in
      • min_activation_height (NUM): minimum height of blocks for which the rules may be enforced
      • status (STR): status of deployment at specified block (one of "defined", "started", "locked_in", "active", "failed")
      • since (NUM): height of the first block to which the status applies
      • status_next (STR): status of deployment at the next block
      • statistics (OBJ, optional): numeric statistics about signalling for a softfork (only for "started" and "locked_in" status)
      • period (NUM): the length in blocks of the signalling period
      • threshold (NUM, optional): the number of blocks with the version bit set required to activate the feature (only for "started" status)
      • elapsed (NUM): the number of blocks elapsed since the beginning of the current period
      • count (NUM): the number of blocks with the version bit set in the current period
      • possible (BOOL, optional): returns false if there are not enough blocks left in this period to pass activation threshold (only for "started" status)
      • signalling (STR, optional): indicates blocks that signalled with a # and blocks that did not with a -

Examples

qbit-cli getdeploymentinfo

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