An alternative path for adding F3 awareness is to adopt /v2 APIs. See 🔧 Migration from V1 to V2 APIs and you can get a high-level overview of the differences between /v1 and /v2 at Introduction.

Understanding V2 API Finality Tags

The V2 APIs introduce three key finality tags that automatically leverage F3:

  1. "finalized" - Returns the most recent F3-finalized tipset (typically 3-5 minutes old), assuming F3-finalization isn’t behind EC. See Understanding finalized TipSets for more info.
  2. "safe" - Balances recency with stability (max 200 epochs behind latest). Assuming F3 isn’t stalled thought, then this effectively returns “finalized”. See Understanding safe TipSets for more info.
  3. "latest" - Returns the most recent tipset (lowest finality guarantee)

Key V2 API Methods for Exchanges and RPC providers

1. ChainGetTipSet - Get Blockchain State Reference

Get the latest finalized tipset:

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSet",
  "params": [
    {
      "tag": "finalized"
    }
  ],
  "id": 1
}

Get a safe tipset (balanced approach):

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSet",
  "params": [
    {
      "tag": "safe"
    }
  ],
  "id": 1
}

2. StateGetActor - Check Account Balances

Check balance at finalized state:

{
  "jsonrpc": "2.0",
  "method": "Filecoin.StateGetActor",
  "params": [
    "f1your-address-here",
    {
      "tag": "finalized"
    }
  ],
  "id": 1
}

3. Ethereum APIs with F3 Awareness

Same as /v1 : 2. Ethereum APIs with F3 Awareness

Recommended Patterns for Exchanges

Same as /v1 : Recommended Patterns for Exchanges