> 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/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 kamuya açık yüzeyi birkaç depodan oluşan bir kümedir: birkaç **temel** üzerine inşa ettiğiniz paketler, bir iskelet kurucu, öğrenmek için başvurulacak referans uygulamalar ve uygulamanızın çağırdığı iki hizmet. Bu sayfa haritadır — her bir deponun ne olduğu ve bunların nasıl bir araya geldiği.

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

* [Mimari](/tr/baslarken/architecture.md) açıklar **protokolü** — EVM'nin bir Solana programının 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)) dosyasıyla gelir; bu dosya sizi **nereden başladığınıza** göre (bir Solidity sözleşmesi, bir Solana programı, sıfırdan, başka bir zincirden) sizin durumunuza en yakın örneğe yönlendirir.

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

## Yüzeye hızlı bakış

### Temel — bunlar üzerine inşa edin

| Depo                                                            | Nedir                                                                                                                                                                                | Ne zaman kullanılır                                                   |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
| [rome-registry](https://github.com/rome-protocol/rome-registry) | `@rome-protocol/registry` — salt okunur, canlı zincir verilerinin üretilmiş projeksiyonu (kimlikler, RPC, adresler, token mint'leri, program kimlikleri, oracle feed'leri, ALT'ler). | Gerçek bir zincir verisine ihtiyacınız olduğunda — asla sabitlemeyin. |
| [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts)     | `@rome-protocol/sdk` — TypeScript yazma yolu: `submitRomeTx` + ücret boyutlandırma, iki hat, PDA/ATA + CPI kodlayıcıları, precompile bağlamaları, bir `/bridge` istemcisi.           | 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şme yazıyorsunuz.                                                |

Yukarıdaki `@rome-protocol/…` adları paket adlarıdır, ancak paketler npm'e yayınlanmaz. Bunları GitHub'dan kurun (komutlar her bölümde [Temel katmanı, yakından](#the-foundation-layer-up-close)) altında yer alır); kodunuzdaki import yolları aynı kalır.

### Rome ZK EVM rollupları

| Depo                                                            | Nedir                                                            | Ne zaman kullanılır                                         |
| --------------------------------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------- |
| [solana-zk-evm](https://github.com/rome-protocol/solana-zk-evm) | ZK rollup programları, düğüm, prover ve operatör belgeleri.      | Solana üzerinde kapanan bir EVM zinciri çalıştırıyorsunuz.  |
| [rome-zk-guest](https://github.com/rome-protocol/rome-zk-guest) | Her zincirin genesis'i için oluşturulan toplu konuk kaynak kodu. | Bir guest oluşturuyor ve doğrulama anahtarını istiyorsunuz. |

### Canton ZK EVM

| Depo                                                                                                                    | Nedir                                                                                                             | Ne zaman kullanılır                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| [canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm/blob/a84e84e439a5cc669c0ae61facf7c8c995d9d564/README.md) | Ostia, kanıtlanmış EVM bloklarını ve Canton eylemlerini tek işlemde kapatan bir Canton zkEVM'nin erken sürümüdür. | Yerel demoyu çalıştırıyorsunuz veya ağ geçidi ve kanıt kontrollerini inceliyorsunuz. Bkz. [Canton ZK EVM](/tr/canton-zk-evm/canton-zk-evm.md). |

### Referans uygulamalar — örnekle öğrenin

| Depo                                                                    | Nedir                                                                                                                       | Ne zaman kullanılır                                       |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| [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çma; bir **yerel çekirdek** ö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çma; bir **Solidity çekirdeği** ö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) çalıştırması.                              | İncelenebilecek, uygulamalı bir CPI-to-Solana uygulaması. |
| [appia](https://github.com/rome-protocol/appia)                         | Pozisyon-öncelikli çapraz-VM 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 supply/borrow/repay, değişiklik yapılmadan dağıtılmış.                                                              | Olduğu gibi çalışan tam bir EVM uygulaması.               |

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

| Depo                                                                              | Nedir                               | Ne zaman kullanılır                    |
| --------------------------------------------------------------------------------- | ----------------------------------- | -------------------------------------- |
| [compound-on-rome-comet](https://github.com/rome-protocol/compound-on-rome-comet) | Compound III (Comet) para piyasası. | Bilinen bir EVM protokolünü çatallama. |
| [rome-aave-v3](https://github.com/rome-protocol/rome-aave-v3)                     | Aave v3 sözleşme çatallaşması.      | Bilinen bir EVM protokolünü çatallama. |

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

| Depo                                                                        | Nedir                                                                                                       | Ne zaman kullanılır                                        |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api)         | Zincir dışı orkestratör + zincir üzerindeki köprü için ücret sponsoru. Anahtar tutmaz.                      | Bir cüzdanı finanse etmek veya kendi zincirinden bir akış. |
| [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) | Solana fiyat feed'lerinin (Pyth, Switchboard) EVM'ye Chainlink üzerinden sunulması `AggregatorV3Interface`. | Bir fiyat feed'ine ihtiyacınız var.                        |

### İskelet kurucu — buradan başlayın

| Depo                                                                | Nedir                                                                                                                                                                        | Ne zaman kullanılır          |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| [create-rome-app](https://github.com/rome-protocol/create-rome-app) | `npx github:rome-protocol/create-rome-app` — registry + SDK ile önceden bağlanmış, çift hatlı bir uygulama iskeleti oluşturur; iki hat için de fonlanmış bir kontrol içerir. | Yeni bir uygulama başlatmak. |

## Nasıl birleşiyorlar

```mermaid
flowchart TD
    REG["rome-registry — canlı zincir verileri"]
    SDK["rome-sdk-ts — yazma, CPI, bridge istemcisi"]
    SOL["rome-solidity — precompile arayüzleri, SPL sarmalayıcıları, oracle bağdaştırıcıları"]
    CRA["create-rome-app — iskelet kurucu"]
    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 feed'leri"]

    CRA -->|iskelet kurar, ö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 yaşar| SOL
    CRA -.->|bağlar| REG
    CRA -.->|bağlar| SDK
```

Omurga üç temel ve bir iskelet kurucudan 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 `rome-bridge-api`. [**rome-solidity**](https://github.com/rome-protocol/rome-solidity) ile konuşmak için kullandığı istemcidir; `rome-oracle-gateway` sözleşmelerinizin (ve çatalların) içe aktardığı şeydir; orada dağıtılan oracle bağdaştırıcıları da bulunur. Üçü 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 bir araya getirir; böylece yeni bir proje daha baştan registry'yi okuyup SDK üzerinden yazarak başlar.

Referans uygulamalar bilinmesi gereken istisnadır: **bunlar, çıkarılan paketlerden önce vardı.** cardo registry paketini kullanır; appia registry'yi derleme sırasında statik JSON'a projekte eder; ve ikisi de SDK'yı içe aktarmak yerine kendi yazma yolunu paketler. Kalıpları öğrenmek için onları okuyun — ama bir **yeni** uygulama `create-rome-app` + paketlerden başlamalı, bir uygulamayı klonlayarak değil.

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

* **Canlı bir zincir verisi** (id, address, mint, program id) → [rome-registry](https://github.com/rome-protocol/rome-registry). Asla sabitlemeyin.
* **Uygulama kodu yazma** (bir yazma işlemi, bir CPI çağrısı, bir bridge) → [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts); referans: [Rome SDK](/tr/urunler/rome-sdk.md).
* **Sözleşme yazma** → [rome-solidity](https://github.com/rome-protocol/rome-solidity); bkz. [Solidity Sözleşmelerini Dağıtma](/tr/gelistirici-kilavuzlari/deploy-solidity.md).
* **Bir Solidity sözleşmesinden bir Solana programını çağırma** → içindeki CPI precompile'ı [rome-solidity](https://github.com/rome-protocol/rome-solidity) (`interface.sol`); [cardo](https://github.com/rome-protocol/cardo) uygulamalı bir örnektir.
* **Çalışan bir örnek** bir AMM, lending, CPI veya kendi zincirinden uygulama → yukarıdaki referans uygulamaları; her deponun `AGENTS.md` başlangıç noktasına göre yönlendirir.
* **Yeni bir uygulama için iskelet oluşturma** → [create-rome-app](https://github.com/rome-protocol/create-rome-app).
* **Bir fiyat feed'i** → [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) (bakınız [Oracle Gateway portalı](/tr/rome-uzerindeki-uygulamalar/oracle-gateway.md)).
* **Başka bir zincirdeki kullanıcılar** → [Kendi zincirinden](/tr/gelistirici-kilavuzlari/from-home.md) + [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api).
* **Mantığınızın hangi tarafta tutulacağına karar verme** → [Çekirdeğinizi seçin](/tr/temel-kavramlar/choose-your-core.md).

## Temel katmanı, yakından

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

Registry **üretilir** Rome'un dahili kaynağından: bir allowlist yalnızca herkese açık olması amaçlananı yayar, **dönüştürür** dahili uç noktaları onların herkese açık karşılıklarıyla değiştirir ve **varsayılan olarak reddeder** geri kalan her şeyi — böylece tasarım gereği herkese açıktır. Zincir başına şunları yayınlar: `chain.json` / `tokens.json` / `contracts.json` / `oracle.json` / `bridge.json` / `alts.json`, ayrıca Solana `programlarını` ve protokole göre uygulama dağıtımlarını.

Bunu GitHub'dan, bir sürüm etiketiyle sabitleyerek kurun: `npm install github:rome-protocol/rome-registry#v0.2.0`. Bunu getter'lar üzerinden okursunuz — `getChain`, `getTokens`, `getContracts`, `getOracle`, `getBridge`, `getAlts`ve `getPrograms(network)` (program kimlikleri zincir kimliğine değil, ağa göre anahtarlanır). Paket düz ESM'dir (bugün yerleşik TypeScript tipleri yok).

Bunu entegre etmeden önce bilinmesi gereken iki şey:

* **`getTokens()` döndürmez `assetRef`.** Bir token'ın sarmalayıcısını bulmak için onun **mint** (`mintId`) ile eşleşmesini kontrol edin — örneğin gaz token'ının sarmalayıcısı aynı mint'i paylaşan girdidir.
* **JSON'u diskten okur (`node:fs`) — tarayıcı için güvenli değildir.** Bir web uygulamasında, ihtiyaç duyduğunuz değerleri derleme zamanında statik bir JSON dosyasına projekte edin ve istemcide onu içe aktarın. (Bunu tam olarak `create-rome-app` ve appia yapar.)

Sözleşme adresleri, sözleşme başına sürüm listesi olarak geri döner; `durumunun` olduğu `canlı`. [Sözleşmeler listesini okumak](/tr/referans/contract-addresses.md#reading-the-contracts-list) bunu nasıl yaptığını gösterir. Uygulamanızın canlı okumadığı veriler de [Sözleşme Adresleri](/tr/referans/contract-addresses.md) referansında yer alır.

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

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

`@rome-protocol/sdk` (v0.4.0) bir Rome yazımı için gereken her şeyi sarar; böylece calldata veya ücretleri el ile oluşturmanız gerekmez:

* **`submitRomeTx`** — EVM hattı yazma yolu: gazı `eth_estimateGas` üzerinden boyutlandırır (yuvarlanmış, tahmin hata verirse yedek bir üst sınırla) ve EIP-1559 ücretlerini sağlar.
* **`submitRomeTxV1`** — aynı işlem, bir **Solana cüzdanı** ile EVM uygulamanızı sürmek için: her çağrıda bir Solana v1 işlemi, iki cüzdan istemi. Sentetik gönderici dinlenme halinde hiçbir şey tutmaz; `buildFundLeg`/`buildSweepLeg` değerleri bir ERC-20 olarak içeri ve dışarı taşır (`wUSDC`), **değil** yerel `msg.value`; bir çağrı çevresindeki düz Solana talimatları (fon bacağı, sweep öncesinde cüzdan token hesabı oluşturma) da `submitSolanaInstructionsV1` üzerinden v1 işlemleri olarak gider. `submitRomeTxSolanaLane` daha önceki yoldur; istemcide eski tip bir Solana işlemi oluşturur ve ilk kullanımda yeni bir sentetik (`create_pda`) otomatik olarak sağlar.
* **PDA/ATA türetimi, CPI `invoke`/`invoke_signed` kodlayıcıları, precompile bağlamaları**, ve bir **`/bridge`** alt yol (`@rome-protocol/sdk/bridge`) — önce teklif alma odaklı bridge istemcisi.

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

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

Bunu npm'den değil, GitHub'dan kurun. npm veya Hardhat ile: `npm install github:rome-protocol/rome-solidity`. Foundry ile: `forge install rome-protocol/rome-solidity`, ardından eşleştirmeyi ekleyin `@rome-protocol/rome-solidity/=lib/rome-solidity/` buna `foundry.toml` (altında `[profile.default]`, şöyle `remappings = [...]`böylece `@rome-protocol/rome-solidity/contracts/interface.sol` çözülür. İçindeki paket adı `package.json` olduğu `@rome-protocol/rome-solidity`olduğundan aynı import yolu her ikisinde de çalışır.

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

* **`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), **Çekim** `IWithdraw` (`0x42…16`), ve **Sistem** (`0xFF…07`). Gaz açısından optimize edilmiş bir **önbelleğe alınmış** aile de burada yer alır; bir sözleşme tek bir hattı tutarlı biçimde kullanır. Tam adres tablosu: [Sözleşme Adresleri](/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'dir.
* **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 uygulamalı örnekler `contracts/examples/`.

bölümü [Rome SDK](/tr/urunler/rome-sdk.md) import kalıplarını ve precompile bağlamalarını kod içinde gösterir.

## Sırada ne var

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


---

# 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/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.