In this tutorial, we'll walk through the process of deploying a Web3 function, creating an automated task, and executing automated actions on the BuildBear Sandbox. By the end of the tutorial, you will get a clear understanding of creating web3 functions and executing automated tasks.<h2>Implementation Path For Creating Web3 Function</h2><ul><li>Choose Trigger Type: Select Trigger Type allows you to choose between time-based, event-based, or every block triggers. In this tutorial, we will be using time based trigger that executes every minute.</li><li>Select Task Type: This option lets you choose between TypeScript Function, Solidity Function, or Transaction types. Typescript Functions are suitable for tasks requiring off-chain data or computations. This tutorial contains a typescript-based function and we will see how to fetch data from API to execute the task.</li><li>Create Web3 Function Task: The task connects your Web3 function to a targeted smart contract for execution. Here every one minute is set in the task to trigger the web3 function.</li><li>Finalize and Monitor Tasks: To make ensure the completion of tasks, one can monitor their outcomes in the explorer. When a task is executed, it provides the IPFS CID of the deployed Web3Function making it available to anyone with CID.</li></ul><h2>Development Setup</h2>To get started, we have set up the following <a href="https://github.com/BuildBearLabs/Gelato-Web3-Functions/tree/master">repo</a> with the required functions. Clone this repository using the commands shown below:<pre><code class="language-plaintext">git clone https://github.com/BuildBearLabs/Gelato-Web3-Functions.git
 cd Gelato-Web3-Functions
 yarn install
