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

# Поддержка JSON-RPC

Методы Ethereum JSON-RPC, поддерживаемые конечными точками Rome EVM, а также особенности Rome — для Foundry, Hardhat, ethers, viem и MetaMask.

Эндпоинты EVM Rome используют стандартный Ethereum JSON-RPC. Foundry, Hardhat, ethers, viem и MetaMask работают с Rome так же, как и с любой EVM-цепочкой. На этой странице перечислено, что поддерживается, а также несколько особенностей Rome, о которых стоит знать.

## Поддерживаемые методы

**Основные (состояние и выполнение):** `eth_chainId`, `eth_blockNumber`, `eth_getBalance`, `eth_getCode`, `eth_getStorageAt`, `eth_getTransactionCount`, `eth_call`, `eth_estimateGas`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_feeHistory`.

**Блоки и транзакции:** `eth_getBlockByNumber`, `eth_getBlockByHash`, `eth_getBlockReceipts`, `eth_getTransactionByHash`, `eth_getTransactionReceipt`, `eth_sendRawTransaction`, варианты по индексу/количеству блока.

**Логи и фильтры:** `eth_getLogs`, `eth_newFilter`, `eth_newBlockFilter`, `eth_getFilterChanges`, `eth_getFilterLogs`, `eth_uninstallFilter`.

**Подписки WebSocket:** `eth_subscribe` / `eth_unsubscribe` (`newHeads`, `logs`). См. [Подписки WebSocket](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/websocket-subscriptions.md).

**Сеть / web3:** `net_version`, `net_listening`, `net_peerCount`, `web3_clientVersion`.

**Небольшие методы для интроспекции:** `rpc_modules` (перечисляет `debug`, `eth`, `net`, `Rome`, `rpc`, `txpool`, `web3`), `eth_syncing` (всегда `false`), `eth_accounts` (всегда пустой список), `eth_getUncleCountByBlockNumber`, `eth_getUncleCountByBlockHash`, `eth_getUncleByBlockNumberAndIndex` и `eth_getUncleByBlockHashAndIndex` (uncle-блоков нет, поэтому счетчики равны `0x0` и запросы возвращают `null`), `eth_newPendingTransactionFilter` (принимается, но никогда не возвращает хеши, поскольку публичного мемпула нет), а `txpool_status`, который всегда возвращает `{"pending":"0x0","queued":"0x0"}` поскольку публичного мемпула нет.

**Трассировка:** `debug_traceRomeTransaction` принимает хеш транзакции и возвращает разбивку по каждому подвызову и каждому CPI для транзакции, которая объединяет несколько вызовов в один пакет. Обычные транзакции возвращают `null`, как и хеш, который неизвестен или еще не проиндексирован.

### Не поддерживается

`debug_traceTransaction` / `trace_*` (трассировка транзакций в стиле Ethereum; они возвращают `-32601`), `eth_getProof`, `eth_createAccessList`, `eth_blobBaseFee` (нет blob-транзакций), а `txpool_*` методы, кроме `txpool_status` (публичного мемпула нет). `newPendingTransactions` подписки принимаются, но никогда не эмитируют события.

## Расширенные методы Rome

Помимо стандартного Ethereum RPC, прокси предоставляет `rome_*` методы:

| Метод                             | Назначение                                                                                                                                                                                                                                             |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `rome_emulateTx`                  | Эмулировать транзакцию вне цепочки (возвращает результат выполнения в Solana)                                                                                                                                                                          |
| `rome_emulateTxWithPayer`         | Эмулировать с конкретным плательщиком                                                                                                                                                                                                                  |
| `rome_emulateCallAccounts`        | Эмулировать и вернуть аккаунты Solana, которых касается вызов                                                                                                                                                                                          |
| `rome_emulateRegRollup`           | Эмулировать регистрацию роллапа                                                                                                                                                                                                                        |
| `rome_getResources`               | Сообщить состояние пула ресурсов прокси (плательщики, держатели)                                                                                                                                                                                       |
| `rome_mintId`                     | Определить SPL mint, скрытый за оберткой ERC-20                                                                                                                                                                                                        |
| `rome_buildInfo`                  | Сборка прокси и информация о программе в сети                                                                                                                                                                                                          |
| `rome_isCompatible`               | Проверить совместимость прокси/программы                                                                                                                                                                                                               |
| `rome_solanaTxForEvmTx`           | Получить транзакцию(и) Solana для хеша EVM-транзакции                                                                                                                                                                                                  |
| `rome_sendUnsignedTransaction`    | Отправить неподписанную транзакцию (сценарии synthetic-sender)                                                                                                                                                                                         |
| `rome_composeUnsignedAtomicV1`    | Сформировать одну транзакцию Solana v1 для неподписанного тела EIP-1559, авторизованного подписью Ed25519 кошелька Solana; кошелек подписывает ее, а приложение отправляет ее в сеть. Отказывает, если вызов не помещается в одну атомарную транзакцию |
| `rome_composeUnsignedIterativeV1` | То же, но возвращает каждый этап (атомарно, если помещается, иначе итеративные этапы); кошелек подписывает каждый и отправляет их с `rome_submitSignedV1Plan`                                                                                          |
| `rome_submitSignedV1Plan`         | Отправить подписанный план (до 64 этапов); прокси выполняет только транспортировку, кошелек остается плательщиком комиссии                                                                                                                             |
| `rome_relayUnsignedV1`            | Одна подпись кошелька, плательщик прокси управляет этапами; синтетический адрес оплачивает газ Rome (сначала пополните его через `rome_composeExternalDepositV1`). Возвращает хеш EVM-транзакции                                                       |
| `rome_composeExternalDepositV1`   | Одна транзакция, подписанная кошельком, которая пополняет нативный газовый баланс синтетического адреса за счет токенов кошелька                                                                                                                       |

## Особенности Rome

### Газ определяется на основе Solana — оценивайте, не задавайте жестко

Rome измеряет выполнение в вычислительных единицах Solana, отображаемых как EVM-газ. Основная часть стоимости записи — это создание аккаунтов Solana: получателя, который никогда не использовался, нового токен-аккаунта, развернутого контракта. Эти аккаунты входят в оценку. Практические последствия:

* **Используйте `eth_estimateGas`, и никогда не задавайте жестко `21000`.** Стандартные инструменты (`forge create`, `cast`, Hardhat, ethers, viem, MetaMask) уже вызывают его и получают пригодное значение. Для вызовов, затрагивающих программы Solana, добавьте запас (SDK `submitRomeTx` увеличивает оценку в 1,3 раза) и установите верхний предел газа, если сама оценка завершается откатом. Жестко заданный `21000` лимит проваливается всякий раз, когда запись создает аккаунты, например при переводе на адрес, который никогда не использовался.
* **Rome списывает фактически использованный газ.** В приведенных ниже измерениях использованный газ никогда не превышал оценку, поэтому более высокая оценка по сравнению с фактически выполненной работой не стоит вам разницы.
* **Оставляйте запас, который добавляет ваш инструментарий.** Состояние может измениться между оценкой и моментом включения транзакции в блок, а оценка для вызова, который выполняет CPI в Solana, может оказаться заниженной. SDK `submitRomeTx` увеличивает оценку в 1,3 раза в качестве запаса.

Измерено на Hadrian, при цене газа около 10,4 gwei на тот момент:

| Запись                                                          | `eth_estimateGas` | Использовано газа |
| --------------------------------------------------------------- | ----------------- | ----------------- |
| Нативный перевод на адрес, который никогда не использовался     | 1,086,961         | 1,086,961         |
| Нативный перевод на существующий адрес                          | 21,000            | 10,001            |
| Перевод wUSDC на адрес, который никогда не использовался        | 2,544,921         | 2,544,921         |
| Обернуть газ в wUSDC (`withdraw_to_ata`)                        | 21,000            | 10,001            |
| Выдача прав обертке (`approve_spl` в прекомпилированном Helper) | 21,000            | 10,001            |
| Развернуть контракт на 10 байт                                  | 1,147,921         | 1,147,921         |

Это единичные измерения для одной цепочки, а не ограничения. Числа зависят от того, какие аккаунты вызов должен создать, поэтому оценивайте каждую запись отдельно, а не копируйте их.

### `forge script --broadcast` требует `--skip-simulation`

`forge script` устанавливает лимит газа для broadcast на основе **локальной** симуляции, которая занижает значение по сравнению с газовой моделью Rome. Добавьте `--skip-simulation` чтобы Foundry использовал значение сети `eth_estimateGas` вместо этого:

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

`forge create`, `cast send`, а Hardhat — не затронуты: они уже оценивают в сети.

### `eth_getLogs` имеет ограничение по диапазону (\~12 000 блоков)

Как и Infura, Alchemy и другие продакшн-RPC, `eth_getLogs` отклоняет слишком широкие диапазоны блоков (ошибка `-32005`). Ограничивайте запросы:

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

Приложение `queryFilter` без диапазона сканирует всю историю и превысит лимит — передайте явные `fromBlock`/`toBlock`. Проверки событий на основе квитанций (например, ожидание транзакции и чтение ее логов) не затронуты.

### Комиссии

`eth_gasPrice` возвращает реальную цену, полученную от оракула; кошельки (включая MetaMask) используют ее и отображают корректные комиссии. Переданные поля комиссии принимаются без строгих ограничений — как legacy, так и EIP-1559 транзакции проходят со стандартными значениями инструментов по умолчанию.


---

# 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/ru/spravochnik/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.
