> 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/from-home.md).

# ホームから：別のチェーンからRomeにアクセス

他チェーンのユーザーが、家を離れずにあなたのRomeアプリにアクセスできるようにします — 資産を持ち込み、操作し、また持ち出します。

ユーザーはRomeに移る必要はありません。自分のホームチェーン（ArbitrumやMonadのようなL2、またはSolana）から資産を持ち込み、あなたのRomeアプリを使い、資産を引き出せます。ブリッジはオンチェーンで、ユーザー自身の署名によって承認されます。あなたは1つのAPIを通してアプリを接続するだけです。

## 仕組み

* **インバウンド（home → Rome）:** gasトークンUSDCルートではCCTP経由で、 `settle_inbound_bridge_v2` Romeプログラムの instruction により、署名済みの **EIP-712** `SettleAuthorization`なので、特権的なセトラーは存在しません。その他のインバウンドルートでは、その instruction や署名は使いません。Wrapper USDC、Wormhole 経由の ETH と SOL は、ラッパートークンとしてユーザーのアカウントに直接着地します。ガストークンが USDC のチェーン上の Solana USDC では、ラッパーをガスに変えるために、ユーザーが署名する追加のトランザクションが1つ必要です。見積もりには、どの署名が必要かが示されます。
* **アウトバウンド（Rome → home）:** `RomeBridgeWithdraw` (in [`rome-solidity`](https://github.com/rome-protocol/rome-solidity)）Rome上で資産をバーンします。ユーザーはその後、自分のトランザクションでホームチェーン上で請求します。
* **輸送:** Circle **CCTP** USDC向けのCCTPと、 **Wormhole** ETH向けのトークンブリッジです。Solanaのホームチェーンでは、入庫は通常のSPL送金で、出庫はRomeのwithdrawです。WormholeはETH専用のインバウンド経路です。汎用のWormholeルートはアウトバウンド専用で存在しますが、そこで扱う各資産はまずRome運営者によって有効化される必要があります。
* **オーケストレーション:** オフチェーンの [`rome-bridge-api`](https://github.com/rome-protocol/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](https://docs.rome.builders/ja/zhi-pin/rome-cli.md) ページ。

### 資産を持ち込む

1. **ルートを見積もる。** ユーザーのソースチェーン、資産、金額、アドレスを送信します。チェーンは CAIP-2 ID として、たとえば `eip155:84532`; `romeChainId` があなたのRomeチェーンです。以前の名称 `ethereum` および `solana` もまだ受け付けられますが非推奨です。またAPIはそれらのレスポンスに `Sunset` ヘッダーを付けます。完全なリクエストとレスポンスの形は [API reference](https://github.com/rome-protocol/rome-bridge-api/blob/main/docs/API.md).

   ```bash
   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 は例外で、以下で説明するようにユーザーが作成します。
2. **ユーザーに署名させます。** CCTPの見積もりでは、それはソースチェーン上の USDC 承認とバーンです。見積もりに `signatureRequests`の項目があれば、ユーザーはその EIP-712 にも署名します `SettleAuthorization` 。バーンハッシュが分かったらそれを埋め、結果を次のように渡します `userSettleSig` を次の呼び出しへ。これがあるのは gas-token の CCTP ルートだけです。Wormhole ETH、wrapper-intent USDC、Solana ルートにはありません。
3. **送金を登録します。** `POST /v1/transfers` 見積もりの `quoteId` および `step1TxHash`、つまり最初のステップ（バーン）の最後のトランザクションのハッシュを、見積もりから15分以内に指定します。gasルートでは、settle署名を `userSettleSig`として追加します。APIは完全な quote オブジェクトを受け付けません。ソースチェーン上のトランザクションが保存済みの見積もりと一致することを確認し、transfer を返します `id`.
4. **ポーリング** `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 を意味します:

```bash
curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \\
  -H 'Content-Type: application/json' \\
  -d '{
    "asset": "USDC",
    "direction": "from-rome",
    "sourceChain": "eip155:84532",
    "destinationChainId": 84532,
    "romeChainId": "200010",
    "amount": "1000000",
    "sender": { "rome": "0xUSER" },
    "recipient": "0xUSER"
  }'
```

CCTP経由のUSDCでは、見積もりは2ステップを返し、ユーザーは両方に署名します:

1. **Rome上では、順番に2つのトランザクションです。** 最初のものは `RomeBridgeWithdraw` Solana上のユーザーの wUSDC に対する delegate 権限を付与します（`approve_spl`）。この付与はバーン額とまったく同じ量を対象とするため、見積もりには毎回含まれ、ユーザーは各バーンの前に署名します。2つ目は、wUSDC を `RomeBridgeWithdraw`でバーンし、CCTP転送を開始します。送金はバーンのハッシュで登録します。バーンするのは wUSDC で、見積もりではそれが `burnToken`と名付けたトークンであり、ネイティブな gas の USDC ではありません。gas として入ってきた資金はバーン対象ではないため、往復させるなら USDC を `intent: "wrapper"`.
2. **宛先チェーンでは、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](https://github.com/rome-protocol/appia) — ホームチェーン発のアプリ: ユーザーはホームチェーンから USDC を持ち込み、Rome側の DeFi をそこから出ずに利用します。
* [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) — オーケストレーター（見積もり → 検証 → スポンサー）。

## 次は何をするか

* [資金を用意する](https://docs.rome.builders/ja/rissu/faucets.md) — 同じブリッジ経路で、新しい開発用ウォレットに資金を入れます。
* [Solidityをデプロイ](https://docs.rome.builders/ja/gaido/deploy-solidity.md) — あなたのアプリをRomeに置きましょう。


---

# 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/from-home.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.
