SHA256
49 lines
3.3 KiB
Markdown
49 lines
3.3 KiB
Markdown
# GetMyBlockchain API
|
||
|
||
`GetMyBlockchain` — авторизованное постраничное чтение **только текущей активной версии собственного блокчейна**. API используется постоянным экраном «Мой блокчейн» и мастером смены ключей для выбора последнего доверенного блока.
|
||
|
||
Login сервер берёт только из авторизованной пользовательской сессии. Активное `blockchainName` определяется через общий реестр `user_identity_current` (DAO `CurrentUsersDAO`): для `PAID` он синхронизирован с 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-механизмом.
|