> 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/rome-academy/08-open-your-solana-program-to-evm-users.md).

# 8. SolanaプログラムをEVMユーザーに公開する

MetaMask ユーザーが、薄い Solidity コントラクトと CPI プリコンパイルを通じて、すでに Solana 上で動いているプログラムを呼び出せるようにします。移植も、状態の二重管理も不要です。

Solanaプログラムがあり、それは動作しています。利用者はSolanaウォレットを持っています。Romeを使うと、別の層の利用者、たとえばMetaMaskのようなEVMウォレットを持つ人々にも、プログラムをSolidityで書き直すことなくアクセスさせられます。

## 学べること

* なぜSolanaプログラムをEVMユーザーに開放するのか、そして何を維持するのか。
* EVM呼び出しがあなたのプログラムに届く仕組み：薄いSolidityコントラクトとCPIプリコンパイル。
* あなたのプログラムが署名者とアカウントとして何を見るか。
* EVMユーザーのトークンがあなたのプログラムに届き、戻る仕組み。
* 設計上の制約：1つのトラック、1つのアトミックトランザクション、アカウント上限。

## ユースケース

このレッスンは、次のユースケースを扱います [作れるもの](https://docs.rome.builders/ja/rome-academy/02-what-you-can-build.md)：既存のSolanaアプリケーションが、さらに多くのユーザーを求めているケース。レンディング市場、AMM、Vault、予測市場、プライバシープログラムなどが該当します。

EVM側のユーザー層は大きく、すでにウォレット、ツール、習慣を持っています。プログラムをSolidityに移植すると、2つのコードベースを維持し、状態も分断されます。Romeでは、1つのプログラムと1つの状態のまま維持できます。EVMユーザーは小さなSolidityコントラクト経由でアクセスし、Solanaユーザーはネイティブに呼び続けます。両者は同じアカウントと同じ流動性を相手に取引します。 [コアを選ぶ](https://docs.rome.builders/ja/ji-ben-gai-nian/choose-your-core.md) これを形 (b)、つまり薄いCPIルーターを前面に置いたネイティブなSolanaコアと呼びます。

[rome-dex](https://github.com/rome-protocol/rome-dex) は、その参考例です。ネイティブなSolanaプールの前面に、EVMルーターを置いたものです。

## 始める前に

* 完了 [7. EVMアプリをSolanaウォレットに開放する](https://docs.rome.builders/ja/rome-academy/07-open-to-solana-wallets.md)、反対側から見た同じ考え方です。
* 知っておくべきこと [5. SolidityからSolanaを呼び出す](https://docs.rome.builders/ja/rome-academy/05-call-solana-from-solidity.md) および [6. 両側のトークン](https://docs.rome.builders/ja/rome-academy/06-tokens-on-both-sides.md)。このレッスンでそれらをまとめます。
* まず、プログラムをSolana devnetにデプロイしてください。Hadrianはそこで決済するため、プログラムはそのクラスター上に存在している必要があります。詳しくは [Hadrian](https://docs.rome.builders/ja/nettowku/hadrian.md).

## 要するに、流れは次のとおりです

### ステップ1: プログラムの前に薄いコントラクトを1つ置く

そのコントラクトはアダプターです。ビジネスロジックは持ちません。呼び出し元を確認し、あなたの命令を組み立て、CPIプリコンパイルを使って `invoke_signed`。その他はすべてSolanaプログラム側に残ります。呼び出しの仕組みは [EVM から Solana を呼び出す](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md#calling-custom-solana-programs)にあり、インターフェースは `contracts/interface.sol` 公開された [rome-solidity](https://github.com/rome-protocol/rome-solidity) リポジトリで扱っています。

アダプターには、ユーザーのポジションを保持する3つの方法があります。ガイドではそれらを以下で比較しています [ユーザーのポジションを保持する3つの方法](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-2.-three-ways-to-hold-a-users-position):

| 形                 | 何か                                 | 適している用途                     |
| ----------------- | ---------------------------------- | --------------------------- |
| アダプターコントラクト       | ユーザーのトークンを引き出し、自身としてあなたのプログラムを呼び出す | 入出金のあるプログラム向けの再利用可能なフロントエンド |
| ユーザーがプリコンパイルを呼び出す | ユーザー自身の権限が署名し、コントラクトは不要            | 一度限りの権限付与とシンプルなプログラム        |
| 非カストディ型ルーター       | トークンを保持せず、ユーザーの委任権限を使って支出する        | スワップやその他の単発アクション            |

Vaultやレンディングプログラムにはアダプターを、スワップにはルーターを選びます。

### ステップ2: あなたのプログラムが誰を認識するかを把握する

すべてのEVMアドレスには、Romeプログラムの下で導出された外部権限PDAというSolana上のIDがあります。コントラクトがプリコンパイルを呼び出すと、Romeはそのコントラクトの権限で署名します。あなたのプログラムには、署名者としてマークされた32バイトの公開鍵が見えます。20バイトのEVMアドレスも、ユーザー自身も見えません。

したがって、ユーザーは署名者ではありません。ユーザーを区別するには、アダプターが命令データにユーザーごとの値を渡すか、あるいはRomeにユーザーのアドレスから導出したソルト付きサブPDAでも署名するよう依頼します。すると、あなたのプログラムはサブPDAごとに1つのポジションを保持します。署名者ルールは [すべてのEVMアドレスには1つのSolana上のIDがあります](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-1.-every-evm-address-has-one-solana-identity).

どの権限が署名してもそれに従って動作するようプログラムを書いてください。そうすれば、Solanaウォレットにもアダプターにも同じように対応できます。

### ステップ3: ユーザーのトークンを移動する

Romeでは、レッスン6で示したように、ユーザーのUSDCは両側から見た1つのSPLトークンです。ユーザーの残高は、その権限が所有するトークンアカウントにあります。アダプターがそれを使えるようにするには、ユーザーはデポジット前にアダプターへSPLの委任を与えます。アダプターはトークンを自分の所有するトークンアカウントに引き出し、その後あなたのプログラムを呼び出します。出金時には、あなたのプログラムがユーザー自身のトークンアカウントへ支払い、ユーザーにはそれがERC-20残高としてすぐに見えます。

ここでは2つの落とし穴が重要です：

* ERC-20の送付は `transferFrom` コントラクトへの送付では、ラッパーのエスクロー台帳に記帳されるだけです。コントラクトは支出元となるトークンアカウントを受け取りません。ラッパーではなく、委任を使ってください。
* トークンアカウントの委任先は1つだけです。あなたの権限付与はラッパーの権限付与を置き換え、ユーザーが再びラッパーに権限を与えるまで、通常のトークン送金は止まります。確認してください `isEnabled` あなたの処理の後に。

完全な手順は [トークンの入出金](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-3.-tokens-in-tokens-out).

### ステップ4: 制限内に収める

* **1つのトラック。** カスタムプログラム呼び出しは legacy-track の CPI です。トランザクションでは cached-track の呼び出しと混在できないため、そのトランザクションには cachedラッパーを含めないでください。
* **アトミックのみ。** legacy-track の CPI は反復型トランザクションでは実行できません。呼び出し全体は1つのSolanaトランザクションに収まる必要があり、目安は約140万 compute units、64アドレス、4KBです。あなたのプログラムはその計算予算をRomeプログラムと共有します。
* **アカウントは先に列挙。** Romeは呼び出しをエミュレートし、触れるすべてのアカウントをSolanaトランザクションに入れます。各アカウントは、アダプターが持つ入力から導出できなければなりません。新規アカウントでも名前付けは必要です。
* **浅い深さ。** あなたのプログラムはRomeの1レベル下で実行されます。そこから呼び出す各プログラムはさらに1レベル使います。
* **レントはユーザー負担です。** あなたの命令が作成するアカウントの費用は、ユーザーのガスから支払われます。

各アクションは、1回のトークン移動と、あなたのプログラムへの1回のCPIに収めてください。それ以上大きいものは、ユーザーの2つのトランザクションに分けます。制限は1つの表にまとまっており、 [制約](https://docs.rome.builders/ja/ji-ben-gai-nian/constraints.md).

## 具体例

あなたのプログラムがVaultだとします。SolanaユーザーがUSDCを預け、後で引き出します。MetaMaskユーザーにも同じことをしてほしいのです。

1. あなたは、プログラムIDとUSDCミントを知っているアダプターをデプロイします。コンストラクタで、そのアダプター自身のSolana IDと、そのためのトークンアカウントを作成します。
2. MetaMaskユーザーは、USDCに対するSPL委任をアダプターに与える1つのトランザクションを送ります。
3. ユーザーは `deposit`。アダプターはUSDCを自分のトークンアカウントに引き出し、その後、自身の権限と、そのユーザー用のソルト付きサブPDAを署名者としてあなたのプログラムを呼び出します。
4. あなたのプログラムはUSDCをVaultに移し、ポジションをそのサブPDAの下に記録します。
5. アダプターの権限付与がラッパーのものを置き換えたため、あなたのアプリは `isEnabled` ユーザーに対するラッパー上でそれを読み取ります。そして `を呼び出し、返り値が`、ユーザーは `approve_spl` をラッパーに再び送ります。次のデポジットでは、アダプターへの新しい権限付与が必要です。
6. ユーザーは `withdraw`。アダプターは、あなたのプログラムにVaultからユーザーのトークンアカウントへ直接支払わせます。残高はMetaMask上でERC-20トークンとして表示されます。

Solanaユーザーはアダプターに一切触れません。彼らはVaultを直接呼び出し、同じ合計値を見ます。対応するSolidityのスケッチは [Solidityで書いたデポジットと出金](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-7.-a-deposit-and-a-withdraw-in-solidity).

まずHadrianでテストしてください。 `eth_call` および `eth_estimateGas` proxyが送信に使うのと同じエミュレーションを実行するので、そこで失敗したCPIは同じ理由でオンチェーンでも失敗し、revertにはあなたのプログラムのエラーが含まれます。送信後は、トランザクションのSolana側を `rome_solanaTxForEvmTx`。参照 [テスト](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-8.-testing).

## 確認しよう

自分の小さなプログラム、またはrome-dexのものを取り上げ、コードなしで書き出してください：

1. アダプターが呼び出したときに、あなたのプログラムが見る署名者。
2. 1回のデポジットで指定されるアカウント。
3. そのデポジットにおけるトークン移動とCPIの回数。

その後、Hadrianにアダプターをデプロイし、ユーザーのトークンアカウントに資金を入れ、SPL権限付与をアダプターに送り、デポジットを `eth_estimateGas` ユーザーのアドレスを `の`として実行してください。見積もりは成功するはずです。失敗する場合、revert data にSolanaのエラー名が出ます。

<details>

<summary>1. MetaMaskユーザーがアダプター経由でデポジットします。あなたのプログラムの署名者は誰ですか？</summary>

アダプターのexternal-authority PDAと、アダプターが列挙する任意のソルト付きサブPDAです。ユーザーではありません。ユーザーの権利は、彼らが与えたSPL委任から来ます。

</details>

<details>

<summary>2. なぜラッパーの <code>transferFrom</code>?</summary>

トークンはラッパーのエスクローアカウントに入り、その台帳に記録されます。アダプター自身のトークンアカウントがなく、あなたのプログラムに渡せません。

</details>

<details>

<summary>3. あなたのデポジットが膨らんでCPIが10回になり、Romeがそれを反復実行します。どうなりますか？</summary>

失敗します。legacy-track の CPI は反復型トランザクションでは拒否されます。アクションを1回のトークン移動と1回のCPIに絞るか、2つのトランザクションに分割してください。

</details>

## 次へ

[9. デュアルレーンアプリを構築する](https://docs.rome.builders/ja/rome-academy/09-build-a-dual-lane-app.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/rome-academy/08-open-your-solana-program-to-evm-users.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.
