> 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/nachalo-raboty-1/architecture.md).

# Архитектура

Как компоненты Rome работают вместе — выполнение EVM внутри программы Solana.

Rome встраивает интерпретатор байткода EVM внутрь on-chain-программы Solana. В ветке EVM-ключа пользователи отправляют подписанные транзакции EVM в Rome Proxy через стандартный Ethereum JSON-RPC. Прокси передает их в программу Rome EVM в Solana. Для одной транзакции EVM может потребоваться несколько транзакций Solana, чтобы записать фрагменты в holder-аккаунты или выполнить итеративное исполнение. В ветке Solana-ключа v1 прокси формирует транзакцию. Кошелек Solana подписывает ее и отправляет напрямую в Solana RPC. Отдельного уровня исполнения, который нужно синхронизировать, нет — состояние EVM *равен* Состояние Solana.

## Обзор системы

<figure><img src="https://1351373662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-4d7d386c95b500079204f3dea2103d9759c5de8f%2Farchitecture.svg?alt=media" alt="EVM wallet and Solana wallet connected to Rome Proxy with its emulator. The Solana cluster holds the Rome EVM program, per-chain state, external-authority PDA, token accounts, Solana programs and holder accounts. Hercules feeds blocks, receipts and logs back to the proxy."><figcaption></figcaption></figure>

## Компоненты

### Программа Rome EVM (on-chain)

Ядро Rome — программа Solana BPF, содержащая полноценный интерпретатор байткода EVM (форк SputnikVM). Она:

* Принимает подписанные транзакции EVM и неподписанные тела EIP-1559 в виде инструкций Solana. Ключ Solana авторизует неподписанное тело через подпись плательщика комиссии Solana или через инструкцию проверки Ed25519
* Выполняет байткод Solidity внутри среды выполнения Solana
* Отображает каждый адрес Ethereum (H160) на balance PDA для каждой сети, содержащую его nonce, нативный баланс и код. Отдельные storage PDA связаны с balance PDA. Каждый адрес также имеет адрес, порожденный программой, для полномочий над вызовами Solana, называемый его **PDA внешнего авторитета**. Эта PDA общая для каждой сети в программе. Она владеет SPL-аккаунтами токенов адреса и подписывает его межпрограммные вызовы (CPI)
* Раскрывает предкомпилы для вызова в Solana (CPI, System, Helper, Withdraw) наряду с Ethereum precompiles. Кэшированное семейство добавляет SystemCached (`0xff…04`), SplCached (`0xff…05`), ASplCached (`0xff…06`) и WithdrawCached (`0xff…0b`). Фабрика разворачивает обертки на этом кэшированном пути
* Хранит состояние EVM (балансы, nonce, код, storage) как данные аккаунта Solana
* Одна программа Rome EVM обслуживает множество chain ID. Chain ID является частью адресов balance и storage PDA, а не внешней-authority PDA

### Rome Proxy (сервер JSON-RPC)

Rome Proxy — стандартный Ethereum JSON-RPC сервер. Пользователи подключаются к `https://hadrian.testnet.romeprotocol.xyz/` для Hadrian (testnet) и `https://rubicon.mainnet.romeprotocol.xyz/` для Rubicon (mainnet). Он преобразует вызовы Ethereum API в действия Solana:

* `eth_sendRawTransaction` → отправить одну или несколько транзакций Solana v1: атомарные `DoTx`, фрагменты holder (`инструкции TransmitTx`) плюс `DoTxHolder`или итеративные ветви. Пуловый плательщик подписывает и оплачивает SOL. Пуловый получатель комиссии собирает газ пользователя
* `eth_call` → нативно запускать интерпретатор EVM в эмуляторе на живых аккаунтах Solana, читаемых через RPC. Mollusk запускает программы Solana, достижимые через CPI. Он также запускает программу Rome EVM, когда прокси измеряет вычислительные единицы
* `eth_estimateGas` → симулировать для оценки газа. Одна единица газа — это один lamport стоимости Solana. Оценка никогда не бывает ниже 21 000
* `eth_getBalance`, `eth_getCode`, `eth_getTransactionCount`, `eth_getStorageAt` → читать живые аккаунты Solana через эмулятор. `eth_getBlockByNumber`, receipts и logs поступают из Hercules

