> 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/06-tokens-on-both-sides.md).

# 6. Token auf beiden Seiten

Wie ein SPL-Token für EVM-Wallets als ERC-20-Wrapper und für Solana-Wallets als Token-Konto erscheint, und die einmalige Freigabe, die Verträgen erlaubt, ihn zu bewegen.

Token bilden die Grundlage jedes Anwendungsfalls in [2. Was du entwickeln kannst](https://docs.rome.builders/de/rome-academy/02-what-you-can-build.md): Ein Pool, ein Vault oder ein Kreditmarkt bewegen alle denselben Vermögenswert, den Solana-Wallets halten. Ein SPL-Wrapper stellt einen SPL-Mint über eine ERC-20-Schnittstelle bereit. Bei Tokens, die eine Wallet hält, liest der Wrapper den Saldo im von Rome abgeleiteten Tokenkonto der Wallet aus, sodass Solana und Solidity denselben Saldo sehen. In dieser Lektion erfährst du, wie das funktioniert und welche einmalige Berechtigung jeder Nutzer erteilen muss, bevor dein Vertrag seine Tokens bewegen kann.

## Das lernst du

* Wie ein SPL-Wrapper den Solana-Token-Saldo einer Wallet über ERC-20-Methoden bereitstellt.
* Was Factory und Wrapper tun und welchen Wrapper du verwenden solltest.
* Wie sich Tokens in Verträgen von Tokens in Wallets unterscheiden.
* Die einmalige `approve_spl` -Berechtigung, wie du sie prüfst und wodurch sie ungültig wird.

## Bevor du loslegst

* Abschließen [5. Solana von Solidity aus aufrufen](https://docs.rome.builders/de/rome-academy/05-call-solana-from-solidity.md). Du benötigst das Konzept der PDA mit externer Autorität und des Helper-Precompiles.
* Du benötigst eine aufgeladene Hadrian-Wallet und einen deployten Vertrag. Die kanonischen Wrapper-Adressen findest du in der Datei `tokens.json` der Chain-Registry: Der Eintrag mit `kind: "spl_wrapper"` und dem Symbol `wUSDC`. [Hadrian](https://docs.rome.builders/de/netzwerke/hadrian.md) verweist auf den Registry-Ordner der Chain.
* Das USDC-Tokenkonto, das du in Lektion 5 mit `createMyAta` erstellt hast. Es muss vorhanden sein, damit die Berechtigung erteilt werden kann.

## Ein Saldo, zwei Ansichten

Jede EVM-Adresse hat auf Solana eine PDA mit externer Autorität, die die Tokenkonten der Adresse besitzt. Die ERC-20-Methode des Wrappers `balanceOf` liest das Tokenkonto der Wallet direkt aus. `totalSupply` liest den Mint aus.

Auf Rome greifen das SPL-Token einer Wallet und der ERC-20-Wrapper auf dasselbe Tokenkonto zu. Sowohl eine Solana-Wallet als auch eine EVM-Adresse, die USDC halten, halten denselben Mint und handeln über dieselben Poolkonten. So bleibt die Liquidität auf Rome an einem Ort. Die Abbildung und weitere Details findest du unter [Token-Interoperabilität](https://docs.rome.builders/de/kernkonzepte/token-interop.md#the-shared-state-model).

## Wallets und Verträge halten Tokens unterschiedlich

Bei Wallets bleibt der Saldo gemeinsam. Bei Verträgen ist das anders. Ein Vertrag kann die unten beschriebene einmalige Berechtigung nicht im Namen eines Nutzers erteilen. Daher halten die gewöhnlichen Wrapper die Tokens eines Vertrags in einem Escrow-Tokenkonto und führen ein Verzeichnis darüber, was jedem Vertrag gehört. Wrapper für Token-2022 mit Hooks führen kein Verzeichnis und verwenden das eigene Tokenkonto des Vertrags.

Daraus ergeben sich zwei Punkte:

* Zwei Wrapper für denselben Mint zeigen denselben Wallet-Saldo an. Beim Saldo eines Vertrags können sie voneinander abweichen, weil jeder sein eigenes Verzeichnis führt.
* Verwende für Pools, Vaults und Kreditmärkte den kanonischen Wrapper, den die Registry für jeden Mint auf jeder Chain angibt. Wähle nicht einfach einen anhand seines Namens aus.

Eine Übertragung an einen Vertrag über den Wrapper schreibt den Betrag seinem Verzeichnis gut. Dadurch erhält der Vertrag kein Tokenkonto, von dem er Tokens ausgeben kann. Für Abläufe, bei denen der Vertrag auf Solana handeln muss, verwende den in [Ein Solana-Programm integrieren](https://docs.rome.builders/pages/efd1c176728a1a4534ac7d3a596931b458c2e34f#id-3.-tokens-in-tokens-out).

## Factory und Wrapper

`ERC20SPLFactory` stellt einen Wrapper für einen SPL-Mint bereit. Jede Factory erlaubt einen Wrapper pro Mint. Der Wrapper bietet eine vollständige ERC-20-Schnittstelle:

* `balanceOf` und `totalSupply` lesen den Solana-Zustand aus.
* `transfer` und `transferFrom` bewegen Tokens auf Solana.
* `approve` und `allowance` gewöhnliche ERC-20-Freigaben im EVM-Speicher halten, da es bei einem Tokenkonto kein Äquivalent dazu gibt.

In der Regel müssen Sie keinen Wrapper bereitstellen. Rome und die Registry enthalten bereits die kanonischen Wrapper für USDC, ETH und SOL. Einen eigenen Wrapper stellen Sie nur bereit, wenn Sie eine neue Mint einführen. Beide Factory-Aufrufe finden Sie in [Die Factory](https://docs.rome.builders/de/kernkonzepte/token-interop.md#the-factory). Die Factory unterstützt auch Token-2022-Mints, deren Erweiterungen jedoch die Integration verändern: Bei einem Wrapper mit Hook schlagen einfache Aufrufe von `transfer` und `transferFrom`fehl, und bei einer Mint mit Transfergebühr kann weniger ankommen, als Sie senden. Lesen Sie [Token-2022-Mints](https://docs.rome.builders/de/kernkonzepte/token-interop.md#token-2022-mints) , bevor Sie eine davon in Ihrem Vault verwenden.

Beträge müssen in `uint64`passen, da SPL-Beträge diesen Typ verwenden und der Wrapper größere Werte zurückweist. Der Gas-Token hat seine eigenen Dezimalstellen, während native Gasguthaben 18 Dezimalstellen verwenden. Die Umrechnung zwischen beiden muss exakt sein. Der Gas-Token auf Hadrian und Rubicon ist USDC.

## Die einmalige Freigabe

Der Wrapper bewegt die Token eines Nutzers als SPL-Delegate des Tokenkontos des Nutzers. Bevor der Wrapper Token bewegen kann, muss das Tokenkonto diesen Delegate benennen. Der Nutzer muss dies einmal pro Wrapper mit einem Aufruf für den Höchstbetrag tun:

`approve_spl(wrapper, type(uint64).max, mint)` auf dem Helper-Precompile.

Vier Details sind in der Praxis wichtig:

* **Der Nutzer sendet die Transaktion.** Die Freigabe wird mit dem eigenen Konto des Nutzers signiert und direkt an den Helper-Precompile gesendet. Ihr Vertrag kann sie nicht im Namen des Nutzers senden. Integrieren Sie in Ihr Frontend einen Schritt „Aktivieren“.
* **Sie gilt für alle.** Sowohl MetaMask-Wallets als auch die synthetischen Adressen von Solana-Wallets benötigen diese Freigabe für jeden Wrapper, dessen Token sie bewegen möchten.
* **Prüfen Sie die Freigabe zuerst.** Die Funktion `isEnabled(user)` des Wrappers gibt `true` zurück, sobald die Freigabe erteilt wurde. Lesen Sie den Wert vor einer Übertragung aus, anstatt ihn vorauszusetzen.
* **Erteilen Sie die Freigabe für den Höchstbetrag.** `isEnabled` bleibt `true` solange noch ein Teil einer begrenzten Freigabe übrig ist. Eine begrenzte Freigabe lässt gewöhnliche Übertragungen scheitern, sobald sie fast aufgebraucht ist, und Ihre App weiß nicht, dass sie erneut danach fragen muss.

Zu übergeben ist die Mint-ID, die Sie mit `mint_id()` auf dem Wrapper erhalten. Ein vollständiges Beispiel für das Frontend, das beide Wallet-Typen abdeckt, finden Sie unter [Einmalig: Wrapper freigeben](https://docs.rome.builders/de/entwicklerleitfaden/dual-lane-app.md#one-time-grant-the-wrapper).

### So kommt es zu Fehlern

Ein Tokenkonto hat nur einen Delegate. Wenn der Nutzer einen Bridge- oder Router-Delegate freigibt, ersetzt diese Freigabe die des Wrappers, und der Wrapper funktioniert für diesen Nutzer nicht mehr. Das äußert sich als Revert mit dem SPL-Fehler `0x4`, einem Fehler wegen nicht übereinstimmender Eigentümer. Die Lösung besteht darin, den Wrapper erneut freizugeben. Prüfen Sie daher `isEnabled` vor jedem Ablauf, der vom Wrapper abhängt, und nicht nur bei der Registrierung.

Eine neue Factory-Version bringt einen neuen Wrapper mit sich, den jedes Wallet auf dieselbe Weise freigeben muss.

## Token herausübertragen

Da der Wrapper-Kontostand bereits dem SPL-Kontostand entspricht, ist das Herausübertragen eines Tokens nach Solana eine SPL-Übertragung.

* Von einem EVM-Wallet an ein anderes Solana-Wallet: `transfer_spl` direkt von der Wallet an den Helper-Precompile gesendet oder `RomeBridgeWithdraw.bridgeOutToSolana`, wofür ebenfalls eine Freigabe für den Bridge-Vertrag erforderlich ist. Bei beiden muss das Token-Konto des Empfängers bereits existieren.
* An die Wallet, die die Transaktion signiert hat: `transfer_spl_to_signer`. Das Geld gelangt nur über den von der Wallet signierten Solana-Pfad in die eigene Wallet des Nutzers. Bei MetaMask ist der Signierer der Proxy-Zahler von Rome. Verwenden Sie daher die beiden anderen Methoden.
* Für den Gas-Token `withdraw_to_ata` und `deposit_from_ata` wandeln natives Gas in den Token in einem Token-Konto um und umgekehrt.

Solgate verbindet Solana-Assets in beide Richtungen mit AggLayer-EVM-Chains, sowohl im Mainnet als auch im Testnet. Im Testnet ist die Registrierung von SPL-Token erlaubnisfrei. Für USDC wird CCTP verwendet. [Lektion 10](https://docs.rome.builders/de/rome-academy/10-from-other-chains.md) befasst sich wieder mit eingehenden Transaktionen und der Bridge. Die Methodenliste finden Sie unter [Einzahlen und Abheben](https://docs.rome.builders/de/kernkonzepte/token-interop.md#deposit-and-withdraw).

## Selbst überprüfen

Verwenden Sie auf Hadrian die Wallet, die Sie aufgeladen haben:

1. Lesen Sie `isEnabled` für Ihre Adresse auf dem kanonischen wUSDC-Wrapper aus dem Registry-Verzeichnis aus.
2. Stellen Sie sicher, dass Ihr USDC-Token-Konto vorhanden ist. Der `createMyAta` Aufruf in Lektion 5 hat es erstellt. Falls Sie diesen Schritt übersprungen haben, wandeln Sie mit `withdraw_to_ata`, wie in [Dieselbe App mit MetaMask](https://docs.rome.builders/de/entwicklerleitfaden/dual-lane-app.md#the-same-app-from-metamask).
3. Wenn `isEnabled` den Wert `false`hat, senden Sie die `approve_spl` Freigabe an den Helper-Precompile. Verwenden Sie den Code aus der oben verlinkten Anleitung für beide Pfade.
4. Lesen Sie `isEnabled` erneut aus. Der Wert sollte nun `true`.
5. Suchen Sie Ihre Freigabetransaktion im [Über den Explorer](https://docs.rome.builders/de/apps-auf-rome/via.md). Achten Sie auf die SPL-Token-Anweisung `ApproveChecked` .

<details>

<summary>1. Warum zeigen zwei Wrapper für denselben Mint denselben Wallet-Guthabenstand an?</summary>

Beide lesen das Token-Konto der Wallet auf Solana aus. Ein Wrapper ist eine Ansicht des SPL-Tokens, kein separates Hauptbuch. Nur Guthaben, die von Verträgen gehalten werden, werden pro Wrapper erfasst.

</details>

<details>

<summary>2. Ein Nutzer zahlt in Ihren Vault ein und verwendet anschließend einen Router, der eine eigene <code>approve_spl</code>Freigabe anfordert. Ihr nächster <code>transferFrom</code> Aufruf schlägt mit dem SPL-Fehler 0x4 fehl. Warum?</summary>

Ein Token-Konto kann nur einen Delegate haben. Die Freigabe für den Router hat die des Wrappers ersetzt. Der Nutzer muss dem Wrapper erneut eine Freigabe erteilen, und Ihre App sollte `isEnabled` vor der Übertragung.

</details>

<details>

<summary>3. Welchen Pool-Wrapper verwenden Sie für einen neuen Liquiditätspool?</summary>

Den kanonischen Wrapper, den das Register für diesen Mint auf dieser Chain angibt. Die von den Contracts gehaltenen Guthaben unterscheiden sich je nach Wrapper.

</details>

## Weiter

[7. Öffnen Sie Ihre EVM-App für Solana-Wallets](https://docs.rome.builders/de/rome-academy/07-open-to-solana-wallets.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/06-tokens-on-both-sides.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.
