Filecoin logo

Filecoin

Fast Finality in Filecoin (F3)

Key metrics for Fast Finality in Filecoin.

Fast Finality (F3) is Filecoin’s mechanism for reaching deterministic finality in minutes instead of hours. It adds a fast confirmation layer on top of the network’s existing consensus, helping users and applications track when chain state can be considered final with much greater confidence.

Instance Explorer

Drill into the voting data for a specific F3 consensus instance.

Operational Statistics

F3 Rounds per Instance

F3 Rounds per Instance

This graph shows daily distributions of how many rounds and F3 instance took to finalize. A round here corresponds to the round variable in the GossiPBFT pseudocode.

The total height of each bar shows the number of instances that were finalized during that particular day. The different colors in each bar show how many instances took how many rounds to finalize. Usually around 50% of instance finalize within the first round. However, it can sometimes take a few more rounds (usually up to six).

Distribution of F3 Rounds per Instance

F3 Finalized Tipset Distance

F3 Finalized Tipset Distance

This graph shows the distribution of the finalized tipsets distance to the consensus chain.

Each day shows a bar consisting of the minimum, median, P90 (90th percentile) and maximum distance to the consensus chain across all finalized F3 instance in that particular day.

For example, a P50 (median) value of 9 means that 50% of finalized F3 instances during that day had a tipset distance to the consensus chain of 9 epochs or less. When you hover over a bar, you'll also see the total number of instances.

Distribution of the finalized tipsets to the consensus chain.

F3 Instance Duration Distribution

F3 Instance Duration Distribution

This graph shows daily distributions of how long an F3 instance took to finalize.

Each day shows a bar consisting of the minimum, median, P90 (90th percentile) and maximum time the F3 instances took to finalize across instances in that particular day.

For example, a P50 (median) value of 2 minutes means that 50% of finalized F3 instances during that day took two minutes or less to finalize. When you hover over a bar, you'll also see the total number of instances that were finalized during that day and therefore were considered in the calculation.

Daily Distribution of F3 Instance Durations

F3 Certificate Exchange

F3 Certificate Exchange

Note that this graph shows the PeerIDs as opposed to the number of Storage Providers. Multiple storage providers can run behind a single peer identity.

This graph shows the distribution of the F3 Certificate Exchange performance across the Filecoin network. It groups peers into six different categories based on how they reacted to our requests:

  • Caught Up: The peer responded to our certificate exchange request and the latest finalized instance in the peer's point of view is at most one instance behind the network-wide finalized instance.
  • Lagging: The peer responded to our certificate exchange request but the latest finalized instance in the peer's point of view is more than one instance behind the network-wide finalized instance.
  • Exchange Error: The peer responded to our certificate exchange request but encountered an error during the exchange process.
  • No Support: The peer does not support the F3 Certificate Exchange protocol: /f3/certexch/get/1/filecoin
  • Unknown: We consider this peer as being online but the identify exchange failed and we could not determine the certificate exchange support status.

Distribution of F3 Certificate Exchange Support

Participation

F3 Power Participation

F3 Power Participation

Each F3 instance potentially consists of multiple consensus rounds. Each dot in this scatter plot represents the start of such a round as identified by the first GossipSub message that we have seen being propagated in the network for that particular round and instance. There is one exception. If consensus was reached in that round, the timestamp when >2/3 of the network has voted with a DECIDE message is used instead of the earliest timestamp of the round. This allows to see exactly when a certain instance was finalized.

The graph shows the voting power in Quality-Adjusted Power (QaP) for three different dimensions:

  1. Voting: The total power that has participated in a particular F3 instance/round
  2. Quorum: The total power that has participated in the DECIDE phase of a particular F3 instance/round
  3. Total: The total power that is available in the network (not all power participates in F3)

Quality-Adjusted Power (QaP) participating in Filecoin Fast Finality (F3)

F3 Storage Provider Participation

F3 Storage Provider Participation

Each F3 instance potentially consists of multiple consensus rounds. Each dot in this scatter plot represents the start of such a round as identified by the first GossipSub message that we have seen being propagated in the network for that particular round and instance. There is one exception. If consensus was reached in that round, the timestamp when >2/3 of the network has voted with a DECIDE message is used instead of the earliest timestamp of the round. This allows to see exactly when a certain instance was finalized.

The graph shows the number of storage providers (SPs) for three different dimensions:

  1. Voting SPs: The number of unique storage providers that have participated in a particular F3 instance/round
  2. Quorum: The number of unique storage providers that have participated in the DECIDE phase of a particular F3 instance/round
  3. Total: The number of unique storage providers that have storage power in the network (not all SPs participate in F3)

Unique Storage Providers (SPs) participating in Filecoin Fast Finality

GossipSub (/f3/granite/0.0.3/filecoin)

GossipSub metrics for the /f3/granite/0.0.3/filecoin topic.

Duplicates Per Topic CDF

Duplicates Per Topic CDF

This graph shows the cumulative distribution function of the number of duplicate messages per topic during the given day. When you hove over the graph, the number of samples represent the number of unique messages, identified by their message IDs, that were received during that day. The point on the x-axis show show often we have received the same message and the y-axis shows where this message falls in the overall distribution of received duplicates.

Loading ...

Time to First Duplicate

CDF of how long it took for the first duplicate to arrive.

Duplicate Message Sizes Per Topic CDF

Loading ...

Msg Size / Count Correlation

Loading ...

Bandwidth Usage Distribution

Loading...

Measurement Tools

Our network monitoring employs advanced crawling and probing tools and techniques to gather comprehensive data about network health, topology, and performance

Our Tools

From rawpixel.com / Freepik

Akai

A libp2p generic DA sampler for the Web3 space
tool-abstract-8

DAS Guardian

A Data Availability Sampling tool to asses Ethereum Node's real custody
tool-abstract-7

Bitswap Sniffer

A CID sniffer for content in IPFS over Bitswap and DHT requests
Freepik

Tiros

A performance measurement tool for Kubo and IPFS-hosted websites.
AI Freepik

Parsec

A DHT and IPNI lookup performance measurement tool.
GarryKillian / Freepik

Ants

A DHT monitoring tool for NAT'd peers.
From GarryKillian / Freepik

Hermes

A lightweight GossipSub tracer.
Abstract Image 6

Nebula

A network agnostic DHT crawler and monitoring tool