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

# 10. Traga usuários e fundos de outras cadeias

Traga usuários e seus fundos para seu app Rome a partir de outras chains e da Solana, com a bridge, sua API e a CLI, e mantenha a tela do seu app ativa.

Seu app funciona com os dois tipos de carteira. Agora, as pessoas precisam de uma forma de chegar até ele. A maioria tem USDC em outra chain ou na Solana e não deveria ter que aprender a usar Rome primeiro. Nesta lição, você vai usar a Rome Bridge API para trazer USDC de uma chain compatível, acompanhar a transferência e permitir que os usuários retirem os fundos, mantendo seu app atualizado. [2. O que você pode criar](https://docs.rome.builders/pt-br/rome-academy/02-what-you-can-build.md) mostra como isso se encaixa.

## O que você vai aprender

* Como um usuário em outra chain acessa seu app Rome sem sair da carteira que já usa.
* Como o USDC de um usuário chega a Rome vindo de uma chain EVM ou da Solana.
* Por que uma transferência chega como gas ou como wUSDC e como escolher.
* As quatro etapas de uma transferência de entrada.
* Por que sair de Rome tem mais etapas do que chegar.
* Como exibir o estado em tempo real no seu app e verificar uma transferência no explorador.

## Antes de começar

* Concluir [9. Crie um app com duas vias](https://docs.rome.builders/pt-br/rome-academy/09-build-a-dual-lane-app.md). Você precisa do vault ou de qualquer app que queira que os usuários acessem.
* Tenha a Rome CLI instalada ([Rome CLI + MCP](https://docs.rome.builders/pt-br/produtos/rome-cli.md)).
* Tenha USDC de teste em uma chain de origem e o token nativo dessa chain para pagar a taxa, obtidos em [Faucets](https://docs.rome.builders/pt-br/recursos/faucets.md).

## A lição

### Etapa 1. Entenda as duas formas de chegar

Com a Rome Bridge, seus usuários vêm de um de dois lugares. Uma chain EVM envia USDC pela CCTP da Circle. Uma carteira Solana envia SOL ou USDC por transferências SPL comuns. Em ambos os casos, a bridge opera on-chain e a liquidação é feita com a assinatura do próprio usuário. A Bridge API, que opera off-chain, fornece cotações da rota, verifica a transação de origem e patrocina a taxa de liquidação. Ela não retém fundos nem chaves; portanto, só pode acionar o que o usuário já assinou.

As chains e os ativos compatíveis variam entre a testnet e a mainnet, então consulte as listas em vez de presumir. Elas estão em [Rome Bridge](https://docs.rome.builders/pt-br/apps-na-rome/bridge-api.md), e a lista atualizada está disponível na API em `/v1/routes`. O padrão para acessar seu app a partir da chain que o usuário já usa está em [A partir de onde você já está](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/from-home.md).

### Etapa 2. Escolha entre gas e wUSDC

Por padrão, o USDC que chega pela bridge é convertido em gas. É com gas que um usuário de MetaMask paga as taxas. O token aceito pelo seu vault é o wUSDC. São duas formas do mesmo USDC, e o usuário pode converter uma na outra.

Defina a intenção na cotação. Um app que aceita wUSDC, como seu vault, deve permitir que os usuários cheguem como wUSDC. Quem chega como gas primeiro converte uma parte, como na lição 9. Quem pretende sair novamente precisa de wUSDC, porque a saída pela bridge queima wUSDC, não gas. O usuário pode chegar como wUSDC ou converter parte do gas mais tarde com `withdraw_to_ata`.

### Etapa 3. Faça uma transferência de entrada

Uma transferência de entrada tem quatro etapas. O subcaminho `/bridge` do SDK agrupa as chamadas à API como `requestQuote`, `registerTransfer`, `getTransfer` e `reportStep`. A versão `registerTransfer` (v0.4.0) ainda envia a cotação inteira, o que a API atual rejeita. Portanto, registre usando o `quoteId` por conta própria, como faz a Rome CLI.

1. Obtenha uma cotação para a rota. Envie a chain de origem, o ativo, o valor, o remetente e o destinatário. As chains devem ser informadas como IDs CAIP-2, e os valores, como inteiros em unidades-base representados por strings.
2. O usuário assina as transações da primeira etapa, na ordem e exatamente como foram retornadas. Em uma transferência CCTP, são a aprovação do USDC e a queima. Na rota de gas, o usuário também assina uma autorização de liquidação EIP-712, depois que você preenche o hash da queima.
3. Registre a transferência. Envie o `quoteId` da cotação e o hash da queima como `step1TxHash` para `POST /v1/transfers` em até 15 minutos após a cotação. Na rota com gas, adicione a assinatura de liquidação como `userSettleSig`. A API verifica se a transação corresponde à cotação armazenada e retorna um ID de transferência.
4. Consulte a transferência até que `outcome` seja `complete`e trate `failed` e `expired`. Uma transferência concluída pode incluir uma observação de `degradation` , então verifique-a antes de informar ao usuário que o gas ou o wUSDC chegou.

As transferências recebidas na Solana seguem o mesmo formato, mas com etapas diferentes. O usuário envia uma transferência SPL para sua conta Rome. Na intenção de gas, o USDC em uma rede cujo token de gas é USDC exige mais uma transação do usuário para converter o wrapper em gas. A cotação lista todas as assinaturas necessárias para uma rota. Formatos das requisições e respostas: [Da origem](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/from-home.md#bring-assets-in).

### Etapa 4. Execute primeiro pela CLI

Antes de escrever qualquer código de bridge, execute o fluxo pela CLI. `rome fund` traz USDC como gas, `rome bridge` recebe uma intenção de gas ou wrapper, e `rome verify --path from-home` comprova um ciclo completo: fazer a bridge de entrada, executar uma ação na Rome e fazer a bridge de saída. Isso fornece uma referência funcional para comparar com sua integração. Comandos e flags: [CLI + MCP da Rome](https://docs.rome.builders/pt-br/produtos/rome-cli.md).

### Etapa 5. Cuide da saída

Fazer bridge de saída não é o fluxo de entrada ao contrário. Para USDC via CCTP, o usuário assina duas etapas. A etapa 1 consiste em duas transações na Rome: uma concessão que permite ao contrato da bridge movimentar o valor exato a ser queimado e, em seguida, a queima. Registre a transferência com o hash da queima. A etapa 2 é o resgate. Quando a etapa 2 da transferência indicar `ready`, ela incluirá a mensagem e o atestado, e o usuário os enviará com `receiveMessage` na rede de destino. O resgate não é patrocinado, então o usuário precisa de gas nessa rede. Informe o hash do resgate à API (`reportStep` no SDK). Chamadas e formatos: [Retire os ativos](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/from-home.md#take-assets-back-out).

O saque para um endereço Solana não tem etapa de resgate. Para USDC, basta uma transação na Rome que faça o saque para a conta Solana do usuário.

A concessão é importante para seu app. Uma conta de token tem um único delegado, então a concessão da bridge substitui a concessão do wrapper até que o usuário conceda novamente ao wrapper. Verifique `isEnabled` antes do próximo depósito, como explicado na lição 9.

### Etapa 6. Mantenha seu app ativo

Os endpoints da Rome oferecem suporte a `eth_subscribe` para `newHeads` e `logs`, no mesmo host do RPC HTTPS. Com ethers, `provider.on("block")` e `contract.on(event)` funcionam como em qualquer outro lugar. Com o viem, o `webSocket` transporte descarta os IDs numéricos de assinatura da Rome, então passe `poll: true` para `watchBlocks` e `watchEvent`ou use ethers para atualizações push. `newPendingTransactions` nunca emite eventos, porque a Rome não tem mempool público. Código: [Assinaturas WebSocket](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/websocket-subscriptions.md).

Ao consultar o histórico, limite cada chamada `eth_getLogs` por intervalo de blocos. A RPC da Rome rejeita intervalos maiores que cerca de 12.000 blocos. Para uma transação que envolve a Solana, a linha "Liquidada em" da Via contém um link para a transação Solana que a liquidou, e o explorador da Solana mostra suas instruções e unidades de computação. É assim que você responde a um usuário que pergunta onde está a transferência. Consulte [Via](https://docs.rome.builders/pt-br/apps-na-rome/via.md) e [Suporte a JSON-RPC](https://docs.rome.builders/pt-br/referencia/json-rpc.md).

## Solgate: ativos da Solana e redes EVM da AggLayer

[Solgate](https://docs.rome.builders/pt-br/apps-na-rome/solgate.md) conecta ativos da Solana a redes EVM da AggLayer nos dois sentidos, tanto na mainnet quanto na testnet. O USDC usa CCTP. As etapas acima usam a API da Rome Bridge.

Para transferir outros tokens ou enviar mensagens, leia [13. Desenvolver com a Solgate](https://docs.rome.builders/pt-br/rome-academy/13-build-on-solgate.md).

## Teste seus conhecimentos

Faça uma transferência real e acompanhe-a.

1. Adicione USDC para taxas de gás a uma carteira Hadrian nova e, em seguida, transfira mais USDC com `rome bridge` e a intenção do wrapper. Mantenha saldo suficiente para aprovações, chamadas ao vault e a queima de saída.
2. Consulte o saldo de wUSDC da carteira na Hadrian, por exemplo, com `rome call` no `balanceOf`do wrapper. Com a intenção do wrapper, a chegada corresponde à transação Solana da ponte (a mensagem de recebimento da Circle), não a uma transação da Rome; portanto, não espere encontrar uma transação de chegada no explorador da Hadrian.
3. Repita a transferência pela API: obtenha uma cotação, assine, registre e, em seguida, consulte `GET /v1/transfers/{id}` até que `outcome` indique `complete`.
4. Execute `rome verify hadrian --path from-home` com `--from` (sua cadeia de origem) e `--amount` (um valor pequeno, como 0.2) e, em seguida, consulte o resultado. Isso leva cerca de 20 minutos.

Em seguida, responda:

* De qual saldo é debitada a queima de USDC de saída e como o usuário pode obtê-lo?
* Quem paga pela reivindicação na cadeia de destino?

<details>

<summary>Respostas</summary>

* wUSDC. O USDC recebido como saldo para taxas de gás é um saldo diferente. O usuário obtém wUSDC por meio da intenção do wrapper ou envolvendo parte do saldo para taxas de gás com `withdraw_to_ata`.
* O usuário. A reivindicação é uma transação na cadeia de destino, então o usuário precisa de gás nela.

</details>

## Avançar

[11. Enviar para Rubicon](https://docs.rome.builders/pt-br/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/pt-br/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.
