eth_getLogs: Blockbereichslimit, Parameter und CU

Ereignis-Logs mit eth_getLogs abfragen: Filterparameter, Rückgabewerte, CU-Gewichte, Blockbereichslimits je Chain und Behandlung von logs_range_too_large.

Übersicht

Fragt Ereignis-Logs innerhalb eines Blockbereichs ab, die mit einem Filter übereinstimmen.

Compute Units (CU) und Preise

CU pro Aufruf

30 CU

Preis pro 1M Aufrufe (USD)

$3.00

Parameter

Parameter	Typ	Beschreibung
`filter`	`object`	Filter-Objekt: fromBlock und toBlock (Blocknummer oder Tag, Standard latest), address (eine Adresse oder ein Array von Adressen), topics (ein Array, in dem jedes Element null, ein 32-Byte-Topic oder ein Array von Topics ist) oder blockHash zur Auswahl eines einzelnen Blocks.

Rückgabewerte

Typ: ARRAY
Beschreibung: Array von Log-Objekten in Blockreihenfolge; ein leeres Array, wenn keine Treffer vorhanden sind.

Hinweise

blockHash schließt fromBlock/toBlock gegenseitig aus; Topics stimmen nach Position überein, und null steht für einen beliebigen Wert an dieser Position. Ein Blockbereich, der größer als max_logs_block_range der Chain ist (siehe GET /v1/chains), gibt -32602 zurück.

Anfragebeispiel

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "address": "0x0000000000000000000000000000000000000000",
        "fromBlock": "latest",
        "toBlock": "latest"
      }
    ],
    "id": 1
  }'

Unterstützte Chains

Verfügbar auf allen 9 unterstützten Chains.

Für Abfragen über große Bereiche folgen Sie dem Leitfaden für eth_getLogs-Blockbereichslimit und segmentierte Abfragen. Fehlerdetails und empfohlene Maßnahmen finden Sie in der logs_range_too_large-Referenz.