From c48de55ea0c976d29641900418ad992220600bb4 Mon Sep 17 00:00:00 2001 From: Aditya Arora Date: Tue, 14 Oct 2025 11:06:21 +0530 Subject: [PATCH 1/3] chore(dev-hub) Move to Fuma Docs Callouts for now --- .../content/docs/entropy/generate-random-numbers-evm.mdx | 2 +- .../content/docs/entropy/set-custom-gas-limits.mdx | 4 ++-- .../content/docs/express-relay/contract-addresses.mdx | 2 +- apps/developer-hub/content/docs/metrics/kpi.mdx | 4 ++-- apps/developer-hub/src/mdx-components.tsx | 2 -- 5 files changed, 6 insertions(+), 8 deletions(-) diff --git a/apps/developer-hub/content/docs/entropy/generate-random-numbers-evm.mdx b/apps/developer-hub/content/docs/entropy/generate-random-numbers-evm.mdx index 1db75566d4..4a0a096a38 100644 --- a/apps/developer-hub/content/docs/entropy/generate-random-numbers-evm.mdx +++ b/apps/developer-hub/content/docs/entropy/generate-random-numbers-evm.mdx @@ -147,7 +147,7 @@ IEntropyV2 entropy; When the final random number is ready to use, the entropyCallback function will be called by the Entropy contract. This will happen in a separate transaction submitted by the requested provider. - + The `entropyCallback` function on your contract should **never** return an error. If it returns an error, the keeper will not be able to invoke the callback. If you are having problems receiving the callback, please see diff --git a/apps/developer-hub/content/docs/entropy/set-custom-gas-limits.mdx b/apps/developer-hub/content/docs/entropy/set-custom-gas-limits.mdx index bfaa8c7f82..3c61ef7f05 100644 --- a/apps/developer-hub/content/docs/entropy/set-custom-gas-limits.mdx +++ b/apps/developer-hub/content/docs/entropy/set-custom-gas-limits.mdx @@ -127,7 +127,7 @@ mapping(uint64 => bool) public processedRequests; When setting custom gas limits, be aware of these constraints: - + Gas limits are automatically rounded up to the nearest multiple of **10,000**. Example: 19,000 becomes 20,000 25,500 becomes 30,000. The minimum gas limit is the provider's configured default limit. The maximum gas limit is 655,350,000 @@ -169,7 +169,7 @@ uint32 customGasLimit = estimatedGas + safetyBuffer; Be prepared to handle cases where your gas limit is insufficient: - + If your callback **runs out of gas**, the entropy provider will **not** be able to complete the callback. Always test your gas limits thoroughly and include adequate safety margins. diff --git a/apps/developer-hub/content/docs/express-relay/contract-addresses.mdx b/apps/developer-hub/content/docs/express-relay/contract-addresses.mdx index fa1b39ccda..9b4474b916 100644 --- a/apps/developer-hub/content/docs/express-relay/contract-addresses.mdx +++ b/apps/developer-hub/content/docs/express-relay/contract-addresses.mdx @@ -22,7 +22,7 @@ description: >- - + To simulate real performance conditions and activity, the staging/testing environment for Solana is on the mainnet-beta network. This environment is not for production use and should only be used for testing. diff --git a/apps/developer-hub/content/docs/metrics/kpi.mdx b/apps/developer-hub/content/docs/metrics/kpi.mdx index 18a951daaa..4543da97f5 100644 --- a/apps/developer-hub/content/docs/metrics/kpi.mdx +++ b/apps/developer-hub/content/docs/metrics/kpi.mdx @@ -3,14 +3,14 @@ title: Pyth Network KPI description: Monthly informative data points on the Pyth network, its growth, and performance metrics. --- - + For the latest KPI dashboard, please visit [https://kpi.pyth.network/](https://kpi.pyth.network/). Every month, the Pyth contributors collect informative data points on the network, its growth, as well as its performance. - + All figures mentioned are just rough estimations. Due to Pyth's permissionless nature, any apps can use the Pyth price feeds without talking to the Pyth contributors. This will exclude them from the calculations. diff --git a/apps/developer-hub/src/mdx-components.tsx b/apps/developer-hub/src/mdx-components.tsx index 0d1308841a..20240cb85e 100644 --- a/apps/developer-hub/src/mdx-components.tsx +++ b/apps/developer-hub/src/mdx-components.tsx @@ -17,7 +17,5 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents { Tab, ...components, InfoBox: InfoBox, - // Fuma has a Callout component in `defaultMdxComponents` which we still want to overwrite - Callout: InfoBox, }; } From d6d44ae209db94623bf289f9ad1a890c702aeb73 Mon Sep 17 00:00:00 2001 From: Aditya Arora Date: Tue, 14 Oct 2025 11:41:57 +0530 Subject: [PATCH 2/3] chore(dev-hub) Added banner to Entropy Pages --- .../content/docs/entropy/chainlist.mdx | 8 ++-- .../content/docs/entropy/fees.mdx | 2 +- .../docs/entropy/whats-new-entropyv2.mdx | 1 - .../content/docs/metrics/kpi.mdx | 2 +- .../src/app/(docs)/[section]/layout.tsx | 38 ++++++++++++++++++- 5 files changed, 42 insertions(+), 9 deletions(-) diff --git a/apps/developer-hub/content/docs/entropy/chainlist.mdx b/apps/developer-hub/content/docs/entropy/chainlist.mdx index 183d36d7f6..4a3a2bd193 100644 --- a/apps/developer-hub/content/docs/entropy/chainlist.mdx +++ b/apps/developer-hub/content/docs/entropy/chainlist.mdx @@ -8,12 +8,12 @@ import { EntropyTable } from "../../../src/components/EntropyTable"; ## Mainnets - +
The fees for mainnet are dynamically set. Always use the on-chain method `entropy.getFeeV2()` to get the current fee.
- + The following tables shows the total fees payable when using the **default provider**. Note that the fees shown below will vary over time with prevailing gas prices on each chain. @@ -32,12 +32,12 @@ Entropy callbacks the consumer as part of this transaction. ## Testnets - +
The fees for testnets are kept deliberately low and different from the mainnet fees.
- + The Entropy contract is deployed on the following testnet chains: diff --git a/apps/developer-hub/content/docs/entropy/fees.mdx b/apps/developer-hub/content/docs/entropy/fees.mdx index 347ef78fd6..eb7cec9e08 100644 --- a/apps/developer-hub/content/docs/entropy/fees.mdx +++ b/apps/developer-hub/content/docs/entropy/fees.mdx @@ -17,4 +17,4 @@ Note that protocols integrating with Entropy can pass these fees along to their submits a transaction that requests a random number, the user can directly pay the entropy fees required with the native blockchain token. There are no fees for revealing the random numbers. -You can check the current fees in the [chainlist and fee details](./entropy/chainlist) page for each blockchain. +You can check the current fees in the [chainlist and fee details](./chainlist) page for each blockchain. diff --git a/apps/developer-hub/content/docs/entropy/whats-new-entropyv2.mdx b/apps/developer-hub/content/docs/entropy/whats-new-entropyv2.mdx index 44b09268e3..b52c82d900 100644 --- a/apps/developer-hub/content/docs/entropy/whats-new-entropyv2.mdx +++ b/apps/developer-hub/content/docs/entropy/whats-new-entropyv2.mdx @@ -22,7 +22,6 @@ Each of these request types is described in more detail with examples in [Reques ### 2. Enhanced Callback Status Entropy V2 introduces callback statuses, which allow users to track the status of their callbacks. - [Pyth Dev-Forum Announcement](https://dev-forum.pyth.network/t/announcing-entropy-v2/324#p-649-enhanced-callback-statuses-2) provides more details on enhanced callback statuses. ### 3. Entropy Explorer diff --git a/apps/developer-hub/content/docs/metrics/kpi.mdx b/apps/developer-hub/content/docs/metrics/kpi.mdx index 4543da97f5..08d24c70b4 100644 --- a/apps/developer-hub/content/docs/metrics/kpi.mdx +++ b/apps/developer-hub/content/docs/metrics/kpi.mdx @@ -3,7 +3,7 @@ title: Pyth Network KPI description: Monthly informative data points on the Pyth network, its growth, and performance metrics. --- - + For the latest KPI dashboard, please visit [https://kpi.pyth.network/](https://kpi.pyth.network/). diff --git a/apps/developer-hub/src/app/(docs)/[section]/layout.tsx b/apps/developer-hub/src/app/(docs)/[section]/layout.tsx index 8a258e1fe6..ea08c91608 100644 --- a/apps/developer-hub/src/app/(docs)/[section]/layout.tsx +++ b/apps/developer-hub/src/app/(docs)/[section]/layout.tsx @@ -1,9 +1,43 @@ +import { Banner } from "fumadocs-ui/components/banner"; import { DocsLayout } from "fumadocs-ui/layouts/docs"; +import Link from "next/link"; import type { ReactNode } from "react"; import { docsOptions } from "../../../config/layout.config"; -export default function Layout({ children }: { children: ReactNode }) { +export default function Layout({ + children, + params, +}: { + children: ReactNode; + params: { section: string }; +}) { + const { section } = params; const options = { ...docsOptions }; - return {children}; + + return ( + <> + {section === "entropy" && ( + + + + Try the{" "} + + Entropy Explorer + + {" "} + to track and debug callback issues.  |  + + Learn what's new in Entropy v2. + + + + )} + {children} + + ); } From 25b3efda6f7ad6aca896adfa2c71fa567d83b631 Mon Sep 17 00:00:00 2001 From: Aditya Arora Date: Wed, 15 Oct 2025 11:31:09 +0530 Subject: [PATCH 3/3] chore(dev-hub) Build issue fixed --- apps/developer-hub/src/app/(docs)/[section]/layout.tsx | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/apps/developer-hub/src/app/(docs)/[section]/layout.tsx b/apps/developer-hub/src/app/(docs)/[section]/layout.tsx index ea08c91608..7738bd74d5 100644 --- a/apps/developer-hub/src/app/(docs)/[section]/layout.tsx +++ b/apps/developer-hub/src/app/(docs)/[section]/layout.tsx @@ -5,15 +5,14 @@ import type { ReactNode } from "react"; import { docsOptions } from "../../../config/layout.config"; -export default function Layout({ +export default async function Layout({ children, params, }: { children: ReactNode; - params: { section: string }; + params: Promise<{ section: string }>; }) { - const { section } = params; - const options = { ...docsOptions }; + const { section } = await params; return ( <> @@ -37,7 +36,7 @@ export default function Layout({ )} - {children} + {children} ); }