Skip to main content
Assumes a user’s Mac node is running and they can show a pairing QR (menu bar setup / dashboard Pair a phone).

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:
Success:
Store device_id + secret key + host (+ fingerprint). Pairing is unsigned by necessity; every later call is signed.

3. Poll pending (signed)

Canonical string and vectors: Device signing.
Render 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)

Common decisions: Success: {"ok": true}. Full catalog: Phone API.

5. Register for push (optional but expected)

After permission and your own Expo/APNs setup:
The node does not mint tokens and does not hold your APNs .p8. See Push notifications.

Minimal loop

Polling remains mandatory. Push is best-effort wake.