# Talkie Sync

> Three random words → one shared session.
> A lightweight ephemeral pairing protocol API. No accounts, no infra to build.

## Docs
- Protocol spec: https://github.com/talkie-sync/talkie-sync/blob/main/pair-relay-spec.md
- TypeScript SDK: https://github.com/talkie-sync/client-ts
- npm package: `talkie-sync`

## API endpoints
- `POST /api/pair` — create a pair (returns words, session_id, channel_id)
- `POST /api/pair` — claim a pair (send `{"words": "..."}`)
- `POST /api/pair/:channelId/messages` — push a message (`{"payload": "..."}`)
- `GET /api/pair/:channelId/messages?after=N` — list messages since seq N
- `GET /api/pair/:channelId/messages?after=N&poll=1&timeout=25000` — long-poll

## Key features
- Three PGP words as pairing code
- Fuzzy matching (Levenshtein ≤ 2)
- AES-256-GCM encrypted session exchange
- Long-poll for real-time message delivery
- Per-IP exponential backoff on failed claims
- TypeScript client with optional payload encryption

## Pricing
- Free: 100 pairs/day, 5 messages/sec
- Creator ($5/mo): 10K pairs/month, 20 messages/sec
- Pro ($12/mo): unlimited pairs and messages, priority support

## Contact
bench@talkie.oskite.com