> 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/07-open-to-solana-wallets.md).

# 7. Öffne deine EVM-App für Solana-Wallets

Mache deinen Vertrag mit einer Solana-Wallet ohne EVM-Schlüssel nutzbar, einschließlich der synthetischen Adresse, des ERC-20-Werts, der zwei Signaturen und des atomaren Budgets.

Ihr Vertrag funktioniert bereits mit MetaMask. Jetzt lassen Sie eine Solana-Wallet ihn mit dem Schlüssel aufrufen, den sie bereits hat, sodass der Benutzer nie ein EVM-Konto erstellt. Sie rufen denselben Vertrag unter derselben Adresse gegen denselben Zustand auf.

## Was Sie lernen werden

* Wie eine Solana-Wallet zu einem normalen `msg.sender` auf Rome wird.
* Warum dieser Kurs Werte als ERC-20-Einzahlung annimmt und was `msg.value` er von einem Solana-Nutzer benötigt.
* Was ein Solana-Nutzer bei jedem Aufruf signiert und wohin die Transaktion geht.
* Was in eine Solana-Transaktion passt und was mit einem Aufruf geschieht, der nicht hineinpasst.
* Welche `Abhängigkeiten` das SDK benötigt und woher jede einzelne kommt.

## Bevor Sie beginnen

