> 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/vi/tai-lieu-tham-khao/json-rpc.md).

# Hỗ trợ JSON-RPC

Các phương thức Ethereum JSON-RPC được hỗ trợ bởi các endpoint Rome EVM, cùng với các hành vi đặc thù của Rome — dành cho Foundry, Hardhat, ethers, viem và MetaMask.

Các điểm cuối EVM của Rome nói chuẩn Ethereum JSON-RPC. Foundry, Hardhat, ethers, viem và MetaMask hoạt động với Rome giống như trên bất kỳ chuỗi EVM nào. Trang này liệt kê những gì được hỗ trợ và một vài hành vi đặc thù của Rome đáng biết.

## Các phương thức được hỗ trợ

**Cốt lõi (trạng thái & thực thi):** `eth_chainId`, `eth_blockNumber`, `eth_getBalance`, `eth_getCode`, `eth_getStorageAt`, `eth_getTransactionCount`, `eth_call`, `eth_estimateGas`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_feeHistory`.

**Khối & giao dịch:** `eth_getBlockByNumber`, `eth_getBlockByHash`, `eth_getBlockReceipts`, `eth_getTransactionByHash`, `eth_getTransactionReceipt`, `eth_sendRawTransaction`, biến thể theo chỉ số/đếm khối.

**Log & bộ lọc:** `eth_getLogs`, `eth_newFilter`, `eth_newBlockFilter`, `eth_getFilterChanges`, `eth_getFilterLogs`, `eth_uninstallFilter`.

**Đăng ký WebSocket:** `eth_subscribe` / `eth_unsubscribe` (`newHeads`, `logs`). Xem [Các đăng ký WebSocket](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/websocket-subscriptions.md).

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

**Các phương thức kiểm tra nhỏ:** `rpc_modules` (liệt kê `debug`, `eth`, `net`, `rome`, `rpc`, `txpool`, `web3`), `eth_syncing` (luôn `false`), `eth_accounts` (luôn là một danh sách rỗng), `eth_getUncleCountByBlockNumber`, `eth_getUncleCountByBlockHash`, `eth_getUncleByBlockNumberAndIndex` và `eth_getUncleByBlockHashAndIndex` (không có uncle, nên số lượng là `0x0` và tra cứu trả về `null`), `eth_newPendingTransactionFilter` (được chấp nhận, nhưng không bao giờ trả về hash vì không có mempool công khai), và `txpool_status`, phương thức này luôn trả về `{"pending":"0x0","queued":"0x0"}` vì không có mempool công khai.

**Truy vết:** `debug_traceRomeTransaction` nhận một hash giao dịch và trả về phân tích chi tiết theo từng lời gọi con và từng CPI cho một giao dịch gộp nhiều lời gọi vào một lô duy nhất. Các giao dịch thông thường trả về `null`, cũng như một hash chưa được biết hoặc chưa được lập chỉ mục.

### Không được hỗ trợ

`debug_traceTransaction` / `trace_*` (truy vết giao dịch kiểu Ethereum; chúng trả về `-32601`), `eth_getProof`, `eth_createAccessList`, `eth_blobBaseFee` (không có giao dịch blob), và các `txpool_*` phương thức khác ngoài `txpool_status` (không có mempool công khai). `newPendingTransactions` các subscription được chấp nhận nhưng không bao giờ phát ra.

## Các phương thức mở rộng của Rome

Ngoài RPC Ethereum chuẩn, proxy còn cung cấp `rome_*` phương thức:

| Phương thức                       | Mục đích                                                                                                                                                                                                         |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome_emulateTx`                  | Mô phỏng một giao dịch ngoài chuỗi (trả về kết quả thực thi Solana)                                                                                                                                              |
| `rome_emulateTxWithPayer`         | Mô phỏng với một payer cụ thể                                                                                                                                                                                    |
| `rome_emulateCallAccounts`        | Mô phỏng và trả về các tài khoản Solana mà một lời gọi chạm tới                                                                                                                                                  |
| `rome_emulateRegRollup`           | Mô phỏng một đăng ký rollup                                                                                                                                                                                      |
| `rome_getResources`               | Báo cáo trạng thái pool tài nguyên của proxy (payer, holder)                                                                                                                                                     |
| `rome_mintId`                     | Giải quyết mint SPL phía sau một wrapper ERC-20                                                                                                                                                                  |
| `rome_buildInfo`                  | Thông tin bản dựng của proxy + thông tin chương trình trên chuỗi                                                                                                                                                 |
| `rome_isCompatible`               | Kiểm tra độ tương thích của proxy/chương trình                                                                                                                                                                   |
| `rome_solanaTxForEvmTx`           | Lấy (các) giao dịch Solana cho một hash giao dịch EVM                                                                                                                                                            |
| `rome_sendUnsignedTransaction`    | Gửi một giao dịch chưa ký (luồng synthetic-sender)                                                                                                                                                               |
| `rome_composeUnsignedAtomicV1`    | Tạo một giao dịch Solana v1 cho phần thân EIP-1559 chưa ký được ủy quyền bằng chữ ký Ed25519 của ví Solana; ví ký nó và ứng dụng phát sóng. Từ chối khi lời gọi không vừa trong một giao dịch nguyên tử duy nhất |
| `rome_composeUnsignedIterativeV1` | Tương tự, nhưng trả về mọi chặng (nguyên tử nếu vừa, nếu không thì các chặng lặp); ví ký từng chặng và gửi chúng với `rome_submitSignedV1Plan`                                                                   |
| `rome_submitSignedV1Plan`         | Phát sóng một kế hoạch đã ký (tối đa 64 chặng); proxy chỉ là lớp truyền tải, ví vẫn là bên trả phí                                                                                                               |
| `rome_relayUnsignedV1`            | Một chữ ký ví, payer của proxy điều khiển các chặng; synthetic trả gas Rome (nạp trước bằng `rome_composeExternalDepositV1`). Trả về hash giao dịch EVM                                                          |
| `rome_composeExternalDepositV1`   | Một giao dịch do ví ký, ghi có số dư gas native của synthetic từ token của ví                                                                                                                                    |

