> 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/produkty/rome-cli.md).

# Rome CLI + MCP

`rome` проводит разработчика — человека или ИИ-агента — через весь жизненный цикл разработки на Rome: проверенные факты о цепочке, правильный шаблон, вызовы контрактов, входной шлюз для пополнения, deploy/send, диагностика между ВМ и проверка работоспособности для обеих дорожек. Один общий набор возможностей, два согласованных интерфейса — CLI (`rome <command>`) и  [MCP](https://modelcontextprotocol.io) сервер (`rome mcp`) — так агент и человек используют одну и ту же ментальную модель.

## Установка

Сначала репозиторий (публикация в npm ожидается):

```bash
# разовый запуск, без установки:
npx github:rome-protocol/rome-cli facts chain hadrian

# постоянная установка — клонировать и связать:
git clone https://github.com/rome-protocol/rome-cli
cd rome-cli && npm install && npm install -g .
```

Обычная `npm install -g github:rome-protocol/rome-cli` не **работает** сегодня — npm подготавливает git-зависимости пакета без собственных node\_modules ([rome-cli#25](https://github.com/rome-protocol/rome-cli/issues/25)). Используйте разовый запуск через npx или clone + link. Закрепляйте тег (`github:rome-protocol/rome-cli#v0.8.0`), когда вам нужны воспроизводимые запуски.

## Два слоя над одним ядром

**Чтение — привязка к фактам и диагностика.** Без ключей; и в CLI, и на MCP-сервере.

| Команда                                                  | Что она возвращает                                                                                                                         |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `rome facts chain·tokens·contracts·gas·balance·programs` | актуальные факты о цепочке из реестра + RPC — без выдуманных идентификаторов, адресов и селекторов                                         |
| `rome cookbook patterns·cpi-recipe·errors`               | какой пример соответствует вашей цели · правила аккаунтов CPI, в которых агенты ошибаются · расшифровать сбой Rome → причина + исправление |
| `rome call <chain> <addr> <sig> [args]`                  | прочитать контракт (`eth_call`) — аргументы с несколькими значениями передаются в одном аргументе через запятую: `"0xOwner…,0xSpender…"`   |
| `rome doctor <chain>`                                    | предварительная проверка — сеть доступна? RPC достижим? программа настроена? кошелек пополнен?                                             |
| `rome tx <chain> <hash>`                                 | диагностировать транзакцию — квитанция EVM + транзакция(и) урегулирования Solana + ссылка Via (у Rome нет `debug_trace*`)                  |
| `rome preset foundry\|hardhat <chain>`                   | готовая конфигурация сети Rome для вашего стека инструментов + особенности                                                                 |

**Действия — подпись в цепочке.** Только в CLI, ключ из окружения, **никогда** на MCP.

| Команда                                                                    | Что делает                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome deploy <chain> <artifact>`                                           | развернуть скомпилированный контракт, учитывая особенности газа Rome                                                                                                                                                                                                                                                                               |
| `rome send <chain> <addr> <sig>`                                           | записать в контракт через правильный путь записи Rome                                                                                                                                                                                                                                                                                              |
| `rome fund <chain> --from <src> --amount <usdc>`                           | перевести USDC → газ Rome (CCTP) — входной шлюз «из дома»                                                                                                                                                                                                                                                                                          |
| `rome bridge <chain> --from <src> --amount <usdc> [--intent gas\|wrapper]` | мостить USDC **в** как газ или wUSDC                                                                                                                                                                                                                                                                                                               |
| `rome bridge <chain> --to <dest> --amount <usdc>`                          | мостить wUSDC **из** — сжечь на Rome; вы получаете на целевой сети (Rome спонсирует входящий перевод, а не получение исходящего)                                                                                                                                                                                                                   |
| `rome activate <chain>`                                                    | одноразовое пополнение PDA требуется перед **первым исходящим мостом** (входящий перевод без трения — ничего не требует)                                                                                                                                                                                                                           |
| `rome verify <chain> [--path …]`                                           | этот **проверка работоспособности с учетом пути**, по одному для каждого пути входа: `solidity` — один и тот же контракт отвечает на дорожке EVM *и* на дорожке Solana · `solana-program` — вызов на дорожке EVM запускает вашу программу Solana через CPI · `из дома` — мост внутрь → действие в Rome → мост наружу, круговой маршрут подтвержден |

## Подключите к ИИ-агенту (MCP)

Вам не нужно ничего запускать или размещать — ваш MCP-клиент запускает `rome mcp` (сервер stdio) по запросу. Зарегистрируйте его один раз:

```json
{ "mcpServers": { "rome": { "command": "npx", "args": ["-y", "github:rome-protocol/rome-cli", "mcp"] } } }
```

(При установке через clone + link, `{ "command": "rome", "args": ["mcp"] }` тоже работает — форме npx просто не требуется предварительная установка.)

Затем агент вызывает такие инструменты, как `facts_chain`, `cookbook_cpi_recipe`, `doctor`, `tx`и `preset` — опираясь на актуальный реестр + RPC, поэтому он перестает угадывать адреса и селекторы. Интерфейс MCP **только для чтения и не содержит ключей** — его безопасно подключать к любому агенту; он никогда не сможет подписывать или перемещать средства. Действия с подписью остаются в CLI, а ключ передается через окружение.

## Цикл привязки агента к фактам

1. `rome cookbook patterns <что я создаю>` → какой пример репозитория + архитектура
2. `rome facts chain <chain>` → RPC, ID программы, токен газа (без хардкода)
3. …пишите код, опираясь именно на эти значения…
4. `rome verify <chain> --path <ваш путь входа>` → подтвердить, что все работает, каким бы путем вы ни пришли

## Подробнее

* Репозиторий + полные руководства: [`rome-protocol/rome-cli`](https://github.com/rome-protocol/rome-cli)
* [Экосистема и репозитории](/ru/nachalo-raboty/ecosystem.md) · [Создайте приложение с двумя дорожками](/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md) · [Из дома: доберитесь до Rome из другой цепочки](/ru/rukovodstva-dlya-razrabotchikov/from-home.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rome.builders/ru/produkty/rome-cli.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.