Skip to content

LibraryConsensus2019Design paperCorpus record

Harmony Technical Whitepaper

Harmony. Stephen Tse and the Harmony team.

A sharded proof-of-stake design that combines a BFT-style consensus inside shards with a randomness scheme for assigning validators, aimed at keeping a single shard from being captured.

Harmony combines staking, random sharding, and a fast Byzantine protocol inside each shard, and it tries to finish cross-shard messages in the same epoch rather than leaving them as an IOU.
Evidence
Primary paper
Re-measured
No
Assumptions
4
Records linked
8

Code

Source, repository, and what is actually hosted

  • harmony.one white paperhttps://harmony.one/whitepaper.pdf
  • The source URL is not a GitHub repository. No code remote is invented.
  • Full text is not mirrored. Public availability is not a licence to copy the file onto this site.
  • Add to a reading list

01 Claim ledger

What the paper is allowed to say

Each row is a sentence already in the study. The status is the same on every row: a model claim, not a live measurement.

  1. Claim 01 · Paper model

    It is explicit about standing on earlier papers

    The text borrows Omniledger's sharding shape, RapidChain's ideas, and a responsive Byzantine protocol for the inside of a shard. The useful reading is what it claims to improve: randomness, cross-shard latency, and a proof-of-stake membership.

  2. Claim 02 · Paper model

    Randomness is a protocol object

    A distributed randomness generation scheme assigns validators to shards. The paper treats a biasable assignment as a security failure, which is the correct instinct.

  3. Claim 03 · Paper model

    FBFT is pipelined voting

    Inside a shard, a leader proposes and validators sign. Signature aggregation is how the paper keeps a large shard's votes small on the wire.

  4. Claim 04 · Paper model

    Cross-shard receipts are supposed to be synchronous

    The paper does not want a message to another shard to wait for an unbounded lock. It specifies a path that aims to settle across shards within an epoch.

  5. Claim 05 · Paper model

    Resharding is when the design is most fragile

    Moving validators between shards, and moving the state they must know, is the expensive part. An epoch that is safe only between reshardings has hidden the hard problem.

02 Three cuts

Observation, model, falsifier

A desk does not stop at the summary. Each claim is cut three ways, using only this study's own assumptions and checks. Nothing here is a new figure.

  1. 01 It is explicit about standing on earlier papers

    Observation

    What the study says

    The text borrows Omniledger's sharding shape, RapidChain's ideas, and a responsive Byzantine protocol for the inside of a shard. The useful reading is what it claims to improve: randomness, cross-shard latency, and a proof-of-stake membership.

    Model

    What has to hold

    Each shard has enough stake that the Byzantine threshold inside it still holds after the random cut.

    Falsifier

    What would retire it

    Does a cross-shard transfer settle in the epoch the paper promises, or in a queue?

  2. 02 Randomness is a protocol object

    Observation

    What the study says

    A distributed randomness generation scheme assigns validators to shards. The paper treats a biasable assignment as a security failure, which is the correct instinct.

    Model

    What has to hold

    Distributed randomness is unbiased and available at the epoch boundary.

    Falsifier

    What would retire it

    Does a cross-shard transfer settle in the epoch the paper promises, or in a queue?

  3. 03 FBFT is pipelined voting

    Observation

    What the study says

    Inside a shard, a leader proposes and validators sign. Signature aggregation is how the paper keeps a large shard's votes small on the wire.

    Model

    What has to hold

    Each shard has enough stake that the Byzantine threshold inside it still holds after the random cut.

    Falsifier

    What would retire it

    Does a cross-shard transfer settle in the epoch the paper promises, or in a queue?

  4. 04 Cross-shard receipts are supposed to be synchronous

    Observation

    What the study says

    The paper does not want a message to another shard to wait for an unbounded lock. It specifies a path that aims to settle across shards within an epoch.

    Model

    What has to hold

    Receipts between shards are data-available. A header that points at a missing receipt is not a settlement.

    Falsifier

    What would retire it

    Does a cross-shard transfer settle in the epoch the paper promises, or in a queue?

  5. 05 Resharding is when the design is most fragile

    Observation

    What the study says

    Moving validators between shards, and moving the state they must know, is the expensive part. An epoch that is safe only between reshardings has hidden the hard problem.

    Model

    What has to hold

    Receipts between shards are data-available. A header that points at a missing receipt is not a settlement.

    Falsifier

    What would retire it

    Does a cross-shard transfer settle in the epoch the paper promises, or in a queue?

03 Sequence

