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

# 10. Bringe Nutzer und Gelder von anderen Chains mit

Hole Nutzer und ihre Gelder mit der Bridge, ihrer API und der CLI aus anderen Chains und von Solana in deine Rome-App, und halte die Ansicht deiner App live.

Deine App funktioniert mit beiden Wallet-Typen. Jetzt brauchen Nutzerinnen und Nutzer eine Möglichkeit, zu ihr zu gelangen. Die meisten halten USDC auf einer anderen Chain oder auf Solana und sollten nicht erst Rome kennenlernen müssen. In dieser Lektion verwendest du die Rome Bridge API, um USDC von einer unterstützten Chain zu übertragen, den Transfer nachzuverfolgen und Nutzern zu ermöglichen, ihre Gelder wieder abzuheben – während deine App aktuell bleibt. [2. Was du erstellen kannst](https://docs.rome.builders/de/rome-academy/02-what-you-can-build.md) zeigt, wo das Ganze hineinpasst.

## Das lernst du

* Wie Nutzer auf einer anderen Chain zu deiner Rome-App gelangen, ohne ihre gewohnte Umgebung zu verlassen.
* Wie die USDC eines Nutzers von einer EVM-Chain und von Solana nach Rome gelangen.
* Warum ein Transfer als Gas oder als wUSDC ankommt und wie du dich entscheidest.
* Die vier Schritte eines eingehenden Transfers.
* Warum das Verlassen von Rome mehr Schritte umfasst als die Ankunft.
* Wie du den aktuellen Status in deiner App anzeigst und einen Transfer im Explorer überprüfst.

## Bevor du loslegst

* Abschließen [9. Eine App mit zwei Zahlungswegen erstellen](https://docs.rome.builders/de/rome-academy/09-build-a-dual-lane-app.md). Du benötigst den Vault oder eine beliebige App, zu der Nutzer gelangen sollen.
* Installiere die Rome CLI ([Rome CLI + MCP](https://docs.rome.builders/de/produkte/rome-cli.md)).
* Halte Test-USDC auf einer Quell-Chain sowie den nativen Token dieser Chain für die Gebühr bereit. Du findest beides unter  [Faucets](https://docs.rome.builders/de/ressourcen/faucets.md).

## Die Lektion

### Schritt 1. Die beiden Möglichkeiten für eingehende Transfers verstehen

Mit der Rome Bridge kommen deine Nutzer von einem von zwei Orten. Eine EVM-Chain sendet USDC über Circles CCTP. Ein Solana-Wallet sendet SOL oder USDC über gewöhnliche SPL-Transfers. In beiden Fällen erfolgt die Übertragung über die Blockchain und wird mit der eigenen Signatur des Nutzers abgewickelt. Die Off-Chain-Bridge-API erstellt ein Angebot für die Route, prüft die Quelltransaktion und übernimmt die Gebühr für die Abwicklung. Sie verwahrt weder Gelder noch Schlüssel und kann daher nur das auslösen, was der Nutzer bereits signiert hat.

Die unterstützten Chains und Assets unterscheiden sich zwischen Testnet und Mainnet. Lies also die Listen, statt Annahmen zu treffen. Du findest sie unter  [Rome Bridge](https://docs.rome.builders/de/apps-auf-rome/bridge-api.md). Die aktuelle Liste liefert der API-Endpunkt  `/v1/routes`. Das Muster, mit dem Nutzer von ihrer gewohnten Chain zu deiner App gelangen, wird unter  [Von der gewohnten Chain](https://docs.rome.builders/de/entwicklerleitfaden/from-home.md).

### Schritt 2. Gas oder wUSDC auswählen

USDC, das über die Bridge ankommt, wird standardmäßig als Gas ausgegeben. Mit Gas bezahlt ein MetaMask-Nutzer Gebühren. Der Token, den dein Vault akzeptiert, ist wUSDC. Das sind zwei Formen desselben USDC, und Nutzer können die eine in die andere umwandeln.

Lege die gewünschte Form im Angebot fest. Eine App, die wUSDC akzeptiert, wie dein Vault, soll Nutzer in Form von wUSDC empfangen. Wer als Gas ankommt, wickelt zunächst einen Teil davon ein, wie in Lektion 9. Wer plant, später wieder abzureisen, braucht wUSDC, da beim Bridging nach außen wUSDC und nicht Gas verbrannt wird. Nutzer können als wUSDC ankommen oder später einen Teil des Gases mit  `withdraw_to_ata`.

### Schritt 3. Einen eingehenden Transfer ausführen

Ein eingehender Transfer umfasst vier Schritte. Der Unterpfad  `/bridge` im SDK kapselt die API-Aufrufe:  `requestQuote`, `registerTransfer`, `getTransfer` und  `reportStep`. Die Version  `registerTransfer` (v0.4.0) übermittelt weiterhin das vollständige Angebot, was die Live-API ablehnt. Registriere den Transfer daher wie die Rome CLI selbst mit der  `quoteId` .

1. Erstelle ein Angebot für die Route. Gib Quell-Chain, Asset, Betrag, Absender und Empfänger an. Chains werden als CAIP-2-IDs übergeben; Beträge sind ganzzahlige Werte in Basiseinheiten als Strings.
2. Der Nutzer signiert die Transaktionen des ersten Schritts in der angegebenen Reihenfolge und genau wie zurückgegeben. Bei einem CCTP-Transfer sind das die USDC-Freigabe und der Burn. Bei der Gas-Route signiert der Nutzer außerdem eine EIP-712-Abwicklungsautorisierung, nachdem du den Burn-Hash eingetragen hast.
3. Registriere den Transfer. Übermittle die  `quoteId` des Angebots und den Burn-Hash als  `step1TxHash` an `POST /v1/transfers` innerhalb von 15 Minuten nach dem Quote. Bei der Gas-Route fügst du die Signatur für die Abwicklung als `userSettleSig`hinzu. Die API prüft, ob die Transaktion mit dem gespeicherten Quote übereinstimmt, und gibt eine Transfer-ID zurück.
4. Rufe den Transferstatus so lange ab, bis `outcome` den Wert `complete`hat, und behandle `failed` und `expired`entsprechend. Ein abgeschlossener Transfer kann einen Hinweis auf eine `degradation` enthalten. Prüfe ihn daher, bevor du dem Nutzer mitteilst, dass das Gas oder die wUSDC angekommen ist.

Eingänge auf Solana folgen demselben Muster, aber mit anderen Schritten. Der Nutzer sendet eine SPL-Überweisung an sein Rome-Konto. Bei der Gas-Absicht muss der Nutzer auf einer Chain, deren Gas-Token USDC ist, eine weitere Transaktion ausführen, um den Wrapper in Gas umzuwandeln. Das Quote führt alle Signaturen auf, die eine Route benötigt. Anfrage- und Antwortformate: [Von zu Hause](https://docs.rome.builders/de/entwicklerleitfaden/from-home.md#bring-assets-in).

### Schritt 4: Zuerst über die CLI ausführen

Bevor du Bridge-Code schreibst, führe den Ablauf über die CLI aus. `rome fund` bringt USDC als Gas ein, `rome bridge` nimmt eine Absicht für Gas oder einen Wrapper entgegen, und `rome verify --path from-home` weist einen vollständigen Hin- und Rückweg nach: Bridge hinein, auf Rome handeln, Bridge hinaus. So erhältst du eine funktionierende Referenz, mit der du deine Integration vergleichen kannst. Befehle und Flags: [Rome CLI + MCP](https://docs.rome.builders/de/produkte/rome-cli.md).

### Schritt 5: Den Rückweg behandeln

Das Bridging nach außen ist nicht einfach der umgekehrte Ablauf des eingehenden Transfers. Bei USDC über CCTP signiert der Nutzer zwei Schritte. Schritt 1 besteht aus zwei Rome-Transaktionen: einer Freigabe, die es dem Bridge-Contract erlaubt, genau den Betrag dieses Burns zu bewegen, und anschließend dem Burn. Registriere den Transfer mit dem Burn-Hash. Schritt 2 ist der Claim. Wenn für Schritt 2 des Transfers `ready`angezeigt wird, enthält er die Nachricht und die Attestation, und der Nutzer ruft `receiveMessage` mit diesen Daten auf der Ziel-Chain auf. Der Claim wird nicht gesponsert, daher benötigt der Nutzer dort Gas. Übermittle den Claim-Hash an die API (im SDK über`reportStep` ). Aufrufe und Formate: [Assets wieder herausnehmen](https://docs.rome.builders/de/entwicklerleitfaden/from-home.md#take-assets-back-out).

Bei Auszahlungen an eine Solana-Adresse gibt es keinen Claim-Schritt. Für USDC ist es eine einzige Rome-Transaktion, die eine Auszahlung an das Solana-Konto des Nutzers vornimmt.

Die Freigabe ist für deine App wichtig. Ein Token-Konto hat nur einen Delegate, daher ersetzt die Bridge-Freigabe die Freigabe des Wrappers, bis der Nutzer dem Wrapper erneut eine Freigabe erteilt. Prüfe vor der nächsten Einzahlung wie in Lektion 9 `isEnabled` .

### Schritt 6: Deine App dauerhaft verfügbar halten

Rome-Endpunkte unterstützen `eth_subscribe` für `newHeads` und `logs`, auf demselben Host wie der HTTPS-RPC. Mit ethers: `provider.on("block")` und `contract.on(event)` funktionieren wie überall sonst. Bei viem verwirft der `webSocket` -Transport die numerischen Subscription-IDs von Rome. Übergeben Sie daher `poll: true` an `watchBlocks` und `watchEvent`, oder verwenden Sie ethers für Push-Updates. `newPendingTransactions` wird nie ausgegeben, da Rome keinen öffentlichen Mempool hat. Code: [WebSocket-Subscriptions](https://docs.rome.builders/de/entwicklerleitfaden/websocket-subscriptions.md).

Wenn Sie den Verlauf abfragen, begrenzen Sie jeden `eth_getLogs` -Aufruf auf einen Blockbereich. Die Rome-RPC lehnt Bereiche ab, die etwa 12.000 Blöcke überschreiten. Bei einer Transaktion, die Solana berührt, verlinkt die Zeile „Abgeschlossen in“ von Via auf die Solana-Transaktion, mit der sie abgeschlossen wurde. Im Solana-Explorer werden deren Instruktionen und Compute Units angezeigt. So können Sie einem Nutzer erklären, wo seine Überweisung ist. Siehe [Via](https://docs.rome.builders/de/apps-auf-rome/via.md) und [JSON-RPC-Unterstützung](https://docs.rome.builders/de/referenz/json-rpc.md).

## Solgate: Solana-Assets und AggLayer-EVM-Chains

[Solgate](https://docs.rome.builders/de/apps-auf-rome/solgate.md) verbindet Solana-Assets in beide Richtungen mit AggLayer-EVM-Chains, sowohl im Mainnet als auch im Testnet. USDC verwendet CCTP. Die obigen Schritte verwenden die Rome Bridge API.

Um andere Token zu übertragen oder Nachrichten zu senden, lesen Sie [13. Mit Solgate entwickeln](https://docs.rome.builders/de/rome-academy/13-build-on-solgate.md).

## Selbst überprüfen

Führen Sie eine echte Überweisung durch und beobachten Sie sie.

1. Laden Sie eine neue Hadrian-Wallet mit etwas Gas-USDC auf und übertragen Sie dann mit `rome bridge` und der Wrapper-Intent weiteres USDC. Halten Sie genug Gas für Genehmigungen, Vault-Aufrufe und den ausgehenden Burn bereit.
2. Lesen Sie den wUSDC-Kontostand der Wallet auf Hadrian aus, zum Beispiel mit `rome call` auf dem `balanceOf`des Wrappers. Beim Wrapper-Intent ist die Ankunft die Solana-Transaktion der Bridge (die Empfangsnachricht von Circle), keine Rome-Transaktion. Erwarten Sie daher keine Ankunftstransaktion im Hadrian-Explorer.
3. Wiederholen Sie die Überweisung über die API: Angebot einholen, signieren, registrieren und dann `GET /v1/transfers/{id}` abfragen, bis `outcome` den Wert `complete`.
4. Führen Sie `rome verify hadrian --path from-home` mit `--from` (Ihrer Quell-Chain) und `--amount` (einem kleinen Betrag, etwa 0.2) aus und lesen Sie dann das Ergebnis. Das dauert etwa 20 Minuten.

Beantworten Sie anschließend folgende Fragen:

* Welcher Kontostand wird für einen ausgehenden USDC-Burn verwendet, und wie kann ein Nutzer diesen erhalten?
* Wer bezahlt den Claim auf der Ziel-Chain?

<details>

<summary>Antworten</summary>

* wUSDC. USDC, das als Gas angekommen ist, ist ein anderer Kontostand. Ein Nutzer erhält wUSDC über den Wrapper-Intent oder indem er etwas Gas mit `withdraw_to_ata`.
* Der Nutzer. Der Claim ist eine Transaktion auf der Ziel-Chain, daher benötigt der Nutzer dort Gas.

</details>

## Weiter

[11. An Rubicon senden](https://docs.rome.builders/de/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/de/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.
