> 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/ecosystem.md). # Ökosystem & Repos Romes öffentliche Oberfläche ist eine Sammlung von Repositories: einige **Grundlagen** Pakete, auf denen Sie aufbauen, ein Scaffolder, Referenz-Apps zum Lernen und zwei Dienste, die Ihre App aufruft. Diese Seite ist die Karte — was jedes Repository ist und wie sie zusammenpassen. Zwei benachbarte Seiten beantworten unterschiedliche Fragen, und diese Seite verlinkt auf beide, statt sie zu wiederholen: * [Architektur](/de/erste-schritte/architecture.md) erklärt das **Protokoll** — wie die EVM innerhalb eines Solana-Programms läuft. * Jedes Repository enthält eine **`AGENTS.md`** (z. B. [rome-sdk-ts/AGENTS.md](https://github.com/rome-protocol/rome-sdk-ts/blob/main/AGENTS.md)) die danach leitet, **wovon Sie ausgehen** (einem Solidity-Vertrag, einem Solana-Programm, Greenfield, von zu Hause) zum Beispiel, das Ihrem Fall am nächsten kommt. Diese Seite ist die Ebene dazwischen: die **gesamte Oberfläche** und wie die Teile verbunden sind. ## Die Oberfläche auf einen Blick ### Grundlagen — darauf bauen Sie auf | Repository | Was es ist | Verwenden Sie es, wenn | | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | | [rome-registry](https://github.com/rome-protocol/rome-registry) | `@rome-protocol/registry` — schreibgeschützte, generierte Projektion von Fakten der Live-Chain (IDs, RPC, Adressen, Token-Mints, Programm-IDs, Oracle-Feeds, ALTs). | Sie benötigen einen echten Chain-Fakt — kodieren Sie ihn niemals fest. | | [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts) | `@rome-protocol/sdk` — der TypeScript-Schreibpfad: `submitRomeTx` + Gebührenbemessung, beide Lanes, PDA/ATA- + CPI-Encoder, Precompile-Bindings, ein `/bridge` -Client. | Sie schreiben App- oder Frontend-Code. | | [rome-solidity](https://github.com/rome-protocol/rome-solidity) | Solidity-Precompile-Schnittstellen, SPL/ERC-20-Wrapper und Oracle-Adapter — das Toolkit für die Vertragsseite. | Sie schreiben Verträge. | ### Referenz-Apps — anhand von Beispielen lernen | Repository | Was es ist | Verwenden Sie es, wenn | | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | | [rome-dex](https://github.com/rome-protocol/rome-dex) | Dual-Lane-AMM — ein nativer Solana-Pool mit einem schlanken EVM-Router. | Die andere Lane eröffnen; ein **native-core** -Beispiel. | | [aerarium](https://github.com/rome-protocol/aerarium) | Dual-Lane-Lending — ein Solidity-Comet-Kern, den Solana-Nutzer über einen synthetischen Sender erreichen. | Die andere Lane eröffnen; ein **Solidity-Kern** -Beispiel. | | [cardo](https://github.com/rome-protocol/cardo) | EVM-Nutzer steuern Solana-dApps (Swap/Stake/Lend/Perps) über CPI. | Eine ausgearbeitete CPI-zu-Solana-App zum Studieren. | | [appia](https://github.com/rome-protocol/appia) | Positionsorientiertes Cross-VM-DeFi; Nutzer erreichen es von ihrer Heimat-Chain aus. | Eine **von zu Hause** -App. | | [rome-aave-v3-demo](https://github.com/rome-protocol/rome-aave-v3-demo) | Aave-v3-Supply/Borrow/Repay, unverändert bereitgestellt. | Eine vollständige EVM-App, die unverändert läuft. | ### Contract-Forks — bekannte Protokolle, auf Rome bereitgestellt | Repository | Was es ist | Verwenden Sie es, wenn | | --------------------------------------------------------------------------------- | ------------------------------- | -------------------------------------- | | [compound-on-rome-comet](https://github.com/rome-protocol/compound-on-rome-comet) | Compound III (Comet) Geldmarkt. | Forken eines bekannten EVM-Protokolls. | | [rome-aave-v3](https://github.com/rome-protocol/rome-aave-v3) | Aave-v3-Contract-Fork. | Forken eines bekannten EVM-Protokolls. | ### Dienste — Ihre App ruft diese auf | Repository | Was es ist | Verwenden Sie es, wenn | | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------- | | [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) | Off-Chain-Orchestrator + Gebührensponsor für die On-Chain-Bridge. Hält keine Schlüssel. | Eine Wallet finanzieren oder ein Von-zu-Hause-Ablauf. | | [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) | Solana-Preisfeeds (Pyth, Switchboard), die über das Chainlink- `AggregatorV3Interface`. | Sie benötigen einen Preisfeed. | ### Scaffold — hier beginnen | Repository | Was es ist | Verwenden Sie es, wenn | | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | | [create-rome-app](https://github.com/rome-protocol/create-rome-app) | `npx github:rome-protocol/create-rome-app` — erstellt das Gerüst einer Dual-Lane-App, bereits mit Registry + SDK verdrahtet, samt Prüfung beider finanzierten Lanes. | Sie starten eine neue App. | ## Wie sie zusammenspielen ```mermaid flowchart TD REG["rome-registry — Live-Chain-Fakten"] SDK["rome-sdk-ts — Schreibvorgänge, CPI, Bridge-Client"] SOL["rome-solidity — Precompile-Schnittstellen, SPL-Wrapper, Oracle-Adapter"] CRA["create-rome-app — Scaffolder"] APP["Ihre App — Frontend + Verträge"] BAPI["rome-bridge-api — Off-Chain-Orchestrator, hält keine Schlüssel"] OG["rome-oracle-gateway — Solana-Preisfeeds"] CRA -->|erstellt Gerüst, vorverdrahtet| APP REG -->|Fakten, niemals fest kodiert| APP SDK -->|Schreibpfad & CPI| APP SOL -->|von Ihren Verträgen importiert| APP APP -->|SDK-/bridge-Client| BAPI APP -->|liest über AggregatorV3Interface| OG OG -.->|Adapter befinden sich in| SOL CRA -.->|verdrahtet| REG CRA -.->|verdrahtet| SDK ``` Das Rückgrat sind drei Grundlagen und ein Scaffolder: * [**rome-registry**](https://github.com/rome-protocol/rome-registry) ist die einzige Quelle für Live-Fakten. [**rome-sdk-ts**](https://github.com/rome-protocol/rome-sdk-ts) ist der Schreibpfad — und sein `/bridge` Unterpfad ist der Client, den Ihre App verwendet, um mit `rome-bridge-api`. [**rome-solidity**](https://github.com/rome-protocol/rome-solidity) ist das, was Ihre Verträge (und die Forks) importieren; die Oracle-Adapter, die `rome-oracle-gateway` bereitstellt, befinden sich ebenfalls dort. Die drei sind voneinander unabhängig — wählen Sie die, die Ihre App benötigt. * [**create-rome-app**](https://github.com/rome-protocol/create-rome-app) verbindet die ersten beiden für eine neue App, sodass ein neues Projekt bereits die Registry liest und über das SDK schreibt. Die Referenz-Apps sind die wissenswerte Ausnahme: **Sie stammen aus der Zeit vor den extrahierten Paketen.** cardo verwendet das Registry-Paket; appia projiziert die Registry zur Build-Zeit in statisches JSON; und beide binden ihren Schreibpfad selbst ein, statt das SDK zu importieren. Lesen Sie sie, um die Muster zu lernen — aber eine **neue** App sollte mit `create-rome-app` + den Paketen beginnen, nicht durch Klonen einer App. ## Navigieren Sie nach Ihrem Bedarf * **Ein Live-Chain-Fakt** (ID, Adresse, Mint, Programm-ID) → [rome-registry](https://github.com/rome-protocol/rome-registry). Niemals fest kodieren. * **App-Code schreiben** (ein Schreibvorgang, ein CPI-Aufruf, eine Bridge) → [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts); Referenz unter [Rome SDK](/de/produkte/rome-sdk.md). * **Verträge schreiben** → [rome-solidity](https://github.com/rome-protocol/rome-solidity); siehe [Solidity-Verträge bereitstellen](/de/entwicklerleitfaden/deploy-solidity.md). * **Ein Solana-Programm aus einem Solidity-Vertrag aufrufen** → das CPI-Precompile in [rome-solidity](https://github.com/rome-protocol/rome-solidity) (`interface.sol`); [cardo](https://github.com/rome-protocol/cardo) ist ein ausgearbeitetes Beispiel. * **Ein funktionierendes Beispiel** einer AMM-, Lending-, CPI- oder Von-zu-Hause-App → die obigen Referenz-Apps; jedes Repositorys `AGENTS.md` leitet nach Ausgangspunkt. * **Eine neue App mit Gerüst erstellen** → [create-rome-app](https://github.com/rome-protocol/create-rome-app). * **Ein Preisfeed** → [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) (siehe das [Oracle-Gateway-Portal](/de/apps-auf-rome/oracle-gateway.md)). * **Nutzer auf einer anderen Chain** → [Von zu Hause](/de/entwicklerleitfaden/from-home.md) + [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api). * **Entscheiden, welche Seite Ihre Logik enthält** → [Wählen Sie Ihren Kern](/de/wichtige-konzepte/choose-your-core.md). ## Die Grundlagenschicht aus der Nähe ### rome-registry — Live-Fakten, konstruktionsbedingt öffentlich Die Registry wird **generiert** aus Romes interner Quelle: Eine Allowlist gibt nur aus, was öffentlich sein soll, **ersetzt** interne Endpunkte durch ihre öffentlichen Entsprechungen und **verweigert standardmäßig** alles andere — daher ist sie konstruktionsbedingt öffentlich sicher. Sie veröffentlicht pro Chain `chain.json` / `tokens.json` / `contracts.json` / `oracle.json` / `bridge.json` / `alts.json`, plus Solana- `Programme` und App-Bereitstellungen pro Protokoll. Sie lesen sie über Getter — `getChain`, `getTokens`, `getContracts`, `getOracle`, `getBridge`, `getAlts`, und `getPrograms(network)` (Programm-IDs sind nach Netzwerk, nicht nach Chain-ID, geschlüsselt). Das Paket ist reines ESM (derzeit ohne gebündelte TypeScript-Typen). Zwei Dinge, die Sie wissen sollten, bevor Sie es einbinden: * **`getTokens()` gibt nicht `assetRef`.** zurück. Um den Wrapper eines Tokens zu finden, gleichen Sie dessen **Mint** (`mintId`) ab — z. B. ist der Wrapper des Gas-Tokens der Eintrag, der seinen Mint teilt. * **Es liest JSON von der Festplatte (`node:fs`) — es ist nicht browsersicher.** Projizieren Sie in einer Web-App die benötigten Werte zur Build-Zeit in eine statische JSON-Datei und importieren Sie diese im Client. (Genau das tun `create-rome-app` und appia.) Fakten, die Ihre App nicht live liest, erscheinen auch in der [Contract-Adressen](/de/referenz/contract-addresses.md) -Referenz. ### rome-sdk-ts — der Schreibpfad, beide Lanes `@rome-protocol/sdk` (v0.2.1) kapselt alles, was ein Rome-Schreibvorgang benötigt, damit Sie weder Calldata noch Gebühren selbst erstellen müssen: * **`submitRomeTx`** — der EVM-Lane-Schreibpfad: bemisst Gas anhand von `eth_estimateGas` (mit Puffer, mit einer Fallback-Obergrenze, falls die Schätzung zurückgesetzt wird) und stellt EIP-1559-Gebühren bereit. * **`submitRomeTxSolanaLane`** — dasselbe für eine **Phantom/Solana** -Wallet, die Ihre EVM-App steuert. Der synthetische Sender hält nichts dauerhaft; `buildFundLeg`/`buildSweepLeg` verschieben Wert hinein und hinaus als ERC-20 (`wUSDC`), **nicht** natives `msg.value`, und ein neuer synthetischer Sender wird bei der ersten Verwendung automatisch bereitgestellt (`create_pda`). * **PDA/ATA-Ableitung, CPI `invoke`/`invoke_signed` -Encoder, Precompile-Bindings**, und ein **`/bridge`** Unterpfad (`@rome-protocol/sdk/bridge`) — Bridge-Client mit Quote-first-Ansatz. Vollständige API + Beispiele: [Rome SDK](/de/produkte/rome-sdk.md), und die Anleitungen [Solana aus EVM aufrufen](/de/entwicklerleitfaden/call-solana-from-evm.md), [EVM aus Solana aufrufen](/de/entwicklerleitfaden/call-evm-from-solana.md), und [Eine Dual-Lane-App erstellen](/de/entwicklerleitfaden/dual-lane-app.md). ### rome-solidity — das Toolkit für die Vertragsseite Was Ihre Verträge importieren: * **`contracts/interface.sol`** — die an ihre Adressen gebundenen Precompile-Schnittstellen: **CPI** `ICrossProgramInvocation` (`0xFF…08`), **Helper** `IHelperProgram` (`0xFF…09`, ATA/PDA-Erstellung, SPL-Transfers, Gas↔Lamports), **Withdraw** `IWithdraw` (`0x42…16`), und **System** (`0xFF…07`). Eine gasoptimierte **gecachte** Familie befindet sich ebenfalls hier; ein Vertrag verwendet durchgehend einen Pfad. Vollständige Adresstabelle: [Contract-Adressen](/de/referenz/contract-addresses.md). * **SPL/ERC-20-Wrapper** — `SPL_ERC20` (CPI-basiert) und `SPL_ERC20_cached` (der gecachte Pfad, der auf Devnet verwendet wird); jeder SPL-Mint ist durch diese bereits ein ERC-20. * **Oracle-Adapter** (`contracts/oracle/`) — die Pyth-/Switchboard-Adapter `rome-oracle-gateway` stellt bereit, gelesen über `IAggregatorV3Interface`. * Ausgearbeitete Beispiele in `contracts/examples/`. Der Solidity-SDK-Abschnitt von [Rome SDK](/de/produkte/rome-sdk.md) zeigt die Importmuster und die Precompile-Bindings im Code. ## Was als Nächstes kommt * [Wählen Sie Ihren Kern](/de/wichtige-konzepte/choose-your-core.md) — welche Seite Ihre Logik enthält. * [Schnellstart](/de/erste-schritte/quickstart.md) — stellen Sie Ihren ersten Vertrag bereit. * [create-rome-app](https://github.com/rome-protocol/create-rome-app) — erstellen Sie das Gerüst einer Dual-Lane-App. * Jedes Repositorys `AGENTS.md` — der nach Ausgangspunkt geordnete Weg zum nächstgelegenen Beispiel. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.rome.builders/de/erste-schritte/ecosystem.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.