Files
SHiNE-server/docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md
T

6.2 KiB

SHiNE — сертификат бесплатной регистрации V1

Статус: формат отдельного ANS-104 DataItem t=reg. В коде есть выпуск сертификата, публикация через Turbo, локальный импорт и проверка внутренней подписи при upgrade. Это описание формата; готовность сквозного сценария на конкретном контуре проверяется отдельно.

Байты и нормализация

full_login = localpart@namespace — ASCII, с сохранением регистра локальной части, максимум 30 байт, regex [A-Za-z0-9_]+@[a-z0-9_]+. Бинарная идентичность:

identity_fields = major:u8(1) || minor:u8(0) || full_login_len:u8 || full_login:utf8
                  || root_pubkey:32 || blockchain_pubkey:32 || client_pubkey:32
inner_message = UTF8("SHiNE_FREE_REG_V1\0") || identity_fields
inner_signature64 = Ed25519.sign(registrar_private_key, inner_message)
payload = identity_fields || inner_signature64 || email_sha256:32

Порядок ключей фиксирован: root → blockchain → client. Регистратор не имеет доступа к приватным ключам пользователя. Адрес public key регистратора хранится в namespace-PDA типа 2. Подделка любого байта identity приводит к отказу.

Нормализация email: удалить пробелы только по краям (trim), Unicode NFC, lowercase независимо от locale; не удалять +tag и точки. email_sha256=SHA256(UTF8(normalized_email)) публикуется после внутренней подписи, не входит в inner_message. Это обычный SHA-256, допускающий словарный подбор email; не обеспечивает полной анонимности. Текущая проверка email использует случайный шестизначный код и письмо через Resend; детали и тестовый обход описаны в инструкции по email.

ANS-104 внешний контейнер

Подписанный бинарный DataItem типа Ed25519 (signature_type=2, owner=registrar_pubkey) создаётся тем же приватным ключом регистратора через стандартный deepHash ANS-104 от всех полей и всего payload. Теги в точном порядке:

  1. App=test5592
  2. t=reg
  3. Protocol=SHiNE-Free-Registration-V1

Без target/anchor в V1. Внешняя подпись удостоверяет email hash и теги; ID DataItem = SHA256(outer_signature64). Она НЕ равна внутренней, поскольку подписаны разные сообщения. Проверка внешней подписи обязательна при импорте (включая Turbo ACK), хотя Solana при upgrade проверяет только inner signature по публичному ключу из namespace-PDA. Сервер должен отвергать конфликт имени/hash-email и не заменять принятую идентичность иной записью.

FREE_CERT → PAID: при Solana-create повторно предъявляется та же внутренняя подпись, созданная для тех же login, root, blockchain, client. Клиент не должен генерировать новые ключи. created_at_ms новой PDA — время регистрации в Solana, первоначальная дата, история и потраченные лимиты остаются в Arweave/БД; нельзя начислить дважды бесплатный бонус. Solana программа не проверяет наличие публикации ANS-104; её проверяет доверенный сервер. Детали защиты от смены ключа регистратора в этой версии не реализуются.

Тестирование

Детерминированные фикстуры: shine-solana/shine/tests/fixtures/registration-v2.json (в том числе ранее подписанный ANS-104 DataItem с историческим App=test5591, его ID и подписи). Этот вектор сохранён исключительно для проверки криптографического формата, он НЕ является актуальным тегом выпуска. Актуальный App=test5592 проверяется выпуском нового сертификата через Java FreeRegistrationCertificateV1Check. Векторные ключи предназначены только для тестов. Java-подписание и проверка сертификата присутствуют в этапе 7; загрузка через Turbo и доверенный импорт — этап 8.

Адрес PDA при upgrade вычисляется от ASCII lowercase полного логина, но строка логина в сертификате, его подпись и поле login в PDA остаются в исходном регистре. Пароль/Argon2id также используют lowercase полного логина.

Исходное написание — это отображаемое зарегистрированное имя. Runtime-идентификаторы (normalized_login, blockchain_name, ключи blocks_store и blockchain_state_store) используют ASCII lowercase. Поэтому уже выпущенные сертификаты с заглавными буквами остаются валидными: сервер не меняет их подписанные байты, а приводит к lowercase только несигнатурные ключи хранения и поиска.