Confirmation Progress

Overview

Meaning and scope

Confirmation progress is the measured advancement of a transaction from initial block inclusion toward the required confirmation or finality threshold. It can be represented as current confirmations, required confirmations, finalized status, or elapsed settlement stages. The value must be tied to the canonical block and refreshed from synchronized data because reorganizations can reduce or invalidate previously reported progress.

Mechanism and operation

Confirmation Progress shows how close a transaction is to satisfying the active confirmation rule. A common display is current confirmations divided by Required Block Confirmations. The count usually increases as new canonical blocks build on the containing block. A reorganization can move the transaction to another block, reset part of the count, or remove it entirely. The system must verify the containing block hash and canonical chain status using synchronized node or provider data. The user interface should reflect the actual protocol model. Payment tracking should store progress updates as evidence while allowing duplicate events.

Practical payment example

A checkout shows a transfer as detected, then confirming, and finally accepted only when its documented completion rule is met.

Operational checks

Crossing the threshold can trigger a Payment State Transition, but asset, amount, and execution validation must already be complete. A counter such as 2 of 3 is meaningful on a block-depth policy, but a deterministic-finality protocol may not advance linearly. Interfaces can instead show observed, included, safe, and finalized stages.

Distinctions and limits

Progress should not be derived from local height alone. For deterministic-finality networks, progress can use stages such as included, safe, or finalized rather than a simple block count. Internal APIs should expose the raw evidence so different products do not interpret one generic percentage differently.

Related reading

Related definitions: Required Block Confirmations, Payment State Transition.