eth_getLogs : limite de plage de blocs, paramètres et CU

Interroge les logs d'événements avec eth_getLogs : paramètres de filtre, valeurs de retour, pondérations en CU, limites de plage de blocs par chaîne et gestion de logs_range_too_large.

Aperçu

Interroge les logs d'événements dans une plage de blocs correspondant à un filtre.

Unités de calcul (CU) et tarification

CU par appel

30 CU

Prix par million d'appels (USD)

$3.00

Paramètres

Paramètre	Type	Description
`filter`	`object`	Objet filtre : fromBlock et toBlock (numéro ou balise de bloc, défaut latest), address (une adresse ou un tableau d'adresses), topics (tableau dont chaque élément est null, un topic de 32 octets ou un tableau de topics), ou blockHash pour cibler un bloc unique.

Valeur de retour

Type: ARRAY
Description: Tableau d'objets de log dans l'ordre des blocs ; tableau vide en l'absence de correspondance.

Remarques

blockHash est mutuellement exclusif avec fromBlock/toBlock ; les topics correspondent par position, et null indique n'importe quelle valeur à cette position. Une plage de blocs supérieure à max_logs_block_range de la chaîne (voir GET /v1/chains) renvoie -32602.

Exemple de requête

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
  }'

Chaînes prises en charge

Disponible sur l'ensemble des 9 chaînes prises en charge.

Pour les requêtes étendues, suivez le guide sur la limite de plage de blocs et requêtes découpées d'eth_getLogs. Les détails de l'erreur et les actions recommandées se trouvent dans la référence logs_range_too_large.