signdatapqchash

Back to wallet

New since v30.2 Wallet

Summary

Sign a 32-byte data hash with a PQC key committed by a wallet-owned P2MR address.

Description

Sign a 32-byte data hash with a PQC key committed by a wallet-owned P2MR address. Requires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.

Change Buckets

  • New since v30.2

Arguments

  • address (STR, required): The wallet-owned P2MR address whose committed pubkey should sign.
  • message_hash (STR_HEX, required): The 32-byte hash to sign, as hex.
  • options (OBJ): Options.
  • proof_mode (STR): Only "p2mr-pubkey" is supported.
  • pubkey (STR_HEX): Optional 32-byte P2MR pubkey to select when the address commits to more than one single-key leaf.
  • leaf_script (STR_HEX): Optional exact P2MR leaf script to sign against.
  • control_block (STR_HEX): Optional exact P2MR control block to prove with.
  • include_pqc_usage (BOOL): Include wallet-local PQC key-usage counters and warnings in the result. These fields may reveal exact remaining signature budget and public keys from failed retry attempts; enable only for local diagnostics.

Results

  • value (OBJ): No description.
  • address (STR): The P2MR address used for the proof.
  • message_hash (STR_HEX): The caller-supplied 32-byte hash.
  • datasig_hash (STR_HEX): The qbit data-signature hash actually signed.
  • domain (STR): The data-signature domain.
  • algorithm (STR): The PQC signature algorithm.
  • proof_mode (STR): The proof mode.
  • pubkey (STR_HEX): The committed 32-byte P2MR pubkey.
  • signature (STR_HEX): The raw PQC signature.
  • leaf_version (NUM): The P2MR leaf version.
  • leaf_script (STR_HEX): The committed P2MR leaf script.
  • control_block (STR_HEX): The P2MR control block proving the leaf.
  • p2mr_merkle_root (STR_HEX): The P2MR Merkle root committed by the address.
  • pqc_key_states (ARR, optional): PQC usage state for local wallet keys that participated in this response.
    • value (OBJ): No description.
    • pubkey (STR_HEX): The hex-encoded PQC public key.
    • pqc_signature_count (NUM): The number of signatures used by this PQC key.
    • pqc_signature_limit (NUM): The hard signature limit for this PQC key.
    • pqc_signatures_remaining (NUM): The remaining signature budget for this PQC key.
    • pqc_limit_state (STR): The PQC usage state. One of normal, warning, critical, or exhausted.
  • pqc_overall_limit_state (STR, optional): The maximum PQC usage severity across pqc_key_states.
  • pqc_signature_count (NUM, optional): The number of signatures used by the single local PQC key associated with this response.
  • pqc_signature_limit (NUM, optional): The hard signature limit for the single local PQC key associated with this response.
  • pqc_signatures_remaining (NUM, optional): The remaining signature budget for the single local PQC key associated with this response.
  • pqc_limit_state (STR, optional): The PQC usage state for the single local PQC key associated with this response.
  • warnings (ARR, optional): Human-readable warning lines emitted when PQC threshold transitions or reminder buckets fire.
    • warning (STR): No description.

Examples

qbit-cli signdatapqchash "qb1..." "0001020304050607080900010203040506070809000102030405060708090001"