Типы оповещений, цели и параметры

Чтобы создать и включить оповещение, необходимо указать и настроить следующие компоненты:

• Тип оповещения (Alert Type): on-chain событие, которое запускает отправку уведомления от Tenderly. Есть 12 триггеров оповещений на выбор.
• Цель оповещения (Alert Target): адрес или адреса, которые вы хотите отслеживать. Опции Target одинаковы для всех типов оповещений и включают:
  • Address: отслеживание одного адреса.
  • Network: отслеживание всех адресов, развёрнутых в выбранной сети.
  • Project: отслеживание всех адресов, входящих в проект в Tenderly.
  • Tag: отслеживание всех контрактов и кошельков с указанным тегом.
• Параметры оповещения (Alert Parameters): дополнительные настройки, специфичные для выбранного типа оповещения.
• Назначение оповещения (Alert Destination): место, куда вы хотите получать уведомления. Одно оповещение может отправлять уведомления на несколько назначений. Есть 8 назначений, куда можно отправлять и получать уведомления.

Далее в этом документе рассматриваются различные типы оповещений.

​

Successful Transaction

Оповещение Successful Transaction отправляет уведомление, когда новая транзакция создаётся и добавляется в блокчейн. Это оповещение обычно используется для отслеживания транзакций, вызывающих определённый смарт-контракт, или транзакций, отправленных или полученных определённым кошельком. Чтобы создать оповещение Successful Transaction, выполните следующие шаги:

1. Выберите Successful Transaction из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать один адрес.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Установите назначение (Destination), создав новое или выбрав ранее созданное.
5. Нажмите Save, чтобы получать уведомления при успешном прохождении транзакции.

​

Failed Transaction

Оповещение Failed Transaction отправляет уведомление, когда транзакцию не удаётся добавить в блокчейн. Оповещение обычно используется для раннего обнаружения проблем эксплуатации кошельков, смарт-контрактов и dapp’ов. Чтобы создать оповещение Failed Transaction, выполните следующие шаги:

1. Выберите Failed Transaction из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать один адрес.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Установите назначение (Destination), создав новое или выбрав ранее созданное.
5. Нажмите Save, чтобы получать уведомления, когда транзакция завершается неудачно.

​

Function Call

Оповещение Function Call отправляет уведомление, когда определённая external или public функция вызывается из выбранного смарт-контракта. Уведомления будут отправлены при первом вызове функции в транзакции и каждый раз, когда она вызывается в ходе выполнения через внутренние вызовы. Чтобы создать оповещение Function Call, выполните следующие шаги:

1. Выберите Function Call из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Выберите функцию, которую хотите отслеживать. Tenderly извлечёт все доступные функции из смарт-контракта.
5. Установите назначение (Destination), создав новое или выбрав ранее созданное.
6. Нажмите Save, чтобы получать уведомления при вызове функции из вашего смарт-контракта.

​

Event Emitted

Оповещение Event Emitted отправляет уведомление, когда выбранный смарт-контракт генерирует определённое событие. Например, вы можете использовать это оповещение для отслеживания ERC-20 токена и получения уведомления, когда сторонний адрес получает разрешение тратить баланс. Чтобы создать оповещение Event Emitted, выполните следующие шаги:

1. Выберите Event Emitted из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Выберите функцию события, которую хотите отслеживать, из списка доступных событий.
5. Установите назначение (Destination), создав новое или выбрав ранее созданное.
6. Нажмите Save, чтобы получать уведомления, когда функция события генерирует событие.

​

Event Parameter

Оповещение Event Parameter отправляет уведомление, когда аргумент события соответствует заданным условиям. Например, вы можете использовать это оповещение для отслеживания ERC-20 токена и получения уведомления, когда сторонний адрес получает разрешение тратить баланс выше порогового значения. Чтобы создать оповещение Event Parameter, выполните следующие шаги:

