> 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/execution-model.md).

# Модель исполнения

Как Rome EVM обрабатывает транзакции Ethereum в Solana — эмуляция через proxy, атомарный (VmAt) и итеративный (VmIt) режимы, а также полный жизненный цикл транзакции.

Rome EVM выполняет байт-код Solidity внутри on-chain программы Solana. На этой странице объясняется, как обрабатываются транзакции EVM.

## Жизненный цикл транзакции

```
1. Пользователь подписывает транзакцию EVM (MetaMask / ethers.js)
                    ↓
2. Rome Proxy получает через eth_sendRawTransaction
                    ↓
3. Proxy эмулирует транзакцию вне цепочки (эмулятор Mollusk SVM)
   → Оценивает газ, проверяет атомарность, определяет необходимые аккаунты
                    ↓
4. Proxy упаковывает EVM-транзакцию как инструкции Solana
   → Если tx помещается в одну Solana-транзакцию → Атомарная (VmAt)
   → Если tx превышает бюджет CU → Итеративная (VmIt)
                    ↓
5. Валидатор Solana выполняет инструкцию(и)
   → Программа Rome EVM интерпретирует байт-код EVM
   → Вызовы CPI к другим программам Solana (если есть)
                    ↓
6. Изменения состояния фиксируются в аккаунтах Solana
                    ↓
7. Hercules индексирует событие → формирует блок EVM
```

## Атомарное выполнение (VmAt)

Режим по умолчанию. Вся транзакция EVM выполняется в пределах одной транзакции Solana.

**Состояние-машина:** `Lock → Init → Execute → Commit → GasTransfer → Exit`

**Свойства:**

* Выполнение по принципу «всё или ничего» — если какой-либо шаг завершается неудачей, вся транзакция откатывается
* Доступно \~1,4 млн вычислительных единиц на одну транзакцию Solana
* Подходит для переводов, простых вызовов контрактов, свопов, большинства операций DeFi
* Финализация менее чем за секунду (время блока Solana)

**Когда используется:** Автоматически выбирается, когда эмулятор определяет, что транзакция укладывается в вычислительный бюджет одной транзакции Solana.

## Итеративное выполнение (VmIt)

Для вычислительно интенсивных операций, которые превышают бюджет одной транзакции. Выполнение EVM разделяется на несколько транзакций Solana.

**Как это работает:**

1. Каждый шаг (транзакция Solana) выполняет **столько EVM-операций, сколько помещается в его вычислительный бюджет** — адаптивный размер шага, а не фиксированное количество
2. После каждого шага состояние VM сериализуется (формат Borsh) в `StateHolder` аккаунт
3. Следующий шаг десериализует состояние и продолжает выполнение
4. Задействованные аккаунты блокируются по TTL на **3–4 секунды** во время многошагового выполнения; сессия ограничена **160 шагов**; после этого следующий шаг снимает блокировки сессии и завершает её без фиксации каких-либо изменений

**Состояние-машина:** `FromStateHolder → Lock → Init → Execute → Serialize → NextIteration → ... → Completed`

**Блокировка аккаунтов:**

* Одна **эксклюзивная блокировка** на каждый управляемый аккаунт (аккаунты баланса и хранилища) — только одна итеративная сессия может удерживать аккаунт в любой момент; атомарная транзакция, которая пытается записать в заблокированный аккаунт, отклоняется с `AccountLocked` до истечения блокировки, после чего клиент отправляет запрос повторно
* **TTL:** 3 секунды, обновляется на каждом шаге (4 секунды, когда сессия затрагивает более 28 аккаунтов)
* **Legacy-track CPI отклоняются** внутри итеративной транзакции (`CpiProhibitedInIterativeTx`); эффекты cached-track накапливаются и фиксируются в конце

