Reverse-engineered documentation of WhatsApp Android internals. All findings are based on static analysis of the WhatsApp Android APK (apktool smali/resource decode, targeted JADX/Kotlin decompilation of individual classes).
More reports are coming soon: new topics and updates for every new APK version.
- Website: https://docs.baron0.com
- GitHub: https://github.com/7ucg
- Repository: https://github.com/7ucg/whatsapp-docs
- velowa: https://github.com/7ucg/velowa — WhatsApp Web multi-device library (TypeScript + Rust/WASM), the active client project behind these docs
- Discord: https://discord.gg/R77JyK2Fu6
- Telegram: https://t.me/wegschleifen
- Changelog
English is the original. Full translations: Deutsch, Español, Português (BR), Русский, العربية, Türkçe, available on https://docs.baron0.com (language switcher in the header) and in translations/. Translated files carry the SHA-1 of their English source; the site build warns when a translation is outdated.
| Report | Version | Description |
|---|---|---|
| WA Ban System | 2.26.41.6 | Full ban lifecycle, WFAC, suspicious marking, GraphQL protocol, spam signals, prevention |
| WA TCToken & CSToken | 2.26.41.6 | TCToken and CSToken internals, NctSalt sync, proto fields, Baileys implementation |
| WA Meta AI | 2.26.41.6 | Meta AI JIDs, proto fields, request/response protocol, why Baileys fails, fix |
| WA Reporting | 2.26.41.6 | Report types, SMAX spam_list, spam_flow entry points, reporting tokens, block, server errors |
| WA Client Integrity | 2.26.41.6 | Keystore attestation, Play Integrity, WASafe, root/emulator telemetry, what the client sends |
| WA Linked-Device Pairing | 2.26.41.6 | QR and pair-code flows, pair-device / pair-success, ADV signed identity, device list, unlink |
| WA Username | 2.26.41.6 | Username check/set/delete, username key, LID, w:mex operations and doc_ids, phone-number-sharing audience controls (2.26.45.10) |
| WA Account Security | 2.26.41.6 | Password login (#PWD_WA envelope), PIN, recovery email, passkeys, trusted devices, native OPAQUE |
| WA App-State Sync | 2.26.41.6 | syncd collections, patches/snapshots, MACs and LTHash, key sharing, 96 sync actions |
| WA Noise Transport | 2.26.41.6 | chatd over TCP, Noise XX handshake, ClientPayload, binary node encoding, reconnect, Tigon |
| WA Call Signaling | 2.26.41.6 | call stanzas, offer and call key, rekey, relay and media path, group calls, links, call log |
| WA Media Upload | 2.26.41.6 | media_conn, upload/download URLs, HKDF media keys, AES-CBC + HMAC, resume/retry, result codes, native hardening |
| WA USync | 2.26.41.6 | usync, contact and device sync, 4 modes, 10 contexts, 30 sync types, LID mapping |
| WA Group History | 2.26.41.6 | sending recent group history to new members, history sync of companion devices, addressing modes |
| WA Broadcast Lists | 2.26.41.6 | w:b list IQs, fan-out, monthly quota, spam-warning bans, status@broadcast |
| WA WAM Analytics | 2.26.41.6 | WAM event model, 4 channels, w:stats upload, private stats, daily events, on-device buffer format |
| WA AB Props | 2.26.41.6 | flag tables (21,424 ids), MobileConfig, props sync, storage, overrides, flag catalog |
| WA Local Storage | 2.26.41.6 | msgstore.db and wa.db, key tables, prefs, caches, backups, logout wipe paths |
| WA Message Secrets | 2.26.41.6 | messageSecret, HKDF use-case keys, encrypted reactions, polls and events, message stanza extensions |
| WA Interop | 2.26.41.6 | third-party chat interop (gated off): w:interop IQs, InteropMessage, JID domains, consent |
| WA Censorship Circumvention | 2.26.41.6 | WhatsApp Proxy, Psiphon SOCKS tunnel, unblocking push, registration relay, what is absent |
| WA Server-Driven UI | 2.26.41.6 | Phoenix, Bloks, native flows and WhatsApp Flows, payload formats, actions, security |
| WA Account-less Surface | 2.26.41.6 | pre-registration screens, deep links, hosts, identifiers, 97 exported components |
| WA Payments | 2.26.41.6 | payment message types, India UPI/NPCI CL credential layer, GraphQL doc_ids, decline/error handling |
| WA Managed Account | 2.26.41.6 | parental supervision (sponsor/dependent), distinct from BSP/Cloud-API business delegation |
| WA View-Once | 2.26.41.6 | proto marking, FLAG_SECURE enforcement, local deletion job, the unavailable error case |
| WA Client Mod Detection | 2.26.41.6 | mod/tamper detection surface, the generic ACRA mod probe, WaEnhancer attack surface |
| WA Channels & Newsletters | 2.26.41.6 | channel JID/follow flow, admin invites, newsletter message types, the xmlns=newsletter IQ protocol |
| WA Polls | 2.26.41.6 | poll message version history (v2-v6), vote privacy model, result snapshots, option hashing |
| WA Stickers | 2.26.41.6 | sticker/lottie/pack message types, third-party pack intent & content-provider contract |
| WA Events | 2.26.41.6 | calendar-style events, encrypted RSVP responses, lifecycle, visibility model |
| WA Call Links | 2.26.41.6 | guest call links, link_query/link_join handshake, waiting room, guest JID allocation, relay/key handoff |
| WA Groups & Communities | 2.26.41.6 | parent/linked/default sub-groups, addressing, w:g2/w:gp2, group+community MEX ops, invites, admin settings, community join approval |
| WA Hatch/Muse AI Agent | 2.26.41.6 | attested Noise-gateway VM transport, native carrier + SEV-SNP attestation, agent-browser noVNC stream, workspace (spaces, feed, goals, ideas, approvals, connectors), Vesta OPAQUE identity/PIN recovery, paid tier, reachability verdict |
| WA Org Accounts | 2.26.45.10 | org_id/member directory membership model, invite-link + email-OTP join flow, GraphQlOrgApi/OrgEmailCodeClient ops, distinction from Managed Account and Business API delegation |
| WA Teen Accounts | 2.26.45.10 | vpc/sponsor parental review (approve/decline/cannot-review), sponsor age-verification gate, account_deletion_time_ms countdown, distinction from Managed Account |
| WA Business App | 2.26.45.7 (Business) / 2.26.45.10 (consumer) | com.whatsapp.w4b vs consumer APK diff: 45 Business-only package roots, exclusive React Native + Fresco stack, facebook-schema GraphQL asymmetry (215 ops), permission diff, distinction from Business API/Cloud API and Managed Account |
- Ban system (WFAC lifecycle, GraphQL BizIntegrityQuery, trust tiers)
- Suspicious marking (when, why, ML signals, prevention)
- Report system (SMAX stanzas, spam_list, all report types)
- XMPP protocol details (stanza structures, binary token dictionary)
- Client-side signal collection (dhash, message velocity, broadcast limits, WaFA)
- Meta AI bots (JIDs, proto fields, Hatch/Muse AI agent, Private Search)
- Reporting, client integrity/attestation, linked-device pairing, usernames
- Groups and communities (structure, addressing, membership, join approval), org accounts
- All analysis is static — no traffic interception
- Obfuscated class names (e.g.
C39833Hhl) reflect JADX output - Server-side ML logic is inferred from client-collected metrics