Chainlink Verifiable Random Function (VRF) is a random number generator for smart contracts. Developers can use Chainlink VRF on BuildBear Sandbox to build and test smart contracts for any decentralized applications that rely on unpredictable outcomes such as in games or lottery systems.In this guide, you'll learn how to request and retrieve random words for your smart contracts and dApps by seamlessly integrating Chainlink VRF into your BuildBear Sandbox.&nbsp;<h1>What can you do with the BuildBear Chainlink Plugin?</h1>The BuildBear Chainlink VRF Plugin lets you integrate Chainlink VRF into your development workflow to request and manage random numbers for your smart contracts and dApps. &nbsp;The plugin's Key Features includes:<ul><li>Subscription Method: Support subscription method to manage multiple consumer contracts with a single subscription account funded with Link tokens.</li><li>Easy Integration: Use your existing Chainlink VRF Subscription or create a new one with ease.</li><li>Multi-Network Support: Supported networks include Ethereum, Sepolia, Arbitrum, Avalanche, BNB, and Polygon.</li></ul>&nbsp;<h1>Step-by-step procedure on using the Chainlink Plugin</h1>In this tutorial, we will use a sample consumer contract that requests random words and receives random words using Chainlink VRF. The consumer contract should be compatible with Chainlink VRF v2.5.<blockquote>Through this plugin we will use our Smart Contract / dApp in a Sandbox Mode, but in the EXACT SAME manner as you would use the Smart Contract / dApp on the Mainnet and that you are NOT using any Mock Values in your script for testing.</blockquote>&nbsp;<h2>1. Create a BuildBear sandbox.</h2>If you are new to BuildBear, refer to our comprehensive documentation to sign up and create your sandbox&nbsp;<a href="https://docs.buildbear.io/docs/intro">here</a>. Visit <a href="https://home.buildbear.io/?">here</a> to create a new Sandbox.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/image_7_f194f7fd3f.png" alt="image (7).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_image_7_f194f7fd3f.png 245w,https://strapi.buildbear.io/uploads/small_image_7_f194f7fd3f.png 500w,https://strapi.buildbear.io/uploads/medium_image_7_f194f7fd3f.png 750w,https://strapi.buildbear.io/uploads/large_image_7_f194f7fd3f.png 1000w," sizes="100vw"></figure>&nbsp;<h2>2. Install the Chainlink VRF plugin.</h2>To install the Chainlink VRF plugin in your Sandbox, go to the dashboard, select the "Plugins" option, and choose the <a href="https://home.buildbear.io/plugins/chainlinkVrf-cf14b24d1b09">Chainlink VRF plugin</a> from the available list. &nbsp;<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/image_8_8b8ec79658.png" alt="image (8).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_image_8_8b8ec79658.png 245w,https://strapi.buildbear.io/uploads/small_image_8_8b8ec79658.png 500w,https://strapi.buildbear.io/uploads/medium_image_8_8b8ec79658.png 750w,https://strapi.buildbear.io/uploads/large_image_8_8b8ec79658.png 1000w," sizes="100vw"></figure><h2>3. Subscribing to VRF and Funding the Subscription</h2>(A) Subscribing&nbsp;One can either use an existing Subscription or set up a new Subscription. BuildBear supports the Chainlink VRF Subscription method for creating a new subscription.To create a new Subscription, call <code>createSubscription()</code> in the <a href="https://docs.chain.link/vrf/v2-5/supported-networks#configurations">VRF Coordinator Contract</a> in your sandbox and secure a Subscription ID. Use the script code below for this:<pre><code class="language-plaintext">// Create subscription
 console.log("[Coordinator] Creating subscription...");
 const subsTx = await vrfCoordinator.connect(signer).createSubscription();
 const subRecipt = await subsTx.wait();
 console.log({ createSubTxnHash: subsTx.hash });
</code></pre>You can also do the same from the BuildBear Explorer by calling the <code>createSubscription</code> function.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_08_22_12_09_09_b070ac5923.png" alt="Screenshot from 2024-08-22 12-09-09.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_08_22_12_09_09_b070ac5923.png 220w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_08_22_12_09_09_b070ac5923.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_08_22_12_09_09_b070ac5923.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_08_22_12_09_09_b070ac5923.png 1000w," sizes="100vw"></figure>If you have an existing <a href="https://docs.chain.link/vrf/v2-5/subscription/create-manage">Chainlink VRF</a> subscription, simply pass the subscription ID in the below script. This allows you to use the existing subscription to request random words from the consumer contract.<pre><code class="language-plaintext">// Using existing subscription
 console.log("[Coordinator] Using existing subscription...");
 const subId = ""// insert your Subscription ID over here
	console.log({subId});
