createauxblock

Back to mining

New since v30.2

Summary

Create a merged-mining candidate block paying the coinbase reward to the given P2MR address.

Description

Create a merged-mining candidate block paying the coinbase reward to the given P2MR address. The candidate remains cached for submitauxblock while its previous block stays on the active tip, its age does not exceed -auxpowtemplateexpiry, and it has not been evicted by -auxpowtemplatecachelimit.

Change Buckets

  • New since v30.2

Arguments

  • payout_address (STR, required): The P2MR qbit address to receive the block reward.

Results

  • value (OBJ): No description.
  • hash (STR_HEX): The candidate aux block hash.
  • chainid (NUM): The configured AuxPoW chain ID.
  • previousblockhash (STR_HEX): The previous block hash used by the candidate.
  • coinbasevalue (NUM): The total coinbase value in satoshis, including fees.
  • bits (STR_HEX): The compact target for the candidate block.
  • height (NUM): The candidate block height.
  • p2mr_validation_weight (OBJ): P2MR validation-weight rule for this candidate
    • per_sigop (NUM): P2MR validation debit per non-empty PQC signature operation
    • v2_active (BOOL): Whether validation-weight-v2 applies to this candidate
    • v2_activation_height (NUM): First block using validation-weight-v2
  • future_block_time (OBJ): Future-time rule for this candidate
    • limit_seconds (NUM): Maximum seconds this candidate timestamp may exceed node time
    • v2_active (BOOL): Whether the qbit v2 future-time limit applies to this candidate
    • v2_activation_height (NUM): First block using the qbit v2 future-time limit
  • commitmentorder (STR): The AuxPoW commitment byte order required for this candidate: "internal" or "display".
  • commitmentactivationheight (NUM): The height at which display byte order becomes active.
  • target (STR_HEX): The expanded target for the candidate block.

Examples

qbit-cli createauxblock "qcrt1qexampleaddresshere"

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