1. Выберите Event Parameter из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Выберите функцию события, которую хотите отслеживать, из списка доступных событий.
5. Выберите аргумент из списка аргументов, которые требуются выбранной функции события. Некоторые события могут иметь несколько аргументов. Tenderly автоматически подтянет все требуемые аргументы.
6. Выберите оператор сравнения (например, равно, не равно и т. д.).
7. Введите значение для сравнения (например, целое число, адрес и т. д.), с которым вы хотите сравнить значение аргумента.
8. Установите назначение (Destination), создав новое или выбрав ранее созданное.
9. Нажмите Save, чтобы получать уведомления, когда аргумент функции события соответствует заданным вами условиям.

​

ERC20 Token Transfer

Оповещение ERC20 Token Transfer отправит вам уведомление, когда из смарт-контракта генерируется событие ERC-20 transfer. Это оповещение полезно, когда вы хотите отслеживать переводы токенов с одного адреса на другой. Чтобы создать оповещение ERC-20 Token Transfer, выполните следующие шаги:

1. Выберите ERC20 Token Transfer из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Задайте направление: токены приходящие на или уходящие с выбранного адреса.
5. Введите адрес, соответствующий направлению.
6. Установите назначение (Destination), создав новое или выбрав ранее созданное.
7. Нажмите Save, чтобы получать уведомления при возникновении события перевода ERC-20 токена.

​

Allowlisted Callers

Оповещение Allowlisted Callers позволяет добавлять известные адреса и получать уведомления только тогда, когда адреса, отсутствующие в списке, вызывают смарт-контракт. Чтобы создать оповещение Allowlisted Callers, выполните следующие шаги:

1. Выберите Allowlisted Callers из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Введите адреса, которые вам знакомы и которые вы хотите исключить из мониторинга.
5. Установите назначение (Destination), создав новое или выбрав ранее созданное.
6. Нажмите Save, чтобы получать уведомления, когда кто-то вне созданного вами списка адресов вызывает ваш смарт-контракт.

​

Blocklisted Callers

Оповещение Blocklisted Caller позволяет добавлять нежелательные адреса и получать уведомление только тогда, когда эти адреса отправляют транзакцию выбранной цели (Target). Это оповещение можно использовать для отслеживания попыток вызова вашего multisig-кошелька или контракта неавторизованными адресами. Чтобы создать оповещение Blocklisted Callers, выполните следующие шаги:

1. Выберите Blocklisted Callers из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт или кошелёк, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта из выпадающего списка.
4. Введите адреса, за которыми хотите следить и получать уведомления, когда они выполняют действия с вашим смарт-контрактом или кошельком.
5. Установите назначение (Destination), создав новое или выбрав ранее созданное.
6. Нажмите Save, чтобы получать уведомления, когда кто-то из созданного вами списка адресов вызывает ваш смарт-контракт.

​

Balance Change

Оповещение Balance Change уведомляет, когда баланс нативной валюты сети конкретного адреса соответствует условиям после выполнения транзакции. Это оповещение может быть полезно, чтобы знать, когда нужно пополнить кошелёк (например, ботов или keeper’ов). Чтобы создать оповещение Balance Change, выполните следующие шаги:

1. Выберите Balance Change из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт или кошелёк, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта или кошелька из выпадающего списка.
4. Выберите оператор сравнения (например, равно, не равно и т. д.).
5. Задайте пороговое значение баланса в wei. Оповещение срабатывает только тогда, когда транзакция устанавливает баланс адреса в значение, удовлетворяющее заданным условиям. Оно не срабатывает, когда баланс уже находится в состоянии выполненных условий.
6. Установите назначение (Destination), создав новое или выбрав ранее созданное.
7. Нажмите Save, чтобы получать уведомления, когда баланс нативной валюты сети на вашем смарт-контракте или кошельке соответствует заданным вами условиям порогового значения.

​

Transaction Value

