Deploy Web3 Actions via Dashboard
This guide shows you how to create a Web3 Action via the Web3 Action builder in the Tenderly Dashboard. Though a practical example, you’ll learn how to create a Web3 Action that logs a message to the console every time 10 blocks get mined on the Mainnet.
Once logged in, create a new Tenderly project or select an existing one where you want to create your Web3 Action.
From the left-hand menu, select Actions, where you’ll see a list of Web3 Actions you’ve already created in your project.
If you recently created a project, the list will be empty and you’ll have to click the Add Action button to create your first Web3 Action.
The process involves three steps:
- Select a trigger type: Choose an on-chain or off-chain event that will trigger the execution of your custom code.
- Specify trigger details: Each pre-defined trigger (event) has its settings. The last step is to configure the trigger itself. For example, for the Block event, you can choose the network to be monitored and the number of blocks to be mined for the event to get triggered.
Choose the event you want the Web3 Action to listen for (the event that will trigger your custom code to run).
For example, run your custom code (outlined in the next step) every time a block is mined on the Rinkeby network.
For example, log the message “Action triggered” to the console **once a block is mined.
Specify the trigger-specific configurations. Each trigger type has different settings. Learn more about Web3 Actions Events and how to configure them.
For the Block trigger type, you need to define two additional parameters: the network (Rinkeby) and the block period (10). This means that our code will get executed every 10th block mined on the Rinkeby network.
In the Info section, add the Web3 Action and title and description. The title and description don’t influence the behavior of your Web3 Actions.
Optionally, you can select where you’d like Tenderly to send you notifications about failed Web3 Actions. To receive email notifications, activate the toggle. While this step is optional, enabling notifications will help give you visibility into why your Web3 Actions are failing and help you build more reliable systems.
When finished, click the Create button to build and deploy your Web3 Action. Once deployed, you’ll be forwarded to the Overview page, where you can stop, upgrade, and delete your Web3 Action.
Monitor the execution of your Web3 Actions by clicking the Execution History tag from the top page menu. This is where you’ll see a log entry for every execution instance of your Web3 Action.
If you prefer to specify action triggers through YAML configuration and have your action functions in your project's code-base, follow the Quickstart on building and deploying a Web3 Action using CLI.
Transaction-triggered Web3 Actions can be built only using the CLI approach.