Chainlink VRF Release Notes
2024-08-15 - VRF V2.5 on BASE
VRF V2.5 is available on BASE mainnet and BASE Sepolia testnet. See the VRF V2.5 Supported Networks page to get configuration details for both subscription and direct funding.
2024-07-15 - VRF V2 and V1 Deprecation Announcement
VRF V2 and V1 will be deprecated on November 29, 2024. Please migrate to VRF V2.5 before then.
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-05-07 - VRF v2.5
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 support 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-02 - 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.