> 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/erste-schritte-1/key-concepts.md).

# Schlüsselkonzepte

Wesentliche Solana- und Rome-EVM-Terminologie für Entwickler — Programme, Accounts, PDAs, CPI, SPL-Token und atomare vs. iterative Ausführung.

Wichtige Terminologie und Konzepte für das Aufbauen auf dem Rome Protocol.

## Solana-Konzepte

**Programm** — Solanas Gegenstück zu einem Smart Contract. Programme sind zustandslose ausführbare Programme, die On-Chain bereitgestellt werden. Die Rome EVM selbst ist ein Solana-Programm.

**Konto** — Der gesamte Zustand auf Solana liegt in Konten. Jedes Konto hat einen Eigentümer (Programm), ein Guthaben (Lamports) und Daten. Anders als bei Ethereum werden Code und Zustand in separaten Konten gespeichert.

**PDA (Program Derived Address)** — Eine deterministische Adresse, abgeleitet aus Seeds und einer Programm-ID. PDAs ermöglichen es Programmen, Konten ohne privaten Schlüssel zu "besitzen". Rome verwendet PDAs, um Ethereum-Adressen Solana-Konten zuzuordnen.

**CPI (Cross-Program Invocation)** — Wenn ein Solana-Programm innerhalb derselben Transaktion ein anderes aufruft. So interagieren Rome-EVM-Verträge mit Jupiter, Kamino, SPL Token und anderen Solana-Programmen.

**SPL Token** — Solanas standardisiertes Token-Programm. Entspricht ERC-20 auf Ethereum. Alle fungiblen Token auf Solana (USDC, SOL usw.) sind SPL-Token.

**Token-2022** — Das SPL-Token-Programm der nächsten Generation mit Erweiterungen wie Transfer Hooks, Confidential Transfers und Permanent Delegates.

**Transfer Hook** — Eine Token-2022-Erweiterung, die bei jedem `transfer_checked` Aufruf.

**ATA (Associated Token Account)** — Ein deterministisches Token-Konto für ein bestimmtes Wallet-Mint-Paar. Jeder Benutzer hat pro gehaltenem Token ein ATA.

**Lamports** — Die kleinste Einheit von SOL. 1 SOL = 1.000.000.000 Lamports (10^9).

**Compute Units (CU)** — Solanas Gegenstück zu Ethereums Gas. Jede Transaktion hat ein Compute-Budget (standardmäßig ca. 200K CU, maximal ca. 1,4M CU). Operationen verbrauchen CU.

## Rome-Konzepte

**Rome EVM-Programm** — Das Solana-Programm, das den EVM-Bytecode-Interpreter enthält. Bereitgestellt unter einer bestimmten Programm-ID pro Umgebung.

**Chain-ID** — Jede Anwendung auf Rome erhält ihre eigene EVM-Chain-ID. Dadurch entstehen isolierte EVM-Umgebungen, die denselben zugrunde liegenden Solana-Zustand gemeinsam nutzen.

**Atomare Ausführung (VmAt)** — Eine EVM-Transaktion, die vollständig innerhalb einer einzelnen Solana-Transaktion ausgeführt wird. Für die meisten Operationen verwendet.

**Iterative Ausführung (VmIt)** — Eine EVM-Transaktion, die über mehrere Solana-Transaktionen aufgeteilt ist, wobei jeder Schritt so viele Opcodes packt, wie in das Compute-Budget einer einzelnen Solana-Transaktion passen (adaptiv, keine feste Anzahl). Für rechenintensive Operationen wie BN254-Pairing verwendet.

**Holder-Konto** — Ein On-Chain-Puffer, der große EVM-Transaktionen (bis zu 80 KB) speichert, die das 4-KB-Transaktionsgrößenlimit von Solana (v1) überschreiten. Wird vom SDK transparent verwaltet.

**StateHolder** — Ein On-Chain-Konto, das serialisierten VM-Zustand zwischen iterativen Ausführungsschritten speichert.

**Rome-Proxy** — Der JSON-RPC-Server (Port 9090), der Ethereum-API-Aufrufe in Solana-Transaktionen übersetzt. Dein MetaMask und Hardhat verbinden sich hier.

