solana: закрыть griefing создания PDA и заморозку выплат, добавить аудит №2

shine_payments + shine_users:
- create_pda_account переведён на «создание поверх предзаполненного»
  (allocate+assign+добор ренты), чтобы подсев лампортов на детерминированный
  адрес PDA (тикет/логин) не блокировал создание — закрыт LOW из аудита №1;
  в shine_payments is_uninitialized_account перестала зависеть от баланса.

shine_payments (HIGH из аудита №2):
- запрещён recipient == inflow_vault в buy_ticket*, manager_add_ticket и
  change_ticket_recipient; добавлена защита по умолчанию в transfer_from_vault
  (require vault.key != recipient.key). Это убирает алиасинг аккаунта в
  step_payout, который навсегда замораживал очередь выплат и средства вольта.

Документация и учёт:
- doc/programs/shine_payments.md §3.4, §10.1; doc/programs/shine_users.md §3.3;
- Dev_Docs/audit: добавлен аудит №2, обе закрытые находки помечены ИСПРАВЛЕНО;
- Dev_Docs/Pending_Features: две записи на ручную e2e-проверку на devnet;
- VERSION.properties: client 1.2.161, server 1.2.150.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
AidarKC 2026-06-11 04:10:31 +04:00
parent 01d9553db4
commit cf6a2830c8
9 changed files with 389 additions and 16 deletions

View File

@ -0,0 +1,33 @@
# Запрет получателя тикета, равного inflow-вольту (защита от заморозки очереди)
## Краткое описание
Закрыта HIGH-находка второго аудита (`Dev_Docs/audit/Solana-audit-2-by-Claude-11июня2026.md`).
Тикет с `recipient_wallet == адрес inflow_vault` приводил к алиасингу аккаунта в
`step_payout` (вольт одновременно источник и получатель), второй mutable-займ
лампортов в `transfer_from_vault` падал, и такой тикет навсегда блокировал
обслуживание очереди и замораживал средства вольта.
Исправление в `shine_payments`:
- `buy_ticket_by_purchase_usd``require!(recipient_wallet != config.inflow_vault)`;
- `process_manager_add_ticket` — запрет через `find_single_pda(INFLOW_VAULT_SEED)`;
- `process_change_ticket_recipient` — тот же запрет для `new_recipient_wallet`;
- `transfer_from_vault` — защита по умолчанию `require!(vault.key != recipient.key)`.
Ошибка во всех случаях — `InvalidTicketRecipient`.
## Что проверять (devnet/localnet)
1. Покупка тикета с `recipient_wallet = <адрес inflow_vault PDA>` → отклоняется
(`InvalidTicketRecipient`), тикет не создаётся.
2. `manager_add_ticket` с тем же recipient → отклоняется.
3. `change_ticket_recipient` с `new_recipient = inflow_vault` → отклоняется.
4. Обычные покупки/выплаты с нормальным получателем → работают как раньше, очередь
обслуживается, `step_payout` выплачивает корректно.
5. Регресс не затронул выплаты в `dao_wallet` и `call_reward` подписанту (их адреса
не совпадают с вольтом).
## Ожидаемый результат
Тикет с получателем-вольтом невозможно создать; ранее существовавший вектор
перманентной заморозки очереди закрыт. Прочая логика выплат без изменений.
## Статус
pending

View File

@ -0,0 +1,32 @@
# Устойчивое создание PDA (защита от «минирования» адреса)
## Краткое описание
В `shine_payments` и `shine_users` функция `create_pda_account` переведена с жёсткого
`system_instruction::create_account` на паттерн «создание поверх предзаполненного»:
- если на детерминированном адресе будущего PDA нет лампортов — обычный `create_account`;
- если лампорты уже есть («подсев» атакующим) — добор ренты переводом, затем
`allocate` + `assign` под подписью PDA.
Дополнительно в `shine_payments` `is_uninitialized_account` перестала требовать нулевой
баланс (проверяет только пустые данные + владельца System Program).
Это закрывает последний (LOW) пункт аудита: griefing-DoS на покупку тикетов и сквоттинг
логинов через предсказуемые адреса PDA.
## Что проверять (devnet/localnet)
1. Обычная покупка тикета без «подсева» — создаётся как раньше (быстрый путь).
2. На адрес следующего тикета заранее переведены лампорты обычным system-переводом →
покупка/`manager_add_ticket` всё равно проходит, тикет создаётся корректно, данные
и владелец = program id.
3. На адрес `user_pda` будущего логина заранее переведены лампорты → регистрация логина
(`create_user_pda`) всё равно проходит; запись и комиссия корректны.
4. Повторная инициализация уже существующего тикета/пользователя по-прежнему отклоняется
(`PdaAlreadyExists` / `UserAlreadyExists`).
5. Singleton-PDA (`init`, economy config) и manager allowance создаются без регрессий.
## Ожидаемый результат
Подсев лампортов на заранее известный адрес PDA не блокирует создание; вся остальная
экономика и проверки повторной инициализации работают как прежде.
## Статус
pending

