For the complete documentation index, see llms.txt. This page is also available as Markdown.

Архитектура

Как компоненты 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.

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

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.

Компоненты

Программа 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 изменился. Этот Через обозреватель считывает данные 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 справочник для полной таблицы.

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

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.

Кто подписывает вызов в 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 изменился.

Что дальше

Последнее обновление

Это было полезно?