Zum Inhalt springen

Überwachung von USDT- / USDC-Zahlungen via JSON-RPC

Nutzen Sie das JSON-RPC von BlockVectra zur Überwachung eingehender USDT- und USDC-Transfers über eth_getLogs Polling, mit WebSocket-Abonnements auf unterstützten Chains.

Unterstützte Chains

Netzwerkfähigkeiten aus GET /v1/chains.

ChainUnterstützter Empfangsmechanismus
Arbitrum OneHTTP-Polling (eth_getLogs)
BaseHTTP-Polling (eth_getLogs)
BNB Smart ChainHTTP-Polling (eth_getLogs)
EthereumHTTP-Polling (eth_getLogs)
HyperEVMHTTP-Polling (eth_getLogs)
PolygonHTTP-Polling (eth_getLogs)
Robinhood ChainHTTP-Polling & WebSocket

Drei Schritte zur Zahlungsannahme

1. API key abrufen

Erstellen Sie einen API key via programmatischer Registrierung(Englisch) per Ethereum-Wallet-Signatur oder melden Sie sich in der Konsole an, um einen zu generieren.

2. Transfer-Events abfragen

Erstellen Sie einen eth_getLogs-Filter mit der Token-Vertragsadresse, dem Transfer-Topic0 und Ihrer mit Nullen auf 32 Byte aufgefüllten Empfängeradresse. Bewegen Sie den Cursor in Blöcken innerhalb des maximalen Bereichs der Chain (typischerweise 1,000 Blöcke). Siehe Transfer-Filter-Leitfaden(Englisch) und Cursor-Polling-Leitfaden(Englisch).

3. Bestätigungstiefe prüfen und Zahlung gutschreiben

Fragen Sie bis safe_head = current_head - CONFIRMATION_DEPTH ab, um Chain-Reorganisationen zu vermeiden. Prüfen Sie, dass log.removed nicht true ist, und stellen Sie Idempotenz über (transactionHash, logIndex) sicher, bevor Sie Guthaben verbuchen. Siehe Reorganisations-Leitfaden(Englisch) und Deduplizierungs-Leitfaden(Englisch).

Beispiel für eth_getLogs-Anfrage

Standardmäßige JSON-RPC-Anfrage gemäß dem Stablecoin-Zahlungsleitfaden:

curl -s -X POST https://api.blockvectra.com/v1/bsc_mainnet \
  -H "content-type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getLogs",
    "params": [
      {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "fromBlock": "0x28a0000",
        "toBlock": "0x28a03e7",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          "0x000000000000000000000000<your-receiving-address>"
        ]
      }
    ]
  }'

Preise und Abrechnungsregeln

eth_getLogs Methodengewicht: 30 CU ($3.00 pro 1,000,000 Anfragen).

Vom Dienst abgelehnte Anfragen (z. B. zu großer Blockbereich oder Ratenlimit) werden nicht berechnet (billed: false). Siehe Abrechnungsregeln(Englisch) oder vollständige Preistabelle.

Zahlungsüberwachung