NEW

Join us at SmartCon 2023—where Web3 gets real. Get your ticket.

Supported Networks

Chainlink VRF allows you to integrate provably fair and verifiably random data in your smart contract.

For implementation details, read Introduction to Chainlink VRF v2 Direct funding method.

Wrapper parameters

These parameters are configured in the VRF v2 Wrapper contract. You can view these values by running getConfig on the VRF v2 Wrapper or by viewing the VRF v2 Wrapper contract in a blockchain explorer.

  • uint32 stalenessSeconds: How long the VRF v2 Wrapper waits until we consider the ETH/LINK price used for converting gas costs to LINK is stale and use fallbackWeiPerUnitLink.
  • uint32 wrapperGasOverhead: The gas overhead of the VRF v2 Wrapper's fulfillRandomWords function.
  • uint32 coordinatorGasOverhead: The gas overhead of the coordinator's fulfillRandomWords function.
  • uint8 maxNumWords: Maximum number of words that can be requested in a single wrapped VRF request.

Coordinator parameters

Some parameters are important to know and are configured in the coordinator contract. You can view these values by running getConfig on the coordinator or by viewing the coordinator contract in a blockchain explorer.

  • uint16 minimumRequestConfirmations: The minimum number of confirmation blocks on VRF requests before oracles respond
  • uint32 maxGasLimit: The maximum gas limit supported for a fulfillRandomWords callback. Note that you still need to substract the wrapperGasOverhead for the accurate limit, as explained in Direct funding limits.

Fee parameters

Fee parameters are configured in the VRF v2 Wrapper and the VRF v2 Coordinator contracts and specify the premium you pay per request in addition to the gas cost for the transaction. You can view them by running getConfig on the VRF v2 Wrapper:

  • The uint32 fulfillmentFlatFeeLinkPPM parameter is a flat fee and defines the fees per request specified in millionths of LINK.
  • The uint8 wrapperPremiumPercentage parameter defines the premium ratio in percentage. For example, a value of 0 indicates no premium. A value of 15 indicates a 15% premium.

The details for calculating the total transaction cost can be found here.

Configurations

VRF v2 coordinators for direct funding are available on several networks. To see a list of coordinators for subscription funding, see the Subscription Configurations page.

Ethereum mainnet

ItemValue
LINK Token0x514910771AF9Ca656af840dff83E8264EcF986CA
VRF Wrapper0x5A861794B927983406fCE1D062e00b9368d97Df6
VRF Coordinator0x271682DEB8C4E0901D1a1550aD2e64D568E69909
Wrapper Premium Percentage0
Coordinator Flat Fee0.25 LINK
Minimum Confirmations3
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Sepolia testnet

ItemValue
LINK Token0x779877A7B0D9E8603169DdbD7836e478b4624789
VRF Wrapper0xab18414CD93297B0d12ac29E63Ca20f515b3DB46
VRF Coordinator0x8103B0A8A00be2DDC778e6e7eaa21791Cd364625
Wrapper Premium Percentage0
Coordinator Flat Fee0.25 LINK
Minimum Confirmations3
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Goerli testnet

ItemValue
LINK Token0x326C977E6efc84E512bB9C30f76E30c160eD06FB
VRF Wrapper0x708701a1DfF4f478de54383E49a627eD4852C816
VRF Coordinator0x2Ca8E0C643bDe4C2E08ab1fA0da3401AdAD7734D
Wrapper Premium Percentage0
Coordinator Flat Fee0.25 LINK
Minimum Confirmations3
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

BNB Chain

ItemValue
LINK Token0x404460C6A5EdE2D891e8297795264fDe62ADBB75
VRF Wrapper0x721DFbc5Cfe53d32ab00A9bdFa605d3b8E1f3f42
VRF Coordinator0xc587d9053cd1118f25F645F9E08BB98c9712A4EE
Wrapper Premium Percentage0
Coordinator Flat Fee0.005 LINK
Minimum Confirmations3
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

BNB Chain testnet

