chore(dev-docs): update entropy edits

Author: aditya520

apps/developer-hub/content/docs/entropy/debug-callback-failures.mdx

@@ -2,65 +2,70 @@
 title: Debug Callback Failures
 description: How to identify and resolve issues with Entropy callbacks
 ---
+import { DynamicCodeBlock } from 'fumadocs-ui/components/dynamic-codeblock';
 
-# Debug Callback Failures
+This guide explains how to identify and resolve issues with the Entropy callback.
+The intended audience for this guide is developers who have made an Entropy random number request, but their application hasn't received a callback.
 
 > 🔍 **Quick Debug Tool**
+> 
 > Use the [Entropy Explorer](https://entropy-debugger.pyth.network/) to quickly diagnose and resolve callback issues.
 
-This guide explains how to identify and resolve issues with the Entropy callback.
-The intended audience for this guide is developers who have made an Entropy random number request, but their application hasn't received a callback.
 
 ## Dependencies
 
 This guide uses [Foundry](https://book.getfoundry.sh/getting-started/installation) to submit transactions to the blockchain.
 Please install Foundry before continuing.
-
 ## Run the Callback
 
 Developers can run the Entropy callback themselves to see the reason for the failure.
 To run the callback, invoke the `revealWithCallback` function on the Entropy contract on your blockchain.
 The function has the following signature:
 
-```solidity
-function revealWithCallback(
+<DynamicCodeBlock lang="solidity" 
+code={`function revealWithCallback(
     address provider,
     uint64 sequenceNumber,
-    bytes32 userRandomNumber,
-    bytes32 providerRevelation
+    bytes32 userContribution,
+    bytes32 providerContribution
 )
-```
+`} />
 
-This call requires the chain ID, contract address, and four arguments.
+This call requires the chain ID, contract address, and four other arguments.
 The chain ID and contract address can be retrieved from [Contract Addresses](contract-addresses).
 Export these values as environment variables for later use:
 
-```bash
-export CHAIN_ID=blast
+<DynamicCodeBlock lang="bash" 
+code={`export CHAIN_ID=blast
 export ENTROPY_ADDRESS=0x5744Cbf430D99456a0A8771208b674F27f8EF0Fb
-```
+`} />
 
-Three of the arguments can be retrieved from the request transaction's event logs.
+Three of the other arguments can be retrieved from the request transaction's event logs.
 Look at the event logs of the request transaction in a block explorer.
 You should see a `RequestedWithCallback` event emitted from the Entropy contract.
 
 Copy the following values from the event into environment variables:
 
-```bash
-export PROVIDER=0x52DeaA1c84233F7bb8C8A45baeDE41091c616506
+<DynamicCodeBlock lang="bash" 
+code={`export PROVIDER=0x52DeaA1c84233F7bb8C8A45baeDE41091c616506
 export SEQUENCE_NUMBER=12345
 export USER_RANDOM_NUMBER=0x1234...
-```
+`} />
 
-The fourth argument (provider revelation) must be retrieved from the provider's API.
+The fourth argument (provider contribution) must be retrieved from the provider's API.
 This value becomes available after the reveal delay has passed.
 
 ## Common Issues
 
+There are a few common issues that can cause the callback to fail.
+
 ### Gas Limit Exceeded
 
 If your callback function uses too much gas, the transaction will fail. Check the gas limit for your chain on the [contract addresses](contract-addresses) page and ensure your callback function uses less gas.
 
+> 💡 **Tip**
+> Refer to the [Set Custom Gas Limits](set-custom-gas-limits) guide to set a custom gas limit for your callback function.
+
 ### Callback Function Errors
 
 Your callback function might contain logic that throws an error. Review your callback implementation for:
@@ -73,3 +78,4 @@ Your callback function might contain logic that throws an error. Review your cal
 ### Transaction Timing
 
 Make sure you're attempting the callback after the reveal delay has passed. The reveal delay varies by network and helps prevent MEV attacks.
+Refer to the [Contract Addresses](contract-addresses) page for the reveal delay for each network.

apps/developer-hub/content/docs/entropy/generate-random-numbers-evm.mdx

@@ -4,6 +4,7 @@ description: Learn how to integrate Pyth Entropy to generate random numbers in y
 ---
 
 import { Step, Steps } from "fumadocs-ui/components/steps";
+import { DynamicCodeBlock } from 'fumadocs-ui/components/dynamic-codeblock';
 
 This guide explains how to integrate Pyth Entropy into EVM Contracts to generate on-chain random numbers.
 The intended audience for this guide is developers of any application that needs on-chain randomness, such as NFT mints or games.
@@ -15,21 +16,19 @@ Install the SDK using your package manager:
 
 <Tabs items={['hardhat', 'foundry']}>
 <Tab value="hardhat">
-```shell copy
-npm install @pythnetwork/entropy-sdk-solidity
-```
+<DynamicCodeBlock lang="shell" 
+code={`npm install @pythnetwork/entropy-sdk-solidity`} />
 </Tab>
 <Tab value="foundry">
-```shell copy
-npm init -y
+<DynamicCodeBlock lang="shell" code={`npm init -y
 npm install @pythnetwork/entropy-sdk-solidity