**Когда используется:** крупные развёртывания контрактов, глубокие стеки вызовов, любая операция, превышающая \~1,4 млн CU. Проверке сопряжения BN254 это само по себе не требуется; см. [Бюджет вычислений](https://docs.rome.builders/ru/klyuchevye-ponyatiya/compute-budget.md).

## Эмуляция

Перед отправкой транзакции в Solana Proxy эмулирует её вне цепочки с помощью **эмулятора Mollusk SVM**. Это:

1. Оценивает потребление газа
2. Определяет, нужен ли атомарный или итеративный режим
3. Определяет все аккаунты Solana, которых коснётся транзакция
4. Проверяет, что транзакция не завершится ошибкой on-chain

Эмулятор выполняет ту же логику EVM, что и on-chain программа — макрос `entrypoint!` обеспечивает идентичные таблицы диспетчеризации в кодовых базах программы и эмулятора.

**Mollusk SVM** также может выполнять произвольные программы Solana BPF во время эмуляции, что означает `eth_call` и `eth_estimateGas` корректную обработку CPI-вызовов к SPL Token, Jupiter, Kamino и т. д.

## Сопоставление аккаунтов

Каждый адрес Ethereum сопоставляется с PDA Solana:

```
Адрес Ethereum (H160, 20 байт)
    ↓
PDA = findProgramAddress(
    [chain_id, "ACCOUN_SEED", H160, bump],
    ROME_EVM_PROGRAM_ID
)
    ↓
Аккаунт Solana (Pubkey, 32 байта)
```

**Типы аккаунтов, хранимые on-chain:**

| Тип         | Сиды                                         | Назначение                                     |
| ----------- | -------------------------------------------- | ---------------------------------------------- |
| Баланс      | `[chain, "ACCOUN_SEED", H160, bump]`         | Nonce, баланс, код контракта                   |
| Хранилище   | `[chain, "STORAGE", H160, slot_index, bump]` | Хранилище контракта (256 слотов на аккаунт)    |
| TxHolder    | `[signer, "TX_HOLDER_SEED", index, bump]`    | Подготовленные данные транзакции (макс. 80 КБ) |
| StateHolder | `[signer, "STATE_HOLDER_SEED", index, bump]` | Сериализованное состояние VM между итерациями  |

## Аккаунты-хранилища

Rome отправляет транзакции Solana **v1**, которые ограничены 4 КБ (4 096 байт) и 64 адресами. Транзакции EVM — особенно развёртывания контрактов — могут быть значительно больше.

**Механизм разделения:**

1. SDK разбивает RLP-кодированную транзакцию на части
2. Каждая часть записывается в `TxHolder` аккаунт через `инструкции TransmitTx` инструкции
3. После подготовки всех частей выполняется инструкция `DoTxHolder` которая собирает и выполняет всю транзакцию
4. Максимальный размер хранилища: **80 КБ** на один TxHolder

Для разработчика это полностью прозрачно — Rome SDK автоматически обрабатывает разбиение и повторную сборку.

## Поддерживаемые типы транзакций

| Тип                   | EIP      | Описание                                                                                                                                                                                                                                                     |
| --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Наследуемый           | —        | Традиционные транзакции Ethereum                                                                                                                                                                                                                             |
| Список доступа        | EIP-2930 | Оптимизированные шаблоны доступа к состоянию                                                                                                                                                                                                                 |
| Динамическая комиссия | EIP-1559 | Базовая комиссия + приоритетная комиссия                                                                                                                                                                                                                     |
| EIP-1559 без подписи  | —        | Приложение `0x02`-типизированное тело без подписи secp256k1, авторизованное вместо этого подписью Ed25519 кошелька Solana (маршрут Solana; см. [Вызов EVM из Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md)) |
| Депозит               | Тип 0x7E | Депозитные транзакции, например входящее урегулирование через мост                                                                                                                                                                                           |

## Журналируемое состояние

Rome EVM использует модель журналируемого состояния для управления изменениями состояния во время выполнения:

* Все изменения (nonce, баланс, хранилище, код) отслеживаются в `журнале`
* Вложенные операции CALL/CREATE добавляют фреймы снимков
* При откате: записи журнала откатываются к снимку
* При успехе: изменения фиксируются в аккаунтах Solana
* Инструкции non-EVM CPI выполняются немедленно (собственные гарантии атомарности Solana обеспечивают корректность)

## Что дальше

* [Бюджет вычислений](https://docs.rome.builders/ru/klyuchevye-ponyatiya/compute-budget.md) — стоимость CU и стратегии оптимизации
* [Ограничения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.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/execution-model.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.
