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

3.3 KiB
Raw Blame History

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

{
  "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-механизмом.