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

# 10. 다른 체인에서 사용자와 자금 가져오기

브리지, API, CLI를 사용해 다른 체인과 Solana에서 사용자와 자금을 Rome 앱으로 가져오고, 앱 화면을 실시간으로 유지하세요.

앱은 두 가지 지갑 유형 모두에서 작동합니다. 이제 사용자가 앱에 들어올 방법이 필요합니다. 대부분 다른 체인이나 Solana에 USDC를 보유하고 있으므로, 먼저 Rome을 익히도록 해서는 안 됩니다. 이 강의에서는 Rome Bridge API를 사용해 지원되는 체인에서 USDC를 가져오고, 전송을 추적하며, 사용자가 자금을 다시 인출할 수 있게 합니다. 앱의 상태도 최신으로 유지합니다. [2. 만들 수 있는 것](https://docs.rome.builders/ko/rome/02-what-you-can-build.md) 이것이 어떤 상황에 해당하는지 보여 줍니다.

## 배울 내용

* 다른 체인의 사용자가 현재 위치를 떠나지 않고 Rome 앱에 도달하는 방법
* 사용자의 USDC가 EVM 체인과 Solana에서 Rome으로 들어오는 방법
* 전송 자금이 가스 또는 wUSDC로 도착하는 이유와 둘 중 하나를 선택하는 방법
* 인바운드 전송의 네 단계
* Rome을 나갈 때 들어올 때보다 단계가 더 많은 이유
* 앱에 실시간 상태를 표시하고 탐색기에서 전송을 확인하는 방법

## 시작하기 전에

* 완료 [9. 듀얼 레인 앱 만들기](https://docs.rome.builders/ko/rome/09-build-a-dual-lane-app.md). 사용자에게 연결할 볼트 또는 앱이 필요합니다.
* Rome CLI를 설치합니다 ([Rome CLI + MCP](https://docs.rome.builders/ko/products/rome-cli.md)).
* 지원 체인에서 테스트용 USDC와 해당 체인의 수수료를 지불할 네이티브 토큰을 준비합니다. 자세한 내용은 다음을 참조하세요:  [수도꼭지](https://docs.rome.builders/ko/resources/faucets.md).

## 강의

### 1단계. 두 가지 인바운드 방식을 이해하기

Rome Bridge를 사용하면 사용자는 두 곳 중 한 곳에서 들어옵니다. EVM 체인에서는 Circle의 CCTP를 통해 USDC를 보냅니다. Solana 지갑에서는 일반 SPL 전송을 통해 SOL 또는 USDC를 보냅니다. 어느 쪽이든 브리지는 온체인에서 작동하며 사용자가 직접 서명한 내용에 따라 정산됩니다. 오프체인 Bridge API는 경로의 견적을 제공하고, 소스 트랜잭션을 확인하며, 정산 수수료를 대신 부담합니다. 자금이나 키를 보유하지 않으므로 사용자가 이미 서명한 작업만 실행할 수 있습니다.

테스트넷과 메인넷은 지원 체인과 자산이 다르므로 추측하지 말고 목록을 확인하세요. 목록은 다음에서 볼 수 있습니다:  [Rome Bridge](https://docs.rome.builders/ko/rome-1/bridge-api.md), 실시간 목록은 API의  `/v1/routes`. 사용자의 홈 체인에서 앱에 도달하는 패턴은  [홈 체인에서](https://docs.rome.builders/ko/developer-guides/from-home.md).

### 2단계. 가스와 wUSDC 중 선택하기

브리지를 통해 도착하는 USDC는 기본적으로 가스로 들어옵니다. MetaMask 사용자는 가스로 수수료를 지불합니다. 볼트에서 받는 토큰은 wUSDC입니다. 둘은 같은 USDC의 두 가지 형태이며, 사용자는 한 형태를 다른 형태로 변환할 수 있습니다.

견적에서 의도를 설정하세요. 볼트처럼 wUSDC를 받는 앱에서는 사용자가 wUSDC로 도착하도록 해야 합니다. 가스로 도착한 사용자는 9강에서처럼 먼저 일부를 래핑합니다. 다시 나갈 계획인 사용자는 wUSDC가 필요합니다. 브리지를 통한 출금에는 가스가 아니라 wUSDC가 소각되기 때문입니다. 사용자는 wUSDC로 도착하거나 나중에 가스 일부를 다음 기능으로 래핑할 수 있습니다:  `withdraw_to_ata`.

### 3단계. 인바운드 전송 실행하기

인바운드 전송은 네 단계로 진행됩니다. SDK의  `/bridge` 하위 경로는 다음 API 호출을 묶어 제공합니다:  `requestQuote`, `registerTransfer`, `getTransfer` 및  `reportStep`입니다. 이 SDK의  `registerTransfer` (v0.4.0)은 여전히 견적 전체를 전송하는데, 라이브 API에서는 이를 거부합니다. 따라서 Rome CLI처럼 직접  `quoteId` 를 사용해 등록하세요.

1. 경로의 견적을 요청합니다. 소스 체인, 자산, 금액, 발신자와 수신자를 전송합니다. 체인은 CAIP-2 ID로 지정하고, 금액은 기본 단위의 정수를 문자열로 지정합니다.
2. 사용자는 반환된 순서와 내용을 그대로 따라 첫 번째 단계의 트랜잭션에 서명합니다. CCTP 전송의 경우 USDC 승인과 소각이 해당됩니다. 가스 경로에서는 소각 해시를 입력한 뒤 EIP-712 정산 승인에도 서명합니다.
3. 전송을 등록합니다. 견적의  `quoteId` 와 소각 해시를  `step1TxHash` 로 `POST /v1/transfers` 견적을 받은 뒤 15분 이내에 호출합니다. 가스 경로에서는 정산 서명을 다음과 같이 추가합니다. `userSettleSig`. API는 트랜잭션이 저장된 견적과 일치하는지 확인하고 전송 ID를 반환합니다.
4. 전송의 `outcome` 이 `complete`가 될 때까지 상태를 확인하고, `failed` 및 `expired`를 처리합니다. 전송이 완료되어도 `degradation` 메모가 포함될 수 있으므로, 사용자에게 가스 또는 wUSDC가 도착했다고 알리기 전에 이를 확인하세요.

Solana 입금도 단계는 다르지만 기본 구조는 같습니다. 사용자가 SPL 전송을 자신의 Rome 계정으로 보냅니다. 가스 인텐트의 경우, 가스 토큰이 USDC인 체인의 USDC를 가스로 바꾸려면 사용자가 트랜잭션을 하나 더 보내야 합니다. 견적에는 경로에 필요한 모든 서명이 나열됩니다. 요청 및 응답 형식: [홈에서 시작](https://docs.rome.builders/ko/developer-guides/from-home.md#bring-assets-in).

### 4단계. 먼저 CLI에서 실행하기

브리지 코드를 작성하기 전에 CLI로 흐름을 실행해 보세요. `rome fund` 는 USDC를 가스로 가져오고, `rome bridge` 는 가스 또는 래퍼 인텐트를 처리하며, `rome verify --path from-home` 는 브리지 인, Rome에서 작업 수행, 브리지 아웃으로 이어지는 전체 왕복 흐름을 검증합니다. 이를 통해 통합 결과를 비교할 수 있는 정상 동작 참고 자료를 얻을 수 있습니다. 명령 및 플래그: [Rome CLI + MCP](https://docs.rome.builders/ko/products/rome-cli.md).

### 5단계. 출금 흐름 처리하기

브리지 아웃은 인바운드 흐름을 역순으로 수행하는 것이 아닙니다. CCTP를 통해 USDC를 전송할 때 사용자는 두 단계를 서명합니다. 1단계는 Rome 트랜잭션 두 개로 구성됩니다. 하나는 브리지 컨트랙트가 이 번의 소각에 필요한 정확한 금액을 이동할 수 있도록 허용하는 권한 부여이고, 다른 하나는 소각입니다. 소각 해시를 사용해 전송을 등록합니다. 2단계는 클레임입니다. 전송의 2단계 상태가 `ready`이면 메시지와 증명이 포함되며, 사용자는 목적지 체인에서 이를 사용해 `receiveMessage` 를 호출합니다. 클레임 과정은 전부 사용자가 부담하므로 목적지 체인에 가스가 필요합니다. 클레임 해시를 API에 보고하세요(SDK에서는`reportStep` ). 호출 및 형식: [자산을 다시 출금하기](https://docs.rome.builders/ko/developer-guides/from-home.md#take-assets-back-out).

Solana 주소로 출금할 때는 클레임 단계가 없습니다. USDC의 경우 사용자의 Solana 계정으로 출금하는 Rome 트랜잭션 한 번이면 됩니다.

권한 부여는 앱에 영향을 줍니다. 토큰 계정에는 위임자가 하나만 있을 수 있으므로 브리지 권한 부여를 하면 사용자가 래퍼에 다시 권한을 부여할 때까지 래퍼의 권한 부여가 대체됩니다. 다음 입금 전에 9과에서 배운 대로 `isEnabled` 를 확인하세요.

### 6단계. 앱을 계속 운영하기

Rome 엔드포인트는 HTTPS RPC와 동일한 호스트에서 `eth_subscribe` 를 사용해 `newHeads` 및 `logs`를 구독할 수 있습니다. ethers에서는 `provider.on("block")` 및 `contract.on(event)` 어디서나 그렇듯 작동합니다. viem에서는 `webSocket` 전송 계층이 Rome의 숫자형 구독 ID를 제거하므로 다음에 `poll: true` 를 전달해 `watchBlocks` 및 `watchEvent`를 사용하거나, 푸시 업데이트에는 ethers를 사용하세요. `newPendingTransactions` 는 Rome에 공개 멤풀(pool)이 없기 때문에 아무것도 내보내지 않습니다. 코드: [WebSocket 구독](https://docs.rome.builders/ko/developer-guides/websocket-subscriptions.md).

기록을 조회할 때는 모든 `eth_getLogs` 호출의 블록 범위를 제한하세요. Rome의 RPC는 약 12,000블록보다 넓은 범위를 거부합니다. Solana를 거치는 트랜잭션의 경우, Via의 "정산 완료" 행에 해당 트랜잭션을 정산한 Solana 트랜잭션 링크가 표시되며, Solana 탐색기에서 명령어와 컴퓨팅 단위를 확인할 수 있습니다. 이를 통해 사용자가 송금 위치를 물었을 때 답변할 수 있습니다. 자세한 내용은 [Via](https://docs.rome.builders/ko/rome-1/via.md) 및 [JSON-RPC 지원](https://docs.rome.builders/ko/reference/json-rpc.md).

## Solgate: Solana 자산 및 AggLayer EVM 체인

[Solgate](https://docs.rome.builders/ko/rome-1/solgate.md) 는 메인넷과 테스트넷에서 Solana 자산을 AggLayer EVM 체인으로, 또 그 반대 방향으로 연결합니다. USDC에는 CCTP를 사용합니다. 위 단계에서는 Rome Bridge API를 사용합니다.

다른 토큰을 옮기거나 메시지를 보내려면 다음을 읽어 보세요. [13. Solgate 기반 구축](https://docs.rome.builders/ko/rome/13-build-on-solgate.md).

## 직접 확인하기

실제 송금 한 건을 진행하고 그 과정을 살펴보세요.

1. 새 Hadrian 지갑에 가스용 USDC를 넣은 다음, `rome bridge` 와 래퍼 인텐트를 사용해 USDC를 더 가져오세요. 승인, 볼트 호출, 출금 소각에 필요한 가스를 충분히 남겨 두세요.
2. 예를 들어 래퍼의 `rome call` 을 사용해 Hadrian에서 지갑의 wUSDC 잔액을 조회하세요. `balanceOf`. 래퍼 인텐트에서는 도착 처리가 Rome 트랜잭션이 아니라 브리지의 Solana 트랜잭션(Circle의 수신 메시지)으로 이루어지므로, 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입니다. 가스용으로 도착한 USDC는 별도의 잔액입니다. 사용자는 래퍼 인텐트를 통해 wUSDC를 얻거나, 가스용 USDC 일부를 래핑해 얻을 수 있습니다. `withdraw_to_ata`.
* 사용자입니다. 클레임은 목적지 체인에서 이루어지는 트랜잭션이므로, 사용자는 해당 체인에서 가스가 필요합니다.

</details>

## 다음

[11. Rubicon으로 전송](https://docs.rome.builders/ko/rome/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/ko/rome/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.
