Skip to main content
本指南演示如何构建一个灵活的监控系统,可以跟踪任何链上事件、处理事务数据并通过 webhook 传递实时通知。通过将 Tenderly Alert 系统强大的触发条件与 Web3Actions 结合,您将创建一个模块化的监控基础设施,可适应任何区块链监控需求,从简单的事件跟踪到复杂的多合约交互。
本指南假定您已拥有 Tenderly 账户并对 Web3Actions 和区块链事件有基本了解。

使用 Web3Actions 进行模块化监控

前提条件

在开始之前,请确保您具备:
  • Node.js(当前支持的最新版本为 v20
  • 已安装 Tenderly CLI
  • 用于接收数据的 webhook 端点
  • 对 TypeScript 的基本理解

系统设置

核心组件

事务处理

系统从处理事务信息开始:
showLineNumbers
此组件:
  • 捕获事务哈希和网络
  • 通过 Tenderly API 获取事务 traces
  • 处理区块信息

合约信息检索

使用 Contracts API 获取合约信息(名称和 ABI)。
showLineNumbers

事件处理

事件处理通过专门的函数进行:
showLineNumbers
此部分:
  • 按名称过滤事件
  • 提取事件参数
  • 处理事件地址

Webhook 交互

系统使用 Axios 将这些结构化数据发送到您的 webhook:
showLineNumbers

故障排除

常见问题及解决方案:
  1. 缺失事件
    • 验证 EVENT_NAME 与合约事件完全匹配
    • 检查 Tenderly dashboard 中的告警配置
    • 查看事务日志以确认事件是否被发出
  2. API 错误
    • 验证 BEARER token 权限
    • 检查 API 端点可用性
    • 验证网络配置
  3. Webhook 问题
    • 确认 WEBHOOK_URL 可访问
    • 检查负载格式是否符合预期
    • 监控 webhook 端点日志