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

# アーキテクチャ

Romeの各コンポーネントがどう噛み合うか — Solanaプログラム内でのEVM実行。

Romeは、EVMバイトコードインタプリタをSolana上のオンチェーンプログラム内に埋め込んでいます。EVMキー経路では、ユーザーは標準のEthereum JSON-RPCを介して署名済みのEVMトランザクションをRome Proxyに送信します。プロキシはそれをSolana上のRome EVMプログラムに送ります。1つのEVMトランザクションで、チャンクを書き込むために複数のSolanaトランザクションが必要になったり、反復実行を行ったりする場合があります。v1のSolanaキー経路では、プロキシがトランザクションを組み立てます。Solanaウォレットがそれに署名し、Solana RPCに直接送信します。同期を保つための別の実行レイヤーはありません — EVM状態 *が* Solana状態。

## システム概要

<figure><img src="https://3990464069-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プログラム（オンチェーン）

Romeの中核。完全なEVMバイトコードインタプリタ（SputnikVMのフォーク）を含むSolana BPFプログラムです。次のことを行います:

* 署名済みのEVMトランザクションと、未署名のEIP-1559ボディをSolanaインストラクションとして受け取ります。Solanaキーは、Solanaのfee payerの署名またはEd25519検証インストラクションを通じて、未署名ボディを認可します
* SolidityバイトコードをSolanaランタイム内で実行します
* 各Ethereumアドレス（H160）を、nonce、ネイティブ残高、コードを含むチェーンごとのbalance PDAにマップします。別個のstorage PDAがbalance PDAに関連付けられます。各アドレスには、Solanaコールに対する権限を持つprogram-derived addressもあり、これを **外部権限 PDA**と呼びます。このPDAは、このプログラム上のすべてのチェーンで共有されます。これはそのアドレスのSPLトークンアカウントを所有し、クロスプログラム呼び出し（CPI）に署名します
* Ethereumのprecompileに加えて、Solanaへの呼び出し用のprecompile（CPI、System、Helper、Withdraw）を公開します。cachedファミリーではSystemCached（`0xff…04`）、SplCached（`0xff…05`）、ASplCached（`0xff…06`）およびWithdrawCached（`0xff…0b`）が追加されます。factoryはこのcached経路上にラッパーをデプロイします
* EVM状態（残高、nonce、コード、ストレージ）をSolanaアカウントデータとして保存します
* 1つのRome EVMプログラムが複数のchain IDをホストします。chain IDは、外部権限PDAではなく、balance PDAとstorage 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` → 1つ以上のSolana v1トランザクションとして送信: 原子的 `DoTx`、ホルダーチャンク（`TransmitTx`）に加えて `DoTxHolder`、または反復レッグ。プールされたpayerが署名し、SOLを支払います。プールされたfee recipientがユーザーのガス
* `eth_call` → RPC経由で読み取ったライブのSolanaアカウント上で、エミュレータ内でEVMインタプリタをネイティブに実行します。Molluskは、CPIで到達したSolanaプログラムを実行します。また、プロキシがcompute unitsを計測するときにはRome EVMプログラムも実行します
* `eth_estimateGas` → ガス見積もりのためにシミュレートします。1ガスユニットはSolanaコストの1 lamportです。見積もりは21,000を下回ることはありません
* `eth_getBalance`, `eth_getCode`, `eth_getTransactionCount`, `eth_getStorageAt` → エミュレータを通じてライブのSolanaアカウントを読み取ります。 `eth_getBlockByNumber`、receiptとログはHerculesから取得されます

また、Rome拡張も公開します: `rome_emulateTx`, `rome_emulateRegRollup`, `rome_mintId`, `rome_buildInfo` および `rome_getResources`。Solanaウォレットのメソッドには `rome_emulateCallAccounts`, `rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1`, `rome_submitSignedV1Plan`, `rome_relayUnsignedV1`, `rome_composeExternalDepositV1` および `rome_sendUnsignedTransaction`。プロキシはさらに `rome_solanaTxForEvmTx`.

### Hercules（インデクサー）

HerculesはSolana上のRome EVMプログラムを監視し、Ethereum互換ブロックをPostgreSQLに再構築します。これにはトランザクション、receipt、ログ、状態変化が含まれます。パブリックチェーンではslot整列モードで動作するため、ブロック番号はSolana slotに対応し、同じslotはどのインデクサーでも同じブロックになります。プロキシはこれらのブロックをウォレットとエクスプローラに提供します。

Herculesは確定済みブロックをインデックスします。各ブロックをfinalized時に再確認し、blockhashが変わっていれば再読み込みします。 [Via explorer](https://docs.rome.builders/ja/romenoapuri/via.md) はHerculesのデータを読み取ります。

### Precompiles

Romeは、BN254とblake2fからの失敗データを除き、Ethereumのセマンティクスでecrecover、SHA-256、RIPEMD-160、identity、BN254曲線演算、blake2fを実装しています。BN254またはblake2fの呼び出しが失敗した場合、Romeの `Error(string)` のrevertデータが、空のバッファの代わりに返されます。Modexp（`0x05`）は無効化されており、 `"big_mod_exp call is disabled"`でrevertします。blake2fは、Ethereumでは許可されている1,000,000ラウンドを超える回数を受け付けません。

EVM以外のprecompileはSolanaにアクセスします: **CpiProgram** (`0xFF…08`、任意のCPI）、 **System** (`0xFF…07`、PDA導出とbase58ヘルパー）、 **HelperProgram** (`0xFF…09`、ATA/PDA作成、SPL転送、gas↔lamports）と **Withdraw** (`0x42…16`）。cachedファミリーは **SystemCached** (`0xff…04`), **SplCached** (`0xff…05`), **ASplCached** (`0xff…06`と **WithdrawCached** (`0xff…0b`）。Legacy CPIは即時に、かつ原子的トランザクション内でのみ実行されます。Cached CPIは実行中に記録され、commit時に送信されます。EVMとともにrevertします。反復トランザクション内で実行できます。完全な表は [Contract Addresses](https://docs.rome.builders/ja/rifarensu/contract-addresses.md) リファレンスを参照してください。

## 実行モード

RomeはEVMトランザクションを次の2通りの方法のいずれかで実行します:

### アトミック（VmAt）

1つのSolanaトランザクション。EVMトランザクション全体が、1つのSolanaトランザクションのcompute budget（約140万compute units）内で実行されます。転送、通常のコントラクト呼び出し、スワップなど、ほとんどの操作に使用されます。

### 反復的（VmIt）

1つのトランザクションの予算を超える作業向けです。実行は複数のSolanaトランザクションに分割されます:

1. 各ステップ（1つのSolanaトランザクション）は、そのcompute budgetに収まるだけ多くのEVMオペコードを実行します — ステップサイズは固定ではなく、適応的です
2. VM状態はBorshでシリアライズされて `StateHolder` ステップ間でアカウントに
3. 実行中、アカウントは数秒間TTLロックされます

compute units、heap、またはインストラクション数が1つのSolanaトランザクションに収まらない場合、プロキシは反復実行にフォールバックします。1セッションは160イテレーションに制限されます。LegacyトラックのCPIは、レッグ間で分割できないため、反復トランザクションでは拒否されます。CachedトラックのCPIは許可されます。

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

各Ethereumアドレスは、Rome EVMプログラムの下でchain IDとアドレスから導出されるSolana balance PDAに決定論的にマップされます。そのネイティブgas残高は、そのPDA内のフィールドであり、nonceとコントラクトコードも同様です。ストレージスロットは別個のstorage PDAに存在します。SPL残高は、別個のexternal-authority PDAが所有するトークンアカウントに存在します。この権限は、同じプログラム上のすべてのチェーンで共有されます。

## 2つの入り口

* **EVMキー経路:** ウォレットがsecp256k1署名済みのEVMトランザクションをRome Proxyに送信します。プロキシがSolanaトランザクションを送信します。
* **Solanaキー経路:** ウォレットがSolanaキーで未署名のEIP-1559ボディを認可します。直接のv1経路では、プロキシがSolanaトランザクションを組み立てます。ウォレットはそれに署名し、Solana RPCに直接送信します。リレー経路では、代わりにプロキシを使って送信します。旧来のレガシー経路では、ウォレットが `DoTxUnsigned` Solanaトランザクションを構築し、署名し、プログラムはSolana署名者から送信者を導出します。

Solanaの公開鍵は、合成アドレス `keccak256(pubkey)[12:]`、つまりハッシュの最後の20バイトにマップされます。参照: [Rome 上で Solana と EVM が出会う場所](https://docs.rome.builders/ja/ji-ben-gai-nian/how-solana-and-evm-meet.md).

## Solanaへの呼び出しに誰が署名するか

Rome EVMプログラムは、precompileの直近の呼び出し元のexternal-authority PDAでCPIに署名します。コントラクトは自分自身として署名します。ユーザーのSPLトークンを使うには、そのユーザーからのSPL delegationがコントラクトに必要です。ユーザーは `HelperProgram.approve_spl(spender, amount, mint)`でそれを許可します。ユーザーのEVMまたは合成アドレスからprecompileへの直接呼び出しでは、そのユーザーのexternal-authority PDAが使用されます。

## ホルダーアカウント

Solana（v1）トランザクションは4 KBに制限されていますが、EVMトランザクション（特にコントラクトデプロイ）はそれより大きくなることがあります。Romeは大きなトランザクションを3,600バイトのチャンクに分割し、順次 **ホルダーアカウント** （最大80 KB）に書き込みます。その後、各トランザクションを組み立ててオンチェーンで実行します。Rome SDKがこれを透過的に管理します。各チャンクの署名手数料は送信者のgasに課金されます。

## Gas と価格設定

各チェーンには独自のgasトークンがあります: SOLまたはSPLトークンです。価格ソースはHermes API、Meteora DAMM v1プール、Meteora DAMM v2プール、または固定価格です。これは、基盤となるSolanaトランザクション手数料に対するgasトークンとSOLの換算を提供します。

* 1ガスユニットはSolanaコストの1 lamportです
* `eth_gasPrice` は、1 lamportあたりのgasトークンweiです
* 送信者は、そのネイティブgas残高からfee recipientに支払います。プロキシのpayerはSOLを支払います
* Solanaウォレットの原子的経路のようにfee recipientがない場合、EVM gasは請求されません。ウォレットがSOLを直接支払います
* ネイティブ残高は18桁です。これは、チェーンごとのプログラムウォレットに保持されたgasトークンSPLによって裏付けられています

## ファイナリティ

RomeはSolanaのファイナリティを使用します。SDKは `confirmed`を待ちます。Herculesは各インデックス済みブロックを `最終確定` で再確認し、blockhashが変わっていれば再読み込みします。

## 次は何をするか

* [ネットワーク](https://docs.rome.builders/ja/nettowku/networks.md) — Hadrian（testnet）とRubicon（mainnet）に接続
* [クイックスタート](https://docs.rome.builders/ja/hajimeni-1/quickstart.md) — 最初のコントラクトをデプロイする
* [実行モデル](https://docs.rome.builders/ja/ji-ben-gai-nian/execution-model.md) — 原子的実行と反復実行の詳細
* [トークン相互運用](https://docs.rome.builders/ja/ji-ben-gai-nian/token-interop.md)
* [制約](https://docs.rome.builders/ja/ji-ben-gai-nian/constraints.md)
* [EVM から Solana を呼び出す](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md)
* [Solana から EVM を呼び出す](https://docs.rome.builders/ja/gaido/call-evm-from-solana.md)
* [プリコンパイルリファレンス](https://docs.rome.builders/ja/rifarensu/precompiles.md)
* [Rome 上で Solana と EVM が出会う場所](https://docs.rome.builders/ja/ji-ben-gai-nian/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/ja/hajimeni-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.
