> 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/ja/ji-ben-gai-nian/execution-model.md).

# 実行モデル

Rome EVMがSolana上でEthereumトランザクションを処理する方法 — プロキシエミュレーション、アトミック（VmAt）モードとイテレーティブ（VmIt）モード、そして完全なトランザクションライフサイクル。

Rome EVM は、Solana のオンチェーンプログラム内で Solidity バイトコードを実行します。このページでは、EVM トランザクションがどのように処理されるかを説明します。

## トランザクションのライフサイクル

```
1. ユーザーが EVM トランザクションに署名する（MetaMask / ethers.js）
                    ↓
2. Rome Proxy が eth_sendRawTransaction 経由で受信する
                    ↓
3. Proxy がトランザクションをオフチェーンでエミュレートする（Mollusk SVM エミュレーター）
   → ガスを見積もり、原子性を確認し、必要なアカウントを特定する
                    ↓
4. Proxy が EVM tx を Solana の命令としてラップする
   → tx が 1 つの Solana tx に収まる場合 → Atomic（VmAt）
   → tx が CU 予算を超える場合 → Iterative（VmIt）
                    ↓
5. Solana バリデータが命令を実行する
   → Rome EVM プログラムが EVM バイトコードを解釈する
   → 他の Solana プログラムへの CPI 呼び出し（ある場合）
                    ↓
6. 状態変更が Solana アカウントにコミットされる
                    ↓
7. Hercules がイベントをインデックス化する → EVM ブロックを生成する
```

## Atomic Execution（VmAt）

デフォルトのモードです。EVM トランザクション全体が 1 つの Solana トランザクション内で実行されます。

**状態マシン：** `Lock → Init → Execute → Commit → GasTransfer → Exit`

**特性：**

* すべてまたは無での実行 — どれか 1 つのステップでも失敗すると、トランザクション全体がロールバックされます
* Solana トランザクションあたり約 1.4M のコンピュートユニットが利用可能
* 送金、簡単なコントラクト呼び出し、スワップ、ほとんどの DeFi 操作に適しています
* サブ秒のファイナリティ（Solana のブロック時間）

**使用される場合：** エミュレーターが、トランザクションが 1 つの Solana トランザクションのコンピュート予算内に収まると判断したときに自動的に選択されます。

## Iterative Execution（VmIt）

1 つのトランザクションの予算を超える計算集約的な操作向けです。EVM 実行は複数の Solana トランザクションに分割されます。

**仕組み：**

1. 各ステップ（1 つの Solana トランザクション）が実行され、 **そのコンピュート予算に収まるだけの EVM オペコードを** — 固定回数ではなく、適応的なステップサイズです
2. 各ステップの後、VM 状態は Borsh 形式で `StateHolder` アカウントに
3. 次のステップが状態をデシリアライズして実行を継続します
4. 関与するアカウントは TTL によりロックされ、 **3〜4 秒** にわたってマルチステップ実行中は保持されます。セッションの上限は **160 ステップ**; それを過ぎると、次のステップがセッションのロックを解除し、何もコミットせずに終了します

**状態マシン：** `FromStateHolder → Lock → Init → Execute → Serialize → NextIteration → ... → Completed`

**アカウントロック：**

* 1 つの **排他的ロック** が管理対象アカウント（残高アカウントとストレージアカウント）ごとに適用されます — 1 つの反復セッションだけが一度に 1 つのアカウントを保持できます。ロックされたアカウントに書き込む Atomic トランザクションは、 `AccountLocked` ロックが失効するまで拒否され、クライアントは再送します
* **TTL：** 3 秒、各ステップごとに更新（セッションが 28 個を超えるアカウントに触れる場合は 4 秒）
* **Legacy-track の CPI は拒否されます** 反復トランザクション内では（`CpiProhibitedInIterativeTx`）；cached-track の効果はステージングされ、最後にコミットされます

