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

# Rome CLI + MCP

CLI dành cho nhà phát triển Rome và máy chủ MCP — các факт chuỗi được xác thực, mẫu xây dựng phù hợp, và các hành động đặc thù của Rome (nạp vốn, triển khai, xác minh) cho con người hoặc tác nhân AI.

`rome` đồng hành cùng một nhà phát triển — con người hoặc tác nhân AI — xuyên suốt toàn bộ vòng đời xây dựng trên Rome: dữ kiện chuỗi đã được neo, mẫu phù hợp, gọi hợp đồng, lối nạp vốn, triển khai/gửi, chẩn đoán xuyên VM, và một cổng kiểm chứng cho cả hai luồng. Một lõi năng lực, hai bề mặt đồng nhất — một CLI (`rome <command>`) và một [MCP](https://modelcontextprotocol.io) máy chủ (`rome mcp`) — để tác nhân và con người dùng chung một mô hình tư duy.

## Cài đặt

Ưu tiên repo (chưa phát hành npm):

```bash
# chạy một lần, không cần cài đặt:
npx github:rome-protocol/rome-cli#v0.12.0 facts chain hadrian

# cài đặt bền vững — clone + link:
git clone --branch v0.12.0 https://github.com/rome-protocol/rome-cli
cd rome-cli && npm install && npm install -g .
```

Một lệnh đơn thuần `npm install -g github:rome-protocol/rome-cli` không **không phải** hoạt động hôm nay — npm chuẩn bị các phụ thuộc git của gói mà không có node\_modules riêng của chúng ([rome-cli#25](https://github.com/rome-protocol/rome-cli/issues/25)). Hãy dùng npx chạy một lần hoặc clone + link, và ghim một thẻ như trên: npx giữ bản sao nó đã lấy đầu tiên, nên một lệnh npx không ghim `npx github:rome-protocol/rome-cli` có thể tiếp tục chạy một phiên bản cũ, trong khi một thẻ đã ghim luôn lấy đúng phiên bản đó.

## Hai lớp trên cùng một lõi

**Lệnh đọc — neo ngữ cảnh + chẩn đoán.** Không có khóa; trên cả CLI và máy chủ MCP.

| Lệnh                                                     | Nó trả về gì                                                                                                                                  |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome facts chain·tokens·contracts·gas·balance·programs` | dữ kiện chuỗi trực tiếp từ registry + RPC — không bịa ra id, địa chỉ hay selector                                                             |
| `rome cookbook patterns·cpi-recipe·errors`               | ví dụ nào phù hợp với mục tiêu của bạn · các quy tắc tài khoản CPI mà tác nhân thường làm sai · giải mã một lỗi Rome → nguyên nhân + cách sửa |
| `rome call <chain> <addr> <sig> [args]`                  | đọc một hợp đồng (`eth_call`) — đối số nhiều giá trị được ngăn cách bằng dấu phẩy trong một đối số: `"0xOwner…,0xSpender…"`                   |
| `rome doctor <chain>`                                    | kiểm tra trước — chuỗi còn hoạt động? RPC truy cập được? chương trình đã cấu hình? ví có tiền?                                                |
| `rome tx <chain> <hash>`                                 | chẩn đoán một giao dịch — biên nhận EVM + các giao dịch thanh toán Solana + một liên kết Via (Rome không có `debug_traceTransaction`)         |
| `rome preset foundry\|hardhat <chain>`                   | một cấu hình mạng Rome sẵn sàng cho bộ công cụ của bạn + các điểm đặc thù                                                                     |

**Hành động — ký on-chain.** Chỉ trên CLI, khóa lấy từ môi trường, **không bao giờ** trên MCP.

| Lệnh                                                                       | Nó làm gì                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome deploy <chain> <artifact>`                                           | triển khai một hợp đồng đã biên dịch, xử lý các điểm đặc thù về gas của Rome                                                                                                                                                                                                                                                                |
| `rome send <chain> <addr> <sig>`                                           | ghi vào một hợp đồng qua đường ghi Rome đúng cách                                                                                                                                                                                                                                                                                           |
| `rome fund <chain> --from <src> --amount <usdc>`                           | cầu nối USDC → gas Rome (CCTP) — lối nạp vốn "từ home"                                                                                                                                                                                                                                                                                      |
| `rome bridge <chain> --from <src> --amount <usdc> [--intent gas\|wrapper]` | cầu nối USDC **trên** thành gas hoặc wUSDC                                                                                                                                                                                                                                                                                                  |
| `rome bridge <chain> --to <dest> --amount <usdc>`                          | cầu nối wUSDC **ra ngoài** — đốt trên Rome; bạn nhận ở đích đến (Rome tài trợ chiều vào, không phải yêu cầu nhận chiều ra)                                                                                                                                                                                                                  |
| `rome activate <chain>`                                                    | nạp PDA tùy chọn; cầu nối ra không cần nó, vì hợp đồng bridge (RomeBridgeWithdraw v12 trở lên) trả tiền thuê thông điệp và tính vào gas                                                                                                                                                                                                     |
| `rome verify <chain> [--path …]`                                           | một **cổng kiểm chứng nhận biết đường dẫn**, mỗi cách đi vào một cổng: `solidity` — cùng một hợp đồng phản hồi trên làn EVM *và* làn Solana · `solana-program` — một lời gọi trên làn EVM điều khiển chương trình Solana của bạn qua CPI · `từ home` — cầu nối vào → thao tác trên Rome → cầu nối ra, hành trình khứ hồi đã được chứng minh |

## Kết nối nó vào một tác nhân AI (MCP)

Bạn không cần chạy hay tự lưu trữ gì — ứng dụng MCP client của bạn sẽ khởi chạy `rome mcp` (một máy chủ stdio) theo yêu cầu. Đăng ký một lần:

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

(Với cách cài đặt clone + link, `{ "command": "rome", "args": ["mcp"] }` cũng hoạt động — chỉ là dạng npx không cần cài đặt trước.)

Sau đó tác nhân gọi các công cụ như `facts_chain`, `cookbook_cpi_recipe`, `doctor`, `tx`, và `preset` — dựa trên registry trực tiếp + RPC, nên nó ngừng đoán địa chỉ và selector. Bề mặt MCP là **chỉ đọc và không giữ khóa** — an toàn để kết nối vào bất kỳ tác nhân nào; nó không bao giờ có thể ký hay chuyển tiền. Các hành động ký vẫn nằm trên CLI, với khóa được cung cấp qua môi trường.

## Vòng neo ngữ cảnh của tác nhân

1. `rome cookbook patterns <thứ tôi đang xây dựng>` → repo ví dụ nào + kiến trúc
2. `rome facts chain <chuỗi>` → RPC, program id, token gas (không mã hóa cứng)
3. …viết code dựa trên chính xác các giá trị đó…
4. `rome verify <chuỗi> --path <đường vào của bạn>` → chứng minh nó hoạt động, dù bạn đi vào bằng đường nào

## Tìm hiểu thêm

* Repo + hướng dẫn đầy đủ: [`rome-protocol/rome-cli`](https://github.com/rome-protocol/rome-cli)
* [Hệ sinh thái & các repo](https://docs.rome.builders/vi/bat-dau-1/ecosystem.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ừ home: đến Rome từ một chuỗi khác](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/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 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/san-pham/rome-cli.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.
