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

Solanaユーザーにコントラクトを開放する

Rome(Hadrian testnet、Rubicon mainnet)にSolidityコントラクトをデプロイし、Solanaウォレットに公開する — コントラクトに必要なもの、Solanaウォレット利用者がどう呼び出すか、ネットワークごとのアドレス、および launch ch

1回のデプロイ、2種類のユーザー。Rome上のコントラクトは、MetaMaskユーザーがEVMキーで、Solanaウォレットユーザー(たとえば Solflare)がSolanaキーでアクセスできます。アドレスは同じ、状態も同じです。このページはエンドツーエンドの手順です。デプロイし、コントラクトを Solana 対応にし、アプリに Solana レーンを組み込み、メインネットへ出します。

1. 希望するネットワークにデプロイする

Romeチェーンは標準的なEVMターゲットです。Hardhat、Foundry、viem、ethersは変更なしで動作します(完全な手順は Solidity コントラクトをデプロイする).

ネットワーク
チェーン ID
RPC
エクスプローラー
ガストークン
ガスの入手方法

ルビコン (メインネット)

7531

https://rubicon.mainnet.romeprotocol.xyz/

USDC

Ethereum、Base、Arbitrum、Polygon、Avalanche、Monad、または OP(CCTP)から、あるいは Solana から、次の方法で USDC をブリッジします Rome Bridge。それはガスとして着金します

Hadrian (テストネット)

200010

https://hadrian.testnet.romeprotocol.xyz/

テストUSDC

テストネット(ファウセット)からブリッジするか、または次の中の Solana devnet ウォレットからラップします Rome App