One action, as an operating tape

  1. 01Staked validators take part in a distributed randomness generation round.
  2. 02The output assigns them to shards for the epoch. A validator cannot cheaply reject the draw and redraw.
  3. 03A shard leader proposes a block. Validators sign, and the signatures are aggregated.
  4. 04A transaction that touches another shard emits a receipt that the destination shard is required to pick up under the paper's same-epoch rule.
  5. 05At the epoch boundary, the beacon layer commits the shard headers and the next assignment begins.

04 Load-bearing

The argument, and where a pitch drops it

  1. Same-epoch cross-shard is the sentence to test

    The cut

    Many sharding papers are precise inside a shard and vague across shards. Harmony's text makes a stronger promise. An implementation that queues cross-shard receipts for later has kept the shard and dropped the sentence that made the paper different.

    Why it carries weight

    If this cut is skipped, the paper's name is being used without the mechanism that makes the name mean anything.

    Where it is dropped

    Do not treat the white paper's target throughput as a measured result.

  2. Aggregated signatures hide a liveness dependency

    The cut

    A tiny aggregate is only useful if the leader can collect the parts. A leader who censors a validator's signature fragment, or a network that loses them, stalls the fast path. The paper's latency math assumes collection works.

    Why it carries weight

    If this cut is skipped, the paper's name is being used without the mechanism that makes the name mean anything.

    Where it is dropped

    Do not treat the white paper's target throughput as a measured result.

  3. Stake plus randomness is two assumptions

    The cut

    Stake says who may speak. Randomness says where they sit. Compromise either one and a shard can be captured with far less than a third of the whole stake. Report both, or the security claim is incomplete.

    Why it carries weight

    If this cut is skipped, the paper's name is being used without the mechanism that makes the name mean anything.

    Where it is dropped

    Randomness that is biasable recreates the shard-capture problem the design set out to avoid.

05 Register

What has to be true

  • Cryptography · Not re-measured

    Distributed randomness is unbiased and available at the epoch boundary.

  • Stake and threshold · Not re-measured

    Each shard has enough stake that the Byzantine threshold inside it still holds after the random cut.

  • Data · Not re-measured

    Receipts between shards are data-available. A header that points at a missing receipt is not a settlement.

  • Model · Not re-measured

    Leaders can be replaced when they withhold an aggregate.

06 Divergence

What happened after the paper

Harmony's network launched from this design and later suffered a bridge-key compromise that had little to do with the sharding proof and everything to do with operational custody. That incident is a reminder about what the paper does not cover. It is not a review of FBFT.

A later client, parameter set, or reward formula is a different object. Cite this paper for the mechanism. Cite a primary release for the network. This desk has not re-run the proof.

07 Pre-mortem

What to check before you use the idea

  1. 0 of 4 marked on this browser. A mark is a reading note, not a pass, a rating, or a recommendation.

08 Anatomy

The paper, in the order a builder needs

The problem it names

If an adversary can predict which validators land in a shard, they can concentrate stake there. Harmony's paper is about the assignment problem as much as about the fast path inside a shard.

What the design proposes

  • Validators stake and are randomly assigned. Resharding is part of the security argument.
  • Consensus inside a shard is a BFT protocol on a small committee, not a global race.
  • A beacon or randomness source is load-bearing. The paper has to say where the randomness comes from.

How the mechanism is specified

  • Cross-shard messages are receipts, not free function calls. That constraint is the design.
  • Effective proof-of-stake in the paper is a response to one-address dominance, not a general fairness theorem.
  • Later network parameters are not frozen by the PDF.

What this page does not treat as proven

  • Do not treat the white paper's target throughput as a measured result.
  • Randomness that is biasable recreates the shard-capture problem the design set out to avoid.
  • This page does not review Harmony's subsequent treasury or bridge incidents. Those are separate facts.

Why the desk still reads it

For a studio, the transferable question is: is shard membership unpredictable to the attacker who is about to join? If the answer is no, the rest of the diagram does not matter.

09 Lexicon

Terms, opened into the record

Beacon layer
The coordinating chain that commits shard headers, randomness, and membership.
FBFT
The paper's fast Byzantine agreement inside a shard, using aggregated signatures.
Resharding
Reassigning validators, and the state they serve, at an epoch boundary.
Receipt
The proof a destination shard needs before it acts on a message from another shard.

10 Repository

Every linked record on this page

Underlined words open a page that already exists: a concept, a protocol profile, a failure record, or another paper. If a word is not underlined, this desk does not have a record for it.

This is Blockchain Lab's reading of a public design paper. It is not the paper, not a copy of it, and not an offer of tokens, equity, custody or a partnership. Later network behaviour can diverge from the text. Nothing here is investment, legal or technical advice.

Research status: Design paper. Last reviewed: 1 October 2026. This is a reading of a public paper, not investment, legal or security advice.