SHA256
Улучшить UI регистрации и связанные сценарии
This commit is contained in:
@@ -6,11 +6,11 @@
|
||||
|
||||
### Регистрация пользователя (`create_user_pda`)
|
||||
|
||||
1. Плательщик: кошелек `signer` (кто отправил транзакцию).
|
||||
2. Получатель комиссии: `inflow_vault` (PDA в программе `shine_payments`).
|
||||
3. Сумма перевода:
|
||||
- `registration_fee_lamports` из economy-конфига `shine_users`;
|
||||
- плюс комиссия за `additional_limit` (по формуле через `limit_step` и `lamports_per_limit_step`).
|
||||
1. Плательщик: кошелёк `signer` (плательщик транзакции).
|
||||
2. Цена регистрации берётся из **`namespace.registration_fee`**, а не из старой стоимости economy-конфига.
|
||||
3. Из цены namespace оплачивается фактическое пополнение депозита для нового PDA до `Rent::minimum_balance(USER_PDA_SPACE)`. Если PDA уже пополнена, требуется только недостающая часть.
|
||||
4. В `inflow_vault` (PDA программы `shine_payments`) переводится `namespace.registration_fee - фактически оплаченный депозит PDA` плюс стоимость `additional_limit` (если он есть). Если цена namespace меньше полной минимальной стоимости rent PDA, создание отклоняется даже для заранее пополненной PDA; отрицательный остаток невозможен.
|
||||
5. Сеть Solana отдельно списывает фактическую транзакционную комиссию с кошелька-плательщика. Она **не входит** в цену namespace и не является доходом проекта. Базовая комиссия за одну подпись обычно составляет 5 000 lamports, но итоговая цена транзакции определяется сетью.
|
||||
|
||||
### Увеличение лимита (`update_user_pda`)
|
||||
|
||||
|
||||
@@ -1,30 +1,31 @@
|
||||
# SHiNE — Namespace PDA, бинарный формат 1.0
|
||||
# SHiNE — Namespace PDA, бинарные форматы 1.0 и 1.1
|
||||
|
||||
Статус: **черновая реализация в объединённом патче этапов 1–3**, не развёрнута; формат предложен как протокол V1. Перед деплоем обязательна компиляция Rust и тесты localnet/devnet.
|
||||
|
||||
## Идентичность и адреса
|
||||
|
||||
- `login@namespace`: строго ASCII lowercase, обе части `[a-z0-9_]+`, ровно один `@`.
|
||||
- `login@namespace`: localpart допускает ASCII `[A-Za-z0-9_]+`, namespace только 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, байтовая раскладка
|
||||
## NamespaceState 1.0/1.1, байтовая раскладка
|
||||
|
||||
| Смещение | Значение | Байты |
|
||||
|---|---|---:|
|
||||
| 0 | major=1 | 1 |
|
||||
| 1 | minor=0 | 1 |
|
||||
| 1 | minor=0 (исторический) либо minor=1 (актуальный) | 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 |
|
||||
| следующий | registration_fee: u64 little-endian (lamports), для SOL это **вся цена регистрации** без сетевой комиссии | 8 |
|
||||
| только minor=1 | currency_code: u8; **1=SOL**; **2 зарезервировано под USDT, сейчас запрещено** | 1 |
|
||||
| только 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 пока отсутствует.
|
||||
**Размер аккаунта ровно соответствует сериализованному размеру. Padding в namespace-PDA отсутствует.** Старые 1.0 записи продолжают читаться с `currency_code=1` по умолчанию. Новые namespace записываются сразу как 1.1; при первом update существующий 1.0 PDA увеличивается на 1 байт, а upgrade authority при необходимости доплачивает rent за расширение. Десериализатор отвергает лишние/недостающие байты, неверные версии, неизвестные типы, пустые/невалидные имена, несоответствие PDA, owner, namespace. В type=1 НЕ существует дополнительных нулевых полей. В type=2 оба поля обязательны. Цена допускает `0` для тестового namespace; защищённый signer authority выбирает значение до создания аккаунта. Изменение цены доступно текущей upgrade authority программой `shine_users` (opcode 8); rename, удаление и изменение типа namespace по-прежнему запрещены. Код `2` пока не поддержан ни для обновлений, ни для регистрации, курсовой пересчёт отсутствует.
|
||||
|
||||
## Полномочия и создание
|
||||
|
||||
@@ -39,3 +40,11 @@
|
||||
- `cargo test --test registration_v2_vectors` — в Rust окружении с toolchain (здесь недоступно).
|
||||
|
||||
Детерминированные приватные ключи, которыми построены фикстуры, **никогда не использовать** как настоящие ключи пользователей/регистратора.
|
||||
|
||||
## Инструкция изменения цены (opcode 8)
|
||||
|
||||
`[8:u8, name:string_u8, currency_code:u8, registration_fee:u64LE]`. Имя namespace не изменяется, валюта обязана быть `1`, цена в lamports может меняться. Подпись — **текущей upgrade authority** из ProgramData `shine_users`, а не произвольного регистратора.
|
||||
|
||||
Порядок account metas: (1) signer/fee-payer writable signer; (2) namespace PDA writable; (3) system program read-only; (4) users economy PDA read-only (индексация синхронизатором); (5) shine_users Program read-only executable; (6) upgradeable ProgramData read-only. До записи программа сверяет PDA по имени и owner, проверяет полномочия, корректность economy PDA и currency code. При изменении старого формата — доплата rent и realloc +1 байт.
|
||||
|
||||
После confirmed-транзакции сервер-синхронизатор видит opcode 8 в истории `economy PDA`, читает **текущий** namespace PDA, применяет `UPSERT` к `shine_namespace_current` и обновляет `registration_fee_lamports`, `currency_code`, `slot`, `raw_data_base64`. Клиент непосредственно перед отправкой платёжной транзакции перечитывает namespace из Solana — запись на сервере служит только кэшем/первичным отображением.
|
||||
|
||||
@@ -27,7 +27,7 @@ Legacy 1.0 считается тестовым и не мигрируется.
|
||||
|
||||
### `3 create_user_pda` — новая V2-инструкция
|
||||
|
||||
**Внимание:** wire и account metas здесь уже несовместимы со старым UI. До завершения клиентского этапа №4 **НЕ DEPLOY** программу. Клиентский JS ещё не переписан.
|
||||
**Важно для развёртывания:** этот патч изменяет экономику `create_user_pda`, но не wire-формат и не список account metas. Обновление on-chain программы `shine_users` должно предшествовать выкладке UI с новой формулой. Старый контракт списывает депозит PDA поверх цены namespace, новый — внутри неё. Ни тестирование, ни публикация программы в сеть не входят в подготовку патча.
|
||||
|
||||
```text
|
||||
tag:u8 = 3
|
||||
@@ -56,7 +56,9 @@ Accounts в неизменном порядке:
|
||||
6. `users_economy_config_pda` — **read-only**;
|
||||
7. `namespace_pda` — read-only, owner `shine_users`.
|
||||
|
||||
Проверки: namespace реально существует в программе, `localPart >= min_localpart_len`, общая длина <= 30, localpart допускает ASCII `[A-Za-z0-9_]+`, namespace остаётся ASCII lowercase `[a-z0-9_]+`, PDA соответствует `SHA256("user_login="+ASCII-lowercase(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 внешняя БД обязана учесть уже использованный бонус и не выдать его снова.
|
||||
Проверки: namespace реально существует в программе, `localPart >= min_localpart_len`, общая длина <= 30, localpart допускает ASCII `[A-Za-z0-9_]+`, namespace остаётся ASCII lowercase `[a-z0-9_]+`, PDA соответствует `SHA256("user_login="+ASCII-lowercase(fullLogin))`, схема v1.2, root и blockchain Ed25519 proof-of-possession. Цена создания PDA для подписанта (без комиссии самой сети) = `namespace.registration_fee + additional_limit/LIMIT_STEP * economy.lamports_per_limit_step`.
|
||||
На создание PDA направляется `top_up = max(0, Rent::minimum_balance(USER_PDA_SPACE) - user_pda.lamports())`, сумма `namespace.registration_fee - top_up` переводится в существующий `shine_payments` vault. Оплата дополнительного лимита направляется в тот же vault полностью. Схема учитывает заранее пополненный system-owned адрес PDA: подписант платит **ровно цену namespace** за регистрацию вне зависимости от ранее зачисленных lamports; их наличие уменьшает top-up и увеличивает остаток, направляемый в vault.
|
||||
Если `namespace.registration_fee < Rent::minimum_balance(USER_PDA_SPACE)`, транзакция отклоняется независимо от заранее внесённых lamports ошибкой `RegistrationFeeBelowRent` (код 45). Сетевая комиссия Solana оплачивается подписантом **сверх** цены namespace; её определяет сеть, она не переводится в vault. Цену можно изменить только отдельной инструкцией `8 update_namespace_price` по подписи текущей upgrade authority. Код валюты проверяется: пока разрешён лишь `1=SOL`; пересчёт в USD/USDT не реализован. На create сохраняется существующая схема starter quota из economy-PDA: при переходе free→paid внешняя БД обязана учесть уже использованный бонус и не выдать его снова.
|
||||
|
||||
**Ed25519 инструкции перед opcode 3 (строго непосредственно):**
|
||||
|
||||
@@ -148,7 +150,7 @@ registration_fee:u64 LE
|
||||
|
||||
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`.
|
||||
Проверки: точный PDA по 32-байтному SHA-256 seed `namespace=NAME`, owner, пустой system PDA, на создание пишется версия 1.1 с `currency_code=1`, длина имени, тип, поля регистратора; economy валиден и read-only; `ProgramData` строго относится к этому исполняемому program ID и `upgrade_authority=Some(signer)`. У immutable программы создание запрещено; цену можно обновлять только opcode 8, удалить/переименовать namespace нельзя. Отдельная документация: `doc/formats/shine-namespace-pda-format-v1.md`.
|
||||
|
||||
## BlockchainRegistry 1.2
|
||||
|
||||
@@ -174,3 +176,11 @@ forks[]:
|
||||
|
||||
### Регистронезависимая идентичность (28.10.2026)
|
||||
Локальная часть полного `login@namespace` допускает латинские буквы `A–Z` и `a–z`, цифры и `_`; `namespace` допускает только нижний ASCII-регистр. Выбранный при регистрации регистр логина неизменяем. Адрес user PDA вычисляется по `SHA256(UTF8("user_login=" + ASCII-lowercase(fullLogin)))` и bump для `find_program_address`. Сама запись PDA 1.2 содержит **оригинальное** написание `login`; подписи записи и регистраторского сертификата проверяются по исходному регистру без нормализации. Это изменение правила seed, не бинарного формата PDA.
|
||||
|
||||
### `8 update_namespace_price` — настройка цены пространства имён
|
||||
|
||||
Формат: `tag=8; namespace:string_u8; currency_code:u8; registration_fee:u64LE`. Код `1` = SOL, код `2` зарезервирован для USDT и **отвергается** (`UnsupportedNamespaceCurrency=46`). Цена `registration_fee` в lamports включает rent user PDA, без комиссии транзакции.
|
||||
|
||||
Accounts: signer/current upgrade authority writable, namespace PDA writable, system program read-only, economy PDA read-only, `shine_users` executable read-only, ProgramData read-only. Проверяется реальная текущая upgrade authority, а не ключ по умолчанию. У старого namespace 1.0 цена обновляется с миграцией бинарной записи до v1.1 и возможной доплатой rent за 1 байт. Изменение полей registrar/server/type не допускается.
|
||||
|
||||
Синхронизатор получает новую цену по истории economy PDA с разбором opcode 8 и чтением обновлённого namespace PDA. Новые регистрации в обоих сценариях всегда проверяют стоимость по on-chain namespace непосредственно перед отправкой транзакции.
|
||||
|
||||
@@ -46,6 +46,8 @@ const IX_CREATE_USER_PDA: u8 = 3;
|
||||
const IX_UPDATE_USER_PDA: u8 = 4;
|
||||
const IX_CLOSE_LEGACY_USER_PDA: u8 = 6;
|
||||
const IX_CREATE_NAMESPACE: u8 = 7;
|
||||
const IX_UPDATE_NAMESPACE_PRICE: u8 = 8;
|
||||
const NAMESPACE_CURRENCY_SOL: u8 = 1; // 2 зарезервировано под USDT, пока запрещено
|
||||
const CERTIFICATE_DOMAIN: &[u8] = b"SHiNE_FREE_REG_V1\0";
|
||||
|
||||
#[repr(u32)]
|
||||
@@ -95,6 +97,8 @@ enum ShineUsersError {
|
||||
InvalidUpgradeAuthority = 42,
|
||||
NamespaceAlreadyExists = 43,
|
||||
CertificateRequired = 44,
|
||||
RegistrationFeeBelowRent = 45,
|
||||
UnsupportedNamespaceCurrency = 46,
|
||||
}
|
||||
|
||||
impl From<ShineUsersError> for ProgramError {
|
||||
@@ -208,6 +212,7 @@ pub struct NamespaceState {
|
||||
pub min_localpart_len: u8,
|
||||
pub namespace: String,
|
||||
pub registration_fee: u64,
|
||||
pub currency_code: u8,
|
||||
pub registrar_pubkey: Option<Pubkey>,
|
||||
pub server_login: Option<String>,
|
||||
}
|
||||
@@ -297,6 +302,13 @@ fn process_instruction<'a>(program_id: &Pubkey, accounts: &'a [AccountInfo<'a>],
|
||||
r.finish()?;
|
||||
process_create_namespace(program_id, accounts, args)
|
||||
},
|
||||
IX_UPDATE_NAMESPACE_PRICE => {
|
||||
let namespace_name = r.read_string_u8()?;
|
||||
let currency_code = r.read_u8()?;
|
||||
let registration_fee = r.read_u64()?;
|
||||
r.finish()?;
|
||||
process_update_namespace_price(program_id, accounts, &namespace_name, currency_code, registration_fee)
|
||||
},
|
||||
IX_CLOSE_LEGACY_USER_PDA => dispatch_close_legacy_user_pda(program_id, accounts, r),
|
||||
_ => Err(ProgramError::from(ShineUsersError::InvalidInstruction)),
|
||||
}
|
||||
@@ -324,7 +336,7 @@ fn parse_namespace_args(r: &mut Reader<'_>) -> Result<NamespaceState, ProgramErr
|
||||
2 => (Some(r.read_pubkey()?), Some(r.read_string_u8()?)),
|
||||
_ => return Err(ShineUsersError::InvalidNamespace.into()),
|
||||
};
|
||||
let state = NamespaceState { namespace_type, min_localpart_len, namespace, registration_fee, registrar_pubkey, server_login };
|
||||
let state = NamespaceState { namespace_type, min_localpart_len, namespace, registration_fee, currency_code: NAMESPACE_CURRENCY_SOL, registrar_pubkey, server_login };
|
||||
validate_namespace_state(&state)?;
|
||||
Ok(state)
|
||||
}
|
||||
@@ -496,6 +508,35 @@ fn process_create_namespace(program_id: &Pubkey, accounts: &[AccountInfo], state
|
||||
write_pda_exact(namespace_pda, &data)
|
||||
}
|
||||
|
||||
/// Обновление цены namespace; единственный разрешённый администратор — текущая upgrade authority.
|
||||
/// Мета economy PDA нужна для истории синхронизации; аккаунт только для чтения.
|
||||
fn process_update_namespace_price(program_id: &Pubkey, accounts: &[AccountInfo], name: &str, currency_code: u8, registration_fee: u64) -> ProgramResult {
|
||||
let mut it = accounts.iter();
|
||||
let signer = next_account_info(&mut it)?;
|
||||
let namespace_pda = next_account_info(&mut it)?;
|
||||
let system_program_ai = next_account_info(&mut it)?;
|
||||
let economy_pda = next_account_info(&mut it)?;
|
||||
let program_ai = next_account_info(&mut it)?;
|
||||
let programdata_ai = next_account_info(&mut it)?;
|
||||
require!(it.next().is_none(), ShineUsersError::InvalidInstruction);
|
||||
require!(signer.is_signer && signer.is_writable, ShineUsersError::InvalidSigner);
|
||||
require!(namespace_pda.is_writable, ShineUsersError::InvalidAccountData);
|
||||
require_keys_eq!(*system_program_ai.key, system_program::id(), ShineUsersError::InvalidSystemProgram);
|
||||
validate_upgrade_authority(program_id, signer, program_ai, programdata_ai)?;
|
||||
validate_users_economy_config_pda(program_id, economy_pda)?;
|
||||
read_users_economy_config(economy_pda)?;
|
||||
require!(!economy_pda.is_writable, ShineUsersError::InvalidAccountData);
|
||||
validate_namespace_name(name)?;
|
||||
let mut state = read_namespace(program_id, namespace_pda, name)?;
|
||||
state.currency_code = currency_code;
|
||||
state.registration_fee = registration_fee;
|
||||
validate_namespace_state(&state)?;
|
||||
let encoded = serialize_namespace(&state);
|
||||
// v1.0 аккаунт создан без места под currency_code. При первом update расширяем на 1 байт.
|
||||
ensure_pda_size_and_rent(namespace_pda, signer, system_program_ai, encoded.len())?;
|
||||
write_pda_exact(namespace_pda, &encoded)
|
||||
}
|
||||
|
||||
/// Проверяем не просто подписанта, а актуальную authority ProgramData ИМЕННО этой программы.
|
||||
/// Bincode layout UpgradeableLoaderState: Program = [2:u32LE, programdata:32],
|
||||
/// ProgramData = [3:u32LE, slot:u64LE, Option<Pubkey>:1+32].
|
||||
@@ -586,6 +627,20 @@ fn process_create_user_pda<'a>(program_id: &Pubkey, accounts: &'a [AccountInfo<'
|
||||
record.signature = verify_record_signature_hash_at(instructions_sysvar, -1, &record.active_fork()?.blockchain_key, &args.signature, unsigned_hash.as_ref())?;
|
||||
|
||||
let serialized = pad_to_fixed_size(serialize_full_record_v12(&record)?, settings::USER_PDA_SPACE)?;
|
||||
// Цена namespace включает депозит PDA: пользователь оплачивает rent из своей
|
||||
// фиксированной суммы, а в inflow_vault поступает лишь её остаток.
|
||||
// Для заранее пополненного system-owned адреса учитываем только фактический top-up.
|
||||
let required_rent = Rent::get()?.minimum_balance(settings::USER_PDA_SPACE);
|
||||
// Недорогие namespace блокируются независимо от внешнего пополнения PDA:
|
||||
// в любой момент цена должна покрывать rent записи фиксированного размера.
|
||||
require!(namespace.registration_fee >= required_rent, ShineUsersError::RegistrationFeeBelowRent);
|
||||
let rent_paid_by_signer = required_rent.saturating_sub(user_pda.lamports());
|
||||
let namespace_remainder = namespace.registration_fee
|
||||
.checked_sub(rent_paid_by_signer)
|
||||
.ok_or(ProgramError::from(ShineUsersError::RegistrationFeeBelowRent))?;
|
||||
let vault_fee = namespace_remainder
|
||||
.checked_add(limit_fee_lamports(args.additional_limit, economy.lamports_per_limit_step)?)
|
||||
.ok_or(ProgramError::from(ShineUsersError::MathOverflow))?;
|
||||
create_pda_account(
|
||||
signer,
|
||||
user_pda,
|
||||
@@ -596,8 +651,7 @@ fn process_create_user_pda<'a>(program_id: &Pubkey, accounts: &'a [AccountInfo<'
|
||||
)?;
|
||||
write_pda_exact(user_pda, &serialized)?;
|
||||
|
||||
let total_fee = namespace.registration_fee.checked_add(limit_fee_lamports(args.additional_limit, economy.lamports_per_limit_step)?).ok_or(ProgramError::from(ShineUsersError::MathOverflow))?;
|
||||
transfer_lamports(signer, inflow_vault, system_program_ai, total_fee)?;
|
||||
transfer_lamports(signer, inflow_vault, system_program_ai, vault_fee)?;
|
||||
Ok(())
|
||||
}
|
||||
|
||||
@@ -1091,6 +1145,7 @@ fn validate_full_login(login: &str) -> Result<&str, ProgramError> {
|
||||
}
|
||||
|
||||
pub fn validate_namespace_state(state: &NamespaceState) -> ProgramResult {
|
||||
require!(state.currency_code == NAMESPACE_CURRENCY_SOL, ShineUsersError::UnsupportedNamespaceCurrency);
|
||||
validate_namespace_name(&state.namespace)?;
|
||||
require!(state.namespace.len() + 1 + state.min_localpart_len as usize <= 30 && state.min_localpart_len > 0, ShineUsersError::InvalidNamespace);
|
||||
match state.namespace_type {
|
||||
@@ -1105,9 +1160,10 @@ pub fn validate_namespace_state(state: &NamespaceState) -> ProgramResult {
|
||||
}
|
||||
|
||||
pub fn serialize_namespace(state: &NamespaceState) -> Vec<u8> {
|
||||
let mut out = vec![1, 0, state.namespace_type, state.min_localpart_len, state.namespace.len() as u8];
|
||||
let mut out = vec![1, 1, state.namespace_type, state.min_localpart_len, state.namespace.len() as u8];
|
||||
out.extend_from_slice(state.namespace.as_bytes());
|
||||
out.extend_from_slice(&state.registration_fee.to_le_bytes());
|
||||
out.push(state.currency_code);
|
||||
if let (Some(registrar), Some(server)) = (state.registrar_pubkey, state.server_login.as_ref()) {
|
||||
out.extend_from_slice(registrar.as_ref());
|
||||
out.push(server.len() as u8);
|
||||
@@ -1122,18 +1178,21 @@ fn read_namespace(program_id: &Pubkey, ai: &AccountInfo, name: &str) -> Result<N
|
||||
require!(ai.owner == program_id, ShineUsersError::InvalidAccountOwner);
|
||||
let data = ai.try_borrow_data()?;
|
||||
let mut r = Reader::new(&data);
|
||||
require!(r.read_u8()? == 1 && r.read_u8()? == 0, ShineUsersError::InvalidNamespace);
|
||||
require!(r.read_u8()? == 1, ShineUsersError::InvalidNamespace);
|
||||
let minor = r.read_u8()?;
|
||||
require!(minor == 0 || minor == 1, ShineUsersError::InvalidNamespace);
|
||||
let namespace_type = r.read_u8()?;
|
||||
let min_localpart_len = r.read_u8()?;
|
||||
let namespace = r.read_string_u8()?;
|
||||
let registration_fee = r.read_u64()?;
|
||||
let currency_code = if minor == 1 { r.read_u8()? } else { NAMESPACE_CURRENCY_SOL };
|
||||
let (registrar_pubkey, server_login) = match namespace_type {
|
||||
1 => (None, None),
|
||||
2 => (Some(r.read_pubkey()?), Some(r.read_string_u8()?)),
|
||||
_ => return Err(ShineUsersError::InvalidNamespace.into()),
|
||||
};
|
||||
r.finish()?;
|
||||
let state = NamespaceState { namespace_type, min_localpart_len, namespace, registration_fee, registrar_pubkey, server_login };
|
||||
let state = NamespaceState { namespace_type, min_localpart_len, namespace, registration_fee, currency_code, registrar_pubkey, server_login };
|
||||
require!(state.namespace == name, ShineUsersError::InvalidNamespace);
|
||||
validate_namespace_state(&state)?;
|
||||
Ok(state)
|
||||
|
||||
@@ -34,6 +34,9 @@ async function run(){
|
||||
if(!(['localhost','127.0.0.1'].includes(endpoint.hostname)||endpoint.hostname.endsWith('.devnet.solana.com')))
|
||||
throw Error('Разрешены только localhost/127.0.0.1 и *.devnet.solana.com; production запрещён');
|
||||
const type=Number(options.type),minimum=Number(options['min-length']);
|
||||
// Формат namespace 1.1 хранит валюту явно; создание через legacy tag=7 всегда задаёт SOL.
|
||||
const currencyCode=Number(options.currency ?? '1');
|
||||
if(currencyCode!==1)throw Error('Код 2 USDT зарезервирован; создание namespace доступно только в SOL (код 1)');
|
||||
const fee=BigInt(options['fee-lamports']);
|
||||
if(![1,2].includes(type) || !Number.isInteger(minimum) || minimum<1 || minimum+1+namespace.length>30 || fee<0n || fee>0xffffffffffffffffn)
|
||||
throw Error('Некорректные тип, длина или цена');
|
||||
@@ -71,7 +74,7 @@ async function run(){
|
||||
{pubkey:programdata,isSigner:false,isWritable:false},
|
||||
...(serverPda?[{pubkey:serverPda,isSigner:false,isWritable:false}]:[]),
|
||||
],data:payload});
|
||||
console.log(JSON.stringify({namespace,type,minimum,fee:fee.toString(),pda:pda.toBase58(),bump,economy:economy.toBase58(),programdata:programdata.toBase58(),mode:options.send?'SEND':'DRY-RUN'},null,2));
|
||||
console.log(JSON.stringify({namespace,type,minimum,currencyCode,fee:fee.toString(),pda:pda.toBase58(),bump,economy:economy.toBase58(),programdata:programdata.toBase58(),mode:options.send?'SEND':'DRY-RUN'},null,2));
|
||||
if(!options.send)return;
|
||||
const signature=await sendAndConfirmTransaction(connection,new Transaction().add(instruction),[wallet],{commitment:'confirmed'});
|
||||
console.log('Подтверждённая devnet/localnet транзакция:',signature);
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
#!/usr/bin/env node
|
||||
import { readFileSync } from 'node:fs';
|
||||
|
||||
// Автономный декодер namespace 1.0 (без RPC и внешних пакетов).
|
||||
// Автономный декодер namespace 1.0/1.1 (без RPC и внешних пакетов).
|
||||
export function decodeNamespace(data) {
|
||||
const b=Buffer.from(data);
|
||||
if(b.length<13) throw Error('namespace: payload слишком короткий');
|
||||
if(b[0]!==1 || b[1]!==0) throw Error('namespace: неизвестная версия');
|
||||
if(b[0]!==1 || ![0,1].includes(b[1])) throw Error('namespace: неизвестная версия');
|
||||
const minor=b[1];
|
||||
const type=b[2],minLocalLen=b[3],len=b[4];
|
||||
if(type!==1 && type!==2)throw Error('namespace: неверный тип');
|
||||
if(!len || !minLocalLen || len+1+minLocalLen>30) throw Error('namespace: некорректная длина');
|
||||
@@ -14,6 +15,8 @@ export function decodeNamespace(data) {
|
||||
const name=b.subarray(p,p+len).toString('utf8');p+=len;
|
||||
if(!/^[a-z0-9_]+$/.test(name) || Buffer.byteLength(name)!==len) throw Error('namespace: некорректное название');
|
||||
const fee=b.readBigUInt64LE(p).toString();p+=8;
|
||||
const currencyCode=minor===1?b[p++]:1;
|
||||
if(currencyCode!==1) throw Error('namespace: неподдерживаемый код валюты (пока только 1=SOL)');
|
||||
let registrar=null,serverLogin=null;
|
||||
if(type===2){
|
||||
if(p+33>b.length)throw Error('namespace: отсутствуют ключ и логин сервера');
|
||||
@@ -24,7 +27,7 @@ export function decodeNamespace(data) {
|
||||
if(!/^[a-z0-9_]+@[a-z0-9_]+$/.test(serverLogin) || Buffer.byteLength(serverLogin)>30)throw Error('namespace: неверный логин сервера');
|
||||
}
|
||||
if(p!==b.length) throw Error('namespace: лишние байты запрещены');
|
||||
return {major:1,minor:0,type,minLocalLen,name,registrationFeeLamports:fee,registrarPubkeyHex:registrar,serverLogin};
|
||||
return {major:1,minor,type,minLocalLen,name,registrationFeeLamports:fee,currencyCode,registrarPubkeyHex:registrar,serverLogin};
|
||||
}
|
||||
if(process.argv[1]?.endsWith('decode-namespace.mjs')){
|
||||
const data=process.argv[2];
|
||||
|
||||
@@ -39,8 +39,15 @@ fn namespace_pdas_and_binaries_match_vectors() {
|
||||
assert_eq!(bump.to_string(),fixture(&format!("namespace_{name}_bump")));
|
||||
assert_eq!(encode_hex(hash(format!("namespace={name}").as_bytes()).as_ref()),fixture(&format!("namespace_{name}_seed")));
|
||||
let registrar=if typ==2 {Some(Pubkey::new_from_array(decode_hex(&fixture("registrar_pubkey_hex")).try_into().unwrap()))}else{None};
|
||||
let state=NamespaceState {namespace_type:typ,min_localpart_len:3,namespace:name.to_string(),registration_fee:fee,registrar_pubkey:registrar,server_login:if typ==2{Some("registrar@shine".to_string())}else{None}};
|
||||
assert_eq!(encode_hex(&serialize_namespace(&state)),fixture(&format!("namespace_{name}_bytes_hex")));
|
||||
let state=NamespaceState {namespace_type:typ,min_localpart_len:3,namespace:name.to_string(),registration_fee:fee,currency_code:1,registrar_pubkey:registrar,server_login:if typ==2{Some("registrar@shine".to_string())}else{None}};
|
||||
let encoded=serialize_namespace(&state);
|
||||
assert_eq!(encoded[0..2], [1,1]);
|
||||
assert_eq!(encoded[5+name.len()+8], 1); // код валюты после u64 fee
|
||||
// Исторические 1.0 векторы отличаются только версией и отсутствующим байтом валюты.
|
||||
let mut legacy=encoded.clone();
|
||||
legacy[1]=0;
|
||||
legacy.remove(5+name.len()+8);
|
||||
assert_eq!(encode_hex(&legacy),fixture(&format!("namespace_{name}_bytes_hex")));
|
||||
}
|
||||
}
|
||||
#[test]
|
||||
|
||||
Reference in New Issue
Block a user