На уровне проекта

​

Web3 Actions

trigger:
  type: alert
  alert: {}

​

Webhooks

​

Требования к webhook:

• Он должен быть доступен по URL webhook: при добавлении webhook Tenderly отправляет GET-запрос для проверки доступности. Любой HTTP-ответ проходит проверку; проверка не проходит только при транспортных ошибках (DNS, TCP, TLS или отсутствие ответа в течение 2 секунд).
• Он должен предоставлять метод POST с тем же URI webhook. Webhook будет получать полезную нагрузку, описанную ниже.
• Доставка считается неуспешной, если webhook не ответит статусом 2xx в течение 10 секунд.
• Настоятельно рекомендуется использовать HTTPS для URL webhook.

• Success: webhook успешно выполнен и событие доставлено на указанный URL
• Failed: webhook не удалось выполнить из-за ошибки, такой как проблема с соединением, ошибка в URL и т. д. (проверьте содержимое ответа, чтобы понять причину ошибки, или обратитесь в нашу поддержку)
• Pending: webhook находится в процессе выполнения и ещё не завершён
• Retry: выполнение webhook не удалось и будет повторено; событие доставляется максимум за 5 попыток всего, после чего статус становится Success или Failed
• Skipped: webhook не был выполнен, поскольку был отключён

​

Полезная нагрузка webhook

• id: String, ID, уникальный среди всех доставленных событий оповещений (UUID).
• event_type: TEST | ALERT, тип события webhook.
• alert_id: String, ID оповещения, правило которого вызвало это событие. Пусто для событий TEST.
• transaction: Object, объект, представляющий недекодированную транзакцию, вызвавшую оповещение и выполнение webhook.

​

Защита webhook

1. всю полезную нагрузку запроса webhook,
2. метку времени (из заголовка Date запроса).

func isValidSignature(
  signature string,
  payload []byte,
  timestamp string,
) bool {
  h := hmac.New(sha256.New, []byte(signingKey))
  h.Write(payload)
  h.Write([]byte(timestamp))
  digest := hex.EncodeToString(h.Sum(nil))
  return digest == signature
}

function isValidSignature(signature, payload, timestamp) {
  // Create a HMAC SHA256 hash using the signing key
  const hmac = crypto.createHmac("sha256", signingKey);

  // Update the hash with the request body using utf8
  hmac.update(payload.toString(), 'utf8');

  // Update the hash with the request timestamp
  hmac.update(timestamp);
  const digest = hmac.digest("hex");
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(digest))
}

def isValidSignature(signature: string, payload: bytes, timestamp: string):
    h = hmac.new(str.encode(signingKey), payload, hashlib.sha256)
    h.update(str.encode(timestamp))
    digest = h.hexdigest()
    return hmac.compare_digest(signature, digest)

​

Отладка выполнения webhook