-```
+`} />
 
 Then add the following line to your `remappings.txt` file:
 
-```text copy
-@pythnetwork/entropy-sdk-solidity/=node_modules/@pythnetwork/entropy-sdk-solidity
-```
+<DynamicCodeBlock lang="text" 
+code={`@pythnetwork/entropy-sdk-solidity/=node_modules/@pythnetwork/entropy-sdk-solidity
+`} />
 
 </Tab>
 </Tabs>
@@ -44,8 +43,8 @@ The Solidity SDK exports two interfaces:
   Consult the current [Entropy contract addresses](../contract-addresses) to find the address on your chain.
   Once you have a contract address, instantiate an `console.log("IEntropyV2"){:bash}` contract in your solidity contract:
 
-```solidity copy
-import { IEntropyConsumer } from "@pythnetwork/entropy-sdk-solidity/IEntropyConsumer.sol";
+<DynamicCodeBlock lang="solidity" 
+code={`import { IEntropyConsumer } from "@pythnetwork/entropy-sdk-solidity/IEntropyConsumer.sol";
 import { IEntropyV2 } from "@pythnetwork/entropy-sdk-solidity/IEntropyV2.sol";
 
 // @param entropyAddress The address of the entropy contract.
@@ -56,16 +55,15 @@ contract YourContract is IEntropyConsumer {
     entropy = IEntropyV2(entropyAddress);
   }
 }
-
-```
+`} />
 
 ## Usage
 
 To generate a random number, follow these steps.
 
 <Steps>
 <Step>
-### 1. Request a number from Entropy
+### Request a number from Entropy
 
 Invoke the [`requestV2`](https://github.com/pyth-network/pyth-crosschain/blob/main/target_chains/ethereum/entropy_sdk/solidity/IEntropy.sol#L83) method of the `IEntropyV2` interface.
 The `console.log("requestV2"){:bash}` method requires paying a fee in native gas tokens which is configured per-provider.
@@ -76,14 +74,13 @@ However, you should use the on-chain method [`getFeeV2`](https://github.com/pyth
 
 These methods use the default randomness provider ([see here](#randomness-providers) for more info on providers).
 
-```solidity copy
-function requestRandomNumber() external payable {
+<DynamicCodeBlock lang="solidity" 
+code={`function requestRandomNumber() external payable {
   uint256 fee = entropy.getFeeV2();
 
   uint64 sequenceNumber = entropy.requestV2{ value: fee }();
 }
-
-```
+`} />
 
 This method returns a sequence number and emits a [`Requested`](https://github.com/pyth-network/pyth-crosschain/blob/main/target_chains/ethereum/entropy_sdk/solidity/EntropyEventsV2.sol#L30) event. You can store this sequence number to identify the request in next step.
 
@@ -94,10 +91,10 @@ Please see the method documentation in the [IEntropyV2 interface](https://github
 </Step>
 <Step>
 
-### 2. Implement the Entropy callback
+### Implement the Entropy callback
 
-```solidity {31-45} copy
-pragma solidity ^0.8.0;
+<DynamicCodeBlock lang="solidity" 
+code={`pragma solidity ^0.8.0;
 
 import { IEntropyConsumer } from "@pythnetwork/entropy-sdk-solidity/IEntropyConsumer.sol";
 import { IEntropyV2 } from "@pythnetwork/entropy-sdk-solidity/IEntropyV2.sol";
@@ -141,15 +138,14 @@ contract YourContract is IEntropyConsumer {
     return address(entropy);
   }
 }
-
-```
+`} />
 
 </Step>
 </Steps>
 
 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.
 
-<Callout type="info">
+<Callout variant="warning">
   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
@@ -184,6 +180,6 @@ a keeper service for fullfilling requests.
 
 You can get the default provider's address by calling the [`getDefaultProvider`](https://github.com/pyth-network/pyth-crosschain/blob/f8ebeb6af31d98f94ce73edade6da2ebab7b2456/target_chains/ethereum/entropy_sdk/solidity/IEntropy.sol#L94) method:
 
-```solidity copy
-address provider = entropy.getDefaultProvider();
-```
+<DynamicCodeBlock lang="solidity" 
+code={`address provider = entropy.getDefaultProvider();
+`} />

apps/developer-hub/content/docs/entropy/set-custom-gas-limits.mdx

@@ -4,8 +4,9 @@ description: How to set custom gas limits for Entropy callbacks
 ---
 
 import { Step, Steps } from "fumadocs-ui/components/steps";
+import { DynamicCodeBlock } from 'fumadocs-ui/components/dynamic-codeblock';
 
-Custom gas limits are useful when your callback function requires more gas than the default provider limit, or when you want to optimize gas costs for simpler callbacks.
+Custom gas limits are useful when your callback function requires more gas than the [default provider limit]TODO(../contract-addresses), or when you want to optimize gas costs for simpler callbacks.
 
 ## Prerequisites
 
@@ -30,8 +31,8 @@ You might need custom gas limits in these scenarios:
 
 Instead of the basic `requestV2()` method, use the variant that accepts a `gasLimit` parameter:
 
-```solidity copy
-function requestRandomNumberWithCustomGas(
+<DynamicCodeBlock lang="solidity" 
+code={`function requestRandomNumberWithCustomGas(
   uint32 customGasLimit
 ) external payable {
   // Calculate the fee for the custom gas limit
@@ -42,26 +43,25 @@ function requestRandomNumberWithCustomGas(
 
   // Store the sequence number for tracking if needed
 }
-
-```
+`} />
 
 ### 2. Calculate Fees with Custom Gas Limit
 
 When using custom gas limits, you must use the `getFeeV2` variant that accepts a `gasLimit` parameter:
 
-```solidity copy
-// Get fee for custom gas limit
+<DynamicCodeBlock lang="solidity" 
+code={`// Get fee for custom gas limit
 uint256 fee = entropy.getFeeV2(customGasLimit);
 
 // NOT: uint256 fee = entropy.getFeeV2(); // This uses default gas limit
-```
+`} />
 
 ### 3. Complete Example
 
 Here's a complete example showing how to implement custom gas limits:
 
-```solidity copy
-pragma solidity ^0.8.0;
+<DynamicCodeBlock lang="solidity" 
+code={`pragma solidity ^0.8.0;
 
 import { IEntropyConsumer } from "@pythnetwork/entropy-sdk-solidity/IEntropyConsumer.sol";
 import { IEntropyV2 } from "@pythnetwork/entropy-sdk-solidity/IEntropyV2.sol";
@@ -120,18 +120,17 @@ contract CustomGasLimitExample is IEntropyConsumer {
     return address(entropy);
   }
 }
-
-```
+`} />
 
 ## Gas Limit Constraints
 
 When setting custom gas limits, be aware of these constraints:
 
