> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.md).

# Ограничения

Ограничения при разработке на Rome EVM — размер транзакции Solana, бюджет \~1,4 млн CU, лимиты аккаунтов, структура хранения и то, как Rome обходит каждое из них.

Важные ограничения и пределы при разработке на Rome EVM. Понимание этих ограничений помогает проектировать контракты, которые работают надежно.

## Ограничения транзакций Solana

| Ограничение                          | Значение          | Влияние                                                                                                              |
| ------------------------------------ | ----------------- | -------------------------------------------------------------------------------------------------------------------- |
| Размер транзакции                    | 4 КБ (4 096 байт) | Rome отправляет транзакции Solana v1; более крупные EVM-транзакции размещаются в аккаунтах-держателях (прозрачно)    |
| Вычислительные единицы на транзакцию | \~1,4 млн CU      | Операции, превышающие этот предел, используют итеративный режим, у которого есть собственные ограничения (ниже)      |
| Аккаунтов на транзакцию              | 64 адреса         | Предел транзакции v1; учитывается все, к чему прикасаются EVM-транзакция и ее CPI, включая собственные аккаунты Rome |
| Макс. размер холдера                 | 80 КБ             | Максимальный размер RLP для одной EVM-транзакции                                                                     |

## Ограничения выполнения EVM