**Hercules** — Der Block-Indexer, der Rome-EVM-Ereignisse auf Solana überwacht und Ethereum-kompatible Blockdaten erzeugt.

**Zahler** — Ein Solana-Schlüsselpaar, das Solana-Transaktionen im Namen von EVM-Benutzern signiert und bezahlt. Wird vom Proxy über Zahler-Pools verwaltet.

## Token-Konzepte

**SPL\_ERC20 / SPL\_ERC20\_cached** — ERC-20-Wrapper-Verträge, die ein SPL-Token innerhalb von Rome EVM repräsentieren. Für ein Wallet liest der Wrapper das Guthaben direkt aus dem zugrunde liegenden SPL-Token-Konto. Von einem Vertrag gehaltene Tokens befinden sich im eigenen Escrow-Token-Konto des Wrappers und werden im Storage des Wrappers verfolgt (siehe [Integrieren Sie ein Solana-Programm](https://docs.rome.builders/de/entwicklerleitfaden/integrate-solana-program.md)). Die Factory stellt heute die gecachte Variante bereit.

**ERC20SPLFactory** — Ein Factory-Vertrag, der Wrapper für jedes beliebige SPL-Token bereitstellt.

**Registry** — Kanonische Wrapper, Gas-Token und Bridge-Verbindungen werden off-chain in der [rome-protocol/registry](https://github.com/rome-protocol/rome-registry) gepflegt; es gibt keinen On-Chain-Token-Registry-Vertrag. So bleibt jedes Asset einem einzigen kanonischen SPL-Mint zugeordnet.

## Precompiles

**Standard-Ethereum-Precompiles** — ecrecover (0x01), SHA-256 (0x02), RIPEMD-160 (0x03), Identität (0x04), modexp (0x05), BN254 ecAdd/ecMul/ecPairing (0x06-0x08), Blake2f (0x09).

**System-Precompile** (`0xFF...07`) — PDA-Ableitung und Base58-Konvertierung aus Solidity.

**CpiProgram-Precompile** (`0xFF...08`) — Cross-Program-Invocation (`invoke` / `invoke_signed`) sowie Abkürzungen für zustandsübergreifendes Lesen.

**HelperProgram-Precompile** (`0xFF...09`) — ATA/PDA-Erstellung, SPL-Übertragungen und Gas↔Lamports-Umrechnung; die Hauptschnittstelle für von Benutzer-PDA-signierte SPL-Operationen.

**Withdraw-Precompile** (`0x42...16`) — SOL oder SPL-Token von EVM zurück nach Solana abheben.

Eine Cached-Track-Familie (`0xff…04/05/06/0b`) spiegelt diese für CU-effiziente Lesezugriffe wider; ein Vertrag verwendet durchgehend einen Track.

## Transaktionstypen

Das Rust-SDK erstellt drei Arten von Transaktionen. Rome wickelt jede davon auf Solana ab.

**Eine EVM-Transaktion (`RheaTx`)** — Eine einzelne EVM-Transaktion auf einer Rome-Chain. Der häufigste Typ.

**Mehrere EVM-Transaktionen (`RemusTx`)** — EVM-Transaktionen auf verschiedenen Rome-Chains, die gemeinsam in einer Solana-Transaktion ausgeführt werden. Wenn eine davon fehlschlägt, werden alle zurückgesetzt.

**EVM-Transaktionen plus Solana-Instruktionen (`RomulusTx`)** — EVM-Transaktionen und native Solana-Instruktionen in einer atomaren Solana-Transaktion, sodass Solidity- und Solana-Programme gemeinsam ausgeführt werden oder gar nicht.

## Wie es weitergeht

* [Ausführungsmodell](https://docs.rome.builders/de/kernkonzepte/execution-model.md) — Tiefgehender Einblick darin, wie EVM-Transaktionen auf Solana ausgeführt werden
* [Token-Interop](https://docs.rome.builders/de/kernkonzepte/token-interop.md) — wie ERC-20- und SPL-Token miteinander interagieren
* [Beschränkungen](https://docs.rome.builders/de/kernkonzepte/constraints.md) — wichtige Grenzen und Beschränkungen


---

# 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/erste-schritte-1/key-concepts.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.