ItemValue
LINK Token0x84b9B910527Ad5C03A9Ca831909E21e236EA7b06
VRF Wrapper0x699d428ee890d55D56d5FC6e26290f3247A762bd
VRF Coordinator0x6A2AAd07396B36Fe02a22b33cf443582f682c82f
Wrapper Premium Percentage0
Coordinator Flat Fee0.005 LINK
Minimum Confirmations3
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Polygon (Matic) mainnet

ItemValue
LINK Token0xb0897686c545045aFc77CF20eC7A532E3120E0F1
VRF Wrapper0x4e42f0adEB69203ef7AaA4B7c414e5b1331c14dc
VRF Coordinator0xAE975071Be8F8eE67addBC1A82488F1C24858067
Wrapper Premium Percentage0
Coordinator Flat Fee0.0005 LINK
Minimum Confirmations3
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Polygon (Matic) Mumbai testnet

ItemValue
LINK Token0x326C977E6efc84E512bB9C30f76E30c160eD06FB
VRF Wrapper0x99aFAf084eBA697E584501b8Ed2c0B37Dd136693
VRF Coordinator0x7a1BaC17Ccc5b313516C5E16fb24f7659aA5ebed
Wrapper Premium Percentage0
Coordinator Flat Fee0.0005 LINK
Minimum Confirmations3
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Avalanche mainnet

ItemValue
LINK Token0x5947BB275c521040051D82396192181b413227A3
VRF Wrapper0x721DFbc5Cfe53d32ab00A9bdFa605d3b8E1f3f42
VRF Coordinator0xd5D517aBE5cF79B7e95eC98dB0f0277788aFF634
Wrapper Premium Percentage0
Coordinator Flat Fee0.005 LINK
Minimum Confirmations1
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Avalanche Fuji testnet

ItemValue
LINK Token0x0b9d5D9136855f6FEc3c0993feE6E9CE8a297846
VRF Wrapper0x9345AC54dA4D0B5Cda8CB749d8ef37e5F02BBb21
VRF Coordinator0x2eD832Ba664535e5886b75D64C46EB9a228C2610
Wrapper Premium Percentage0
Coordinator Flat Fee0.005 LINK
Minimum Confirmations1
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Fantom mainnet

ItemValue
LINK Token0x6F43FF82CCA38001B6699a8AC47A2d0E66939407
VRF Wrapper0xeDA5B00fB33B13c730D004Cf5D1aDa1ac191Ddc2
VRF Coordinator0xd5D517aBE5cF79B7e95eC98dB0f0277788aFF634
Wrapper Premium Percentage0
Coordinator Flat Fee0.0005 LINK
Minimum Confirmations1
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Fantom testnet

ItemValue
LINK Token0xfaFedb041c0DD4fA2Dc0d87a6B0979Ee6FA7af5F
VRF Wrapper0x38336BDaE79747a1d2c4e6C67BBF382244287ca6
VRF Coordinator0xbd13f08b8352A3635218ab9418E340c60d6Eb418
Wrapper Premium Percentage0
Coordinator Flat Fee0.0005 LINK
Minimum Confirmations1
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Arbitrum mainnet

ItemValue
LINK Token0xf97f4df75117a78c1A5a0DBb814Af92458539FB4
VRF Coordinator0x41034678D6C633D8a95c75e1138A360a28bA15d1
VRF Wrapper0x2D159AE3bFf04a10A355B608D22BDEC092e934fa
Wrapper Premium Percentage0
Coordinator Flat Fee0.0005 LINK
Minimum Confirmations1
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Arbitrum Goerli testnet

ItemValue
LINK Token0xd14838A68E8AFBAdE5efb411d5871ea0011AFd28
VRF Coordinator0x6D80646bEAdd07cE68cab36c27c626790bBcf17f
VRF Wrapper0x674Cda1Fef7b3aA28c535693D658B42424bb7dBD
Wrapper Premium Percentage0
Coordinator Flat Fee0.0005 LINK
Minimum Confirmations1
Maximum Confirmations200
Maximum Random Values10
Wrapper Gas overhead40000
Coordinator Gas Overhead90000

Stay updated on the latest Chainlink news