verifydatapqchash

Back to util

New since v30.2

Summary

Verify a P2MR/PQC data-hash signature proof.

Description

Verify a P2MR/PQC data-hash signature proof.

Change Buckets

  • New since v30.2

Arguments

  • p2mr_proof (OBJ, required): The proof returned by signdatapqchash.
  • address (STR, required): The P2MR address.
  • message_hash (STR_HEX, required): The 32-byte hash that was signed.
  • signature (STR_HEX, required): The raw PQC signature.
  • pubkey (STR_HEX, required): The 32-byte P2MR pubkey.
  • leaf_script (STR_HEX, required): The committed P2MR pubkey leaf script.
  • control_block (STR_HEX, required): The P2MR control block proving the leaf.
  • leaf_version (NUM, required): The P2MR leaf version.
  • proof_mode (STR, required): Must be "p2mr-pubkey".

Results

  • value (OBJ): No description.
  • valid (BOOL): Whether the proof verifies.
  • error (STR, optional): Failure reason when valid is false.
  • address (STR, optional): The P2MR address.
  • message_hash (STR_HEX, optional): The caller-supplied 32-byte hash.
  • datasig_hash (STR_HEX, optional): The qbit data-signature hash that was verified.
  • pubkey (STR_HEX, optional): The committed 32-byte P2MR pubkey.
  • proof_mode (STR, optional): The proof mode.
  • p2mr_merkle_root (STR_HEX, optional): The P2MR Merkle root committed by the address.

Examples

qbit-cli verifydatapqchash '{"address":"qb1...","message_hash":"00...","signature":"...","pubkey":"...","leaf_script":"...","control_block":"c1","leaf_version":192,"proof_mode":"p2mr-pubkey"}'