This 44-page whitepaper, version June 26, 2026, explains the algorithms and design decisions behind Threema’s cryptography. It covers end-to-end and transport encryption, key generation and verification, the Ibex perfect forward secrecy protocol, group messaging, multi-device communication, local data protection, DualLock, contact synchronization, encrypted calls, and Threema Safe backups. Technical details include Curve25519, XSalsa20, Poly1305, key derivation, platform-specific storage, and backup server interfaces. The document notes that the multi-device protocol currently lacks perfect forward secrecy.
Free preview text
The first 5 pages, shown as text so search engines and readers can find this document.
Page 1
Cryptography Whitepaper
Threema uses modern cryptography based on open source components
that strike an optimal balance between security, performance and mes-
sage size. In this whitepaper, the algorithms and design decisions be-
hind the cryptography in Threema are explained.
Version: June 26, 2026
Page 2
Contents
Overview 4
Open Source 5
End-to-End Encryption 5
Key Generation and Registration 5
Key Distribution and Trust 6
Message Encryption 7
Perfect Forward Secrecy (PFS) 8
Group Messaging 9
Key Backup 10
Client-Server Protocol Description 11
Chat Server Protocol 11
Directory Access Protocol 12
Media Access Protocol 12
Multi-Device Protocol 13
Cryptography Details 18
Key Lengths 18
Random Number Generation 19
Padding 19
Repudiability 20
Replay Prevention 20
Local Encryption 21
Key Storage 21
Data Storage 22
Additional Protection with DualLock 24
Push Notifications 27
iOS 27
Android 27
2/44 Threema • Cryptography Whitepaper
Page 3
Address Book Synchronization 27
Use of HMAC Keys 28
A Word About Hashing Phone Numbers 28
Linking 28
ID Revocation 29
An Example 29
Profile Pictures 29
Web Client / Desktop 1.0 App 30
Architecture 30
Connection Buildup 31
WebRTC Signaling 33
WebRTC Connection Buildup 33
Trusted Keys / Stored Sessions 33
Push Service 34
Self Hosting 34
Threema Calls 35
WebRTC Encryption 35
1:1 Calls 35
Group Calls 36
Threema Safe 39
Overview 39
Backup Format 40
Encryption 40
Upload / Storage 41
Backup Intervals 41
Restore / Decryption 41
Running a Custom Threema Safe Server 42
3/44 Threema • Cryptography Whitepaper
Page 4
Overview
Threema uses two different encryption layers to protect messages between the sender and
the recipient.
• End-to-end encryption layer: this layer is between the sender and the recipient.
• Transport layer: each end-to-end encrypted message is encrypted again for transport
between the client and the server, in order to protect the header information.
These layers and other important aspects of the cryptography in Threema are described
in detail in the following chapters. The crucial part is that the end-to-end encryption layer
passes through the server uninterrupted; the server cannot remove the inner encryption
layer.
4/44 Threema • Cryptography Whitepaper
Page 5
Open Source
The Threema apps for iOS, Android, and Desktop as well as all components of the web
client are published under open source licenses:
• iOS app: github.com/threema-ch/threema-ios
• Android app: github.com/threema-ch/threema-android
• Desktop 2.0 app: github.com/threema-ch/threema-desktop
• Web client: github.com/threema-ch/threema-web
• SaltyRTC server: github.com/saltyrtc/saltyrtc-server-python
• Push relay: github.com/threema-ch/push-relay
End-to-End Encryption
In Threema, all messages (whether they are simple text messages, or contain media like
images, videos or audio recordings) are end-to-end encrypted. For this purpose, every
Threema user has a unique asymmetric key pair consisting of a public and a private key
based on Elliptic Curve Cryptography. These two keys are mathematically related, but it
is not technically feasible to calculate the private key given only the public key. In addition,
an additional protocol layer ensures PFS.
Key Generation and Registration
When a Threema user sets up the app for the first time, the following process is performed:
1. The app generates a new key pair by choosing a private key at random1, storing it se-
curely on the device, and calculating the corresponding public key over the Elliptic Curve
(Curve25519).
2. The app sends the public key to the server.
3. The server stores the public key and assigns a new random Threema ID, consisting of 8
characters out of A-Z/0-9.
4. The app stores the received Threema ID along with the public and private key in secure
storage on the device.
1including entropy generated by user interaction; see section “Random Number Generation” for details
5/44 Threema • Cryptography Whitepaper
Cryptography Whitepaper: summary, contents and background
This guide helps you understand the scope of Cryptography Whitepaper before or alongside reading the original document. It is based on the catalogue record, credited creator, source, classification and topics shown on this page. It does not replace the original work and does not invent claims about passages that Doxxly cannot verify.
Summary and overview
Cryptography Whitepaper is a 44-page documentcredited to Freya B. Ellwood. This 44-page whitepaper, version June 26, 2026, explains the algorithms and design decisions behind Threema’s cryptography. It covers end-to-end and transport encryption, key generation and verification, the Ibex perfect forward secrecy protocol, group messaging, multi-device communication, local data protection, DualLock, contact synchronization, encrypted calls, and Threema Safe backups. Technical details include Curve25519, XSalsa20, Poly1305, key derivation, platform-specific storage, and backup server interfaces. The document notes that the multi-device protocol currently lacks perfect forward secrecy. It appears in the Technology & Security collection, which groups it with other material that readers may use for comparison and further study.
The item can be approached in several ways. A reader looking for a quick orientation can begin with the free five-page preview, inspect the page structure and use the metadata to judge relevance. Someone undertaking deeper research can work through the complete file, search its indexed text, record useful page references and compare its treatment of Threema, Cryptography, Whitepaper, End-to-End Encryption, Secure Messaging, Perfect Forward Secrecy, Key Management, Multi-Device Protocol, Local Encryption, DualLock, WebRTC, Encrypted Backups with the related resources linked below.
Rather than reducing the work to a single claim, this page treats it as a source that should be read in context. The title, creator, publication source, licence and format all help explain what kind of evidence it may offer. Readers should distinguish the original author's statements from Doxxly's catalogue description, and should cite the original edition when using the material in academic, professional or published work.
Key topics and reader takeaways
The catalogue connects this document with Threema, Cryptography, Whitepaper, End-to-End Encryption, Secure Messaging, Perfect Forward Secrecy, Key Management, Multi-Device Protocol, Local Encryption, DualLock, WebRTC, Encrypted Backups. These terms offer practical entry points rather than a substitute for close reading. Start by identifying the definitions, examples, arguments, tables or visual explanations attached to each topic. Then note where the creator draws connections, makes distinctions or moves from background material to a conclusion, recommendation, calculation or narrative development.
A useful reading method is to separate description from interpretation. First record what the item actually presents: names, headings, figures, formulas, quotations or stated propositions. Next consider why those details matter within the whole work. Finally compare them with another source from the same subject area. This process helps turn a long digital file into evidence that can be evaluated rather than merely skimmed.
Table of contents and reading guide
The following is an editorial content guide based on the verified catalogue topics. It is not represented as the original author's formal table of contents. Use it to organise notes while moving through the 44 pages in the player.
Part 1
Threema
Use this section of the reading guide to identify how Threema appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
Part 2
Cryptography
Use this section of the reading guide to identify how Cryptography appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
Part 3
Whitepaper
Use this section of the reading guide to identify how Whitepaper appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
Part 4
End-to-End Encryption
Use this section of the reading guide to identify how End-to-End Encryption appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
Part 5
Secure Messaging
Use this section of the reading guide to identify how Secure Messaging appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
Part 6
Perfect Forward Secrecy
Use this section of the reading guide to identify how Perfect Forward Secrecy appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
Part 7
Key Management
Use this section of the reading guide to identify how Key Management appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
Part 8
Multi-Device Protocol
Use this section of the reading guide to identify how Multi-Device Protocol appears in Cryptography Whitepaper, note important terms, and connect the subject to the wider purpose of the work.
When a heading in the original differs from this guide, follow the original heading in your citation. Page numbers can also vary between editions. Doxxly's direct page field is useful for navigation, but formal references should include the title, creator, source and edition details available in the file itself.
About Freya B. Ellwood
Doxxly credits Freya B. Ellwood as the author or creator of Cryptography Whitepaper. This page does not add an unverified biography, job title or institutional affiliation. The attribution is preserved so readers can distinguish the creator from the hosting library and follow the original record when an external author link is available.
Author context matters because a work reflects a particular purpose, audience and point of view. Before relying on the material, consider what the creator set out to explain, when the source was produced and whether later research or revised guidance should also be consulted. For literature and philosophy, compare translations and editions; for technical material, check whether a newer version has superseded the one shown here.
About the source organisation
The recorded source for this item is threema.com. Doxxly provides access and discovery tools but does not claim to be the original publisher unless explicitly stated. Source links, creator attribution and the recorded Publicly available file collected for editorial review licence are displayed to help readers assess provenance and permitted use.
Provenance is especially important for reports, standards, presentations and working spreadsheets. Check the original source for amendments, supporting files and current policy. A trustworthy research workflow keeps the source URL with any notes or downloaded copy, verifies important figures against the original, and avoids treating an archived document as automatically current.
Begin with the title and opening pages, then use the guide above to decide whether to read sequentially or move to a particular topic. The Doxxly player provides previous and next navigation, a direct page field, zoom steps, fit-to-width and fit-to-page modes, rotation and fullscreen. These controls are useful when a page contains small type, a wide table, an image, a scanned layout or a dense sequence of notes.
The first five pages are open to every visitor. A plan unlocks the complete item and full-document search. Search is best used for distinctive names, technical terms or short phrases; broad words can produce too many possible contexts. When you find a useful passage, read the surrounding pages so that a sentence, chart or formula is not separated from its explanation.
If downloading is enabled, members can obtain the original PDF file. Keep the original format when formulas, slide sequencing, pagination or layout carries meaning. Respect the Publicly available file collected for editorial review terms displayed on this page, and use the rights-report link if you believe the attribution or availability needs review.
Research questions to consider
As you read Cryptography Whitepaper, ask which audience the creator addresses, what problem or idea organises the work, what evidence is presented, and which assumptions remain unstated. Note whether important terms are defined consistently and whether examples represent a broader pattern or a narrow case. For quantitative material, record units, time periods, formulas and data sources. For interpretive material, separate the creator's language from your own summary.
A second set of questions concerns relevance today. Which parts remain durable, which depend on their historical or institutional setting, and what would need confirmation from a newer source? Following the tags and the Technology & Security collection can reveal useful comparisons. Agreement between sources can strengthen confidence, while disagreement can point to changing definitions, methods, evidence or priorities.
Finally, decide what you need from the item: background knowledge, a quotation, a worked example, a model, a visual explanation or a starting bibliography. That purpose should guide the depth of reading and the notes you keep. Doxxly helps locate and navigate the source; careful interpretation remains the reader's responsibility.