Gelato Network
Search…
⌃K

Execution & Balance Alerts

Automate provides an alerting service to enable you to get notified about your task executions, problems or when your balance is getting low. Alerting currently supports notifications in Telegram and Discord, with other channels on the way.

Types of notifications

Type
Description
Balance
If your task uses Gelato Balance you need to ensure that you always have enough funds deposited, otherwise your executions will stop executing until you top-up. Set a balance alert to be notified when your funds are running low - you can use our default levels or set your own threshold.
Execution Success
Get notified every time your task executes a transaction successfully
Execution Revert
Alerts you if your task executes a transaction but it reverts
Simulation Fail
Alerts you when Automate has identified that your task should be executed but it is failing in simulation and would revert on-chain. These alerts are most suitable for scheduled or resolver tasks.

Setting up Telegram Notifications

You can visit your notifications area to follow the steps listed below.
  1. 1.
    Add GelatoWatcherBot to your Telegram - if you have Telegram installed you can just click on the link to do this.
  2. 2.
    Enter the command /start
  3. 3.
    The bot will show you the main alerts that you can request by entering the command.
Telegram bot will introduce to the main commands it supports
When you enter each command the bot will step you through the inputs required to finish setting up the alert.
You can view the full list of commands at any time by entering /help

Telegram Bot Commands

Command
Usage
/balance
Alerts when your Gelato Balance drops below the minimum balance threshold. The default thresholds are listed here.
The bot will prompt you for the wallet address that you use to create and manage your tasks.
To provide multiple addresses enter each one as a new message to the bot.
If you use the same wallet address across multiple networks, you will be alerted when any of these drop below the default thresholds. If you would like to set your own threshold use the /balance_threshold command.
/balance_threshold
Alerts you when your Gelato Balance drops below the threshold you set on a specific network. After entering the /balance_threshold command the bot will prompt you to specify the chain IDs and your threshold level. Chain IDs are listed here.
For example to be alerted when your Gelato Balance drops below 0.15 ETH on mainnet you would enter 1,0.15
/stop_balance
Switch off all low balance alerts
/simulation_fail
Notifies you when your task is due to be executed but when Gelato simulates the transaction it determines that it will revert when executed on-chain. You will probably need to debug an issue with your target contract. The bot will ask you to send the task id for your task in a new message.
/stop_simulation_fail
Switch off all simulation failure notifications
/exec_success
Notifies each times your task executes a transaction.
/stop_exec_success
Switch of all execution success notifications
/exec_revert
Alerts you to any on-chain reverts when Gelato has executed a transaction for your task.
/stop_exec_revert
Switch of all revert notifications

Discord DM Notifications

In this mode you receive your alerts as DM's to your Discord handle. To activate:
  1. 1.
  2. 2.
    Choose from the list of commands below
If you would prefer to receive alerts in a specific channel please see how to get Discord notifications in your server.
Command
Usage
/balance-dmaddress
Alerts when your Gelato Balance drops below the default threshold for the specified wallet address. The default thresholds are listed below.
To provide multiple addresses enter a new command to the bot for each address.
If you use the same wallet address across multiple networks, you will be alerted when any of these drop below the default thresholds. To set your own threshold use the /balance-threshold-dm command.
/balance-threshold-dm chain_id threshold
Alerts you when your Gelato Balance drops below the threshold you set on a specific network. Use the /balance-dm command to set the address(es) that you would like to monitor. Chain IDs are listed here.
For example to be alerted when your Gelato Balance drops below 0.15 ETH on mainnet you would enter 1 0.15
/stop-balance-dm
Switch off all low balance alerts
/simulation-fail-dmtask_id
Notifies you when your task with the specified task_id is due to be executed but when Gelato simulates the transaction it determines that it will revert when executed on-chain. You will probably need to debug an issue with your target contract.
/stop-simulation-fail-dm
Switch off all simulation failure notifications
/exec-success-dm task_id
Notifies each times your task executes a transaction.
/stop-exec-success-dm
Switch of all execution success notifications
/exec-revert-dm task_id
Alerts you to any on-chain reverts when Gelato has executed a transaction for your task.
/stop-exec-revert-dm
Switch of all revert notifications

Discord notifications in your own server

  1. 1.
    Add our Gelato Bot to your server using this invite link (you need to be admin of the server)
  2. 2.
    If you want to receive notifications in a private channel, make sure to add Gelato Bot as a member in the channel where you want to receive the notification.
  3. 3.
    Enter the following commands in the channel you want to receive alerts.
Command
Usage
/balance-channeladdress
Alerts when your Gelato Balance drops below the default threshold for the specified wallet address. The default thresholds are listed below.
To provide multiple addresses enter a new command to the bot for each address.
If you use the same wallet address across multiple networks, you will be alerted when any of these drop below the default thresholds. To set your own threshold use the /balance-threshold-dm command.
/balance-threshold-channel chain_id threshold
Alerts you when your Gelato Balance drops below the threshold you set on a specific network. Use the /balance-dm command to set the address(es) that you would like to monitor. Chain IDs are listed here.
For example to be alerted when your Gelato Balance drops below 0.15 ETH on mainnet you would enter 1 0.15
/stop-balance-channel
Switch off all low balance alerts
/simulation-fail-channeltask_id
Notifies you when your task with the specified task_id is due to be executed but when Gelato simulates the transaction it determines that it will revert when executed on-chain. You will probably need to debug an issue with your target contract.
/stop-simulation-fail-channel
Switch off all simulation failure notifications
/exec-success-channel task_id
Notifies each times your task executes a transaction.
/stop-exec-success-channel
Switch of all execution success notifications
/exec-revert-channel task_id
Alerts you to any on-chain reverts when Gelato has executed a transaction for your task.
/stop-exec-revert-channel
Switch of all revert notifications

Default Thresholds

Unless overridden these are the default levels that are used for each network.
Network
Chain ID
Default Threshold
Ethereum
1
0.05 ETH
Polygon
137
20 MATIC
Fantom
250
20 FTM
Arbitrum
42161
0.05 ETH
Avalanche
43114
0.5 AVAX
BNB Chain
56
0.05 BNB
Gnosis Chain
100
5 XDAI
Optimism
10
0.05 ETH
Moonbeam
1284
5 GLMR
Moonriver
1285
1 MOVR
Cronos
25
50 CRO
If you need more notifications or new communication channels, your feedback and suggestions are always welcome.