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

# Arsitektur

Bagaimana komponen Rome saling terhubung — eksekusi EVM di dalam program Solana.

Rome menyematkan interpreter bytecode EVM di dalam program on-chain Solana. Pada jalur kunci EVM, pengguna mengirim transaksi EVM yang ditandatangani ke Rome Proxy melalui Ethereum JSON-RPC standar. Proxy meneruskannya ke program Rome EVM di Solana. Satu transaksi EVM dapat memerlukan beberapa transaksi Solana untuk menulis potongan ke akun penampung atau menjalankan eksekusi iteratif. Pada jalur kunci Solana v1, proxy menyusun transaksinya. Wallet Solana menandatanganinya dan mengirimkannya langsung ke Solana RPC. Tidak ada lapisan eksekusi terpisah yang perlu disinkronkan — state EVM *adalah* state Solana.

## Ikhtisar sistem

<figure><img src="https://320084446-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>

## Komponen

### Program EVM Rome (on-chain)

Inti Rome — sebuah program BPF Solana yang berisi interpreter bytecode EVM lengkap (fork dari SputnikVM). Ini:

* Menerima transaksi EVM yang ditandatangani dan body EIP-1559 yang belum ditandatangani sebagai instruksi Solana. Sebuah kunci Solana mengotorisasi body yang belum ditandatangani melalui tanda tangan pembayar biaya Solana atau instruksi verifier Ed25519
* Menjalankan bytecode Solidity di dalam runtime Solana
* Memetakan setiap alamat Ethereum (H160) ke PDA saldo per chain yang berisi nonce, saldo native, dan kode. PDA penyimpanan terpisah dikaitkan dengan PDA saldo. Setiap alamat juga memiliki program-derived address untuk otoritas atas panggilan Solana, disebut miliknya **PDA otoritas eksternal**. PDA ini dibagikan oleh setiap chain pada program. PDA ini memiliki akun token SPL milik alamat tersebut dan menandatangani cross-program invocations (CPI)-nya
* Menyediakan precompile untuk memanggil Solana (CPI, System, Helper, Withdraw) bersama precompile Ethereum. Keluarga cached menambahkan SystemCached (`0xff…04`), SplCached (`0xff…05`), ASplCached (`0xff…06`), dan WithdrawCached (`0xff…0b`). Factory men-deploy wrapper pada jalur cached ini
* Menyimpan state EVM (saldo, nonce, kode, storage) sebagai data akun Solana
* Satu program Rome EVM menampung banyak chain ID. Chain ID merupakan bagian dari alamat PDA saldo dan storage, bukan dari PDA otoritas eksternal

### Proxy Rome (server JSON-RPC)

Proxy Rome adalah server JSON-RPC Ethereum standar. Pengguna terhubung ke `https://hadrian.testnet.romeprotocol.xyz/` untuk Hadrian (testnet) dan `https://rubicon.mainnet.romeprotocol.xyz/` untuk Rubicon (mainnet). Ini menerjemahkan panggilan API Ethereum menjadi aktivitas Solana:

* `eth_sendRawTransaction` → mengirim satu atau lebih transaksi Solana v1: atomik `DoTx`, potongan holder (`TransmitTx`) plus `DoTxHolder`, atau leg iteratif. Payer bersama menandatangani dan membayar SOL. Penerima fee bersama mengumpulkan gas pengguna
* `eth_call` → menjalankan interpreter EVM secara native di emulator pada akun Solana live yang dibaca lewat RPC. Mollusk menjalankan program Solana yang dijangkau oleh CPI. Ia juga menjalankan program Rome EVM ketika proxy mengukur unit komputasi
* `eth_estimateGas` → mensimulasikan untuk estimasi gas. Satu unit gas adalah satu lamport biaya Solana. Estimasi tidak pernah di bawah 21.000
* `eth_getBalance`, `eth_getCode`, `eth_getTransactionCount`, `eth_getStorageAt` → membaca akun Solana live melalui emulator. `eth_getBlockByNumber`, receipt dan log berasal dari Hercules

Ini juga menyediakan ekstensi Rome: `rome_emulateTx`, `rome_emulateRegRollup`, `rome_mintId`, `rome_buildInfo` dan `rome_getResources`. Metode wallet Solana mencakup `rome_emulateCallAccounts`, `rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1`, `rome_submitSignedV1Plan`, `rome_relayUnsignedV1`, `rome_composeExternalDepositV1` dan `rome_sendUnsignedTransaction`. Proxy juga menyediakan `rome_solanaTxForEvmTx`.