View File

@ -0,0 +1,177 @@
# Аудит безопасности Solana-программ SHiNE — выпуск 2 (11.06.2026)
Повторный независимый аудит после исправления всех 4 находок первого отчёта
(`Solana-audit-by-Claude-File5-9июня2026.md`). Код перечитан целиком:
- `shine_login_guard` (183 строки) — stateless-классификатор логинов;
- `shine_users` (1069 строк) — реестр пользователей, PDA-записи, подписи, экономика лимитов;
- `shine_payments` (1381 строка) — очереди тикетов, выплаты из вольта, оракул Pyth.
Перебраны классы атак: подмена аккаунтов/PDA, авторизация и подписи, арифметика и
переполнения, валидация оракула, экономика, реентранси, griefing/DoS, **алиасинг
аккаунтов (передача одного аккаунта в несколько слотов инструкции)**.
## Статус прошлых находок (все закрыты)
- 🔴 Critical #1 (economy-config PDA в `shine_users`) — закрыто: `validate_users_economy_config_pda` проверяет и адрес, и `owner == program_id`, и вызывается перед чтением и в create, и в update.
- 🔴 Critical #2 (singleton-PDA в `shine_payments`) — закрыто: `validate_singleton_state_pda` проверяет точный адрес + `owner == id()` во всех инструкциях (`update_coef_limit`, `grant_manager_limits`, `buy_ticket*`, `manager_add_ticket`, `step_payout`, `change_ticket_recipient`).
- 🟠 Medium (валидация Pyth) — закрыто: пин адреса аккаунта `PYTH_SOL_USD_ACCOUNT`, проверка `owner == pyth_receiver`, разбор официальным `PriceUpdateV2`, `get_price_no_older_than` с проверкой `feed_id`, проверка возраста и доверительного интервала (`ORACLE_MAX_CONFIDENCE_PPM`).
- 🟡 Low (griefing на предсказуемых адресах) — закрыто: `create_pda_account` в обеих программах переведён на «создание поверх предзаполненного» (allocate + assign + добор ренты).
---
## 🔴 HIGH (НОВОЕ) — `shine_payments`: тикет с `recipient_wallet == inflow_vault` навсегда замораживает все выплаты — ✅ ИСПРАВЛЕНО (11.06.2026)
Закрыто: равенство `recipient == inflow_vault` запрещено во всех точках задания
получателя — `buy_ticket_by_purchase_usd` (через `config.inflow_vault`),
`process_manager_add_ticket` и `process_change_ticket_recipient` (через
`find_single_pda(INFLOW_VAULT_SEED)`). Дополнительно в `transfer_from_vault` добавлена
защита по умолчанию `require!(vault.key != recipient.key)`. Документация —
`doc/programs/shine_payments.md` §10.1. Историческое описание находки ниже.
### Где
`transfer_from_vault` (строки 12581268) переводит лампорты из вольта прямой
манипуляцией балансами (вольт — PDA без приватного ключа, обычный system-перевод
невозможен):
```rust
fn transfer_from_vault(vault: &AccountInfo, recipient: &AccountInfo, amount: u64) -> ProgramResult {
if amount == 0 { return Ok(()); }
let mut vault_lamports = vault.try_borrow_mut_lamports()?; // займ #1
let mut recipient_lamports = recipient.try_borrow_mut_lamports()?; // займ #2
...
}
```
В `step_payout` (строка 849) получатель — это `ticket.recipient_wallet`:
```rust
transfer_from_vault(inflow_vault_pda, ticket_recipient_wallet, ticket_lamports)?;
```
А `recipient_wallet` нигде не валидируется при создании тикета:
`buy_ticket*` (строки 696/711/725 → 1031), `manager_add_ticket` (строка 765),
`change_ticket_recipient` (строка 900) — берут его «как есть» из аргументов.
### Суть атаки (алиасинг аккаунта)
В Solana, если один и тот же аккаунт передан в инструкцию в нескольких слотах,
рантайм отдаёт для всех слотов **один и тот же** `RefCell` (механизм дублей).
Поэтому если `ticket.recipient_wallet` равен адресу `inflow_vault` PDA, то в
`step_payout` аккаунт вольта попадает и в слот `inflow_vault_pda`, и в слот
`ticket_recipient_wallet`. Тогда внутри `transfer_from_vault`:
- `vault.try_borrow_mut_lamports()` — берёт mutable-займ (успех);
- `recipient.try_borrow_mut_lamports()` — это **тот же** аккаунт → второй
mutable-займ → `Err(AccountBorrowFailed)``?` возвращает ошибку → инструкция
падает.
### Почему это «заморозка всего», а не один тикет
Выплаты идут строго по возрастанию индекса. `step_payout` всегда обслуживает
сначала очередь Q1 (если в ней есть pending), затем Q2, затем Q3, и в каждой —
ровно «следующий неоплаченный» тикет (`paid + 1`). Тикет с `recipient == vault`:
- не может быть оплачен (`step_payout` всегда падает на нём);
- не может быть пропущен (нет механизма «skip»);
- блокирует все тикеты после него в своей очереди;
- если он в Q1 — блокирует обслуживание Q2 и Q3 (до них очередь не доходит);
- лампорты вольта (накопленные регистрационные комиссии) перестают выплачиваться
и не уходят в DAO (слив в DAO происходит только когда `pending == 0` по всем
очередям, а это состояние недостижимо).
### Эксплуатация (тривиальная, перестановочная)
Q1 — публичная очередь (`buy_ticket` доступен любому). Атакующий покупает **один**
дешёвый тикет Q1, указав `recipient_wallet = <адрес inflow_vault PDA>`. Адрес вольта
детерминирован и публичен (`find_single_pda(INFLOW_VAULT_SEED)`). С этого момента вся
подсистема выплат и средства вольта заморожены за стоимость одного тикета + ренты.
Дополнительно: даже при защите на этапе покупки остаётся вектор через
`change_ticket_recipient` (строка 900) — владелец любого своего неоплаченного тикета
может выставить `new_recipient_wallet = vault` позже.
### Класс и серьёзность
Класс: «account aliasing / duplicate-account mutable borrow» + отсутствие
валидации адреса получателя. Прямой кражи средств нет, но это перманентный
отказ в обслуживании (availability) с блокировкой средств вольта, триггер —
копеечный и доступен анонимно. Оценка: **HIGH**.
### Рекомендуемый фикс
Запретить `recipient`, равный адресу вольта, во всех точках, где он задаётся, чтобы
тикет с таким получателем вообще не мог появиться:
1. в `buy_ticket_by_purchase_usd``require!(recipient_wallet != config.inflow_vault, …)`
(config уже прочитан);
2. в `process_manager_add_ticket` — сверять с `find_single_pda(INFLOW_VAULT_SEED).0`;
3. в `process_change_ticket_recipient` — то же для `new_recipient_wallet`.
Дополнительно (defense-in-depth) — в `transfer_from_vault` явно
`require!(vault.key != recipient.key, …)` с понятной ошибкой, чтобы любой будущий
вызов был защищён от алиасинга. Этого `require` недостаточно как единственной меры
(тикет всё равно застрял бы), поэтому основная защита — на входе.
---
## 🟡 LOW / INFO — наблюдения без прямой эксплуатации
### L1. `change_ticket_recipient` и `buy_ticket` не проверяют получателя на «опасные» адреса
Связано с HIGH выше; после фикса основной проблемы стоит заодно зафиксировать
правило «получатель не должен совпадать с системными PDA программы».
### L2. Гонка за логином (first-come) в `shine_users`
Адрес `user_pda` выводится из логина. После закрытия griefing-подсева остаётся
обычное состязание: увидев в мемпуле регистрацию `alice`, атакующий может
зарегистрировать `alice` со своим `root_key` первым. On-chain это решается только
commit-reveal; для текущей модели — приемлемый риск, отметить как известный.
### L3. `step_payout` без slippage-параметра
Выплата считается по текущей цене оракула без верхней границы лампортов. Цена
ограничена возрастом (120с) и доверительным интервалом (10%), аккаунт оракула
запинен — манипуляция маловероятна, но при резком движении цены SOL объём выплаты
в лампортах плавает. Риск низкий; при желании добавить верхнюю границу на шаг.
### L4. Экономическая устойчивость вольта (дизайн, не баг)
Деньги за покупку тикетов (`buy_ticket`) уходят на `dao_wallet`, а выплаты в
`step_payout` идут из `inflow_vault`, который наполняется **регистрационными
комиссиями** `shine_users`. Если поток регистраций меньше обязательств по выплатам,
вольт истощается и выплаты останавливаются (без потери средств, но с остановкой
сервиса). Это свойство экономической модели — стоит явно держать в уме и
мониторить баланс вольта/обязательств.
### L5. Заполнение Q1 до лимита как мягкий DoS
`buy_ticket` блокируется при `q1_sum_total >= limit_usd_cents`. Атакующий может
наполнить Q1 своими тикетами и приостановить покупки. Дорого (тратит SOL в DAO и
ренту) и его же тикеты потом оплачиваются из вольта, поэтому это скорее
экономический, а не дешёвый griefing. Риск низкий.
---
## ✅ Проверено и подтверждено как корректное
- **Подмена singleton-PDA** невозможна: везде сверяется точный адрес и владелец.
- **Авторизация**: `update_coef_limit`/`grant_manager_limits` требуют `signer == config.dao_wallet`; `manager_add_ticket``signer == allowance.manager_wallet`; `change_ticket_recipient``signer == ticket.recipient_wallet`; обновление economy-config — `signer == DAO_AUTHORITY`.
- **Ed25519 в `shine_users`**: строгие относительные индексы (1/2), `num_signatures == 1`, все три `ix_index == u16::MAX` (данные внутри самой ed25519-инструкции), сверка pubkey/signature/message по хэшу. Подмена и указание на чужую инструкцию исключены.
- **Цепочка версий записи** (`version == record_number+1`, `prev_hash == hash(old)`) — корректная защита от replay; сигнатура записи завязана на `root_key`, а не на плательщика.
- **Монотонность** `used_bytes`/`last_block_number` и `used_bytes <= paid_limit_bytes`.
- **Арифметика**: повсеместные `checked_*`, `overflow-checks = true`, расчёты оракула в `u128` с `u64::try_from` на сужении.
- **Оракул Pyth**: пин аккаунта + owner + feed_id + возраст + confidence через официальный SDK.
- **Рент-экземпт вольта** сохраняется: `available_vault_lamports` вычитает `minimum_balance`, а суммарная проверка `available >= needed` гарантирует, что после выплат вольт не опустится ниже ренты.
- **Двойная оплата тикета** исключена: `is_paid` + инкремент `*_tickets_paid`, следующий шаг адресует следующий индекс.
- **Реентранси отсутствует**: CPI только в System Program (transfer/allocate/assign) и в stateless `shine_login_guard` (с проверкой возвращённого `program_id`); обратных вызовов в наши программы нет.
- **create_pda_account (новый)**: устойчив к подсеву лампортов; атакующий не может ни выделить данные, ни сменить владельца PDA (нет ключа/seeds), поэтому ветка allocate+assign безопасна.
- **shine_login_guard**: stateless, без аккаунтов и средств; DFS-классификация ограничена (`MAX_WORDS_PER_LOGIN = 3`, длина ≤ 20) — без compute-DoS.
---
## Приоритет действий
1. **HIGH** — запретить `recipient == inflow_vault` в `buy_ticket*`, `manager_add_ticket`,
`change_ticket_recipient`; добавить `require!(vault.key != recipient.key)` в
`transfer_from_vault` как защиту по умолчанию. Закрыть до mainnet.
2. **LOW** — зафиксировать правило «получатель ≠ системные PDA» (L1), оценить
добавление верхней границы выплаты на шаг (L3).
3. **INFO** — формально задокументировать экономику вольта (L4) и known-issue
гонки за логином (L5/L2).
Изменений в код в рамках этого аудита не вносил — это анализ. Готов подготовить патч
по пункту 1, если подтвердите.

