Encryption
How PinkyBond encrypts messages and calls
Everything she shares with you is encrypted on her phone and decrypted on yours. Our server forwards sealed envelopes it cannot open. We never hold the key.
Built on platform cryptography
We did not write our own crypto. On iPhone we use Apple's CryptoKit. On Android we use Google's Tink. Curve25519 key agreement, HKDF-SHA256 and AES-256-GCM on both, pinned to each other by shared test vectors, so an iPhone and an Android phone produce byte-for-byte identical ciphertext.
Key agreement
Curve25519 (X25519) ECDH
Encryption
AES-256-GCM
Key derivation
HKDF-SHA256
What we do, and what we don't
Every row is checkable. The last three are where we fall short of the best messengers, and we would rather you read that here than find it out later.
| Dimension | PinkyBond |
|---|---|
| Encryption | AES-256-GCM, end-to-end between the two phones |
| Key agreement | Curve25519 (X25519) ECDH, then HKDF-SHA256 |
| Implementation | Apple CryptoKit on iPhone, Google Tink on Android — byte-for-byte interoperable |
| Key storage | iOS Keychain / Android Keystore, hardware-backed where available |
| Pairing | QR code in person, or a 6-character code / link exchanged remotely; both public keys exchanged |
| Verification | A 6-digit code on both phones confirms no one sat in the middle |
| Account | None — no phone number, no email, no password |
| Доступ сервера до вмісту повідомлень і дзвінків | Немає. Ми ніколи не маємо ключа. |
| What the relay stores | Ідентифікатор з'єднання, тип повідомлення, часова мітка, розмір, шифротекст — видаляється одразу після доставки, максимум 30 днів |
| Фото, відео та файли | До 2 ГБ, запечатані новим ключем для кожного файлу, який мають лише телефони твого з'єднання; видаляються одразу після завантаження, максимум 30 днів. Для партнерського застосунку, який ще не оновився: до 25 МБ під ключем з'єднання, зберігається 30 днів |
| Журнал дзвінків | Який телефон дзвонив, коли, голосовий чи відеодзвінок, результат і тривалість — доступно для читання нашим сервером, зберігається 90 днів, видаляється, коли ти скасовуєш з'єднання. Ніколи звук чи відео. |
| Push notifications | Carry no text; the phone decrypts locally |
| Safety Mode | Yes — her phone sends neutral substitute data instead of her real status. Your app shows no indicator, though the flag itself is in the snapshot. |
| Forward secrecy | No — one key per pairing |
| Open source | No |
| Independent audit | Not yet |
How pairing works
No phone number. No email. No account. In the same room, she shows a QR code and you scan it. Apart, she sends you a 6-character code or a link. Either way both phones exchange public keys, derive the same secret, and show a 6-digit verification code so the two of you can confirm no one sat in the middle.
She taps “Pair with partner” in PinkyBloom
Her phone generates a Curve25519 key pair (Apple CryptoKit on iPhone, Google Tink on Android)
She shows a QR code, or sends you a 6-character code or link if you are apart
You scan or enter it in PinkyBond, and your phone generates its own key pair
Your public key travels back to her the same way; both phones now hold both public keys
Each phone runs ECDH and HKDF-SHA256 to derive the same shared secret — nothing secret crosses the network
The shared secret is stored in the iOS Keychain or the Android Keystore
A 6-digit verification code appears on both phones; if they match, no one sat in the middle
The Blind Relay
Наш сервер — це поштова скринька для запечатаних конвертів. Він тримає шифротекст лише доки інший телефон не забере його, а тоді видаляє — максимум через 30 днів, якщо той телефон залишається офлайн. Він ніколи не має ключа. Push-сповіщення не містять тексту; телефон розшифровує локально.
PinkyBloom
Encrypts on her phone
Blind Relay
Тримає шифротекст до доставки, максимум 30 днів
Cannot decrypt
PinkyBond
Decrypts on your phone
Усе, що наш сервер зберігає про повідомлення, файл і дзвінок:
pairingId
Identifier for the pairing; not a name, number or email
senderRole
Which app sent it: PinkyBloom or PinkyBond
messageType
Який це тип конверта — наприклад, повідомлення чату, знімок статусу, підтвердження доставки чи налаштування дзвінка — ніколи те, що всередині
timestamp
When it was sent
ciphertext
AES-256-GCM blob we cannot open; its length is the only thing we can measure
retention
Видаляється, щойно інший телефон отримає його; максимум 30 днів, якщо він залишається офлайн
relayReceipts
Після доставки — запис без вмісту: яке це було повідомлення і чи було воно доставлене, чи термін дії вийшов. Зберігається 30 днів, щоб телефон відправника міг показати «не доставлено»
mediaObjects
Фото, голосові повідомлення, відео та файли до 2 ГБ, що зберігаються на Cloudflare R2 як шифротекст під новим ключем для кожного файлу, який передається лише всередині зашифрованого повідомлення. Видаляється, щойно телефон твоєї партнерки завантажить його; максимум 30 днів
callLog
Який із двох телефонів дзвонив, коли, голосовий чи відеодзвінок, прийнято, пропущено чи відхилено, і скільки тривало. Доступно для читання нашим сервером — саме так телефон, який був вимкнений, дізнається про пропущений дзвінок. Зберігається 90 днів, видаляється, коли ти скасовуєш з'єднання. Ніколи звук чи відео
Calls
Voice and video are peer-to-peer WebRTC with DTLS-SRTP and fresh keys for every call. The call setup rides the encrypted relay like any message. Before media flows, your phone checks the peer's DTLS fingerprint against a key derived from the pairing secret; a failed check aborts the call.
Коли мережа блокує прямий шлях, реле пересилає пакети, які не може прочитати. Жоден медіасервер ніколи не чує дзвінка, і жоден дзвінок не записується. Це працює між iPhone та Android. Що наш сервер справді зберігає — це журнал дзвінків: який телефон дзвонив, коли, голосовий чи відеодзвінок, результат і скільки тривало — протягом 90 днів, щоб партнерка, чий телефон був вимкнений, усе одно бачила пропущений дзвінок. Більше на /calls.
Safety Mode
Encryption protects her data from outsiders and from us. Safety Mode is for the case where the person on the other end is the concern. She can pause sharing at any time, and he is never notified. She can also turn on Safety Mode, which substitutes neutral data he cannot distinguish from a real update.
When Safety Mode is active, the partner sees:
Phase
“Follicular”
Mood
“Good”
Energy
3 (Moderate)
The neutral data is encrypted and sent through the normal relay, so it looks the same as a real update in transit and on his screen.