EVM側ではガスは小数18桁のUSDCです。Rubicon や Hadrian には Rome の faucet はありません。書き込みは Ethereum の感覚より多くのガスを消費します。コストの大半は Solana アカウントの作成だからです。未使用の受取人、新しいトークンアカウント、デプロイ済みコントラクトなどです。 eth_estimateGas標準ツールが行うようにそれを使い、21,000 をハードコードしないでください。Hadrian で計測したところ、10バイトのコントラクトのデプロイは見積もりでも実使用でも 1,147,921 gas、未使用アドレスへのネイティブ転送は 1,086,961 gas でした。一方、既存アドレスへの転送は 21,000 です。Rome は実際に使用した gas を請求し、この計測ではそれが見積もりを上回ることはありませんでした。最初のデプロイ前に数 USDC を入れておいてください。後でエクスプローラーでソースを確認します(コントラクトを検証する;メインネットの検証器は https://verify.mainnet.romeprotocol.xyz).

Hadrian で開発し、同じ成果物を chain id とメインネットのラッパーアドレスを入れ替えて Rubicon に再デプロイします。ネットワーク間でコントラクト自体は変わりません。Rubicon は v0.3.0 以降で公開レジストリにありますが、 create-rome-app および rome-cli 依然として registry v0.2.0 に固定しているツールには Rubicon の項目がないため、対象にできません。そうしたツールでは、次の値を手で入力してください ルビコン。Rubicon のガスは実際の USDC で、Hadrian のガス価格のおよそ10倍なので、デプロイにはそこで実費がかかります。

2. コントラクトを Solana 対応にするもの

Solana ユーザーの EVM 識別子は次のものです 合成アドレス, keccak256(solana_pubkey)[12:]:通常の msg.sender、通常の nonce を持つものです。ほとんどのコントラクトはまったく変更不要です。重要なのは次の3点です。

  • 価値は ERC-20 として受け取り、 msg.value. Solana ユーザーの資金はウォレット内の SPL トークンであり、EVM 側ではそのトークンのラッパー(wUSDC, wETH, wSOL)として見えます。synthetic は静止時には何も保持せず、ユーザー資産はラッパーとして届くので、次のように引き出し、 transferFrom の後に approve 次のように返却します transfer。各ユーザーは最初の引き出し前に一度だけ、ラッパーに SPL のデリゲート権を付与します(を HelperProgram に送るよう求めてください。これはラッパーが想定する最大付与と同じです()。 payable エントリポイントは、synthetic にネイティブガスが付与された後でのみ機能します(リレーパスの rome_composeExternalDepositV1)、そして fund-and-sweep モデルではそれを行いません。既存の ERC-20 Vault、AMM、またはレンディング市場は、すでに適切な形をしています。

  • 正規のラッパーを使ってください。 各チェーンには mint ごとに1つのラッパーがあり、アドレスは Contract Addresses (Hadrian のものも公開 registryレジストリにもあります)。コンストラクタはそれらのアドレスを指すようにし、自前でデプロイしないでください。

  • ウォレットが署名する場所でアトミックな予算に収めてください。 Solana ウォレットは1回の Solana トランザクションに署名するため、Solana レーンの呼び出しはそれに収まる必要があります。目安は約 140万 compute unit、64 アカウント、4 KB(制約)です。Hadrian で計測したところ、転送、approve、Aave の supply は収まりました。Uniswap V3 の swap も余裕は少ないものの収まります(約 124万 CU)。Aave の borrow は収まらず、次のセクションのリレーパスを使います。Solana レシートの computeUnitsConsumedを使って計測し、トランザクションの要求時に maxSupportedTransactionVersion: 1 (Rome のレッグは v1 トランザクションです。これがないと RPC は要求を拒否します)。

不要なもの: Solana プログラム、ブリッジ、2回目のデプロイ、Rome 専用の Solidity は不要です。コントラクトが precompile を通じて Solana プログラムも呼び出す場合は、 EVM から Solana を呼び出す.

3. Solana ウォレットに呼び出させる

アプリの EVM パスは変わりません(MetaMask + submitRomeTx、または通常の viem/ethers)。Solana パスには2つの形があります。

SDK レーン — 1回の呼び出しにつき Solana v1 トランザクション1つ。 @rome-protocol/sdk (submitRomeTxV1) では、プロキシがあなたの EVM 呼び出しに対して Solana v1 トランザクションを1つ組み立てます(最大64アカウント、4 KB、アドレスルックアップテーブルなし。コード内に ComputeBudget 命令、treasure wallet、アカウント探索はありません)。ウォレットは同じ鍵で2回署名します。まず可読な認可メッセージ(Rome認可 1行目に 0x と、次の行に EVM トランザクションハッシュを載せます)。これをチェーンは Ed25519 プログラム経由で検証し、その後トランザクションを検証します。アプリは署名済みトランザクションを Solana RPC に送信し、呼び出しは EVM トランザクションハッシュとそのレシートを返します。ウォレットがトランザクションに署名する前に、SDK はそれを検査します。payer が唯一の署名者であり、Rome プログラムと Ed25519 検証器のみが実行され、Rome 命令にはユーザーが認可した呼び出しがそのまま含まれ、priority fee はありません。それ以外は拒否されます。

呼び出しが1つのトランザクションに収まらない場合、composer はそれを拒否し、SDK は同じ認可署名のままプロキシに渡してリレーさせるため、ユーザーには依然として1回の認可プロンプトしか表示されません。その結果は route: "relay"。リレーされた呼び出しと長い呼び出しのルールは 中継呼び出しと長い呼び出しにあります。リレーされた呼び出しはチェーンのネイティブガスで支払われるため、synthetic にはガス残高が必要です。 fundSyntheticGas(deps, amountWei) ウォレットのトークンアカウントからチェーンのガストークン(Hadrian と Rubicon では USDC)を、その中へ移します。1回のウォレット署名付き v1 トランザクションです。

fund レッグ(buildFundLeg)と、sweep 前のウォレットのトークンアカウント作成は、通常の Solana 命令です。 submitSolanaInstructionsV1 それらも v1 トランザクションとして送信し、同じウォレット署名者が署名し、プロキシは関与しません。sweep 自体の呼び出し(buildSweepLeg, HelperProgram.transfer_splは submitRomeTxV1 他と同様に処理され、プロキシがトークンアカウントを見つけます。 submitRomeTxV1 は、新しい synthetic のアカウントを自動では作成しません。最初の価値移動呼び出しの前に、 isSyntheticProvisioned(...) を確認し、false なら buildCreatePdaCall(synthetic) を経由して submitRomeTxV1 を1回送信してください。コード付きの完全な deposit-and-withdraw 手順は デュアルレーンアプリを作る;その仕組みは Solana から EVM を呼び出す. 以前の submitRomeTxSolanaLaneにあり、クライアント側で legacy Solana transaction を構築するもので、SDK には旧来のパスとしてまだ残っています。

各 依存関係 値の出どころ。 SDK の 依存関係 オブジェクトには必須フィールドが5つあります(残り、たとえば fetchImpl や timeout は任意です)。4つはチェーンから、1つはウォレットから来ます。

依存関係 フィールド

由来

レジストリ取得元(@rome-protocol/registry v0.2.0

proxyUrl

チェーンの RPC URL

getChain(chainId).rpcUrl

chainId

チェーン ID

getChain(chainId).chainId

programId

チェーンが実行する Rome の program ID

getChain(chainId).romeEvmProgramId

接続については

チェーンのクラスタ用の Solana RPC で、署名済みトランザクションが送信されます(Hadrian は devnet、Rubicon は mainnet)

getChain(chainId).solana.rpc (Hadrian 用の公開 devnet URL)。メインネットでは自分の RPC を使ってください

signer

ウォレットの LaneSigner、または Keypair スクリプト内では

なし

レッグビルダーが受け取る値は、次の場所にはありません 依存関係。それらの mint (次のように呼ばれます usdcMint (手順では usdcMint と呼びます)は、ガストークンの Solana mint で、 getTokens(chainId) (次のエントリです kind: "gas"、フィールド mintId)。wUSDC ラッパーアドレスはレッグビルダーの入力ではありません。ERC-20 呼び出しで使うもので、次のエントリです kind: "spl_wrapper" と symbol wUSDC (フィールド address)。レジストリは Hadrian と、v0.3.0 以降の Rubicon をカバーします。代わりに Rubicon の値を手で埋めるには次のとおりです。 proxyUrl https://rubicon.mainnet.romeprotocol.xyz/, chainId 7531, programId RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX, mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v、次のセクションの表にあるラッパー、および Solana mainnet RPC を 接続については. ルビコン には完全な一覧があります。

プロキシの external-V1 エンドポイント — SDK なしの同じレーン。 SDK は、atomic compose、relay、gas deposit(fundSyntheticGas)をラップします。生の RPC メソッドは SDK を使わないクライアント向けに残されており、SDK がラップしない iterative compose も含まれます。ウォレットは呼び出しに対して1つの Ed25519 メッセージに署名します(読みやすい形式は Rome 認可\n0x<hash> または生のハッシュ)で、プロキシはウォレットに署名させるための Solana トランザクション群を組み立てるか(rome_composeUnsignedAtomicV1, rome_composeUnsignedIterativeV1 + rome_submitSignedV1Plan)、あるいはウォレットの署名1回で実行全体を行います(rome_relayUnsignedV1、その後 rome_composeExternalDepositV1 (SDK の fundSyntheticGas)で synthetic のガス残高を補充します。リレーされた呼び出しはそこから消費するので、残高が少なくなったら補充してください)。メソッドの形は JSON-RPCサポート;認可ルールは Solana から EVM を呼び出すにあります。反復的なものには relay を使い、収まるものには SDK レーンを使ってください。

どちらの場合でも、コントラクトには synthetic アドレスからの通常のトランザクションが見え、ユーザーが EVM キーを保持することはありません。

4. ネットワークごとのラッパーアドレス

ネットワーク

wUSDC ラッパー

他のラッパー

Rubicon (7531)

0x0952d233b0c254cd375f3bfb3e5869c1a906f9b3

wETH 0x01e8b3573da1d4b7b4b1ce0932cf07c8af0c92e9, wSOL 0xc4e29e0f726a906e93277cbbc37bf27a9848a113

Hadrian (200010)

0xbce339ba4c3a8de3bb8af1c5539e6ac11da3112d

wETH 0x02aeace038269f9961c93d04dcacd6fb3adfa55f, wSOL 0x39f36444fcb79b3e691544aee2a832ebef54ca9f

ネイティブのガストークンは次のように表示されます 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee トークンリストではそう表示されます。これは ERC-20 コントラクトではありません。ラッパーは SPL mint の小数桁を持ち、18 ではありません。wUSDC は 6、wETH は 8、wSOL は 9 です。

5. リリース前チェックリスト

  1. Hadrian にデプロイ済み。EVM パスは MetaMask から動作します。

  2. 価値を動かすすべてのエントリポイントは ERC-20 ベースで、チェーンの正規ラッパーを指しています。

  3. v1 トランザクションに署名できる Solana ウォレット(現在 devnet では Solflare が対応、Phantom はまだ未対応)が、Hadrian で完全な往復を完了します。synthetic を準備し(create_pda、1回だけ)→ fund レッグ → grant → approve → call → sweep レッグを SDK レーンで実行します。呼び出しが反復的なら relay パスを使います。

  4. 各 Solana レーン呼び出しの computeUnitsConsumed は Solana レシートから読み取られ、アトミック予算内に収まります。そうでなければ、その呼び出しは relay に振り分けられます。

  5. ラッパーの grant は、どちらのレーンでもアプリの初回入金フローにあります。 isEnabled(user) が確認され、 approve_spl が false のときに1回送信されます(を HelperProgram に送るよう求めてください。これはラッパーが想定する最大付与と同じです().

  6. ソースがエクスプローラで検証済みである。

  7. メインネットのラッパーアドレスで Rubicon に再デプロイ済み。その 依存関係 値はレジストリ(v0.3.0 以降)から、または手動で次から取得します ルビコン。同じ往復を実資金で1回実行し、事前に確認したウォレットを使ってメインネットで v1 トランザクションに署名します。

次は何をするか

最終更新

役に立ちましたか?