> 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/05-call-solana-from-solidity.md).

# 5. Solidity から Solana を呼び出す

Rome の CPI と Helper のプリコンパイルを使って、Solana のアカウントを読み取り、トークンアカウントを作成し、Solidity コントラクトから Solana プログラムを呼び出します。

Romeでは、Solidityコントラクトが同一トランザクション内でSolanaアカウントを読み取り、Solanaプログラムを呼び出せます。Solanaのトークン残高を読み取り、トークンアカウントを作成し、プログラム呼び出しの組み立て方を学びます。

## 学べること

* Romeにおけるプリコンパイルとは何か、そして最もよく使う3つはどれか。
* あなたのコントラクトが呼び出したとき、Solanaプログラムには誰の署名が見えるのか。
* Solanaの状態を読み取り、Solidityからトークンアカウントを作成する方法。
* Solana呼び出しが成功するかを決めるルール: 宣言済みアカウント、単一トラック、アトミックのみ。

## 始める前に

* 完了 [4. Romeがコードをどう実行するか](https://docs.rome.builders/ja/rome-academy/04-how-rome-runs-your-code.md)。ここではアトミック予算と64アカウント上限が重要です。
* Hadrianウォレットに資金を入れ、レッスン3でのデプロイ設定が動作していることを確認してください。ファウセットは次に一覧があります [ファウセット](https://docs.rome.builders/ja/rissu/faucets.md).
* RomeのSolidityインターフェースを次からインストールします `rome-solidity` リポジトリから、次で説明されているとおりに [Solidityをデプロイ](https://docs.rome.builders/ja/gaido/deploy-solidity.md#using-the-rome-solidity-sdk).

## プリコンパイルは入口です

プリコンパイルは、バイトコードではなくネイティブコードを実行する固定アドレスです。Ethereumにはいくつかあり、たとえば `ecrecover`。Romeは、Solanaに到達するためのプリコンパイルを追加しています。インターフェースを通じて、通常のコントラクトと同じように呼び出します。

使用するのは3つです:

| プリコンパイル       | できること                                                                           |
| ------------- | ------------------------------------------------------------------------------- |
| CpiProgram    | `invoke` および `invoke_signed` あらゆるSolanaプログラムを呼び出せるほか、Solanaアカウントの読み取り専用ビューも使えます |
| HelperProgram | すぐ使えるトークン／アカウント操作: トークンアカウントの作成、SPLトークンの送金、アドレスの導出                              |
| System        | PDAの導出とbase58変換                                                                 |

アドレスは [プリコンパイルリファレンス](https://docs.rome.builders/ja/rifarensu/precompiles.md) および [コントラクトアドレス](https://docs.rome.builders/ja/rifarensu/contract-addresses.md)にあります。自分で入力する必要はありません。 `interface.sol` の `rome-solidity` をインポートすると、次の名前のあらかじめ用意された定数が使えます: `CpiProgram`, `HelperProgram` および `SystemProgram`.

## 署名者は誰か

あなたのコントラクトがプリコンパイルを呼ぶと、Solanaが見るのはユーザーではなく、コントラクト自身の識別情報です。すべてのEVMアドレスには、Solanaのプログラム由来アドレスである外部権限PDAがあります。それがそのアドレスのトークンアカウントを所有し、その代わりに署名します。

これはERC-20で知っているのと同じルールです。ユーザーが許可しない限り、コントラクトはユーザーの資産を動かせません。レッスン6では、Romeでユーザーがそれを許可する方法を示します。このルールと、ユーザーのポジションを保持する3つの方法は、次にあります [Solana プログラムを統合する](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-1.-every-evm-address-has-one-solana-identity).

## ステップ1: 書き込む前に読む

まずは読み取りから始めます。読み取りは状態を変更せず、アトミック実行でも反復実行でも機能します。変更する前に読んでください。キャッシュ済み呼び出しが一度実行されると、そのトランザクションの残りではレガシートラックの読み取りは拒否されます。

```solidity
import "@rome-protocol/rome-solidity/contracts/interface.sol";

contract SolanaPeek {
    // Rome が呼び出し元とチェーンのガスミントに使用するトークンアカウント
    function myTokenAccount() external view returns (bytes32) {
        return HelperProgram.ata(msg.sender, SystemProgram.mint_id());
    }

    // そのアカウントにおける呼び出し元の残高
    function myBalance() external view returns (uint64) {
        return HelperProgram.user_balance(msg.sender, SystemProgram.mint_id());
    }
}
```

Solanaのアドレスは `bytes32` ここにあり、20バイトのアドレスではありません。その他の読み取り、 `account_info`, `account_data_at` および `account_u64_at`は、任意のSolanaアカウントを調べることができます。詳しくは [アカウントデータの読み取り](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md#reading-account-data).

## ステップ2: ヘルパーを使う

よくある作業なら、手で命令を組み立てる必要はありません。Helperはトークンアカウントを作成し、SPLトークンとlamportsを移動し、ガスとlamportsを変換します。シグネチャは次にあります `contracts/interface.sol`、そして完成済みのコントラクトは次にあります [lamportsを送金する](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md#transfer-lamports).

```solidity
function createMyAta() external {
    HelperProgram.create_ata(msg.sender, SystemProgram.mint_id());
}
```

Helperを呼び出すコントラクトは、自分自身として振る舞います。移動するトークンはユーザーのものではなく、コントラクト自身のものです。

## ステップ3: 任意のSolanaプログラムを呼び出す

Helperで対応していないプログラムでは、アカウント一覧と命令バイト列を自分で作成し、次を呼び出します `invoke`。各アカウントは、pubkeyに signer と writable の2つのフラグを加えたものです。命令データは、対象プログラムが期待する形式で、通常はBorshです。

完全なコントラクトは次にあります [カスタムSolanaプログラムの呼び出し](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md#calling-custom-solana-programs). `invoke_signed` 対象がコントラクトから複数の署名者を必要とする場合、salt付きのサブPDAを追加します。Solidity内でPDAのアドレスを取得するには、次を使います `find_program_address` Systemプリコンパイル上のものを使います。詳しくは [PDAの導出](https://docs.rome.builders/ja/gaido/call-solana-from-evm.md#pda-derivation).

## うまくいくかどうかを決めるルール

* **すべてのアカウントを宣言します。** Solanaは、呼び出しが実行される前に完全なアカウント一覧を必要とします。プロキシはまずトランザクションをエミュレートしてそれを見つけるため、各アカウントはコントラクトが持つ入力から導出できなければなりません。合計は64アドレス上限以内に収める必要があります。
* **アトミックに保つ。** レガシートラックのCPIを発生させる呼び出しは、反復的には実行できません。1つのアトミックトランザクションに収める必要があるため、各アクションは1回のトークン移動と1回のCPIにしてください。
* **トラックは1つに絞ります。** Romeには、Solanaの状態を変更する2系統のプリコンパイルがあります: レガシー（`CpiProgram`, `HelperProgram`, `Withdraw`）とキャッシュ済み（ `…Cached` セット）。トランザクションはどちらか一方の系統のみを使います。カスタムプログラムを呼び出せるのはレガシートラックだけです。次の表を参照してください [Solana プログラムを統合する](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-4.-one-track-per-contract-and-per-transaction).
* **深さは浅く保つ。** Solanaプログラムへの呼び出しはCPIレベルを使用し、そこからさらに呼ばれる各プログラムも同様です。Solanaの深さ制限は低いです。 [制約](https://docs.rome.builders/ja/ji-ben-gai-nian/constraints.md#cpi-constraints) がレベルを説明します。
* **Romeへの呼び戻しは不可。** CPIはRomeプログラムを指定したり呼び出したりできません。通常のSystem送金命令以外では、Solanaのfee payerを指定することもできません。

## 確認しよう

追加する `createMyAta` を `SolanaPeek` をHadrianにデプロイします。次に:

1. を呼び出します `myTokenAccount` および `myBalance` を、ウォレットアドレスからの読み取り呼び出しで実行します。
2. 次を呼び出すトランザクションを送信します: `createMyAta`.
3. Hadrianエクスプローラーでそのトランザクションを開きます。次を確認してください [Via explorer](https://docs.rome.builders/ja/romenoapuri/via.md).

呼び出しの背後にあるSolana命令とそのcompute unitsが見えるはずです。Solanaに到達する呼び出しは、EVMの呼び出しだけでなく、エクスプローラー上にSolanaプログラムとして表示されます。

<details>

<summary>1. コントラクトが次を呼び出す <code>HelperProgram.transfer_spl</code>。誰のトークンが動きますか?</summary>

コントラクト自身のものです。署名者はコントラクトのexternal-authority PDAです。ユーザーのトークンを動かすには、まずユーザーが権限を付与しなければなりません。

</details>

<details>

<summary>2. 次を使う呼び出しがなぜ <code>invoke</code> 1つのアトミックトランザクションに収まる必要があるのですか?</summary>

レガシートラックのCPIは、反復トランザクション内では拒否されます。呼び出しに1つを超えるSolanaトランザクションが必要なら失敗します。

</details>

<details>

<summary>3. どの読み取りなら、どの実行モードでも頼れますか?</summary>

読み取り専用ビュー: `account_info`, `account_data_at`, `account_u64_at`, `account_lamports`, `pdas_batch_derive` および、次のようなHelperの読み取り: `user_balance`。副作用はありません。同じトランザクション内でキャッシュ済みの変更を行う前に実行してください。

</details>

## 次へ

[6. 両側のトークン](https://docs.rome.builders/ja/rome-academy/06-tokens-on-both-sides.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/05-call-solana-from-solidity.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.
