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

# 重要な概念

開発者向けの、SolanaとRome EVMの必須用語 — program、account、PDA、CPI、SPLトークン、アトミック実行とイテレーティブ実行など。

Rome Protocol に基づいて構築するための必須用語と概念。

## Solana の概念

**プログラム** — Solana におけるスマートコントラクトに相当します。プログラムはオンチェーンにデプロイされるステートレスな実行ファイルです。Rome EVM 自体が Solana プログラムです。

**アカウント** — Solana 上のすべての状態はアカウントに保存されます。各アカウントには所有者（プログラム）、残高（lamports）、データがあります。Ethereum と異なり、コードと状態は別々のアカウントに保存されます。

**PDA（Program Derived Address）** — シードとプログラム ID から導出される決定論的なアドレスです。PDA により、プログラムは秘密鍵なしでアカウントを「所有」できます。Rome では PDA を使って Ethereum アドレスを Solana アカウントに対応付けます。

**CPI（Cross-Program Invocation）** — 同じトランザクション内で、ある Solana プログラムが別のプログラムを呼び出すことです。Rome EVM コントラクトが Jupiter、Kamino、SPL Token、その他の Solana プログラムとやり取りする仕組みです。

**SPL Token** — Solana の標準トークンプログラムです。Ethereum の ERC-20 に相当します。Solana 上のすべての代替可能トークン（USDC、SOL など）は SPL トークンです。

**Token-2022** — Transfer Hooks、Confidential Transfers、Permanent Delegates などの拡張機能を備えた次世代の SPL トークンプログラムです。

**Transfer Hook** — Token-2022 の拡張で、毎回プログラムを呼び出す `transfer_checked` 機能です。

**ATA（Associated Token Account）** — 特定のウォレット + ミントの組み合わせに対応する決定論的なトークンアカウントです。各ユーザーは保有するトークンごとに 1 つの ATA を持ちます。

**Lamports** — SOL の最小単位です。1 SOL = 1,000,000,000 lamports（10^9）です。

**Compute Units（CU）** — Ethereum の gas に相当する Solana の単位です。各トランザクションには計算予算があります（デフォルトは約 200K CU、最大は約 1.4M CU）。操作は CU を消費します。

## Rome の概念

**Rome EVM プログラム** — EVM バイトコードインタプリタを含む Solana プログラムです。環境ごとに特定のプログラム ID にデプロイされます。

**チェーン ID** — Rome 上の各アプリケーションには独自の EVM chain ID が割り当てられます。これにより、基盤となる同じ Solana 状態を共有しつつ、分離された EVM 環境が作られます。

**Atomic Execution（VmAt）** — 1 つの Solana トランザクション内で完全に実行される EVM トランザクションです。ほとんどの操作で使用されます。

**Iterative Execution（VmIt）** — 複数の Solana トランザクションに分割された EVM トランザクションで、各ステップは 1 回の Solana トランザクションの計算予算に収まるだけのオペコードをパックします（固定数ではなく、適応的です）。BN254 のペアリングのような計算負荷の高い操作に使用されます。

**ホルダーアカウント** — 4 KB の Solana（v1）トランザクションサイズ制限を超える大きな EVM トランザクション（最大 80 KB）を保存するオンチェーンバッファです。SDK が透過的に管理します。

**StateHolder** — 繰り返し実行ステップ間のシリアライズされた VM 状態を保存するオンチェーンアカウントです。

**Rome Proxy** — Ethereum API 呼び出しを Solana トランザクションに変換する JSON-RPC サーバー（ポート 9090）です。MetaMask と Hardhat はここに接続します。

**Hercules** — Solana 上の Rome EVM イベントを監視し、Ethereum と互換性のあるブロックデータを生成するブロックインデクサーです。

**支払者** — EVM ユーザーに代わって Solana トランザクションに署名し、その手数料を支払う Solana キーペアです。payer pool を通じて Proxy が管理します。

## トークンの概念

**SPL\_ERC20 / SPL\_ERC20\_cached** — Rome EVM 内で SPL トークンを表す ERC-20 ラッパーコントラクトです。ウォレットに対しては、ラッパーは基盤となる SPL トークンアカウントから残高を直接読み取ります。コントラクトが保有するトークンは、ラッパー自身のエスクロー用トークンアカウントに置かれ、ラッパーのストレージで追跡されます（ [Solana プログラムを統合する](https://docs.rome.builders/ja/gaido/integrate-solana-program.md)）。ファクトリーは現在、キャッシュ版をデプロイします。

**ERC20SPLFactory** — 任意の SPL トークン用のラッパーをデプロイするファクトリーコントラクトです。

**レジストリ** — 正規のラッパー、ガストークン、ブリッジ接続は、 [rome-protocol/registry](https://github.com/rome-protocol/rome-registry)にオフチェーンで管理されています。オンチェーンのトークンレジストリコントラクトはありません。これにより、各資産は単一の正規 SPL ミントにマッピングされます。

## Precompiles

**標準 Ethereum プリコンパイル** — ecrecover (0x01)、SHA-256 (0x02)、RIPEMD-160 (0x03)、identity (0x04)、modexp (0x05)、BN254 ecAdd/ecMul/ecPairing (0x06-0x08)、Blake2f (0x09)。

**System プリコンパイル** (`0xFF...07`) — Solidity からの PDA 導出と base58 変換。

**CpiProgram プリコンパイル** (`0xFF...08`) — クロスプログラム呼び出し（`invoke` / `invoke_signed`) とクロスステート読み取りショートカット。

**HelperProgram プリコンパイル** (`0xFF...09`) — ATA/PDA 作成、SPL 転送、gas↔lamports 変換。ユーザーが署名した PDA ベースの SPL 操作の主な入口です。

**Withdraw プリコンパイル** (`0x42...16`) — EVM から Solana に戻す SOL または SPL トークンの引き出し。

キャッシュトラック系（`0xff…04/05/06/0b`）は、CU 効率のよい読み取りのためにこれらを反映します。コントラクトは 1 つのトラックを一貫して使用します。

## トランザクション種別

Rust SDK は 3 種類のトランザクションを構築します。Rome はそれぞれを Solana 上で決済します。

**1 つの EVM トランザクション（`RheaTx`)** — 1 つの Rome チェーン上の単一の EVM トランザクションです。最も一般的な種類です。

**複数の EVM トランザクション（`RemusTx`)** — 異なる Rome チェーン上の EVM トランザクションを、1 つの Solana トランザクション内でまとめて実行します。どれか 1 つでも失敗すると、すべて元に戻ります。

**EVM トランザクションと Solana 命令（`RomulusTx`)** — 1 つの原子的な Solana トランザクション内で EVM トランザクションとネイティブな Solana 命令を実行し、Solidity と Solana プログラムが一緒に動くか、まったく実行されないかのどちらかになります。

## 次は何か

* [実行モデル](https://docs.rome.builders/ja/ji-ben-gai-nian/execution-model.md) — EVM トランザクションが Solana 上でどのように実行されるかの詳細解説
* [トークン相互運用](https://docs.rome.builders/ja/ji-ben-gai-nian/token-interop.md) — ERC-20 と SPL トークンがどのように相互作用するか
* [制約](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/hajimeni-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.