</code></pre>(B) Funding the Subscription&nbsp;Before requesting random numbers from Chainlink VRF, you need to fund your subscription with <code>LINK</code> tokens. If the Subscription is already funded on the mainnet, then your smart contract calls will work on BuildBear Sandboxes without any modification (i.e., exactly as they would function on the mainnet). If the Subscription is NOT funded, you can fund the subscription using the <code>LINK</code> tokens in the exactly same manner as you would do on the mainnet. However, you can use the <a href="https://faucet.buildbear.io">BuildBear Faucet</a> to get the <code>LINK</code> tokens easily.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_08_22_12_13_11_e694a696e0.png" alt="Screenshot from 2024-08-22 12-13-11.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_08_22_12_13_11_e694a696e0.png 245w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_08_22_12_13_11_e694a696e0.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_08_22_12_13_11_e694a696e0.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_08_22_12_13_11_e694a696e0.png 1000w," sizes="100vw"></figure>Once you have the <code>LINK</code> tokens, you have to call the <code>transferAndCall</code> function in the <code>LINK Token Contract</code>. Please note the following in relation to the parameters of the <code>transferAndCall</code> function:(1) <code>value</code> should be in Juel, which is the smallest denomination of LINK and(2) <code>data</code> must be the subscription ID (<code>subId</code>) encoded in ABI format.For your ease, you can use the following script to encode your <code>subId</code> and fund subscription with an actual LINK:<pre><code class="language-plaintext"> //@ts-ignore
 const subId = // insert your Subscription ID over here
 const abiCoder = new ethers.AbiCoder();
 const encodedSubId = abiCoder.encode(["uint256"], [subId]);
 console.log({ subId, encodedSubId });
 
 const linkToken = await ethers.getContractAt(
 "LinkTokenInterface",
 linkTokenAddr
 );
 const value = 50;
 console.log(`Transferring ${value} LINK to subscription...`);
 const linkTxn = await linkToken
 .connect(user)
 .transferAndCall(mainnetVRFCoordinatorAddr, BigInt(value * 1e18), encodedSubId);
 await linkTxn.wait();
</code></pre><h2>4. Deploy a Smart Contract that will request the Random Numbers (consumer contract) {Sample Smart Contract below}</h2><figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/carbon_1_1_b41f219f8c.png" alt="carbon (1) (1).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_carbon_1_1_b41f219f8c.png 83w,https://strapi.buildbear.io/uploads/small_carbon_1_1_b41f219f8c.png 267w,https://strapi.buildbear.io/uploads/medium_carbon_1_1_b41f219f8c.png 401w,https://strapi.buildbear.io/uploads/large_carbon_1_1_b41f219f8c.png 535w," sizes="100vw"></figure>Deploy consumer contracts with the newly created Subscription ID, VRF Coordinator address, and key hash (make sure to change the VRF Coordinator Address and the key hash value according to the network. You can find the list of supported networks, the corresponding values of the VRF Coordinator address, and the key hash <a href="https://docs.chain.link/vrf/v2-5/supported-networks#configurations">here</a>). For the purpose of this tutorial, we will be using the Ethereum Mainnet.&nbsp;Refer to the complete sample <a href="https://github.com/BuildBearLabs/chainlink-vrf-demo/tree/main">repo</a> and <a href="https://github.com/BuildBearLabs/chainlink-vrf-demo/blob/main/scripts/vrf-consumer.ts">script</a> for requesting and checking random words.&nbsp;<pre><code class="language-plaintext">const consumerMock = await ethers.deployContract(
 "RandomNumberConsumerV2_5",
 [
 subId,
 mainnetVRFCoordinatorAddr, // insert address of the VRF Coordinator based on your network
 "0x787d74caea10b2b357790d5b5247c2f63d1d91572a9846f780606e4d953677ae",
 ],
 user
 );
 await consumerMock.waitForDeployment();
 console.log(`VRF Consumer Mock deployed to ${consumerMock.target}`);
 const consumerAddr = consumerMock.target;
