> 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/zh/rome-xue-yuan/10-from-other-chains.md).

# 从其他链引入用户和资金

借助桥接、其 API 和 CLI，将用户及其资金从其他链和 Solana 引入你的 Rome 应用，并保持应用界面实时更新。

你的应用同时支持两种钱包类型。现在，用户需要一种方式来访问它。大多数用户在其他链或 Solana 上持有 USDC，他们不应该还得先了解 Rome。本课将使用 Rome Bridge API 从受支持的链转入 USDC、跟踪转账，并让用户将资金转出，同时确保你的应用始终保持最新。 [2. 你可以构建什么](https://docs.rome.builders/zh/rome-xue-yuan/02-what-you-can-build.md) 展示了这在整体流程中的位置。

## 你将学到什么

* 其他链上的用户如何无需离开原有环境，就能访问你的 Rome 应用。
* 用户的 USDC 如何从 EVM 链和 Solana 转入 Rome。
* 转入的资产为何会成为 gas 或 wUSDC，以及如何选择。
* 转入交易的四个步骤。
* 为何离开 Rome 比进入 Rome 要多几个步骤。
* 如何在应用中显示实时状态，以及如何在区块浏览器中查看转账。

## 开始之前

* 完成 [9. 构建双通道应用](https://docs.rome.builders/zh/rome-xue-yuan/09-build-a-dual-lane-app.md)。你需要准备好金库，或任何你希望用户访问的应用。
* 安装 Rome CLI（[Rome CLI + MCP](https://docs.rome.builders/zh/chan-pin/rome-cli.md)).
* 在源链上准备好测试用 USDC，以及用于支付该链手续费的原生代币，可通过 [水龙头](https://docs.rome.builders/zh/zi-yuan/faucets.md).

## 获取

### 步骤 1：了解两种转入方式

使用 Rome Bridge，用户可以从两个地方转入。EVM 链通过 Circle 的 CCTP 发送 USDC。Solana 钱包则通过普通 SPL 转账发送 SOL 或 USDC。无论哪种方式，桥接都在链上进行，并在用户自己的签名授权下完成结算。链下的 Bridge API 会为路由报价、检查源交易并代付结算手续费。它不持有任何资金或密钥，因此只能触发用户已签名授权的操作。

测试网和主网支持的链与资产各不相同，因此请查看列表，不要想当然。列表位于 [Rome Bridge](https://docs.rome.builders/zh/rome-shang-de-ying-yong/bridge-api.md)，实时列表则可通过 API 的 `/v1/routes`查看。关于如何让用户从其常用链访问你的应用，请参阅 [从常用链访问](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/from-home.md).

### 步骤 2：选择 gas 或 wUSDC

通过桥接转入的 USDC 默认会以 gas 的形式到账。MetaMask 用户使用 gas 支付手续费。你的金库接收的代币是 wUSDC。它们是同一 USDC 的两种形式，用户可以在两者之间转换。

在报价中设置意图。像你的金库这样接收 wUSDC 的应用，希望用户以 wUSDC 到账。以 gas 到账的用户需要先包装其中一部分，如第 9 课所示。计划之后再次转出的用户需要 wUSDC，因为桥接转出时销毁的是 wUSDC，而不是 gas。用户可以直接以 wUSDC 到账，也可以之后使用 `withdraw_to_ata`.

### 步骤 3：执行转入交易

转入交易分为四个步骤。SDK 的 `/bridge` 子路径将 API 调用封装为 `requestQuote`, `registerTransfer`, `getTransfer` 和 `reportStep`。其 `registerTransfer` （v0.4.0）仍会提交完整报价，而实时 API 会拒绝这种请求，因此需要像 Rome CLI 那样，使用 `quoteId` 自行注册。

1. 获取路由报价。发送源链、资产、金额、发送方和接收方。链以 CAIP-2 ID 传入，金额则以字符串形式传入，单位为最小面额整数。
2. 用户按顺序为第一步中的交易签名，并严格按照返回的顺序操作。对于 CCTP 转账，这些交易是 USDC 授权和销毁。在 gas 路由中，用户还要签署一份 EIP-712 结算授权；你需要先填入销毁交易的哈希。
3. 注册转账。发送报价中的 `quoteId` 以及销毁交易哈希，作为 `step1TxHash` 到 `POST /v1/transfers` 报价生成后的 15 分钟内。在 gas 路由中，将结算签名作为 `userSettleSig`。API 会检查交易是否与存储的报价相符，并返回转账 ID。
4. 轮询转账，直到 `outcome` 为 `complete`，并处理 `failed` 和 `expired`状态。已完成的转账可能带有 `degradation` 提示，因此在告知用户 gas 或 wUSDC 已到账前，请先检查该提示。

Solana 到账流程的结构相同，但步骤不同。用户会向其 Rome 账户发送 SPL 转账。对于 gas 意图，如果链的 gas 代币是 USDC，用户还需要再发起一笔交易，将包装代币转换为 gas。报价会列出路由所需的所有签名。请求和响应结构： [从本地开始](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/from-home.md#bring-assets-in).

### 第 4 步：先从 CLI 运行

在编写任何桥接代码之前，先用 CLI 跑通整个流程。 `rome fund` 将 USDC 作为 gas 转入， `rome bridge` 接收 gas 或包装代币的意图，而 `rome verify --path from-home` 验证完整往返流程：桥接转入、在 Rome 上执行操作，再桥接转出。这样你就有一个可运行的参考流程，可用于对照你的集成。命令和标志： [Rome CLI + MCP](https://docs.rome.builders/zh/chan-pin/rome-cli.md).

### 第 5 步：处理转出

桥接转出并不是转入流程的反向操作。对于通过 CCTP 转移 USDC，用户需要签署两个步骤。步骤 1 包含两笔 Rome 交易：先授权桥接合约转移本次销毁的确切金额，再执行销毁。使用销毁交易的哈希注册转账。步骤 2 是领取。当转账的步骤 2 显示 `ready`时，其中包含消息和证明，用户需在目标链上调用 `receiveMessage` 并传入这些内容。领取操作不提供任何赞助，因此用户需要在目标链上准备 gas。将领取交易的哈希报告给 API（在 SDK 中使用`reportStep` ）。调用和数据结构： [将资产转出](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/from-home.md#take-assets-back-out).

提现到 Solana 地址无需领取步骤。对于 USDC，只需在 Rome 上执行一笔交易，即可将其提现到用户的 Solana 账户。

授权对你的应用很重要。一个代币账户只能有一个委托人，因此桥接授权会替换包装代币的授权，直到用户再次授权包装代币。正如第 9 课所讲，在下次存款前检查 `isEnabled` 。

### 第 6 步：确保应用持续运行

Rome 端点支持 `eth_subscribe` 订阅 `newHeads` 和 `logs`，并且与 HTTPS RPC 使用同一主机。使用 ethers 时， `provider.on("block")` 和 `contract.on(event)` 其行为与其他地方相同。使用 viem 时， `webSocket` 传输会丢弃 Rome 的数字订阅 ID，因此请传入 `poll: true` 以用于 `watchBlocks` 和 `watchEvent`，或者使用 ethers 获取推送更新。 `newPendingTransactions` 不会发出任何事件，因为 Rome 没有公开的内存池。代码： [WebSocket 订阅](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/websocket-subscriptions.md).

读取历史记录时，请为每次 `eth_getLogs` 调用设置区块范围上限。Rome 的 RPC 会拒绝范围超过约 12,000 个区块的请求。对于涉及 Solana 的交易，Via 的“结算于”行会链接到完成结算的 Solana 交易；Solana 区块浏览器会显示其指令和计算单元数。这样就能回答用户关于转账去向的问题。请参阅 [Via](https://docs.rome.builders/zh/rome-shang-de-ying-yong/via.md) 和 [JSON-RPC 支持](https://docs.rome.builders/zh/can-kao/json-rpc.md).

## Solgate：Solana 资产与 AggLayer EVM 链

[Solgate](https://docs.rome.builders/zh/rome-shang-de-ying-yong/solgate.md) 可在主网和测试网上实现 Solana 资产与 AggLayer EVM 链之间的双向连接。USDC 使用 CCTP。上述步骤使用 Rome Bridge API。

如需转移其他代币或发送消息，请阅读 [13. 在 Solgate 上构建](https://docs.rome.builders/zh/rome-xue-yuan/13-build-on-solgate.md).

## 自测

完成一笔真实转账并观察其过程。

1. 为一个全新的 Hadrian 钱包充值一些用作 gas 的 USDC，然后使用 `rome bridge` 和 wrapper intent 转入更多 USDC。确保留有足够的 gas，用于授权、vault 调用和转出销毁。
2. 读取该钱包在 Hadrian 上的 wUSDC 余额，例如使用 wrapper 的 `rome call` 调用其 `balanceOf`。使用 wrapper intent 时，到账交易是 Solana 上的桥接交易（Circle 的接收消息），而不是 Rome 交易，因此不要指望在 Hadrian 区块浏览器中看到到账交易。
3. 通过 API 重复此转账：获取报价、签名、注册，然后轮询 `GET /v1/transfers/{id}` 直到 `outcome` 显示为 `complete`.
4. 运行 `rome verify hadrian --path from-home` 并指定 `--from` （源链）和 `--amount` （较小的金额，例如 0.2），然后查看结果。大约需要 20 分钟。

然后回答：

* 转出销毁 USDC 时会扣除哪种余额？用户如何获取这种余额？
* 由谁支付目标链上的领取费用？

<details>

<summary>答案</summary>

* wUSDC。作为 gas 到账的 USDC 是另一种余额。用户可以通过 wrapper intent 获取 wUSDC，也可以将部分 gas 代币包装为 wUSDC，方法是使用 `withdraw_to_ata`.
* 用户。领取操作是在目标链上执行的交易，因此用户需要在该链上支付 Gas 费。

</details>

## 下一步

[11. 部署到 Rubicon](https://docs.rome.builders/zh/rome-xue-yuan/11-ship-to-rubicon.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/zh/rome-xue-yuan/10-from-other-chains.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.
