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

# エコシステムとリポジトリ

公開されているRomeの各リポジトリ、その内容、そしてそれらのつながり — 表層を見渡すための地図。

Rome の公開面は、いくつかのリポジトリからなる集合です: **基盤** あなたが基にするパッケージ、スキャフォルダー、学習用の参考アプリ、そしてアプリが呼び出す 2 つのサービス。このページは、その地図です — 各リポジトリが何で、どう噛み合うかを示します。

2 つの隣接するリポジトリは異なる問いに答えます。このページはそれらを繰り返すのではなく、両方へのリンクを示します:

* [アーキテクチャ](https://docs.rome.builders/ja/hajimeni-1/architecture.md) を説明します **プロトコル** — EVM が Solana プログラム内でどのように動作するか。
* 各リポジトリには **`AGENTS.md`** （例: [rome-sdk-ts/AGENTS.md](https://github.com/rome-protocol/rome-sdk-ts/blob/main/AGENTS.md)）が同梱されており、次の基準で案内します: **何から始めるか** （Solidity コントラクト、Solana プログラム、新規、from-home）から、あなたのケースに最も近い例へ。

このページはその中間の階層です: **全体像** そして各要素のつながり方。

## 全体像をひと目で

### 基盤 — ここから構築します

| リポジトリ                                                           | 何か                                                                                                                                | こんなときに使います                       |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [rome-registry](https://github.com/rome-protocol/rome-registry) | `@rome-protocol/registry` — 読み取り専用の、ライブなチェーン情報（ID、RPC、アドレス、トークン mint、プログラム ID、オラクル feed、ALT）を生成して投影したもの。                          | 本物のチェーン情報が必要なとき — ハードコードは絶対にしない。 |
| [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts)     | `@rome-protocol/sdk` — TypeScript の書き込み経路: `submitRomeTx` + 手数料計算、両レーン、PDA/ATA + CPI エンコーダー、precompile バインディング、 `/bridge` クライアント。 | アプリやフロントエンドのコードを書いているとき。         |
| [rome-solidity](https://github.com/rome-protocol/rome-solidity) | Solidity の precompile インターフェース、SPL/ERC-20 ラッパー、オラクルアダプター — コントラクト側のツールキット。                                                        | コントラクトを書いているとき。                  |

上記の `@rome-protocol/…` 上記はパッケージ名ですが、これらのパッケージは npm には公開されていません。GitHub からインストールしてください（コマンドは各セクションの [基盤レイヤーを詳しく見る](#the-foundation-layer-up-close)）にあります。コード内の import パスはそのままです。

### Rome ZK EVM ロールアップ

| リポジトリ                                                           | 何か                                         | こんなときに使います                       |
| --------------------------------------------------------------- | ------------------------------------------ | -------------------------------- |
| [solana-zk-evm](https://github.com/rome-protocol/solana-zk-evm) | ZK ロールアップのプログラム、ノード、prover、オペレーター向けドキュメント。 | Solana 上で決済する EVM チェーンを運用しているとき。 |
| [rome-zk-guest](https://github.com/rome-protocol/rome-zk-guest) | 各チェーンの genesis 向けにビルドされたバッチ guest ソース。     | guest をビルドし、その検証鍵を要求するとき。        |

### Ostia（Canton 上の ZK EVM）

| リポジトリ                                                                                 | 何か                                                                                     | こんなときに使います                                                                                                                                                                       |
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/README.md) | Ostia は Canton 上の ZK EVM で、証明済みの各 EVM ブロックは、その Canton アクションとともに 1 つのトランザクションでコミットされます。 | Ostia DevNet（[explorer](https://ostia.devnet.romeprotocol.xyz/)）上で構築しているか、自分の Ostia を運用している場合。参照: [Canton ZK EVM](https://docs.rome.builders/ja/canton-zk-evm/canton-zk-evm.md). |

### 参考アプリ — 例で学ぶ

| リポジトリ                                                                   | 何か                                                                     | こんなときに使います                         |
| ----------------------------------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------- |
| [rome-dex](https://github.com/rome-protocol/rome-dex)                   | デュアルレーン AMM — ネイティブな Solana プールに薄い EVM ルーターを載せたもの。                     | もう一方のレーンを開く;  **native-core** の例。  |
| [aerarium](https://github.com/rome-protocol/aerarium)                   | デュアルレーン貸付 — Solana ユーザーが synthetic sender 経由で到達する Solidity の Comet コア。 | もう一方のレーンを開く;  **Solidity コア** の例。  |
| [cardo](https://github.com/rome-protocol/cardo)                         | EVM ユーザーが CPI 経由で Solana dApp（swap/stake/lend/perps）を動かす例。             | CPI から Solana へつながる、実際のアプリを学ぶための例。 |
| [appia](https://github.com/rome-protocol/appia)                         | ポジション優先のクロス VM DeFi。ユーザーは自分のホームチェーンから利用します。                            | ある **from-home** アプリ。              |
| [rome-aave-v3-demo](https://github.com/rome-protocol/rome-aave-v3-demo) | Aave v3 の supply/borrow/repay を、変更なしでデプロイしたもの。                         | そのまま動く完全な EVM アプリ。                 |

### コントラクトのフォーク — 既知のプロトコルを Rome にデプロイしたもの

| リポジトリ                                                                             | 何か                            | こんなときに使います              |
| --------------------------------------------------------------------------------- | ----------------------------- | ----------------------- |
| [compound-on-rome-comet](https://github.com/rome-protocol/compound-on-rome-comet) | Compound III（Comet）のマネーマーケット。 | 既知の EVM プロトコルをフォークするもの。 |
| [rome-aave-v3](https://github.com/rome-protocol/rome-aave-v3)                     | Aave v3 コントラクトのフォーク。          | 既知の EVM プロトコルをフォークするもの。 |

### サービス — アプリがこれらを呼び出します

| リポジトリ                                                                       | 何か                                                                                 | こんなときに使います                     |
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------ |
| [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api)         | オンチェーンブリッジのためのオフチェーン・オーケストレーター + 手数料スポンサー。鍵は保持しません。                                | ウォレットへの資金供給、または from-home フロー。 |
| [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) | Solana の価格フィード（Pyth、Switchboard）を Chainlink 経由で EVM に公開する `AggregatorV3Interface`. | 価格フィードが必要なとき。                  |

### スキャフォールド — ここから始める

| リポジトリ                                                               | 何か                                                                                                              | こんなときに使います    |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------- |
| [create-rome-app](https://github.com/rome-protocol/create-rome-app) | `npx github:rome-protocol/create-rome-app` — registry + SDK があらかじめ接続されたデュアルレーンアプリをスキャフォールドし、両レーンの資金チェックも付いています。 | 新しいアプリを始めるとき。 |

## どのように組み合わさるか

```mermaid
flowchart TD
    REG["rome-registry — ライブなチェーン情報"]
    SDK["rome-sdk-ts — 書き込み、CPI、ブリッジクライアント"]
    SOL["rome-solidity — precompile インターフェース、SPL ラッパー、オラクルアダプター"]
    CRA["create-rome-app — スキャフォルダー"]
    APP["あなたのアプリ — フロントエンド + コントラクト"]
    BAPI["rome-bridge-api — オフチェーン・オーケストレーター、鍵は保持しない"]
    OG["rome-oracle-gateway — Solana の価格フィード"]

    CRA -->|スキャフォールド、事前接続済み| APP
    REG -->|事実、ハードコードなし| APP
    SDK -->|書き込み経路 & CPI| APP
    SOL -->|あなたのコントラクトが import| APP
    APP -->|SDK /bridge クライアント| BAPI
    APP -->|AggregatorV3Interface 経由で読み取り| OG
    OG -.->|アダプターはここにある| SOL
    CRA -.->|接続する| REG
    CRA -.->|接続する| SDK
```

中核は 3 つの基盤と 1 つのスキャフォルダーです:

* [**rome-registry**](https://github.com/rome-protocol/rome-registry) は、ライブな事実の唯一の情報源です。 [**rome-sdk-ts**](https://github.com/rome-protocol/rome-sdk-ts) は書き込み経路であり、その `/bridge` サブパスは、アプリがやり取りに使うクライアントです `rome-bridge-api`. [**rome-solidity**](https://github.com/rome-protocol/rome-solidity) は、あなたのコントラクト（およびフォーク）が import するものです; そして、オラクルアダプターが `rome-oracle-gateway` のデプロイ先もここです。3 つは互いに独立しているので、アプリに必要なものだけを選んでください。
* [**create-rome-app**](https://github.com/rome-protocol/create-rome-app) 新しいアプリでは最初の 2 つをつなぎ合わせるので、作り立てのプロジェクトでも最初から registry を読み、SDK 経由で書き込めます。

覚えておく価値のある例外が参考アプリです: **これらは抽出されたパッケージより前から存在します。** cardo は registry パッケージを利用し、appia はビルド時に registry を静的 JSON に投影します。どちらも SDK を import するのではなく、自前で書き込み経路を同梱しています。パターンを学ぶには読む価値がありますが、 **新しい** アプリは `create-rome-app` とパッケージから始めるべきで、アプリをクローンするところから始めるべきではありません。

## 必要なものからたどる

* **ライブなチェーン情報** （ID、アドレス、mint、プログラム ID）→ [rome-registry](https://github.com/rome-protocol/rome-registry)。ハードコードはしない。
* **アプリコードを書く** （書き込み、CPI 呼び出し、ブリッジ）→ [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts)；参照先: [Rome SDK](https://docs.rome.builders/ja/zhi-pin/rome-sdk.md).
* **コントラクトを書く** → [rome-solidity](https://github.com/rome-protocol/rome-solidity)；参照: [Solidity コントラクトをデプロイする](https://docs.rome.builders/ja/gaido/deploy-solidity.md).
* **Solidity コントラクトから Solana プログラムを呼び出す** → の CPI precompile は [rome-solidity](https://github.com/rome-protocol/rome-solidity) (`interface.sol`); [cardo](https://github.com/rome-protocol/cardo) にある実例です。
* **動作する例** AMM、貸付、CPI、または from-home アプリの例 → 上記の参考アプリへ。各リポジトリの `AGENTS.md` は開始地点で案内します。
* **新しいアプリをスキャフォールドする** → [create-rome-app](https://github.com/rome-protocol/create-rome-app).
* **価格フィード** → [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) （ [Oracle Gateway ポータル](https://docs.rome.builders/ja/romenoapuri/oracle-gateway.md)).
* **別のチェーン上のユーザー** → [ホームチェーンから](https://docs.rome.builders/ja/gaido/from-home.md) + [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api).
* **ロジックをどちら側に持たせるかを決める** → [コアを選ぶ](https://docs.rome.builders/ja/ji-ben-gai-nian/choose-your-core.md).

## 基盤レイヤーを詳しく見る

### rome-registry — ライブな事実、公開されるように作られている

registry は **生成されます** Rome の内部ソースから: allowlist は公開するつもりのものだけを出力し、 **置き換え、** 内部エンドポイントを公開用のものにし、 **デフォルトでは拒否し** その他すべてを除外します — そのため、構造上 public-safe です。各チェーンごとに公開されるのは `chain.json` / `tokens.json` / `contracts.json` / `oracle.json` / `bridge.json` / `alts.json`、さらに Solana の `プログラム` と、プロトコルごとのアプリデプロイです。

GitHub から、リリースタグを固定してインストールします: `npm install github:rome-protocol/rome-registry#v0.2.0`。getter 経由で読みます — `getChain`, `getTokens`, `getContracts`, `getOracle`, `getBridge`, `getAlts`、および `getPrograms(network)` （プログラム ID は chain id ではなく network でキー付けされます）。このパッケージは通常の ESM です（現時点で TypeScript 型はバンドルされていません）。

組み込む前に知っておくべきことが 2 つあります:

* **`getTokens()` は返しません `assetRef`.** トークンのラッパーを見つけるには、その **mint** (`mintId`）で照合します — たとえば gas トークンのラッパーは、その mint を共有するエントリです。
* **ディスクから JSON を読みます（`node:fs`）— ブラウザでは安全に使えません。** Web アプリでは、必要な値をビルド時に静的 JSON ファイルへ投影し、クライアント側でそれを import します。（これはまさに `create-rome-app` と appia がやっていることです。）

コントラクトアドレスは、コントラクトごとのバージョン一覧として返ります; そのうち `status` が `live`. [contracts リストを読む](https://docs.rome.builders/ja/rifarensu/contract-addresses.md#reading-the-contracts-list) と、どう選ぶかが分かります。アプリがライブで読まない事実も [Contract Addresses](https://docs.rome.builders/ja/rifarensu/contract-addresses.md) のリファレンスに載っています。

### rome-sdk-ts — 両レーンの書き込み経路

GitHub からインストールします: `npm install github:rome-protocol/rome-sdk-ts#v0.4.0`.

`@rome-protocol/sdk` (v0.4.0) は、Rome の書き込みに必要なものをすべてまとめているので、calldata や手数料を手で組み立てる必要がありません:

* **`submitRomeTx`** — EVM レーンの書き込み経路: gas を見積もる `eth_estimateGas` （パディング付き、推定が revert したときは上限値にフォールバック）し、EIP-1559 の手数料を供給します。
* **`submitRomeTxV1`** — 同様に、 **Solana ウォレット** で EVM アプリを動かす場合。1 回の呼び出しにつき Solana v1 トランザクション 1 つ、ウォレットの確認は 2 回です。synthetic sender は静止状態では何も保持しません; `buildFundLeg`/`buildSweepLeg` ERC-20 として価値を出し入れします（`wUSDC`), **ではなく** ネイティブな `msg.value`；呼び出しの周りにある通常の Solana 命令（fund leg、sweep 前のウォレット token-account 作成）は `submitSolanaInstructionsV1` で v1 トランザクションとしても送られます。 `submitRomeTxSolanaLane` は以前の経路で、クライアント内でレガシー Solana トランザクションを組み立て、初回使用時に新しい synthetic（`create_pda`create\_pda）を自動で用意します。
* **PDA/ATA の導出、CPI `invoke`/`invoke_signed` エンコーダー、precompile バインディング**、および **`/bridge`** サブパス（`@rome-protocol/sdk/bridge`）— 見積もり優先のブリッジクライアント。

完全な API + 例: [Rome SDK](https://docs.rome.builders/ja/zhi-pin/rome-sdk.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/gaido/dual-lane-app.md).

### rome-solidity — コントラクト側のツールキット

npm ではなく GitHub からインストールします。npm または Hardhat なら: `npm install github:rome-protocol/rome-solidity`。Foundry なら: `forge install rome-protocol/rome-solidity`、その後リマッピングを追加します `@rome-protocol/rome-solidity/=lib/rome-solidity/` を `foundry.toml` （ `[profile.default]`の下に `remappings = [...]`）として追加し、 `@rome-protocol/rome-solidity/contracts/interface.sol` が解決されるようにします。 `package.json` が `@rome-protocol/rome-solidity`というパッケージ名なので、同じ import パスを両方で使えます。

あなたのコントラクトが import するもの:

* **`contracts/interface.sol`** — それぞれのアドレスにバインドされた precompile インターフェース: **CPI** `ICrossProgramInvocation` (`0xFF…08`), **Helper** `IHelperProgram` (`0xFF…09`、ATA/PDA 作成、SPL 転送、gas↔lamports） **Withdraw** `IWithdraw` (`0x42…16`）、そして **System** (`0xFF…07`）。gas 最適化された **cached** 系統もここにあります; コントラクトは一貫してどちらか一方の経路を使います。完全なアドレス表: [Contract Addresses](https://docs.rome.builders/ja/rifarensu/contract-addresses.md).
* **SPL/ERC-20 ラッパー** — `SPL_ERC20` （CPI ベース）と `SPL_ERC20_cached` （cached 経路。devnet で使用）; どの SPL mint も、これらを通じてすでに ERC-20 です。
* **オラクルアダプター** (`contracts/oracle/`）— Pyth/Switchboard のアダプター `rome-oracle-gateway` のデプロイ。読み取りは `IAggregatorV3Interface`.
* 実装例は `contracts/examples/`.

の Solidity SDK セクションでは [Rome SDK](https://docs.rome.builders/ja/zhi-pin/rome-sdk.md) import パターンと precompile バインディングをコードで示しています。

## 次は何をするか

* [コアを選ぶ](https://docs.rome.builders/ja/ji-ben-gai-nian/choose-your-core.md) — ロジックをどちら側に持たせるか。
* [クイックスタート](https://docs.rome.builders/ja/hajimeni-1/quickstart.md) — 最初のコントラクトをデプロイします。
* [create-rome-app](https://github.com/rome-protocol/create-rome-app) — デュアルレーンアプリをスキャフォールドします。
* 各リポジトリの `AGENTS.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/ecosystem.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.
