Skip to content

docs: document eth_getLogs query limits - #383

Open
huklaa wants to merge 4 commits into
circlefin:mainfrom
huklaa:docs-83-rpc-filter-limits
Open

huklaa wants to merge 4 commits into
circlefin:mainfrom
huklaa:docs-83-rpc-filter-limits

Conversation

@huklaa

@huklaa huklaa commented Sep 11, 2026

Copy link
Copy Markdown

Summary

  • document the inherited --rpc.max-blocks-per-filter and --rpc.max-logs-per-response flags
  • record their Reth defaults of 100000 blocks and 20000 logs
  • clarify that public gateways and reverse proxies may enforce stricter limits independently

This captures the repo-owned documentation follow-up identified in #83 without changing node behavior or duplicating the pending-tag fix in #340.

Validation

  • git diff --check

Related to #83.

@huklaa

huklaa commented Sep 12, 2026

Copy link
Copy Markdown
Author

Checking comment permissions after the latest CI update. No code changes needed from my side right now.

@osr21

osr21 commented Sep 19, 2026

Copy link
Copy Markdown

One addition worth capturing: the Arc public mainnet RPC enforces a stricter limit than the Reth node defaults.

Querying https://rpc.mainnet.arc.io with a block range above ~10,000 blocks returns:

{ "code": -32600, "message": "Query exceeds max block range of 10000" }

This is 10× lower than the 100,000-block Reth default this PR documents. A developer who validates against a local Arc node (where the Reth default applies) will hit this in production without a clear reason why — especially since the error code is -32600 (invalid request) rather than the rate-limit or method-not-found codes they might expect.

A note in the "public gateway" section with the concrete 10,000-block figure, alongside the existing mention that gateways may enforce stricter limits, would close that gap. Practical reference: we hit it while fetching DevicePayment event history from a mainnet contract and switched to 5,000-block chunks with cursor tracking to stay safely under the limit.

@huklaa
huklaa force-pushed the docs-83-rpc-filter-limits branch from d2f55c8 to 065caf0 Compare September 22, 2026 22:22
@huklaa
huklaa force-pushed the docs-83-rpc-filter-limits branch from 065caf0 to bdb38be Compare September 26, 2026 09:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants