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, or special tags) with an optional epoch limit for state resolution.

• Tests

  • Added RPC tests for the new v2 variant and included a new test snapshot.

• Documentation

  • Added an unreleased changelog entry documenting the v2 API.

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

[coderabbitai]

Walkthrough

Adds a V2 RPC variant Filecoin.EthGetBlockReceiptsLimited: implements EthGetBlockReceiptsLimitedV2, registers it in the RPC method macro, updates the existing DESCRIPTION, and adds tests and a snapshot entry for the new V2 behavior.

Changes

Cohort / File(s)	Summary
Changelog CHANGELOG.md	Added unreleased entry documenting Filecoin.EthGetBlockReceiptsLimited for API v2.
RPC Implementation src/rpc/methods/eth.rs, src/rpc/mod.rs	Added EthGetBlockReceiptsLimitedV2 and RpcMethod<2> impl (NAME, NAME_ALIAS, PARAM_NAMES, API_PATHS = V2, Params = (ExtBlockNumberOrHash, ChainEpoch), Ok = Vec<EthTxReceipt), handle resolves tipset via tipset_by_block_number_or_hash_v2 and calls get_block_receipts(..., Some(limit)). Added DESCRIPTION constant to existing EthGetBlockReceiptsLimited. Registered new variant in for_each_rpc_method.
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 (using ExtBlockNumberOrHash with block_hash indices 4 and -1) and added new 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: 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<EthTxReceipt> (or error)
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 Eth block-receipts endpoints and updates related RPC method patterns.
• Add support for the Filecoin.EthCall V2 #6339: Introduces other V2 RPC variants and the tipset_by_block_number_or_hash_v2 tipset-resolution helper used here.

Suggested reviewers

• LesnyRumcajs
• hanabi1224

🚥 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 describes the main change: adding V2 support for the Filecoin.EthGetBlockReceiptsLimited RPC method, which aligns with the code changes across multiple files.
Linked Issues check	✅ Passed	The PR implements the Filecoin.EthGetBlockReceiptsLimited V2 RPC method as required by issue #6296, including method implementation, tests, and documentation updates.
Out of Scope Changes check	✅ Passed	All changes are directly related to implementing the EthGetBlockReceiptsLimitedV2 endpoint, including method definition, macro registration, tests, and changelog documentation.

_{✏️ 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.72%. Comparing base (8117383) to head (b636ba5).
⚠️ Report is 1 commits behind head on main.

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.35% <ø> (ø)
src/rpc/methods/eth.rs	69.31% <90.00%> (+0.07%)	⬆️

... and 3 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 8117383...b636ba5. Read the comment docs.

🚀 New features to boost your workflow:

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