## Các hành vi đặc thù của Rome

### Gas được suy ra từ Solana — hãy ước tính, đừng hardcode

Rome đo việc thực thi bằng đơn vị tính toán của Solana, hiển thị dưới dạng gas EVM. Phần lớn chi phí của một lệnh ghi là việc tạo tài khoản Solana: một người nhận chưa từng được dùng, một tài khoản token mới, một hợp đồng đã triển khai. Các tài khoản đó nằm trong ước tính. Hệ quả thực tế:

* **Dùng `eth_estimateGas`, và đừng bao giờ hardcode `21000`.** Các công cụ tiêu chuẩn (`forge create`, `cast`, Hardhat, ethers, viem, MetaMask) đã gọi nó và nhận được một giá trị dùng được. Với các lời gọi chạm tới chương trình Solana, hãy thêm một biên độ (của SDK `submitRomeTx` đệm thêm 1.3x) và đặt trần gas nếu chính ước tính đó bị revert. Một `21000` giới hạn hardcode sẽ thất bại bất cứ khi nào lệnh ghi tạo tài khoản, ví dụ khi chuyển tới một địa chỉ chưa từng được dùng.
* **Rome chỉ tính gas thực tế đã dùng.** Trong các phép đo dưới đây, gas dùng không bao giờ nhiều hơn ước tính, nên một ước tính cao hơn công việc thực tế sẽ không làm bạn mất phần chênh lệch.
* **Hãy giữ nguyên biên độ mà công cụ của bạn thêm vào.** Trạng thái có thể thay đổi giữa lúc ước tính và lúc giao dịch được đưa lên chuỗi, và ước tính cho một lời gọi tạo ra CPI Solana có thể thấp hơn thực tế. SDK `submitRomeTx` đệm ước tính thêm 1.3x như một biên độ.

Đo trên Hadrian, với giá gas vào khoảng 10.4 gwei tại thời điểm đó:

| Lệnh ghi                                                     | `eth_estimateGas` | Gas đã dùng |
| ------------------------------------------------------------ | ----------------- | ----------- |
| Chuyển native tới một địa chỉ chưa từng được dùng            | 1,086,961         | 1,086,961   |
| Chuyển native tới một địa chỉ đã tồn tại                     | 21,000            | 10,001      |
| Chuyển wUSDC tới một địa chỉ chưa từng được dùng             | 2,544,921         | 2,544,921   |
| Bọc gas vào wUSDC (`withdraw_to_ata`)                        | 21,000            | 10,001      |
| Cấp quyền của wrapper (`approve_spl` trên Helper precompile) | 21,000            | 10,001      |
| Triển khai một hợp đồng 10 byte                              | 1,147,921         | 1,147,921   |

Đây là các phép đo đơn lẻ trên một chuỗi, không phải giới hạn. Các con số phụ thuộc vào những tài khoản mà một lời gọi phải tạo, vì vậy hãy ước tính từng lệnh ghi thay vì sao chép chúng.

### `forge script --broadcast` cần `--skip-simulation`

`forge script` đặt trần gas phát sóng của nó từ một **cục bộ** mô phỏng, điều này cấp phát thiếu so với mô hình gas của Rome. Thêm `--skip-simulation` để Foundry dùng `eth_estimateGas` của chuỗi thay vào đó:

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

`forge create`, `cast send`, và Hardhat không bị ảnh hưởng — chúng đã ước tính trên chuỗi rồi.

### `eth_getLogs` bị giới hạn theo phạm vi (\~12.000 khối)

Giống như Infura, Alchemy và các RPC production khác, `eth_getLogs` từ chối các phạm vi khối quá rộng (lỗi `-32005`). Hãy giới hạn truy vấn của bạn:

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

Một `queryFilter` với không có phạm vi sẽ quét toàn bộ lịch sử và sẽ vượt quá giới hạn — hãy truyền một `fromBlock`/`toBlock`. Các khẳng định sự kiện dựa trên receipt (ví dụ: chờ một tx rồi đọc log của nó) không bị ảnh hưởng.

### Phí

`eth_gasPrice` trả về giá thực, suy ra từ oracle; ví (bao gồm MetaMask) dùng nó và hiển thị phí chính xác. Các trường phí được gửi lên được chấp nhận linh hoạt — cả giao dịch legacy lẫn EIP-1559 đều được đưa lên chuỗi với mặc định của công cụ tiêu chuẩn.


---

# 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/vi/tai-lieu-tham-khao/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.
