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

# 10. Приведите пользователей и средства из других цепочек

Переносите пользователей и их средства в ваше приложение Rome из других сетей и из Solana с помощью моста, его API и CLI, сохраняя экран приложения в актуальном состоянии.

Ваше приложение работает с обоими типами кошельков. Теперь пользователям нужно дать возможность попасть в него. У большинства USDC хранится в другой сети или в Solana, и им не нужно сначала изучать Rome. В этом уроке используется API Rome Bridge, чтобы перевести USDC из поддерживаемой сети, отслеживать перевод и дать пользователям возможность вывести средства обратно, пока ваше приложение остаётся актуальным. [2. Что можно создать](https://docs.rome.builders/ru/rome-academy/02-what-you-can-build.md) показывает, как это вписывается в общую картину.

## Чему вы научитесь

* Как пользователю из другой сети попасть в ваше приложение Rome, не покидая привычную среду.
* Как USDC пользователя попадает в Rome из EVM-сети и из Solana.
* Почему перевод поступает в виде газа или wUSDC и как выбрать нужный вариант.
* Четыре шага входящего перевода.
* Почему для вывода из Rome требуется больше шагов, чем для ввода.
* Как показывать актуальное состояние в приложении и проверять перевод в обозревателе.

## Перед началом

* Завершите [9. Создайте приложение с двумя маршрутами](https://docs.rome.builders/ru/rome-academy/09-build-a-dual-lane-app.md). Вам понадобится хранилище или любое другое приложение, в которое должны попадать пользователи.
* Установите Rome CLI ([Rome CLI + MCP](https://docs.rome.builders/ru/produkty/rome-cli.md)).
* Получите тестовые USDC в исходной сети и нативный токен этой сети для оплаты комиссии — воспользуйтесь разделом [Краны](https://docs.rome.builders/ru/resursy/faucets.md).

## Урок

### Шаг 1. Разберитесь в двух способах перевода средств

Через Rome Bridge пользователи могут прийти из одного из двух источников. Из EVM-сети USDC переводятся через CCTP от Circle. С кошелька Solana переводятся SOL или USDC с помощью обычных SPL-переводов. В обоих случаях перевод выполняется ончейн и подтверждается личной подписью пользователя. Внешний API Bridge рассчитывает маршрут, проверяет исходную транзакцию и оплачивает комиссию за расчёт. Он не хранит средства или ключи, поэтому может лишь инициировать операцию, уже подписанную пользователем.

Поддерживаемые сети и активы для тестовой и основной сетей различаются, поэтому сверяйтесь со списками, а не делайте предположений. Они доступны на странице [Rome Bridge](https://docs.rome.builders/ru/prilozheniya-v-rome/bridge-api.md), а актуальный список можно получить через API, выполнив запрос к `/v1/routes`. О том, как дать пользователю попасть в ваше приложение из его исходной сети, читайте в уроке [Из привычной сети](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/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`. В версии `registerTransfer` (v0.4.0) по-прежнему отправляется вся котировка, но действующий API отклоняет такой запрос. Поэтому зарегистрируйте перевод самостоятельно, указав `quoteId` , как это делает Rome CLI.

1. Рассчитайте маршрут. Укажите исходную сеть, актив, сумму, отправителя и получателя. Идентификаторы сетей передаются в формате CAIP-2, а суммы — в виде целых чисел в минимальных единицах, записанных строками.
2. Пользователь подписывает транзакции первого шага в указанном порядке, точно в том виде, в котором они возвращены. Для перевода через CCTP это подтверждение USDC и их сжигание. В маршруте с газом пользователь также подписывает одну авторизацию расчёта EIP-712 после того, как вы укажете хеш транзакции сжигания.
3. Зарегистрируйте перевод. Передайте `quoteId` из котировки и хеш транзакции сжигания в поле `step1TxHash` на `POST /v1/transfers` в течение 15 минут после получения котировки. Для маршрута с оплатой газа добавьте подпись подтверждения расчёта в поле `userSettleSig`. API проверяет, соответствует ли транзакция сохранённой котировке, и возвращает идентификатор перевода.
4. Отслеживайте перевод, пока `outcome` не примет значение `complete`, а для значений `failed` и `expired`предусмотрите обработку ошибок. У завершённого перевода может быть примечание `degradation` , поэтому проверьте его, прежде чем сообщать пользователю о поступлении газа или wUSDC.

Поступление средств в Solana устроено так же, но включает другие шаги. Пользователь отправляет SPL-перевод на свой аккаунт Rome. Для намерения с оплатой газа, если токен газа в сети — USDC, пользователю нужно выполнить ещё одну транзакцию, чтобы преобразовать обёрнутый токен в газ. В котировке перечислены все подписи, необходимые для маршрута. Форматы запросов и ответов: [Из домашней сети](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/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/ru/produkty/rome-cli.md).

### Шаг 5. Обработайте вывод средств

Вывод средств через мост — это не обратный процесс ввода. Для перевода USDC через CCTP пользователь подписывает два шага. Шаг 1 — две транзакции в Rome: разрешение, позволяющее контракту моста переместить точную сумму для сжигания, а затем сама операция сжигания. Зарегистрируйте перевод, указав хеш операции сжигания. Шаг 2 — получение средств. Когда для шага 2 перевода указано значение `ready`, в ответе содержатся сообщение и аттестация. Пользователь вызывает `receiveMessage` с этими данными в целевой сети. Получение средств не спонсируется, поэтому пользователю потребуется газ в этой сети. Передайте API хеш операции получения средств (`reportStep` в SDK). Вызовы и форматы: [Выведите активы обратно](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/from-home.md#take-assets-back-out).

Для вывода на адрес Solana шаг получения средств не нужен. Чтобы вывести USDC, достаточно одной транзакции в Rome, которая переводит средства на аккаунт пользователя в Solana.

Разрешение важно для вашего приложения. У токен-аккаунта может быть только один делегат, поэтому разрешение для моста заменяет разрешение для обёрнутого токена, пока пользователь не выдаст его повторно. Перед следующим депозитом проверьте `isEnabled` , как объяснялось в уроке 9.

### Шаг 6. Обеспечьте работу приложения

Конечные точки Rome поддерживают `eth_subscribe` для подписок на `newHeads` и `logs`, на том же хосте, что и HTTPS RPC. В ethers используйте `provider.on("block")` и `contract.on(event)` работают так же, как и везде. В viem `webSocket` транспорт отбрасывает числовые идентификаторы подписок Rome, поэтому передавайте `poll: true` в `watchBlocks` и `watchEvent`, либо используйте ethers для получения обновлений push-уведомлениями. `newPendingTransactions` никогда не выдает события, поскольку в Rome нет публичного мемпула. Код: [Подписки WebSocket](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/websocket-subscriptions.md).

При чтении истории ограничивайте диапазон блоков в каждом вызове `eth_getLogs` RPC Rome отклоняет диапазон шире примерно 12 000 блоков. Если транзакция затрагивает Solana, строка Via «Завершено в» содержит ссылку на транзакцию Solana, которая завершила ее, а в обозревателе Solana можно посмотреть инструкции и вычислительные единицы. Так можно ответить пользователю, который спрашивает, куда делся его перевод. См. разделы [Via](https://docs.rome.builders/ru/prilozheniya-v-rome/via.md) и [Поддержка JSON-RPC](https://docs.rome.builders/ru/spravochnik/json-rpc.md).

## Solgate: активы Solana и EVM-сети AggLayer

[Solgate](https://docs.rome.builders/ru/prilozheniya-v-rome/solgate.md) соединяет активы Solana с EVM-сетями AggLayer в обоих направлениях, в основной и тестовой сетях. Для USDC используется CCTP. В шагах выше применяется API Rome Bridge.

Чтобы перемещать другие токены или отправлять сообщения, прочитайте раздел [13. Разработка на Solgate](https://docs.rome.builders/ru/rome-academy/13-build-on-solgate.md).

## Проверьте себя

Проведите один реальный перевод и проследите за ним.

1. Пополните новый кошелек Hadrian небольшим количеством USDC для оплаты газа, затем переведите туда дополнительный USDC с помощью `rome bridge` и intent-обертки. Оставьте достаточно средств на оплату подтверждений, вызовов хранилища и сжигания при выводе.
2. Проверьте баланс wUSDC кошелька в Hadrian, например, с помощью `rome call` для вызова `balanceOf`. При использовании 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. USDC, поступивший в качестве газа, учитывается отдельно. Пользователь может получить wUSDC с помощью intent-обертки или обернув часть средств для газа с помощью `withdraw_to_ata`.
* Пользователь. Запрос представляет собой транзакцию в целевой сети, поэтому пользователю нужен газ в этой сети.

</details>

## Далее

[11. Перевести в Rubicon](https://docs.rome.builders/ru/rome-academy/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/ru/rome-academy/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.
