Files
SHiNE-server/docs/registration-v2/WS_REGISTRATION_V2_PROPOSED_NOT_ENABLED.md
T

3.6 KiB

Регистрация V2: утверждённый API (23.10.2026)

Статус: код шести новых операций зарегистрирован в JsonHandlerRegistry по явному согласованию владельца. Не означает успешную проверку devnet или разрешение на production.

Общий транспорт: {"op":"...","requestId":"...","payload":{...}} и {"op":"...","requestId":"...","status":200,"ok":true,"payload":{...}}.

op Поля payload запроса Поля результата (payload) Когда нужен
GetNamespaces {} namespaces:[{name,type,minLocalLength,registrationFeeLamports,defaultServerLogin}] первый экран
CheckRegistrationLogin fullLogin loginAvailable,namespaceType,minLocalLength,registrationFeeLamports после логина/пароля, до генерации ключей
CheckRegistrationEmail email emailAvailable отдельный экран email
StartFreeRegistration fullLogin,rootPublicKeyB64,blockchainPublicKeyB64,clientPublicKeyB64,email challengeId,expiresAtMs создание временной заявки
ConfirmFreeRegistration challengeId,code (учебное 1111) fullLogin,dataItemId,publicationStatus,chainConfirmed:false выпуск+Turbo ACK+локальный импорт
GetRegistrationStatus fullLogin registrationStatus,dataItemId,publicationStatus; для FREE_CERT дополнительно innerSignature64B64,rootPublicKey,blockchainPublicKey,clientPublicKey,defaultServerLogin retry/upgrade

registrationFeeLamports — строка десятичного целого u64. Публичные ключи запроса — Base64 от ровно 32 байт (не PKCS#8). innerSignature64B64 — Base64 внутренней подписи Ed25519, публичная информация сертификата; PRIVATE-ключ регистратора никогда не отдаётся.

Ошибки: REGISTRATION_UNAVAILABLE 503, INVALID_REGISTRATION_INPUT 400, REGISTRATION_CONFLICT 409, RATE_LIMITED 429, прочие 500 требуют анализа логов без раскрытия секретов. Проверка логина и email не резервирует их; перед подписью и перед импортом делается повторная проверка.

Ограничения приватности: публичный boolean emailAvailable допускает подбор адресов. Действует глобальный/per-WebSocket счётчик запросов; пересоздание WebSocket может обходить персональную квоту, перед production нужен rate limit на edge по IP/ASN и CAPTCHA, плюс переход с тестового кода на реальное подтверждение email. Учебный код 1111 не означает подтверждения владения адресом.

Ограничения надёжности: challenge и единожды подписанные bytes пока живут в памяти сервера не более 15 минут. Если сервер перезапущен после Turbo ACK, пользователь проверяет GetRegistrationStatus, но повтор той же challenge невозможен. Для production нужна долговечная очередь заявок/подписанных артефактов с защитой от повторного выпуска.