Улучшить UI регистрации и связанные сценарии

This commit is contained in:
AidarKC
2026-11-08 18:04:06 +03:00
parent 9405f28525
commit 4068465ee6
66 changed files with 842 additions and 221 deletions
+5 -5
View File
@@ -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 — запись на сервере служит только кэшем/первичным отображением.
+13 -3
View File
@@ -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]