Files

T

SashegDev 096c4d0a2d Initial commit: JustAMessenger v0.1.0

Серверная часть (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 — спецификация протокола

2026-06-06 22:39:14 +00:00

2.7 KiB

Raw Permalink Blame History

JAM Protocol v0.1

Transport

WebSocket (ws:// or wss://) at /ws
REST API at /api/*
Federation at /federation/receive

WebSocket Packet Format

{
  "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}

2.7 KiB Raw Permalink Blame History