Модульный мониторинг с Web3 Actions - Tenderly

Это руководство демонстрирует, как построить гибкую систему мониторинга, которая может отслеживать любое on-chain событие, обрабатывать данные транзакций и доставлять уведомления в реальном времени через webhook. Объединяя мощные критерии триггеров системы Alert Tenderly с Web3 Actions, вы создадите модульную инфраструктуру мониторинга, способную адаптироваться под любые потребности мониторинга блокчейна — от простого отслеживания событий до сложных мультиконтрактных взаимодействий.

В этом руководстве предполагается, что у вас есть аккаунт Tenderly и базовое знакомство с Web3 Actions и событиями блокчейна.

Модульный мониторинг с Web3 Actions

Предварительные требования

Перед началом убедитесь, что у вас есть:

Node.js (в настоящее время в качестве последней версии поддерживается v20)
Установленный Tenderly CLI
Конечная точка webhook для получения данных
Базовое понимание TypeScript

Настройка системы

Основные компоненты

Обработка транзакции

Система начинает с обработки информации о транзакции:

showLineNumbers

export const modularFn = async (context: Context, transactionEvent: TransactionEvent) => {
  const txHash = transactionEvent.hash;
  const txNetwork = transactionEvent.network;

  const blockHash = transactionEvent.blockHash;
  const blockNumber = transactionEvent.blockNumber;

  const WEBHOOK_URL = await context.secrets.get("WEBHOOK_URL");
  const BEARER = await context.secrets.get("BEARER");
  const ACCOUNT_SLUG = await context.secrets.get("ACCOUNT_SLUG");
  const PROJECT_SLUG = await context.secrets.get("PROJECT_SLUG");
  const EVENT_NAME = await context.secrets.get("EVENT_NAME");

  if (!EVENT_NAME) {
    throw new Error("EVENT_NAME not found in environment variables");
  }

  const url = `https://api.tenderly.co/api/v1/public-contract/${txNetwork}/trace/${txHash}`;

  const traceResponse = await axios.get(url, {
    headers: {
      authorization: BEARER,
    },
  });

  const traceData = traceResponse.data;

Этот компонент:

Захватывает хеш транзакции и сеть
Получает трейсы транзакции через Tenderly API
Обрабатывает информацию о блоке

Получение информации о контракте

Информация о контракте (имена и ABI) получается с помощью Contracts API.

showLineNumbers

const fetchContractName = async (addr: string) => {
  const contractEndpoint = `https://api.tenderly.co/api/v1/account/${ACCOUNT_SLUG}/project/${PROJECT_SLUG}/contract/${txNetwork}/${addr}`;

  try {
    const contractResponse = await axios.get(contractEndpoint, {headers: {'Authorization': BEARER}});
    return contractResponse.data.contract.contract_name;
  } catch (error) {
    console.error(`Error fetching contract name from endpoint for ${addr}:`, error);
  }
};

const fetchContractAbi = async (addr: string) => {
  const contractEndpoint = `https://api.tenderly.co/api/v1/account/${ACCOUNT_SLUG}/project/${PROJECT_SLUG}/contract/${txNetwork}/${addr}`;

  try {
    const contractResponse = await axios.get(contractEndpoint, {headers: {'Authorization': BEARER}});
    return contractResponse.data.contract.data.abi;
  } catch (error) {
    console.error(`Error fetching contract ABI from endpoint for ${addr}:`, error);
  }
};

Обработка событий

Обработка событий выполняется с помощью специализированных функций:

showLineNumbers

const extractEventAddresses = (logs: any[]): string[] =>
  Array.from(new Set(
    logs
      .filter(log => log.name === EVENT_NAME)
      .map(log => log.raw.address)
  ));

const extractEventDetails = (logs: any[]) => {
  return logs
    .filter(log => log.name === EVENT_NAME)
    .map(log => {
      const result: { [key: string]: string } = {
        name: log.name
      };

    log.inputs.forEach((input: any) => {
      const name = input.soltype.name;
      const value = input.value.toString();
      result[name] = value;
    });

    return result;
  });
};

Этот раздел:

Фильтрует события по имени
Извлекает параметры события
Обрабатывает адреса событий

Взаимодействие с webhook

Система отправляет эти структурированные данные на ваш webhook с помощью Axios:

showLineNumbers

{
  hash: string,              // Transaction hash
  transaction: object,       // Full transaction event
  blockHash: string,        // Block hash
  blockNumber: number,      // Block number
  matchReasons: Array<{     // Event details
    name: string,
    [parameterName: string]: string
  }>,
  sentinel: {               // Contract information
    contractName: string,
    abi: object
  },
  traceData: object,        // Transaction trace data
  addresses: string[]       // Involved addresses
}

Устранение неполадок

Распространённые проблемы и решения:

Пропущенные события
- Убедитесь, что EVENT_NAME точно соответствует событиям контракта
- Проверьте конфигурацию оповещения в панели Tenderly
- Просмотрите логи транзакции на предмет генерации события
Ошибки API
- Проверьте права токена BEARER
- Проверьте доступность endpoint API
- Проверьте настройки сети
Проблемы с webhook
- Убедитесь в доступности WEBHOOK_URL
- Проверьте, что формат полезной нагрузки соответствует ожиданиям
- Отслеживайте логи endpoint’а webhook

⌘I