> 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/tr/baslarken-1/ecosystem.md).

# Ekosistem ve repolar

Her herkese açık Rome deposu, ne olduğu ve nasıl bir araya geldikleri — yüzeyde gezinmek için harita.

Rome'un herkese açık yüzeyi bir dizi depodan oluşur: birkaç **temel** üzerine geliştirdiğiniz paketler, bir iskelet oluşturucu, öğrenmek için örnek uygulamalar ve uygulamanızın çağırdığı iki hizmet. Bu sayfa bir haritadır — her bir deponun ne olduğu ve nasıl bir araya geldikleri.

İki komşu farklı soruları yanıtlar ve bu sayfa onları tekrar etmek yerine ikisine de bağlantı verir:

* [Mimari](https://docs.rome.builders/tr/baslarken-1/architecture.md) açıklar **protokolü** — EVM'nin bir Solana programı içinde nasıl çalıştığını.
* Her depo bir **`AGENTS.md`** (örn. [rome-sdk-ts/AGENTS.md](https://github.com/rome-protocol/rome-sdk-ts/blob/main/AGENTS.md)) ve yönlendirmeyi şuna göre yapar: **neyden başladığınıza** (bir Solidity sözleşmesi, bir Solana programı, sıfırdan bir proje, kendi zincirinden) bunu durumunuza en yakın örneğe göre yapar.

Bu sayfa aradaki seviyedir:  **tüm yüzey** ve parçaların nasıl bağlandığı.

## Yüzeye bir bakış

### Temel — bunların üzerine kurun

| Depo                                                            | Nedir                                                                                                                                                                                      | Şunlar için başvurun:                                                   |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| [rome-registry](https://github.com/rome-protocol/rome-registry) | `@rome-protocol/registry` — salt okunur, canlı zincir verilerinin üretilmiş bir yansımasıdır (kimlikler, RPC, adresler, token mint'leri, program kimlikleri, oracle beslemeleri, ALT'ler). | Gerçek bir zincir verisine ihtiyacınız varsa onu asla sabit kodlamayın. |
| [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts)     | `@rome-protocol/sdk` — TypeScript yazma yolu: `submitRomeTx` + ücret boyutlandırma, her iki hat, PDA/ATA + CPI kodlayıcıları, precompile bağlamaları, bir `/bridge` istemci.               | Uygulama veya ön yüz kodu yazıyorsunuz.                                 |
| [rome-solidity](https://github.com/rome-protocol/rome-solidity) | Solidity precompile arayüzleri, SPL/ERC-20 sarmalayıcıları ve oracle bağdaştırıcıları — sözleşme tarafı araç seti.                                                                         | Sözleşmeler yazıyorsunuz.                                               |

Şu `@rome-protocol/…` yukarıdaki adlar paket adlarıdır, ancak paketler npm'de yayımlanmamıştır. Bunları GitHub'dan yükleyin (komutlar her bölümde [Temel katman, yakından](#the-foundation-layer-up-close)); kodunuzdaki içe aktarma yolları aynı kalır.

### Rome ZK EVM rollup'ları

| Depo                                                            | Nedir                                                        | Şunlar için başvurun:                                            |
| --------------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------- |
| [solana-zk-evm](https://github.com/rome-protocol/solana-zk-evm) | ZK rollup programları, düğüm, prover ve operatör belgeleri.  | Solana'da uzlaşan bir EVM zinciri işletiyorsunuz.                |
| [rome-zk-guest](https://github.com/rome-protocol/rome-zk-guest) | Her zincirin genesis'i için oluşturulan toplu guest kaynağı. | Bir guest oluşturuyor ve doğrulama anahtarını talep ediyorsunuz. |

### Ostia (Canton üzerinde ZK EVM)

| Depo                                                                                  | Nedir                                                                                                                              | Şunlar için başvurun:                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/README.md) | Ostia, Canton üzerindeki bir ZK EVM'dir: kanıtlanmış her EVM bloğu, kendi Canton işlemleriyle birlikte tek bir işlemde kaydedilir. | Ostia DevNet üzerinde geliştiriyorsunuz ([explorer](https://ostia.devnet.romeprotocol.xyz/)) ya da kendi Ostia'nızı çalıştırıyorsunuz. Bkz. [Canton ZK EVM](https://docs.rome.builders/tr/canton-zk-evm/canton-zk-evm.md). |

### Referans uygulamalar — örnekle öğrenin

| Depo                                                                    | Nedir                                                                                                                       | Şunlar için başvurun:                                       |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| [rome-dex](https://github.com/rome-protocol/rome-dex)                   | Çift hatlı AMM — ince bir EVM yönlendiricisine sahip yerel bir Solana havuzu.                                               | Diğer hattı açmak; bir **native-core** örneği.              |
| [aerarium](https://github.com/rome-protocol/aerarium)                   | Çift hatlı kredi verme — Solana kullanıcılarının sentetik bir gönderici aracılığıyla ulaştığı bir Solidity Comet çekirdeği. | Diğer hattı açmak; bir **Solidity çekirdek** örneği.        |
| [cardo](https://github.com/rome-protocol/cardo)                         | EVM kullanıcılarının CPI aracılığıyla Solana dApp'lerini (swap/stake/lend/perps) yönlendirmesi.                             | İncelenebilecek, çalışılmış bir CPI'dan Solana'ya uygulama. |
| [appia](https://github.com/rome-protocol/appia)                         | Pozisyon-öncelikli, VM'ler arası DeFi; kullanıcılar ona kendi zincirlerinden ulaşır.                                        | Bir **kendi zincirinden** uygulama.                         |
| [rome-aave-v3-demo](https://github.com/rome-protocol/rome-aave-v3-demo) | Aave v3 yatır/borç al/geri öde, değişiklik yapılmadan dağıtılmış.                                                           | Olduğu gibi çalışan tam bir EVM uygulaması.                 |

### Sözleşme çatalları — Rome üzerinde dağıtılmış bilinen protokoller

| Depo                                                                              | Nedir                               | Şunlar için başvurun:                   |
| --------------------------------------------------------------------------------- | ----------------------------------- | --------------------------------------- |
| [compound-on-rome-comet](https://github.com/rome-protocol/compound-on-rome-comet) | Compound III (Comet) para piyasası. | Bilinen bir EVM protokolünü çatallamak. |
| [rome-aave-v3](https://github.com/rome-protocol/rome-aave-v3)                     | Aave v3 sözleşme çatalı.            | Bilinen bir EVM protokolünü çatallamak. |

### Hizmetler — uygulamanız bunları çağırır

| Depo                                                                        | Nedir                                                                                                        | Şunlar için başvurun:                                 |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
| [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api)         | Zincir dışı orkestratör + zincir üstü köprü için ücret sponsorluğu. Anahtar tutmaz.                          | Bir cüzdanı fonlamak veya kendi zincirinden bir akış. |
| [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) | Solana fiyat beslemeleri (Pyth, Switchboard), EVM'ye Chainlink aracılığıyla sunulur `AggregatorV3Interface`. | Bir fiyat beslemesine ihtiyacınız var.                |

### İskelet oluştur — buradan başlayın

| Depo                                                                | Nedir                                                                                                                                                                         | Şunlar için başvurun:         |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| [create-rome-app](https://github.com/rome-protocol/create-rome-app) | `npx github:rome-protocol/create-rome-app` — kayıt defteri + SDK'ya önceden bağlanmış, çift hatlı bir uygulama iskeleti oluşturur; her iki hat için fonlu bir kontrol içerir. | Yeni bir uygulamaya başlamak. |

## Nasıl bir araya gelirler

```mermaid
flowchart TD
    REG["rome-registry — canlı zincir verileri"]
    SDK["rome-sdk-ts — yazmalar, CPI, köprü istemcisi"]
    SOL["rome-solidity — precompile arayüzleri, SPL sarmalayıcıları, oracle bağdaştırıcıları"]
    CRA["create-rome-app — iskelet oluşturucu"]
    APP["uygulamanız — ön yüz + sözleşmeler"]
    BAPI["rome-bridge-api — zincir dışı orkestratör, anahtar tutmaz"]
    OG["rome-oracle-gateway — Solana fiyat beslemeleri"]

    CRA -->|iskelet oluşturur, önceden bağlanmış| APP
    REG -->|veriler, asla sabit kodlanmaz| APP
    SDK -->|yazma yolu ve CPI| APP
    SOL -->|sözleşmeleriniz tarafından içe aktarılır| APP
    APP -->|SDK /bridge istemcisi| BAPI
    APP -->|AggregatorV3Interface üzerinden okur| OG
    OG -.->|bağdaştırıcılar burada bulunur| SOL
    CRA -.->|bağlar| REG
    CRA -.->|bağlar| SDK
```

Omurga üç temel ve bir iskelet oluşturucudan oluşur:

* [**rome-registry**](https://github.com/rome-protocol/rome-registry) canlı verilerin tek kaynağıdır. [**rome-sdk-ts**](https://github.com/rome-protocol/rome-sdk-ts) yazma yoludur — ve onun `/bridge` alt yolu, uygulamanızın konuşmak için kullandığı istemcidir `rome-bridge-api`. [**rome-solidity**](https://github.com/rome-protocol/rome-solidity) sözleşmelerinizin (ve çatalların) içe aktardığı şey budur; oracle bağdaştırıcıları da `rome-oracle-gateway` burada dağıtılır. Bu üçü birbirinden bağımsızdır — uygulamanızın ihtiyaç duyduklarını seçin.
* [**create-rome-app**](https://github.com/rome-protocol/create-rome-app) yeni bir uygulama için ilk ikisini birbirine bağlar; böylece yeni bir proje daha baştan kayıt defterini okuyup SDK üzerinden yazmaya başlar.

Referans uygulamalar bilinmesi gereken istisnadır: **çıkarılmış paketlerden önce gelirler.** cardo kayıt defteri paketini kullanır; appia kayıt defterini derleme zamanında statik JSON'a projeler; ve her ikisi de SDK'yı içe aktarmak yerine yazma yollarını kendi içinde barındırır. Desenleri öğrenmek için onları okuyun — ama bir **yeni** uygulama şunlardan başlamalıdır: `create-rome-app` + paketlerden, bir uygulamayı klonlayarak değil.

## İhtiyacınıza göre gezinin

* **Canlı zincir verisi** (kimlik, adres, mint, program kimliği) → [rome-registry](https://github.com/rome-protocol/rome-registry). Asla sabit kodlamayın.
* **Uygulama kodu yazma** (bir yazma, bir CPI çağrısı, bir köprü) → [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts); başvuru: [Rome SDK](https://docs.rome.builders/tr/urunler/rome-sdk.md).
* **Sözleşme yazma** → [rome-solidity](https://github.com/rome-protocol/rome-solidity); bkz. [Solidity Sözleşmeleri Dağıtma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/deploy-solidity.md).
* **Bir Solidity sözleşmesinden bir Solana programı çağırma** → içindeki CPI precompile'ı [rome-solidity](https://github.com/rome-protocol/rome-solidity) (`interface.sol`); [cardo](https://github.com/rome-protocol/cardo) çalışılmış bir örnektir.
* **Çalışan bir örnek** bir AMM, kredi verme, CPI veya kendi zincirinden bir uygulamanın → yukarıdaki referans uygulamalar; her deponun `AGENTS.md` yönlendirmesi başlangıç noktasına göredir.
* **Yeni bir uygulama iskeleti oluşturma** → [create-rome-app](https://github.com/rome-protocol/create-rome-app).
* **Bir fiyat beslemesi** → [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) (bkz. [Oracle Gateway portalı](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/oracle-gateway.md)).
* **Başka bir zincirdeki kullanıcılar** → [Kendi zincirinden](https://docs.rome.builders/tr/gelistirici-kilavuzlari/from-home.md) + [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api).
* **Mantığınızın hangi tarafta olduğunu seçme** → [Çekirdeğinizi seçin](https://docs.rome.builders/tr/temel-kavramlar/choose-your-core.md).

## Temel katman, yakından

### rome-registry — canlı veriler, tasarım gereği herkese açık

Kayıt defteri **üretilir** Rome'un iç kaynağından: bir izin listesi yalnızca herkese açık olması amaçlananları çıkarır, **yerine koyar** iç uç noktaları bunların herkese açık eşdeğerleriyle değiştirir ve **varsayılan olarak reddeder** diğer her şeyi — böylece tasarım gereği herkese açık kullanıma uygundur. Her zincir için şunları yayımlar: `chain.json` / `tokens.json` / `contracts.json` / `oracle.json` / `bridge.json` / `alts.json`, ayrıca Solana `programları` ve protokol bazında uygulama dağıtımlarını.

Bir sürüm etiketine sabitlenmiş halde GitHub'dan yükleyin: `npm install github:rome-protocol/rome-registry#v0.2.0`. Bunu getter'lar aracılığıyla okursunuz — `getChain`, `getTokens`, `getContracts`, `getOracle`, `getBridge`, `getAlts`, ve `getPrograms(network)` (program kimlikleri zincir kimliğine göre değil, ağ'a göre anahtarlanır). Paket saf ESM'dir (şu anda gömülü TypeScript türleri yoktur).

Bunu entegre etmeden önce bilmeniz gereken iki şey:

* **`getTokens()` şunu döndürmez `assetRef`.** Bir token'ın sarmalayıcısını bulmak için onunla eşleştirin: **mint** (`mintId`) — örn. gas token'ının sarmalayıcısı, mint'ini paylaşan girdidir.
* **JSON'u diskten okur (`node:fs`) — tarayıcı için güvenli değildir.** Bir web uygulamasında, ihtiyacınız olan değerleri derleme zamanında statik bir JSON dosyasına projelendirin ve bunu istemcide içe aktarın. (Bu tam olarak `create-rome-app` ve appia'nın yaptığı şeydir.)

Sözleşme adresleri, her sözleşme için sürüm listesi olarak döner; hangisinin `durumu` şu `canlı`. [Sözleşme listesini okumak](https://docs.rome.builders/tr/referans/contract-addresses.md#reading-the-contracts-list) nasıl yapıldığını gösterir. Uygulamanızın canlı okumadığı veriler de [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md) başvurusunda yer alır.

### rome-sdk-ts — yazma yolu, her iki hat

GitHub'dan yükleyin: `npm install github:rome-protocol/rome-sdk-ts#v0.4.0`.

`@rome-protocol/sdk` (v0.4.0), bir Rome yazmasının ihtiyaç duyduğu her şeyi sarar; böylece calldata veya ücretleri elle oluşturmazsınız:

* **`submitRomeTx`** — EVM hattı yazma yolu: gazı buna göre boyutlandırır `eth_estimateGas` (dolgu ile, tahmin başarısız olursa yedek bir üst sınırla) ve EIP-1559 ücretleri sağlar.
* **`submitRomeTxV1`** — aynısı, bir **Solana cüzdanı** EVM uygulamanızı yönlendirirken: her çağrı için bir Solana v1 işlemi, iki cüzdan istemi. Sentetik gönderici dinlenmede hiçbir şey tutmaz; `buildFundLeg`/`buildSweepLeg` değeri bir ERC-20 olarak içeri ve dışarı taşır (`wUSDC`), **değil** yerel `msg.value`; bir çağrı etrafındaki düz Solana talimatları (fonlama ayağı, bir sweep öncesi cüzdan token hesabı oluşturma) şuradan geçer: `submitSolanaInstructionsV1` v1 işlemleri olarak da. `submitRomeTxSolanaLane` istemcide eski tip bir Solana işlemi oluşturan ve otomatik olarak yeni bir sentetik`create_pda`)i ilk kullanımda oluşturur.
* **PDA/ATA türetme, CPI `invoke`/`invoke_signed` kodlayıcılar, precompile bağlamaları**, ve bir **`/bridge`** alt yol (`@rome-protocol/sdk/bridge`) — önce teklif alan köprü istemcisi.

Tam API + örnekler: [Rome SDK](https://docs.rome.builders/tr/urunler/rome-sdk.md), ve kılavuzlar [EVM'den Solana'yı çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md), [Solana'dan EVM'yi çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-evm-from-solana.md), ve [Çift hatlı bir uygulama oluşturma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/dual-lane-app.md).

### rome-solidity — sözleşme tarafı araç seti

Bunu npm'den değil, GitHub'dan yükleyin. npm veya Hardhat ile: `npm install github:rome-protocol/rome-solidity`. Foundry ile: `forge install rome-protocol/rome-solidity`, ardından yeniden eşlemeyi ekleyin `@rome-protocol/rome-solidity/=lib/rome-solidity/` şuraya `foundry.toml` (altında `[profile.default]`, olarak `remappings = [...]`) böylece `@rome-protocol/rome-solidity/contracts/interface.sol` çözülür. İçindeki paket adı `package.json` şu `@rome-protocol/rome-solidity`, bu yüzden aynı içe aktarma yolu ikisiyle de çalışır.

Sözleşmelerinizin içe aktardığı şey:

* **`contracts/interface.sol`** — adreslerine bağlanmış precompile arayüzleri: **CPI** `ICrossProgramInvocation` (`0xFF…08`), **Yardımcı** `IHelperProgram` (`0xFF…09`, ATA/PDA oluşturma, SPL transferleri, gas↔lamports), **Çekme** `IWithdraw` (`0x42…16`), ve **Sistem** (`0xFF…07`). Gaz için optimize edilmiş bir **önbelleğe alınmış** aile de burada bulunur; bir sözleşme tutarlı şekilde tek bir hattı kullanır. Tam adres tablosu: [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md).
* **SPL/ERC-20 sarmalayıcıları** — `SPL_ERC20` (CPI tabanlı) ve `SPL_ERC20_cached` (önbelleğe alınmış hat, devnet'te kullanılır); herhangi bir SPL mint bu sayede zaten bir ERC-20 olur.
* **Oracle bağdaştırıcıları** (`contracts/oracle/`) — Pyth/Switchboard bağdaştırıcıları `rome-oracle-gateway` dağıtılır, şu yolla okunur: `IAggregatorV3Interface`.
* İçindeki çalışılmış örnekler `contracts/examples/`.

Solidity SDK bölümünde [Rome SDK](https://docs.rome.builders/tr/urunler/rome-sdk.md) içe aktarma kalıplarını ve kod içindeki precompile bağlamalarını gösterir.

## Sırada ne var

* [Çekirdeğinizi seçin](https://docs.rome.builders/tr/temel-kavramlar/choose-your-core.md) — mantığınızın hangi tarafta olduğuna göre.
* [Hızlı başlangıç](https://docs.rome.builders/tr/baslarken-1/quickstart.md) — ilk sözleşmenizi dağıtın.
* [create-rome-app](https://github.com/rome-protocol/create-rome-app) — çift hatlı bir uygulama iskeleti oluşturun.
* Her deponun `AGENTS.md` — başlangıç noktasına göre en yakın örneğe giden rota.


---

# 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/tr/baslarken-1/ecosystem.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.
