ホームから:別のチェーンからRomeにアクセス
他チェーンのユーザーが、家を離れずにあなたのRomeアプリにアクセスできるようにします — 資産を持ち込み、操作し、また持ち出します。
ユーザーはRomeに移る必要はありません。自分のホームチェーン(ArbitrumやMonadのようなL2、またはSolana)から資産を持ち込み、あなたのRomeアプリを使い、資産を引き出せます。ブリッジはオンチェーンで、ユーザー自身の署名によって承認されます。あなたは1つのAPIを通してアプリを接続するだけです。
仕組み
インバウンド(home → Rome): gasトークンUSDCルートではCCTP経由で、
settle_inbound_bridge_v2Romeプログラムの instruction により、署名済みの EIP-712SettleAuthorizationなので、特権的なセトラーは存在しません。その他のインバウンドルートでは、その instruction や署名は使いません。Wrapper USDC、Wormhole 経由の ETH と SOL は、ラッパートークンとしてユーザーのアカウントに直接着地します。ガストークンが USDC のチェーン上の Solana USDC では、ラッパーをガスに変えるために、ユーザーが署名する追加のトランザクションが1つ必要です。見積もりには、どの署名が必要かが示されます。アウトバウンド(Rome → home):
RomeBridgeWithdraw(inrome-solidity)Rome上で資産をバーンします。ユーザーはその後、自分のトランザクションでホームチェーン上で請求します。輸送: Circle CCTP USDC向けのCCTPと、 Wormhole ETH向けのトークンブリッジです。Solanaのホームチェーンでは、入庫は通常のSPL送金で、出庫はRomeのwithdrawです。WormholeはETH専用のインバウンド経路です。汎用のWormholeルートはアウトバウンド専用で存在しますが、そこで扱う各資産はまずRome運営者によって有効化される必要があります。
オーケストレーション: オフチェーンの
rome-bridge-apiルートを見積もり、ソースチェーンのトランザクションを検証し、settle手数料を負担します。資金も鍵も保持しません。できるのは、ユーザーがすでに署名した内容を実行することだけです。
実装しよう
APIはdevnetで公開されています: https://bridge-api.devnet.romeprotocol.xyz. GET /v1/routes 稼働中のすべてのルート(資産、経路、方向、ソースチェーン、Romeチェーン、速度)を一覧表示します。以下の呼び出しは、SDKが次の4つにラップしているものと同じです。 @rome-protocol/sdk/bridge (requestQuote, registerTransfer, getTransfer, reportStep)。CLIが全体のフローを代行します: rome fund および rome bridge 送金用に、そして rome verify --path from-home 往復用に。詳細は次のページの説明どおりです: Rome CLI ページ。
資産を持ち込む
ルートを見積もる。 ユーザーのソースチェーン、資産、金額、アドレスを送信します。チェーンは CAIP-2 ID として、たとえば
eip155:84532;romeChainIdがあなたのRomeチェーンです。以前の名称ethereumおよびsolanaもまだ受け付けられますが非推奨です。またAPIはそれらのレスポンスにSunsetヘッダーを付けます。完全なリクエストとレスポンスの形は API reference.curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \\ -H 'Content-Type: application/json' \\ -d '{ "asset": "USDC", "direction": "to-rome", "sourceChain": "eip155:84532", "romeChainId": "200010", "amount": "1000000", "sender": { "ethereum": "0xUSER" }, "recipient": "0xUSER" }'金額は文字列のベース単位整数です(
"1000000"は1 USDCです)。ETHの金額は wei で表され、出庫時には 10,000,000,000 wei の倍数でなければなりません(ラッパーは8桁の小数を持ちます)。APIはそれより細かい値を拒否します。レスポンスにはステップが含まれます。ユーザーは、次の印が付いた各ステップのトランザクションに署名しますuserSigns: true、ステップ順に。EVMトランザクションはunsignedTxsにあり、Solanaの instruction はunsignedTxにあります。返されたとおりに正確に署名してください。署名するものが何もないステップは、Circle または Wormhole が送金を attest した時点でスポンサーが実行します。アウトバウンドの claim は例外で、以下で説明するようにユーザーが作成します。ユーザーに署名させます。 CCTPの見積もりでは、それはソースチェーン上の USDC 承認とバーンです。見積もりに
signatureRequestsの項目があれば、ユーザーはその EIP-712 にも署名しますSettleAuthorization。バーンハッシュが分かったらそれを埋め、結果を次のように渡しますuserSettleSigを次の呼び出しへ。これがあるのは gas-token の CCTP ルートだけです。Wormhole ETH、wrapper-intent USDC、Solana ルートにはありません。送金を登録します。
POST /v1/transfers見積もりのquoteIdおよびstep1TxHash、つまり最初のステップ(バーン)の最後のトランザクションのハッシュを、見積もりから15分以内に指定します。gasルートでは、settle署名をuserSettleSigとして追加します。APIは完全な quote オブジェクトを受け付けません。ソースチェーン上のトランザクションが保存済みの見積もりと一致することを確認し、transfer を返しますid.ポーリング
GET /v1/transfers/{id}を数秒ごとに、次の状態になるまで結果がcompleteになり、失敗およびexpiredに対応します。その後、ユーザーはRomeで資金を受け取り、あなたのアプリを使えます。完了した送金にはの劣化を含めることがあるので、degradationReasonを含めることがあるので、ガス残高やラッパー残高が届いたとユーザーに伝える前に確認してください。
Solanaのホームチェーンも、ステップは違いますが同じ構成です。ユーザーはRomeアカウントの token account にSPL送金を行います。SOLはその1回の送金後に wrapped SOL として到着します。Hadrianのように gas token が USDC のチェーンでは、USDC にもう1ステップ必要です。ユーザーが署名する Rome トランザクションで、到着した wrapper をネイティブの gas に変換します。その他のSPLトークンは spl-solana-to-rome ルートを通り、mint を splAsset.
資産を持ち出す
持ち出しは、インバウンドフローを逆向きにしたものではありません。署名は複数あり、ユーザーがホームチェーン上で完了させます。見積もりでは direction を from-rome. sourceChain で、非Rome側を CAIP-2 ID として指定し、バーンはそのチェーンに送られます。 destinationChainId は任意ですが、送信時にはそれと一致している必要があります。以前の名称 ethereum は、今でも Ethereum Sepolia を意味します:
CCTP経由のUSDCでは、見積もりは2ステップを返し、ユーザーは両方に署名します:
Rome上では、順番に2つのトランザクションです。 最初のものは
RomeBridgeWithdrawSolana上のユーザーの wUSDC に対する delegate 権限を付与します(approve_spl)。この付与はバーン額とまったく同じ量を対象とするため、見積もりには毎回含まれ、ユーザーは各バーンの前に署名します。2つ目は、wUSDC をRomeBridgeWithdrawでバーンし、CCTP転送を開始します。送金はバーンのハッシュで登録します。バーンするのは wUSDC で、見積もりではそれがburnTokenと名付けたトークンであり、ネイティブな gas の USDC ではありません。gas として入ってきた資金はバーン対象ではないため、往復させるなら USDC をintent: "wrapper".宛先チェーンでは、claim を行います。 ポーリング
GET /v1/transfers/{id}ステップ2がになるまで。次にそれはmessageアテステーションを運びます。ユーザーはおよびattestationをreceiveMessage(message, attestation)を宛先チェーン上の Circle の message transmitter に対して呼び出します(見積もりには transmitter と CCTP domain が記載されています)。ここはスポンサーされないため、ユーザーはそのチェーン上で gas が必要です。claim のハッシュは次のように報告しますPOST /v1/transfers/{id}/steps/2.
Wormhole経由でRomeから出すETHは、現時点では Hadrian や Rubicon では提供されていません。Hadrian は Rome 向けの ETH over Wormhole のみを掲載しています。Rubicon にはETHルートはありません。
Solanaアドレスへの出庫には claim ステップはありません。USDC は、ユーザーの Solana アカウントへ出庫する1回の Rome トランザクションです。SOL は1つの Rome ステップで、3つのトランザクションからなります。wSOL に対する同じ delegate 付与、Solana上での受取人の wSOL token account の任意作成(すでに存在する場合は省略)、そして RomeBridgeWithdraw.
アウトバウンド送金に activation ステップは不要です。 CCTPのバーンは Solana 上に message account を作成し、そのアカウントには rent が必要です。ブリッジコントラクト自身の Solana アカウントがその rent を支払います。CPI 呼び出しの直前に、コントラクトは swap_gas_to_lamportsを呼び出します。トランザクションの Solana fee payer が lamports を立て替え、ユーザーには同じバーントランザクション内で gas として請求されます。新しいウォレットでも事前設定なしで最初のアウトバウンド送金ができます。 RomeBridgeWithdraw は、現時点で Hadrian と Rubicon のバージョン13.0.0です。アウトバウンドの見積もりには activation や top-up ステップがないため、アプリは最初の見積もりの前にユーザーのアカウントを確認する必要がありません。インバウンド送金にも activation は不要です。 rome CLI(0.11.0)には、まだ独自のチェックがあります。 rome bridge --to (without --dry-run)は、Solana上のユーザーの external-authority アカウントの lamports を読み取ります。15,000,000未満しか持っていない場合、コマンドは停止し、次を実行するよう案内します rome activate <chain>。これは Hadrian 上で 2 USDC を SimpleActivator コントラクトを通じて支払います。 rome verify --path from-home は開始前に同じチェックを行います。コントラクトにはその activation は不要です。
コードを読む
appia — ホームチェーン発のアプリ: ユーザーはホームチェーンから USDC を持ち込み、Rome側の DeFi をそこから出ずに利用します。
rome-bridge-api — オーケストレーター(見積もり → 検証 → スポンサー)。
次は何をするか
資金を用意する — 同じブリッジ経路で、新しい開発用ウォレットに資金を入れます。
Solidityをデプロイ — あなたのアプリをRomeに置きましょう。
最終更新
役に立ちましたか?