Регистрация V2: не проверено end-to-end

This commit is contained in:
AidarKC
2026-10-23 19:21:52 +03:00
parent 6c8159c5f7
commit cab26bbf41
95 changed files with 4469 additions and 1088 deletions
@@ -0,0 +1,41 @@
# SHiNE — Namespace PDA, бинарный формат 1.0
Статус: **черновая реализация в объединённом патче этапов 1–3**, не развёрнута; формат предложен как протокол V1. Перед деплоем обязательна компиляция Rust и тесты localnet/devnet.
## Идентичность и адреса
- `login@namespace`: строго ASCII lowercase, обе части `[a-z0-9_]+`, ровно один `@`.
- Полная длина имени — не более **30 байт**; `min_localpart_len` из namespace. Никаких обрезаний, удаления `_`, автоматических преобразований регистра; некорректный ввод отвергается.
- Пользовательский PDA: `seed=SHA256(UTF8("user_login=" + fullLogin))`, **один seed из 32 сырых байт**; `findProgramAddress([seed], shine_users_program_id)`.
- Namespace PDA: `seed=SHA256(UTF8("namespace=" + namespace))`, **один seed из 32 сырых байт**; `findProgramAddress([seed], shine_users_program_id)`.
- `program_id` из тестовых векторов: `SHiNEPr1APdAgNBteUyBXcNovaHctpSjUu8oH2ZJdN6`. При другой программе адреса PDA изменятся.
## NamespaceState 1.0, байтовая раскладка
| Смещение | Значение | Байты |
|---|---|---:|
| 0 | major=1 | 1 |
| 1 | minor=0 | 1 |
| 2 | namespace_type: 1 платный; 2 бесплатный сертификат | 1 |
| 3 | min_localpart_len: u8, не менее 1, вместе с названием укладывается в 30 байт | 1 |
| 4 | namespace_len: u8 | 1 |
| 5 | namespace: lowercase ASCII | namespace_len |
| следующий | registration_fee: u64 little-endian (lamports) | 8 |
| только type=2 | registrar_pubkey: Ed25519 | 32 |
| только type=2 | server_login_len: u8; server_login в формате `login@namespace` | 1+N |
**Размер аккаунта ровно соответствует сериализованному размеру. Padding в namespace-PDA отсутствует.** Десериализатор отвергает лишние/недостающие байты, неверные версии, неизвестные типы, пустые/невалидные имена, несоответствие PDA, owner, namespace. В type=1 НЕ существует дополнительных нулевых полей. В type=2 оба поля обязательны. Цена допускает `0` для тестового namespace; защищённый signer authority выбирает значение до создания аккаунта. Изменение или удаление namespace пока отсутствует.
## Полномочия и создание
Создавать namespaces может только **текущая upgrade authority именно этой программы**. Программа читает аккаунт самой программы (`UpgradeableLoaderState::Program`) и связанный с ним ProgramData, проверяет владельца upgradeable loader, совпадение programData address и `Some(upgrade_authority)` с фактическим подписантом. При immutable программе — отказ. Для type=2 обязательная дополнительная read-only мета с **настоящим PDA v1.2** указанного `server_login`, у записи должен быть ServerProfile адрес; сначала регистрируется сервер в платном namespace. Economy PDA должен существовать, передаётся read-only, чтобы транзакция находилась через его историю `getSignaturesForAddress`. Уведомление `accountSubscribe` только из-за read-only меты не гарантировано.
## Векторы и воспроизводимость
- `tests/fixtures/registration-v2.json` — полный вектор, включая реальные синтетические ANS-104 bytes.
- `tests/fixtures/registration-v2.properties` — общий простой формат для Rust/Java/JS.
- `node --test tests/registration-v2-vectors.test.mjs` — проверка в Node без npm.
- `javac --release 17 -d /tmp/shine-reg-v2 tests/java/RegistrationV2VectorsCheck.java && java -cp /tmp/shine-reg-v2 RegistrationV2VectorsCheck tests/fixtures/registration-v2.properties`.
- `cargo test --test registration_v2_vectors` — в Rust окружении с toolchain (здесь недоступно).
Детерминированные приватные ключи, которыми построены фикстуры, **никогда не использовать** как настоящие ключи пользователей/регистратора.
@@ -183,3 +183,10 @@ Root доказывает владение recovery-key отдельной Ed255
- переводит его lamports вызывающему signer.
Legacy migration в 1.2 отсутствует. После удаления тестовых PDA временную close-инструкцию можно удалить из программы.
## Изменение адресации регистрации V2 (этапы 1–3, dev-only)
Бинарный user-PDA 1.2 **не изменён**. Меняется seed новых PDA на `SHA256(UTF8("user_login="+normalizedFullLogin))` (32 сырых байта), а полная строка `login@namespace` входит в поле `login` и в существующую подпись. Ограничение полного имени — 30 байт. `created_at_ms` в новой PDA при free→paid соответствует дате on-chain создания и не является датой первого Arweave сертификата. Историческая идентичность и потраченные лимиты остаются за логическим пользователем, их сохраняет сервер/БД последующих этапов.
Существующие PDA старых логинов без namespace продолжают принимать `update_user_pda` по старому seed `user_login=` + lowercase login; новых аккаунтов такого типа создать V2 больше нельзя. Новая регистрация **не будет совместима со старым клиентом** до обновления JS/сервера.
+51 -21
View File
@@ -21,41 +21,55 @@ Legacy 1.0 считается тестовым и не мигрируется.
Без изменений.
### `2 update_users_economy_config`
Без изменений.
### `3 create_user_pda`
Меняется **только** право доступа: текущая upgrade authority из ProgramData данного `shine_users`, а не статическая DAO-константа. Accounts: `signer writable?` (signer), `users_economy_config_pda writable`, `program read-only executable`, `programdata read-only`. `init` (opcode 1) остаётся доступным любому подписанту один раз.
### `3 create_user_pda` — новая V2-инструкция
**Внимание:** wire и account metas здесь уже несовместимы со старым UI. До завершения клиентского этапа №4 **НЕ DEPLOY** программу. Клиентский JS ещё не переписан.
```text
tag:u8 = 3
login:string_u8
login:string_u8 // полный lowercase login@namespace, <= 30 байт
root_key:[32]
created_at_ms:u64
additional_limit:u64
created_at_ms:u64 LE // новая Solana дата в пределах +-5 мин
additional_limit:u64 LE // кратно LIMIT_STEP
client_key:[32]
blockchain_key:[32]
address_count:u8 // 0 или 1
[address]
[address] // type:u8, version:u8, address:string_u8
access_server_count:u8 // 0 или 1
[access_server]
record_signature:[64]
[promo_seller_login:string_u8]
[access_server:string_u8]
record_signature:[64] // подпись текущего blockchain-key, сохраняется в PDA
registrar_signature_present:u8 // 0 для type 1, 1 для type 2
[registrar_signature:[64]] // только type 2, внутренняя подпись сертификата
```
Server address:
Accounts в неизменном порядке:
```text
address_format_type:u8
address_format_version:u8
address:string_u8
```
1. `payer` — signer, writable;
2. `user_pda` — writable (SHA-256 полного логина);
3. `system_program` — read-only;
4. `shine_payments` inflow vault — writable;
5. `sysvar::instructions` — read-only;
6. `users_economy_config_pda` — **read-only**;
7. `namespace_pda` — read-only, owner `shine_users`.
Fee payer — любой переданный signer; он не обязан совпадать с client key.
`created_at_ms` должен быть в пределах ±5 минут от Solana Clock.
Root даёт proof-of-possession, а initial blockchain key подписывает саму новую PDA.
Проверки: namespace реально существует в программе, `localPart >= min_localpart_len`, общая длина <= 30, обе части ASCII lowercase `[a-z0-9_]+`, PDA соответствует `SHA256("user_login="+fullLogin)`, схема v1.2, root и blockchain Ed25519 proof-of-possession. Цена = `namespace.registration_fee + additional_limit/LIMIT_STEP * economy.lamports_per_limit_step` в существующий `shine_payments` vault. На create сохраняется существующая схема starter quota из economy-PDA: при переходе free→paid внешняя БД обязана учесть уже использованный бонус и не выдать его снова.
**Ed25519 инструкции перед opcode 3 (строго непосредственно):**
- Тип 1: `[root_verify(unsigned_hash), blockchain_verify(unsigned_hash), create_user]`; смещения `-2`, `-1`.
- Тип 2: `[registrar_verify(inner_message), root_verify(unsigned_hash), blockchain_verify(unsigned_hash), create_user]`; смещения `-3`, `-2`, `-1`.
Всем проверкам нужны именно требуемые `pubkey`, `message`, а blockchain также сопоставляется с `record_signature`. Проверка сертификата использует `registrar_pubkey` **из указанного namespace-PDA**, а не ключ клиента. Порядок байтов inner message см. `docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md`. Solana подтверждает право создать PDA, но не утверждает успешную публикацию сертификата в Arweave.
**Upgrade free→paid** — тот же opcode 3 на том же полном логине и публичных ключах. Старые приватные ключи клиента не раскрываются; сохранение исходных публикаций обеспечивают синхронизатор/сервер (не Solana). Дата создания on-chain PDA может быть новой. Повторное создание PDA отвергается.
### `4 update_user_pda`
Работает только с PDA 1.2.
Работает только с PDA 1.2. Для нового `login@namespace` ищет SHA-256 PDA; для существующего старого логина без `@` сохраняет прежнюю схему `[b"user_login=", lowercase_login]`, чтобы не блокировать прежние аккаунты. Оплата дополнительных лимитов и авторизация обновлений не меняются.
```text
tag:u8 = 4
@@ -101,8 +115,9 @@ Root-mode:
Обе Ed25519-подписи проверяются по одному и тому же hash нового unsigned PDA state, поэтому новые root/client/blockchain public keys входят в подписываемое состояние.
### `5 upsert_promo_seller`
Без изменений.
### `5` — зарезервированная старая promo instruction
В V2 диспетчер не исполняет opcode 5. Новая регистрация не обращается в `shine_login_guard`, не использует promo seller и premium классы. Исторические standalone программы не удалялись.
### `6 close_legacy_pda`
@@ -120,6 +135,21 @@ Accounts:
Программа проверяет PDA seed/owner и `format=1.0`, переводит все lamports PDA вызывающему и обнуляет account data. PDA 1.2 этой инструкцией закрыть нельзя.
### `7 create_namespace`
```text
tag:u8=7
namespace_type:u8 // 1 paid-direct / 2 free-cert
min_localpart_len:u8
namespace:string_u8
registration_fee:u64 LE
[if type=2: registrar_pubkey:[32]; server_login:string_u8]
```
Accounts: `payer signer writable`, `namespace_pda writable`, `system_program read-only`, `economy_pda read-only`, `shine_users program executable read-only`, `shine_users ProgramData read-only`; **только type=2** — `registered_access_server_user_pda` (read-only) настоящего зарегистрированного сервера с ServerProfile.
Проверки: точный PDA по 32-байтному SHA-256 seed `namespace=NAME`, owner, пустой system PDA, версия 1.0, длина имени, тип, поля регистратора; economy валиден и read-only; `ProgramData` строго относится к этому исполняемому program ID и `upgrade_authority=Some(signer)`. У immutable программы создание запрещено; изменить/удалить namespace нельзя. Отдельная документация: `doc/formats/shine-namespace-pda-format-v1.md`.
## BlockchainRegistry 1.2
```text