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

# Konsep Utama

Istilah penting Solana dan Rome EVM untuk pengembang — program, akun, PDA, CPI, token SPL, serta eksekusi atomik vs. iteratif.

Istilah dan konsep penting untuk membangun di atas Rome Protocol.

## Konsep Solana

**Program** — Padanan smart contract di Solana. Program adalah executable tanpa status yang dideploy di on-chain. Rome EVM itu sendiri adalah program Solana.

**Account** — Semua status di Solana berada di account. Setiap account memiliki pemilik (program), saldo (lamports), dan data. Tidak seperti Ethereum, kode dan status disimpan dalam account yang terpisah.

**PDA (Program Derived Address)** — Alamat deterministik yang diturunkan dari seed dan program ID. PDA memungkinkan program "memiliki" account tanpa private key. Rome menggunakan PDA untuk memetakan alamat Ethereum ke account Solana.

**CPI (Cross-Program Invocation)** — Satu program Solana memanggil program lain dalam transaksi yang sama. Inilah cara kontrak Rome EVM berinteraksi dengan Jupiter, Kamino, SPL Token, dan program Solana lainnya.

**SPL Token** — Program token standar Solana. Setara dengan ERC-20 di Ethereum. Semua token fungible di Solana (USDC, SOL, dll.) adalah token SPL.

**Token-2022** — Program token SPL generasi berikutnya dengan ekstensi seperti Transfer Hooks, Confidential Transfers, dan Permanent Delegates.

**Transfer Hook** — Ekstensi Token-2022 yang memanggil program pada setiap `transfer_checked` pemanggilan.

**ATA (Associated Token Account)** — Account token deterministik untuk pasangan wallet + mint tertentu. Setiap pengguna memiliki satu ATA per token yang mereka pegang.

**Lamports** — Unit terkecil SOL. 1 SOL = 1.000.000.000 lamports (10^9).

**Compute Units (CU)** — Padanan gas Ethereum di Solana. Setiap transaksi memiliki anggaran komputasi (default \~200K CU, maksimum \~1,4M CU). Operasi mengonsumsi CU.

## Konsep Rome

**Program Rome EVM** — Program Solana yang berisi interpreter bytecode EVM. Dideploy pada program ID tertentu per lingkungan.

**ID chain** — Setiap aplikasi di Rome mendapat chain ID EVM-nya sendiri. Ini menciptakan lingkungan EVM terisolasi yang berbagi status Solana dasar yang sama.

**Eksekusi Atomik (VmAt)** — Transaksi EVM yang dieksekusi sepenuhnya dalam satu transaksi Solana. Digunakan untuk sebagian besar operasi.

**Eksekusi Iteratif (VmIt)** — Transaksi EVM yang dipecah ke beberapa transaksi Solana, dengan setiap langkah mengemas sebanyak opcode yang muat dalam anggaran komputasi satu transaksi Solana (adaptif, bukan jumlah tetap). Digunakan untuk operasi intensif komputasi seperti BN254 pairing.

**Account Holder** — Buffer on-chain yang menyimpan transaksi EVM besar (hingga 80 KB) yang melebihi batas ukuran transaksi Solana (v1) 4 KB. Dikelola secara transparan oleh SDK.

**StateHolder** — Account on-chain yang menyimpan status VM terserialisasi di antara langkah-langkah eksekusi iteratif.

**Rome Proxy** — Server JSON-RPC (port 9090) yang menerjemahkan panggilan API Ethereum menjadi transaksi Solana. MetaMask dan Hardhat Anda terhubung ke sini.

**Hercules** — Pengindeks blok yang memantau event Rome EVM di Solana dan menghasilkan data blok yang kompatibel dengan Ethereum.

**Payer** — Keypair Solana yang menandatangani dan membayar transaksi Solana atas nama pengguna EVM. Dikelola oleh Proxy melalui kumpulan payer.

## Konsep Token

**SPL\_ERC20 / SPL\_ERC20\_cached** — Kontrak wrapper ERC-20 yang merepresentasikan token SPL di dalam Rome EVM. Untuk sebuah wallet, wrapper membaca saldo langsung dari account token SPL yang mendasarinya. Token yang dipegang oleh kontrak disimpan di account token escrow milik wrapper sendiri dan dilacak dalam storage wrapper (lihat [Integrasikan program Solana](https://docs.rome.builders/id/panduan-pengembang/integrate-solana-program.md)). Factory saat ini menerapkan varian cached.

**ERC20SPLFactory** — Kontrak factory yang mendeploy wrapper untuk token SPL apa pun.

**Registry** — Wrapper kanonik, gas token, dan wiring bridge dikurasi di luar chain dalam [rome-protocol/registry](https://github.com/rome-protocol/rome-registry); tidak ada kontrak token-registry on-chain. Ini menjaga setiap aset dipetakan ke satu mint SPL kanonik.

## Precompile

**Standard Ethereum Precompile** — ecrecover (0x01), SHA-256 (0x02), RIPEMD-160 (0x03), identity (0x04), modexp (0x05), BN254 ecAdd/ecMul/ecPairing (0x06-0x08), Blake2f (0x09).

**Precompile Sistem** (`0xFF...07`) — derivasi PDA dan konversi base58 dari Solidity.

**Precompile CpiProgram** (`0xFF...08`) — invocation lintas program (`invoke` / `invoke_signed`) plus pintasan baca lintas status.

**Precompile HelperProgram** (`0xFF...09`) — pembuatan ATA/PDA, transfer SPL, dan konversi gas↔lamports; permukaan utama untuk operasi SPL yang ditandatangani user-PDA.

**Precompile Withdraw** (`0x42...16`) — menarik SOL atau token SPL dari EVM kembali ke Solana.

Keluarga jalur cached (`0xff…04/05/06/0b`) meniru ini untuk pembacaan yang efisien CU; sebuah kontrak menggunakan satu jalur secara konsisten.

## Tipe Transaksi

Rust SDK membangun tiga jenis transaksi. Rome menyelesaikan masing-masing di Solana.

**Satu transaksi EVM (`RheaTx`)** — Satu transaksi EVM pada satu chain Rome. Jenis yang paling umum.

**Beberapa transaksi EVM (`RemusTx`)** — Transaksi EVM pada chain Rome yang berbeda, dieksekusi bersama dalam satu transaksi Solana. Jika salah satu gagal, semuanya dibatalkan.

**Transaksi EVM plus instruksi Solana (`RomulusTx`)** — Transaksi EVM dan instruksi Solana native dalam satu transaksi Solana atomik, sehingga program Solidity dan Solana berjalan bersama atau tidak sama sekali.

## Langkah Berikutnya

* [Model Eksekusi](https://docs.rome.builders/id/konsep-inti/execution-model.md) — penjelasan mendalam tentang bagaimana transaksi EVM dieksekusi di Solana
* [Interoperabilitas Token](https://docs.rome.builders/id/konsep-inti/token-interop.md) — bagaimana ERC-20 dan token SPL saling berinteraksi
* [Batasan](https://docs.rome.builders/id/konsep-inti/constraints.md) — batas dan pembatasan penting


---

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