### Hercules (indeksator)

Hercules memantau program Rome EVM di Solana dan merekonstruksi blok yang kompatibel dengan Ethereum di PostgreSQL. Ini mencakup transaksi, receipt, log, dan perubahan state. Pada chain publik, ia berjalan dalam mode selaras-slot, sehingga nomor blok dipetakan ke slot Solana dan slot yang sama menghasilkan blok yang sama pada indeksator mana pun. Proxy menyajikan blok-blok ini ke wallet dan explorer.

Hercules mengindeks blok yang terkonfirmasi. Ia memeriksa ulang setiap blok saat finalized dan memuat ulang jika blockhash berubah. The [Via explorer](https://docs.rome.builders/id/aplikasi-di-rome/via.md) membaca data Hercules.

### Precompile

Rome mengimplementasikan ecrecover, SHA-256, RIPEMD-160, identity, operasi kurva BN254, dan blake2f dengan semantik Ethereum, kecuali untuk data kegagalan dari BN254 dan blake2f. Panggilan BN254 atau blake2f yang gagal mengembalikan `Error(string)` data revert alih-alih buffer kosong. Modexp (`0x05`) dinonaktifkan dan me-revert dengan `"big_mod_exp call is disabled"`. blake2f menolak lebih dari 1.000.000 ronde, yang diizinkan oleh Ethereum.

Precompile non-EVM menjangkau Solana: **CpiProgram** (`0xFF…08`, CPI arbitrer), **System** (`0xFF…07`, derivasi PDA dan helper base58), **HelperProgram** (`0xFF…09`, pembuatan ATA/PDA, transfer SPL, gas↔lamports), dan **Withdraw** (`0x42…16`). Keluarga cached adalah **SystemCached** (`0xff…04`), **SplCached** (`0xff…05`), **ASplCached** (`0xff…06`) dan **WithdrawCached** (`0xff…0b`). CPI legacy dijalankan segera dan hanya dalam transaksi atomik. CPI cached dicatat selama eksekusi dan dikirim saat commit. Ini me-revert bersama EVM. Ini dapat berjalan dalam transaksi iteratif. Lihat [Contract Addresses](https://docs.rome.builders/id/referensi/contract-addresses.md) referensi untuk tabel lengkap.

## Mode eksekusi

Rome mengeksekusi transaksi EVM dengan salah satu dari dua cara:

### Atomik (VmAt)

Satu transaksi Solana. Seluruh transaksi EVM dieksekusi dalam anggaran compute unit satu transaksi Solana (\~1,4 juta compute unit). Digunakan untuk sebagian besar operasi — transfer, panggilan kontrak biasa, swap.

### Iteratif (VmIt)

Untuk pekerjaan yang melebihi anggaran satu transaksi. Eksekusi dibagi ke beberapa transaksi Solana:

1. Setiap langkah (sebuah transaksi Solana) menjalankan sebanyak opcode EVM yang muat dalam anggaran compute unit-nya — ukuran langkah bersifat adaptif, bukan tetap
2. State VM diserialisasi dengan Borsh ke dalam sebuah `StateHolder` akun di antara langkah-langkah
3. Akun dikunci TTL selama beberapa detik selama eksekusi

Proxy beralih ke eksekusi iteratif ketika compute unit, heap, atau jumlah instruksi tidak muat dalam satu transaksi Solana. Satu sesi dibatasi hingga 160 iterasi. CPI pada jalur legacy ditolak dalam transaksi iteratif, karena tidak dapat dibagi ke beberapa leg. CPI pada jalur cached diizinkan.

## Pemetaan akun

Setiap alamat Ethereum dipetakan secara deterministik ke PDA saldo Solana yang diturunkan dari chain ID dan alamat di bawah program Rome EVM. Saldo gas native-nya adalah sebuah field di PDA itu, bersama nonce dan kode kontrak. Slot storage berada di PDA storage terpisah. Saldo SPL berada di akun token milik PDA otoritas eksternal yang terpisah. Otoritas itu dibagikan di setiap chain pada program yang sama.

## Dua cara masuk

* **Jalur kunci EVM:** sebuah wallet mengirim transaksi EVM yang ditandatangani secp256k1 ke Rome Proxy. Proxy mengirim transaksi Solana tersebut.
* **Jalur kunci Solana:** sebuah wallet mengotorisasi body EIP-1559 yang belum ditandatangani dengan kunci Solana-nya. Untuk rute v1 langsung, proxy menyusun transaksi Solana. Wallet menandatanganinya dan mengirimkannya langsung ke Solana RPC. Rute relay menggunakan proxy untuk mengirimnya sebagai pengganti. Rute legacy yang lebih lama mengharuskan wallet membangun, menandatangani, dan membayar sebuah `DoTxUnsigned` transaksi Solana, dan program menurunkan pengirim dari penanda tangan Solana.

Kunci publik Solana dipetakan ke alamat sintetis `keccak256(pubkey)[12:]`, 20 byte terakhir dari hash tersebut. Lihat [Cara Solana dan EVM bertemu di Rome](https://docs.rome.builders/id/konsep-inti/how-solana-and-evm-meet.md).

## Siapa yang menandatangani panggilan ke Solana

Program Rome EVM menandatangani CPI dengan PDA otoritas eksternal dari pemanggil langsung precompile. Sebuah kontrak menandatangani atas namanya sendiri. Untuk membelanjakan token SPL pengguna, kontrak memerlukan delegasi SPL dari pengguna tersebut. Pengguna memberikannya dengan `HelperProgram.approve_spl(spender, amount, mint)`. Panggilan langsung dari EVM pengguna atau alamat sintetis ke precompile menggunakan PDA otoritas eksternal milik pengguna.

## Akun penampung

Transaksi Solana (v1) dibatasi hingga 4 KB, tetapi transaksi EVM (terutama deployment kontrak) bisa jauh lebih besar. Rome memecah transaksi besar menjadi potongan 3.600 byte dan menulisnya secara berurutan ke **akun penampung** (hingga 80 KB). Lalu ia menyusun setiap transaksi dan mengeksekusinya on-chain. SDK Rome menangani ini secara transparan. Biaya tanda tangan setiap potongan dibebankan ke gas pengirim.

## Gas dan penetapan harga

Setiap chain memiliki token gas sendiri: SOL atau token SPL. Sumber harga adalah Hermes API, pool Meteora DAMM v1, pool Meteora DAMM v2, atau harga tetap. Ini menyediakan konversi antara token gas dan SOL untuk biaya transaksi Solana yang mendasarinya.

* Satu unit gas adalah satu lamport biaya Solana
* `eth_gasPrice` adalah wei token gas per lamport
* Pengirim membayar penerima fee dari saldo gas native-nya. Pembayar proxy membayar SOL
* Tanpa penerima fee, seperti pada jalur atomik wallet Solana, tidak ada gas EVM yang dikenakan. Wallet membayar SOL secara langsung
* Saldo native memiliki 18 desimal. Ini didukung oleh token SPL gas yang disimpan di wallet program per-chain

## Finalitas

Rome menggunakan finalitas Solana. SDK menunggu `terkonfirmasi`. Hercules memeriksa ulang setiap blok yang diindeks pada `terfinalisasi` dan memuat ulang jika blockhash berubah.

## Langkah berikutnya

* [Jaringan](https://docs.rome.builders/id/jaringan/networks.md) — terhubung ke Hadrian (testnet) dan Rubicon (mainnet)
* [Quickstart](https://docs.rome.builders/id/memulai-1/quickstart.md) — deploy kontrak pertama Anda
* [Model Eksekusi](https://docs.rome.builders/id/konsep-inti/execution-model.md) — eksekusi atomik vs iteratif secara mendalam
* [Interoperabilitas Token](https://docs.rome.builders/id/konsep-inti/token-interop.md)
* [Batasan](https://docs.rome.builders/id/konsep-inti/constraints.md)
* [Panggil Solana dari EVM](https://docs.rome.builders/id/panduan-pengembang/call-solana-from-evm.md)
* [Panggil EVM dari Solana](https://docs.rome.builders/id/panduan-pengembang/call-evm-from-solana.md)
* [Referensi precompile](https://docs.rome.builders/id/referensi/precompiles.md)
* [Cara Solana dan EVM bertemu di Rome](https://docs.rome.builders/id/konsep-inti/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/id/memulai-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.
