From 771d50f39e8d7e78590dbb7442629873fcb5a8e4 Mon Sep 17 00:00:00 2001 From: Dinesh Pinto Date: Mon, 23 Feb 2026 17:40:05 +0400 Subject: [PATCH 1/3] feat(fsp): add sub-protocol parameters --- docs/network/fsp/5-protocol-parameters.mdx | 33 ++++++++++++++++++++++ sidebars.ts | 1 + 2 files changed, 34 insertions(+) create mode 100644 docs/network/fsp/5-protocol-parameters.mdx diff --git a/docs/network/fsp/5-protocol-parameters.mdx b/docs/network/fsp/5-protocol-parameters.mdx new file mode 100644 index 00000000..d555e656 --- /dev/null +++ b/docs/network/fsp/5-protocol-parameters.mdx @@ -0,0 +1,33 @@ +--- +title: Protocol Parameters +description: Parameters of the sub-protocols comprising the FSP. +keywords: [flare-network, ftso, fdc, configuration, system, client] +--- + +Each FSP sub-protocol (e.g. FTSOv2, FDC) has several associated parameters, which are detailed here, alongside the contract method (if applicable) to query them onchain. +The values provided here correspond to Flare Mainnet. + +## FTSOv2 + +### Block-Latency Feeds (Fast Updates) + +| Metric | Value | Associated functions | +| --------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- | +| **Update size** | ≈200k (1.33%) | - | +| **Mean updates per block** | 1.5 | [`FastUpdatesIncentiveManager.getExpectedSampleSize`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getexpectedsamplesize) | +| **Precision (step size)** | ≈0.0122% | [`FastUpdatesIncentiveManager.getPrecision`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getprecision) | +| **Range** | 0.0183% | [`FastUpdatesIncentiveManager.getRange`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getrange) | +| **Max range (max increment per block)** | 0.091% (5x) | [`FastUpdatesIncentiveManager.rangeIncreaseLimit`](/ftso/solidity-reference/IFastUpdateIncentiveManager#rangeincreaselimit) | +| **Max increment per second** | 0.054% | - | +| **Incentive duration** | 17 blocks (≈29 seconds) | [`FastUpdatesIncentiveManager.getIncentiveDuration`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getincentiveduration) | +| **Incentive fee (2x)** | ≈36.6 FLR | - | + +### Anchor Feeds (Scaling) + +| Metric | Value | Associated functions | +| ------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| **Update size** | ≈200k (1.33%) | - | +| **Update duration** | 90s | - | +| **FTSO protocol ID** | 100 | [`FtsoFeedPublisher.ftsoProtocolId`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#ftsoprotocolid) | +| **Feeds history size** | 1000 | [`FtsoFeedPublisher.feedsHistorySize`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#feedshistorysize) | +| **Minimal reward offer** | 100000 FLR | [`FtsoRewardOffersManager.minimalRewardsOfferValueWei`](/ftso/scaling/solidity-reference/IFtsoRewardOffersManager#minimalrewardsoffervaluewei) | diff --git a/sidebars.ts b/sidebars.ts index d6ad2a48..0e6a8df4 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -49,6 +49,7 @@ const sidebars: SidebarsConfig = { "network/fsp/rewarding", "network/fsp/system-protocols", "network/fsp/offchain-services", + "network/fsp/protocol-parameters", { type: "category", label: "FSP Guides", From 642b32f7558c070f7f630e7f7b978f60422a4787 Mon Sep 17 00:00:00 2001 From: Kristaps Grinbergs Date: Mon, 9 Mar 2026 11:19:30 +0200 Subject: [PATCH 2/3] refactor(fsp): update protocol parameters table for clarity and accuracy --- docs/network/fsp/5-protocol-parameters.mdx | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/docs/network/fsp/5-protocol-parameters.mdx b/docs/network/fsp/5-protocol-parameters.mdx index d555e656..5840b02c 100644 --- a/docs/network/fsp/5-protocol-parameters.mdx +++ b/docs/network/fsp/5-protocol-parameters.mdx @@ -13,20 +13,17 @@ The values provided here correspond to Flare Mainnet. | Metric | Value | Associated functions | | --------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -| **Update size** | ≈200k (1.33%) | - | | **Mean updates per block** | 1.5 | [`FastUpdatesIncentiveManager.getExpectedSampleSize`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getexpectedsamplesize) | | **Precision (step size)** | ≈0.0122% | [`FastUpdatesIncentiveManager.getPrecision`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getprecision) | -| **Range** | 0.0183% | [`FastUpdatesIncentiveManager.getRange`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getrange) | -| **Max range (max increment per block)** | 0.091% (5x) | [`FastUpdatesIncentiveManager.rangeIncreaseLimit`](/ftso/solidity-reference/IFastUpdateIncentiveManager#rangeincreaselimit) | -| **Max increment per second** | 0.054% | - | -| **Incentive duration** | 17 blocks (≈29 seconds) | [`FastUpdatesIncentiveManager.getIncentiveDuration`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getincentiveduration) | +| **Range (precision * mean updates)** | 0.0183% | [`FastUpdatesIncentiveManager.getRange`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getrange) | +| **Max range** | 0.091% (5x) | [`FastUpdatesIncentiveManager.rangeIncreaseLimit`](/ftso/solidity-reference/IFastUpdateIncentiveManager#rangeincreaselimit) | +| **Incentive duration** | 17 blocks | [`FastUpdatesIncentiveManager.getIncentiveDuration`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getincentiveduration) | | **Incentive fee (2x)** | ≈36.6 FLR | - | ### Anchor Feeds (Scaling) | Metric | Value | Associated functions | | ------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -| **Update size** | ≈200k (1.33%) | - | | **Update duration** | 90s | - | | **FTSO protocol ID** | 100 | [`FtsoFeedPublisher.ftsoProtocolId`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#ftsoprotocolid) | | **Feeds history size** | 1000 | [`FtsoFeedPublisher.feedsHistorySize`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#feedshistorysize) | From 0db4d72c19feb794856b15340f60a3d10ade868f Mon Sep 17 00:00:00 2001 From: Kristaps Grinbergs Date: Mon, 9 Mar 2026 11:26:54 +0200 Subject: [PATCH 3/3] refactor(fsp): update protocol parameters table for clarity and accuracy --- docs/network/fsp/5-protocol-parameters.mdx | 28 +++++++++++----------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/network/fsp/5-protocol-parameters.mdx b/docs/network/fsp/5-protocol-parameters.mdx index 5840b02c..b14a2ff6 100644 --- a/docs/network/fsp/5-protocol-parameters.mdx +++ b/docs/network/fsp/5-protocol-parameters.mdx @@ -11,20 +11,20 @@ The values provided here correspond to Flare Mainnet. ### Block-Latency Feeds (Fast Updates) -| Metric | Value | Associated functions | -| --------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -| **Mean updates per block** | 1.5 | [`FastUpdatesIncentiveManager.getExpectedSampleSize`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getexpectedsamplesize) | -| **Precision (step size)** | ≈0.0122% | [`FastUpdatesIncentiveManager.getPrecision`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getprecision) | -| **Range (precision * mean updates)** | 0.0183% | [`FastUpdatesIncentiveManager.getRange`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getrange) | -| **Max range** | 0.091% (5x) | [`FastUpdatesIncentiveManager.rangeIncreaseLimit`](/ftso/solidity-reference/IFastUpdateIncentiveManager#rangeincreaselimit) | -| **Incentive duration** | 17 blocks | [`FastUpdatesIncentiveManager.getIncentiveDuration`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getincentiveduration) | -| **Incentive fee (2x)** | ≈36.6 FLR | - | +| Metric | Value | Associated functions | +| ------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- | +| **Mean updates per block** | 1.5 | [`FastUpdatesIncentiveManager.getExpectedSampleSize`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getexpectedsamplesize) | +| **Precision (step size)** | ≈0.0122% | [`FastUpdatesIncentiveManager.getPrecision`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getprecision) | +| **Range (precision \* mean updates)** | 0.0183% | [`FastUpdatesIncentiveManager.getRange`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getrange) | +| **Max range** | 0.091% (5x) | [`FastUpdatesIncentiveManager.rangeIncreaseLimit`](/ftso/solidity-reference/IFastUpdateIncentiveManager#rangeincreaselimit) | +| **Incentive duration** | 17 blocks | [`FastUpdatesIncentiveManager.getIncentiveDuration`](/ftso/solidity-reference/IFastUpdateIncentiveManager#getincentiveduration) | +| **Incentive fee (2x)** | ≈36.6 FLR | - | ### Anchor Feeds (Scaling) -| Metric | Value | Associated functions | -| ------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -| **Update duration** | 90s | - | -| **FTSO protocol ID** | 100 | [`FtsoFeedPublisher.ftsoProtocolId`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#ftsoprotocolid) | -| **Feeds history size** | 1000 | [`FtsoFeedPublisher.feedsHistorySize`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#feedshistorysize) | -| **Minimal reward offer** | 100000 FLR | [`FtsoRewardOffersManager.minimalRewardsOfferValueWei`](/ftso/scaling/solidity-reference/IFtsoRewardOffersManager#minimalrewardsoffervaluewei) | +| Metric | Value | Associated functions | +| ------------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| **Update duration** | 90s | - | +| **FTSO protocol ID** | 100 | [`FtsoFeedPublisher.ftsoProtocolId`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#ftsoprotocolid) | +| **Feeds history size** | 1000 | [`FtsoFeedPublisher.feedsHistorySize`](/ftso/scaling/solidity-reference/IFtsoFeedPublisher#feedshistorysize) | +| **Minimal reward offer** | 100000 FLR | [`FtsoRewardOffersManager.minimalRewardsOfferValueWei`](/ftso/scaling/solidity-reference/IFtsoRewardOffersManager#minimalrewardsoffervaluewei) |