View File

@ -73,7 +73,19 @@ read_sol_usd_price / parse_pyth_price_update_v2 (строки 10381075):
Проверка возраста цены (ORACLE_MAX_AGE_SECS = 120) есть и сделана корректно. Рекомендация: проверять владельца аккаунта, сверять feed_id с константой и валидировать verification_level == Full (или парсить через официальный pyth_solana_receiver_sdk, который уже завендорен в .vendor/). Проверка возраста цены (ORACLE_MAX_AGE_SECS = 120) есть и сделана корректно. Рекомендация: проверять владельца аккаунта, сверять feed_id с константой и валидировать verification_level == Full (или парсить через официальный pyth_solana_receiver_sdk, который уже завендорен в .vendor/).
--- ---
🟡 LOW — DoS через предсказуемые адреса тикетов 🟡 LOW — DoS через предсказуемые адреса тикетов — ✅ ИСПРАВЛЕНО (11.06.2026)
Закрыто: `create_pda_account` в `shine_payments` и `shine_users` переведён на паттерн
«создание поверх предзаполненного» (allocate + assign + добор ренты вместо строгого
`system_instruction::create_account`). «Подсев» лампортов на заранее известный адрес
тикета или пользовательской записи больше не блокирует создание PDA. Проверка
`is_uninitialized_account` в payments перестала зависеть от нулевого баланса. Тот же фикс
закрывает аналогичный сквоттинг логинов в `shine_users` (адрес выводится из логина).
Подробности — в `doc/programs/shine_payments.md` §3.4 и `doc/programs/shine_users.md` §3.3.
Историческое описание находки ниже.
is_uninitialized_account (строка 1195) считает аккаунт неинициализированным только если lamports() == 0. Адреса тикетов детерминированы (queue_seed + index), а индекс последователен и предсказуем. Любой может заранее перевести немного лампортов на адрес следующего тикета — тогда create_pda_account упадёт (PdaAlreadyExists / ошибка create_account), заблокировав покупку/добавление тикета. Это griefing-DoS, не кража. Митигировать можно паттерном «create поверх предзаполненного» (allocate + assign + добор ренты) вместо system_instruction::create_account. is_uninitialized_account (строка 1195) считает аккаунт неинициализированным только если lamports() == 0. Адреса тикетов детерминированы (queue_seed + index), а индекс последователен и предсказуем. Любой может заранее перевести немного лампортов на адрес следующего тикета — тогда create_pda_account упадёт (PdaAlreadyExists / ошибка create_account), заблокировав покупку/добавление тикета. Это griefing-DoS, не кража. Митигировать можно паттерном «create поверх предзаполненного» (allocate + assign + добор ренты) вместо system_instruction::create_account.