</code></pre>Open a code editor like VS Code and explore the folder structure. It includes three main folders:<ul><li>The script folder contains task execution scripts.</li><li>The test folder has functionalities for testing.</li><li>The web3-function folder contains all the web3 functions.</li></ul><h2>Create Your Private Sandbox and install the Gelato plugin</h2>Visit <a href="https://home.buildbear.io/">BuildBear Home</a> to create a new Sandbox. If you are new to BuildBear, refer to our comprehensive documentation to sign up and create your sandbox <a href="https://docs.buildbear.io/docs/intro">here</a>.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_04_29_15_06_17_84fb7ae9ff.png" alt="Screenshot from 2024-04-29 15-06-17.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_04_29_15_06_17_84fb7ae9ff.png 223w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_04_29_15_06_17_84fb7ae9ff.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_04_29_15_06_17_84fb7ae9ff.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_04_29_15_06_17_84fb7ae9ff.png 1000w," sizes="100vw"></figure>Click on the Plugins option from the sandbox dashboard. From the All Plugins tab, select and install the Gelato plugin, once installed it will be visible under installed Plugins.<figure class="image image_resized" style="width:25%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_05_03_09_54_20_57ad6ec641.png" alt="Screenshot from 2024-05-03 09-54-20.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_05_03_09_54_20_57ad6ec641.png 154w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_05_03_09_54_20_57ad6ec641.png 493w," sizes="100vw"></figure>Configure your local environment by creating a <code>.env</code> file containing the private key and RPC URL in the format shown below;<pre><code class="language-plaintext">## Example Private Key and RPC
PRIVATE_KEY=670e8f5f57a3bc4bd1869d473591ff10f6cf0d69a254257b61eca3f244ef188
PROVIDER_URLS= https://rpc.buildbear.io/sanam</code></pre><h2>Creating a Web3 Function</h2>Now, we will look into how can we automate the execution of its function by creating a Web3 Function. Inside the <code>web3-functions</code> folder, there are multiple folder containing various Web3 functions. In this tutorial, we will see how to implement ‘advertising-board’ function. Inside a web3 function, the core functionality is defined over <code>index.ts</code>.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/carbon_11_6444a3d09b.png" alt="carbon (11).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_carbon_11_6444a3d09b.png 105w,https://strapi.buildbear.io/uploads/small_carbon_11_6444a3d09b.png 335w,https://strapi.buildbear.io/uploads/medium_carbon_11_6444a3d09b.png 503w,https://strapi.buildbear.io/uploads/large_carbon_11_6444a3d09b.png 671w," sizes="100vw"></figure>This script defines a Web3Function, which executes on-chain transactions based on off-chain data. Let's break down the script:Web3Function.onRun<ul><li>This function is invoked when the Web3Function is triggered to run. It takes a callback function with a <code>context</code> parameter of type <code>Web3FunctionContext</code>.</li><li>Inside this callback function, the context object provides access to user arguments (<code>userArgs</code>), storage (<code>storage</code>), and a multi-chain provider (<code>multiChainProvider</code>).</li></ul>Provider and Ad Board Contract Initialization<ul><li>The default provider is obtained from the multi-chain provider.</li><li>The address of the Ad Board contract is retrieved from user arguments (<code>userArgs.adBoard</code>) or set to a default value.</li><li>The last post timestamp is retrieved from storage, and if it doesn't exist, it defaults to 0.</li><li>An instance of the Ad Board contract is created using the address and ABI.</li></ul>Post Message Logic<ul><li>Calculates the next allowed post time by adding 1 hour to the last post timestamp.</li><li>Retrieves the current timestamp from the latest block using the provider.</li><li>If the current timestamp is less than the next post time, it returns an object indicating that execution is not allowed yet.</li><li>Attempts to fetch a random quote from the ZenQuotes API. It constructs a message string using the quote author and content if successful.</li><li>If the quote fetch fails, it returns an object indicating the failure.</li><li>Stores the current timestamp as the last post timestamp in storage.</li></ul>Execution Result<ul><li>If the execution is allowed (<code>canExec: true</code>), it constructs an array of call data objects.</li><li>Each call data object specifies the contract address (<code>to</code>) and the encoded function call data (<code>data</code>) for the <code>postMessage</code> function with the generated message as an argument.</li></ul>Return Value<ul><li>The function returns an object with <code>canExec</code> indicating whether execution is allowed, and <code>callData</code> containing the transaction data for contract function calls. If execution is not allowed, it also includes a <code>message</code> field with an explanation.</li></ul>This script essentially defines the logic for a Web3Function that posts a random quote message to an Ad Board smart contract at regular intervals, leveraging off-chain data and on-chain transactions.<h2>Testing Web3 Function Using the Web3 Function command</h2>A quick way to see the results of the Web3 Function, without setting the testing environment is by using the W3f command; &nbsp;you will need to pass the path to our Web3 Function, the chain-id, where we are testing, and the user arguments and storage if any.<pre><code class="language-plaintext">npx w3f test web3-functions/advertising-board/index.ts --logs --chain-id=1
</code></pre><h2>Creating and Executing Task</h2>We have set the Web3 Function, now to execute the task we need to create scripts that are defined in the <code>create-task-ad-board.ts</code> file inside the scripts folder.Note: if Web3 Functions take any arguments, then they should be passed under <code>web3FunctionArgs</code>. In this case, copy and paste the value from <code>userArgs.json</code> the file from advertising-board web3 function. &nbsp;<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/carbon_10_e842c54c63.png" alt="carbon (10).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_carbon_10_e842c54c63.png 164w,https://strapi.buildbear.io/uploads/small_carbon_10_e842c54c63.png 500w,https://strapi.buildbear.io/uploads/medium_carbon_10_e842c54c63.png 750w,https://strapi.buildbear.io/uploads/large_carbon_10_e842c54c63.png 1000w," sizes="100vw"></figure>This script performs the following actions using the Automate SDK and other libraries:Instantiate Provider &amp; Signer:<ul><li>Create a JSON-RPC provider using the specified provider URL.</li><li>Obtain the chain ID by querying the network using the provider.</li><li>Create a wallet instance using the specified private key and provider.</li><li>Instantiate the Automate SDK with the obtained chain ID and wallet.</li></ul>Deploy Web3Function on IPFS:<ul><li>Specify the path to the TypeScript file containing the Web3Function code (<code>index.ts</code> in the "web3-functions/simple" directory).</li><li>Deploy the Web3Function to IPFS using the <code>Web3FunctionBuilder.deploy</code> method.</li><li>Print the IPFS CID (Content ID) of the deployed Web3Function.</li></ul>Create Automate Task:<ul><li>Create an Automate task (batch execution task) using the <code>automate.createBatchExecTask</code> method.</li><li>Provide details such as task name, Web3Function hash (CID), Web3Function arguments, and trigger settings.</li><li>The trigger is set to execute the task at regular intervals (every 60 seconds in this case).</li><li>Wait for the transaction to be mined and print the task ID along with the transaction hash.</li><li>Provide a link to view the task on the Gelato Network beta application.</li></ul>This script essentially deploys a Web3Function to IPFS and creates an Automate task that executes this function at specified intervals.&nbsp;To execute scripts, make sure the account contains enough balance to perform transactions on the network. To fund your account, navigate to your sandbox dashboard and use the faucet to transfer tokens.Run the scripts using the command below:<pre><code class="language-plaintext">ts-node scripts/create-task-ad-board.ts
</code></pre><figure class="image image_resized" style="width:75%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_04_29_11_30_12_89ce5cb001.png" alt="Screenshot from 2024-04-29 11-30-12.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_04_29_11_30_12_89ce5cb001.png 245w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_04_29_11_30_12_89ce5cb001.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_04_29_11_30_12_89ce5cb001.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_04_29_11_30_12_89ce5cb001.png 1000w," sizes="100vw"></figure>This command stores the Web3Function on IPFS and generates a task ID, as illustrated above.Now, navigate to our Sandbox Explorer to inspect the transaction.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_04_29_13_24_39_231dafa127.png" alt="Screenshot from 2024-04-29 13-24-39.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_04_29_13_24_39_231dafa127.png 234w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_04_29_13_24_39_231dafa127.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_04_29_13_24_39_231dafa127.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_04_29_13_24_39_231dafa127.png 1000w," sizes="100vw"></figure>To cancel a task, create a new file inside the scripts folder named ‘cancel-task.ts’ and use the following script to cancel the task which is just executed by passing your TaskID as a string in <code>cancelTask</code> method.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/carbon_9_a2bcea10ad.png" alt="carbon (9).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_carbon_9_a2bcea10ad.png 218w,https://strapi.buildbear.io/uploads/small_carbon_9_a2bcea10ad.png 500w,https://strapi.buildbear.io/uploads/medium_carbon_9_a2bcea10ad.png 750w,https://strapi.buildbear.io/uploads/large_carbon_9_a2bcea10ad.png 1000w," sizes="100vw"></figure>To execute the above cancellation task, run the command below:<pre><code class="language-plaintext">ts-node scripts/cancel-task.ts</code></pre><h1>Conclusion</h1>Congratulations on completing this tutorial and exploring the power of automation in smart contracts using Gelato Web3 Functions on BuildBear Sandbox! Explore all other Web3 Functions in the template and experience the power of automation in smart contracts to enhance DApp capabilities. Leveraging Gelato Web3 Functions using Buildbear sandbox allows developers to automate tasks on DApps effectively and identify any potential issues or optimizations needed before deploying their applications to production.<h1>Simplify DApp development and testing with BuildBear!</h1><a href="https://www.buildbear.io/">BuildBear</a>&nbsp;empowers you with:<ul><li>Instant Sandboxes with replication of mainnet states:&nbsp;Create instant custom sandbox replicating mainnet experience for thorough testing and simulation of real-world scenarios before deployment.</li><li>Dedicated Faucets:&nbsp;Never run out of test funds with built-in faucets for each sandbox.</li><li>Blazing Fast Transactions:&nbsp;Experience lightning-fast transaction speeds for smooth development and testing.</li><li>User-Friendly Explorer:&nbsp;Debug with ease using a clear and intuitive blockchain explorer.</li><li>Plus, many more features:&nbsp;Explore a comprehensive suite of tools and plugin functionalities to streamline your DApp development workflow.</li></ul>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>

image (4).png

In this tutorial, we'll walk through the process of deploying a Web3 function, creating an automated task, and executing automated actions on the BuildBear sandbox. By the end of the tutorial, you will get a clear understanding of creating web3 functions and executing automated tasks.

How To Use Gelato Web3 Functions On BuildBear Sandbox

Let’s get started then, Shall we?

Let’s get started then, Shall we?

Test DApps at Scale.