</code></pre>After deploying the consumer contract, the next steps are to add the contract to the coordinator contract, request random words from the consumer contract, and finally fulfill and verify the random words.&nbsp;1. Add the Consumer to the CoordinatorThis step is crucial to register the consumer contracts to the coordinator for requesting random words.<pre><code class="language-plaintext">const addCosumerTx = await updatedCoordinator
 .connect(user)
 .addConsumer(subId, consumerAddr);
 await addCosumerTx.wait();
</code></pre><figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_08_22_12_26_14_71229c77b9.png" alt="Screenshot from 2024-08-22 12-26-14.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_08_22_12_26_14_71229c77b9.png 245w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_08_22_12_26_14_71229c77b9.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_08_22_12_26_14_71229c77b9.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_08_22_12_26_14_71229c77b9.png 1000w," sizes="100vw"></figure>&nbsp;2. Request Random WordsHere we request random numbers from Chainlink VRF by calling the <code>requestRandomWords()</code> function on the consumer contract.<pre><code class="language-plaintext"> const requestRandomnessTx = await consumerMock
 .connect(user)
 .requestRandomWords();
 await requestRandomnessTx.wait();

 const reqId = await consumerMock.connect(user).s_requestId();
 console.log({ reqId });
</code></pre><figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_08_22_12_28_28_668fee3f99.png" alt="Screenshot from 2024-08-22 12-28-28.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_08_22_12_28_28_668fee3f99.png 245w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_08_22_12_28_28_668fee3f99.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_08_22_12_28_28_668fee3f99.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_08_22_12_28_28_668fee3f99.png 1000w," sizes="100vw"></figure>&nbsp;3. Fulfill and Check Random wordsAutomatically fulfills random words and retrieves them without any additional steps. Here is the scrip fetching random words:<pre><code class="language-plaintext"> 	await new Promise((resolve) =&gt; setTimeout(resolve, 60000));
 console.log("Finished sleeping.");

 // Check random word
 console.log("[Consumer] Checking random word...");
 let randomWord = await consumerMock.connect(user).s_randomWords(0);
 console.log({ randomWord });
 randomWord = await consumerMock.connect(user).s_randomWords(1);
 console.log({ randomWord });
</code></pre>The successful output of the random words is as shown below:<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Untitled_15_750a7d059b.png" alt="Untitled (15).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_15_750a7d059b.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_15_750a7d059b.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_15_750a7d059b.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_15_750a7d059b.png 1000w," sizes="100vw"></figure><h1>Conclusion</h1>Follow the steps above to easily integrate Chainlink VRF into BuildBear Sandbox for obtaining random words into your contracts. Install the Chainlink plugin to build and test innovative applications on web3 that require randomness before mainnet deployment.<h1 style="margin-left:0px;">About BuilBear:</h1><a href="https://www.buildbear.io/">BuildBear</a>&nbsp;is a platform tailored for DApp development and testing. Developers gain the freedom to construct a personalized Private Testnet sandbox across a variety of blockchain networks. The liberty to mint unlimited Native and ERC20 tokens, coupled with rapid transaction times on BuildBear (under 3 seconds!), enhances the DApp development lifecycle manifold. The platform comes equipped with tools and plugins designed for real-time testing and debugging, ensuring developers can keep tabs on intricate blockchain transactions with unparalleled ease.Connect with us on&nbsp;<a href="https://twitter.com/_BuildBear">Twitter</a>&nbsp;|&nbsp;<a href="https://www.linkedin.com/company/build-bear/">LinkedIn</a>&nbsp;|&nbsp;<a href="https://t.me/Web3_dApp_Developers">Telegram</a>&nbsp;|&nbsp;<a href="https://github.com/BuildBearLabs">GitHub</a>&nbsp;

Screenshot from 2024-08-30 15-53-35.png

Chainlink Verifiable Random Function is a random number generator for smart contracts. Developers can use Chainlink VRF to build reliable smart contracts for any applications that rely on unpredictable outcomes such as in games or lottery systems.

How to Use Chainlink VRF | Beginner Friendly

BUILDBEAR // TUTORIALS

How to Use Chainlink VRF | Beginner Friendly

Let’s get started then, Shall we?

Let’s get started then, Shall we?

Test DApps at Scale.