Оповещение Transaction Value уведомляет вас, когда значение транзакции, в которой участвует кошелёк или смарт-контракт, соответствует некоторому значению в wei. Чтобы создать оповещение Transaction Value, выполните следующие шаги:

1. Выберите Transaction Value из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт или кошелёк, развёрнутый по конкретному адресу.
3. Выберите оператор сравнения (например, равно, больше чем и т. д.).
4. Введите значение в wei, с которым вы хотите сравнивать.
5. Установите назначение (Destination), создав новое или выбрав ранее созданное.
6. Нажмите Save, чтобы получать уведомления, когда значение транзакции, исходящей от кошелька или смарт-контракта, соответствует указанному вами значению в wei.

​

State Change

Оповещение State Change уведомляет вас об изменении числовой (int/uint) переменной состояния в смарт-контракте. С этим оповещением вы можете получать уведомления, когда количество требуемых подтверждений в multisig увеличивается или уменьшается. Аналогично можно наблюдать за любой другой конфигурационной переменной состояния смарт-контракта. Чтобы создать оповещение State Change, выполните следующие шаги:

1. Выберите State Change из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт или кошелёк, развёрнутый по конкретному адресу.
3. Выберите переменную состояния смарт-контракта, которую хотите отслеживать.
4. Настройте дополнительные параметры для выбранной переменной состояния. В зависимости от типа данных переменной состояния необходимо настроить дополнительные параметры, чтобы указать Tenderly, как сравнивать значение свойства переменной состояния с тем, что вы хотите:
   • Threshold passed: срабатывает, когда значение свойства проходит порог. Вы получите только одно оповещение каждый раз, когда значение проходит порог.
   • Percentage change: срабатывает, когда значение свойства увеличивается или уменьшается на заданный процент.
   • Criteria: срабатывает, когда новое значение свойства, установленное транзакцией, соответствует критериям сравнения.
   • Value changed: срабатывает всякий раз, когда меняется значение свойства.
5. Установите назначение (Destination), создав новое или выбрав ранее созданное.
6. Нажмите Save, чтобы получать уведомления при изменении переменной состояния в смарт-контракте.

​

View Function

Оповещение View Function уведомляет вас, когда возвращаемое значение выбранной view-функции в смарт-контракте изменяется транзакцией. Например, вы можете отслеживать, когда баланс определённого адреса ERC-20 токена изменяется, используя view-функцию balanceOf('0x...'). Чтобы создать оповещение View Function, выполните следующие шаги:

1. Выберите View Function из списка типов оповещений.
2. В разделе Target выберите Address, чтобы отслеживать смарт-контракт или кошелёк, развёрнутый по конкретному адресу.
3. Выберите адрес смарт-контракта.
4. Из списка объявленных view-функций выберите view-функцию, которую хотите отслеживать. Вам нужно будет указать любые аргументы, которые может потребовать view-функция.
5. Настройте дополнительные параметры в зависимости от типа данных, возвращаемого view-функцией.
   1. Threshold passed: определите порог и получайте уведомления, когда возвращаемое значение проходит пороговое значение. Также необходимо определить тип оператора сравнения (меньше чем, равно и т. д.) и значение, с которым делать сравнение. Вы получите только одно оповещение каждый раз, когда значение проходит порог.
   2. Percentage change: определите процент и получайте уведомления, когда значение изменяется на определённый процент. Также необходимо определить тип оператора сравнения и значение, с которым делать сравнение.
   3. Criteria: определите любой тип критериев с использованием разных операторов сравнения и получайте уведомления, когда критерии выполнены.
   4. Value changed: получайте уведомления всякий раз, когда возвращаемое значение изменяется любым образом.
6. Установите назначение (Destination), создав новое или выбрав ранее созданное.
7. Нажмите Save, чтобы получать уведомления, когда возвращаемое значение выбранной вами view-функции изменяется по сравнению с предыдущим блоком.