Request Callback Variants

The IEntropyV2 interface provides multiple variants of the requestV2 function:

1. Basic request

function requestV2() external payable returns (uint64 assignedSequenceNumber);

This is the simplest variant that requests entropy using the default provider and default gas settings. Uses in-contract PRNG for the user contribution to randomness.

Use this when you want the most straightforward implementation and don't need to customize provider or gas parameters.

Example

function requestBasicRandomNumber() external payable {
    // Get the fee for the default provider and gas limit
    uint256 fee = entropy.getFeeV2();

    require(msg.value >= fee, "Insufficient fee");

    // Request randomness with default settings
    uint64 sequenceNumber = entropy.requestV2{value: fee}();
}

2. Request with custom gas limit

function requestV2(
    uint32 gasLimit
) external payable returns (uint64 assignedSequenceNumber);

This variant allows you to specify a custom gas limit for the callback function execution. Uses in-contract PRNG for the user contribution.

Use this when your entropyCallback function has complex logic that requires more gas than the default amount, or when you want to optimize gas usage by setting a lower limit for simple callbacks.

Example

function requestWithCustomGas() external payable {
    uint32 customGasLimit = 150000; // Custom gas limit for callback

    // Get fee for the custom gas limit
    uint256 fee = entropy.getFeeV2(customGasLimit);

    require(msg.value >= fee, "Insufficient fee");

    // Request with custom gas limit
    uint64 sequenceNumber = entropy.requestV2{value: fee}(customGasLimit);
}

3. Request with custom provider

function requestV2(
    address provider
) external payable returns (uint64 assignedSequenceNumber);

This variant allows you to specify a custom entropy provider instead of using the default one.

4. Full custom request

function requestV2(
    address provider,
    uint32 gasLimit,
    bytes32 userRandomNumber
) external payable returns (uint64 assignedSequenceNumber);

This is the most flexible variant that allows you to specify all parameters: custom provider, custom gas limit, and user random number.

1. Basic request

Example

2. Request with custom gas limit

Example

3. Request with custom provider

4. Full custom request

On this page