Уточнить удаление каналов и обновить версии

Доработана серверная и клиентская логика удаления публичных каналов.

Обновлена документация API и форматов блокчейна.
This commit is contained in:
AidarKC
2026-10-06 19:09:56 +03:00
parent 83548a859f
commit acd5d4406d
12 changed files with 84 additions and 23 deletions
@@ -127,7 +127,7 @@ public final class ChannelNameStateDAO {
SET is_deleted = ?,
deleted_at_ms = ?,
deleted_block_number = ?
WHERE owner_bch_name = ?
WHERE LOWER(owner_login) = LOWER(?)
AND channel_root_block_number = ?
AND is_deleted IS DISTINCT FROM ?
""";
@@ -135,7 +135,7 @@ public final class ChannelNameStateDAO {
ps.setBoolean(1, deleted);
ps.setLong(2, deleted ? Math.max(0L, deletedAtMs) : 0L);
if (deleted && deletedBlockNumber != null) ps.setInt(3, deletedBlockNumber); else ps.setNull(3, java.sql.Types.INTEGER);
ps.setString(4, ownerBchName);
ps.setString(4, loginOf(ownerBchName));
ps.setInt(5, rootBlockNumber);
ps.setBoolean(6, deleted);
return ps.executeUpdate() > 0;
@@ -17,6 +17,7 @@ import java.sql.ResultSet;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;
public final class ChannelNamesStateBootstrapper {
@@ -48,7 +49,15 @@ public final class ChannelNamesStateBootstrapper {
SELECT login, bch_name, block_number, block_hash, block_bytes
FROM blocks
WHERE msg_type = ? AND msg_sub_type = ?
ORDER BY bch_name, block_number
AND fork_number=shine_canonical_fork(
login,
(SELECT substring(blockchain_name from '([0-9]{3})$')::INTEGER
FROM solana_user_pda_current
WHERE LOWER(login)=LOWER(blocks.login)
LIMIT 1),
block_number
)
ORDER BY LOWER(login), block_number
""";
try (Connection c = DbController.getInstance().getConnection()) {
@@ -107,7 +116,7 @@ public final class ChannelNamesStateBootstrapper {
}
String identity = ownerBch + "#" + blockNumber;
String ownerTypeSlug = ownerBch + "|" + channelTypeCode + "|" + slug;
String ownerTypeSlug = ownerLogin.toLowerCase(Locale.ROOT) + "|" + channelTypeCode + "|" + slug;
String existing = slugToIdentity.putIfAbsent(ownerTypeSlug, identity);
if (existing != null && !existing.equals(identity)) {
conflicts.add("owner/type/slug=\"" + ownerTypeSlug + "\" conflicts: " + existing + " vs " + identity);
@@ -188,7 +197,15 @@ public final class ChannelNamesStateBootstrapper {
SELECT bch_name, block_number, block_bytes, msg_sub_type
FROM blocks
WHERE msg_type = ? AND msg_sub_type IN (?, ?, ?, ?, ?, ?, ?)
ORDER BY bch_name, block_number
AND fork_number=shine_canonical_fork(
login,
(SELECT substring(blockchain_name from '([0-9]{3})$')::INTEGER
FROM solana_user_pda_current
WHERE LOWER(login)=LOWER(blocks.login)
LIMIT 1),
block_number
)
ORDER BY LOWER(login), block_number
""";
try (PreparedStatement ps = c.prepareStatement(sql)) {
ps.setInt(1, MSG_TYPE_TEXT);
@@ -229,7 +246,15 @@ public final class ChannelNamesStateBootstrapper {
SELECT login, bch_name, block_number, block_bytes
FROM blocks
WHERE msg_type = ? AND msg_sub_type = ?
ORDER BY bch_name, block_number
AND fork_number=shine_canonical_fork(
login,
(SELECT substring(blockchain_name from '([0-9]{3})$')::INTEGER
FROM solana_user_pda_current
WHERE LOWER(login)=LOWER(blocks.login)
LIMIT 1),
block_number
)
ORDER BY LOWER(login), block_number
""";
try (PreparedStatement ps = c.prepareStatement(sql)) {
ps.setInt(1, MSG_TYPE_TEXT);
+2 -2
View File
@@ -1,2 +1,2 @@
client.version=1.14.10
server.version=1.12.10
client.version=1.14.11
server.version=1.12.11
@@ -34,6 +34,7 @@
- owner 32 bytes и равен текущему blockchain public key;
- обязательный тестовый tag `App=test5591`;
- для channel block — `c=<canonical_channel_slug>`;
- `TEXT_CHANNEL_DELETE (type=1/subType=92/version=1)` является обычным line-based channel block с пустым text и тем же обязательным `c=<slug>`; отдельной операции API для удаления канала нет;
- `data` содержит SHiNE Frame v1 (`frameCode=1`).
## Основные ошибки
+14 -2
View File
@@ -32,6 +32,8 @@
> `unreadCount` для канала считается по подписанному состоянию чтения канала.
> Для собственных каналов владельцу всегда возвращается `unreadCount = 0`, чтобы его собственные публикации не становились «новыми» для него самого.
> Если для пары `ownerBlockchainName/channelName` ещё нет записи, канал временно считается полностью прочитанным. После появления записи новые публикации увеличивают `unreadCount` до продвижения курсора чтения.
>
> `ListSubscriptionsFeed` технически может возвращать soft-deleted каналы с `channel.deleted=true`, чтобы старые ссылки и selector канала продолжали разрешаться. Обычный UI скрывает такие строки. Для deleted-канала общий unread/counters не учитываются; сама подписка сохраняется.
---
@@ -70,6 +72,9 @@
"avaSha256": "0123...",
"avaSize": 248193,
"metaUpdatedAtMs": 1760000000000,
"deleted": false,
"deletedAtMs": 0,
"deletedBlockNumber": null,
"personal": true,
"channelRoot": { "blockNumber": 0, "blockHash": "..." }
},
@@ -169,6 +174,9 @@
"avaSha256": "0123...",
"avaSize": 248193,
"metaUpdatedAtMs": 1760000000000,
"deleted": false,
"deletedAtMs": 0,
"deletedBlockNumber": null,
"subscribersCount": 128,
"channelRoot": { "blockNumber": 123, "blockHash": "..." }
},
@@ -223,6 +231,8 @@
}
```
Для soft-deleted канала `channel.deleted=true`; `deletedAtMs` и `deletedBlockNumber` указывают последний delete-блок. В `metaEvents` delete-блоки возвращаются как `kind: "deleted"`. После новой самостоятельной публикации канал снова активен (`deleted=false`), при этом исторические `deleted` meta-events остаются частью истории.
---
## 3) GetMessageThread
@@ -560,11 +570,13 @@ Returns lightweight public-channel cards for profile counters. `mode` is `owned`
{
"op": "ListUserProfileChannels",
"requestId": "profile-ch-1",
"payload": { "login": "Alice", "mode": "owned", "limit": 100, "offset": 0 }
"payload": { "login": "Alice", "mode": "owned", "includeDeleted": false, "limit": 100, "offset": 0 }
}
```
Channel items contain `ownerLogin`, `slug`, `displayName`, `avatarAr`, `ownerBlockchainName`, `rootBlockNumber`, and `rootBlockHashHex`.
`includeDeleted` необязателен и по умолчанию равен `false`. При `true` ответ включает как активные, так и soft-deleted каналы.
Channel items contain `ownerLogin`, `slug`, `displayName`, `avatarAr`, `ownerBlockchainName`, `rootBlockNumber`, `rootBlockHashHex`, `deleted`, `deletedAtMs`, and `deletedBlockNumber`.
## Qualified likes (v18)
@@ -16,7 +16,7 @@
## Быстрая карта типов
- `type=0` — TECH: HEADER, CREATE_CHANNEL, FORK.
- `type=1` — TEXT: POST/EDIT_POST/REPLY/EDIT_REPLY/RATING/REPOST/CHANNEL_META/ENTRYPOINT/EXERCISE/SERVICE/COURSE.
- `type=1` — TEXT: POST/EDIT_POST/REPLY/EDIT_REPLY/RATING/REPOST/CHANNEL_META/CHANNEL_DELETE/ENTRYPOINT/EXERCISE/SERVICE/COURSE.
- `type=2` — REACTION: LIKE/UNLIKE.
- `type=3` — CONNECTION: FRIEND/CONTACT/FOLLOW/SPOUSE/PARENT/CHILD/SIBLING и обратные операции.
- `type=4` — USER_PROFILE: история полей профиля пользователя.
@@ -73,7 +73,7 @@
Ссылка просто на любой существующий блок больше не считается допустимой. Это запрещает случайные или намеренные боковые ветки линии.
Для канала в одну линию входят все line-based события этого канала, включая обычные посты, `EDIT_POST`, `REPOST`, `CHANNEL_META` и контентные типы канала. Поэтому редактирование не создаёт отдельную боковую ветку.
Для канала в одну линию входят все line-based события этого канала, включая обычные посты, `EDIT_POST`, `REPOST`, `CHANNEL_META`, `CHANNEL_DELETE` и контентные типы канала. Поэтому редактирование не создаёт отдельную боковую ветку.
## 6. Индексные ANS-104 теги
+12 -6
View File
@@ -38,24 +38,30 @@ TEXT-тип хранит сообщения, материалы и редакт
- не отображается как обычное сообщение ленты;
- применяется сервером к текущему состоянию канала.
8. `subType=100` — `TEXT_ENTRYPOINT`
8. `subType=92` — `TEXT_CHANNEL_DELETE`
- скрытый технический soft-delete канала;
- содержит line-поля и обязательный пустой `text`;
- становится хвостом той же линии канала;
- новый самостоятельный channel-пост автоматически делает канал активным снова; `CHANNEL_META` и `EDIT_POST` не оживляют канал.
9. `subType=100` — `TEXT_ENTRYPOINT`
- входная страница канала;
- line-based сообщение с тем же body, что у `TEXT_POST`;
- не редактируется через `TEXT_EDIT_POST`: новая версия создаётся новым `TEXT_ENTRYPOINT`.
9. `subType=110` — `TEXT_EXERCISE`
10. `subType=110` — `TEXT_EXERCISE`
- line-based материал упражнения;
- использует тот же body, что у `TEXT_POST`.
10. `subType=120` — `TEXT_SERVICE`
11. `subType=120` — `TEXT_SERVICE`
- line-based материал услуги / процедуры;
- использует тот же body, что у `TEXT_POST`.
11. `subType=130` — `TEXT_COURSE`
12. `subType=130` — `TEXT_COURSE`
- line-based материал курса;
- использует тот же body, что у `TEXT_POST`.
Подробная спецификация: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md).
Подробные спецификации: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md) и [17_TEXT_Channel_Delete.md](./17_TEXT_Channel_Delete.md).
## Канонический target-формат TEXT
@@ -95,7 +101,7 @@ Login/fork для edit не подписываются: edit может ссыл
- Для `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` допустим `textLen=0`.
- Такой edit трактуется как логическое удаление содержимого сообщения.
- Для удаления используется именно edit-блок; отдельного `DELETE`-подтипа нет.
- Для удаления отдельного сообщения используется именно edit-блок; отдельного `DELETE`-подтипа сообщения нет. `TEXT_CHANNEL_DELETE=92` относится только к soft-delete всего канала.
## Вложения в текстовых сообщениях (`S:att v=1`)
+11
View File
@@ -1,3 +1,14 @@
## 2026-10-06 18:02 +0300 — Soft-delete каналов
- Базовый коммит-ориентир: `working tree`; изменение подготовлено как patch без нового git-коммита.
- Добавлен line-based `TEXT_CHANNEL_DELETE (type=1, subType=92, version=1)` с обязательным пустым text.
- `TEXT_CHANNEL_DELETE` становится обычным хвостом линии канала и сохраняет обязательный ANS-104 tag `c=<slug>`.
- В `channel_names_state` добавлены только `is_deleted`, `deleted_at_ms`, `deleted_block_number`; delete-hash отдельно не хранится.
- Новый самостоятельный `TEXT_POST/REPOST/ENTRYPOINT/EXERCISE/SERVICE/COURSE` автоматически оживляет канал; `TEXT_CHANNEL_META` и `TEXT_EDIT_POST` состояние удаления не меняют.
- Soft-deleted канал сохраняет root, slug, историю, старые ссылки и подписки; slug не освобождается. Обычные списки/counters/unread deleted-каналы скрывают, а `ListUserProfileChannels.includeDeleted=true` позволяет показать их в профиле.
- Bootstrap/rebuild восстанавливает delete-state из канонической истории с учётом segmented forks по логическому `login`, поэтому root из старого fork остаётся валидным.
- Схема PostgreSQL поднята до v31; добавлен безопасный переход v30 -> v31.
## 2026-10-02 — Transport namespace `test5591`
- Текущий ANS-104 namespace переключён с `test5590` на `test5591`: `App=test5591`; channel index теперь постоянный и не зависит от namespace: `c=<slug>`.
+1
View File
@@ -5,6 +5,7 @@
## Основные документы
- [`01_Common_Block_Format.md`](01_Common_Block_Format.md) — точный Frame v1, ANS-104, подпись, хэши и теги.
- [`17_TEXT_Channel_Delete.md`](17_TEXT_Channel_Delete.md) — soft-delete канала через `TEXT_CHANNEL_DELETE=92` и правила автоматического оживления.
- [`17_ANS104_Arweave_Transport.md`](17_ANS104_Arweave_Transport.md) — публикация блоков в Arweave и обратный импорт между серверами.
- [`sync-between-servers.md`](sync-between-servers.md) — межсерверная синхронизация и full-resync без файловой копии blockchain.
- [`CHANGELOG.md`](CHANGELOG.md) — история изменений протокола.
+4 -3
View File
@@ -102,17 +102,18 @@ async function resolveChannelSelector(route) {
const ownerUser = await authService.getUser(ownerLogin);
if (!ownerUser?.exists) throw new Error('Владелец канала не найден.');
const ownerBlockchainName = String(ownerUser.blockchainName || ownerRef).trim();
const ownerFeed = await authService.listSubscriptionsFeed(ownerLogin, 500);
const ownedRows = Array.isArray(ownerFeed?.ownedChannels) ? ownerFeed.ownedChannels : [];
const ownerLoginNormalized = ownerLogin.toLowerCase();
const row = ownedRows.find((item) => (
String(item?.channel?.channelName || '').trim().toLowerCase() === channelName.toLowerCase()
&& String(item?.channel?.ownerBlockchainName || '').trim().toLowerCase() === ownerBlockchainName.toLowerCase()
&& String(item?.channel?.ownerLogin || '').trim().toLowerCase() === ownerLoginNormalized
));
if (!row?.channel?.channelRoot) throw new Error('Канал не найден.');
const rootBlockchainName = String(row.channel.ownerBlockchainName || ownerRef).trim();
return {
ownerBlockchainName,
ownerBlockchainName: rootBlockchainName,
channelRootBlockNumber: Number(row.channel.channelRoot.blockNumber),
channelRootBlockHash: normalizeHash(row.channel.channelRoot.blockHash),
channelName,
+6 -2
View File
@@ -2371,9 +2371,11 @@ export class AuthService {
async listOwnChannelsForBlockchain(login, blockchainName) {
const feed = await this.listSubscriptionsFeed(login, 500);
const own = feed?.ownedChannels || [];
const ownerLogin = String(login || '').trim().toLowerCase();
return own
.filter((item) => String(item?.channel?.ownerBlockchainName || '') === blockchainName)
.filter((item) => String(item?.channel?.ownerLogin || '').trim().toLowerCase() === ownerLogin)
.map((item) => ({
ownerBlockchainName: String(item?.channel?.ownerBlockchainName || '').trim(),
rootBlockNumber: Number(item?.channel?.channelRoot?.blockNumber),
rootBlockHash: normalizeHex32(item?.channel?.channelRoot?.blockHash, ZERO64),
channelName: String(item?.channel?.channelName || ''),
@@ -2460,7 +2462,9 @@ export class AuthService {
if (!ownerBlockchainName || !Number.isInteger(lineCode) || lineCode < 0) {
throw new Error('Invalid channel selector');
}
if (ownerBlockchainName !== blockchainName) {
const currentOwnerLogin = loginFromBlockchainNameValue(blockchainName).toLowerCase();
const selectorOwnerLogin = loginFromBlockchainNameValue(ownerBlockchainName).toLowerCase();
if (!currentOwnerLogin || !selectorOwnerLogin || currentOwnerLogin !== selectorOwnerLogin) {
throw new Error('Posting is allowed only to your own channels');
}