> 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/cac-khai-niem-cot-loi/how-solana-and-evm-meet.md).

# Cách Solana và EVM gặp nhau trên Rome

Cách ví Solana gọi các hợp đồng Solidity, các địa chỉ EVM gọi các chương trình Solana, và Rome xử lý danh tính, token, phí và giới hạn thực thi.

Trang này giải thích cách các lời gọi đi qua lại giữa Solana và EVM trên Rome. Nó bao gồm ai ký, token ở đâu, ai trả phí và những quy tắc Solana nào ảnh hưởng đến hợp đồng Solidity.

Trừ khi có ghi chú khác, các con số và giao dịch trên trang này là từ Hadrian (testnet) tính đến ngày 19 tháng 10 năm 2026.

## Địa chỉ tổng hợp là gì?

Địa chỉ tổng hợp là danh tính EVM của một khóa công khai Solana. Rome tính nó bằng 20 byte cuối cùng của `keccak256` khóa công khai: `keccak256(pubkey)[12..32]`. Ánh xạ này là cố định. Nó được gọi là tổng hợp vì không ai nắm giữ khóa secp256k1 cho nó: MetaMask không thể ký cho nó, và chỉ khóa Solana mới có thể ủy quyền các lời gọi từ nó.

Ở lời gọi hợp đồng cấp cao nhất, cả `msg.sender` và `tx.origin` đều là địa chỉ tổng hợp. Rome lưu nonce EVM dưới địa chỉ đó. Hợp đồng không thể phân biệt danh tính này với người dùng MetaMask thông qua các trường đó.

## Người dùng Solana gọi một hợp đồng Solidity như thế nào?

Ví ủy quyền cho một lời gọi EIP-1559 chưa ký qua một trong hai luồng. Luồng v1 là đường hiện tại. Luồng kế thừa là đường cũ hơn: ví ký và trả phí cho giao dịch Solana mang `DoTxUnsigned`, và chương trình Rome EVM suy ra địa chỉ tổng hợp từ người ký Solana đó.

Trong luồng v1, ví ký một thông điệp dễ đọc chứa `Rome authorization`, một ký tự xuống dòng, và hàm băm của lời gọi dưới dạng `0x` theo sau bởi 64 ký tự thập lục phân thường. Giao dịch mang chữ ký này trong một chỉ thị xác minh Ed25519 ở chỉ mục 0. Chương trình Rome EVM suy ra địa chỉ tổng hợp từ khóa đã ủy quyền cho lời gọi.

Rome Proxy tạo giao dịch v1. Sau đó ví ký nó và gửi lên Solana. Trên tuyến relay, Rome Proxy nộp giao dịch và trả SOL, còn địa chỉ tổng hợp trả gas từ số dư native của nó bằng token gas gốc của chuỗi (USDC trên Hadrian và Rubicon).

Khi ví trả trực tiếp, luồng v1 tốn 15.000 lamport: phí chữ ký 5.000 lamport, 5.000 lamport cho chữ ký xác minh Ed25519, và một khoản thu quỹ 5.000 lamport. Luồng `DoTxUnsigned` kế thừa cũ hơn không có chỉ thị Ed25519 và tốn 10.000 lamport. Cả hai tuyến cũng trả tiền thuê cho mọi tài khoản được tạo. Không tuyến trực tiếp nào tính gas EVM. Một giao dịch luồng kế thừa trên Hadrian đã tốn của ví 10.000 lamport và báo cáo `gasUsed = 0` và `effectiveGasPrice = 0`.

Đối tượng `submitRomeTxV1` thực hiện các bước sau:

1. Đọc nonce của địa chỉ tổng hợp bằng `eth_getTransactionCount`, ước tính gas và dựng lời gọi chưa ký.
2. Yêu cầu ví ký `Rome authorization` thông điệp dễ đọc.
3. Yêu cầu một giao dịch từ `rome_composeUnsignedAtomicV1`.
4. Xác minh người trả phí trả về, các byte của lời gọi, ủy quyền Ed25519, các chương trình được phép và việc không có phí ưu tiên.
5. Yêu cầu ví ký giao dịch v1, gửi nó lên Solana, và thăm dò Rome Proxy để lấy biên nhận EVM.
6. Nếu lời gọi cần thực thi lặp, hãy chuyển tiếp nó qua `rome_relayUnsignedV1` bằng cùng chữ ký ủy quyền.

Dùng `fundSyntheticGas` để cấp vốn cho số dư native cần cho một relay hoặc `msg.value`. Nó nạp token gas từ tài khoản token của ví và ghi có vào số dư native của địa chỉ tổng hợp. Số dư native dùng 18 chữ số thập phân.

