> 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/referensi/json-rpc.md).

# Dukungan JSON-RPC

Metode Ethereum JSON-RPC yang didukung oleh endpoint Rome EVM, plus perilaku khusus Rome — untuk Foundry, Hardhat, ethers, viem, dan MetaMask.

Endpoint EVM Rome menggunakan Ethereum JSON-RPC standar. Foundry, Hardhat, ethers, viem, dan MetaMask bekerja dengan Rome sama seperti pada chain EVM mana pun. Halaman ini mencantumkan apa yang didukung dan beberapa perilaku khusus Rome yang perlu diketahui.

## Metode yang didukung

**Inti (state & eksekusi):** `eth_chainId`, `eth_blockNumber`, `eth_getBalance`, `eth_getCode`, `eth_getStorageAt`, `eth_getTransactionCount`, `eth_call`, `eth_estimateGas`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_feeHistory`.

**Blok & transaksi:** `eth_getBlockByNumber`, `eth_getBlockByHash`, `eth_getBlockReceipts`, `eth_getTransactionByHash`, `eth_getTransactionReceipt`, `eth_sendRawTransaction`, varian blok berdasarkan indeks/jumlah.

**Log & filter:** `eth_getLogs`, `eth_newFilter`, `eth_newBlockFilter`, `eth_getFilterChanges`, `eth_getFilterLogs`, `eth_uninstallFilter`.

**Langganan WebSocket:** `eth_subscribe` / `eth_unsubscribe` (`newHeads`, `logs`). Lihat [Langganan WebSocket](https://docs.rome.builders/id/panduan-pengembang/websocket-subscriptions.md).

**Net / web3:** `net_version`, `net_listening`, `net_peerCount`, `web3_clientVersion`.

**Metode introspeksi kecil:** `rpc_modules` (mencantumkan `debug`, `eth`, `net`, `rome`, `rpc`, `txpool`, `web3`), `eth_syncing` (selalu `false`), `eth_accounts` (selalu daftar kosong), `eth_getUncleCountByBlockNumber`, `eth_getUncleCountByBlockHash`, `eth_getUncleByBlockNumberAndIndex` dan `eth_getUncleByBlockHashAndIndex` (tidak ada uncle, jadi hitungan adalah `0x0` dan pencarian mengembalikan `null`), `eth_newPendingTransactionFilter` (diterima, tetapi tidak pernah mengembalikan hash karena tidak ada mempool publik), dan `txpool_status`, yang selalu mengembalikan `{"pending":"0x0","queued":"0x0"}` karena tidak ada mempool publik.

**Pelacakan:** `debug_traceRomeTransaction` mengambil hash transaksi dan mengembalikan rincian per sub-call dan per CPI untuk transaksi yang menggabungkan beberapa panggilan ke dalam satu batch. Transaksi biasa mengembalikan `null`, demikian juga hash yang belum dikenal atau belum terindeks.

### Tidak didukung

`debug_traceTransaction` / `trace_*` (pelacakan transaksi bergaya Ethereum; mereka mengembalikan `-32601`), `eth_getProof`, `eth_createAccessList`, `eth_blobBaseFee` (tidak ada transaksi blob), dan `metode txpool_*` selain `txpool_status` (tidak ada mempool publik). `newPendingTransactions` langganan diterima tetapi tidak pernah mengeluarkan event.

## Metode ekstensi Rome

Di luar RPC Ethereum standar, proxy mengekspos `rome_*` metode:

| Metode                            | Tujuan                                                                                                                                                                                                                                                    |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome_emulateTx`                  | Emulasikan transaksi secara off-chain (mengembalikan hasil eksekusi Solana)                                                                                                                                                                               |
| `rome_emulateTxWithPayer`         | Emulasikan terhadap payer tertentu                                                                                                                                                                                                                        |
| `rome_emulateCallAccounts`        | Emulasikan dan kembalikan akun Solana yang disentuh sebuah panggilan                                                                                                                                                                                      |
| `rome_emulateRegRollup`           | Emulasikan pendaftaran rollup                                                                                                                                                                                                                             |
| `rome_getResources`               | Laporkan status kumpulan sumber daya proxy (payer, holder)                                                                                                                                                                                                |
| `rome_mintId`                     | Uraikan mint SPL di balik pembungkus ERC-20                                                                                                                                                                                                               |
| `rome_buildInfo`                  | Informasi build proxy + program on-chain                                                                                                                                                                                                                  |
| `rome_isCompatible`               | Periksa kompatibilitas proxy/program                                                                                                                                                                                                                      |
| `rome_solanaTxForEvmTx`           | Ambil transaksi Solana untuk hash tx EVM                                                                                                                                                                                                                  |
| `rome_sendUnsignedTransaction`    | Kirim transaksi tanpa tanda tangan (alur synthetic-sender)                                                                                                                                                                                                |
| `rome_composeUnsignedAtomicV1`    | Susun satu transaksi Solana v1 untuk body EIP-1559 tanpa tanda tangan yang diotorisasi oleh tanda tangan Ed25519 dari dompet Solana; dompet menandatanganinya dan aplikasi menyiarkannya. Menolak ketika panggilan tidak muat dalam satu transaksi atomik |
| `rome_composeUnsignedIterativeV1` | Sama, tetapi mengembalikan setiap bagian (atomik jika muat, jika tidak maka bagian iteratif); dompet menandatangani masing-masing dan mengirimkannya dengan `rome_submitSignedV1Plan`                                                                     |
| `rome_submitSignedV1Plan`         | Siarkan rencana yang ditandatangani (hingga 64 bagian); proxy hanya menjadi transport, dompet tetap sebagai fee payer                                                                                                                                     |
| `rome_relayUnsignedV1`            | Satu tanda tangan dompet, payer milik proxy yang menjalankan bagian; synthetic membayar gas Rome (isi dulu dengan `rome_composeExternalDepositV1`). Mengembalikan hash tx EVM                                                                             |
| `rome_composeExternalDepositV1`   | Satu transaksi yang ditandatangani dompet yang mengkredit saldo gas native synthetic dari token milik dompet                                                                                                                                              |

