跳转到主要内容
ChainstreamTrigger 节点在 n8n 中实现事件驱动的工作流。该节点不再按计划轮询变更,而是通过 Webhook 从 ChainStream 接收实时事件,在链上事件发生的瞬间启动你的工作流。

工作原理

  1. 当触发器节点处于活动状态时,n8n 会暴露一个 Webhook 端点。
  2. 你在 ChainStream Dashboard 中注册该端点。
  3. 当匹配的链上事件发生时,ChainStream 向该 Webhook 发送 POST 请求。
  4. 触发器节点解析负载并启动工作流。

设置

步骤 1 —— 添加触发器节点

在 n8n 工作流编辑器中:
  1. 点击 Add Node 并搜索 ChainStream Trigger
  2. 将节点拖到画布上作为工作流的第一个节点。
  3. 选择你要监听的 Event Type(参见下表)。

步骤 2 —— 复制 Webhook URL

放置触发器节点后:
  1. 打开节点设置。
  2. 复制顶部显示的 Webhook URL。格式如下:
在生产模式下,请使用 Production URL(而非测试 URL),以确保在工作流编辑器关闭后触发器仍保持活动状态。

步骤 3 —— 在 ChainStream 中注册 Webhook

  1. 在 ChainStream Dashboard 中,前往 Settings > Webhooks
  2. 点击 Create Webhook
  3. 粘贴 n8n 的 Webhook URL。
  4. 选择要订阅的事件类型。
  5. 保存并激活。

步骤 4 —— 测试连接

  1. 在 n8n 中,点击触发器节点上的 Listen for Test Event
  2. 在 ChainStream 中,点击刚创建的 Webhook 上的 Send Test Event
  3. 验证触发器节点是否收到负载。

支持的事件

节点配置

事件负载

token.price.change

token.transfer.large

token.new

trade.activity

示例:大额转账 Telegram 告警

一个完整的工作流,当检测到大额 USDC 转账时发送 Telegram 消息。

故障排除

下一步

n8n 概览

查看 ChainStream n8n 节点中所有可用的资源和操作。

Webhooks API

通过 ChainStream API 以编程方式管理 Webhook 订阅。