Do I need a paid plan to use Web3 Actions?
Yes. Web3 Actions are available on the paid plan. To enable them for your account, contact our sales team to schedule a call and discuss upgrading your plan.
What’s the difference between parallel and sequential execution?
During configuration of your Web3 Action, you can choose between the two modes of execution.When there’s several triggered Web3 Actions (e.g. transactions from the same block), these two modes behave in the following way:
- sequential: execution will respect the order in which the triggers have happened; until completion of trigger
N-1, triggerNis awaiting for execution. The order of execution is guaranteed. - parallel: all triggers will be submitted for execution, and the execution order can not be guaranteed.
execution_type.Strict ordering is best-effort under sustained load: if a sequential action keeps lagging behind its triggers, Tenderly may switch it to parallel execution to catch up and notifies you by email when that happens.Different rate limits apply.What’s the difference between WRITE, COPY ON WRITE, and EMPTY storage types?
- Write: This type is selected by default. It’s always used in automatic triggers and writes data on the
main storage. Please note that this type can potentially overwrite data on the main storage.
- Copy on write: This type creates a copy of the main storage as temporary storage. It can be selected for manual triggers. Once a trigger stops running, everything that was written in the temporary storage won’t be saved.
- Empty: This type creates temporary empty storage. It can be selected for manual triggers. The empty storage type doesn’t have any reference to the main storage. Once a trigger stops running, everything that was written on this type of storage will disappear.
Do contracts need to be verified to be used in Web3 Actions?
Yes, contracts need to be verified and added to your project on Tenderly to be used in Web3 Action triggers.
Otherwise, the CLI will throw an error.Learn more about triggers and how they work
here.
What is the allowed number of Web3 Actions per project?
The number of Web3 Actions you can run depends on your plan capacity. Contact our sales team to discuss the capacity your project needs.
What is the storage limit?
Storage allows up to 1,000 keys per project, with a maximum key size of 1 KB and a maximum value size of 100 KB. Exceeding a limit returns a
400 Bad Request error stating which limit was violated. See Storage limits.Can the Web3 Actions storage limits be increased?
The 100 KB per-value limit is a hard limit of the underlying storage engine and cannot be raised. If a single item needs more space, split it across multiple keys, or keep it in an external database and store its credentials in Secrets. If you’re approaching the 1,000-key project limit, contact support@tenderly.co.
What’s the size limit to the Web3 Action project?
When you create a Web3 Action using the CLI, the entire NPM project will be zipped and uploaded to Tenderly.
The maximum size of the zipped archive, including
node_modules is 40 MB.What is the execution timeout for Web3 Actions?
Execution is limited to 30 seconds by default, at which point it’s terminated. If more time is needed, contact our support team at support@tenderly.co to discuss your use case. Extended time limits apply only to parallel actions; sequential executions keep the 30-second limit. Get more information on the execution status types.
I have a tenderly.yaml file with two Web3 Actions with the same trigger (a certain contract event). Will the first action declared in the manifest file always be invoked before the second one?
Two separate Web3 Actions with the same trigger are executed in parallel since they’re isolated entities unaware
of one another.
What’s available in Web3 Actions Runtime?
How do Web3 Actions interact with blockchain data?
Web3 Actions can interact with blockchain data by reading blocks, transactions, and logs, enabling smart contract monitoring.
Example:Learn more →
What are the trigger types available for Web3 Actions?
Web3 Actions support four trigger types, which define when the action should be executed:Learn more →
- Block: triggered by new blocks on the blockchain, ideal for block-level monitoring.
- Transaction: triggered by specific blockchain transactions, enabling monitoring and custom reactions.
- Webhook: triggered by incoming HTTP requests, allowing Web3 Actions to act as backends for dapps or other services.
- Periodic (CRON): runs at specific intervals, automating recurring tasks. Example:
How do I deploy Web3 Actions?
Web3 Actions can be deployed via the Tenderly Dashboard or using the CLI. The CLI provides more advanced configuration options. Actions and their triggers are configured in the Learn more →
tenderly.yaml file; the deploy command takes no flags:How are errors handled in Web3 Actions?
Errors in Web3 Actions are logged and can be viewed in the Tenderly Dashboard. Failed actions can be re-executed for further debugging.Learn more →
Why didn’t I get an email when my Web3 Action failed?
Failure emails are sent only when a new incident is created: the first time a given error occurs for the current version of your Action, on a trigger-based run. Check the following:
- Repeated occurrences of the same error are grouped under the existing incident and don’t send additional emails until the incident is resolved in Error Reporting.
- Manual runs and re-runs never send failure emails or create incidents, regardless of outcome.
- Executions ending in
TIMED_OUT,RATE_LIMITED, orTU_QUOTA_REACHEDdon’t send failure emails. - The destination email must be verified and switched on in the Action’s Destinations section.
What’s the rate limit for Web3 Actions?
Rate limits apply per action: 400 executions per 5 minutes for sequential actions and 2000 executions per 5 minutes for parallel actions, customizable per quote.Learn more →
I received an “action reached a rate limit” email. What does it mean?
The action was triggered more often than its per-action execution rate limit allows. Executions above the limit were skipped: they appear as
RATE_LIMITED in the execution history and are not retried. The notification is batched, so you receive at most one such email per action per 24 hours. If your workload needs a higher rate, contact support@tenderly.co.What is key-value storage in Web3 Actions?
Key-value storage allows Web3 Actions to persist state and data between executions. For sensitive information like API keys, use secrets instead.
Example:Learn more →
What are common use cases for Web3 Actions?
Common use cases include monitoring blockchain transactions, automating tasks, and building webhook backends for dapps.Learn more →
Can Web3 Actions be tested locally?
Yes, using the Learn more →
@tenderly/actions-test npm package, Web3 Actions can be tested locally. Install it with npm install --save-dev @tenderly/actions-test, then execute your action function through the TestRuntime:What are the supported programming languages for Web3 Actions?
Web3 Actions are written in JavaScript or TypeScript.
Example:
How can I manage secrets in Web3 Actions?
You can securely store and retrieve sensitive data, such as API keys, using the secrets management feature.
Example:Learn more →
Can Web3 Actions interact with external APIs?
Yes, you can interact with external APIs using libraries such as Axios for HTTP requests.
Example:Learn more →
What is the purpose of simulations in Web3 Actions?
Web3 Actions can run transaction simulations to test and verify outcomes before broadcasting transactions.
Example:Learn more →
How does Tenderly handle logs for Web3 Actions?
Tenderly logs every execution of Web3 Actions. Logs can be accessed and reviewed on the Tenderly Dashboard for debugging.