Chain ID (1=Ethereum, 137=Polygon, 56=BSC, 8453=Base, etc.)

Optional contract address to filter logs. If omitted, returns any log matching the event signature.

The event ABI to decode logs against. Must be a single event definition.

Max number of recent logs to return (newest first). Default 5, max 25.

How many blocks back to search at most. Default 150000 (~3.5 days on Base/L2). Capped at 250000 to stay within RPC and proxy timeout budgets.

Matching logs, newest first. Empty array if none found.

The chain's latest block at fetch time.

How many blocks were actually searched before returning.

True when the search hit the server-side deadline or chunk cap before completing the full range. Callers should treat results as incomplete — consider narrowing the event or contract filter.