3.3 KiB
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
{
"op": "GetMyBlockchain",
"requestId": "my-bch-1",
"payload": {
"beforeBlock": 500,
"limit": 50,
"includeBlockBytes": false
}
}
Поля:
beforeBlock— необязательный номер верхней границы страницы; если отсутствует, чтение начинается с current tip;limit—1..100, default50;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 EDITtoLogin/toForkNumberотсутствуют); blockBytesB64, только если запрошенincludeBlockBytes=true.
После fork API показывает только новую активную ветку PostgreSQL. Исторические fork при необходимости восстанавливаются из Arweave/PDA history отдельным будущим viewer-механизмом.