Add Contracts to subscription

After creating your subscription and configuring gas settings, you need to whitelist your consumer contracts. Only whitelisted contracts can request random numbers from your subscription.

Important: Make sure you've read the Gas Configuration page first. Understanding gas settings is crucial before adding contracts and funds, as your contract-level gas configuration directly impacts performance, costs, and minimum balance requirements

Via Subscription Manager UI

The easiest way to manage your contracts is through the web interface at supra.com/data/dvrf.

Steps

• Navigate to Contract Management

  • Go to supra.com/data/dvrf

  • Connect your wallet (subscription owner)

  • Click on "My Subscription"

  • Select "Manage Contracts" or "Add Contract"

• Add New Contract

  • Click "Add Contract"

  • Enter your contract address

  • Configure gas settings for this specific contract

• Configure Contract Gas Settings For EVM Chains:

  • Callback Gas Price: Must be ≤ your subscription's maxGasPrice

  • Callback Gas Limit: Must be ≤ your subscription's maxGasLimit

  For Supra L1:

  • Gas settings are inherited from subscription level

• Submit and Confirm

Via Onchain Contracts

For EVM Chains

solidity// Interface for adding contracts
interface IDeposit {
    function addContractToWhitelist(
        address contractAddress,
        uint128 callbackGasPrice,
        uint128 callbackGasLimit
    ) external;
}

For Supra L1

// Add contract to whitelist
public entry fun add_contract(sender: &signer, contract_address: address) {
    deposit::add_contract_to_whitelist(contract_address);
}

Remove Contracts from subscription

You can remove already whitelisted contracts via subscription manager UI or via onchain function.

// Remove contract from whitelist
removeContractFromWhitelist(contractAddress);