Để dùng token trong một hợp đồng, SDK cấp vốn cho địa chỉ tổng hợp, gọi hợp đồng và trả lại mọi token còn dư. `buildFundLeg` sử dụng `ActivateAta` để chuyển token từ ví vào tài khoản token của địa chỉ tổng hợp. Lời gọi Solidity dùng các token đó thông qua một wrapper. `buildSweepLeg` sử dụng `transfer_spl` để gửi lại số token còn dư về ví.

Ví phải hỗ trợ ký các giao dịch Solana v1. Solflare hỗ trợ điều này trên Solana devnet; Phantom thì chưa. Mọi lời gọi đều kiểm tra và tăng nonce EVM dưới địa chỉ tổng hợp để ngăn phát lại.

Xem [Gọi EVM từ Solana](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-evm-from-solana.md), [Xây dựng một ứng dụng hai làn](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md), và [Rome SDK](https://docs.rome.builders/vi/san-pham/rome-sdk.md).

## Người dùng EVM, hoặc một hợp đồng, gọi một chương trình Solana như thế nào?

Mọi địa chỉ EVM đều có một địa chỉ dẫn xuất từ chương trình Solana sở hữu các tài khoản token của nó và có thể ký các lời gọi đến các chương trình Solana. Đây là PDA ngoại quyền của nó. Chương trình Rome EVM suy ra nó từ seed `EXTERNAL_AUTHORITY` theo sau bởi địa chỉ EVM. Các seed không chứa chain ID, vì vậy các chain được lưu trữ bởi cùng một chương trình Rome EVM sẽ chia sẻ quyền này.

Người dùng hoặc hợp đồng gọi precompile CPI tại `0xFF…08` với program ID đích, danh sách tài khoản và byte chỉ thị. CPI có nghĩa là lời gọi liên chương trình. Precompile gọi chương trình Solana trong cùng một giao dịch Solana.

`invoke` ký cho PDA ngoại quyền của bên gọi trực tiếp khi danh sách tài khoản đánh dấu nó là signer. `invoke_signed` cũng hỗ trợ các PDA được suy ra với salt. Mỗi PDA có salt phải xuất hiện trong danh sách tài khoản với vai trò signer.

Các phương thức `account_info`, `account_data_at`, `account_u64_at`, `account_lamports`, và `pdas_batch_derive` là các trợ giúp chỉ đọc. Chúng không gọi chương trình Solana.

Precompile từ chối các lời gọi nhắm tới chính chương trình Rome EVM. Nó cũng từ chối một danh sách tài khoản chứa program ID của Rome EVM. Một CPI không được đặt tên fee payer của Solana, ngoại trừ bên trong một System `Transfer` instruction thuần.

Một lượt hoán đổi của RomeDexRouter 2.0.0 trên Hadrian đã theo các bước sau:

1. Bộ định tuyến gọi `HelperProgram.create_ata` để đảm bảo tài khoản token đầu ra của người dùng tồn tại.
2. Nó suy ra các tài khoản token đầu vào và đầu ra của người dùng và đánh dấu PDA ngoại quyền của chính nó là signer.
3. Nó gọi `CPI.invoke` với chương trình hoán đổi Solana, danh sách tài khoản và byte chỉ thị hoán đổi.
4. SPL Token chuyển token từ tài khoản của người dùng vào pool và trả token đầu ra về tài khoản kia của người dùng. PDA của bộ định tuyến ký với tư cách SPL delegate của người dùng. Bộ định tuyến không giữ token nào.
5. Bộ định tuyến kiểm tra số lượng nhận được bằng `CPI.account_u64_at(dstAta, 64)`.
6. Biên nhận báo cáo 10.001 gas: `5,000 + 5,000 + 1 = 10,001` lamport chi phí Solana. Những chi phí đó là phí chữ ký, khoản thu quỹ và phí ưu tiên. Rome Proxy trả SOL, còn người dùng trả gas bằng USDC.

Xem [Gọi Solana từ EVM](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md), [Tích hợp một chương trình Solana](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/integrate-solana-program.md), và [Tham chiếu precompile](https://docs.rome.builders/vi/tai-lieu-tham-khao/precompiles.md).

## Ai ký khi một hợp đồng gọi một chương trình Solana?

Rome ký bằng PDA ngoại quyền của bên gọi ngay trước precompile. Do đó, một hợp đồng ký với tư cách chính nó. Chỉ một lời gọi được gửi trực tiếp đến precompile bởi chính EVM hoặc địa chỉ tổng hợp của người dùng mới ký bằng PDA của người dùng.

Để cho phép một router hoặc adapter chuyển token của người dùng, người dùng gọi `approve_spl(spender, amount, mint)`. Điều này đặt PDA ngoại quyền của hợp đồng làm SPL delegate của tài khoản token của người dùng. Đây là phiên bản ERC-20 của Rome `approve`.

Bên dưới `DELEGATECALL`, precompile từ chối signer PDA ngoại quyền trần. Các authority có salt bao gồm hợp đồng đang chạy trong dẫn xuất của chúng dưới `DELEGATECALL`.

## Mọi địa chỉ đều có một PDA, vậy tại sao các wrapper không tách thanh khoản?

Đối với một ví, wrapper là một góc nhìn về các token SPL của nó. `balanceOf` đọc tài khoản token thực của ví trên Solana. `totalSupply` đọc tổng cung của mint.

Ba wrapper wUSDC trên Hadrian (testnet), 9.0.0 (`0xbce339ba…`), 8.0.0 (`0xae287c43…`), và tháng 5 năm 2026 (`0x9fd4d58d…`), cho thấy cùng một số dư cho mỗi ví. Cả ba đều trả về tổng cung của mint từ `totalSupply`.

Một chủ sở hữu native trên Solana và một chủ sở hữu EVM dùng các tài khoản của cùng một mint. Ví Solana sở hữu trực tiếp tài khoản token của nó. PDA ngoại quyền của địa chỉ EVM sở hữu tài khoản token của nó. `ActivateAta` và `transfer_spl` chuyển token giữa các tài khoản này. Cả hai bên đều giao dịch chống lại cùng các tài khoản pool và dự trữ Solana.

Số dư do hợp đồng nắm giữ cần xử lý khác. Token được gửi tới một hợp đồng nằm trong tài khoản ký quỹ của wrapper. Wrapper theo dõi số dư của hợp đồng. Một cặp kiểu UniswapV2 trên Hadrian có số dư 9.600.566 thông qua wrapper 9.0.0 và 0 thông qua wrapper 8.0.0. Hãy dùng wrapper chuẩn từ registry cho pool, vault và thị trường cho vay.

Mỗi tài khoản token chỉ có một khe SPL delegate. Cấp quyền cho một router hoặc cầu nối sẽ thay thế quyền cấp của wrapper. Sau khi xoay wrapper, người dùng phải cấp quyền cho wrapper mới bằng `approve_spl`. Hãy cấp quyền cho wrapper مرة nữa nếu một delegate khác đã thay thế nó.

Mỗi factory chỉ cho phép một wrapper cho mỗi mint. Các wrapper từ các factory khác nhau vẫn có thể đọc cùng các tài khoản token của ví. Xem [Tương tác token](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md).

## Rome làm cách nào để xử lý các ngữ nghĩa khác nhau của Solana và EVM?

| Khác biệt                                          | Rome làm gì                                                                                                                                                                                                                              |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Các tài khoản khai báo trước so với truy cập động  | Mô phỏng lời gọi trước rồi dùng các tài khoản đã chạm tới làm danh sách tài khoản của chỉ thị Solana.                                                                                                                                    |
| Giới hạn tính toán và kích thước của một giao dịch | Dùng thực thi nguyên tử (VmAt) khi lời gọi vừa khít. Các tài khoản holder mang payload lớn hơn, còn thực thi lặp (VmIt) chia công việc qua nhiều giao dịch.                                                                              |
| Khóa tài khoản qua các lượt                        | Gia hạn khóa trên các tài khoản số dư và lưu trữ ở mỗi lượt. Khóa kéo dài 3 giây, hoặc 4 giây khi giao dịch đặt tên hơn 28 tài khoản. Một lần ghi nguyên tử vào tài khoản đang bị khóa sẽ thất bại với `AccountLocked`.                  |
| Token gas và phí                                   | Tính các chi phí Solana bằng lamport và quy đổi chúng thành phí bằng token gas theo giá gas của giao dịch. Các lời gọi do ví trả tiền thanh toán SOL trực tiếp.                                                                          |
| Block và slot                                      | Sử dụng slot Solana cho `block.number` và đồng hồ Solana cho `block.timestamp`.                                                                                                                                                          |
| Tính cuối cùng                                     | Xác nhận ở Solana `được xác nhận`. Hercules kiểm tra lại các block được lập chỉ mục tại `đã chốt`.                                                                                                                                       |
| Chữ ký                                             | Xác minh chữ ký EVM bằng `secp256k1_recover`. Ủy quyền Solana dùng Ed25519. Cả hai đều tạo ra một người gửi EVM dài 20 byte.                                                                                                             |
| Rent                                               | Cấp vốn cho việc tạo và mở rộng tài khoản Solana thông qua fee payer. Tính phí người gửi EVM thông qua gas khi có người nhận phí.                                                                                                        |
| Số chữ số thập phân và độ rộng số nguyên           | Dùng 18 chữ số thập phân cho số dư gas native. Việc chuyển đổi sang đơn vị SPL phải chính xác và vừa với `u64`. Wrapper dùng số chữ số thập phân của mint và từ chối các số lượng vượt quá `uint64` mức tối đa.                          |
| Tái nhập và đo gas                                 | Không có bộ đếm gas opcode EVM. Mức 2.300 gas không hạn chế các lời gọi, nên hợp đồng cần các cơ chế chặn tái nhập rõ ràng.                                                                                                              |
| Độ sâu CPI                                         | Chạy chương trình Rome EVM ở độ sâu 1 và mục tiêu CPI ở độ sâu 2. Solana cho phép lồng tới độ sâu 5.                                                                                                                                     |
| Tính nguyên tử của các tác động phụ trên Solana    | Thực thi các CPI kế thừa ngay lập tức và hủy toàn bộ giao dịch nếu frame của chúng sau đó hoàn nguyên. Các lời gọi được cache được ghi lại trong quá trình thực thi và gửi lúc commit. Chúng bị loại bỏ khi frame của chúng hoàn nguyên. |
| `SELFDESTRUCT` và các opcode chưa biết             | Tắt `SELFDESTRUCT`. Nó và các opcode chưa được triển khai khác sẽ hủy toàn bộ giao dịch với `IncompatibleVersionEVM`.                                                                                                                    |
| Nonce                                              | Lưu trữ và kiểm tra một nonce EVM cho mỗi người gửi trong balance PDA của nó. Ước tính gas bỏ qua kiểm tra nonce.                                                                                                                        |

### Tài khoản

Bộ mô phỏng chạy lời gọi trên các tài khoản Solana trước khi gửi. Nó ghi lại mọi tài khoản đã chạm tới và liệu nó có cần ghi được hay không. Tập đó trở thành danh sách tài khoản của chỉ thị Solana. Một tài khoản bắt buộc mà thiếu khỏi danh sách sẽ làm lời gọi on-chain thất bại.

Một nhánh phụ thuộc thời gian có thể thay đổi giữa mô phỏng và thực thi. Nếu thay đổi đó khiến lời gọi vượt ngân sách tính toán, Rome Proxy sẽ dựng lại một lần ở block tiếp theo.

### Kích thước giao dịch và tính toán

Thực thi nguyên tử (VmAt) vừa trong một giao dịch Solana, với khoảng 1,4 triệu đơn vị tính toán và tối đa 64 tài khoản. Lời gọi cũng phải vừa với giới hạn heap và dấu vết chỉ thị.

Một giao dịch Solana v1 chứa tối đa 4.096 byte. Với các payload giao dịch EVM lớn hơn, Rome Proxy ghi các đoạn 3.600 byte vào một `TxHolder` tài khoản holder có kích thước tối đa 80.000 byte. Phí chữ ký của mỗi đoạn được tính như gas.

Thực thi lặp (VmIt) lưu trạng thái VM trong một `StateHolder` tài khoản holder giữa các lượt. Một phiên cho phép tối đa 160 vòng lặp. Bộ lập kế hoạch tạo tối đa 128 lượt, với giới hạn opcode ít nhất 500 mỗi lượt. Các CPI kế thừa yêu cầu thực thi nguyên tử. Các lời gọi được cache hỗ trợ thực thi lặp.

### Gas và rent

Một đơn vị gas Rome đại diện cho một lamport chi phí Solana. Chi phí bao gồm phí chữ ký, khoản thu quỹ 5.000 lamport, phí ưu tiên và rent sau khi trừ hoàn tiền. `eth_gasPrice` báo cáo wei của token gas trên mỗi lamport. Khi có người nhận phí, Rome tính phí người gửi `lamport × tx.gasPrice` từ số dư native.

Fee payer của Solana tài trợ rent khi Rome tạo hoặc mở rộng các tài khoản balance và storage. Chi phí đó được tính cho người gửi EVM dưới dạng gas khi có người nhận phí. Do đó, lần chuyển đầu tiên tới một địa chỉ chưa từng dùng sẽ tốn khoảng 1 triệu gas. `eth_estimateGas` không bao giờ trả về nhỏ hơn 21.000.

### Block, thời gian và tính cuối cùng

`block.number` là slot Solana. `block.timestamp` là dấu thời gian Unix của đồng hồ Solana. Rome ghi nhận cả hai khi tạo trạng thái VM và giữ chúng qua các lượt lặp.

`blockhash(n)` là `keccak256(bytes32(n))` trong 256 slot gần nhất và bằng 0 bên ngoài chúng. Nó không có entropy. `block.coinbase` là người nhận phí, hoặc bằng 0 khi không có.

SDK chờ `đượ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.

### Hoàn nguyên, tái nhập và CPI

CPI kế thừa thực thi ngay lập tức. Nếu một frame đã thực hiện CPI sau đó hoàn nguyên, Rome sẽ hủy toàn bộ giao dịch. Solidity `try/catch` không thể hấp thụ lần hoàn nguyên đó. Các lời gọi được cache được ghi lại trong quá trình thực thi và gửi lúc commit. Một frame hoàn nguyên sẽ loại bỏ các lời gọi đã ghi của nó. Một khi giao dịch đã ghi thông qua một luồng, các lần ghi qua luồng kia sẽ bị từ chối. Sau một lần ghi được cache, các trợ giúp đọc kế thừa cũng bị từ chối: các lần đọc tài khoản của CpiProgram và `pdas_batch_derive`, và của HelperProgram `user_balance`, `allowance_of` và `mint_info`.

Rome không có bộ đếm gas opcode EVM. `gasleft()` trả về giới hạn gas, hoặc `U256::MAX` khi không có người nhận phí. Lượng gas truyền tới `CALL` hoặc `CREATE` không được thực thi. Hãy dùng các cơ chế chặn tái nhập rõ ràng thay vì dựa trên suất 2.300 gas.

Độ sâu ngăn xếp chỉ thị của Solana là 5. Chương trình Rome EVM chạy ở độ sâu 1, vì vậy mục tiêu của nó chạy ở độ sâu 2 và có thể lồng tới độ sâu 5. Lượt hoán đổi trên Hadrian đã chạy chương trình swap ở độ sâu 2 và SPL Token ở độ sâu 3. Một thay đổi Solana đang chờ (SIMD-0268) sẽ tăng độ sâu từ 5 lên 9. Nó chưa hoạt động trên devnet hay mainnet tính đến ngày 19 tháng 10 năm 2026. Một CPI quay trở lại chương trình Rome EVM sẽ bị từ chối.

Xem [Mô hình thực thi](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/execution-model.md), [Ràng buộc](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/constraints.md), [Ngân sách tính toán](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/compute-budget.md), và [Các Hạn chế Đã Biết](https://docs.rome.builders/vi/bao-mat/known-limitations.md).

## Các câu hỏi thường gặp

### MetaMask và Phantom có phải là cùng một tài khoản trên Rome không?

Không. Một khóa MetaMask và một khóa Solana tạo ra hai địa chỉ EVM khác nhau, và Rome không bao giờ liên kết chúng. Khóa MetaMask cho địa chỉ Ethereum thông thường của nó. Khóa Solana cho [địa chỉ tổng hợp](#what-is-a-synthetic-address), `keccak256(pubkey)[12..32]`: `2PMoUv…` trở thành `0x45b64dae…`. Ở lời gọi cấp cao nhất, `msg.sender` và `tx.origin` là địa chỉ ký, bao gồm cả địa chỉ tổng hợp trên tuyến relay.

Các khóa khác nhau gây ra sự tách biệt: hai khóa MetaMask cũng là hai tài khoản. Các đường cong chỉ có nghĩa là không khóa nào có thể ký cho địa chỉ của khóa kia. Không có tính năng liên kết. `ActivateAta` chỉ cấp vốn cho địa chỉ tổng hợp của chính người ký. Một `Nạp` instruction có thể ghi có gas native cho bất kỳ địa chỉ EVM nào, được thanh toán từ tài khoản token gas của người ký. Proxy chỉ dựng các khoản nạp vào địa chỉ tổng hợp của chính người ký. Không điều nào trong số này biến hai khóa thành một tài khoản. Một pool thấy hai người nắm giữ, nhưng cả hai đều giao dịch chống lại cùng các dự trữ; xem [Thanh khoản có được chia sẻ](#is-liquidity-shared-between-solana-and-evm-users-or-split).

### Các tài khoản Solana và EVM ánh xạ như thế nào?

Rome ánh xạ mỗi khóa Solana tới một [địa chỉ EVM tổng hợp](#what-is-a-synthetic-address). Mỗi địa chỉ EVM có một balance PDA theo mỗi chain cho nonce, số dư gas native và code của nó. PDA ngoại quyền của nó sở hữu các tài khoản token và ký CPI. Các chain trên một chương trình Rome dùng chung quyền này.

Các tài khoản này đã được đọc trên Hadrian (testnet):

| Tài khoản                         | Địa chỉ MetaMask `0x35153297…a266`                                                | ví Solana `2PMoUv…`, địa chỉ tổng hợp `0x45b64dae…127d`                                              |
| --------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Các tài khoản Solana riêng của ví | Không có từ khóa MetaMask                                                         | Tài khoản hệ thống SOL `2PMoUv…`; tài khoản wSOL riêng `T8gKAAg9pz5eLcerH1Nh52Hn97m1nnGyhY9z4bwtyir` |
| Balance PDA                       | `8zuWEakFcuRRJ5Gju44u6Ptyk22gbNUMbsD8VLEQVS4c`                                    | `EeRr14Feh3Ft7YuyacAVJQd3YSYsKAPTqdMEN43gtBSd`                                                       |
| PDA ngoại quyền                   | `EZSTURZAg3GMqiWN3NBCvMLjEeLSxGH9PGooW6dAG8Kb`                                    | `FMSHMpgdA9rEhzGLSvFniAHT7BmGjJweQqxPiGJJntC1`                                                       |
| Tài khoản token Rome sử dụng      | USDC `8wAzpmag4oL4c6ku6wqQBjxWXYLPoVsek6SyAvrYaxim`, thuộc sở hữu của `EZSTURZA…` | wSOL `3pPjxR4ho3mVb5AMauVCjqTBUVS2Rif5JAnk9DFukPg2`, thuộc sở hữu của `FMSHMpgd…`                    |

Token của người dùng Solana nằm ở hai nơi: các tài khoản riêng của ví và các tài khoản thuộc PDA của địa chỉ tổng hợp mà wrapper đọc. SDK chuyển token vào bằng `ActivateAta` và chuyển lại bằng `transfer_spl`, như được mô tả trong [Người dùng Solana gọi một hợp đồng Solidity như thế nào?](#how-does-a-solana-user-call-a-solidity-contract). Lệnh sweep `0x95b2502d…` đã trả 0,016587 wSOL về ví. Cùng một địa chỉ MetaMask có các tài khoản token khác nhau trên Hadrian (testnet) và Rubicon (mainnet) vì chúng chạy trên các chương trình Rome, mint và cụm Solana khác nhau.

### Khi một người dùng EVM và một người dùng Solana gọi cùng một hợp đồng, ai trả loại phí nào? Là một đường phí hay hai?

Rome dùng một mô hình chi phí với hai cách để thanh toán nó. Một đơn vị gas Rome là một lamport chi phí Solana: phí chữ ký, khoản thu quỹ 5.000 lamport, mọi phí ưu tiên và rent sau khi trừ hoàn tiền.

Trên các luồng Solana do ví ký, fee payer của Solana trả chi phí đó bằng SOL mà không bị tính phí gas EVM. Trên các lời gọi MetaMask và relay, Rome Proxy ứng trước SOL. Chương trình tính phí người gửi EVM `lamport × gasPrice của giao dịch` từ số dư native của nó tới một proxy fee recipient. Token gas là USDC trên Hadrian (testnet) và Rubicon (mainnet).

Hai `lời gọi cung cấp` (USDC từ MetaMask, wSOL từ khóa Solana) đã dùng AavePool 2.0.0 (`0x81e7e7e4…`) trên Hadrian (testnet). Mỗi lời gọi tạo ra hai tài khoản.

| Chi phí hoặc người nhận  | Khóa EVM (MetaMask)                                                               | Khóa Solana (v1 do ví ký)                                                                                 |
| ------------------------ | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Giao dịch EVM            | `0xc7e6ee8d…`, từ `0x35153297…`                                                   | `0xb0712551…`, từ `0x45b64dae…`                                                                           |
| Ai đã ký và trả SOL      | người trả phí của proxy Rome `GNX1fLhb…`                                          | ví của người dùng `2PMoUv…`                                                                               |
| SOL đã chi               | 2.102.962 lamport = 5.000 chữ ký + 2 ưu tiên + 5.000 thu quỹ + 2 × 1.046.480 rent | 2.107.960 lamport = 10.000 phí chữ ký (giao dịch + xác minh Ed25519) + 5.000 thu quỹ + 2 × 1.046.480 rent |
| Gas EVM được tính        | Người gửi đã trả 2.102.962 gas × 13.004.742.450 wei = 0,0273485 USDC              | `gasUsed` 0, `gasPrice` 0                                                                                 |
| Gas được trả cho         | Người nhận phí của proxy `0x179d6112…`                                            | Không ai; không có `gasRecipient`                                                                         |
| Người nhận khoản thu quỹ | `7WDWCxvk…`, tài khoản quỹ #31                                                    | `3F9eKFpr…`, tài khoản quỹ #6                                                                             |

* **Luồng kế thừa (đường cũ hơn):** `0x350b8e36…` đã tốn của ví 1.056.480 lamport: phí chữ ký 5.000 + thu quỹ 5.000 + rent 1.046.480, cho một tài khoản được tạo. Gas EVM là 0.
* **Relay:** Aave `borrow` giao dịch `0x18d65e8c…` đã dùng 16 lượt Solana. Địa chỉ tổng hợp đã trả 2.177.992 gas = 0,0226594 USDC, dùng cùng đường phí như người dùng MetaMask. Khoản gas tính cho `16 × 5.002 + 5.000 thu quỹ + 2 × 1.046.480 rent = 2.177.992`. Mỗi lượt relay cũng mang chữ ký xác minh Ed25519. Proxy trả 5.000 lamport cho mỗi lượt đó và không tính lại, vì vậy lời gọi này tốn proxy 16 × 10.002 lamport phí.
* **Kho bạc chung:** Mỗi tuyến đều nộp khoản thu quỹ 5.000 lamport của nó vào một trong 64 tài khoản kho bạc của chuỗi. Hai lời gọi cung cấp ở trên đã nộp khoản thu của chúng vào các tài khoản #31 và #6 của cùng một tập.
* **Giá được khai báo:** Rome tính giá được khai báo của giao dịch, `maxFeePerGas` cho EIP-1559. Không có base fee hay hoàn lại phần chênh lệch. Các giao dịch dùng khóa EVM trực tiếp đã khai báo từ 1× đến 2× `eth_gasPrice` mức báo giá 10.403.793.960 wei mỗi lamport, và mỗi giao dịch trả đúng số đã khai báo. Gas được định giá theo mỗi lamport chi phí Solana, không phải theo mỗi opcode EVM.
* **Chi phí do ví ký:** Các luồng SDK không đặt phí ưu tiên, nên người dùng không trả phí tính toán. Họ trả phí chữ ký, khoản thu quỹ và rent bằng SOL. Luồng v1 trả cho hai chữ ký: chữ ký giao dịch và xác minh Ed25519.

Xem [luồng gọi Solana](#how-does-a-solana-user-call-a-solidity-contract) và [hướng dẫn hai luồng](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md) cho các tuyến ví và relay.

### Thanh khoản có được chia sẻ giữa người dùng Solana và EVM, hay bị tách riêng?

Được chia sẻ. Cả hai luồng đều giao dịch chống lại các tài khoản của cùng một mint. Trên Aave trên Hadrian (testnet), một khóa Solana và một khóa EVM theo luồng MetaMask đều cung cấp và vay thông qua tài khoản ký quỹ wSOL `3yY2FHSG…` (MetaMask: cung cấp `0xaf460f52…`, vay `0x89dbf0b6…`; khóa Solana: cung cấp `0xb0712551…`, vay `0x18d65e8c…`). Đây là ký quỹ của wrapper wSOL, nơi giữ dự trữ awSOL.

Trên rome-dex, một ví Solana đã gửi thanh khoản trực tiếp vào cùng các vault được dùng bởi hoán đổi của router EVM `0xa7f77530…`. Giao dịch gửi Solana `2xFSzza7…` không chứa chương trình Rome nào. Chỉ các số dư do hợp đồng nắm giữ mới phụ thuộc vào wrapper, vì vậy hãy dùng wrapper chuẩn của registry cho pool và vault (xem phần [PDA và wrapper](#every-address-has-a-pda-so-why-dont-the-wrappers-split-liquidity)). Đừng đo thanh khoản wSOL bằng `totalSupply`: nó đọc 0 vì mint SOL native báo cáo tổng cung là 0.

### Làm cách nào để chuyển token và số dư gas giữa một địa chỉ MetaMask và một ví Solana?

* **Từ ví Solana đến địa chỉ MetaMask, token:** Tạo tài khoản token nếu nó còn thiếu (lệnh tạo idempotent của Associated Token program, với PDA ngoại quyền của địa chỉ làm chủ sở hữu), rồi gửi một chuyển SPL thông thường tới nó. `HelperProgram.ata(address, mint)` trả về địa chỉ của nó. Giao dịch `2tBhefMJ…` đã làm cả hai và chuyển 20 USDC.
* **Từ ví Solana đến địa chỉ MetaMask, gas:** Nạp địa chỉ tổng hợp của chính bạn bằng `fundSyntheticGas`. Sau đó gửi một chuyển giá trị native từ địa chỉ tổng hợp đến địa chỉ MetaMask.
* **Từ địa chỉ MetaMask đến ví Solana, token:** Gọi `transfer_spl(bytes32,uint64,bytes32)` trên precompile Helper trực tiếp từ địa chỉ EVM, với tài khoản token hiện có của người nhận. Hoặc, gọi `RomeBridgeWithdraw.bridgeOutToSolana`, điều này cần một quyền cấp và một tài khoản token người nhận hiện có.
* **Từ địa chỉ MetaMask đến ví Solana, gas:** Gọi precompile Withdraw có thể thanh toán `withdrawal(bytes32 to)` với số lượng dưới dạng `msg.value`. Ví nhận nó dưới dạng USDC trong tài khoản token USDC của nó, mà Rome tạo nếu cần. `msg.value` phải là bội số của 10^12 wei. Người nhận phải là một tài khoản ví hiện có.

`transfer_spl_to_signer` chỉ đến ví của chính bạn trên làn Solana được ký bởi ví. Từ MetaMask hoặc qua relay, bên ký là payer proxy của Rome, nên lời gọi thất bại hoặc token sẽ đi vào Rome. Xem [Tham chiếu precompile](https://docs.rome.builders/vi/tai-lieu-tham-khao/precompiles.md).

Một danh tính chỉ có thể chi tiêu token của danh tính kia thông qua một quyền cấp rõ ràng, `approve_spl` hoặc một ERC-20 `approve`, giống như với bất kỳ địa chỉ nào khác. Mỗi tài khoản token có một ô ủy quyền. Xem [Tương tác token](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md#one-time-grant-per-wallet).

### Địa chỉ của tôi có giống nhau trên mọi chuỗi Rome không?

Địa chỉ EVM giống nhau trên mọi chuỗi vì nó được tạo từ khóa. Nonce và số dư gas của nó được giữ theo từng chuỗi. Các tài khoản token của nó được chia sẻ giữa các chuỗi dùng cùng một chương trình Rome và khác nhau giữa các chương trình và cụm. Xem [ánh xạ tài khoản](#how-do-solana-and-evm-accounts-map).

### Ví nào hoạt động trên làn Solana? Phantom có hoạt động không?

Chưa có trên làn Solana. Làn Solana sử dụng các giao dịch Solana v1, và ví phải ký chúng. Trên devnet, Solflare thì có; Phantom thì chưa.

### Trình khám phá có hiển thị giao dịch đã dùng làn nào không?

Một phần.  [Qua trình khám phá](https://docs.rome.builders/vi/ung-dung-tren-rome/via.md) cho biết liệu khóa EVM hay khóa Solana đã gửi một lời gọi: `nguồn gốc` là `ecdsa` hoặc `solana_unsigned`, và các lời gọi bằng khóa Solana mang `solanaSigner`. Nó không phân biệt được các tuyến legacy, v1 và relay; cả ba đều hiển thị `solana_unsigned`. Một lời gọi relay là lời có giá trị khác 0 của `gasUsed` và một `gasRecipient`. Một lần nạp gas được thực hiện bằng `fundSyntheticGas` hiển thị là `ecdsa` không có `solanaSigner`.

## Đi tiếp ở đâu

* [Kiến trúc](https://docs.rome.builders/vi/bat-dau-1/architecture.md)
* [Mô hình thực thi](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/execution-model.md)
* [Tương tác token](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.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)
* [Xây dựng một ứng dụng hai làn](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md)
* [Tích hợp một chương trình Solana](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/integrate-solana-program.md)
* [Tham chiếu precompile](https://docs.rome.builders/vi/tai-lieu-tham-khao/precompiles.md)
* [tham chiếu JSON-RPC](https://docs.rome.builders/vi/tai-lieu-tham-khao/json-rpc.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/cac-khai-niem-cot-loi/how-solana-and-evm-meet.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.