View File

@ -1,2 +1,2 @@
client.version=1.2.159 client.version=1.2.161
server.version=1.2.148 server.version=1.2.150

View File

@ -58,6 +58,24 @@
- seed prefix: `shine_p_manager_allow` - seed prefix: `shine_p_manager_allow`
- второй seed: `manager_wallet.as_ref()` - второй seed: `manager_wallet.as_ref()`
### 3.4. Правило создания PDA (защита от «минирования» адреса)
Все адреса PDA детерминированы (особенно тикеты: seed + последовательный `ticket_index`),
поэтому злоумышленник может заранее вычислить адрес будущего тикета и перевести на него
немного лампортов обычным system-переводом. Если бы создание шло строго через
`system_instruction::create_account`, такой «подсев» приводил бы к ошибке
«account already in use» и навсегда блокировал бы покупку/добавление тикета (griefing-DoS).
Поэтому `create_pda_account` создаёт аккаунт устойчиво к предзаполненному балансу:
- если на адресе нет лампортов — обычный `create_account` (быстрый путь);
- если лампорты уже есть — «создание поверх предзаполненного»: добор ренты переводом,
затем `allocate` + `assign` под подписью PDA.
Признак «инициализируемого» аккаунта (`is_uninitialized_account`) — пустые данные и
владелец System Program; условие нулевого баланса намеренно не проверяется. Уже созданный
программой PDA имеет данные/владельца = program id и повторно инициализирован не будет.
## 4. Состояния программы ## 4. Состояния программы
### 4.1. `ConfigState` ### 4.1. `ConfigState`
@ -218,7 +236,8 @@
- ticket создаётся только в `Q1`; - ticket создаётся только в `Q1`;
- очередь `Q1` временно блокируется, если достигнут её суммарный лимит; - очередь `Q1` временно блокируется, если достигнут её суммарный лимит;
- `payout_usd_cents = purchase_usd_cents * coef_ppm / COEF_SCALE_PPM`; - `payout_usd_cents = purchase_usd_cents * coef_ppm / COEF_SCALE_PPM`;
- `recipient_wallet` записывается в ticket. - `recipient_wallet` записывается в ticket;
- `recipient_wallet` **не должен совпадать с адресом inflow-вольта** (см. §10.1).
### 9.2. Важная деталь денежного потока ### 9.2. Важная деталь денежного потока
@ -248,6 +267,7 @@ Signer должен совпадать с `manager_wallet` в `manager_allowance
- `queue_id` только `1`, `2` или `3`; - `queue_id` только `1`, `2` или `3`;
- `payout_usd_cents > 0`; - `payout_usd_cents > 0`;
- `recipient_wallet` не равен адресу inflow-вольта (см. §10.1);
- доступный allowance по очереди не меньше суммы тикета; - доступный allowance по очереди не меньше суммы тикета;
- ticket PDA ещё не существует. - ticket PDA ещё не существует.
@ -257,6 +277,21 @@ Signer должен совпадать с `manager_wallet` в `manager_allowance
- allowance уменьшается; - allowance уменьшается;
- агрегаты соответствующей очереди увеличиваются. - агрегаты соответствующей очереди увеличиваются.
### 10.1. Запрет получателя, равного inflow-вольту (важно для безопасности)
`recipient_wallet` тикета не должен совпадать с адресом `inflow_vault` PDA.
Причина: в `step_payout` выплата получателю исполняется прямой манипуляцией
балансами (`transfer_from_vault`), где источником служит сам вольт. Если получатель
равен вольту, один и тот же аккаунт попадает в инструкцию дважды (в Solana дубли
делят общий `RefCell`), и второй mutable-займ лампортов завершается ошибкой. Такой
тикет невозможно ни оплатить, ни пропустить — он навсегда блокирует обслуживание
очереди (а если он в `Q1`, то и `Q2`/`Q3`) и замораживает средства вольта.
Поэтому равенство `recipient == inflow_vault` запрещено во всех точках, где
получатель задаётся: `buy_ticket*`, `manager_add_ticket`, `change_ticket_recipient`.
Дополнительно `transfer_from_vault` содержит защиту по умолчанию
`require!(vault.key != recipient.key)`.
## 11. Инструкция `step_payout` ## 11. Инструкция `step_payout`
### Назначение ### Назначение
@ -334,6 +369,8 @@ next_index = tickets_paid + 1
### Ограничения ### Ограничения
`new_recipient_wallet` не должен совпадать с адресом inflow-вольта (см. §10.1).
Нельзя менять получателя у следующего тикета на выплату в активной очереди. Нельзя менять получателя у следующего тикета на выплату в активной очереди.
Логика: Логика:

