For the complete documentation index, see llms.txt. This page is also available as Markdown.

EVMからSolanaを呼ぶ

RomeのCPIとヘルパーprecompileを使って、SolidityからSolanaプログラムを呼び出します。

Rome の precompile は、Solidity コントラクトが Solana プログラムを直接呼び出せるようにします。このガイドではその仕組みを説明します。

前提条件

各インターフェースをそれぞれの precompile アドレスにバインドします:

import {ICrossProgramInvocation, ISystemProgram, IHelperProgram}
    from "@rome-protocol/rome-solidity/contracts/interface.sol";

ICrossProgramInvocation constant CpiProgram    = ICrossProgramInvocation(0xFF00000000000000000000000000000000000008);
ISystemProgram          constant SystemProgram = ISystemProgram(0xFF00000000000000000000000000000000000007);
IHelperProgram          constant Helper        = IHelperProgram(0xFF00000000000000000000000000000000000009);

CpiProgram precompile は

CpiProgram (0xFF…08) は CPI(invoke / invoke_signed) に加え、クロス状態読み取りショートカット(account_info, account_data_at, account_u64_at, account_lamports, pdas_batch_derive):

// Solana プログラムを呼び出す
CpiProgram.invoke(programId, accounts, instructionData);

// PDA 署名で呼び出す: あなたのコントラクトの外部権限 PDA が署名し、さらに
// `salts` の各エントリごとに salt 付きの sub-PDA を 1 つずつ使用します(Rome は ["EXTERNAL_AUTHORITY", contract, salt] を導出します)
CpiProgram.invoke_signed(programId, accounts, data, salts);

lamportsを送金する

単純な lamport と SPL の送金には、HelperProgram precompile を使います — 手作業で CPI を組み立てる必要はありません。これを呼び出すコントラクトは それ自身として: 以下の送金はコントラクト自身の lamports とトークン(その外部権限 PDA が署名します)を移動するのであり、ユーザーのものではありません。コントラクトがユーザーの SPL トークンを自分が管理するトークンアカウントへ引き出し、その所有者を知るには、ユーザーが SPL デリゲーションを付与します。ERC-20 transfer または transferFrom をコントラクトへ送っても、ラッパーのエスクロー台帳に記録されるだけで、コントラクトに支出元のトークンアカウントは与えられません — 参照 Solana プログラムを統合する.

transfer_spl にはいくつかのオーバーロードがあります( transferFrom フロー用のデリゲート版を含む); interface.sol. キャッシュ済みトラックでは、代わりに ISplCached (0xff…05) / IAssociatedSplCached (0xff…06) を使ってください — コントラクトは一貫して 1 つのトラックを使い、レガシートラックだけが invoke カスタムプログラムを使用できます(参照 Solana プログラムを統合する).

アカウントデータの読み取り

CpiProgram の読み取りショートカットを使って、任意の Solana アカウントのデータを読み取れます:

PDAの導出

System precompile を使って Solidity から Program Derived Address を見つけます:

Base58 変換

相互変換します bytes32 と base58(Solana のアドレス形式)の間で:

カスタムSolanaプログラムの呼び出し

任意の Solana プログラムを呼び出すには、アカウント一覧と instruction data を自分で構築します:

主な制約

  1. すべてのアカウントは事前に宣言しなければなりません。 Solana トランザクションには、CPI が触れるすべてのアカウントを含める必要があります — CPI 内で動的にアカウントを見つけることはできません。

  2. CPI の深さ制限: 4 レベル。 Rome EVM → 対象 → 対象の呼び出し → さらに 1 段。呼び出し深度を計画してください。

  3. Solana の pubkey は bytes32, 20 バイトの Ethereum アドレスではありません。

  4. instruction data は生のバイト列です 対象プログラムが期待する形式(通常は Borsh、リトルエンディアン)である必要があります。

次は何か

  • 実際のアプリで見る — cardo ユーザーのウォレットから直接 precompile に CPI 呼び出しを送り、アダプタコントラクトは使いません; rome-dex (dual-lane AMM)も同様で、さらにカストディ不要のルーターコントラクトもあります; aerarium は、Solidity から Solana プログラムを呼び出さないレンディングアプリです。

  • Solana プログラムを統合する — ユーザーの Solana アイデンティティ、それとして署名すること、1 トラックのルール、そして向こう側の実際のプログラムに対するアカウント準備

  • プリコンパイルリファレンス — すべての precompile のすべてのセレクタ

  • Solana から EVM を呼び出す — 逆方向: Solana ウォレットから EVM コントラクトを操作する

  • トークン相互運用 — ERC-20 と SPL トークンがどう連携するか

  • 制約 — CPI の深さとその他の制限

最終更新

役に立ちましたか?