SHiNE-server/Dev_Docs/03_Addable_Blocks_Channels_Messages_Connections.md

Какие блоки можно добавлять и что уже есть по API

1) Что реально доступно по сети сейчас

В JsonHandlerRegistry сейчас есть:

• AddBlock
• GetFriendsLists
• UpsertUserParam, GetUserParam, ListUserParams
• auth/system и тестовые операции.

Отдельных read-API для каналов/сообщений пока нет (только запись блока + частично списки друзей + user params).

2) Как добавляются блоки

Через AddBlock клиент отправляет:

• blockchainName
• blockNumber
• prevBlockHash
• blockBytesB64

Сервер:

• парсит block;
• проверяет подпись блокчейна;
• извлекает line/target из body;
• сохраняет в blocks;
• обновляет blockchain_state;
• триггеры автоматически обновляют производные таблицы (connections_state, message_stats).

3) Конкретные сценарии

3.1 Создать канал

Добавить TECH-блок CreateChannelBody (type=0/subType=TECH_CREATE_CHANNEL).

3.2 Опубликовать сообщение в своём канале

Добавить TEXT_POST в нужную линию канала (lineCode указывает на root канала).

3.3 Ответ на сообщение

Добавить TEXT_REPLY с target (toBlockchainName, toBlockGlobalNumber, toBlockHash32).

3.4 Лайк

Добавить REACTION_LIKE с target сообщения.

3.5 Подписаться / отписаться от канала

Добавить CONNECTION_FOLLOW / CONNECTION_UNFOLLOW с target root канала.

3.6 Добавить в контакты/друзья

• Контакты: CONNECTION_CONTACT / CONNECTION_UNCONTACT.
• Друзья: CONNECTION_FRIEND / CONNECTION_UNFRIEND.

4) Есть ли метод «подписаться на канал» кроме публикации?

Да: подписка — это не отдельный RPC, а блок CONNECTION_FOLLOW, отправляемый через AddBlock.

5) Есть ли методы для сохранения технического состояния (например, сколько прочитано)

Да, есть UpsertUserParam.

Практично хранить:

• channel_last_read:<bchName>:<lineCode> -> <lastSeenMessageSeq или blockNumber>
• channel_last_sync_at -> <time_ms>

Ограничение: users_params сейчас хранит строки param/value, то есть сложные структуры лучше класть в JSON-строку с версией схемы.

6) Чего не хватает прямо сейчас

1. Нет RPC, который вернёт список подписанных каналов и счётчики сообщений.
2. Нет RPC, который вернёт сообщения конкретного канала (с пагинацией).
3. Нет RPC, который вернёт подробный тред сообщения (предки + все ответы) одним JSON.
4. Нет RPC «ленты событий» (кто лайкнул/ответил/подписался) как отдельного серверного канала.