NEW

CCIP is now live for all developers. See what's new.

Chainlink VRF Release Notes

2024-07-15 - Deprecation announcement

VRF V2 and V1 will be deprecated on November 29, 2024. Please migrate to VRF V2.5 before then.

The docs for VRF V2 are still available and have been moved to the legacy section:

2024-05-24 - Updated VRF V2.5 contracts

The @chainlink/contracts package version 1.1.1 is now available. It includes the updated wrapper and interface contracts for VRF 2.5 direct funding, which had not been included in the @chainlink/contracts package version 1.1.0. The DirectFundingConsumer.sol example contract has been updated to reflect this.

The @chainlink/contracts also includes an updated function signature for fulfillRandomWords in the VRFConsumerBaseV2Plus contract, which applies only to subscription users. This function signature has not changed in the VRFV2PlusWrapperConsumerBase, so this does not affect direct funding users.

When using package version 1.1.1 and later, update your fulfillRandomWords function signature to match the VRFConsumerBaseV2Plus contract, which has changed to:

function fulfillRandomWords(uint256 requestId, uint256[] calldata randomWords)

In the @chainlink/contracts package version 1.1.0 and earlier, the randomWords parameter has a memory storage location.

2024-04-29 - VRF V2.5 released on Ethereum, BNB Chain, Polygon, Avalanche and Arbitrum

VRF V2.5 is available on Ethereum, BNB Chain, Polygon, Avalanche and Arbitrum mainnets and testnets.

The new version of Chainlink VRF implements the following changes:

  • Support for native gas token billing
  • Easy 1-click migration to future new versions
  • New billing model, where the premium is a percentage of the gas costs of the VRF callback instead of a flat fee
  • Gas optimizations

Learn how to migrate to VRF V2.5.

2024-04-13 - Polygon testnet support changed

The Mumbai network has stopped producing blocks, so example code will not function on this network. Check again soon for updates about future testnet support on Polygon.

2024-03-29 - Fantom support changed

Creating new Fantom subscriptions in the VRF Subscription Manager is no longer supported. Existing Fantom subscriptions are still supported.

2023-11-17 - Arbitrum testnet changed

Arbitrum Goerli support ends as of November 18, 2023. Support for Arbitrum Sepolia is available for both subscription and direct funding.

2023-10-02 - VRF Quickstarts and Resources

The Developer Hub has been released. It helps you find resources related to web3 use cases like NFTs and gaming. The Developer Hub includes a comprehensive VRF Resources page that shows a collection of Quickstarts, guides, tutorials, videos, blog posts, courses, documentation, and case studies related to VRF.

A new set of Quickstarts has been released. See all the Quickstarts that involve VRF.

2023-10-23 - Sepolia gas lane increase

For VRF V2 subscription, the Sepolia gas lane has increased from 30 gwei to 150 gwei. The key hash has otherwise remained the same.

2023-10-02 - VRF Quickstarts and Resources

The Developer Hub has been released. It helps you find resources related to web3 use cases like NFTs and gaming. The Developer Hub includes a comprehensive VRF Resources page that shows a collection of Quickstarts, guides, tutorials, videos, blog posts, courses, documentation, and case studies related to VRF.

A new set of Quickstarts has been released. See all the Quickstarts that involve VRF.

2023-07-26 - VRF Cost Calculator

A VRF cost calculator has been added to the Estimating Costs page. Use this calculator to estimate costs for both subscription and direct funding.

2023-06-14 - Arbitrum support and docs expanded

Arbitrum mainnet and Arbitrum Goerli are supported on VRF V2 direct funding. Detailed cost explanations for Arbitrum and a cost estimation code example are available on the Estimating Costs page.

2023-05-19 - Support added for Arbitrum

Arbitrum mainnet and Arbitrum Goerli are supported on VRF V2 subscription.

2023-04-20 - Supported network removed

Klaytn and Klaytn Baobob are no longer supported networks on VRF.

See the currently supported networks for subscription and direct funding.

2023-04-19 - VRF Subscription Manager updated

The VRF Subscription Manager has a new Actions menu that displays actions you can take on a VRF subscription, including funding, cancellation, and adding an email address.

2023-04-12 - Estimating costs page added

Billing and cost information for VRF V2 subscription and direct funding has been consolidated into one Estimating Costs page. Static cost breakdown examples are available for both funding methods.

2023-04-05 - VRF V2 mock contracts added

Mock contracts for local testing are available for VRF V2 subscription and direct funding:

2022-02-16 - VRF V2 is GA

VRF V2 is generally available with new sample contracts for V2.

2021-12-14 - VRF V2 launched

VRF V2 is available along with guides to help you migrate from V1 to V2:

2020-10-22 - VRF V1 is available

VRF V1 is available on Ethereum mainnet.

What's next

Stay updated on the latest Chainlink news