* Abschließen [6. Token auf beiden Seiten](https://docs.rome.builders/de/rome-academy/06-tokens-on-both-sides.md). Diese Lektion setzt voraus, dass Sie wissen, was ein Wrapper ist und warum ein Nutzer ihn einmal gewährt.
* Haben `HelloRome` auf Hadrian bereitgestellt von [3. Dein erster Contract auf Hadrian](https://docs.rome.builders/de/rome-academy/03-first-contract-on-hadrian.md).
* Installieren Sie das TypeScript-SDK, wie in [Rome SDK](https://docs.rome.builders/de/produkte/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* Haben Sie eine Solana-Wallet, die Solana-v1-Transaktionen signiert, mit etwas Devnet-SOL und Devnet-USDC. Faucets sind aufgeführt in [Faucets](https://docs.rome.builders/de/ressourcen/faucets.md). Die Unterstützung für v1-Transaktionen unterscheidet sich je nach Wallet, testen Sie Ihre daher zuerst. [Eine Dual-Lane-App bauen](https://docs.rome.builders/de/entwicklerleitfaden/dual-lane-app.md) nennt die bisher geprüften Wallets.

## Die Lektion

### Schritt 1. Lernen Sie die synthetische Adresse kennen

Eine Solana-Wallet hat keine EVM-Adresse, also leitet Rome eine aus ihrem öffentlichen Schlüssel ab. Das Ergebnis ist die synthetische Adresse der Wallet. Sie ist die `msg.sender` die Ihr Vertrag sieht, und sie bringt wie jedes andere Konto ihren eigenen Nonce und Speicher mit. Dieselbe Wallet wird immer derselben Adresse zugeordnet.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // eine gewöhnliche 20-Byte-Adresse
```

Im Ablauf dieses Kurses hält das Synthetic im Ruhezustand keine Token. Sie beginnen in der Solana-Wallet des Benutzers. Der Fund-Teil verschiebt sie vor einer Einzahlung in das Token-Konto des Synthetic, und erst dann zeigt der Wrapper `balanceOf(synthetic)` sie an. Der Sweep-Teil verschiebt sie nach einer Auszahlung zurück in die Wallet. Lesen Sie das vollständige Modell in [EVM aus Solana aufrufen](https://docs.rome.builders/de/entwicklerleitfaden/call-evm-from-solana.md#synthetic-addresses).

### Schritt 2. Machen Sie den Vertrag Solana-fähig

Die meisten Verträge brauchen keine Änderung. Drei Regeln entscheiden, ob Ihrer einer von ihnen ist:

* Nehmen Sie Werte als ERC-20 an. Ziehen Sie sie mit `transferFrom` nach einem `approve`ein und geben Sie sie mit `transfer`.
* Verweisen Sie für jedes Token auf den kanonischen Wrapper. Stellen Sie keinen eigenen bereit.
* Halten Sie jeden Solana-Lane-Aufruf innerhalb einer Solana-Transaktion.

Die erste Regel ist die, die zuschlägt. Dieser Einstiegspunkt funktioniert für MetaMask-Nutzer. Er scheitert für Solana-Nutzer im Fund-and-Sweep-Modell, weil ihr Synthetic keinen nativen Kontostand hält, es sei denn, Sie füllen ihn mit `fundSyntheticGas`:

```solidity
function deposit() external payable { balanceOf[msg.sender] += msg.value; }
```

Dieser funktioniert für beide, weil beide Lanes eine `transferFrom`:

```solidity
function deposit(uint256 amount) external {
    require(token.transferFrom(msg.sender, address(this), amount));
    balanceOf[msg.sender] += amount;
}
```

Wrapper-Adressen sind auf [Contract Addresses](https://docs.rome.builders/de/referenz/contract-addresses.md). Die Prüfungen für einen Solana-fähigen Vertrag finden Sie in [Öffnen Sie Ihren Solidity-Vertrag für Solana-Nutzer](https://docs.rome.builders/pages/ca2b8fd6dd66f0791e7d6ac3b2a7a038356a4af4#id-2.-what-makes-a-contract-solana-ready).

### Schritt 3. Verstehen Sie, was die Wallet signiert

Der SDK-Aufruf lautet `submitRomeTxV1`. Für jeden Aufruf erstellt der Proxy eine Solana-v1-Transaktion. Die Wallet signiert zweimal mit demselben Schlüssel. Zuerst signiert sie eine lesbare Autorisierungsnachricht, die den Hash der EVM-Transaktion nennt. Dann signiert sie die Transaktion selbst.

Die App sendet die signierte Transaktion an das Solana-RPC, nicht an den Rome-Proxy. Die Chain prüft die Autorisierung über das Ed25519-Programm und führt Ihren Aufruf als die synthetische Adresse aus. Der Benutzer hält niemals einen EVM-Schlüssel.

Bevor die Wallet die Transaktion signiert, prüft das SDK, dass sie genau den Aufruf enthält, den der Benutzer autorisiert hat. Alles andere wird abgelehnt. Die Einzelheiten stehen in [Öffnen Sie Ihren Solidity-Vertrag für Solana-Nutzer](https://docs.rome.builders/pages/ca2b8fd6dd66f0791e7d6ac3b2a7a038356a4af4#id-3.-let-a-solana-wallet-call-it).

### Schritt 4. Verbinden Sie die Lane

Das SDK benötigt fünf Werte: eine Proxy-URL, eine Chain-ID, die Rome-Programm-ID, eine Solana-RPC-Verbindung und einen Signer. Vier beschreiben die Chain. Einer stammt aus der Wallet.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: Ihr Vertrag aus Lektion 3; data: der ABI-kodierte greet()-Aufruf
```

Für Hadrian lesen Sie die vier Chain-Werte aus der Registry. Die Zuordnung steht in der `Abhängigkeiten` Tabelle des in Schritt 3 verlinkten Leitfadens, und die Werte stehen auf [Hadrian](https://docs.rome.builders/de/netzwerke/hadrian.md). Lektion 11 behandelt dieselbe Verdrahtung für Rubicon.

Zwei einmalige Schritte kommen vor dem ersten wertbewegenden Aufruf eines neuen Benutzers. Richten Sie das Synthetic mit `buildCreatePdaCall`ein, und gewähren Sie dem Wrapper die Genehmigung, wenn `isEnabled` false ist. `submitRomeTxV1` richtet das nicht für Sie ein. Lektion 9 führt beide in dieser Reihenfolge aus.

### Schritt 5. Bleiben Sie in einer Transaktion

Ein Aufruf in der Solana-Lane muss in eine Solana-Transaktion passen: etwa 1,4 Mio. Compute Units, 64 Konten und 4 KB. Messen Sie mit `computeUnitsConsumed` aus dem Solana-Receipt, nicht EVM `gasUsed`. Fordern Sie die Transaktion mit `maxSupportedTransactionVersion: 1`an; ohne dies lehnt die RPC die Anfrage ab.

Wenn ein Aufruf nicht hineinpasst, lehnt der Composer ihn ab und das SDK übergibt ihn an den Proxy, damit er mit derselben Autorisierungssignatur weitergeleitet wird. Der Benutzer sieht trotzdem nur eine Aufforderung. Das Ergebnis enthält `route: "relay"`. Ein weitergeleiteter Aufruf verbraucht das native Gas des Synthetic, also laden Sie es zuerst mit `fundSyntheticGas`auf. Ein weitergeleiteter Aufruf, der zurückrollt, wirft keinen Fehler. Prüfen Sie `receipt.status`. Die Regeln stehen in [Weitergeleitete Aufrufe und lange Aufrufe](https://docs.rome.builders/de/entwicklerleitfaden/call-evm-from-solana.md#relayed-calls-and-long-calls). Grenzwerte in einer Tabelle: [Einschränkungen](https://docs.rome.builders/de/kernkonzepte/constraints.md).

## Überprüfen Sie sich selbst

Beantworten Sie diese, dann öffnen Sie die Antworten.

1. Warum scheitert eine `payable` Einzahlung für einen Solana-Nutzer?
2. Wie viele Signaturen erzeugt die Wallet pro Aufruf, und was deckt jede ab?
3. Wohin geht die signierte Transaktion?
4. Ein Aufruf braucht mehr als eine Transaktion. Was sieht der Benutzer, und wer zahlt?

<details>

<summary>Antworten</summary>

1. Das Geld des Benutzers ist ein SPL-Token in seiner Wallet, der auf Rome als Wrapper angezeigt wird. Das Synthetic hält im Fund-and-Sweep-Modell keinen nativen Kontostand, es sei denn, Sie laden ihn auf, also gibt es nichts `msg.value` zu senden.
2. Zwei. Die erste deckt eine lesbare Autorisierungsnachricht mit dem EVM-Transaktions-Hash ab. Die zweite deckt die Solana-Transaktion ab.
3. An das Solana-RPC, gesendet von der App. Der Proxy erstellt die Transaktion und empfängt sie nicht, außer bei einem weitergeleiteten Aufruf.
4. Eine Autorisierungsaufforderung. Der Proxy leitet den Aufruf weiter und der native Gasbestand des Synthetic bezahlt dafür.

</details>

## Weiter

[8. Öffne dein Solana-Programm für EVM-Nutzer](https://docs.rome.builders/de/rome-academy/08-open-your-solana-program-to-evm-users.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/07-open-to-solana-wallets.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.
