4.2 KiB
Регистрация V2: WebSocket API
Статус: шесть операций зарегистрированы в JsonHandlerRegistry. Доступность полного сценария зависит от конфигурации регистратора, Resend, Turbo и синхронизации; регистрацию на конкретном контуре нужно проверять отдельно.
Общий транспорт: {"op":"...","requestId":"...","payload":{...}} и {"op":"...","requestId":"...","status":200,"ok":true,"payload":{...}}.
| op | Поля payload запроса | Поля результата (payload) | Когда нужен |
|---|---|---|---|
GetNamespaces |
{} |
namespaces:[{name,type,minLocalLength,registrationFeeLamports,currencyCode,defaultServerLogin}] |
первый экран |
CheckRegistrationLogin |
fullLogin |
loginAvailable,namespaceType,minLocalLength,registrationFeeLamports,currencyCode |
после логина/пароля, до генерации ключей |
CheckRegistrationEmail |
email |
emailAvailable |
отдельный экран email |
StartFreeRegistration |
fullLogin,rootPublicKeyB64,blockchainPublicKeyB64,clientPublicKeyB64,email |
challengeId,expiresAtMs |
создание временной заявки |
ConfirmFreeRegistration |
challengeId,code (случайный шестизначный код из письма) |
fullLogin,dataItemId,publicationStatus,chainConfirmed:false |
выпуск+Turbo ACK+локальный импорт |
GetRegistrationStatus |
fullLogin |
registrationStatus,dataItemId,publicationStatus; для FREE_CERT дополнительно innerSignature64B64,rootPublicKey,blockchainPublicKey,clientPublicKey,defaultServerLogin |
retry/upgrade |
registrationFeeLamports — строка десятичного целого u64. currencyCode — числовой код: 1 = SOL; 2 зарезервирован, сервер не принимает его до реализации USDT. Сервер отдаёт актуальный кэш namespace после sync Solana, UI перед платной транзакцией дополнительно читает значение напрямую из Solana. Публичные ключи запроса — 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-кода. Код генерируется случайно и отправляется через Resend. См. RESEND_EMAIL_VERIFICATION.md.
Ограничения надёжности: challenge и единожды подписанные bytes пока живут в памяти сервера до 1 часа (FreeRegistrationWorkflow.TTL_MS). Если сервер перезапущен после Turbo ACK, пользователь проверяет GetRegistrationStatus, но повтор той же challenge невозможен. Для нескольких инстансов нужна общая очередь заявок/подписанных артефактов с защитой от повторного выпуска.