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.
  • 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/