決済対照テンプレートジェネレーター

x402 の突合せには絶対に守るべきルールがあります:チェーン上のTransferイベントのみを認識し、いかなる手動レポートも認識しないこのツールは、以下の3つのものを提供します:請求書CSVテンプレート、Baseメインネット上のUSDC入金をスキャンする実行可能なスクリプト、および財務部門に直接渡せる請求書照合説明書(ルール、許容誤差、差異処理方法がすべて記載済み)。

無料・ ログイン不要 ローカル生成・ コンテンツはアップロードされません 基準・ 自然月集約 ・ 翌月10日 ・ $50 以上で決済

1決済主体および決済期間

2チェーン上スキャンパラメータ

パブリックノードでarchiveステータスを確認するにはトークンが必要であるため、0 からスキャンしないでください——チェーンヘッドから2000ブロック遡って開始します。

結果当期の決済基準

出力 1対照表 CSV テンプレート

0 行
—
BOM 付き。Excel で開くと文字化けしません。

出力 2オンチェーン入金スキャンスクリプト(Node)

0 行
—

出力 3財務向け対帳説明

0 行
—
この罠は私たちが既に踏んでいます

1 ・ チェーン上の Transfer のみを認識し、レポートは認識しません。照合の唯一の根拠は Base メインネットの USDC コントラクトです Transfer イベント(順) topics[2](受取アドレス)によるフィルタリング。「この金額のはずだ」という主観的な判断は一切認めない。

2・0 からチェーンをスキャンしないでください。公共ノードで archive 状態を照会するには token が必要です。創世ブロックからスキャンすると必ず失敗します。正しい手順:チェーンヘッドから2000ブロック戻る起点として、その後lastScannedを記録し、増分スキャンを行う。

3・チャンク分割+レート制限。eth_getLogs 一度に多すぎるブロックを検索するとレート制限を受けます。当社の本番環境では、400ブロックごとのセグメント、セグメント間250msの間隔で実行しており、複数ノードによるフェイルオーバー構成(publicnode / base.org / drpc の順でバックアップ)を採用しています。

4 · 金額許容誤差 ±$0.02。入金金額と支払予定額は「近似一致」(±$0.02)で判定します。厳密な等価比較は行わないでください——ブロックチェーン上の金額は最小単位の整数であるため、丸め処理によりセント単位の差異が生じます。

5 · データファイルを変更する前に、サービスを停止する必要があります。サービスのメモリ内には全量DBが保持されており、ハートビートで30秒ごとにディスクへ永続化されます。実行中にJSONを直接編集しても、メモリ内の古い値で上書きされてしまいます(当社はレート移行時に1度、この現象が発生しました)。