From 84dcead0b8221ab9034106fe78834bf4751703cd Mon Sep 17 00:00:00 2001 From: Amin Moghaddam Date: Wed, 6 Mar 2024 10:45:32 +0100 Subject: [PATCH] docs(fortuna): Add comments regarding delays on fortuna --- pages/entropy/contract-addresses.mdx | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/pages/entropy/contract-addresses.mdx b/pages/entropy/contract-addresses.mdx index 246a00a1..70ffa7ae 100644 --- a/pages/entropy/contract-addresses.mdx +++ b/pages/entropy/contract-addresses.mdx @@ -2,18 +2,22 @@ ## Mainnets -| Chain Id | Entropy Contract Address | -| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| lightlink-phoenix | [`0x98046Bd286715D3B0BC227Dd7a956b83D8978603`](https://phoenix.lightlink.io/address/0x98046Bd286715D3B0BC227Dd7a956b83D8978603) | -| chiliz | [`0x0708325268dF9F66270F1401206434524814508b`](https://scan.chiliz.com/address/0x0708325268dF9F66270F1401206434524814508b) | -| arbitrum | [`0x7698E925FfC29655576D0b361D75Af579e20AdAc`](https://arbiscan.io/address/0x7698E925FfC29655576D0b361D75Af579e20AdAc) | -| optimism | [`0xdF21D137Aadc95588205586636710ca2890538d5`](https://optimistic.etherscan.io/address/0xdF21D137Aadc95588205586636710ca2890538d5) | -| mode | [`0x8D254a21b3C86D32F7179855531CE99164721933`](https://explorer.mode.network/address/0x8D254a21b3C86D32F7179855531CE99164721933) | -| blast | [`0x5744Cbf430D99456a0A8771208b674F27f8EF0Fb`](https://blastscan.io/address/0x5744Cbf430D99456a0A8771208b674F27f8EF0Fb) | +| Chain Id | Entropy Contract Address | Reveal Delay | +| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------ | +| lightlink-phoenix | [`0x98046Bd286715D3B0BC227Dd7a956b83D8978603`](https://phoenix.lightlink.io/address/0x98046Bd286715D3B0BC227Dd7a956b83D8978603) | 1 block | +| chiliz | [`0x0708325268dF9F66270F1401206434524814508b`](https://scan.chiliz.com/address/0x0708325268dF9F66270F1401206434524814508b) | 12 blocks | +| arbitrum | [`0x7698E925FfC29655576D0b361D75Af579e20AdAc`](https://arbiscan.io/address/0x7698E925FfC29655576D0b361D75Af579e20AdAc) | 6 blocks | +| optimism | [`0xdF21D137Aadc95588205586636710ca2890538d5`](https://optimistic.etherscan.io/address/0xdF21D137Aadc95588205586636710ca2890538d5) | Until `safe` | +| mode | [`0x8D254a21b3C86D32F7179855531CE99164721933`](https://explorer.mode.network/address/0x8D254a21b3C86D32F7179855531CE99164721933) | Until `safe` | +| blast | [`0x5744Cbf430D99456a0A8771208b674F27f8EF0Fb`](https://blastscan.io/address/0x5744Cbf430D99456a0A8771208b674F27f8EF0Fb) | Until `safe` | The default provider for above mainnet chains is `0x52DeaA1c84233F7bb8C8A45baeDE41091c616506`. The Fortuna URL for the default provider is `https://fortuna.dourolabs.app/v1/chains/`, where `` is the chain id from the leftmost column. +The default provider on mainnet has a reveal delay to avoid changes on the outcome of the Entropy request because of block reorgs. +The reveal delay can be a number of blocks (measured from the `latest` block) or `safe` which means the reveal will be delayed until the request transaction is included in a block with `safe` tag. +Read [here](https://www.alchemy.com/overviews/ethereum-commitment-levels) for more information on commitment levels. + ## Testnets | Chain Id | Entropy Contract Address | @@ -33,3 +37,5 @@ where `` is the chain id from the leftmost column. The default provider for above testnet chains is `0x6CC14824Ea2918f5De5C2f75A9Da968ad4BD6344`. The Fortuna URL for the default provider is `https://fortuna-staging.dourolabs.app/v1/chains/`, where `` is the chain id from the leftmost column. + +The default provider on testnet doesn't have a reveal delay. It reveals the commitment as soon as the request transaction is included in a block.