View File

@ -74,6 +74,23 @@ PDA экономических настроек:
users_economy_config_pda = PDA(["shine_users_economy_config"], shine_users_program_id) users_economy_config_pda = PDA(["shine_users_economy_config"], shine_users_program_id)
``` ```
### 3.3. Правило создания PDA (защита от «минирования» адреса)
Адрес пользовательской PDA выводится из логина и публично предсказуем: зная желаемый логин,
любой может заранее вычислить адрес записи и перевести на него немного лампортов обычным
system-переводом. Если бы создание шло строго через `system_instruction::create_account`,
такой «подсев» приводил бы к ошибке «account already in use» и навсегда блокировал бы
регистрацию этого логина (targeted-DoS / сквоттинг логинов), причём без оплаты комиссии.
Поэтому `create_pda_account` создаёт аккаунт устойчиво к предзаполненному балансу:
- если на адресе нет лампортов — обычный `create_account` (быстрый путь);
- если лампорты уже есть — «создание поверх предзаполненного»: добор ренты переводом,
затем `allocate` + `assign` под подписью PDA.
Проверки повторной инициализации (`owner == System Program` и пустые данные) остаются и
не зависят от баланса аккаунта.
## 4. Состояния программы ## 4. Состояния программы
### 4.1. `UsersEconomyConfigState` ### 4.1. `UsersEconomyConfigState`

