From 7167f1c90f67b7846103c3cd704ad77432e49d94 Mon Sep 17 00:00:00 2001
From: Francisco Giordano <fg@frang.io>
Date: Tue, 21 Apr 2026 12:16:25 -0300
Subject: [PATCH] Document support for block tags in eth_getLogs range

---
 src/schemas/block.yaml  | 16 ++++++++++++++++
 src/schemas/filter.yaml |  4 ++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/src/schemas/block.yaml b/src/schemas/block.yaml
index 37c56b7b1..3a1b23303 100644
--- a/src/schemas/block.yaml
+++ b/src/schemas/block.yaml
@@ -127,6 +127,22 @@ BlockNumberOrTag:
       $ref: '#/components/schemas/uint'
     - title: Block tag
       $ref: '#/components/schemas/BlockTag'
+BlockTagForRange:
+  title: Block tag
+  type: string
+  enum:
+    - earliest
+    - finalized
+    - safe
+    - latest
+  description: '`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
+BlockNumberOrTagForRange:
+  title: Block number or tag
+  oneOf:
+    - title: Block number
+      $ref: '#/components/schemas/uint'
+    - title: Block tag
+      $ref: '#/components/schemas/BlockTagForRange'
 BlockNumberOrTagOrHash:
   title: Block number, tag, or block hash
   anyOf:
diff --git a/src/schemas/filter.yaml b/src/schemas/filter.yaml
index 2c0a34f6f..5da814a7a 100644
--- a/src/schemas/filter.yaml
+++ b/src/schemas/filter.yaml
@@ -18,10 +18,10 @@ Filter:
       properties:
         fromBlock:
           title: from block
-          $ref: '#/components/schemas/uint'
+          $ref: '#/components/schemas/BlockNumberOrTagForRange'
         toBlock:
           title: to block
-          $ref: '#/components/schemas/uint'
+          $ref: '#/components/schemas/BlockNumberOrTagForRange'
         address:
           title: Address(es)
           oneOf: