> 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/bat-dau-1/architecture.md).

# Kiến trúc

Các thành phần của Rome khớp với nhau như thế nào — thực thi EVM bên trong một chương trình Solana.

Rome nhúng một trình thông dịch bytecode EVM bên trong một chương trình on-chain của Solana. Trong làn khóa EVM, người dùng gửi các giao dịch EVM đã ký tới Rome Proxy qua Ethereum JSON-RPC tiêu chuẩn. Proxy gửi chúng tới chương trình Rome EVM trên Solana. Một giao dịch EVM có thể cần nhiều giao dịch Solana để ghi các phân đoạn vào tài khoản holder hoặc chạy thực thi lặp lại. Trong làn khóa Solana v1, proxy soạn giao dịch. Ví Solana ký nó và gửi trực tiếp tới Solana RPC. Không có lớp thực thi riêng để đồng bộ — trạng thái EVM *là* trạng thái Solana.

## Tổng quan hệ thống

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

## Các thành phần

### Chương trình Rome EVM (on-chain)

Cốt lõi của Rome — một chương trình BPF trên Solana chứa một trình thông dịch bytecode EVM đầy đủ (một nhánh của SputnikVM). Nó:

* Nhận các giao dịch EVM đã ký và các thân EIP-1559 chưa ký dưới dạng lệnh Solana. Một khóa Solana ủy quyền cho một thân chưa ký thông qua chữ ký của fee payer Solana hoặc một lệnh xác minh Ed25519
* Thực thi bytecode Solidity bên trong runtime của Solana
* Ánh xạ mỗi địa chỉ Ethereum (H160) tới một balance PDA theo từng chain chứa nonce, số dư gốc và code của nó. Các storage PDA riêng biệt được gắn với balance PDA. Mỗi địa chỉ cũng có một địa chỉ dẫn xuất từ chương trình để làm thẩm quyền đối với các lời gọi Solana, được gọi là **PDA có thẩm quyền bên ngoài**. PDA này được chia sẻ bởi mọi chain trên chương trình. Nó sở hữu các tài khoản SPL token của địa chỉ và ký các cross-program invocation (CPI) của nó
* Cung cấp các precompile để gọi vào Solana (CPI, System, Helper, Withdraw) cùng với các precompile Ethereum. Nhánh cached bổ sung SystemCached (`0xff…04`), SplCached (`0xff…05`), ASplCached (`0xff…06`) và WithdrawCached (`0xff…0b`). Factory triển khai các wrapper trên nhánh cached này
* Lưu trạng thái EVM (số dư, nonce, code, storage) dưới dạng dữ liệu tài khoản Solana
* Một chương trình Rome EVM duy nhất chứa nhiều chain ID. Chain ID là một phần của địa chỉ balance PDA và storage PDA, chứ không phải của PDA quyền bên ngoài

### Rome Proxy (máy chủ JSON-RPC)

Rome Proxy là một máy chủ Ethereum JSON-RPC tiêu chuẩn. Người dùng kết nối tới `https://hadrian.testnet.romeprotocol.xyz/` cho Hadrian (testnet) và `https://rubicon.mainnet.romeprotocol.xyz/` cho Rubicon (mainnet). Nó chuyển các lời gọi API Ethereum thành hoạt động Solana:

* `eth_sendRawTransaction` → gửi một hoặc nhiều giao dịch Solana v1: `DoTx`, các phân đoạn holder (`TransmitTx`) cùng với `DoTxHolder`, hoặc các nhánh lặp lại. Một bên thanh toán chung ký và trả SOL. Một người nhận phí chung thu gas của người dùng
* `eth_call` → chạy trình thông dịch EVM nguyên bản trong trình mô phỏng trên các tài khoản Solana trực tiếp đọc qua RPC. Mollusk chạy các chương trình Solana được đi tới qua CPI. Nó cũng chạy chương trình Rome EVM khi proxy đo compute units
* `eth_estimateGas` → mô phỏng để ước tính gas. Một đơn vị gas là một lamport chi phí Solana. Mức ước tính không bao giờ thấp hơn 21.000
* `eth_getBalance`, `eth_getCode`, `eth_getTransactionCount`, `eth_getStorageAt` → đọc các tài khoản Solana trực tiếp thông qua trình mô phỏng. `eth_getBlockByNumber`, receipts và logs đến từ Hercules

