ウォレット活動とトークン転送のブロックチェーン Webhook API

アドレスの活動を受信先に配信

native.transfer は最上位トランザクションのネイティブ通貨転送、token.transfer は ERC-20、ERC-721、ERC-1155 の転送を配信します。その他のログは、発行元コントラクトまたは topics[1]–topics[3] に監視対象アドレスがある場合、log として配信されます。

GET /v1/push/chains は現在対応しているチェーンと確認数の範囲を返します。購読するチェーンを選ぶ前に API key を付けて照会してください。

一つの購読で複数チェーンをカバーし、受信 URL は一つです。開発者と AI Agent は同じ容量プランと料金を利用できます。

ウォレットとコントラクトの活動を利用

署名検証、確認、イベントの復旧

• イベントを処理する前に、購読のシークレットで `webhook-id.webhook-timestamp.raw-body` に対する HMAC-SHA256 署名を検証します。先に JSON をパースせず、生のリクエストボディを使用してください。
• 配信は少なくとも一回です。イベント id で重複を排除し、処理結果を永続化してから 2xx を返します。購読がオンラインでイベントが保持期間内にある間、失敗した配信を再試行します。
• GET /v1/push/chains が返す範囲内でチェーンごとに confirmations を設定します。chain.reorg は配信済みブロックの置き換えを通知します。古いイベントを ref でマークし、自動再配信された正規チェーンのイベントを保持して id で重複を排除します。
• Replay は再送可能な範囲内の保存済みイベントを再配信します。アドレスやチェーンを購読に追加する前の活動は取得できません。

料金

表の CU 重みと無料アドレス枠は GET /v1/plans から取得します。データイベントは配信単位で課金され、自動再試行と制御イベントは無料です。replay による再配信はイベント料金で課金されます。