> 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/ru/rukovodstva-dlya-razrabotchikov/from-home.md).

# Из дома: доберитесь до Rome из другой цепочки

Позвольте пользователям из другой цепочки получать доступ к вашему приложению Rome, не покидая «дом» — вводите активы, выполняйте действия, затем выводите их обратно.

Вашим пользователям не нужно переходить в Rome. Со своей домашней сети — L2 вроде Arbitrum или Monad, либо Solana — они заводят активы, используют ваше приложение на Rome и выводят активы обратно. Мост работает on-chain и авторизуется собственной подписью пользователя; вы подключаете приложение к нему через один API.

## Как это работает

* **Входящий поток (домашняя сеть → Rome):** в маршруте USDC с газовым токеном через CCTP, `settle_inbound_bridge_v2` инструкция программы Rome зачисляет средства пользователю на основании подписанного **EIP-712** `SettleAuthorization` — поэтому привилегированного сеттлера нет. В остальных входящих маршрутах не используются ни эта инструкция, ни эта подпись. Wrapper USDC, ETH через Wormhole и SOL поступают напрямую как обёрнутый токен на счёт пользователя. Для Solana USDC в сети, где газовый токен — USDC, требуется ещё одна транзакция, подписанная пользователем, чтобы преобразовать wrapper в газ. Квота подсказывает, какие подписи нужны для маршрута.
* **Исходящий поток (Rome → домашняя сеть):** `RomeBridgeWithdraw` (в [`rome-solidity`](https://github.com/rome-protocol/rome-solidity)) сжигает актив в Rome. Затем пользователь получает его в домашней сети собственной транзакцией.
* **Транспорт:** Circle **CCTP** для USDC, а **Wormhole** мост токенов для ETH. Домашние сети Solana используют обычные SPL-переводы на вход и вывод через Rome на выход. 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` перечисляет все активные маршруты (актив, канал, направление, исходная сеть, сеть Rome, скорости). Ниже приведены те же четыре вызова, которые 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/ru/produkty/rome-cli.md) .

### Завести активы

1. **Получите квоту на маршрут.** Передайте исходную сеть пользователя, актив, сумму и адреса. Сети указываются как идентификаторы CAIP-2, например `eip155:84532`; `romeChainId` — это ваша сеть Rome. Старые названия `ethereum` и `solana` по-прежнему принимаются, но считаются устаревшими, и API помечает такие ответы заголовком `Sunset` заголовок Sunset. Полные структуры запроса и ответа приведены в [справочнике API](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 (у wrapper 8 знаков после запятой); API отклоняет более мелкие значения. Ответ перечисляет `шаги`. `userSigns: true`в порядке шагов: EVM-транзакции находятся в `unsignedTxs`, инструкции Solana — в `unsignedTx`. Подписывайте их ровно в том виде, в каком они возвращены. Шаги, где нечего подписывать, выполняются спонсором после того, как Circle или Wormhole подтвердит перевод. Исключение — получение на выходе, описанное ниже: его собирает пользователь.
2. **Попросите пользователя подписать.** Для квоты CCTP это одобрение USDC и сжигание в исходной сети. Если в квоте есть запись в `signatureRequests`, пользователь также подписывает этот EIP-712 `SettleAuthorization` после того как станет известен хэш сжигания; подставьте хэш сжигания и передайте результат как `userSettleSig` в следующем вызове. Такой шаг есть только у маршрута CCTP с газовым токеном. У маршрутов Wormhole ETH, wrapper-intent USDC и Solana его нет.
3. **Зарегистрируйте перевод.** `POST /v1/transfers` с `quoteId` и `step1TxHash`— хэш последней транзакции в первом шаге (сжигании), в течение 15 минут после получения квоты. В маршруте с газом добавьте подпись сеттла как `userSettleSig`. API не принимает полный объект квоты. Он проверяет, что транзакция в исходной сети соответствует сохранённой квоте, и возвращает идентификатор перевода `id`.
4. **Опросите** `GET /v1/transfers/{id}` каждые несколько секунд, пока не `результат` равен `завершён`и обработайте `неуспешный` и `истёкший`. `ухудшение` заметку с `degradationReason`, поэтому проверьте их, прежде чем сообщать пользователю, что баланс газа или wrapper поступил.

Домашние сети Solana следуют той же схеме, но с другими шагами. Пользователь отправляет SPL-перевод на токен-аккаунт своего аккаунта Rome. После этой одной транзакции SOL поступает как wrapped SOL. В сети, где газовый токен — USDC, например в Hadrian, для USDC нужен второй шаг: транзакция в Rome, которую подписывает пользователь и которая преобразует поступивший wrapper в нативный газ. Любой другой SPL-токен проходит через `spl-solana-to-rome` маршрут, который принимает mint в `splAsset`.

### Вывести активы обратно

Исходящий мост — это не просто обратный входящий поток. Он требует более одной подписи, и пользователь завершает его в домашней сети. Получите для него квоту с `direction` установленным в `from-rome`. `sourceChain` задаёт сторону, не относящуюся к Rome, как идентификатор CAIP-2, а сжигание направляется в эту сеть. `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"
  }'
```

Для USDC через CCTP квота возвращает два шага, и пользователь подписывает оба:

1. **В Rome — две транзакции по порядку.** Первая предоставляет `RomeBridgeWithdraw` права делегирования над wUSDC пользователя в Solana (`approve_spl`). Разрешение покрывает ровно сумму этого сжигания, поэтому квота включает его каждый раз, и пользователь подписывает его перед каждым сжиганием. Вторая транзакция сжигает wUSDC через `RomeBridgeWithdraw`что запускает перевод CCTP. Зарегистрируйте перевод с хэшем сжигания. При сжигании расходуется wUSDC — токен, который в квоте указан как `burnToken`, а не нативный газовый USDC. Поступившие как газ средства не сжигаются, поэтому для кругового маршрута заводите USDC с `intent: "wrapper"`.
2. **В сети назначения — получение.** Опросите `GET /v1/transfers/{id}` пока шаг 2 не станет `готов`. Затем он содержит `сообщение` и `аттестацию`. Пользователь вызывает `receiveMessage(message, attestation)` в передатчике сообщений Circle в сети назначения (в квоте указаны передатчик и домен CCTP). Здесь ничего не спонсируется, поэтому пользователю нужен газ в этой сети. Сообщите хэш получения с `POST /v1/transfers/{id}/steps/2`.

Вывод ETH из Rome через Wormhole на данный момент не предлагается ни в Hadrian, ни в Rubicon. В Hadrian маршрут ETH через Wormhole доступен только в сторону Rome. В Rubicon маршрутов для ETH нет.

Вывод на адрес Solana не требует шага получения. USDC — это одна транзакция в Rome, которая выводит средства на Solana-аккаунт пользователя. SOL — это один шаг в Rome с тремя транзакциями: то же самое предоставление делегирования над wSOL, необязательное создание wSOL token account получателя в Solana (пропускается, если он уже существует), и вывод через `RomeBridgeWithdraw`.

**Исходящие переводы не требуют шага активации.** Сжигание CCTP создаёт account сообщения в Solana, и этому account требуется rent. Собственный Solana-аккаунт bridge-контракта оплачивает этот rent. Непосредственно перед своим CPI-вызовом контракт вызывает `swap_gas_to_lamports`: плательщик комиссии Solana в транзакции авансирует лампорты, а пользователю они списываются в газе в той же транзакции сжигания. Новый кошелёк может выполнить свой первый исходящий перевод без какой-либо предварительной настройки. `RomeBridgeWithdraw` сегодня имеет версию 13.0.0 в Hadrian и Rubicon. Исходящие квоты не содержат шага активации или пополнения, поэтому вашему приложению не нужно проверять аккаунт пользователя перед первой квотой. Входящие переводы тоже не требуют активации. The `Rome` CLI (0.11.0) по-прежнему выполняет собственную проверку. `rome bridge --to` (без `--dry-run`) считывает лампорты аккаунта с внешним правом доступа пользователя в Solana. Если там меньше 15 000 000, команда останавливается и предлагает выполнить `rome activate <chain>`, которая оплачивает 2 USDC в Hadrian через `SimpleActivator` контракт. `rome verify --path from-home` выполняет такую же проверку перед запуском. Контракт не нуждается в этой активации.

## Изучите код

* [appia](https://github.com/rome-protocol/appia) — приложение from-home: пользователи заводят USDC из своей домашней сети и используют DeFi на стороне Rome, не покидая её.
* [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) — оркестратор (квота → проверка → спонсирование).

## Что дальше

* [Получение средств](https://docs.rome.builders/ru/resursy/faucets.md) — тот же маршрут моста пополняет новый dev-кошелёк.
* [Разверните Solidity](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/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/ru/rukovodstva-dlya-razrabotchikov/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.
