用途:操作 Alchemy Notify Webhook,覆盖原始请求体 HMAC-SHA256 校验、幂等接收、持久化处理和安全的生命周期变更。核心是在产生任何线上副作用前,先产出可审查的产物与负路径证据。
主要能力:
- 签名验证:Alchemy 用 webhook 的签名密钥对精确原始请求体做 HMAC-SHA256,摘要放在 X-Alchemy-Signature;需在 JSON 解析前捕获原始字节,用等长、时间安全的比较函数校验。
- 鉴权隔离:Notify 管理使用其文档规定的 auth token,非签名密钥;二者须存于独立的受管密钥中,接收方只能读签名密钥用于验证,不得创建、更新或删除 webhook 注册。
- 幂等与持久化:在确认前原子化保存 webhook 与事件标识,入队后即返回成功,不阻塞于下游副作用;消费者需幂等,并在需要时保持按实体排序。
- 生命周期与测试:测试有效、无效、重放、延迟、乱序及下游失败等用例,运行有界死信重放并需明确批准。
使用方式与前置条件:需当前一方 Alchemy 文档(对应产品、链、功能、客户端、鉴权方式、限额与生命周期)、各责任人(产品、应用、安全、数据隐私、预算、发布、运维)、合成或已批准的非生产夹具、凭据 canary、明确成功标准与经测试的回滚边界。
限制与边界:技能调用本身不授权网络访问、凭据、钱包地址、客户数据、计划变更、支出、密钥创建或轮换、webhook 变更、部署、重放、交易构造、签名、广播或删除。创建、变更、删除、重放或轮换生产 webhook 需所有者明确批准。缺失、畸形或不匹配的签名必须在解析或副作用前拒绝;不得将 Notify 管理 token 当作 HMAC 签名密钥。资料未提供具体价格与收费信息。