getconfirmationtarget

Back to blockchain

New since v30.2

Summary

Calculate the recommended number of confirmations for a transaction.

Description

Calculate the recommended number of confirmations for a transaction. Uses real-time orphan rate and hashrate to estimate how many qbit confirmations provide equivalent security to Bitcoin confirmations.

Changed behavior since v30.2

Adds the qbit confirmation-target estimator RPC.

Notes

  • This method does not exist in Bitcoin Core v30.2.

Change Buckets

  • New since v30.2

Arguments

  • value_satoshis (NUM, required): Transaction value in satoshis (included in response for reference)
  • security_level (STR): Security level: "low" (1 BTC conf), "medium" (3), "high" (6), "maximum" (60)
  • merge_mining_pct (NUM): Optional fallback/override fraction of BTC hashrate merge-mining qbit (0.0-1.0). If omitted, observed AuxPoW chainwork is used when enough samples are available.
  • btc_hashrate (NUM): Estimated Bitcoin network hashrate in H/s

Results

  • value (OBJ): No description.
  • required_confirmations (NUM): recommended number of qbit confirmations
  • required_minutes (NUM): estimated wait time in minutes
  • equivalent_btc_confirmations (NUM): equivalent Bitcoin confirmations of security
  • permissionless_hashrate (NUM): current qbit permissionless-lane hashrate (H/s; excludes AuxPoW work)
  • auxpow_hashrate (NUM): current qbit AuxPoW-lane hashrate (H/s; excludes permissionless work)
  • total_observed_hashrate (NUM): current observed qbit hashrate across permissionless and AuxPoW lanes (H/s)
  • orphan_rate (NUM): current stale/orphan block rate (from getorphanmetrics)
  • security_level (STR): the security level used
  • value_qbt (NUM): transaction value in QBT
  • model (OBJ): model parameters used in calculation
    • btc_target_confirmations (NUM): target Bitcoin confirmations for this security level
    • block_time_seconds (NUM): qbit block time from consensus parameters
    • hashrate_source (STR): hashrate model source: observed_chainwork, override_merge_mining_pct, or fallback_merge_mining_pct
    • hashrate_window_blocks (NUM): active-chain block window used for hashrate estimates
    • permissionless_blocks_in_window (NUM): permissionless blocks in the hashrate window
    • auxpow_blocks_in_window (NUM): AuxPoW blocks in the hashrate window
    • merge_mining_pct (NUM): fallback/override merge mining participation fraction used when observed chainwork is not selected
    • btc_hashrate (NUM): Bitcoin hashrate estimate used (H/s)
    • orphan_rate_penalty (NUM): confirmation multiplier due to orphan rate
    • security_per_confirmation (NUM): fraction of a BTC confirmation per qbit confirmation
    • cadence_merged_fraction (NUM): fraction of blocks that are merge-mined, derived from consensus lane spacings for the fallback percentage model

Examples

qbit-cli getconfirmationtarget 100000000 "high"

qbit-cli getconfirmationtarget 1000000000 "maximum" 0.01

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