SashegDev
096c4d0a2d
Серверная часть (Go): - WebSocket сервер с бинарным протоколом - XChaCha20-Poly1305 шифрование - zstd сжатие с дедупликацией (64KB чанки) - SQLite хранилище (WAL режим) - Управление гильдиями, каналами, ролями - Федерация между серверами (ed25519) - REST API + WebSocket endpoints Клиентская часть (Flutter): - Material Design 3 тёмная тема (Discord-like) - WebSocket соединение с сервером - Экраны: сплэш, логин, домашний, гильдии, чат - Модели: пользователи, гильдии, каналы, сообщения, роли - Сервисы: соединение, API, криптография, тема - Виджеты: иконки гильдий, сообщения, ввод чата - Web сборка (PWA) Документация: - AGENTS.md — контекст для ИИ ассистентов - docs/protocol.md — спецификация протокола
93 lines
2.7 KiB
Markdown
93 lines
2.7 KiB
Markdown
# JAM Protocol v0.1
|
|
|
|
## Transport
|
|
- WebSocket (ws:// or wss://) at `/ws`
|
|
- REST API at `/api/*`
|
|
- Federation at `/federation/receive`
|
|
|
|
## WebSocket Packet Format
|
|
```json
|
|
{
|
|
"op": <int>,
|
|
"d": <object>,
|
|
"s": <int> // sequence number
|
|
}
|
|
```
|
|
|
|
## Opcodes
|
|
| Op | Name | Direction | Description |
|
|
|----|------|-----------|-------------|
|
|
| 0 | Heartbeat | C↔S | Keepalive |
|
|
| 1 | Hello | S→C | Server greeting |
|
|
| 2 | Authenticate | C→S | Login/register |
|
|
| 3 | Authenticated | S→C | Auth success |
|
|
| 4 | Error | S→C | Error response |
|
|
| 10 | MessageCreate | C↔S | Send message |
|
|
| 11 | MessageUpdate | C↔S | Edit message |
|
|
| 12 | MessageDelete | C↔S | Delete message |
|
|
| 13 | MessageReaction | C↔S | Add/remove reaction |
|
|
| 20 | ChannelCreate | S→C | New channel |
|
|
| 21 | ChannelUpdate | S→C | Channel updated |
|
|
| 22 | ChannelDelete | S→C | Channel deleted |
|
|
| 30 | GuildCreate | S→C | New guild |
|
|
| 31 | GuildUpdate | S→C | Guild updated |
|
|
| 40 | VoiceStateUpdate | C↔S | Voice channel join/leave |
|
|
| 50 | StreamStart | C↔S | Start stream |
|
|
| 51 | StreamEnd | C↔S | End stream |
|
|
| 60 | TypingStart | C↔S | User typing |
|
|
| 70 | UserPresence | S→C | Presence update |
|
|
| 80 | FederationPacket | S↔S | Server-to-server data |
|
|
| 90 | CallOffer | C↔S | WebRTC offer |
|
|
| 91 | CallAnswer | C↔S | WebRTC answer |
|
|
| 92 | CallICE | C↔S | ICE candidate |
|
|
| 93 | CallEnd | C↔S | End call |
|
|
|
|
## Encryption
|
|
- Algorithm: XChaCha20-Poly1305
|
|
- Key exchange: X25519
|
|
- Key derivation: Argon2id
|
|
- Nonce: 24 bytes random
|
|
- Messages with `encrypted: true` have content encrypted with the channel's session key
|
|
|
|
## Compression
|
|
- Algorithm: zstd (level: best compression)
|
|
- Window size: 16MB
|
|
- Deduplication: 64KB chunks, SHA256 hash
|
|
- Only files > 1KB are compressed
|
|
- Ratio target: 10MB → 512KB-2MB
|
|
|
|
## Federation
|
|
- HTTP POST to `https://<peer>/federation/receive`
|
|
- Headers: `X-JAM-Domain`, `X-JAM-Signature` (ed25519)
|
|
- Body: `FederationData` JSON
|
|
- Peers discovered via manual configuration
|
|
|
|
## REST API
|
|
### Health
|
|
`GET /api/health`
|
|
|
|
### Guilds
|
|
`GET /api/guilds?user_id=<id>`
|
|
`POST /api/guilds` body: `{name, owner_id, description}`
|
|
`GET /api/guilds/<id>` returns guild + channels + roles + categories
|
|
`DELETE /api/guilds/<id>`
|
|
|
|
### Channels
|
|
`POST /api/channels` body: `{guild_id, category_id, name, type, topic, position}`
|
|
`GET /api/channels/<id>`
|
|
`PUT /api/channels/<id>` body: `{name, topic, position}`
|
|
`DELETE /api/channels/<id>`
|
|
|
|
### Messages
|
|
`GET /api/messages?channel_id=<id>&limit=50&before=<id>`
|
|
|
|
### Users
|
|
`GET /api/users/<id>`
|
|
|
|
### Upload
|
|
`POST /api/upload` (multipart/form-data, field: file)
|
|
`GET /api/files/<id>`
|
|
|
|
### Roles
|
|
`POST /api/roles/` body: `{guild_id, name, color, permissions}`
|