-<Callout type="info" title="Gas Limit Rules">
-  - 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 (uint16.max × 10,000).
+<Callout variant="info" header="Gas Limit Rules">
+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 (`uint16.max` \* 10,000).
 </Callout>
 
 ### Recommended Gas Limits
@@ -147,44 +146,44 @@ When setting custom gas limits, be aware of these constraints:
 
 Test your callback function to determine the actual gas usage:
 
-```solidity copy
-// In your tests, measure gas usage
+<DynamicCodeBlock lang="solidity" 
+code={`// In your tests, measure gas usage
 uint256 gasStart = gasleft();
 // Your callback logic here
 uint256 gasUsed = gasStart - gasleft();
 console.log("Gas used:", gasUsed);
-```
+`} />
 
 ### 2. Add Safety Buffer
 
 Always add a safety buffer to your estimated gas usage:
 
-```solidity copy
-uint32 estimatedGas = 150000;
+<DynamicCodeBlock lang="solidity" 
+code={`uint32 estimatedGas = 150000;
 uint32 safetyBuffer = 20000;
 uint32 customGasLimit = estimatedGas + safetyBuffer;
-```
+`} />
 
 ### 3. Handle Gas Limit Errors
 
 Be prepared to handle cases where your gas limit is insufficient:
 
-<Callout type="warning" emoji="⚠️">
-  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.
+<Callout variant="warning">
+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.
 </Callout>
 
 ### 4. Consider Fee Implications
 
 Higher gas limits result in higher fees. Balance your gas needs with cost considerations:
 
-```solidity copy
-// Compare fees for different gas limits
+<DynamicCodeBlock lang="solidity" 
+code={`// Compare fees for different gas limits
 uint256 defaultFee = entropy.getFeeV2();
 uint256 customFee = entropy.getFeeV2(customGasLimit);
 uint256 additionalCost = customFee - defaultFee;
-```
+`} />
 
 ## Troubleshooting
 

apps/developer-hub/content/docs/entropy/whats-new-entropyv2.mdx

@@ -3,6 +3,7 @@ title: What's New in Entropy v2
 description: New features and improvements in Entropy v2
 icon: Sparkle
 ---
+import { DynamicCodeBlock } from 'fumadocs-ui/components/dynamic-codeblock';
 
 ## Key Improvements
 
@@ -23,16 +24,15 @@ Each of these request types is described in more detail with examples in [Reques
 
 The new version offers more granular fee calculation:
 
-```solidity
-// Get fee for default provider and gas limit
+<DynamicCodeBlock lang="solidity" code={`// Get fee for default provider and gas limit
 uint256 basicFee = entropy.getFeeV2();
 
 // Get fee for custom gas limit
 uint256 customGasFee = entropy.getFeeV2(gasLimit);
 
 // Get fee for specific provider and gas limit
 uint256 providerFee = entropy.getFeeV2(provider, gasLimit);
-```
+`} />
 
 ### 3. Enhanced Callback Status
 

apps/developer-hub/src/app/(docs)/layout.tsx

@@ -5,7 +5,7 @@ import { docsOptions } from "../../config/layout.config";
 
 export default function Layout({ children }: { children: ReactNode }) {
   return (
-    <DocsLayout {...docsOptions} containerProps={{ role: "none" }}>
+    <DocsLayout {...docsOptions}>
       {children}
     </DocsLayout>
   );