x402의 대조에는 하나의 불변의 원칙이 있습니다:체인 상의 Transfer 이벤트만 인정하며, 인위적인 보고서는 일체 인정하지 않습니다.이 도구는 다음 세 가지를 제공합니다: 대조표 CSV 템플릿, Base 메인넷 USDC 입금을 스캔할 수 있는 바로 실행 가능한 스크립트, 그리고 재무팀에 바로 전달할 수 있는 대조 설명서(규칙, 허용 오차, 차이 처리 방식 등이 모두 명시됨)입니다.
—
—
—
1 · 체인상의 Transfer만 인정, 보고서는 인정하지 않음.대조의 유일한 근거는 Base 메인넷 USDC 컨트랙트의 Transfer 이벤트, 다음 기준에 따라 topics[2](수취 주소) 필터링. "내가 이 값일 것 같다고 생각하는 것"은 모두 무효입니다.
2 · 0에서 체인을 스캔하지 마십시오.공용 노드로 archive 상태 조회 시 토큰 필요; 제네시스 블록부터 스캔하면 반드시 실패합니다. 올바른 방법:체인 헤드에서 2000 블록 뒤로 되감기시작점으로 삼은 후, lastScanned을 기준으로 증분 스캔합니다.
3 · 블록 단위 분할 + 속도 제한.eth_getLogs 한 번에 너무 많은 블록을 조회하면 요청 제한이 적용됩니다. 당사 운영 환경에서는 400블록 단위로 조회하며, 구간 간 지연은 250ms이며, 다중 노드 장애 복구 구성(publicnode / base.org / drpc 순으로 대체)을 사용합니다.
4 · 금액 허용 오차 ±$0.02.입금 금액과 지급 예정 금액은 "근사 일치"(±$0.02)로 판정하며, 절대 정확한 동일 비교를 하지 마세요—블록체인 금액은 최소 단위 정수이므로 반올림 시 센트 단위 오차가 발생할 수 있습니다.
5 · 데이터 파일을 수정하기 전에 반드시 서비스를 중지해야 합니다.서비스 메모리에는 전체 DB가 저장되어 있으며, 하트비트로 30초마다 디스크에 기록됩니다. 실행 중 JSON을 직접 수정하면 메모리 내 구버전 값으로 덮어씌워집니다(우리는 요금제 마이그레이션 시 한 차례 덮어쓰인 적 있음).