Также он раскрывает расширения Rome: `rome_emulateTx`, `rome_emulateRegRollup`, `rome_mintId`, `rome_buildInfo` и `rome_getResources`Методы Solana-wallet включают `rome_emulateCallAccounts`, `rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1`, `rome_submitSignedV1Plan`, `rome_relayUnsignedV1`, `rome_composeExternalDepositV1` и `rome_sendUnsignedTransaction`Также прокси раскрывает `rome_solanaTxForEvmTx`.

### Hercules (индексатор)

Hercules отслеживает программу Rome EVM в Solana и реконструирует совместимые с Ethereum блоки в PostgreSQL. Они содержат транзакции, receipts, logs и изменения состояния. В публичных сетях он работает в режиме выравнивания по слотам, поэтому номер блока соответствует слоту Solana, и тот же слот дает тот же блок на любом индексаторе. Прокси обслуживает эти блоки кошелькам и обозревателям.

Hercules индексирует подтвержденные блоки. Он повторно проверяет каждый блок после финализации и перезагружает его, если blockhash изменился. Этот [Через обозреватель](https://docs.rome.builders/ru/prilozheniya-v-rome/via.md) считывает данные Hercules.

### Предкомпиляции

Rome реализует ecrecover, SHA-256, RIPEMD-160, identity, операции кривой BN254 и blake2f с семантикой Ethereum, за исключением данных сбоя для BN254 и blake2f. Неудачный вызов BN254 или blake2f возвращает данные отката Rome `Error(string)` вместо пустого буфера. Modexp (`0x05`) отключен и завершает выполнение с ошибкой `"big_mod_exp call is disabled"`. blake2f отклоняет более 1 000 000 раундов, хотя Ethereum это допускает.

Непредкомпилы, не относящиеся к EVM, обращаются в Solana: **CpiProgram** (`0xFF…08`, произвольный CPI), **Система** (`0xFF…07`, деривация PDA и вспомогательные функции base58), **HelperProgram** (`0xFF…09`, создание ATA/PDA, переводы SPL, gas↔lamports), и **Вывод** (`0x42…16`). Кэшированное семейство — это **SystemCached** (`0xff…04`), **SplCached** (`0xff…05`), **ASplCached** (`0xff…06`) и **WithdrawCached** (`0xff…0b`). Устаревший CPI выполняется немедленно и только в атомарных транзакциях. Кэшированные CPI регистрируются во время исполнения и отправляются при фиксации. Они откатываются вместе с EVM. Их можно выполнять в итеративных транзакциях. См. [справочнике Contract Addresses](https://docs.rome.builders/ru/spravochnik/contract-addresses.md) справочник для полной таблицы.

## Режимы исполнения

Rome выполняет транзакцию EVM одним из двух способов:

### Атомарный (VmAt)

Одна транзакция Solana. Вся транзакция EVM выполняется в пределах вычислительного бюджета одной транзакции Solana (\~1,4 млн вычислительных единиц). Используется для большинства операций — переводов, обычных вызовов контрактов, свопов.

### Итеративный (VmIt)

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

1. Каждый шаг (транзакция Solana) выполняет столько opcodes EVM, сколько помещается в его вычислительный бюджет — размер шага адаптивный, а не фиксированный
2. Состояние VM сериализуется с помощью Borsh в `StateHolder` аккаунт между шагами
3. Аккаунты блокируются по TTL на несколько секунд во время исполнения

Прокси переходит к итеративному исполнению, когда вычислительные единицы, heap или число инструкций не помещаются в одну транзакцию Solana. Сессия ограничена 160 итерациями. CPI на legacy-треке отклоняется в итеративной транзакции, поскольку его нельзя разделить на этапы. CPI на cached-треке разрешены.

## Маппинг аккаунтов

Каждый адрес Ethereum детерминированно отображается на balance PDA Solana, производную от chain ID и адреса в рамках программы Rome EVM. Его нативный газовый баланс является полем в этой PDA наряду с nonce и кодом контракта. Слоты хранения находятся в отдельных storage PDA. Балансы SPL находятся в токен-аккаунтах, принадлежащих отдельной external-authority PDA. Эта authority общая для каждой сети на одной и той же программе.

## Два способа входа

* **Ветка EVM-ключа:** кошелек отправляет в Rome Proxy подписанную secp256k1 транзакцию EVM. Прокси отправляет транзакции Solana.
* **Ветка Solana-ключа:** кошелек авторизует неподписанное тело EIP-1559 своим ключом Solana. Для прямого маршрута v1 прокси формирует транзакцию Solana. Кошелек подписывает ее и отправляет напрямую в Solana RPC. Маршрут relay использует вместо этого прокси для отправки. Более старый legacy-маршрут требует, чтобы кошелек сформировал, подписал и оплатил `DoTxUnsigned` транзакцию Solana, а программа выводит отправителя из подписи Solana.

Публичный ключ Solana отображается в синтетический адрес `keccak256(pubkey)[12:]`, последние 20 байт хэша. См. [Как Solana и EVM встречаются в Rome](https://docs.rome.builders/ru/klyuchevye-ponyatiya/how-solana-and-evm-meet.md).

## Кто подписывает вызов в Solana

Программа Rome EVM подписывает CPI внешней PDA непосредственного вызывающего precompile. Контракт подписывает от своего имени. Чтобы расходовать SPL-токены пользователя, контракту нужна SPL-delegation от этого пользователя. Пользователь предоставляет ее с помощью `HelperProgram.approve_spl(spender, amount, mint)`. Прямой вызов от EVM-адреса пользователя или синтетического адреса к precompile использует external-authority PDA пользователя.

## Аккаунты-холдеры

Транзакции Solana (v1) ограничены 4 КБ, но транзакции EVM (особенно развертывания контрактов) могут быть значительно больше. Rome разбивает крупные транзакции на фрагменты по 3 600 байт и последовательно записывает их в **аккаунты-холдеры** (до 80 КБ). Затем он собирает каждую транзакцию и выполняет ее on-chain. Rome SDK управляет этим прозрачно. Комиссия за подпись каждого фрагмента списывается из газа отправителя.

## Gas и ценообразование

У каждой сети есть свой газовый токен: SOL или SPL-токен. Источник цены — Hermes API, пул Meteora DAMM v1, пул Meteora DAMM v2 или фиксированная цена. Он обеспечивает конвертацию между газовым токеном и SOL для базовых комиссий транзакций Solana.

* Одна единица газа — это один lamport стоимости Solana
* `eth_gasPrice` это wei газового токена на lamport
* Отправитель оплачивает комиссии получателю комиссии из своего нативного газового баланса. Плательщик прокси оплачивает SOL
* При отсутствии получателя комиссии, как в атомарной ветке кошелька Solana, EVM-газ не взимается. Кошелек оплачивает SOL напрямую
* Нативный баланс имеет 18 десятичных знаков. Он обеспечен SPL газового токена, хранящимся в программном кошельке на уровне сети

## Финализация

Rome использует финализацию Solana. SDK ждет `подтвержденного`. Hercules повторно проверяет каждый индексированный блок при `финализированный` и перезагружает его, если blockhash изменился.

## Что дальше

* [Сети](https://docs.rome.builders/ru/seti/networks.md) — подключение к Hadrian (testnet) и Rubicon (mainnet)
* [Быстрый старт](https://docs.rome.builders/ru/nachalo-raboty-1/quickstart.md) — разверните свой первый контракт
* [Модель выполнения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/execution-model.md) — атомарное и итеративное исполнение в деталях
* [Интероперабельность токенов](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md)
* [Ограничения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.md)
* [Вызов Solana из EVM](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md)
* [Вызов EVM из Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md)
* [Справочник пре-компиляций](https://docs.rome.builders/ru/spravochnik/precompiles.md)
* [Как Solana и EVM встречаются в Rome](https://docs.rome.builders/ru/klyuchevye-ponyatiya/how-solana-and-evm-meet.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/nachalo-raboty-1/architecture.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.
