Kaspa One Stop

In brief

Kaspa keeps nearby valid blocks in a blockDAG and uses consensus rules to reason about ordering and accepted effects.

What this page explains#

Build the bridge from public Kaspa descriptions into GHOSTDAG, virtual state, and source-level consensus review. This page sits in Consensus, GHOSTDAG, And blockDAG. It gives the topic a plain-language handle first, then shows the working idea, the mechanism, the source trail, and any limits that still matter. This category explains how Kaspa reasons about many blocks without pretending the graph itself is enough. The flow moves from graph shape, to GHOSTDAG classification and ordering, to virtual state and accepted transaction evidence.

The writing follows a simple Kaspa documentation pattern: answer the practical question first, then link outward for details. The closest public sources for this page are WIKI-KASPA, WIKI-BLUE-SCORE, WIKI-MERGING-REWARDS, WIKI-THEORETICAL-TOPICS, RK-GHOSTDAG. Local notes can help choose what to explain, but public-facing references resolve to upstream websites, repositories, papers, release pages, or docs.

How to think about it#

The practical model starts by naming the layer that owns the topic: wallet use, node operation, consensus, transaction validation, Toccata script behavior, tooling, or research. From there, the page shows which public source can support the explanation and where the explanation becomes incomplete.

For Consensus, GHOSTDAG, And blockDAG, the model is built around these anchors: Kaspa blocks can reference multiple direct parents, forming a blockDAG; GHOSTDAG selected-parent, ordering, and mergeset behavior must be separated from the graph shape itself; Blue score, blue work, and header checks are current implementation claims when source-backed; PHANTOM, GHOSTDAG papers, and DAGKnight material remain research context unless implementation and release evidence support stronger wording; Virtual processing and accepted data are the bridge from ordered DAG consequences to transaction-state evidence. This model is useful, but it does not encode every constant, branch, error type, or edge case. Those details belong in the source path and the source notes.

How it works#

1. Kaspa blocks can reference multiple direct parents, forming a blockDAG. Consensus pages separate graph structure, ordering, work signals, and state consequences. A claim in this section is useful only when it says whether the source is describing the DAG shape, GHOSTDAG classification, selected-parent context, virtual-state processing, or research background.

2. GHOSTDAG selected-parent, ordering, and mergeset behavior must be separated from the graph shape itself. A mergeset is the part of the DAG brought into view by a block beyond the selected-parent path. It matters because Kaspa is not merely following a single chain tip; it is deciding how parallel work is incorporated. When explaining mergesets, keep the graph relationship, ordering consequence, and transaction consequence separate so app pages do not treat every visible block as immediate accepted state.

3. Blue score, blue work, and header checks are current implementation claims when source-backed. Blue/red vocabulary belongs to consensus classification, not user reputation or transaction success. Blue score and blue work are progress signals inside the consensus view. They are useful for understanding chain progress and ordering context, but wallet, indexer, and app pages still need accepted-transaction or UTXO evidence before claiming a spend has taken effect.

4. PHANTOM, GHOSTDAG papers, and DAGKnight material remain research context unless implementation and release evidence support stronger wording. Readiness pages are evidence gates. A testnet result is useful only with network name, date, release or branch, node/wallet/tool versions, and accepted evidence. Release notes and source paths support stronger claims; old testnet observations remain historical unless refreshed.

5. Virtual processing and accepted data are the bridge from ordered DAG consequences to transaction-state evidence. Virtual state is the bridge from ordered consensus consequences into the state surfaces that tools can inspect. Mempool visibility says a node is considering a transaction; accepted evidence says the transaction was incorporated through consensus processing. UTXO diffs, accepting data, and indexer replay are the review trail for applications that need durable state.

This mechanism section separates graph structure, GHOSTDAG classification, selected-parent context, ordering consequences, and virtual-state effects. A diagram or summary can orient the reader, but implementation paths and KIPs carry high-risk claims.

How to check it#

StepCheckEvidence gate
1Check Kaspa blocks can reference multiple direct parents, forming a blockDAG.Read WIKI-KASPA, WIKI-BLUE-SCORE, WIKI-MERGING-REWARDS; distinguish graph shape, ordering, selected-parent context, and accepted-state consequences.
2Check GHOSTDAG selected-parent, ordering, and mergeset behavior must be separated from the graph shape itself.Read WIKI-KASPA, WIKI-BLUE-SCORE, WIKI-MERGING-REWARDS; distinguish graph shape, ordering, selected-parent context, and accepted-state consequences.
3Check Blue score, blue work, and header checks are current implementation claims when source-backed.Read WIKI-KASPA, WIKI-BLUE-SCORE, WIKI-MERGING-REWARDS; distinguish graph shape, ordering, selected-parent context, and accepted-state consequences.
4Check PHANTOM, GHOSTDAG papers, and DAGKnight material remain research context unless implementation and release evidence support stronger wording.Read WIKI-KASPA, WIKI-BLUE-SCORE, WIKI-MERGING-REWARDS; distinguish graph shape, ordering, selected-parent context, and accepted-state consequences.
5Check Virtual processing and accepted data are the bridge from ordered DAG consequences to transaction-state evidence.Read WIKI-KASPA, WIKI-BLUE-SCORE, WIKI-MERGING-REWARDS; distinguish graph shape, ordering, selected-parent context, and accepted-state consequences.

