> 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/architecture.md).

# Mimari

Rome'un bileşenlerinin nasıl bir araya geldiği — bir Solana programı içinde EVM yürütmesi.

Rome, bir Solana zincir üstü programı içine bir EVM bytecode yorumlayıcısı yerleştirir. EVM-anahtarlı hatta, kullanıcılar standart Ethereum JSON-RPC üzerinden imzalı EVM işlemlerini Rome Proxy'ye gönderir. Proxy bunları Solana'daki Rome EVM programına iletir. Tek bir EVM işlemi, holder hesaplarına parçalar yazmak veya yinelemeli yürütme çalıştırmak için birden fazla Solana işlemi gerektirebilir. v1 Solana-anahtarlı hatta, proxy işlemi oluşturur. Solana cüzdanı bunu imzalar ve doğrudan Solana RPC'ye gönderir. Senkronize edilecek ayrı bir yürütme katmanı yoktur — EVM durumu *şu* Solana durumu.

## Sistem genel görünümü

<figure><img src="https://4222476421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-4d7d386c95b500079204f3dea2103d9759c5de8f%2Farchitecture.svg?alt=media" alt="EVM wallet and Solana wallet connected to Rome Proxy with its emulator. The Solana cluster holds the Rome EVM program, per-chain state, external-authority PDA, token accounts, Solana programs and holder accounts. Hercules feeds blocks, receipts and logs back to the proxy."><figcaption></figcaption></figure>

## Bileşenler

### Rome EVM Programı (zincir üstü)

Rome'un çekirdeği — tam bir EVM bytecode yorumlayıcısı (SputnikVM'in bir çatallanması) içeren bir Solana BPF programı. Şunları yapar:

