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 нужна долговечная очередь заявок/подписанных артефактов с защитой от повторного выпуска.