|
7 | 7 |
|
8 | 8 | # Meta
|
9 | 9 | ## Status
|
| 10 | +- 2025-09-19: Update to account for the F3-awareness that was added to `/v1` APIs in Lotus v1.34.0. This was reviewed in PR [#13352](https://github.com/filecoin-project/lotus/pull/13352). |
| 11 | +- 2025-08-29: Updated to summarize the difference between `/v1` and `/v2`. This was reviewed in PR [#13284](https://github.com/filecoin-project/lotus/pull/13284). |
10 | 12 | - 2025-06-06: Updated to make clear the impact on the APIs if F3 isn't finalizing or if the latest F3-finalized tipset is older than the latest EC-finalized tipset. This was reviewed in [PR #13161](https://github.com/filecoin-project/lotus/pull/13161).
|
11 | 13 | - 2025-04-24: This document has been updated to include information about Eth APIs in `/v2`. This was reviewed in [PR #13068](https://github.com/filecoin-project/lotus/pull/13068).
|
12 | 14 | - 2025-04-23: This document has been updated to account for the minimum initial set of non-Eth /v2 API groups as specified in [issue #12991](https://github.com/filecoin-project/lotus/issues/12991). This was reviewed in [PR #13051](https://github.com/filecoin-project/lotus/pull/13051)
|
@@ -113,12 +115,12 @@ ETH APIs have also been updated with F3 awareness for the `finalized` and `safe`
|
113 | 115 |
|
114 | 116 | | Group | Dimension | `/v1` | `/v2` |
|
115 | 117 | | --- | --- | --- | --- |
|
116 |
| -| non-ETH APIs | F3 awareness | ❌ | ✅ | |
| 118 | +| non-ETH APIs | F3 awareness | ☑️ Only `ChainGetFinalizedTipSet` | ✅ | |
117 | 119 | | | Selector pattern | ❌ | ✅ |
|
118 | 120 | | | Stable | ✅ | Experimental. There are no known changes to make, but we’ll make breaking changes in response to user feedback. |
|
119 |
| -| | Support level | Full. Critical bugs can trigger emergency patch releases. Backwards compatibility is a chief concern. | Very responsive to any feedback or bugs, and bugs impacting production usage can trigger an emergency patch release. Backwards compatbility isn’t a concern currently until we get more feedback on the API. | |
120 |
| -| | Footprint | Large as has accumulated bloat over the years. | Small. There is a lot of functionality from `/v1` that doesn’t have a `v2` corrolary yet. | |
121 |
| -| ETH APIs | F3 awareness | ❌ | ✅ :`finalized` and `safe` tags consult the F3 subsystem (see [Ethereum (Eth)](#ethereum-eth)). | |
| 121 | +| | Support level | Full. Critical bugs can trigger emergency patch releases. Backwards compatibility is a chief concern. | Very responsive to any feedback or bugs, and bugs impacting production usage can trigger an emergency patch release. Backwards compatibility isn’t a concern currently until we get more feedback on the API. | |
| 122 | +| | Footprint | Large as has accumulated bloat over the years. | Small. There is a lot of functionality from `/v1` that doesn’t have a `v2` equivalent yet. | |
| 123 | +| ETH APIs | F3 awareness | ✅ :`finalized` and `safe` tags consult the F3 subsystem (see [Ethereum (Eth)](#ethereum-eth)). | ✅ Same | |
122 | 124 | | | Support level | Full | Same |
|
123 | 125 | | | Footprint | See [Lotus Ethereum API Compatibility](https://www.notion.so/filecoindev/Lotus-Ethereum-API-Compatibility-1d0dc41950c180cc8c3ecc9033d56cc7) | Same. Any `/v1` ETH APIs are supported in `/v2`. |
|
124 | 126 |
|
@@ -445,7 +447,7 @@ If the address cannot be resolved to an ID address at the specified tipset state
|
445 | 447 |
|
446 | 448 | ## Ethereum (Eth)
|
447 | 449 |
|
448 |
| -The V2 API namespace includes all the Ethereum (Eth) APIs that `/v1` supports, but the `finalized` and `safe` tags have been updated to consult the F3 subsystem (if enabled) for finality information. `finalized` and `safe` for the "Eth" APIs has the same meaning and fallback outlined in [Consensus Protocol Notes](#consensus-protocol-notes). In addition, in V2, `safe` will look back a maximum 30 epochs, whereas V1 looks back 30. |
| 450 | +The V2 API namespace includes all the Ethereum (Eth) APIs that `/v1` supports. As of Lotus v1.34.0, both `/v1` and `/v2` have had the `finalized` and `safe` tags updated to consult the F3 subsystem (if enabled) for finality information. `finalized` and `safe` for the "Eth" APIs has the same meaning and fallback outlined in [Consensus Protocol Notes](#consensus-protocol-notes). In addition, `safe` will look back a maximum 200 epochs. |
449 | 451 |
|
450 | 452 | For a complete list of available Eth methods in V2, refer to the [V2 autogenerated documentation](https://github.com/filecoin-project/lotus/blob/master/documentation/en/api-v2-unstable-methods.md#eth).
|
451 | 453 |
|
|
0 commit comments