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

# Ekosistem & repos

Setiap repo Rome publik, apa fungsinya, dan bagaimana semuanya tersusun — peta untuk menavigasi permukaannya.

Permukaan publik Rome adalah sekumpulan repositori: beberapa **fondasi** paket yang Anda bangun di atasnya, sebuah scaffolder, aplikasi referensi untuk dipelajari, dan dua layanan yang dipanggil aplikasi Anda. Halaman ini adalah peta — apa itu setiap repo dan bagaimana semuanya saling terhubung.

Dua tetangga menjawab pertanyaan yang berbeda, dan halaman ini menautkan ke keduanya alih-alih mengulanginya:

* [Arsitektur](https://docs.rome.builders/id/memulai-1/architecture.md) menjelaskan **protokol** — bagaimana EVM berjalan di dalam program Solana.
* Setiap repo menyertakan **`AGENTS.md`** (mis. [rome-sdk-ts/AGENTS.md](https://github.com/rome-protocol/rome-sdk-ts/blob/main/AGENTS.md)) yang mengarahkan berdasarkan **apa yang Anda mulai dari** (kontrak Solidity, program Solana, greenfield, dari rumah) ke satu contoh yang paling dekat dengan kasus Anda.

Halaman ini adalah tingkat di antaranya: **seluruh permukaan** dan bagaimana bagian-bagiannya terhubung.

## Sekilas tentang permukaan

### Fondasi — bangun di atas ini

| Repo                                                            | Apa itu                                                                                                                                                                | Gunakan ini saat                                                   |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| [rome-registry](https://github.com/rome-protocol/rome-registry) | `@rome-protocol/registry` — proyeksi fakta rantai hidup yang hanya-baca dan digenerasikan (id, RPC, alamat, mint token, program id, feed oracle, ALT).                 | Anda membutuhkan fakta rantai yang nyata — jangan pernah hardcode. |
| [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts)     | `@rome-protocol/sdk` — jalur tulis TypeScript: `submitRomeTx` + penentuan ukuran fee, kedua jalur, encoder PDA/ATA + CPI, binding precompile, sebuah `/bridge` client. | Anda sedang menulis kode aplikasi atau frontend.                   |
| [rome-solidity](https://github.com/rome-protocol/rome-solidity) | antarmuka precompile Solidity, wrapper SPL/ERC-20, dan adaptor oracle — toolkit sisi kontrak.                                                                          | Anda sedang menulis kontrak.                                       |

Nama `@rome-protocol/…` di atas adalah nama paket, tetapi paket-paket itu tidak dipublikasikan ke npm. Instal dari GitHub (perintahnya ada di tiap bagian di bawah [Lapisan fondasi, lebih dekat](#the-foundation-layer-up-close)); jalur import dalam kode Anda tetap sama.

### Rollup ZK EVM Rome

| Repo                                                            | Apa itu                                                    | Gunakan ini saat                                              |
| --------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------- |
| [solana-zk-evm](https://github.com/rome-protocol/solana-zk-evm) | Program rollup ZK, node, prover, dan dokumentasi operator. | Anda menjalankan chain EVM yang diselesaikan di Solana.       |
| [rome-zk-guest](https://github.com/rome-protocol/rome-zk-guest) | Sumber guest batch yang dibangun untuk genesis tiap chain. | Anda sedang membangun guest dan meminta verification key-nya. |

### Ostia (ZK EVM di Canton)

| Repo                                                                                  | Apa itu                                                                                                              | Gunakan ini saat                                                                                                                                                                                              |
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/README.md) | Ostia, sebuah ZK EVM di Canton: setiap blok EVM yang dibuktikan dikomit dengan aksi Canton-nya dalam satu transaksi. | Anda membangun di Ostia DevNet ([explorer](https://ostia.devnet.romeprotocol.xyz/)) atau menjalankan Ostia Anda sendiri. Lihat [Canton ZK EVM](https://docs.rome.builders/id/canton-zk-evm/canton-zk-evm.md). |

### Aplikasi referensi — belajar dari contoh

| Repo                                                                    | Apa itu                                                                                                | Gunakan ini saat                                                                  |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| [rome-dex](https://github.com/rome-protocol/rome-dex)                   | AMM jalur ganda — pool Solana native dengan router EVM tipis.                                          | Membuka jalur lainnya; sebuah **native-core** contoh.                             |
| [aerarium](https://github.com/rome-protocol/aerarium)                   | Peminjaman jalur ganda — core Comet Solidity yang dijangkau pengguna Solana melalui pengirim sintetis. | Membuka jalur lainnya; sebuah **Solidity-core** contoh.                           |
| [cardo](https://github.com/rome-protocol/cardo)                         | Pengguna EVM yang menggerakkan dApp Solana (swap/stake/lend/perps) melalui CPI.                        | Sebuah aplikasi CPI-ke-Solana yang dibahas langkah demi langkah untuk dipelajari. |
| [appia](https://github.com/rome-protocol/appia)                         | DeFi lintas-VM yang berfokus pada posisi; pengguna menjangkaunya dari chain asal mereka.               | Sebuah **from-home** aplikasi.                                                    |
| [rome-aave-v3-demo](https://github.com/rome-protocol/rome-aave-v3-demo) | Supply/borrow/repay Aave v3, diterapkan tanpa perubahan.                                               | Aplikasi EVM penuh yang berjalan apa adanya.                                      |

### Fork kontrak — protokol yang sudah dikenal, diterapkan di Rome

| Repo                                                                              | Apa itu                          | Gunakan ini saat                               |
| --------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------------------- |
| [compound-on-rome-comet](https://github.com/rome-protocol/compound-on-rome-comet) | Pasar uang Compound III (Comet). | Melakukan fork pada protokol EVM yang dikenal. |
| [rome-aave-v3](https://github.com/rome-protocol/rome-aave-v3)                     | Fork kontrak Aave v3.            | Melakukan fork pada protokol EVM yang dikenal. |

### Layanan — aplikasi Anda memanggil ini

| Repo                                                                        | Apa itu                                                                                               | Gunakan ini saat                      |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------- |
| [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api)         | Orkestrator off-chain + sponsor fee untuk bridge on-chain. Tidak menyimpan kunci apa pun.             | Mendanai wallet, atau alur from-home. |
| [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) | Feed harga Solana (Pyth, Switchboard) yang diekspos ke EVM melalui Chainlink `AggregatorV3Interface`. | Anda membutuhkan feed harga.          |

### Scaffold — mulai dari sini

| Repo                                                                | Apa itu                                                                                                                                                                 | Gunakan ini saat       |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| [create-rome-app](https://github.com/rome-protocol/create-rome-app) | `npx github:rome-protocol/create-rome-app` — membuat scaffold aplikasi jalur ganda yang sudah terhubung ke registry + SDK, dengan pemeriksaan kedua-jalur yang didanai. | Memulai aplikasi baru. |

## Cara mereka tersusun

```mermaid
flowchart TD
    REG["rome-registry — fakta chain hidup"]
    SDK["rome-sdk-ts — penulisan, CPI, client bridge"]
    SOL["rome-solidity — antarmuka precompile, wrapper SPL, adaptor oracle"]
    CRA["create-rome-app — scaffolder"]
    APP["aplikasi Anda — frontend + kontrak"]
    BAPI["rome-bridge-api — orkestrator off-chain, tidak menyimpan kunci"]
    OG["rome-oracle-gateway — feed harga Solana"]

    CRA -->|scaffolds, terhubung sebelumnya| APP
    REG -->|fakta, jangan pernah di-hardcode| APP
    SDK -->|jalur tulis & CPI| APP
    SOL -->|diimpor oleh kontrak Anda| APP
    APP -->|SDK /bridge client| BAPI
    APP -->|membaca via AggregatorV3Interface| OG
    OG -.->|adaptor berada di| SOL
    CRA -.->|menghubungkan| REG
    CRA -.->|menghubungkan| SDK
```

Tulang punggungnya ada tiga fondasi dan satu scaffolder:

* [**rome-registry**](https://github.com/rome-protocol/rome-registry) adalah satu-satunya sumber fakta hidup. [**rome-sdk-ts**](https://github.com/rome-protocol/rome-sdk-ts) adalah jalur tulis — dan `/bridge` subpath-nya adalah client yang dipakai aplikasi Anda untuk berbicara ke `rome-bridge-api`. [**rome-solidity**](https://github.com/rome-protocol/rome-solidity) adalah apa yang diimpor kontrak Anda (dan fork); adaptor oracle yang `rome-oracle-gateway` juga menerapkannya di sana. Ketiganya saling independen — pilih yang dibutuhkan aplikasi Anda.
* [**create-rome-app**](https://github.com/rome-protocol/create-rome-app) menggabungkan dua yang pertama untuk aplikasi baru, sehingga proyek baru sudah mulai dengan membaca registry dan menulis melalui SDK.

Aplikasi referensi adalah pengecualian yang layak diketahui: **mereka ada sebelum paket-paket yang diekstrak.** cardo menggunakan paket registry; appia memproyeksikan registry ke JSON statis saat build time; dan keduanya menyertakan jalur tulis mereka sendiri alih-alih mengimpor SDK. Bacalah untuk mempelajari polanya — tetapi sebuah **baru** aplikasi sebaiknya mulai dari `create-rome-app` + paket-paketnya, bukan dengan mengkloning aplikasi.

## Navigasi berdasarkan apa yang Anda butuhkan

* **Sebuah fakta chain hidup** (id, alamat, mint, program id) → [rome-registry](https://github.com/rome-protocol/rome-registry). Jangan pernah hardcode.
* **Menulis kode aplikasi** (sebuah write, panggilan CPI, bridge) → [rome-sdk-ts](https://github.com/rome-protocol/rome-sdk-ts); referensi di [Rome SDK](https://docs.rome.builders/id/produk/rome-sdk.md).
* **Menulis kontrak** → [rome-solidity](https://github.com/rome-protocol/rome-solidity); lihat [Deploy Solidity Contracts](https://docs.rome.builders/id/panduan-pengembang/deploy-solidity.md).
* **Memanggil program Solana dari kontrak Solidity** → precompile CPI di [rome-solidity](https://github.com/rome-protocol/rome-solidity) (`interface.sol`); [cardo](https://github.com/rome-protocol/cardo) adalah contoh yang dibahas.
* **Contoh yang bekerja** dari AMM, lending, CPI, atau aplikasi from-home → aplikasi referensi di atas; tiap repo `AGENTS.md` mengarah berdasarkan titik awal.
* **Men-scaffold aplikasi baru** → [create-rome-app](https://github.com/rome-protocol/create-rome-app).
* **Sebuah feed harga** → [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) (lihat [portal Oracle Gateway](https://docs.rome.builders/id/aplikasi-di-rome/oracle-gateway.md)).
* **Pengguna di chain lain** → [Dari rumah](https://docs.rome.builders/id/panduan-pengembang/from-home.md) + [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api).
* **Menentukan sisi mana yang menyimpan logika Anda** → [Pilih core Anda](https://docs.rome.builders/id/konsep-inti/choose-your-core.md).

## Lapisan fondasi, lebih dekat

### rome-registry — fakta hidup, publik secara bawaan

Registry ini **digenerasikan** dari sumber internal Rome: sebuah allowlist hanya mengeluarkan apa yang memang dimaksudkan untuk publik, **mengganti** endpoint internal dengan padanan publiknya, dan **secara default menolak** semuanya yang lain — jadi aman untuk publik secara bawaan. Ia menerbitkan, per chain, `chain.json` / `tokens.json` / `contracts.json` / `oracle.json` / `bridge.json` / `alts.json`serta Solana `program` dan deployment aplikasi per-protokol.

Instal dari GitHub, dipin ke tag rilis: `npm install github:rome-protocol/rome-registry#v0.2.0`. Anda membacanya melalui getter — `getChain`, `getTokens`, `getContracts`, `getOracle`, `getBridge`, `getAlts`, dan `getPrograms(network)` (program id diberi kunci berdasarkan network, bukan chain id). Paket ini ESM biasa (belum ada tipe TypeScript bawaan saat ini).

Dua hal yang perlu diketahui sebelum Anda menghubungkannya:

* **`getTokens()` tidak mengembalikan `assetRef`.** Untuk menemukan wrapper sebuah token, cocokkan berdasarkan **mint** (`mintId`) — mis. wrapper token gas adalah entri yang berbagi mint-nya.
* **Ia membaca JSON dari disk (`node:fs`) — ini tidak aman untuk browser.** Dalam aplikasi web, proyeksikan nilai yang Anda butuhkan ke file JSON statis saat build time dan impor itu di klien. (Ini persis yang dilakukan `create-rome-app` dan appia.)

Alamat kontrak kembali sebagai daftar versi per kontrak; pilih yang statusnya `status` adalah `aktif`. [Membaca daftar kontrak](https://docs.rome.builders/id/referensi/contract-addresses.md#reading-the-contracts-list) menunjukkan caranya. Fakta yang tidak dibaca live oleh aplikasi Anda juga muncul di referensi [Contract Addresses](https://docs.rome.builders/id/referensi/contract-addresses.md) .

### rome-sdk-ts — jalur tulis, kedua jalur

Instal dari GitHub: `npm install github:rome-protocol/rome-sdk-ts#v0.4.0`.

`@rome-protocol/sdk` (v0.4.0) membungkus semua yang dibutuhkan untuk write Rome sehingga Anda tidak perlu merakit calldata atau fee secara manual:

* **`submitRomeTx`** — jalur tulis lane EVM: mengukur gas dari `eth_estimateGas` (ditambah, dengan batas cadangan saat estimasi gagal) dan menyediakan fee EIP-1559.
* **`submitRomeTxV1`** — sama, untuk **wallet Solana** yang menggerakkan aplikasi EVM Anda: satu transaksi Solana v1 per panggilan, dua prompt wallet. Pengirim sintetis tidak menyimpan apa pun saat diam; `buildFundLeg`/`buildSweepLeg` memindahkan nilai masuk dan keluar sebagai ERC-20 (`wUSDC`), **bukan** native `msg.value`; instruksi Solana biasa di sekitar sebuah panggilan (leg pendanaan, pembuatan token-account wallet sebelum sweep) melewati `submitSolanaInstructionsV1` sebagai transaksi v1 juga. `submitRomeTxSolanaLane` adalah jalur yang lebih awal, yang membangun transaksi Solana legacy di klien dan secara otomatis menyiapkan sintetis baru (`create_pda`) pada penggunaan pertama.
* **Derivasi PDA/ATA, CPI `invoke`/`invoke_signed` encoder, binding precompile**, dan sebuah **`/bridge`** subpath (`@rome-protocol/sdk/bridge`) — client bridge quote-first.

API lengkap + contoh: [Rome SDK](https://docs.rome.builders/id/produk/rome-sdk.md), dan panduan [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), dan [Bangun aplikasi jalur ganda](https://docs.rome.builders/id/panduan-pengembang/dual-lane-app.md).

### rome-solidity — toolkit sisi kontrak

Instal dari GitHub, bukan npm. Dengan npm atau Hardhat: `npm install github:rome-protocol/rome-solidity`. Dengan Foundry: `forge install rome-protocol/rome-solidity`, lalu tambahkan remapping `@rome-protocol/rome-solidity/=lib/rome-solidity/` ke `foundry.toml` (di bawah `[profile.default]`, sebagai `remappings = [...]`agar `@rome-protocol/rome-solidity/contracts/interface.sol` terselesaikan. Nama paket di `package.json` adalah `@rome-protocol/rome-solidity`, sehingga jalur import yang sama berfungsi untuk keduanya.

Apa yang diimpor kontrak Anda:

* **`contracts/interface.sol`** — antarmuka precompile yang terikat ke alamatnya: **CPI** `ICrossProgramInvocation` (`0xFF…08`), **Helper** `IHelperProgram` (`0xFF…09`pembuatan ATA/PDA, transfer SPL, gas↔lamports), **Withdraw** `IWithdraw` (`0x42…16`), dan **System** (`0xFF…07`). Sebuah keluarga **cached** yang dioptimalkan untuk gas juga ada di sini; sebuah kontrak menggunakan satu jalur secara konsisten. Tabel alamat lengkap: [Contract Addresses](https://docs.rome.builders/id/referensi/contract-addresses.md).
* **Wrapper SPL/ERC-20** — `SPL_ERC20` (berbasis CPI) dan `SPL_ERC20_cached` (jalur cached, digunakan di devnet); setiap mint SPL sudah menjadi ERC-20 melalui ini.
* **Adaptor oracle** (`contracts/oracle/`) — adaptor Pyth/Switchboard `rome-oracle-gateway` menerapkan, dibaca melalui `IAggregatorV3Interface`.
* Contoh yang dibahas dalam `contracts/examples/`.

Bagian Solidity SDK dari [Rome SDK](https://docs.rome.builders/id/produk/rome-sdk.md) menunjukkan pola import dan binding precompile di dalam kode.

## Langkah berikutnya

* [Pilih core Anda](https://docs.rome.builders/id/konsep-inti/choose-your-core.md) — sisi mana yang menyimpan logika Anda.
* [Quickstart](https://docs.rome.builders/id/memulai-1/quickstart.md) — deploy kontrak pertama Anda.
* [create-rome-app](https://github.com/rome-protocol/create-rome-app) — buat scaffold aplikasi jalur ganda.
* Setiap repo `AGENTS.md` — rute berdasarkan titik awal ke contoh terdekat.


---

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