Skip to content

Add json-rpc docs for ChainGetFinalizedTipSet #2422

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
+86 −0
Open

Add json-rpc docs for ChainGetFinalizedTipSet #2422

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 86 additions & 0 deletions reference/json-rpc/chain.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -290,6 +290,92 @@ Response:
]
```

## ChainGetFinalizedTipSet
ChainGetFinalizedTipSet returns the latest finalized tipset. It uses the
current F3 instance to determine the finalized tipset.
This is the tipset at the end of the last finalized round and can be used
for follow-up querying of the chain state with the assurance that the
state will not change.
If F3 is operational and finalizing in this node. If not, it will fall back
Copy link
Preview

Copilot AI Sep 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The sentence on line 299 is incomplete. It should read 'This method returns the finalized tipset if F3 is operational and finalizing in this node.'

Suggested change
If F3 is operational and finalizing in this node. If not, it will fall back
This method returns the finalized tipset if F3 is operational and finalizing in this node. If not, it will fall back

Copilot uses AI. Check for mistakes.

to the Expected Consensus (EC) finality definition of head - 900 epochs.

Perms: read

Inputs: `null`

Response:
```json
{
"Cids": [
{
"/": "bafy2bzacedo7hjsumaajt6sbor42qycvjyk6goqe4oi4o4ddsjxkdeqrqf42c"
}
],
"Blocks": [
{
"Miner": "f01938223",
"Ticket": {
"VRFProof": "rIPyBy+F827Szc5oN/6ylCmpzxfAWr7aI5F4YJrN4pLSyknkcJI3ivsCo2KKjQVZFRnFyEus1maD5LdzQpnFRKMla4138qEuML+Ne/fsgOMrUEAeL34ceVwJd+Mt4Jrz"
},
"ElectionProof": {
"WinCount": 1,
"VRFProof": "sN51JqjZNf+xWxwoo+wlMH1bpXI9T3wUIrla6FpwTxU4jC1z+ab5NFU/B2ZdDITTE+u8qaiibtLkld5lhNcOEOUqwKNyJ4nwFo5vAhWqvOTNdOiZmxsKpWG0NZUoXb/+"
},
"BeaconEntries": [
{
"Round": 17133822,
"Data": "tH4q8euIaP9/QRJt8ALfkBvttSmQ/DOAt8+37wGGV5f8kkhzEFrHhskitNnPS70j"
},
{
"Round": 17133832,
"Data": "uQD5cEn8U69+sPjpccT8Bm0jVrnXLScf2jBkLJNHvAHLA6tPsZDREzpBIckpVvPy"
}
],
"WinPoStProof": [
{
"PoStProof": 3,
"ProofBytes": "qOPLMhMui8qm/rE2y/UceyBDv5JvRCH5Fc5Ul+kuN190XDcMme5eKURUCmE2sN1HoQ2dMZX+xNZY351dbG93H/tUr6wuNhkvmemi2Xi62YvqU36/kJh+K2YBiW7h/4LXCUTP/6XAOONOPl+j9GqS7RQxruPLfIyehvzVC0C8dB8+SVWtAnRKRPUUOPJvyHKejlrCyzWXOz/I7JG2/qEGLD0xwazBVwML1vVvuE5NzXeOoQGlnB2PwSRb5Cn8FH8Q"
}
],
"Parents": [
{
"/": "bafy2bzaceba2kdmysmi5ieugzvv5np7f2lobayzpvtk777du74n7jq6xhynda"
},
{
"/": "bafy2bzacecrye24tkqrvvddcf62gfi4z4o33z2tdedbpaalordozaxfrz2jyi"
},
{
"/": "bafy2bzaceab5mrohjvnp3mz7mo33ky7qqlmssrs7veqmjrgouafxyhnd5dy66"
}
],
"ParentWeight": "116013147118",
"Height": 4863283,
"ParentStateRoot": {
"/": "bafy2bzaceajxzsvzuq3ddzxfrs2jlaxsooqmgdy5uxbqujnjy3y56iumzzy7u"
},
"ParentMessageReceipts": {
"/": "bafy2bzacecfcx2ykqucyv3gkyrcy3upwrvdraz3ktfg7phkqysefdwsggglac"
},
"Messages": {
"/": "bafy2bzacebzofmh6migvc4v6qsme6vuxlhi6pv2ocy4apyic3uihjqm7dum3u"
},
"BLSAggregate": {
"Type": 2,
"Data": "krFATGA0OBu/kFwtXsThVtKCkppnU7045uTURCeiOeJttxuXfx3wqJrLkCytnJFWFLVC+tiVWI4BxC3wqc9r6eAlNr9dEBx+3KwML/RFG/b5grmknLpGWn7g1EB/2T4y"
},
"Timestamp": 1744204890,
"BlockSig": {
"Type": 2,
"Data": "pWiUr+M8xxTxLED7GuU586gSfZCaHyLbLj0uS0HhKYRtHuyG47fIrfIT/04OCmQvEXBD8pFraWbMc3tnFrSsM1mIBJ5M38UPUfXDSspo+QGdouo2kll2X+VNKY3ajb1K"
},
"ForkSignaling": 0,
"ParentBaseFee": "20592036"
}
],
"Height": 4863283
}
```

## ChainGetGenesis

ChainGetGenesis returns the genesis tipset.
Expand Down
Loading