* İmzalı EVM işlemlerini ve imzasız EIP-1559 gövdelerini Solana talimatları olarak alır. Bir Solana anahtarı, imzasız bir gövdeyi Solana ücret ödeyeninin imzası veya bir Ed25519 doğrulayıcı talimatı aracılığıyla yetkilendirir
* Solidity bytecode'unu Solana çalışma zamanının içinde yürütür
* Her Ethereum adresini (H160), nonce'unu, yerel bakiyesini ve kodunu içeren, zincir başına bir bakiye PDA'sına eşler. Ayrı depolama PDA'ları bakiye PDA'sı ile ilişkilendirilir. Her adresin ayrıca Solana çağrıları üzerinde yetki için bir program-türetilmiş adresi vardır; buna **harici yetki PDA’sıdır**. Bu PDA, programdaki her zincir tarafından paylaşılır. Adresin SPL token hesaplarına sahiptir ve zincirler arası çağrılarının (CPI'ların) imzasını atar
* Solana'ya çağrı yapmak için ön derlemeler (CPI, System, Helper, Withdraw) sunar; bunun yanında Ethereum ön derlemeleri de vardır. Önbellekli aile SystemCached (`0xff…04`), SplCached (`0xff…05`), ASplCached (`0xff…06`) ve WithdrawCached (`0xff…0b`). Factory, bu önbellekli yolda sarmalayıcıları dağıtır
* EVM durumunu (bakiyeler, nonce, kod, depolama) Solana hesap verisi olarak saklar
* Tek bir Rome EVM programı birden çok zincir kimliğini barındırır. Zincir kimliği, external-authority PDA'sının değil, bakiye ve depolama PDA adreslerinin bir parçasıdır

### Rome Proxy (JSON-RPC sunucusu)

Rome Proxy standart bir Ethereum JSON-RPC sunucusudur. Kullanıcılar şuraya bağlanır `https://hadrian.testnet.romeprotocol.xyz/` Hadrian (testnet) için ve `https://rubicon.mainnet.romeprotocol.xyz/` Rubicon (mainnet) için. Ethereum API çağrılarını Solana etkinliğine çevirir:

* `eth_sendRawTransaction` → bir veya daha fazla Solana v1 işlemi gönderin: atomik `DoTx`, holder parçaları (`TransmitTx`) artı `Tüm parçalar aşamalandırıldıktan sonra bir`, ya da yinelemeli bacaklar. Havuzlanmış bir ödeyen SOL'u imzalar ve öder. Havuzlanmış bir ücret alıcısı kullanıcının gazını toplar
* `eth_call` → EVM yorumlayıcısını, RPC üzerinden okunan canlı Solana hesapları üzerinde emülatör içinde yerel olarak çalıştırır. Mollusk, CPI ile ulaşılan Solana programlarını çalıştırır. Ayrıca proxy hesaplama birimlerini ölçtüğünde Rome EVM programını da çalıştırır
* `eth_estimateGas` → gaz tahmini için simülasyon yapın. Bir gaz birimi, bir lamport Solana maliyetidir. Tahmin hiçbir zaman 21.000'in altına düşmez
* `eth_getBalance`, `eth_getCode`, `eth_getTransactionCount`, `eth_getStorageAt` → emülatör aracılığıyla canlı Solana hesaplarını okuyun. `eth_getBlockByNumber`, makbuzlar ve günlükler Hercules'ten gelir

Ayrıca Rome uzantılarını da sunar: `rome_emulateTx`, `rome_emulateRegRollup`, `rome_mintId`, `rome_buildInfo` ve `rome_getResources`. Solana cüzdanı yöntemlerini içerir `rome_emulateCallAccounts`, `rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1`, `rome_submitSignedV1Plan`, `rome_relayUnsignedV1`, `rome_composeExternalDepositV1` ve `rome_sendUnsignedTransaction`. Proxy ayrıca şunları da sunar `rome_solanaTxForEvmTx`.

### Hercules (indeksleyici)

Hercules, Solana üzerindeki Rome EVM programını izler ve PostgreSQL'de Ethereum ile uyumlu blokları yeniden oluşturur. Bunlar işlemleri, makbuzları, günlükleri ve durum değişikliklerini içerir. Genel zincirlerde slot hizalı modda çalışır; böylece bir blok numarası bir Solana slotuyla eşleşir ve aynı slot, herhangi bir indeksleyicide aynı bloğu üretir. Proxy bu blokları cüzdanlara ve gezginlere sunar.

Hercules doğrulanmış blokları indeksler. Her bloğu finalleştiğinde yeniden kontrol eder ve blok karması değişmişse onu yeniden yükler. Bu [Via gezgini](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/via.md) Hercules verilerini okur.

### Precompile'lar

Rome, ecrecover, SHA-256, RIPEMD-160, identity, BN254 eğri işlemlerini ve blake2f'yi Ethereum anlambilimiyle uygular; ancak BN254 ve blake2f'den gelen hata verileri hariçtir. Başarısız bir BN254 veya blake2f çağrısı, Rome'un `Error(string)` boş bir tampon yerine revert verisi döndürür. Modexp (`0x05`) devre dışıdır ve şu hatayla geri döner: `"big_mod_exp çağrısı devre dışı"`. blake2f, Ethereum'un izin verdiği 1.000.000'dan fazla turu reddeder.

EVM dışı ön derlemeler Solana'ya uzanır: **CpiProgram** (`0xFF…08`, keyfi CPI), **Sistem** (`0xFF…07`, PDA türetme ve base58 yardımcıları), **HelperProgram** (`0xFF…09`, ATA/PDA oluşturma, SPL transferleri, gaz↔lamport dönüşümü) ve **Çekme** (`0x42…16`). Önbellekli aile şudur **SystemCached** (`0xff…04`), **SplCached** (`0xff…05`), **ASplCached** (`0xff…06`ve **WithdrawCached** (`0xff…0b`). Legacy CPI'lar hemen ve yalnızca atomik işlemlerde çalışır. Önbellekli CPI'lar yürütme sırasında kaydedilir ve taahhütte gönderilir. EVM ile birlikte geri alınırlar. Yinelemeli işlemlerde çalışabilirler. Tam tablo için bakınız [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md) tam tablo için referansa bakın.

## Yürütme modları

Rome, bir EVM işlemini iki yoldan biriyle yürütür:

### Atomik (VmAt)

Tek bir Solana işlemi. Tüm EVM işlemi, bir Solana işleminin hesaplama bütçesi (\~1,4 milyon compute unit) içinde yürütülür. Çoğu işlem için kullanılır — transferler, sıradan sözleşme çağrıları, takaslar.

### Yinelemeli (VmIt)

Tek bir işlemin bütçesini aşan işler için. Yürütme birden fazla Solana işlemine bölünür:

1. Her adım (bir Solana işlemi), hesaplama bütçesine sığan kadar EVM opcode çalıştırır — adım boyutu sabittir değil, uyarlamalıdır
2. VM durumu Borsh ile serileştirilerek bir `StateHolder` adımlar arasında bir hesaba
3. Hesaplar yürütme sırasında birkaç saniye boyunca TTL kilitlidir

Proxy, hesaplama birimleri, yığın veya talimat sayısı tek bir Solana işlemine sığmadığında yinelemeli yürütmeye geri döner. Bir oturum en fazla 160 yinelemeyle sınırlıdır. Legacy yoldaki bir CPI, yinelemeli bir işlemde reddedilir; çünkü bacaklara bölünemez. Önbellekli yol CPI'larına izin verilir.

## Hesap eşlemesi

Her Ethereum adresi, Rome EVM programı altında zincir kimliğinden ve adresten türetilen bir Solana bakiye PDA'sına deterministik olarak eşlenir. Yerel gaz bakiyesi, nonce ve sözleşme koduyla birlikte o PDA'nın bir alanıdır. Depolama yuvaları ayrı depolama PDA'larında bulunur. SPL bakiyeleri, ayrı external-authority PDA'sına ait token hesaplarında bulunur. Bu yetki, aynı program üzerindeki her zincirde ortaktır.

## İçeri girmek için iki yol

* **EVM anahtarlı hat:** bir cüzdan, secp256k1 ile imzalanmış bir EVM işlemini Rome Proxy'ye gönderir. Proxy Solana işlemlerini iletir.
* **Solana anahtarlı hat:** bir cüzdan, imzasız bir EIP-1559 gövdesini Solana anahtarıyla yetkilendirir. Doğrudan v1 yolu için proxy, Solana işlemini oluşturur. Cüzdan bunu imzalar ve doğrudan Solana RPC'ye gönderir. Aktarma yolu bunun yerine göndermek için proxy'yi kullanır. Daha eski legacy yolunda cüzdanın oluşturup, imzalayıp ve ödeme yaptığı bir `DoTxUnsigned` Solana işlemi; program ise göndericiyi Solana imzalayıcısından türetir.

Bir Solana açık anahtarı sentetik adrese eşlenir `keccak256(pubkey)[12:]`, karmanın son 20 baytı. Bakınız [Solana ve EVM Rome üzerinde nasıl buluşur](https://docs.rome.builders/tr/temel-kavramlar/how-solana-and-evm-meet.md).

## Solana'ya yapılan bir çağrıyı kim imzalar

Rome EVM programı, precompile'ın doğrudan çağıranının external-authority PDA'sı ile bir CPI'yi imzalar. Bir sözleşme kendisi olarak imzalar. Bir kullanıcının SPL tokenlarını harcamak için sözleşmenin o kullanıcıdan bir SPL delegasyonu gerekir. Kullanıcı bunu şu şekilde verir `HelperProgram.approve_spl(spender, amount, mint)`. Kullanıcının EVM veya sentetik adresinden precompile'a yapılan doğrudan bir çağrı, kullanıcının external-authority PDA'sını kullanır.

## Holder hesapları

Solana (v1) işlemleri 4 KB ile sınırlıdır, ancak EVM işlemleri (özellikle sözleşme dağıtımları) çok daha büyük olabilir. Rome, büyük işlemleri 3.600 baytlık parçalara böler ve bunları sırayla şuraya yazar **holder hesaplarına** (80 KB'ye kadar). Ardından her işlemi birleştirir ve zincir üzerinde yürütür. Rome SDK bunu şeffaf bir şekilde yönetir. Her parçanın imza ücreti, göndericinin gazına faturalandırılır.

## Gas ve fiyatlandırma

Her zincirin kendi gaz token'ı vardır: SOL veya bir SPL token. Fiyat kaynağı Hermes API, bir Meteora DAMM v1 havuzu, bir Meteora DAMM v2 havuzu ya da sabit bir fiyattır. Alttaki Solana işlem ücretleri için gaz token'ı ile SOL arasındaki dönüşümü sağlar.

* Bir gaz birimi, bir lamport Solana maliyetidir
* `eth_gasPrice` lamport başına gas-token wei'sidir
* Gönderici, ücret alıcısına yerel gaz bakiyesinden ödeme yapar. Proxy ödeyici SOL öder
* Solana cüzdanı atomik hattında olduğu gibi bir ücret alıcısı yoksa, EVM gazı ücretlendirilmez. Cüzdan SOL'u doğrudan öder
* Yerel bakiye 18 ondalık basamağa sahiptir. Bu, zincir başına bir program cüzdanında tutulan gas-token SPL ile desteklenir

## Kesinlik

Rome, Solana'nın kesinliğini kullanır. SDK şunu bekler `onaylanmış`. Hercules, indekslenen her bloğu finalleştiğinde yeniden kontrol eder `nihai` ve blok karması değişmişse onu yeniden yükler.

## Sırada ne var

* [Ağlar](https://docs.rome.builders/tr/aglar/networks.md) — Hadrian'a (testnet) ve Rubicon'a (mainnet) bağlanın
* [Hızlı başlangıç](https://docs.rome.builders/tr/baslarken-1/quickstart.md) — ilk sözleşmenizi dağıtın
* [Yürütme Modeli](https://docs.rome.builders/tr/temel-kavramlar/execution-model.md) — atomik ve yinelemeli yürütmenin derinlemesine karşılaştırması
* [Token Birlikte Çalışabilirliği](https://docs.rome.builders/tr/temel-kavramlar/token-interop.md)
* [Kısıtlar](https://docs.rome.builders/tr/temel-kavramlar/constraints.md)
* [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)
* [Precompile referansı](https://docs.rome.builders/tr/referans/precompiles.md)
* [Solana ve EVM Rome üzerinde nasıl buluşur](https://docs.rome.builders/tr/temel-kavramlar/how-solana-and-evm-meet.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/tr/baslarken-1/architecture.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.
