OptionaladdressOptionaladsWhen the install last downloaded its Enigma conversion list
(IGEnigmaEncryptedConversionQuery), on the device clock; absent means it
never has. The launch sends the query for an install that never downloaded.
OptionaladsThe install's ads key (see AdsKey): minted once, at the first launch
that needs it (EnsureAdsKey), and kept for the install's life. Absent means
the install has not minted one yet.
OptionaladsWhether the device opted out of ad tracking (the tracking permission denied,
"Allow Apps to Request to Track" off): iOS sends it as x-ads-opt-out (1
opted out, 0 allowed). A device fact, not a session one, and not derivable
— how the app maps the permission to the header is not known. Optional:
absent renders 0 (tracking allowed).
OptionalandroidThe device's performance class, sent as
bk_context.android_device_performance_class on Bloks app-root requests.
A device fact beside gpuMemoryMb, also the device's own: the Redroid
emulator and a 451 phone both report 0.
The Android generator sets that value; a device without the fact
sends null. Optional: absent renders null.
OptionalaymhAccounts the device may have (AYMH), sent as
client_input_params.aymh_accounts on send_login_request. Device-local
saved-account state, empty on a first login. Optional: absent renders []
(the older 448 devices); one 448 device carries one blank entry.
OptionalbatteryThe simulation the device's battery and charging readings are derived
from: the level at startedAtMs, the discharge while it is not charging
and whether it is on charge. The reading itself is not stored — every
request reads it at its own time (batteryReadingOf in mobile.device.ts),
so a snapshot carries the simulation, never a stale measurement. Absent, the
reading is simulated from the device id and the clock.
OptionalbootedWhen the device booted, epoch ms: the uptime the telemetry logger reports
(system_uptime of the health counters, a perf event's
time_since_boot_ms) counts from it. A device keeps it in the snapshot. It
has one writer, the Android platform's process telemetry
(makeAndroidProcessTelemetry.attach, android.telemetry.ts): a device
whose state holds none takes its process's start minus the recorded uptime
of a fresh device at its first start
(ANDROID_DEVICE_UPTIME_AT_FIRST_START_MS, packages/android/src/telemetry/spec/).
The uptime readers only read it.
OptionalcloudThe Meta cloud trust token stored on the device (two upper-case UUIDs
written back to back, 72 characters), sent by iOS as x-cloud-trust-token.
Optional: how the app derives it on a new device is not known, so a
device without it sends no header rather than an invented token.
OptionalcurrentThe keyboard language currently in use (ru-RU), iOS x-ig-device-languages.
OptionaldeviceThe email of the account the phone's account manager holds — the address
the app's prefill lookup finds when the post-registration onboarding's
email step opens (found_email_for_prefill, source: android_account_manager, #978). A device fact, not the app account's: the
signing-up person's Instagram account has no email (the recording's step
prompts to add one), while the phone's own account does. Three states:
absent means the device has not declared one, and a generated or restored
device gets an address on the reserved example.com domain generated from
its id; null means the phone's account manager holds no account, which the
caller or the scene declares — the lookup finds none, the event is not
logged, and no restore fills it; a string is the address the lookup finds.
OptionaldeviceWhether the Android Credential Manager holds a saved credential for the
app's account. Beside deviceAccountEmail, and independent of it: a
phone can hold the account and no saved credential, which is the
recording's case — the onboarding's email step prompts the Credential
Manager and logs nux_step_error with
android.credentials.GetCredentialException.TYPE_NO_CREDENTIAL (#978).
Absent or false means no saved credential.
OptionaldeviceThe device's hardware decode capability block (hw_av1_dec, chip_name,
core_count, …) as the device holds it; the request that sends it
(clips/discover/stream's device_status) serializes it. The library
models no hardware: absent renders an empty object.
OptionalexpThe experiment exposure the Android app's analytics logger stored in an
earlier process, which its Pigeon uploads carry as x-fb-exp-tag: the
exposure (qrt8254_v31079:off in every 451 recording that carries one) and
how many lines of it the upload's header joins. A fact of the device before
the process, beside the account's x-fb-tasos-td-config
(packages/core/src/android/spec/android-throttling-detector-…-x-fb-exp-tag.md):
no recorded answer carries it, so the library never derives it, and a
device whose recording shows it declares it. A device without it sends no
x-fb-exp-tag. Optional.
OptionalfamilyPersisted flag: whether the family device id / app-scoped device id pair
has already been synced with the server. A fresh install syncs it once
(FamilyDeviceIDAppScopedDeviceIDSyncMutation); a device that already ran
the sync skips it. Absent means not yet synced (fresh), matching the
older 448 devices; one 448 device declares it true.
OptionalfbnsThe Android device's FBNS key: the P-256 key the app's own push service
(FBNS) creates once per install — one key across processes, logins and
notification-gateway connections — and binds those connections to. publicKey is the 65-byte key 0x40 ‖ X ‖ Y in lower-case
hex (the app's pub_key), createdAt its creation time in milliseconds.
The device's push token is computed from it (packages/android/src/simulation/android.fbns-token.ts),
exactly as the server's notification gateway returns it. Absent until the
first push registration creates it.
OptionalfcmThe Google (FCM) registration token the phone's Google Play services issue
the app — the token the app's second push channel registers as
device_type=android_fcm. A device fact the library cannot obtain: it is a
caller input (AndroidIgpapiOptions.fcmToken), supplied by a caller or a
scene, never generated — a push token a service issues is not a device
measurement (“Architecture”, “Identities a service issues are not
measurements”). The caller's token replaces a restored snapshot's; a
snapshot keeps the token it was saved with. Absent means the device has no
Google push channel: the launch registers only its FBNS channel, as a phone
without Play services does. The recorded form is 11 characters, :APA91b,
113 characters (131 in all).
OptionalflashAndroid runtime-permission grants the account-recovery search screen offers
as client_input_params.flash_call_permissions_status. Device state the
library cannot query. Optional: absent renders every permission DENIED
(the login flow's spelling); the recovery flow's device granted
READ_PHONE_STATE.
OptionalgmsGoogle Mobile Services incoming-call-retriever eligibility, sent as
client_input_params.gms_incoming_call_retriever_eligibility on
send_login_request. The 448 login-home action script picks eligible /
not_eligible from a device GMS signal the library cannot query, so it is
device state. Optional: absent renders eligible (the older 448
devices); one 448 device reports not_eligible.
OptionalgpuThe device's GPU memory, sent as bk_context.gpu_memory_mb on Bloks
app-root requests. A device fact, never a build's: devices
differ (a Redroid emulator reports 2048, a 6 GB phone 6144), so a
declared reference device declares what its own value is. The Android generator
models no hardware and sets the Redroid emulator's 2048; a device without the
fact sends null. Optional: absent renders null.
OptionalhasWhether the app holds the camera permission, sent as the timeline's has_camera_permission; absent renders 1.
OptionalhasWhether the device has a Google advertising id (device.adid is a Google
Play Services value): the Android feed and explore requests carry it as
x-google-ad-id, and a device without one sends nothing. Optional: absent
means the device has one. A device without Play Services is built without
it (hasGoogleAdId: false), so no request carries an id the app would not
send.
OptionalhasWhether the app may post notifications (Android's notification permission),
reported as push/register's os_settings.notificationEnabled. A device
fact the library cannot query: the app reports false on a fresh install
and true once the permission is granted. Optional: absent renders false —
a fresh device has not been granted it.
OptionalinputThe device's current input language — the language its keyboard is set to, one of the installed keyboards' languages and its own fact (the recordings show it first for one device and second for another). A device fact the generator derives from the profile, like inputMethods; a caller who wants a particular one declares a device state of its own.
OptionalinputThe device's installed input methods (keyboards), the fact
ZeroDayLanguageSignalUpload reports. A device fact, never caller input:
the generator derives the list from the device's profile (the device id and
descriptor — a Samsung device carries the Samsung keyboard) and the same
list comes back across restores (settleAndroidDeviceFacts), and a caller
who wants particular keyboards declares a device state of its own.
OptionalisWhether the device is in dark mode: the app reports it as is_dark_mode on
the feed and Explore requests. Optional: absent reads as light, the value
every recording without the field carries.
OptionalisDevice foldable state, sent as x-ig-is-foldable. Optional: absent when the
caller does not model the device's fold posture; the Android header layer
renders false then. One 448 device is foldable (true); the older
448 devices report false.
OptionalkeyboardThe configured keyboard language (ru-RU), iOS x-ig-device-languages.
OptionallastWhen this install last registered its main push channel successfully
(push/register answered ok), in milliseconds: the app's
push_reg_date. A process start with a stored session registers again
when it is absent or more than five hours away from the clock. Absent: the
install never registered.
OptionallocationThe device's known coarse location, when it has one. AccountSerp sends
it as the lat/lng query fields; the typeahead sends none on either
app version (450 and 451), so it does not read this. Absent means
the device has no known position (no permission or no fix), and then the
SERP request carries no coordinates.
OptionalmobileThe MobileConfig values the server sent this device in its
launcher/mobileconfig answers, for the parameters the library declares
(mobile.mobile-config.ts). Absent until an answer is kept: every
parameter reads the app's built-in default.
OptionalnetworkThe network the device is on, the single source of every network-dependent
wire value (see MobileNetwork). Absent means the default network,
cellular LTE (read it through networkOf): the device generators set it,
and snapshots made before the field existed restore without it.
A device is on a client network, Wi-Fi or cellular LTE. A device may be presented on a network the client state does not model (the emulator's Ethernet NIC); that is not a value of this field, and no builder sends it.
OptionalnetworkOptional telephony/network profile. Request builders emit it as
si_device_param_network_info only when present.
OptionalnetworkThe network-session id (nid=) of the Android x-fb-session-id header the
device's network stack last used. It is the session a new process starts
from — the nid the earlier process left — and the process replaces it when
it opens its own network session (AndroidNetworkSession), so the device
only ever holds the current one. Optional: a device that never had a
session, or one restored from a snapshot made before the field existed,
sends no pair rather than an invented id.
OptionalpigeonWhat the app's Pigeon logger keeps of the upload's answers, by the identity
the answer was for (PigeonIdentityStatesSchema): the viewer's id, or ''
for the anonymous identity. Absent until an answer is kept: an identity the
map does not name has been served nothing, and its upload echoes the empty
checksum.
OptionalpushLazily populated on first Android push registration. See EnsurePushHpkeIdentity.
OptionalpushThe iOS device's APNs push token, which Apple issues and the library cannot
obtain. A device fact, not a launch input: the caller supplies it through
IosIgpapi.install({ pushToken, … }), or a restored snapshot carries it;
absent, iOS registers no push. An Android device registers its own FBNS
token from fbnsKey and takes no caller token; on Android the field
is only an earlier release's fact — a device restored from a release that
registered a caller's token counts as having registered before.
OptionalradioThe body radio_type, derived from network (radioTypeOf): a
second spelling of the one network fact, kept so a restored device carries
it without re-settling. Absent when the network has no body spelling
(the Ethernet-only view), and then no builder sends it.
OptionalramThe device's memory in gigabytes (fractional, as the app reads it), sent as
ram_size_in_gb by the Explore tab's autoplay configuration. A device fact
beside deviceStatus; the library models no hardware, so absent
renders the parameter empty (ram_size_in_gb=): the request always carries
core_count, device_status and ram_size_in_gb (the 451 app sends all
three on the tab), and a device that declares no hardware reports them
empty, as the other hardware-reporting requests do.
OptionalrmdThe routing map the install holds: set when a fetch's answer was accepted
(EnterUrlEligibleRmd, the one writer) and by a scenario's device
declaration. The map belongs to the install, not to a user session: every
account that runs on the device and every later process finds it, a login
in a process that holds it keeps it, and absent means the install holds
none (a fetch then reports no-valid-map). What a process reports of it is
read through rmdReportedOf.
OptionalrmdThe two trailing numbers of the no-valid-map x-fb-rmd value, once this
install has reported one (see RmdNoValidMapTimes and
rmdNoValidMapTimesOf). Written by KeepRmdNoValidMapTimes
when the fetch first reports the no-valid-map state, and by a scenario's
device declaration; absent until then, and read through
rmdNoValidMapTimesOf.
OptionalsystemThe device's system languages in the user's order (['ru-ID', 'id-ID']),
sent by iOS in x-ig-device-languages. Optional: without it the iOS layer
sends the system locale alone.
OptionalsystemThe system locale of the device (ru-ID: Russian language, Indonesian
region), not the app language (language, ru_RU). iOS sends it as
x-ig-device-locale. Optional: without it the iOS header layer renders the
app language in that spelling.
OptionaltelemetryThe telemetry this device logged and has not delivered, with the number the
next event gets and the health counters since the last health upload
(MobileTelemetryQueue, mobile.telemetry.ts). In the snapshot, as the app
keeps it on disk: a restored device sends the tail on its next start and
continues the numbering. Absent until the first event is logged.
OptionaltimezoneIANA timezone name (TimeZone.getDefault().getID()), sent as
device_timezone_name on feed-surface requests. Optional: absent when the
caller does not model a zone name.
OptionalusdidLazily populated on first USDID-related operation. See EnsureUsdidIdentity.
OptionalvideoThe video encoders the device's media stack lists, as the app reports them
in the upload settings it sends before a video (codec). A device fact,
never a build's: it follows the hardware and the OS image. The Android
generator reports the descriptor's own release's AOSP software encoders
(android.state.ts, one cited file per release); no public source maps a
phone model to its vendor encoders, so a generated device claims none, and
a caller that knows a real device's list passes it in the snapshot. A
declared reference device takes its own list
(AndroidDeviceProfile.videoEncoders). Optional: a device that lists none
reports an empty codec object.
OptionalwifiThe BSSID of the Wi-Fi access point the device is attached to, in the
lower-case colon spelling the app reports. The 453 sign-up recording sends
it as the x-network-signal REST header on every REST call of the process
(the 448 and 451 recordings carry no such header). A device fact: a device
on a network without it sends none. Optional: absent renders no header.
OptionalzeroThe zero-campaign attestation key, once the device has created and uploaded
one. Presence is device state: a device that holds a key is a used device,
a fresh install holds none. The library never creates or uploads the key,
and it does not send x-meta-zca; the key is carried in the snapshot for
the work that models the token and its upload.
The device's address book: the contacts
address_book/linkuploads (@igpapi/mobile'sAddressBookLink), one entry per contact in the domain's fields — the brick spells them to the wire's snake_case. A device fact, never caller input: the generator makes plausible entries from the device id and the same book comes back across restores (settleAndroidDeviceFacts), and a caller who wants particular entries declares a device state of its own (a snapshot), like the other device facts. The recorded contacts belong to a real person and are never used; only their shape is modelled.