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

# 홈에서: 다른 체인에서 Rome에 도달하기

다른 체인의 사용자가 집을 떠나지 않고도 Rome 앱에 도달하게 하세요 — 자산을 가져오고, 작업을 수행하고, 다시 내보내세요.

사용자는 Rome으로 이동할 필요가 없습니다. 자신의 홈 체인 — Arbitrum이나 Monad 같은 L2, 또는 Solana — 에서 자산을 가져와 여러분의 Rome 앱을 사용하고, 자산을 다시 꺼냅니다. 브리지는 온체인이며 사용자의 서명으로 승인됩니다. 여러분은 단 하나의 API로 앱을 여기에 연결하면 됩니다.

## 작동 방식

* **유입(홈 → Rome):** 가스 토큰 USDC 경로에서 CCTP를 통해, `settle_inbound_bridge_v2` Rome 프로그램의 instruction이 사용자의 잔액을 적립하며, 서명된 **EIP-712** `SettleAuthorization` 아래에서 처리되므로 특권 셋틀러는 없습니다. 다른 유입 경로들은 그 instruction이나 서명을 사용하지 않습니다. 래퍼 USDC, Wormhole을 통한 ETH, 그리고 SOL은 사용자의 계정에 래퍼 토큰으로 직접 들어옵니다. 가스 토큰이 USDC인 체인의 Solana USDC는 래퍼를 가스로 바꾸기 위해 사용자가 서명하는 한 번의 추가 트랜잭션이 필요합니다. 견적에는 어떤 경로에 어떤 서명이 필요한지가 표시됩니다.
* **유출(Rome → 홈):** `RomeBridgeWithdraw` (in [`rome-solidity`](https://github.com/rome-protocol/rome-solidity))가 Rome에서 자산을 소각합니다. 그런 다음 사용자는 자신의 트랜잭션으로 홈 체인에서 이를 청구합니다.
* **전송:** Circle **CCTP** 는 USDC용, **Wormhole** 은 ETH용 토큰 브리지입니다. Solana 홈 체인은 일반 SPL 전송으로 유입되고 Rome withdraw로 유출됩니다. Wormhole은 ETH에만 쓰이는 유입 경로입니다. 일반적인 Wormhole 경로는 유출 전용으로만 존재하며, 그 위의 각 자산은 먼저 Rome 운영자가 활성화해야 합니다.
* **조정:** 오프체인 [`rome-bridge-api`](https://github.com/rome-protocol/rome-bridge-api) 이 경로를 견적하고, 소스 체인 트랜잭션을 검증하며, 정산 수수료를 대납합니다. 자금도 키도 보유하지 않습니다. 사용자가 이미 서명한 것만 실행할 수 있습니다.

## 구현하기

API는 devnet에서 공개되어 있으며 `https://bridge-api.devnet.romeprotocol.xyz`. `GET /v1/routes` 는 모든 라이브 경로(asset, rail, direction, source chain, Rome chain, speeds)를 나열합니다. 아래 호출은 SDK가 `@rome-protocol/sdk/bridge` (`requestQuote`, `registerTransfer`, `getTransfer`, `reportStep`에서 감싸는 동일한 네 가지입니다. CLI는 전체 흐름을 대신 실행합니다: `rome fund` 그리고 `rome bridge` 는 전송용이고 `rome verify --path from-home` 는 왕복용이며, 다음 페이지에 설명되어 있습니다. [Rome CLI](https://docs.rome.builders/ko/products/rome-cli.md) 페이지.

### 자산을 가져오기

1. **경로를 견적합니다.** 사용자의 소스 체인, 자산, 금액, 주소를 보내세요. 체인은 `eip155:84532`; `와 같은 CAIP-2 id로 들어갑니다.` romeChainId `는 여러분의 Rome 체인입니다. 이전 이름인` 그리고 `ethereum` 와 `solana` 도 여전히 허용되지만 더 이상 권장되지 않으며, API는 해당 응답에 [Sunset](https://github.com/rome-protocol/rome-bridge-api/blob/main/docs/API.md).

   ```bash
    헤더를 표시합니다. 전체 요청 및 응답 형식은
     API reference
     에 있습니다.
       "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이 전송을 증명한 뒤 스폰서가 처리합니다. 예외는 아래에 설명된 유출 청구이며, 이 경우 사용자가 직접 생성합니다.
2. **사용자에게 서명시키기** CCTP 견적의 경우 소스 체인에서 USDC 승인과 소각입니다. 견적에 `signatureRequests` 항목이 있으면 사용자는 그 EIP-712 `SettleAuthorization` 도 소각 해시가 알려진 뒤 서명합니다. 소각 해시를 채워 다음 호출의 `userSettleSig` 로 전달하세요. 가스 토큰 CCTP 경로만 이 항목을 가집니다. Wormhole ETH, 래퍼 의도 USDC, Solana 경로에는 없습니다.
3. **전송 등록하기.** `POST /v1/transfers` 에 견적의 `quoteId` 그리고 `step1TxHash`를 함께 보내세요. 이는 견적 후 15분 이내에 첫 번째 단계(소각)의 마지막 트랜잭션 해시입니다. 가스 경로에서는 정산 서명을 `userSettleSig`로 추가하세요. API는 전체 quote 객체를 받지 않습니다. 소스 체인의 트랜잭션이 저장된 견적과 일치하는지 확인한 뒤 전송 `id`.
4. **폴링하세요** `GET /v1/transfers/{id}` 를 몇 초마다 호출하다가 `결과` 가 `complete`가 되면 처리하고 `실패` 그리고 `expired`도 처리하세요. 그러면 사용자는 Rome에서 자금을 받게 되고 여러분의 앱을 사용할 수 있습니다. 완료된 전송에는 `degradation`  메모와 `degradationReason`가 포함될 수 있으니, 가스 또는 래퍼 잔액이 도착했다고 사용자에게 알리기 전에 확인하세요.

Solana 홈 체인도 같은 구조를 따르지만 단계는 다릅니다. 사용자는 SPL 전송을 자신의 Rome 계정의 토큰 계정으로 보냅니다. SOL은 그 한 번의 전송 후 래핑된 SOL로 도착합니다. Hadrian 같은 가스 토큰이 USDC인 체인에서는 USDC에 두 번째 단계가 필요합니다. 사용자가 서명하는 Rome 트랜잭션으로 도착한 래퍼를 네이티브 가스로 바꾸는 것입니다. 다른 모든 SPL 토큰은 `spl-solana-to-rome`  경로를 거치며, 여기서는 `splAsset`.

### 자산을 다시 꺼내기

유출은 유입 흐름을 거꾸로 실행하는 것이 아닙니다. 서명이 하나 이상 필요하며, 사용자가 홈 체인에서 마무리합니다. 다음으로 견적하세요 `direction` 를 `from-rome`. `로 설정하고` , 소스 체인이 아닌 쪽을 CAIP-2 id로 지정하며, 소각은 그 체인으로 갑니다. `destinationChainId` 는 선택 사항이며, 전달할 경우 이 값과 일치해야 합니다. 이전 이름은 `는 여러분의 Rome 체인입니다. 이전 이름인` 는 여전히 Ethereum Sepolia를 의미합니다:

```bash
 헤더를 표시합니다. 전체 요청 및 응답 형식은
  API reference
  에 있습니다.
    "asset": "USDC",
    "direction": "from-rome",
    "sourceChain": "eip155:84532",
    "destinationChainId": 84532,
    "romeChainId": "200010",
    "amount": "1000000",
    "sender": { "rome": "0xUSER" },
    "recipient": "0xUSER"
  }'
```

CCTP를 통한 USDC의 경우 견적은 두 단계를 반환하며, 사용자는 둘 다 서명합니다:

1. **Rome에서, 순서대로 두 개의 트랜잭션.** 첫 번째는 `RomeBridgeWithdraw` Solana의 사용자의 wUSDC에 대한 대리 권한을 부여합니다(`approve_spl`). 이 권한 부여는 이 소각의 정확한 금액만을 포함하므로, 견적에는 매번 포함되며 사용자는 각 소각 전에 이를 서명합니다. 두 번째는 `RomeBridgeWithdraw`를 통해 wUSDC를 소각하여 CCTP 전송을 시작합니다. 소각 해시로 전송을 등록하세요. 소각은 견적에서 `burnToken`으로 지정한 토큰인 wUSDC를 사용하며, 네이티브 가스 USDC를 사용하지 않습니다. 가스로 들어온 자금이 소각되는 것이 아니므로, 왕복을 하려면 USDC를 `intent: "wrapper"`.
2. **로 가져오세요.** 폴링하세요 `GET /v1/transfers/{id}` 대상 체인에서는 청구가 `ready`가 될 때까지 기다립니다. 그다음 `message` 그리고 `attestation`을 전달합니다. 사용자는 대상 체인의 Circle 메시지 전송자에 대해 `receiveMessage(message, attestation)` 를 호출합니다(견적에는 전송자와 CCTP 도메인이 나와 있습니다). 여기서는 아무도 비용을 대납하지 않으므로, 사용자는 그 체인의 가스가 필요합니다. 청구 해시는 다음으로 보고하세요 `POST /v1/transfers/{id}/steps/2`.

Rome에서 Wormhole을 통한 ETH 유출은 현재 Hadrian이나 Rubicon에서 제공되지 않습니다. Hadrian은 Rome을 향한 Wormhole ETH만 나열합니다. Rubicon에는 ETH 경로가 없습니다.

Solana 주소로의 출금에는 청구 단계가 없습니다. USDC는 Solana 계정으로 출금하는 단일 Rome 트랜잭션입니다. SOL은 세 개의 트랜잭션이 있는 하나의 Rome 단계입니다: wSOL에 대한 동일한 대리 권한 부여, Solana에서 수신자의 wSOL 토큰 계정을 선택적으로 생성하는 단계(이미 존재하면 건너뜀), 그리고 `RomeBridgeWithdraw`.

**유출 전송에는 활성화 단계가 필요하지 않습니다.** CCTP 소각은 Solana에 메시지 계정을 만들며, 그 계정에는 rent가 필요합니다. 브리지 계약 자체의 Solana 계정이 그 rent를 지불합니다. CPI 호출 직전에 계약은 `swap_gas_to_lamports`를 호출합니다. 즉, 트랜잭션의 Solana 수수료 지불자가 lamports를 먼저 지불하고, 사용자는 동일한 소각 트랜잭션에서 가스로 이를 청구받습니다. 새 지갑도 사전 설정 없이 첫 유출 전송을 할 수 있습니다. `RomeBridgeWithdraw` 는 오늘 Hadrian과 Rubicon에서 13.0.0 버전입니다. 유출 견적에는 활성화나 보충 단계가 없으므로, 앱은 첫 견적 전에 사용자의 계정을 확인할 필요가 없습니다. 유입 전송도 활성화가 필요 없습니다.  `rome` CLI(0.11.0)는 여전히 자체 검사를 수행합니다. `rome bridge --to` ( `--dry-run` 없이)는 Solana의 사용자의 외부 권한 계정 lamports를 읽습니다. 15,000,000 미만이면 명령이 중단되고 `rome activate <chain>`를 실행하라고 알립니다. 이는 Hadrian에서 `SimpleActivator`  계약을 통해 2 USDC를 지불합니다. `rome verify --path from-home` 는 시작하기 전에 같은 검사를 수행합니다. 계약은 그 활성화가 필요하지 않습니다.

## 코드 읽기

* [appia](https://github.com/rome-protocol/appia) — from-home 앱: 사용자는 홈 체인에서 USDC를 가져와 Rome 측 DeFi를 벗어나지 않고 사용합니다.
* [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) — 오케스트레이터(견적 → 검증 → 대납).

## 다음 단계

* [자금 조달](https://docs.rome.builders/ko/resources/faucets.md) — 같은 브리지 경로로 새 dev 지갑에 자금을 넣습니다.
* [Solidity 배포](https://docs.rome.builders/ko/developer-guides/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/ko/developer-guides/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.
