Skip to content

About

Reverse-engineered documentation of WhatsApp Android internals

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Latest commit

 

History

53 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

whatsapp-docs

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.

Links

Languages

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.

Reports

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

Scope

  • 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

Notes

  • 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

About

Reverse-engineered documentation of WhatsApp Android internals

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Contributors

Languages