Add support for the Filecoin.EthGetBlockReceiptsLimited V2

[sudo-shashank]

Summary of changes

Changes introduced in this pull request:

• Impl Filecoin.EthGetBlockReceiptsLimited V2 and added test.

Reference issue to close (if applicable)

Closes #6296

Other information and links

Change checklist

• I have performed a self-review of my own code,
• I have made corresponding changes to the documentation. All new code adheres to the team's documentation standards,
• I have added tests that prove my fix is effective or that my feature works (if possible),
• I have made sure the CHANGELOG is up-to-date. All user-facing changes should be reflected in this document.

Outside contributions

• I have read and agree to the CONTRIBUTING document.
• I have read and agree to the AI Policy document. I understand that failure to comply with the guidelines will lead to rejection of the pull request.

Summary by CodeRabbit

• New Features

  • Added a v2 variant of Filecoin.EthGetBlockReceiptsLimited supporting extended block identification (number, hash, special tags) with an optional epoch limit for state resolution.

• Tests

  • Added RPC tests covering the new v2 variant and updated test snapshots.

• Documentation

  • Added an unreleased changelog entry for the new v2 API.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Introduces Filecoin.EthGetBlockReceiptsLimited as an RPC v2 endpoint. Adds EthGetBlockReceiptsLimitedV2 variant to the RPC methods, registers it in the macro system, and includes corresponding tests and a snapshot entry.

Changes

Cohort / File(s)	Summary
Changelog CHANGELOG.md	Added unreleased entry for Filecoin.EthGetBlockReceiptsLimited (API v2).
RPC Implementation src/rpc/methods/eth.rs, src/rpc/mod.rs	Added EthGetBlockReceiptsLimitedV2 enum and RpcMethod<2> implementation (NAME, NAME_ALIAS, PARAM_NAMES, API_PATHS V2, Params = (ExtBlockNumberOrHash, ChainEpoch), handle uses tipset_by_block_number_or_hash_v2 and get_block_receipts with limit). Added DESCRIPTION to existing EthGetBlockReceiptsLimited. Registered new variant in for_each_rpc_method macro.
Tests & Snapshots src/tool/subcommands/api_cmd/api_compare_tests.rs, src/tool/subcommands/api_cmd/test_snapshots.txt	Added two RPC tests for EthGetBlockReceiptsLimitedV2 (ExtBlockNumberOrHash block_hash with indices 4 and -1) and added corresponding snapshot filename entry.

Sequence Diagram(s)

mermaid
sequenceDiagram
participant Client
participant RPC_Method as EthGetBlockReceiptsLimitedV2
participant TipsetResolver as tipset_by_block_number_or_hash_v2
participant Chain as get_block_receipts
Client->>RPC_Method: Send request (blockParam, limit)
RPC_Method->>TipsetResolver: Resolve tipset from ExtBlockNumberOrHash
TipsetResolver-->>RPC_Method: Tipset (or error)
RPC_Method->>Chain: get_block_receipts(tipset, Some(limit))
Chain-->>RPC_Method: Vec
RPC_Method-->>Client: Return receipts (or error)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• Add support for the Filecoin.EthGetBlockReceipts V2 #6489: Adds V2 variants for EthGetBlockReceipts and related refactors—closely related to V2 receipt endpoints.
• Add support for the Filecoin.EthCall V2 #6339: Adds other V2 RPC variants using tipset_by_block_number_or_hash_v2—shares tipset-resolution patterns.

Suggested reviewers

• hanabi1224
• LesnyRumcajs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change: adding V2 support for the Filecoin.EthGetBlockReceiptsLimited RPC method, which aligns with the changeset's core modifications.
Linked Issues check	✅ Passed	The PR implements EthGetBlockReceiptsLimitedV2 with V2 routing, adds comprehensive tests, and updates documentation/changelog to address the objective of supporting Filecoin.EthGetBlockReceiptsLimited under RPC v2.
Out of Scope Changes check	✅ Passed	All changes are directly related to implementing the V2 RPC method: new enum variant, RpcMethod implementation, macro registration, tests, and documentation updates with no unrelated modifications present.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@src/rpc/methods/eth.rs`:
- Around line 1778-1780: The DESCRIPTION for the method (const DESCRIPTION) is
misleading because it says "optional limit" while the function signature
requires a limit; update the text to accurately reflect the API behavior: either
state that callers must provide a limit and that they can pass a sentinel value
(e.g., LOOKBACK_NO_LIMIT) to disable limiting, or change the function signature
to accept an optional limit (Option<...>) if you intend it to be truly optional;
reference DESCRIPTION and the limit parameter handling (and the
LOOKBACK_NO_LIMIT constant if used) and make the wording precise such as
"provide a limit; pass LOOKBACK_NO_LIMIT to disable limiting" or adjust the
signature to accept Option and update docs accordingly.

[codecov]

Codecov Report

❌ Patch coverage is 90.00000% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 62.74%. Comparing base (7254a42) to head (3017979).

Files with missing lines	Patch %	Lines
src/rpc/methods/eth.rs	90.00%	0 Missing and 1 partial ⚠️

Additional details and impacted files

Files with missing lines	Coverage Δ
src/rpc/mod.rs	24.47% <ø> (ø)
src/rpc/methods/eth.rs	69.29% <90.00%> (+0.07%)	⬆️

... and 5 files with indirect coverage changes

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7254a42...3017979. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.