> 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/gaido/call-evm-from-solana.md).

# SolanaからEVMを呼ぶ

Ethereum鍵なしで、SolanaウォレットにRome上のEVMコントラクトを操作させます。ウォレットが署名し、そのトランザクションはSolanaへ送られます。

の逆 [EVM から Solana を呼び出す](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md): Solanaウォレット（たとえばSolflare）がRome上の任意のEVMコントラクトを直接呼び出し、 **Ethereumキーなしで**。これが [Aerarium](https://docs.rome.builders/ja/romenoapuri/apps.md) SolanaネイティブのユーザーがEVMユーザーと同じコントラクトを共有できる仕組みです。

1回の呼び出しで済む方法は、SDKの `submitRomeTxV1`で、プロキシがその呼び出し用に1つのSolana v1トランザクションを組み立てます。このページではその仕組みを説明します。

## 合成アドレス

SolanaウォレットのEVM上の識別子は、その **合成アドレス** — の末尾20バイトです。 `keccak256` 32バイトのSolana公開鍵の:

```
synthetic_evm_address = keccak256(solana_pubkey)[12:]
```

これは `msg.sender` ウォレットがコントラクトを呼び出すときのアドレスであり、そのnonceとストレージが置かれる安定した識別子です。導出はプロトコルに固定されているため、ウォレットは常に同じアドレスに対応します。

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // 0x… 20 bytes
```

## 合成アドレスは通過点にすぎず、静止時にはトークンを保持しません

Solanaネイティブのユーザーが支出できる残高は、その **Solana ウォレット** （SPLトークンとして）にあり、EVM側ではトークンの **ERC20SPLラッパー** （例: `wUSDC`）として1:1で表現されます。合成アドレスは静止時には何も保持しないため、価値は *を経由して* 流れます — すべてのステップはSolanaウォレットで署名されます:

1. **準備（1回のみ）。** 新規の合成アドレスのexternal-auth PDAは、 `create_pda` が実行されるまで存在しません — 以下の転送はそのPDAで署名されます。 `submitRomeTxSolanaLane` 初回使用時に自動的に準備されます（または `provisionSynthetic` を呼び出して明示的に「Activate」ステップを行えます。確認は `isSyntheticProvisioned`）。 `submitRomeTxV1`では、確認し `isSyntheticProvisioned` 、そして送信します `buildCreatePdaCall` を1回経由します。
2. **資金供給の段階（ウォレット → 合成アドレス）。** トークンをウォレットのATAから合成アドレスのものへ移動します — これは `ActivateAta` ステップで、 `buildFundLeg`。すると `wrapper.balanceOf(synthetic)` がその残高を読み取り、合成アドレスはそれを通常のERC-20として（`transfer` / `transferFrom`）— **ではなく** ネイティブとして `msg.value`としてではなく、合成アドレス自身は保持していないためです。
3. **呼び出し（`DoTxUnsigned`).** 合成アドレスがEVMトランザクションを実行します — たとえば `approve` その後、vaultの `deposit` が次を介して引き出します `transferFrom`.
4. **スイープの段階（合成アドレス → ウォレット）。** withdraw / borrow / claim によりトークンが合成アドレスに入ったあと、 `buildSweepLeg` それらをユーザー自身のウォレットATAへ戻します（`HelperProgram.transfer_spl`）ので、合成アドレスの差し引きはゼロになります。

次のセクションでは、以前の `submitRomeTxSolanaLane` がクライアント側で構築していたものを説明します。 `submitRomeTxV1` では、プロキシにv1トランザクションを組み立てさせます。あなたのコードにはアカウント探索、ComputeBudget、treasureウォレットは不要です。参照: [external-V1エンドポイント](#the-external-v1-endpoints) 以下。

## 呼び出しの構築方法

`submitRomeTxSolanaLane` がこれらすべてを行います。仕組みは次のとおりです:

1. **未署名のEIP-1559トランザクションを構築する** ただし `の` ＝合成アドレス — secp256k1署名は不要。
2. **アカウントを検出する** — を呼び出し、 [`rome_emulateCallAccounts`](https://docs.rome.builders/ja/rifarensu/json-rpc.md) 呼び出しの `の`, `を`, `data`, **および `value`** （呼び出しがpayableの場合）。 `value` を渡すことが重要です。プロキシは *実際の* 呼び出しをエミュレートするため、valueに依存するストレージ書き込み — たとえば新しいmappingスロット — が割り当てられ、そのSolanaアカウントが返されます。省略するとそのアカウントがなくなり、トランザクションは次のエラーで失敗します *「instruction modified data of a read-only account.」*
3. **Solanaトランザクションを組み立てる:** 2つの **ComputeBudget** 命令（RomeのEVMには引き上げたCU上限 ≈1.35M と大きなヒープフレーム ≈250 KB が必要で、Solanaのデフォルトでは失敗します）＋ **`DoTxUnsigned`** 命令（未署名のRLP + 検出されたアカウント）＋チェーンごとの **treasureウォレット** （実行時に小額の手数料が支払われます。検出では省略されるため、SDKが末尾に追加します）。
4. **ウォレットが署名して送信します。** 上記の **SolanaウォレットはSolanaトランザクションにEd25519で署名し、プロキシではなくSolana RPCへ送信します。** Solanaランタイムが署名を検証し、オンチェーンではプログラムが `msg.sender` その署名者から導出します。権限はEthereum署名ではなくSolana署名です。（プロキシは手順2のエミュレーション／探索にのみ使われます。）

ユーザーのPDA（`["EXTERNAL_AUTHORITY", synthetic_address]`）がトークンアカウントを所有し、SPLのCPIに代わって署名します — そのためSolanaユーザーは、供給、借入、スワップ、LPをすべてSolanaウォレットだけで行えます。

## external-V1エンドポイント

`submitRomeTxV1` は1回の呼び出しで済む方法です。プロキシに組み立て済みのv1トランザクションを要求し、それを検証し、ウォレットに署名させてSolana RPCへ送信します。呼び出しが収まらない場合はプロキシ経由で中継します。プロキシはRPCメソッドとして同じ経路を公開しているため、どのクライアントでもSDKなしで利用できます（全一覧は [JSON-RPCサポート](https://docs.rome.builders/ja/rifarensu/json-rpc.md)):

* `rome_composeUnsignedAtomicV1(rlp, pubkey, signature)` — 1つのSolana v1トランザクション。ウォレットが署名し、アプリがそれをSolana RPCにブロードキャストします。呼び出しが1つのatomicトランザクションに収まらない場合は拒否されます。
* `rome_composeUnsignedIterativeV1(rlp, pubkey, signature)` — 実行の各段階（収まるならatomic、そうでなければ反復の段階）; ウォレットがそれぞれに署名し、 `rome_submitSignedV1Plan` それらをブロードキャストします。長いプランの制限は [中継呼び出しと長い呼び出し](#relayed-calls-and-long-calls).
* `rome_relayUnsignedV1(rlp, pubkey, signature)` — ウォレット署名は1回だけで、プロキシのpayerが各段階を実行し、EVMトランザクションハッシュを返します。Romeのガス代は合成アドレスが支払うため、最初に1回だけ `rome_composeExternalDepositV1`.

**認可署名。** `rlp` は、9フィールドからなる素の未署名EIP-1559本文です。ウォレットはEd25519鍵で、32バイトの生の `keccak256(0x02 ‖ rlp)` または読みやすいメッセージ

```
Rome認可\n0x<そのハッシュの64文字の小文字16進数>
```

どちらも受け付けられます。読みやすい形式は、ウォレットがその `signMessage` signMessageプロンプトで可読に表示する形式です。プログラムは実行する本文からハッシュを再計算し、署名済みメッセージがこの2形式のどちらかと完全に一致することを要求するため、ある本文への署名で別の本文を認可することはできず、本文のnonceがリプレイを防ぎます。

## 中継呼び出しと長い呼び出し

一部の呼び出しは1つのSolanaトランザクションに収まりません。このセクションでは、その場合に何が起こるか、どんな制限が適用されるかを説明します。

### atomicコンポーザーが拒否するとき

`rome_composeUnsignedAtomicV1` は、1つのatomicトランザクションに収まらない呼び出しを拒否します。 `submitRomeTxV1` その場合、呼び出しをプロキシ経由で中継し、 **同じ** 認可署名を使います。そのためウォレットに2回目の確認は求めません。結果には `route: "relay"` およびSolanaの `署名はありません`。 `relayOnRefusal: false` を指定すると、拒否をエラーとして受け取れます。あるいは `relayV1` を自分で呼び出して、意図的に中継してください。

中継された呼び出しについて知っておくべき3点:

* **ガス代は合成アドレスが支払います。** 中継ルートでは、プロキシがSolanaトランザクションを送信し、その費用を支払い、呼び出しの料金はチェーンのネイティブガストークンで合成アドレスの残高から支払われます。残高は少なくとも `gasLimit × maxFeePerGas`. `fundSyntheticGas(deps, amountWei)` で補充します。チェーンのガストークンのウォレット自身のトークンアカウント（HadrianとRubiconではUSDC）から補充されます。ウォレットは通常のv1トランザクションに1回署名し、Solana手数料用に少しのSOLが必要です。 `amountWei` はチェーンの18小数のweiで、10^12の倍数でなければならず、そうでないとプロキシは拒否します。SDKなしでは、 `rome_composeExternalDepositV1` 同じトランザクションを構築します。
* **revertは例外を投げません。** EVM側でrevertした中継呼び出しも通常どおり解決され、 `receipt.status === "0x0"`。次を確認してください。 `receipt?.status === "0x1"` で呼び出し完了とみなす前に。 `receipt` が `null` receiptは、時間内に現れなかった場合です。
* **`relayOnRefusal: false` はSDKでの選択であり、固定ではありません。** プロキシはすでにそのペイロードの認可署名を保持しており、どちらのルートでも実行できます。ただし上限は `gasLimit × maxFeePerGas`.

```javascript
const res = await submitRomeTxV1(deps, { to, data, value });
if (res.route === "relay" && res.receipt?.status !== "0x1") {
  // revertした中継呼び出しは解決される; 例外は投げない
}
```

### 長い呼び出し

1つ以上のトランザクションを必要とする呼び出しは、反復セッションとして実行されます。プログラムは各Solanaトランザクションに収まるだけのEVMステップを実行し、その間に状態を保存します。Solanaウォレットからこれを動かす方法は2つあります:

* **中継する。** `rome_relayUnsignedV1` はウォレット署名を1回受け取り、プロキシのpayerが各段階を送信します。ガス代は上記のとおり合成アドレスが支払います。
* **各段階に自分で署名する。** `rome_composeUnsignedIterativeV1` は各段階を署名欄空欄のまま返し、ウォレットがそれぞれに署名し、 `rome_submitSignedV1Plan` 順番にブロードキャストします。各段階はウォレットが署名する別個のSolanaトランザクションなので、1回に1件ずつ署名するウォレットでは、認可署名に加えて各段階ごとに1回プロンプトが出ます。ウォレットは各段階のSolana手数料を支払います。

制限:

| 制限                                 | 値           | 由来                                                                              |
| ---------------------------------- | ----------- | ------------------------------------------------------------------------------- |
| 1回の `rome_submitSignedV1Plan` 呼び出し | 64          | プロキシはそれより長いプランを拒否します                                                            |
| 反復コンポーザーが計画する段階数                   | 128         | Rust Rome SDKの反復コンポーザーの上限で、プランもそれで制限されます `rome_composeUnsignedIterativeV1` 返します |
| 1セッション内の反復回数                       | 160         | Rome EVMプログラム; これを超えるとセッションは再開を停止し、アカウントロックを解除して終了します                           |
| Solanaトランザクションのサイズとアカウント           | 4 KB、64アドレス | 各段階はSolana v1トランザクションです                                                         |

実際の呼び出しのほとんどは、これらの上限よりはるかに少ない段階で完了します。ウォレット署名済みプランの64トランザクション制限が、最初に当たる制限です。それより多くの段階を必要とする呼び出しは、経由してブロードキャストできません `rome_submitSignedV1Plan`.

長い呼び出しはlegacy-trackのCPIを行えません。legacy precompile（`0xff…08`, `0xff…09` および `0x42…16`）上の変更系呼び出しは、反復セッションでは次の理由で拒否されます `CpiProhibitedInIterativeTx`。Solana状態の読み取りとcached-trackのprecompile（`0xff…04`, `0xff…05`, `0xff…06`, `0xff…0b`）は動作します。legacy-trackのCPIを行う呼び出しは、どのレーンで送る場合でも1つのatomicトランザクションに収まる必要があります。参照: [制約](https://docs.rome.builders/ja/ji-ben-gai-nian/constraints.md) および [計算予算](https://docs.rome.builders/ja/ji-ben-gai-nian/compute-budget.md).

## 参照実装

* **Aerarium** — SolanaウォレットからCompound v3（供給 / 借入）を `DoTxUnsigned`経由で操作します。これは上で説明した古いlegacyトランザクションのレーンの参考実装であり、 `submitRomeTxV1`.
* **Rome DEX** はこのページの例ではありません。Solana側はウォレットが直接署名するネイティブSolanaプログラムで、EVM側は同じプールを共有します。

Aerariumでは2つ目のウォレットは不要です — 合成アドレスにより、1つのSolana鍵が第一級のEVMアカウントになります。v1パターンについては、 [デュアルレーンアプリを作る](https://docs.rome.builders/ja/gaido/dual-lane-app.md).

## 次は何か

* [EVM から Solana を呼び出す](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md) — 逆方向、CPI経由
* [トークン相互運用](https://docs.rome.builders/ja/ji-ben-gai-nian/token-interop.md) — EVMとSolanaの間で残高がどのように共有されるか


---

# 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/gaido/call-evm-from-solana.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.
