The checkpoint format this library writes. An older released format keeps
decoding, as the root rule of "Only the Latest App Version Exists" says: a
checkpoint written by an earlier release of the library is a version of the
library, not of the app, and its old fields are read into the current layout.
This build writes format 6 and reads formats 5 and 4 (v4.11.0) beside it; a
checkpoint of an unknown or newer format is refused with
CheckpointDecodeError, never partially restored.
The carried platform parts are part of the format. The set of
ProcessCheckpointRegistries parts — their keys and their encodings — is as
much a checkpoint's format as this number is: adding, removing or renaming a
part changes what a checkpoint holds, so it bumps this constant. A part a
later format added is absent from an older released checkpoint; it is
restored to its declared initial state (ProcessCheckpointPart.initial),
which is the state a process of that build held — the fact did not exist
there — never a guess about a value the older build stored. A part with no
initial makes such a checkpoint undecodable. A checkpoint of the current
format must carry every part, and an unknown part is refused (see
restoreExtras).
Format 2 (released in v4.7.0) added a frame's lookup index (the rows an action
refreshed) beside its visit index, so a restored frame keeps the two apart
exactly as the live one did, and carries the facts a restore continues the
process with: the frame's visit (its id, ordinal, start and shown times), a
swipeable feed's item in front with its own visit, the process's tray
session and the foreground surface trail's navigation source (a screen's
module can depend on how it was reached). A restored departure is then the same visit it was before the
checkpoint — the item in front's included — and the tray keeps its id. It also
adds the interruption: a frame the server brought over the frame below (a
challenge), and the root that is one. The platform parts extended it the same
way (the Android sign-up screens' registration session,
android.registration-session, and the reels viewer's session and visits,
android.reels-viewer-views).
Format 3 drops the telemetry queue from the process part: undelivered
events belong to the process that logged them, which delivers them when it
closes. A format released in a tag is never changed in place: format 5
reads format 4 instead of rewriting it, and a format this build cannot read
(3 and earlier, or an unknown or newer one) is refused.
Format 4 (released in v4.11.0) adds the Android process's running user flows
(android.user-flows, the state x-ig-salt-ids renders) with the readiness
of the QPL logger that renders them: a restored process continues the flows
the checkpointed one was running, and a checkpoint taken inside a launch's
first flight restores a logger that still stamps no header. It also carries the
process's timers as a platform part (Android: android.process-timers, the
routing-map refresh and the Direct presence re-read with when each next fires
and what it repeats, so a restored process fires them when a continued one
would). It also carries the MobileConfig configs the process has read with
the values it fixed for each (mobileConfig, mobile.mobile-config.ts), so a
restored process reads what the checkpointed one read, and the Android
quick-promotion stash (android.quick-promotion-stash, each surface's last
answered batch: the app persists the answer's time across its own restart, so
a restored process does not re-send the batch), and the process's client
address (android.client-address, the public IPv4 the server echoed and when,
which the reels viewer's tail page re-sends). The process's session origin
keeps only whether the stored-session start has begun (begun): the routing
map it once carried is the install's, so it travels in the client state's
device.
Format 5 adds two Android platform parts: the throttling detector
(android.throttling-detector, the process state behind
x-meta-tasos-td-rates / x-meta-tasos-td-signal), so a restored process
reports the detector's form and count the checkpointed one held, and the
comments sheet's once-only reads (android.comments-sheet-reads), so a
restored process skips the restricted-account and shop-eligibility reads the
checkpointed one made. Format 4 shipped in v4.11.0 without these parts and
with the session origin's earlier shape, so format 4 is not changed in
place: it is read. A format-4 checkpoint restores into the format-5 layout
with its missing parts at their initial states — the detector's Waiting and
the reads' nothing held — because a 4.11.0 process had no such state to
save: that is the state it held, not an invented default.
Format 6 carries the device's telemetry queue (in the client state's
device, MobileDeviceState.telemetry: the undelivered events, their
numbering and the health counters) and the process's navigation count
(telemetry.navigationMoves), owner decision 2026-10-28 («го»): unsent events
persist with the session, as the app keeps them on disk. It also carries the
Android telemetry sender's process facts (android.telemetry-sender: when the
process started, whether its app-start upload went out, when the health
counters were last attempted), so a restored process continues the
checkpointed one — its pending events are that process's own and go out when
their reasons come due, never as a start's tail. Format 5 is read: a
format-5 process held its events in memory and logged no navigation, so its
device has no queue and its count is 0, and it ran no sender — the state it
held.
Format 7 adds one field to the comments sheet's once-only reads
(android.comments-sheet-reads): the composer sessions the process has
focused, so the sheet logs its composer's tap and focus once per sheet and a
second comment in the same sheet sends without re-opening it. Format 6
shipped in v4.15.0 without the set and is read: its sheets carry no
comment-surface facts (that input is this build's), so they log no composer
events and their reads restore with no session focused — the state they held.
Format 8 changes the sign-up's checkpointed session (android.registration-session):
the registration context carries the launch-issued aac every sign-up request
chains, and the create call's attestation pair is no longer stored — the
agree() action requests it itself, so the completion reuses that call's pair
and the session holds no nonce between screens. The login home's issued data
(android.login-homepage-issued) also gains the launch's regContext and
regInfo, which the sign-up's steps chain. Format 7 is read: its context
has no aac (the 453 sign-up's requests chain the launch's token, which a 7
process did not keep), its stored attestation is dropped with a
StoredSnapshotFieldDropped record, and its login-home issued data has
neither regContext nor regInfo.
Format 8 also carries the Android onboarding's flow state
(android.onboarding-flow: the NUX flow's waterfall and session ids, the
steps' session ids, the suggested accounts the discover-people step shows,
the reels list's cursor and the reels tuning screen's counts), so a restored
step logs under the ids the checkpointed process used. It shipped in v4.18.0;
an earlier format restores the flow at its initial state (no onboarding
begun).
Format 9 removes the routing value from the iOS process part
(ios.process): ig-u-rur is the signed-in account's fact and lives in the
checkpoint's client session (MobileSessionState.accounts), where every
request reads it. Format 8 is read: the ios.process.rur it carried is
read in its release's shape and moves into the checkpoint account's record
(a value the client session already placed there wins); a checkpoint that
names no account drops it with a logged StoredSnapshotFieldDropped.
The checkpoint format this library writes. An older released format keeps decoding, as the root rule of "Only the Latest App Version Exists" says: a checkpoint written by an earlier release of the library is a version of the library, not of the app, and its old fields are read into the current layout. This build writes format
6and reads formats5and4(v4.11.0) beside it; a checkpoint of an unknown or newer format is refused withCheckpointDecodeError, never partially restored.The carried platform parts are part of the format. The set of
ProcessCheckpointRegistriesparts — their keys and their encodings — is as much a checkpoint's format as this number is: adding, removing or renaming a part changes what a checkpoint holds, so it bumps this constant. A part a later format added is absent from an older released checkpoint; it is restored to its declared initial state (ProcessCheckpointPart.initial), which is the state a process of that build held — the fact did not exist there — never a guess about a value the older build stored. A part with no initial makes such a checkpoint undecodable. A checkpoint of the current format must carry every part, and an unknown part is refused (seerestoreExtras).Format
2(released in v4.7.0) added a frame's lookup index (the rows an action refreshed) beside its visit index, so a restored frame keeps the two apart exactly as the live one did, and carries the facts a restore continues the process with: the frame's visit (its id, ordinal, start and shown times), a swipeable feed's item in front with its own visit, the process's tray session and the foreground surface trail's navigation source (a screen's module can depend on how it was reached). A restored departure is then the same visit it was before the checkpoint — the item in front's included — and the tray keeps its id. It also adds the interruption: a frame the server brought over the frame below (a challenge), and the root that is one. The platform parts extended it the same way (the Android sign-up screens' registration session,android.registration-session, and the reels viewer's session and visits,android.reels-viewer-views).Format
3drops the telemetry queue from the process part: undelivered events belong to the process that logged them, which delivers them when it closes. A format released in a tag is never changed in place: format5reads format4instead of rewriting it, and a format this build cannot read (3and earlier, or an unknown or newer one) is refused.Format
4(released in v4.11.0) adds the Android process's running user flows (android.user-flows, the statex-ig-salt-idsrenders) with the readiness of the QPL logger that renders them: a restored process continues the flows the checkpointed one was running, and a checkpoint taken inside a launch's first flight restores a logger that still stamps no header. It also carries the process's timers as a platform part (Android:android.process-timers, the routing-map refresh and the Direct presence re-read with when each next fires and what it repeats, so a restored process fires them when a continued one would). It also carries the MobileConfig configs the process has read with the values it fixed for each (mobileConfig,mobile.mobile-config.ts), so a restored process reads what the checkpointed one read, and the Android quick-promotion stash (android.quick-promotion-stash, each surface's last answered batch: the app persists the answer's time across its own restart, so a restored process does not re-send the batch), and the process's client address (android.client-address, the public IPv4 the server echoed and when, which the reels viewer's tail page re-sends). The process's session origin keeps only whether the stored-session start has begun (begun): the routing map it once carried is the install's, so it travels in the client state's device.Format
5adds two Android platform parts: the throttling detector (android.throttling-detector, the process state behindx-meta-tasos-td-rates/x-meta-tasos-td-signal), so a restored process reports the detector's form and count the checkpointed one held, and the comments sheet's once-only reads (android.comments-sheet-reads), so a restored process skips the restricted-account and shop-eligibility reads the checkpointed one made. Format4shipped in v4.11.0 without these parts and with the session origin's earlier shape, so format4is not changed in place: it is read. A format-4 checkpoint restores into the format-5 layout with its missing parts at their initial states — the detector'sWaitingand the reads' nothing held — because a 4.11.0 process had no such state to save: that is the state it held, not an invented default.Format
6carries the device's telemetry queue (in the client state's device,MobileDeviceState.telemetry: the undelivered events, their numbering and the health counters) and the process's navigation count (telemetry.navigationMoves), owner decision 2026-10-28 («го»): unsent events persist with the session, as the app keeps them on disk. It also carries the Android telemetry sender's process facts (android.telemetry-sender: when the process started, whether its app-start upload went out, when the health counters were last attempted), so a restored process continues the checkpointed one — its pending events are that process's own and go out when their reasons come due, never as a start's tail. Format5is read: a format-5 process held its events in memory and logged no navigation, so its device has no queue and its count is 0, and it ran no sender — the state it held.Format
7adds one field to the comments sheet's once-only reads (android.comments-sheet-reads): the composer sessions the process has focused, so the sheet logs its composer's tap and focus once per sheet and a second comment in the same sheet sends without re-opening it. Format6shipped in v4.15.0 without the set and is read: its sheets carry no comment-surface facts (that input is this build's), so they log no composer events and their reads restore with no session focused — the state they held.Format
8changes the sign-up's checkpointed session (android.registration-session): the registration context carries the launch-issuedaacevery sign-up request chains, and the create call's attestation pair is no longer stored — theagree()action requests it itself, so the completion reuses that call's pair and the session holds no nonce between screens. The login home's issued data (android.login-homepage-issued) also gains the launch'sregContextandregInfo, which the sign-up's steps chain. Format7is read: its context has noaac(the 453 sign-up's requests chain the launch's token, which a 7 process did not keep), its stored attestation is dropped with aStoredSnapshotFieldDroppedrecord, and its login-home issued data has neitherregContextnorregInfo.Format
8also carries the Android onboarding's flow state (android.onboarding-flow: the NUX flow's waterfall and session ids, the steps' session ids, the suggested accounts the discover-people step shows, the reels list's cursor and the reels tuning screen's counts), so a restored step logs under the ids the checkpointed process used. It shipped in v4.18.0; an earlier format restores the flow at its initial state (no onboarding begun).Format
9removes the routing value from the iOS process part (ios.process):ig-u-ruris the signed-in account's fact and lives in the checkpoint's client session (MobileSessionState.accounts), where every request reads it. Format8is read: theios.process.rurit carried is read in its release's shape and moves into the checkpoint account's record (a value the client session already placed there wins); a checkpoint that names no account drops it with a loggedStoredSnapshotFieldDropped.