SuperAPI AI 工具集

alchemy-webhooks

测试与质量

查看项目

更新于 10-16 09:56

技能介绍

用途:该技能帮助接收并验证 Alchemy Notify 发来的 webhook,适用于搭建 Alchemy webhook 处理器、排查 X-Alchemy-Signature 验证失败,以及处理链上活动事件。

主要能力:说明签名机制——Alchemy 对原始请求体做 HMAC-SHA256 并以十六进制放入 X-Alchemy-Signature 头,无 sha256= 前缀、无时间戳,密钥是每个 webhook 的 signing key(取自 Notify 面板该 webhook 详情页右上角,或经 Notify API 获取),不是应用的 Auth Token。alchemy-sdk 只管 webhook 增删改查,不负责验签,需自行实现 HMAC;必须对原始 body 计算,重新序列化的 JSON 不匹配。技能还整理常见事件类型:ADDRESS_ACTIVITY、NFT_ACTIVITY、GRAPHQL,并指出 MINED_TRANSACTION、DROPPED_TRANSACTION、NFT_METADATA_UPDATE 自 2026-08-30 起已不再出现在文档中,示例仍保留分支但不应据此新建集成。

使用方式:设置环境变量 ALCHEMY_SIGNING_KEY(每个 webhook 的签名密钥)与可选的 ALCHEMY_AUTH_TOKEN(用于 Notify API 或 alchemy-sdk 编程式管理)。示例处理程序见 examples/express/、examples/nextjs/、examples/fastapi/。本地开发可执行 npx hookdeck-cli listen 3000 alchemy --path /webhooks/alchemy 建立隧道,并把得到的 URL 配置为 Notify 面板中的 webhook 目标;可选放行 Alchemy 出口 IP:54.236.136.17 和 34.237.24.169。

适用场景与限制:适合需要接收链上活动通知的服务端集成。签名校验须用恒定时间比较,长度不符视为无效。建议配合 webhook-handler-patterns 技能,遵循先验证、再解析、后幂等处理,并用 webhook id 防重复;重试为指数退避,最多约 10 分钟(Free/PAYG)或约 1 小时(Enterprise)。生成文件时按要求加注释。其他细节暂未提供。