# Kilt Chain Average Relay Chain inclusion time Methodology

## 1. Overview

Average Relay Chain inclusion time measures the average duration between the production of a block on Kilt Chain and its subsequent inclusion in a Polkadot Relay Chain block. This metric is used to evaluate the consensus latency and the efficiency of the finality process for Kilt Chain within the Polkadot ecosystem. It provides insight into the performance of the multichain architecture and the time required for parachain data to be secured by the Relay Chain.

## 2. Data sources

- **Blockchain events**: `CandidateIncluded` events from the `paraInclusion` pallet on Polkadot, and block data from Kilt Chain

## 3. Step-by-step calculation

### Component A: Relay Chain event parsing

- **Purpose**: Identify when Kilt Chain block headers are included in the Polkadot Relay Chain
- **Logic**: `CandidateIncluded` events are parsed from the `paraInclusion` pallet on Polkadot. The `paraHead` (representing the parachain block hash) and `paraId` are extracted from the event data descriptors. These events are filtered to specifically isolate those associated with the Kilt Chain identifier.
- **Key fields**: `paraHead`, `paraId`, and `relay_chain_timestamp`

### Component B: Parachain block matching

- **Purpose**: Correlate Relay Chain inclusion events with the original block production time on Kilt Chain
- **Logic**: The `paraHead` extracted from Polkadot events is matched against the block hashes from Kilt Chain block data. This connection enables the alignment of the original Kilt Chain block timestamp with the timestamp of the Relay Chain block where the inclusion was recorded.
- **Key fields**: `block_hash` and `parachain_timestamp`

### Component C: Inclusion time calculation and averaging

- **Purpose**: Quantify the latency and aggregate the results into a daily average
- **Logic**: The inclusion time is calculated for each correlated block as the difference in milliseconds between the Relay Chain block timestamp and the original Kilt Chain block timestamp. These individual durations are then aggregated by day. The final daily metric is calculated as the average of all inclusion times recorded within each UTC day boundary for Kilt Chain.
- **Key fields**: `relay_chain_timestamp`, `parachain_timestamp`, and `avg_relaychain_inclusion_time`

*This methodology was automatically generated by Token Terminal's methodology analyzer.*

avg(relay_inclusion_timestamp - parachain_block_timestamp)

Average time between parachain block production and Relay Chain inclusion.

Average Relay Chain inclusion time

Blockchains (L1)

Collators aggregate parachain transactions block candidates and producing state transition proofs for validators based on those blocks.

Kilt Chain

Archived

Average Relay Chain inclusion time

Average Relay Chain inclusion time

Chain breakdown