> 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/key-concepts.md).

# Ключевые понятия

Основная терминология Solana и Rome EVM для разработчиков — программы, аккаунты, PDA, CPI, SPL-токены и атомарное vs. итеративное выполнение.

Основная терминология и концепции для разработки на Rome Protocol.

## Концепции Solana

**Программа** — Аналог смарт-контракта в Solana. Программы — это исполняемые файлы без состояния, развернутые в блокчейне. Сам Rome EVM является программой Solana.

**Аккаунт** — Всё состояние в Solana хранится в аккаунтах. У каждого аккаунта есть владелец (программа), баланс (лампорты) и данные. В отличие от Ethereum, код и состояние хранятся в отдельных аккаунтах.

**PDA (адрес, производный от программы)** — Детерминированный адрес, получаемый из seed-значений и идентификатора программы. PDA позволяют программам «владеть» аккаунтами без закрытого ключа. Rome использует PDA для сопоставления Ethereum-адресов с аккаунтами Solana.

**CPI (вызов между программами)** — Одна программа Solana вызывает другую в рамках одной и той же транзакции. Именно так контракты Rome EVM взаимодействуют с Jupiter, Kamino, SPL Token и другими программами Solana.

**SPL Token** — Стандартная токен-программа Solana. Аналог ERC-20 в Ethereum. Все взаимозаменяемые токены в Solana (USDC, SOL и т. д.) — это SPL-токены.

**Token-2022** — Токен-программа SPL нового поколения с расширениями, такими как Transfer Hooks, Confidential Transfers и Permanent Delegates.

**Transfer Hook** — Расширение Token-2022, которое вызывает программу при каждом `transfer_checked` вызове.

**ATA (Associated Token Account)** — Детерминированный токен-аккаунт для заданной пары кошелёк + mint. У каждого пользователя есть один ATA на каждый токен, которым он владеет.

**Лампорты** — Наименьшая единица SOL. 1 SOL = 1 000 000 000 лампортов (10^9).

**Единицы вычислений (CU)** — Аналог газа в Ethereum в Solana. У каждой транзакции есть бюджет вычислений (по умолчанию \~200 тыс. CU, максимум \~1,4 млн CU). Операции расходуют CU.

## Концепции Rome

**Программа Rome EVM** — Программа Solana, содержащая интерпретатор байткода EVM. Развертывается с определённым program ID для каждой среды.

**Идентификатор цепи** — Каждое приложение в Rome получает собственный EVM chain ID. Это создаёт изолированные среды EVM, которые разделяют одно и то же базовое состояние Solana.

**Атомарное выполнение (VmAt)** — Транзакция EVM, выполняемая целиком в рамках одной транзакции Solana. Используется для большинства операций.

**Итеративное выполнение (VmIt)** — Транзакция EVM, разбитая на несколько транзакций Solana; на каждом шаге упаковывается столько opcode, сколько помещается в бюджет вычислений одной транзакции Solana (адаптивно, а не фиксированным количеством). Используется для ресурсоёмких операций, таких как BN254 pairing.

**Аккаунт-держатель** — Буфер в блокчейне, который хранит большие транзакции EVM (до 80 КБ), превышающие лимит размера транзакции Solana (v1) в 4 КБ. Управляется SDK прозрачно.

**StateHolder** — Аккаунт в блокчейне, который хранит сериализованное состояние VM между итеративными шагами выполнения.

**Прокси Rome** — Сервер JSON-RPC (порт 9090), который преобразует вызовы Ethereum API в транзакции Solana. Именно сюда подключаются MetaMask и Hardhat.

**Hercules** — Блочный индексатор, который отслеживает события Rome EVM в Solana и формирует данные блоков, совместимые с Ethereum.

**Плательщик** — Пара ключей Solana, которая подписывает и оплачивает транзакции Solana от имени пользователей EVM. Управляется Proxy через пулы плательщиков.

## Концепции токенов

**SPL\_ERC20 / SPL\_ERC20\_cached** — Контракты-обёртки ERC-20, представляющие SPL-токен внутри Rome EVM. Для кошелька обёртка считывает баланс напрямую из базового аккаунта SPL-токена. Токены, удерживаемые контрактом, находятся на собственном эскроу-аккаунте токенов обёртки и отслеживаются в её хранилище (см. [Интеграция программы Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/integrate-solana-program.md)). Сегодня фабрика развёртывает кешированную версию.

**ERC20SPLFactory** — Контракт-фабрика, который развёртывает обёртки для любого SPL-токена.

**Реестр** — Канонические обёртки, газовые токены и настройки мостов курируются вне цепочки в [rome-protocol/registry](https://github.com/rome-protocol/rome-registry); on-chain контракта реестра токенов не существует. Это позволяет сопоставлять каждый актив с единственным каноническим SPL mint.

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

**Стандартные предкомпилированные контракты Ethereum** — ecrecover (0x01), SHA-256 (0x02), RIPEMD-160 (0x03), identity (0x04), modexp (0x05), BN254 ecAdd/ecMul/ecPairing (0x06–0x08), Blake2f (0x09).

**Системный предкомпилированный контракт** (`0xFF...07`) — Вычисление PDA и преобразование base58 из Solidity.

**Предкомпилированный контракт CpiProgram** (`0xFF...08`) — Вызов между программами (`invoke` / `invoke_signed`) плюс сокращения для чтения межсостояния.

**Предкомпилированный контракт HelperProgram** (`0xFF...09`) — Создание ATA/PDA, переводы SPL и конвертация gas↔lamports; основной интерфейс для SPL-операций, подписываемых пользовательским PDA.

**Предкомпилированный контракт Withdraw** (`0x42...16`) — Вывод SOL или SPL-токенов из EVM обратно в Solana.

Семейство cached-track (`0xff…04/05/06/0b`) отражает их для эффективного по CU чтения; контракт последовательно использует один track.

## Типы транзакций

Rust SDK формирует три вида транзакций. Rome проводит расчёт каждой из них в Solana.

**Одна транзакция EVM (`RheaTx`)** — Одна транзакция EVM в одной цепочке Rome. Самый распространённый тип.

**Несколько транзакций EVM (`RemusTx`)** — Транзакции EVM в разных цепочках Rome, выполняемые вместе в одной транзакции Solana. Если хотя бы одна завершится ошибкой, все будут отменены.

**Транзакции EVM плюс инструкции Solana (`RomulusTx`)** — Транзакции EVM и нативные инструкции Solana в одной атомарной транзакции Solana, так что Solidity и программы Solana выполняются либо вместе, либо никак.

## Что дальше

* [Модель выполнения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/execution-model.md) — подробный разбор того, как транзакции EVM выполняются в Solana
* [Интероперабельность токенов](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md) — как взаимодействуют ERC-20 и SPL-токены
* [Ограничения](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/nachalo-raboty-1/key-concepts.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.