| Ограничение                               | Значение                                               | Примечания                                                                                                                                                                                                                    |
| ----------------------------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Слоты хранилища контракта                 | 256 на аккаунт хранилища                               | Для каждого контракта можно создать несколько аккаунтов хранилища                                                                                                                                                             |
| Opcode за итерацию                        | Адаптивно                                              | Упаковывается в бюджет CU каждой транзакции Solana (VmIt)                                                                                                                                                                     |
| TTL блокировки аккаунта                   | 3 с (4 с, когда сессия затрагивает более 28 аккаунтов) | Во время итеративного выполнения; обновляется на каждом шаге                                                                                                                                                                  |
| Длина итеративной сессии                  | 160 шагов                                              | После достижения лимита следующий шаг освобождает блокировки сессии и завершает ее без фиксации каких-либо изменений                                                                                                          |
| Этапы, запланированные Rust SDK Rome      | 128                                                    | Предел итеративного компоновщика; реальные вызовы завершаются значительно раньше                                                                                                                                              |
| Транзакций на план, подписанный кошельком | 64                                                     | Максимум `rome_submitSignedV1Plan` принимает за один вызов; см. [Ретранслируемые вызовы и длинные вызовы](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md#relayed-calls-and-long-calls) |
| Казначейские кошельки                     | 64                                                     | Кошельки пула комиссий                                                                                                                                                                                                        |
| Ограничение размера контракта             | 24 КБ                                                  | То же, что и в Ethereum (EIP-170, 24 576 байт)                                                                                                                                                                                |

## Ограничения CPI

| Ограничение                         | Значение                                                                          | Примечания                                                                                                                                     |
| ----------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Глубина CPI                         | Максимум 4 уровня                                                                 | Предел глубины CPI в Solana                                                                                                                    |
| Аккаунтов на вызов CPI              | В пределах лимита транзакции в 64 адреса                                          | Разделяется со всеми другими аккаунтами, к которым обращается транзакция                                                                       |
| Глубина CPI + Transfer Hook         | Использует уровни CPI                                                             | Transfer hooks изнутри CPI могут превысить глубину                                                                                             |
| Один маршрут на контракт            | Устаревший (`0xff…07/08/09`, `0x42…16`) **или** кэшированный (`0xff…04/05/06/0b`) | Смешивание изменяющих вызовов из обоих вариантов в одной транзакции запрещено                                                                  |
| Устаревший CPI в итеративном режиме | Не допускается                                                                    | CPI устаревшего маршрута в итеративной транзакции завершается с ошибкой `CpiProhibitedInIterativeTx`; эффекты кэшированного маршрута разрешены |

**Глубина CPI — самое критическое ограничение.** Rome EVM потребляет один уровень CPI, когда Solana вызывает программу Rome. Если ваш контракт Solidity затем вызывает другую программу Solana через CPI, это уровень 2. Если та программа вызывает еще одну, это уровень 3. Всего у вас максимум 4 уровня.

```
Уровень 0: среда выполнения Solana → программа Rome EVM
Уровень 1: программа Rome EVM → ваша цель CPI (например, Jupiter)
Уровень 2: Jupiter → другая программа (например, Raydium)
Уровень 3: Raydium → SPL Token (максимальная глубина)
```

## Ограничения Transfer Hook Token-2022

| Ограничение                    | Влияние                                                                                      |
| ------------------------------ | -------------------------------------------------------------------------------------------- |
| Один хук на mint               | У mint Token-2022 есть один слот для transfer-hook                                           |
| `transfer_checked` только      | Хуки не срабатывают на обычном `transfer`. Операции моста Rome используют `transfer_checked` |
| Mint/burn не привязаны к хукам | Управляется через authority mint, а не хуками                                                |

## Ограничения газа и ценообразования

| Ограничение           | Примечания                                                     |
| --------------------- | -------------------------------------------------------------- |
| Источник цены газа    | Пул Meteora DAMM, v1 или v2 (SPL gas token)                    |
| Множитель цены газа   | Настраивается для каждого прокси (`gas_price_mul`)             |
| Минимальная цена газа | Задается конфигурацией прокси                                  |
| Оценка газа           | Выполняется вне цепочки через эмулятор Mollusk перед отправкой |

## Ограничения, зависящие от сети

| Среда             | Идентификатор цепи | Идентификатор программы rome-evm              |
| ----------------- | ------------------ | --------------------------------------------- |
| Hadrian (testnet) | 200010             | `RPTWwELXAY4KC9ZPHhaxp7Sq1hHtU3HNEgLbSegCcWf` |
| Rubicon (mainnet) | 7531               | `RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX` |

## Ограничения пре-компиляций

| Пре-компиляция                 | Ограничение                                                                                                                                  |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Modexp (0x05)                  | **Отключено** — вызов завершается с ошибкой `вызов big_mod_exp отключен` до тех пор, пока Solana не активирует `big_mod_exp` системный вызов |
| BN254 ecPairing (0x08)         | Около 22 тыс. CU плюс 12,8 тыс. на пару по тарифам программы; проверка на четыре пары укладывается в одну атомарную транзакцию               |
| Пре-компиляция CPI (0xFF...08) | Аккаунты должны быть заранее объявлены в транзакции Solana                                                                                   |

## Валидация транзакций

| Правило                      | Эффект                                                                                                                                                                                                        |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Изменяемость подписи (EIP-2) | Подписанная транзакция, у которой `s` выше половины порядка кривой, отклоняется                                                                                                                               |
| Форма RLP                    | Транзакция, у которой RLP-список содержит завершающие байты после последнего элемента, отклоняется                                                                                                            |
| Нереализованный opcode       | Прерывает всю транзакцию (`IncompatibleVersionEVM(opcode)`); ничего не фиксируется, и вызывающий контракт не может это подавить                                                                               |
| Учет газа                    | В Rome нет газового расписания для каждого opcode: газ, переданный `CALL`/`CREATE` , не принудительно применяется, и нет stipend'а в 2300 газа — не полагайтесь на защиту от реэнтрантности на основе stipend |

## Ограничения оракулов

| Ограничение                           | Значение                                                                                |
| ------------------------------------- | --------------------------------------------------------------------------------------- |
| Максимальная устарелость по умолчанию | 60 секунд                                                                               |
| Исторические данные раунда            | Не поддерживается — `getRoundData(roundId)` завершается с ошибкой                       |
| EMA Switchboard                       | Не поддерживается — `latestEMAData()` завершается с ошибкой на SwitchboardV3            |
| Смещения парсера                      | Эмпирически подтверждено — перед повторным развертыванием необходимо повторно проверить |

## Рекомендации по проектированию

1. **Держите глубину CPI небольшой.** Проектируйте контракты так, чтобы свести вложенность к минимуму. Если вы вызываете Jupiter, который вызывает Raydium, который вызывает SPL Token, вы находитесь на 3 уровнях — опасно близко к пределу.
2. **Предпочитайте атомарный режим.** Проектируйте операции так, чтобы они укладывались примерно в 1,4 млн CU. Итеративный режим добавляет задержку (блокировки на 3–4 секунды), лимит в 160 итераций на сессию и запрос кошелька на каждый этап на маршруте Solana, когда сам кошелек подписывает этапы. Вызов, который делает CPI устаревшего маршрута, вообще не может выполняться итеративно.
3. **Заранее объявляйте аккаунты.** Все аккаунты Solana, к которым обращается CPI, должны быть известны на момент создания транзакции (эмуляция прокси их обнаруживает). Динамическое обнаружение аккаунтов внутри вызова CPI невозможно, а общее число должно укладываться в лимит 64 адресов.
4. **Выбирайте один маршрут пре-компиляции на контракт.** Вызов пользовательской программы Solana (`invoke_signed`) — это устаревший маршрут и только атомарный режим; см. [Интеграция программы Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/integrate-solana-program.md).
5. **Используйте `transfer_checked`.** Если вы создаете что-либо, что работает с токенами Token-2022, всегда используйте `transfer_checked` чтобы хуки срабатывали.
6. **Проверяйте потребление CU.** Измеряйте реальные вычислительные единицы Solana по квитанции транзакции (`computeUnitsConsumed`) — EVM `gasUsed` не является точным заменителем CU Solana. Оптимизируйте горячие пути с помощью Yul.

## Что дальше

* [Бюджет вычислений](https://docs.rome.builders/ru/klyuchevye-ponyatiya/compute-budget.md) — подробные затраты CU на операцию
* [Интероперабельность токенов](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md) — модель мостирования ERC-20 ↔ SPL
* [Справочник пре-компиляций](https://docs.rome.builders/ru/spravochnik/precompiles.md) — каждый селектор и его класс диспетчеризации


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