When using this page for consensus explanation, identify whether the claim is about graph shape, GHOSTDAG classification, selected-parent context, virtual-state processing, or transaction consequences. Diagrams are orientation aids; source paths and KIPs carry the high-risk behavior claims.

Expanded Category Guide#

This category carries the consensus learning ramp: proof of work, blockDAG structure, GHOSTDAG reasoning, selected parent, mergesets, blue score/work, virtual state, and research-edge boundaries.

Use this category as a curated path. Start with the category README to understand the boundary, then read the mechanism pages, then follow source-path or open-gap pages for claims that need stronger evidence. If a page contains needs checking rows, keep those claims visibly unresolved until a reader reads the cited public source directly.

The category should not be treated as final authority by folder name alone. The authority comes from page Source Notes, Source Lists, public URLs, and the status labels attached to each claim.

  • consensus-blockdag-ghostdag
  • blockdag-model

Topic pages#

  • blockDAG Model: A blockDAG starts from the simple fact that valid blocks can be found close together, but it does not remove the need for a consistent ordering rule.
  • PHANTOM And GHOSTDAG: PHANTOM and GHOSTDAG belong in the research-to-implementation bridge: the paper motivates the model, and Rusty Kaspa closes current behavior.
  • GHOSTDAG Mechanics: This page explains selected parent, mergesets, blue/red classification, blue score, and blue work as connected mechanics.
  • Selected Parent And Mergesets: Selected parent and mergesets are the first place where DAG intuition becomes source-level mechanics.
  • Blue Score And Blue Work: Blue score and blue work are progress indicators in the consensus view and need careful explanation before apps use them.
  • Virtual State And Accepted Transactions: Virtual state is where ordered consensus consequences become transaction and UTXO evidence for tools and applications.
  • DAGKnight Research Edge: DAGKnight belongs in research edge unless current implementation and release evidence supports stronger status.
  • Consensus FAQ And Failure Modes: This question-led page corrects common misreadings: DAG does not mean no ordering, selected parent is not the whole state story, and mempool visibility is not accepted evidence.

Topic notes#

This category is accepted when the subpages explain the actual topics, not merely the source links. Each subpage carries public source IDs, claim labels, Open Questions, and a path from first contact into source review.

Source-linkedReviewed 2026-07-09 · 18 public sourcesEvidence and sources
Evidence and sources18 public sources · reviewed 2026-07-09
DAGKnight PaperResearch paper
eprint.iacr.org/2022/1494
Technical details

Reference key: PAPER-DAGKNIGHT

Recheck this public source before relying on exact current details.

PHANTOM/GHOSTDAG PaperResearch paper
eprint.iacr.org/2018/104
Technical details

Reference key: PAPER-GHOSTDAG

Recheck this public source before relying on exact current details.

Rusty Kaspa Acceptance DataRusty Kaspa source
github.com/kaspanet/rusty-kaspa/blob/78257f273a26c4be085bab0f79437dee99ca8835/consensus/src/pipeline/virtual_processor/processor.rsgithub.com/kaspanet/rusty-kaspa/blob/78257f273a26c4be085bab0f79437dee99ca8835/consensus/core/src/acceptance_data.rsgithub.com/kaspanet/rusty-kaspa/blob/78257f273a26c4be085bab0f79437dee99ca8835/consensus/src/model/stores/acceptance_data.rs
Technical details

Reference key: RK-ACCEPTANCE-DATA

Recheck this public source before relying on exact current details.

Blue ScoreKaspa documentation
wiki.kaspa.org/blue-score
Technical details

Reference key: WIKI-BLUE-SCORE

Recheck this public source before relying on exact current details.

KaspaKaspa documentation
wiki.kaspa.org/en/kaspa
Technical details

Reference key: WIKI-KASPA

Recheck this public source before relying on exact current details.

Merging And RewardsKaspa documentation
wiki.kaspa.org/merging-and-rewards
Technical details

Reference key: WIKI-MERGING-REWARDS

Recheck this public source before relying on exact current details.

Theoretical TopicsKaspa documentation
wiki.kaspa.org/en/theoretical-topics
Technical details

Reference key: WIKI-THEORETICAL-TOPICS

Recheck this public source before relying on exact current details.