**使用される場合：** 大規模なコントラクト展開、深いコールスタック、約 1.4M CU を超えるあらゆる操作。BN254 のペアリングチェック単体では不要です。参照： [計算予算](https://docs.rome.builders/ja/ji-ben-gai-nian/compute-budget.md).

## エミュレーション

トランザクションを Solana に送信する前に、Proxy は **Mollusk SVM エミュレーター**を使ってオフチェーンでエミュレートします。これにより：

1. ガス消費量を見積もる
2. Atomic モードか Iterative モードかを判定する
3. トランザクションが触れるすべての Solana アカウントを特定する
4. トランザクションがオンチェーンで失敗しないことを検証する

エミュレーターはオンチェーンプログラムと同じ EVM ロジックを実行します。 `entrypoint!` マクロにより、プログラムコードベースとエミュレーターコードベースの両方で同一のディスパッチテーブルが保証されます。

**Mollusk SVM** はエミュレーション中に任意の Solana BPF プログラムも実行できるため、 `eth_call` および `eth_estimateGas` SPL Token、Jupiter、Kamino などへの CPI 呼び出しを正しく処理できます。

## アカウントマッピング

すべての Ethereum アドレスは Solana の PDA にマッピングされます：

```
Ethereum アドレス（H160、20 バイト）
    ↓
PDA = findProgramAddress(
    [chain_id, "ACCOUN_SEED", H160, bump],
    ROME_EVM_PROGRAM_ID
)
    ↓
Solana アカウント（Pubkey、32 バイト）
```

**オンチェーンに保存されるアカウント型：**

| 型           | Seeds                                        | 目的                                |
| ----------- | -------------------------------------------- | --------------------------------- |
| Balance     | `[chain, "ACCOUN_SEED", H160, bump]`         | Nonce、残高、コントラクトコード                |
| Storage     | `[chain, "STORAGE", H160, slot_index, bump]` | コントラクトのストレージ（1 アカウントあたり 256 スロット） |
| TxHolder    | `[signer, "TX_HOLDER_SEED", index, bump]`    | ステージングされたトランザクションデータ（最大 80 KB）    |
| StateHolder | `[signer, "STATE_HOLDER_SEED", index, bump]` | 反復間の VM 状態のシリアライズ済みデータ            |

## Holder アカウント

Rome は Solana の **v1 トランザクション**を送信します。これは 4 KB（4,096 バイト）と 64 アドレスに制限されています。EVM トランザクション、特にコントラクト展開は、はるかに大きくなることがあります。

**分割機構：**

1. SDK は RLP エンコードされたトランザクションをチャンクに分割します
2. 各チャンクは `TxHolder` アカウントに書き込まれ、 `TransmitTx` 命令を介して送られます
3. すべてのチャンクがステージングされると、 `DoTxHolder` 命令が完全なトランザクションを組み立てて実行します
4. 最大 holder サイズ： **80 KB** TxHolder ごとに

これは開発者にとって完全に透過的です。Rome SDK が分割と再構成を自動的に処理します。

## サポートされるトランザクション型

| 型             | EIP       | 説明                                                                                                                                                                        |
| ------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Legacy        | —         | 従来の Ethereum トランザクション                                                                                                                                                     |
| アクセスリスト       | EIP-2930  | 最適化された状態アクセスパターン                                                                                                                                                          |
| ダイナミックフィー     | EIP-1559  | ベースフィー + 優先手数料                                                                                                                                                            |
| 署名なし EIP-1559 | —         | ある `0x02`secp256k1 署名のない型付きボディで、代わりに Solana ウォレットの Ed25519 署名によって認可されます（Solana レーン；参照 [Solana から EVM を呼び出す](https://docs.rome.builders/ja/gaido/call-evm-from-solana.md)) |
| 入金            | Type 0x7E | 入金トランザクション、例：ブリッジの inbound セトルメント                                                                                                                                         |

## Journaled State

Rome EVM は、実行中の状態変化を管理するために journaled state モデルを使用します：

* すべての変更（nonce、残高、ストレージ、コード）は、 `Journal`
* ネストされた CALL/CREATE 操作はスナップショットフレームを積みます
* revert 時：journal エントリはスナップショットへ巻き戻されます
* 成功時：変更は Solana アカウントにコミットされます
* EVM 以外の CPI 命令は即座に実行されます（Solana 自身の原子性保証により正しさが保たれます）

## 次は何か

* [計算予算](https://docs.rome.builders/ja/ji-ben-gai-nian/compute-budget.md) — CU コストと最適化戦略
* [制約](https://docs.rome.builders/ja/ji-ben-gai-nian/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/ja/ji-ben-gai-nian/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.
