feat(client): protocol v2 wire layer, screen sharing, channel webhooks and secure voice

Verified against the real gateway via tests/gateway_interop.rs.
This commit is contained in:
Loki 2026-10-24 16:51:15 +02:00
parent 8460fb28fd
commit 3d7dd5413b
Signed by: boba
GPG key ID: 253067914055423B
65 changed files with 6048 additions and 1156 deletions

461
protocol/lnex.proto Normal file
View file

@ -0,0 +1,461 @@
syntax = "proto3";
package lnex;
// ─── HANDSHAKE ──────────────────────────────────────────────────────────────
message Hello {
string lnex_version = 1;
bytes server_pubkey = 2;
bytes challenge_nonce = 3;
string node_name = 4;
bytes server_eph_pubkey = 5;
bool private_mode = 6;
bytes server_signature = 7;
}
message Auth {
bytes client_pubkey = 1;
string nickname = 2;
string lnex_version = 3;
bytes signature = 4;
bytes client_eph_pubkey = 5;
}
message Session {
string session_id = 1;
string token = 2;
int64 expires_at = 3;
}
// ─── KEEPALIVE ──────────────────────────────────────────────────────────────
message Ping { int64 timestamp = 1; }
message Pong { int64 timestamp = 1; }
// ─── ERROR / DISCONNECT ─────────────────────────────────────────────────────
message Error { uint32 code = 1; string message = 2; }
message Disconnect { string reason = 1; }
// ─── CHANNELS ───────────────────────────────────────────────────────────────
message JoinChannel { string channel_id = 1; }
message LeaveChannel { string channel_id = 1; }
message ChannelState {
string channel_id = 1;
string channel_name = 2;
string kind = 3;
repeated MemberInfo members = 4;
string voice_endpoint = 5;
optional string guild_id = 6;
}
message MemberInfo {
string user_id = 1;
string nickname = 2;
bool in_voice = 3;
}
message ChannelCreate {
string channel_id = 1;
string channel_name = 2;
string kind = 3;
optional string guild_id = 4;
}
message ChannelDelete { string channel_id = 1; }
message ChannelEdit {
string channel_id = 1;
string channel_name = 2;
}
message ChannelList {
repeated ChannelListItem channels = 1;
optional string guild_id = 2;
}
message ChannelListItem {
string channel_id = 1;
string channel_name = 2;
string kind = 3;
optional string guild_id = 4;
}
message UserJoin { string channel_id = 1; string user_id = 2; string nickname = 3; }
message UserLeave { string channel_id = 1; string user_id = 2; }
// ─── CHAT ────────────────────────────────────────────────────────────────────
message ChatMessage {
string message_id = 1;
string channel_id = 2;
string sender_id = 3;
string content = 4;
int64 timestamp = 5;
bool edited = 6;
optional string reply_to = 7;
}
message ChatHistory {
string channel_id = 1;
repeated ChatMessage messages = 2;
}
message ReactionPayload {
string message_id = 1;
string channel_id = 2;
string emoji = 3;
string user_id = 4;
}
message MessageEdit {
string message_id = 1;
string channel_id = 2;
string content = 3;
}
message MessageDelete {
string message_id = 1;
string channel_id = 2;
}
// ─── VOICE ──────────────────────────────────────────────────────────────────
message VoiceState {
string user_id = 1;
string channel_id = 2;
string state = 3;
}
// ─── GUILDS ─────────────────────────────────────────────────────────────────
message GuildCreate { string name = 1; }
message GuildInfo {
string id = 1;
string owner_id = 2;
string name = 3;
int64 member_count = 4;
int64 created_at = 5;
}
message GuildDelete { string guild_id = 1; }
message GuildList { repeated GuildInfo guilds = 1; }
message GuildMemberJoin { string guild_id = 1; }
message GuildMemberLeave { string guild_id = 1; string user_id = 2; }
message GuildMemberKick { string guild_id = 1; string user_id = 2; }
message RoleCreate {
string guild_id = 1;
string name = 2;
optional string color = 3;
optional uint64 permissions = 4;
string id = 5;
}
message RoleDelete {
string guild_id = 1;
string role_id = 2;
}
message InviteCreate {
string guild_id = 1;
optional int64 max_uses = 2;
optional int64 expires_in_seconds = 3;
}
message InviteInfo {
string id = 1;
string guild_id = 2;
string guild_name = 3;
string code = 4;
string creator_id = 5;
optional int64 max_uses = 6;
int64 uses = 7;
optional int64 expires_at = 8;
int64 created_at = 9;
}
message InviteAccept {
string code = 1;
string guild_id = 2;
string guild_name = 3;
}
message InviteDelete {
string guild_id = 1;
string invite_id = 2;
}
message GuildAuditLogFetch {
string guild_id = 1;
int64 limit = 2;
}
message AuditLogEntry {
string id = 1;
string guild_id = 2;
string actor_id = 3;
string action = 4;
optional string target_id = 5;
optional string target_type = 6;
optional string reason = 7;
int64 created_at = 8;
}
message GuildAuditLog {
string guild_id = 1;
repeated AuditLogEntry entries = 2;
}
message GuildMemberListFetch { string guild_id = 1; }
message GuildMemberInfo {
string user_id = 1;
string nickname = 2;
int64 joined_at = 3;
string role_color = 4;
string role_name = 5;
bool is_owner = 6;
}
message GuildMemberList {
string guild_id = 1;
repeated GuildMemberInfo members = 2;
}
message RoleAssign {
string guild_id = 1;
string user_id = 2;
string role_id = 3;
}
message GuildRoleListFetch { string guild_id = 1; }
message GuildRoleInfo {
string id = 1;
string guild_id = 2;
string name = 3;
string color = 4;
uint64 permissions = 5;
int32 position = 6;
}
message GuildRoleList {
string guild_id = 1;
repeated GuildRoleInfo roles = 2;
}
// ─── DIRECT MESSAGES ────────────────────────────────────────────────────────
message DmStart {
string target_user_id = 1;
}
message DmStartResponse {
string dm_id = 1;
string other_user_id = 2;
string other_nickname = 3;
repeated DmMessage messages = 4;
uint32 unread_count = 5;
}
message DmMessage {
string dm_id = 1;
string sender_id = 2;
string content = 3;
int64 timestamp = 4;
}
message DmHistory {
string dm_id = 1;
repeated DmMessage messages = 2;
optional string search_query = 3;
optional int64 limit = 4;
}
message DmReadAck {
string dm_id = 1;
}
// ─── FRIENDS ────────────────────────────────────────────────────────────────
message FriendRequest { string to_user_id = 1; }
message FriendAccept { string from_user_id = 1; }
message FriendDecline { string from_user_id = 1; }
message FriendRemove { string user_id = 1; }
message FriendInfo {
string user_id = 1;
string nickname = 2;
string status = 3;
int64 since = 4;
}
message FriendList { repeated FriendInfo friends = 1; }
message BlockUser { string user_id = 1; }
message UnblockUser { string user_id = 1; }
message BlockList { repeated string blocked = 1; }
message FriendEvent {
string event = 1;
string user_id = 2;
optional string nickname = 3;
}
// ─── PRESENCE ──────────────────────────────────────────────────────────────
message PresenceUpdate {
string status = 1;
optional string activity_type = 2;
optional string activity_text = 3;
}
message PresenceInfo {
string user_id = 1;
string nickname = 2;
string status = 3;
optional string activity_type = 4;
optional string activity_text = 5;
}
message PresenceSync { repeated PresenceInfo presences = 1; }
message PresenceEvent {
string user_id = 1;
string nickname = 2;
string status = 3;
optional string activity_type = 4;
optional string activity_text = 5;
}
// ─── READ RECEIPT & TYPING ─────────────────────────────────────────────────
message ReadReceipt {
string channel_id = 1;
string last_read_message_id = 2;
string user_id = 3;
}
message TypingStart {
string channel_id = 1;
}
// ─── AD-HOC RESPONSE / BROADCAST TYPES ──────────────────────────────────────
message ReadReceiptBroadcast {
string channel_id = 1;
string user_id = 2;
string last_read_message_id = 3;
}
message UserRoleUpdate {
string user_id = 1;
string guild_id = 2;
string color = 3;
}
message TypingBroadcast {
string user_id = 1;
string nickname = 2;
string channel_id = 3;
}
message SimpleResponse {
bool ok = 1;
optional string user_id = 2;
optional string role_id = 3;
}
// ─── E2EE for Direct Messages ────────────────────────────────────────────────
message E2eeDmKeyExchange {
string dm_id = 1;
bytes e2ee_public_key = 2;
}
message E2eeDmKeyExchangeAck {
string dm_id = 1;
}
message E2eeDmMessage {
string dm_id = 1;
string sender_id = 2;
bytes ciphertext = 3;
int64 timestamp = 4;
}
message E2eeDmHistory {
string dm_id = 1;
repeated E2eeDmMessage messages = 2;
optional int64 limit = 3;
}
// Channel-scoped webhook management: authenticated LNEx only. Secrets returned once.
message WebhookRequest {
string id = 1;
string channel_id = 2;
string name = 3;
string direction = 4; // incoming | outgoing
string provider = 5; // generic | github (incoming only)
string endpoint = 6; // outgoing HTTPS URL
string request_id = 7;
}
message WebhookInfo {
string id = 1;
string channel_id = 2;
string name = 3;
string direction = 4;
string provider = 5;
string endpoint = 6;
int64 created_at = 7;
bool revoked = 8;
string suspended_reason = 9;
}
message WebhookResult { WebhookInfo hook = 1; string secret = 2; string request_id = 3; }
message WebhookListResult { repeated WebhookInfo hooks = 1; string request_id = 2; }
message WebhookErrorResult { string request_id = 1; uint32 code = 2; string message = 3; }
// Authenticated signalling only; media uses DTLS/SRTP peer connections.
message MediaControl {
uint32 action = 1; // START1 STOP2 WATCH3 UNWATCH4 OFFER5 ANSWER6 ICE7
string channel_id = 2;
string share_id = 3;
string target_session_id = 4;
string body = 5;
uint32 mline_index = 6;
bool application_audio = 7;
bool microphone = 8;
}
message MediaEvent {
uint32 action = 1;
string channel_id = 2;
string share_id = 3;
string target_session_id = 4;
string body = 5;
uint32 mline_index = 6;
bool application_audio = 7;
bool microphone = 8;
string sender_session_id = 9;
string publisher_user_id = 10;
}
// Fresh credentials delivered only over the authenticated encrypted control session.
message VoiceSession {
bytes route_id = 1;
bytes c2s_key = 2;
bytes s2c_key = 3;
string channel_id = 4;
}
message VoiceFrame {
uint32 voice_seq = 1;
uint32 timestamp = 2;
string channel_id = 3;
string sender_session_id = 4;
bytes opus = 5;
string sender_user_id = 6;
}