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.
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:
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ờ hardcode21000. 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 SDKsubmitRomeTxđệm thêm 1.3x) và đặt trần gas nếu chính ước tính đó bị revert. Một21000giớ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 đó:
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:
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.
Cập nhật lần cuối
Nội dung này có hữu ích không?