## Perilaku khusus Rome

### Gas diturunkan dari Solana — estimasikan, jangan hardcode

Rome mengukur eksekusi dalam unit komputasi Solana, yang ditampilkan sebagai gas EVM. Sebagian besar biaya sebuah write adalah pembuatan akun Solana: penerima yang belum pernah digunakan, akun token baru, kontrak yang dideploy. Akun-akun tersebut termasuk dalam estimasi. Konsekuensi praktis:

* **Gunakan `eth_estimateGas`, dan jangan pernah hardcode `21000`.** Perkakas standar (`forge create`, `cast`, Hardhat, ethers, viem, MetaMask) sudah memanggilnya dan mendapatkan nilai yang dapat digunakan. Untuk panggilan yang menyentuh program Solana, tambahkan margin (SDK `submitRomeTx` memberi padding 1,3x) dan tetapkan batas gas jika estimasinya sendiri revert. Sebuah hardcoded `21000` limit gagal setiap kali write membuat akun, misalnya transfer ke alamat yang belum pernah digunakan.
* **Rome menagih gas yang benar-benar digunakan.** Dalam pengukuran di bawah ini gas yang digunakan tidak pernah melebihi estimasi, jadi estimasi yang lebih tinggi dari pekerjaan yang dilakukan tidak membebankan selisihnya kepada Anda.
* **Biarkan margin yang ditambahkan perkakas Anda.** State dapat berubah antara estimasi dan saat transaksi masuk, dan estimasi untuk panggilan yang membuat CPI Solana bisa menjadi terlalu rendah. SDK `submitRomeTx` memberi padding estimasi 1,3x sebagai margin.

Diukur di Hadrian, dengan harga gas sekitar 10,4 gwei pada saat itu:

| Write                                                    | `eth_estimateGas` | Gas yang digunakan |
| -------------------------------------------------------- | ----------------- | ------------------ |
| Transfer native ke alamat yang belum pernah digunakan    | 1,086,961         | 1,086,961          |
| Transfer native ke alamat yang sudah ada                 | 21,000            | 10,001             |
| Transfer wUSDC ke alamat yang belum pernah digunakan     | 2,544,921         | 2,544,921          |
| Bungkus gas menjadi wUSDC (`withdraw_to_ata`)            | 21,000            | 10,001             |
| Pemberian wrapper (`approve_spl` pada precompile Helper) | 21,000            | 10,001             |
| Deploy kontrak 10 byte                                   | 1,147,921         | 1,147,921          |

Ini adalah pengukuran tunggal pada satu chain, bukan batas. Angkanya bergantung pada akun mana yang harus dibuat oleh sebuah panggilan, jadi estimasikan setiap write alih-alih menyalinnya.

### `forge script --broadcast` memerlukan `--skip-simulation`

`forge script` menetapkan batas gas siarnya dari sebuah **lokal** simulasi, yang kekurangan alokasi terhadap model gas Rome. Tambahkan `--skip-simulation` agar Foundry menggunakan `eth_estimateGas` sebagai gantinya:

```bash
forge script script/Deploy.s.sol:Deploy \
  --rpc-url <RPC> --private-key $PRIVATE_KEY --broadcast --skip-simulation
```

`forge create`, `cast send`, dan Hardhat, tidak terpengaruh — mereka sudah mengestimasi secara on-chain.

### `eth_getLogs` dibatasi rentangnya (\~12.000 blok)

Seperti Infura, Alchemy, dan RPC produksi lainnya, `eth_getLogs` menolak rentang blok yang terlalu lebar (error `-32005`). Batasi kueri Anda:

```javascript
const latest = await provider.getBlockNumber();
const logs = await contract.queryFilter(filter, latest - 5000, latest);
```

Sebuah `queryFilter` tanpa rentang akan memindai seluruh riwayat dan akan melampaui batas — berikan `fromBlock`/`toBlock`. Aseri event berbasis receipt (misalnya menunggu tx dan membaca log-nya) tidak terpengaruh.

### Biaya

`eth_gasPrice` mengembalikan harga nyata yang berasal dari oracle; dompet (termasuk MetaMask) menggunakannya dan menampilkan biaya yang benar. Field biaya yang dikirim diterima secara permisif — baik transaksi legacy maupun EIP-1559 masuk dengan default perkakas standar.


---

# 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/referensi/json-rpc.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.
