getblocktemplate

Generates a block template for mining, intended for both PoW and PoS types of blocks based on the provided parameters.

URL: http:://127.0.0.1:11211/json_rpc

Request:

{
  "id": 0,
  "jsonrpc": "2.0",
  "method": "getblocktemplate",
  "params": {
    "explicit_transaction": "5fa8eaaf231a305053260ff91d69c6ef1ecbd0f5",
    "extra_text": "OMG, you can't just ask people why they're PoW-maxi",
    "pe": {
      "amount": 0,
      "block_timestamp": 0,
      "g_index": 0,
      "keyimage": "\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
      "stake_unlock_time": 0,
      "tx_id": "0000000000000000000000000000000000000000000000000000000000000000",
      "tx_out_index": 0
    },
    "pos_block": false,
    "stakeholder_address": "",
    "wallet_address": "ZxCSpsGGeJsS8fwvQ4HktDU3qBeauoJTR6j73jAWWZxFXdF7XTbGm4YfS2kXJmAP4Rf5BVsSQ9iZ45XANXEYsrLN2L2W77dH7"
  }
}

Request description:

    "explicit_transaction": A transaction blob that must be explicitly included in the block.
    "extra_text": Arbitrary data added to the extra field of the miner transaction.
    "pe": PoS entry details, relevant only for PoS block generation.
    "pos_block": Flag indicating whether the block is a PoS block.
    "stakeholder_address": Address where the stake is returned for PoS blocks (usually the same as 'wallet_address').
    "wallet_address": Address where mining rewards will be deposited.

Response:

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "block_reward": 1000000000000,
    "block_reward_without_fee": 1000000000000,
    "blocktemplate_blob": "030000000000000000ae73338b792......6258a2b5ee340700",
    "difficulty": "12936195379842",
    "height": 2555002,
    "miner_tx_tgc": {
      "amount_blinding_masks": "",
      "amount_blinding_masks_sum": "0000000000000000000000000000000000000000000000000000000000000000",
      "amount_commitments": "",
      "amount_commitments_sum": "00000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "amounts": "",
      "ao_amount_blinding_mask": "0000000000000000000000000000000000000000000000000000000000000000",
      "ao_amount_commitment": "00000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "ao_asset_id": "0000000000000000000000000000000000000000000000000000000000000000",
      "ao_asset_id_pt": "00000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "ao_commitment_in_outputs": "00",
      "asset_id_blinding_mask_x_amount_sum": "0000000000000000000000000000000000000000000000000000000000000000",
      "asset_id_blinding_masks": "",
      "asset_ids": "",
      "blinded_asset_ids": "",
      "pseudo_out_amount_blinding_masks_sum": "0000000000000000000000000000000000000000000000000000000000000000",
      "pseudo_out_amount_commitments_sum": "00000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "pseudo_outs_blinded_asset_ids": "",
      "pseudo_outs_plus_real_out_blinding_masks": "",
      "real_in_asset_id_blinding_mask_x_amount_sum": "0000000000000000000000000000000000000000000000000000000000000000",
      "real_zc_ins_asset_ids": "",
      "tx_key": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "tx_pub_key_p": "00000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    },
    "prev_hash": "ae73338b7927df71b6ed477937625c230172219306750ba97995fb5109dda703",
    "seed": "0518e1373ff88ccabb28493cac10cb0731313135d880dae0d846be6016ab9acf",
    "status": "OK",
    "txs_fee": 0
  }
}

Response description:

    "block_reward": Total block reward, including transaction fees if they are given to the miner (legacy), or the base reward if fees are burnt (current state).
    "block_reward_without_fee": Base block reward excluding any transaction fees.
    "blocktemplate_blob": Serialized block template blob.
    "difficulty": The mining difficulty targeted by the block template.
    "height": The height of the block template in the blockchain.
    "miner_tx_tgc": Miner transaction generation context. Intended for PoS blocks and Zarcanum.
    "prev_hash": Hash of the previous block in the chain.
    "seed": Seed value for the ProgPoWZ mining algorithm's epoch.
    "status": Status of the call.
    "txs_fee": Total fees from transactions included in the block.