1. Scan the pair QR
Payload shape:
Parse carefully; reject anything that is not
fau://pair. Details:
Pairing.
2. Generate a device key and pair
Create an Ed25519 keypair on device. Keep the secret in platform secure storage (ideally behind biometrics). Send only the public key:device_id + secret key + host (+ fingerprint). Pairing is unsigned by
necessity; every later call is signed.
3. Poll pending (signed)
summary, agent_domain, match_code, and for kind: "send" the draft fields
in detail.draft. Never invent mail that is not in the payload.
4. Decide (signed)
Success:
{"ok": true}. Full catalog: Phone API.
5. Register for push (optional but expected)
After permission and your own Expo/APNs setup:.p8. See
Push notifications.