Files
SHiNE-server/docs/API/20_Get_My_Blockchain_API.md
T

49 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# GetMyBlockchain API
`GetMyBlockchain` — авторизованное постраничное чтение **только текущей активной версии собственного блокчейна**. API используется постоянным экраном «Мой блокчейн» и мастером смены ключей для выбора последнего доверенного блока.
Login сервер берёт только из авторизованной пользовательской сессии. Активное `blockchainName` определяется через общий реестр `user_identity_current` (DAO `CurrentUsersDAO`): для `PAID_DIRECT`/`PAID_UPGRADED` он синхронизирован с Solana, для `FREE_CERT` — с проверенным сертификатом Arweave. Наличие пользовательского Solana PDA **не требуется** для чтения собственного блокчейна. Клиент не может запросить этим методом чужую цепочку.
У только что зарегистрированного пользователя до первого `HEADER` может отсутствовать запись с блоками: тогда при существующей идентичности возвращается `status=200`, `tipBlockNumber=-1`, `blocks=[]`, а не `BLOCKCHAIN_NOT_FOUND`. Ошибка `BLOCKCHAIN_NOT_FOUND` относится к отсутствующему пользователю или отсутствующему в его записи имени блокчейна; отсутствие блоков само по себе не является ошибкой. Это изменение внутреннего источника поиска, **без изменения JSON-полей, op или кодировки блоков**.
## Request
```json
{
"op": "GetMyBlockchain",
"requestId": "my-bch-1",
"payload": {
"beforeBlock": 500,
"limit": 50,
"includeBlockBytes": false
}
}
```
Поля:
- `beforeBlock` — необязательный номер верхней границы страницы; если отсутствует, чтение начинается с current tip;
- `limit` — `1..100`, default `50`;
- `includeBlockBytes` — при `true` дополнительно вернуть полный ANS-104 DataItem в Base64.
## Response
Payload содержит:
- `login`;
- `blockchainName`;
- `tipBlockNumber` / `tipBlockHash`;
- `nextBeforeBlock` для следующей страницы;
- `blocks[]` в порядке от новых к старым.
Каждый элемент `blocks[]` содержит:
- `blockNumber`;
- `blockHash` / `prevBlockHash`;
- `timestampMs`;
- `msgType` / `msgSubType` / `msgVersion`;
- для target-блоков: `toLogin + toForkNumber + toBlockNumber + toBlockHash` (для compact EDIT `toLogin/toForkNumber` отсутствуют);
- `blockBytesB64`, только если запрошен `includeBlockBytes=true`.
После fork API показывает только новую активную ветку PostgreSQL. Исторические fork при необходимости восстанавливаются из Arweave/PDA history отдельным будущим viewer-механизмом.