Nó cũng cung cấp các phần mở rộng của Rome: `rome_emulateTx`, `rome_emulateRegRollup`, `rome_mintId`, `rome_buildInfo` và `rome_getResources`. Các phương thức ví Solana bao gồm `rome_emulateCallAccounts`, `rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1`, `rome_submitSignedV1Plan`, `rome_relayUnsignedV1`, `rome_composeExternalDepositV1` và `rome_sendUnsignedTransaction`. Proxy cũng cung cấp `rome_solanaTxForEvmTx`.

### Hercules (bộ lập chỉ mục)

Hercules theo dõi chương trình Rome EVM trên Solana và tái tạo các khối tương thích với Ethereum trong PostgreSQL. Chúng chứa giao dịch, receipt, log và các thay đổi trạng thái. Trên các chain công khai, nó chạy ở chế độ căn theo slot, nên một số khối ánh xạ tới một slot Solana và cùng một slot sẽ tạo ra cùng một khối trên bất kỳ indexer nào. Proxy cung cấp các khối này cho ví và trình khám phá.

Hercules lập chỉ mục các khối đã được xác nhận. Nó kiểm tra lại mỗi khối tại finalized và tải lại nếu blockhash đã thay đổi. The [Qua trình khám phá](https://docs.rome.builders/vi/ung-dung-tren-rome/via.md) đọc dữ liệu Hercules.

### Precompiles

Rome triển khai ecrecover, SHA-256, RIPEMD-160, identity, các phép toán đường cong BN254 và blake2f với ngữ nghĩa Ethereum, ngoại trừ dữ liệu lỗi từ BN254 và blake2f. Một lời gọi BN254 hoặc blake2f thất bại sẽ trả về dữ liệu revert của Rome `Error(string)` thay vì một buffer rỗng. Modexp (`0x05`) bị vô hiệu hóa và revert với `"lời gọi big_mod_exp bị vô hiệu hóa"`. blake2f từ chối hơn 1.000.000 vòng lặp, điều mà Ethereum cho phép.

Các precompile không thuộc EVM đi vào Solana: **CpiProgram** (`0xFF…08`, CPI tùy ý), **System** (`0xFF…07`, dẫn xuất PDA và các tiện ích base58), **HelperProgram** (`0xFF…09`, tạo ATA/PDA, chuyển SPL, gas↔lamports), và **Withdraw** (`0x42…16`). Nhánh cached là **SystemCached** (`0xff…04`), **SplCached** (`0xff…05`), **ASplCached** (`0xff…06`và **WithdrawCached** (`0xff…0b`). Các CPI legacy chạy ngay lập tức và chỉ trong các giao dịch nguyên tử. Các CPI cached được ghi lại trong quá trình thực thi và được gửi khi commit. Chúng revert cùng với EVM. Chúng có thể chạy trong các giao dịch lặp lại. Xem [Địa chỉ hợp đồng](https://docs.rome.builders/vi/tai-lieu-tham-khao/contract-addresses.md) tham chiếu để xem bảng đầy đủ.

## Chế độ thực thi

Rome thực thi một giao dịch EVM theo một trong hai cách:

### Nguyên tử (VmAt)

Một giao dịch Solana duy nhất. Toàn bộ giao dịch EVM thực thi trong ngân sách tính toán của một giao dịch Solana (\~1,4 triệu compute units). Dùng cho hầu hết các thao tác — chuyển tiền, các lời gọi hợp đồng thông thường, hoán đổi.

### Lặp (VmIt)

Dành cho công việc vượt quá ngân sách của một giao dịch duy nhất. Việc thực thi được chia across nhiều giao dịch Solana:

1. Mỗi bước (một giao dịch Solana) chạy số lượng opcode EVM tối đa phù hợp với ngân sách tính toán của nó — kích thước bước mang tính thích ứng, không cố định
2. Trạng thái VM được tuần tự hóa bằng Borsh vào một `StateHolder` tài khoản giữa các bước
3. Các tài khoản được khóa TTL trong vài giây أثناء thực thi

Proxy sẽ chuyển sang thực thi lặp lại khi compute units, heap hoặc số lượng lệnh không đủ cho một giao dịch Solana. Một phiên bị giới hạn ở 160 vòng lặp. Một CPI theo nhánh legacy sẽ bị từ chối trong giao dịch lặp lại, vì nó không thể được chia ra qua các nhánh. Các CPI theo nhánh cached được cho phép.

## Ánh xạ tài khoản

Mỗi địa chỉ Ethereum được ánh xạ một cách xác định tới một Solana balance PDA được dẫn xuất từ chain ID và địa chỉ dưới chương trình Rome EVM. Số dư gas gốc của nó là một trường trong PDA đó, cùng với nonce và code hợp đồng. Các ô storage nằm trong các storage PDA riêng biệt. Số dư SPL nằm trong các tài khoản token thuộc sở hữu của PDA quyền bên ngoài riêng biệt. Thẩm quyền đó được chia sẻ trên mọi chain trong cùng một chương trình.

## Hai cách đi vào

* **Làn khóa EVM:** một ví gửi giao dịch EVM đã ký secp256k1 tới Rome Proxy. Proxy gửi các giao dịch Solana.
* **Làn khóa Solana:** một ví ủy quyền cho một thân EIP-1559 chưa ký bằng khóa Solana của nó. Với lộ trình trực tiếp v1, proxy soạn giao dịch Solana. Ví ký nó và gửi trực tiếp tới Solana RPC. Lộ trình relay dùng proxy để gửi thay thế. Lộ trình legacy cũ hơn bắt ví tạo, ký và trả phí cho một `DoTxUnsigned` giao dịch Solana, và chương trình suy ra người gửi từ chữ ký Solana.

Một khóa công khai Solana ánh xạ tới địa chỉ tổng hợp `keccak256(pubkey)[12:]`, tức 20 byte cuối của hash. Xem [Solana và EVM gặp nhau trên Rome như thế nào](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/how-solana-and-evm-meet.md).

## Ai ký một lời gọi vào Solana

Chương trình Rome EVM ký một CPI bằng PDA quyền bên ngoài của người gọi trực tiếp gần nhất của precompile. Một hợp đồng ký như chính nó. Để tiêu SPL token của người dùng, hợp đồng cần một ủy quyền SPL từ người dùng đó. Người dùng cấp nó bằng `HelperProgram.approve_spl(spender, amount, mint)`. Một lời gọi trực tiếp từ địa chỉ EVM hoặc địa chỉ tổng hợp của người dùng tới precompile sử dụng PDA quyền bên ngoài của người dùng.

## Tài khoản holder

Các giao dịch Solana (v1) bị giới hạn ở 4 KB, nhưng các giao dịch EVM (đặc biệt là triển khai hợp đồng) có thể lớn hơn nhiều. Rome chia các giao dịch lớn thành các phân đoạn 3.600 byte và ghi chúng tuần tự vào **các tài khoản holder** (tối đa 80 KB). Sau đó nó ghép từng giao dịch và thực thi nó on-chain. Rome SDK xử lý việc này một cách minh bạch. Phí chữ ký của mỗi phân đoạn được tính vào gas của người gửi.

## Gas và định giá

Mỗi chain có token gas riêng: SOL hoặc một SPL token. Nguồn giá là Hermes API, một pool Meteora DAMM v1, một pool Meteora DAMM v2 hoặc một mức giá cố định. Nó cung cấp quy đổi giữa token gas và SOL cho các phí giao dịch Solana cơ sở.

* Một đơn vị gas tương đương một lamport chi phí Solana
* `eth_gasPrice` là wei của token gas trên mỗi lamport
* Người gửi trả phí cho người nhận phí từ số dư gas gốc của mình. Bên thanh toán của proxy trả SOL
* Khi không có người nhận phí, như trong làn nguyên tử của ví Solana, không bị tính gas EVM. Ví trả SOL trực tiếp
* Số dư gốc có 18 chữ số thập phân. Nó được bảo chứng bởi SPL của token gas được giữ trong một ví chương trình theo từng chain

## Tính cuối cùng

Rome sử dụng tính cuối cùng của Solana. SDK chờ cho đến khi `được xác nhận`. Hercules kiểm tra lại mỗi khối đã được lập chỉ mục ở finalized và nạp lại nếu blockhash thay đổi. `đã chốt` và nạp lại nếu blockhash thay đổi.

## Tiếp theo là gì

* [Mạng](https://docs.rome.builders/vi/mang/networks.md) — kết nối tới Hadrian (testnet) và Rubicon (mainnet)
* [Bắt đầu nhanh](https://docs.rome.builders/vi/bat-dau-1/quickstart.md) — triển khai hợp đồng đầu tiên của bạn
* [Mô hình thực thi](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/execution-model.md) — chi tiết về thực thi nguyên tử so với thực thi lặp
* [Tương tác token](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md)
* [Ràng buộc](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/constraints.md)
* [Gọi Solana từ EVM](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md)
* [Gọi EVM từ Solana](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-evm-from-solana.md)
* [Tham chiếu precompile](https://docs.rome.builders/vi/tai-lieu-tham-khao/precompiles.md)
* [Solana và EVM gặp nhau trên Rome như thế nào](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/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/vi/bat-dau-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.
