TriportRPC
DashboardDocs

bor_getSnapshot

Last updated:

bor_getSnapshot returns the complete Polygon Bor consensus snapshot as of a given block. A snapshot is the richest of the bor_* methods: it bundles the block context (number, hash), the current validators set with their stake weights and proposer-rotation accumulators, and a recents map of recently seen signers keyed by block number. It is the single best entry point for observability and indexing tooling that needs the full proposer schedule for an epoch rather than just the current validator list or current proposer.

Use it when you want one authoritative read of consensus state — for building a validator-set dashboard, reconstructing the epoch proposer rotation, or auditing signer behavior. The recents map together with validators lets you derive who has signed recently and whose turn is coming up, without polling bor_getCurrentProposer block-by-block.

Bor consensus rotates its validator set roughly every epoch (~1024 blocks, about 36 minutes), so the snapshot is broadly stable within an epoch and changes at epoch boundaries. This is a Polygon-only, Bor-fork-specific method — it does not exist on standard Geth/Erigon Ethereum nodes. The response is heavier than the other bor_* methods (roughly 50–100 KB for a full snapshot), so cache results client-side rather than calling it in a hot loop.

Parameters

This method takes no parameters.

Returns

bor_getSnapshot return value
FieldType
resultobject

Examples

curl https://triport.io/sol \
  -X POST -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <api-key>' \
  -d '{"id":1,"method":"bor_getSnapshot","params":[],"jsonrpc":"2.0"}'
const res = await fetch("https://triport.io/sol", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer <api-key>" },
  body: JSON.stringify({
  "id": 1,
  "method": "bor_getSnapshot",
  "params": [],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post(
    "https://triport.io/sol",
    headers={"Authorization": "Bearer <api-key>"},
    json={"id":1,"method":"bor_getSnapshot","params":[],"jsonrpc":"2.0"},
)
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet.
  3. Credit cost: 1 per call.

FAQ

What does bor_getSnapshot do?
Returns the full Bor consensus snapshot at a block — the validator set, the recent-signers map, and the block context — in a single call.
How many credits does bor_getSnapshot cost?
bor_getSnapshot costs 1 credit(s) per call on Triport by default.
Is bor_getSnapshot available over WebSocket?
bor_getSnapshot is an HTTP JSON-RPC method.