View File

@ -741,6 +741,10 @@ fn process_manager_add_ticket(
require!(args.payout_usd_cents > 0, PaymentsError::InvalidPayoutAmount); require!(args.payout_usd_cents > 0, PaymentsError::InvalidPayoutAmount);
require!(is_valid_queue_id(args.queue_id), PaymentsError::InvalidTicketQueue); require!(is_valid_queue_id(args.queue_id), PaymentsError::InvalidTicketQueue);
// Получатель не должен совпадать с inflow-вольтом (см. подробности в
// buy_ticket_by_purchase_usd): иначе тикет навсегда застрянет в step_payout.
let (inflow_vault_addr, _) = find_single_pda(program_id, settings::INFLOW_VAULT_SEED);
require!(args.recipient_wallet != inflow_vault_addr, PaymentsError::InvalidTicketRecipient);
let (expected_manager_pda, _) = find_manager_allowance_pda(program_id, signer.key); let (expected_manager_pda, _) = find_manager_allowance_pda(program_id, signer.key);
require_keys_eq!(expected_manager_pda, *manager_allowance_pda.key, PaymentsError::InvalidPdaAddress); require_keys_eq!(expected_manager_pda, *manager_allowance_pda.key, PaymentsError::InvalidPdaAddress);
@ -868,6 +872,11 @@ fn process_change_ticket_recipient(
require!(account_iter.next().is_none(), PaymentsError::InvalidInstruction); require!(account_iter.next().is_none(), PaymentsError::InvalidInstruction);
validate_singleton_state_pda(program_id, queues_pda, settings::QUEUES_SEED)?; validate_singleton_state_pda(program_id, queues_pda, settings::QUEUES_SEED)?;
// Новый получатель не должен совпадать с inflow-вольтом (см. подробности в
// buy_ticket_by_purchase_usd): иначе тикет навсегда застрянет в step_payout.
let (inflow_vault_addr, _) = find_single_pda(program_id, settings::INFLOW_VAULT_SEED);
require!(args.new_recipient_wallet != inflow_vault_addr, PaymentsError::InvalidTicketRecipient);
let queues = read_state::<QueuesState>(queues_pda)?; let queues = read_state::<QueuesState>(queues_pda)?;
let mut ticket = read_state::<TicketState>(ticket_pda)?; let mut ticket = read_state::<TicketState>(ticket_pda)?;
require!(!ticket.is_paid, PaymentsError::TicketAlreadyPaid); require!(!ticket.is_paid, PaymentsError::TicketAlreadyPaid);
@ -1010,6 +1019,11 @@ fn buy_ticket_by_purchase_usd(
let mut queues = read_state::<QueuesState>(ctx.queues_pda)?; let mut queues = read_state::<QueuesState>(ctx.queues_pda)?;
require_keys_eq!(*ctx.dao_wallet.key, config.dao_wallet, PaymentsError::InvalidDaoWallet); require_keys_eq!(*ctx.dao_wallet.key, config.dao_wallet, PaymentsError::InvalidDaoWallet);
// Получатель тикета не должен совпадать с inflow-вольтом: иначе в step_payout
// вольт окажется и источником, и получателем перевода (алиасинг одного аккаунта),
// второй mutable-займ в transfer_from_vault упадёт, и такой тикет навсегда
// заморозит обслуживание очереди. Запрещаем такой recipient на входе.
require!(recipient_wallet != config.inflow_vault, PaymentsError::InvalidTicketRecipient);
let queue1_sum_total_before = queues.q1_sum_total_usd_cents; let queue1_sum_total_before = queues.q1_sum_total_usd_cents;
require!(queue1_sum_total_before < coef_limit.limit_usd_cents, PaymentsError::QueueTemporarilyPaused); require!(queue1_sum_total_before < coef_limit.limit_usd_cents, PaymentsError::QueueTemporarilyPaused);
@ -1192,13 +1206,31 @@ fn create_pda_account<'info>(
space: u64, space: u64,
) -> ProgramResult { ) -> ProgramResult {
require!(is_uninitialized_account(pda), PaymentsError::PdaAlreadyExists); require!(is_uninitialized_account(pda), PaymentsError::PdaAlreadyExists);
let lamports = Rent::get()?.minimum_balance(space as usize); let required_lamports = Rent::get()?.minimum_balance(space as usize);
let create_ix = system_instruction::create_account(payer.key, pda.key, lamports, space, program_id); let current_lamports = pda.lamports();
invoke_signed(
&create_ix, if current_lamports == 0 {
&[payer.clone(), pda.clone(), system_program_ai.clone()], // Быстрый путь: адрес пуст — обычное создание аккаунта одной инструкцией.
&[seeds], let create_ix = system_instruction::create_account(payer.key, pda.key, required_lamports, space, program_id);
) return invoke_signed(
&create_ix,
&[payer.clone(), pda.clone(), system_program_ai.clone()],
&[seeds],
);
}
// На адресе уже лежат лампорты — вероятно, «подсев» атакующим на заранее
// известный детерминированный адрес тикета/PDA. Создаём «поверх предзаполненного»:
// доводим ренту переводом, затем allocate + assign под подписью PDA.
let top_up = required_lamports.saturating_sub(current_lamports);
if top_up > 0 {
let transfer_ix = system_instruction::transfer(payer.key, pda.key, top_up);
invoke(&transfer_ix, &[payer.clone(), pda.clone(), system_program_ai.clone()])?;
}
let allocate_ix = system_instruction::allocate(pda.key, space);
invoke_signed(&allocate_ix, &[pda.clone(), system_program_ai.clone()], &[seeds])?;
let assign_ix = system_instruction::assign(pda.key, program_id);
invoke_signed(&assign_ix, &[pda.clone(), system_program_ai.clone()], &[seeds])
} }
fn write_state<T: StateCodec>(pda: &AccountInfo, state: &T) -> ProgramResult { fn write_state<T: StateCodec>(pda: &AccountInfo, state: &T) -> ProgramResult {
@ -1219,9 +1251,15 @@ fn read_state<T: StateCodec>(pda: &AccountInfo) -> Result<T, ProgramError> {
T::decode(&data[..encoded_len]) T::decode(&data[..encoded_len])
} }
// «Инициализируемым» считаем аккаунт без данных, всё ещё принадлежащий System
// Program. Условие lamports() == 0 сознательно убрано: адреса тикетов и прочих
// PDA детерминированы, и любой может заранее перевести на них немного лампортов,
// чтобы заблокировать создание (griefing-DoS). Наличие лампортов больше не должно
// мешать инициализации — за безопасное создание «поверх предзаполненного» отвечает
// create_pda_account. Уже созданный нашей программой PDA имеет данные/владельца id()
// и сюда не пройдёт.
fn is_uninitialized_account(account: &AccountInfo) -> bool { fn is_uninitialized_account(account: &AccountInfo) -> bool {
account.lamports() == 0 account.data_len() == 0
&& account.data_len() == 0
&& (*account.owner == system_program::ID || *account.owner == Pubkey::default()) && (*account.owner == system_program::ID || *account.owner == Pubkey::default())
} }
@ -1235,6 +1273,9 @@ fn transfer_from_vault(vault: &AccountInfo, recipient: &AccountInfo, amount: u64
if amount == 0 { if amount == 0 {
return Ok(()); return Ok(());
} }
// Защита по умолчанию от алиасинга: источник и получатель не должны быть одним
// и тем же аккаунтом, иначе второй mutable-займ лампортов ниже завершится ошибкой.
require!(vault.key != recipient.key, PaymentsError::InvalidTicketRecipient);
let mut vault_lamports = vault.try_borrow_mut_lamports()?; let mut vault_lamports = vault.try_borrow_mut_lamports()?;
let mut recipient_lamports = recipient.try_borrow_mut_lamports()?; let mut recipient_lamports = recipient.try_borrow_mut_lamports()?;
require!(**vault_lamports >= amount, PaymentsError::NotEnoughInflowForStep); require!(**vault_lamports >= amount, PaymentsError::NotEnoughInflowForStep);

View File

@ -1007,11 +1007,35 @@ fn transfer_lamports<'a>(payer: &AccountInfo<'a>, recipient: &AccountInfo<'a>, s
invoke(&ix, &[payer.clone(), recipient.clone(), system_program_ai.clone()]) invoke(&ix, &[payer.clone(), recipient.clone(), system_program_ai.clone()])
} }
// Создание PDA, устойчивое к «минированию» детерминированного адреса.
// Адрес будущей записи логина выводится из самого логина, поэтому злоумышленник
// может заранее вычислить адрес и перевести на него немного лампортов обычным
// system-переводом. Тогда обычный system_instruction::create_account упал бы
// («account already in use») и заблокировал бы регистрацию этого логина навсегда.
// Чтобы это исключить, при уже существующих на адресе лампортах создаём аккаунт
// «поверх предзаполненного»: доводим ренту переводом, затем allocate + assign
// под подписью PDA. Подсев чужих лампортов больше ничего не ломает.
fn create_pda_account<'a>(payer: &AccountInfo<'a>, pda: &AccountInfo<'a>, system_program_ai: &AccountInfo<'a>, owner: &Pubkey, seeds: &[&[u8]], space: usize) -> ProgramResult { fn create_pda_account<'a>(payer: &AccountInfo<'a>, pda: &AccountInfo<'a>, system_program_ai: &AccountInfo<'a>, owner: &Pubkey, seeds: &[&[u8]], space: usize) -> ProgramResult {
let rent = Rent::get()?; let rent = Rent::get()?;
let lamports = rent.minimum_balance(space); let required_lamports = rent.minimum_balance(space);
let ix = system_instruction::create_account(payer.key, pda.key, lamports, space as u64, owner); let current_lamports = pda.lamports();
invoke_signed(&ix, &[payer.clone(), pda.clone(), system_program_ai.clone()], &[seeds])
if current_lamports == 0 {
// Быстрый путь: адрес пуст — обычное создание аккаунта одной инструкцией.
let ix = system_instruction::create_account(payer.key, pda.key, required_lamports, space as u64, owner);
return invoke_signed(&ix, &[payer.clone(), pda.clone(), system_program_ai.clone()], &[seeds]);
}
// На адресе уже лежат лампорты (вероятно, «подсев» атакующим). Доводим баланс
// до рент-экземпта, выделяем место и назначаем владельцем нашу программу.
let top_up = required_lamports.saturating_sub(current_lamports);
transfer_lamports(payer, pda, system_program_ai, top_up)?;
let allocate_ix = system_instruction::allocate(pda.key, space as u64);
invoke_signed(&allocate_ix, &[pda.clone(), system_program_ai.clone()], &[seeds])?;
let assign_ix = system_instruction::assign(pda.key, owner);
invoke_signed(&assign_ix, &[pda.clone(), system_program_ai.clone()], &[seeds])
} }
fn ensure_pda_size_and_rent<'a>(pda: &AccountInfo<'a>, payer: &AccountInfo<'a>, system_program_ai: &AccountInfo<'a>, required_len: usize) -> ProgramResult { fn ensure_pda_size_and_rent<'a>(pda: &AccountInfo<'a>, payer: &AccountInfo<'a>, system_program_ai: &AccountInfo<'a>, required_len: usize) -> ProgramResult {