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

# Rome CLI + MCP

`روما` يحمل الباني — إنسانًا كان أو وكيل ذكاء اصطناعي — عبر دورة البناء على روما كاملة: حقائق سلسلة مؤصَّلة، النمط الصحيح، استدعاءات العقود، مسار الدخول للتمويل، النشر/الإرسال، التشخيص عبر الآلات الافتراضية المختلفة، وبوابة تحقق تعمل على كلا المسارين. نواة قدرة واحدة، وواجهتان متطابقتان — واجهة CLI (`روما <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 لمرة واحدة أو الاستنساخ + الربط. ثبّت وسمًا (`github:rome-protocol/rome-cli#v0.8.0`) عندما تحتاج إلى تشغيلات قابلة لإعادة الإنتاج.

## طبقتان فوق نواة واحدة

**القراءات — التأصيل + التشخيص.** لا مفاتيح؛ على كلٍ من CLI وخادم MCP.

| الأمر                                                   | ما يعيده                                                                                                     |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `روما حقائق السلسلة·الرموز·العقود·الغاز·الرصيد·البرامج` | حقائق حية عن السلسلة من السجل + RPC — بلا معرّفات أو عناوين أو محددات وهمية                                  |
| `روما كُتيّب الوصفات الأنماط·cpi-recipe·الأخطاء`        | أي مثال يناسب هدفك · قواعد حسابات CPI التي يخطئ فيها الوكلاء · فكّ فشل روما → السبب + الإصلاح                |
| `rome call <chain> <addr> <sig> [args]`                 | قراءة عقد (`eth_call`) — الوسائط متعددة القيم تُمرَّر مفصولة بفواصل ضمن وسيطة واحدة: `"0xOwner…,0xSpender…"` |
| `rome doctor <chain>`                                   | فحص مسبق — هل السلسلة تعمل؟ هل يمكن الوصول إلى RPC؟ هل البرنامج مُهيّأ؟ هل المحفظة ممولة؟                    |
| `rome tx <chain> <hash>`                                | تشخيص معاملة — إيصال EVM + معاملات التسوية على سولانا + رابط Via (روما لا يملك `debug_trace*`)               |
| `rome preset foundry\|hardhat <chain>`                  | إعداد شبكة روما جاهز لسلسلة أدواتك + الخصائص الغريبة                                                         |

**الإجراءات — التوقيع على السلسلة.** على CLI فقط، والمفتاح من البيئة، **أبدًا** على MCP.

| الأمر                                                                      | ما الذي يفعله                                                                                                                                                                                                                                                                      |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome deploy <chain> <artifact>`                                           | نشر عقد مُجمَّع، مع التعامل مع خصائص غاز روما الغريبة                                                                                                                                                                                                                              |
| `rome send <chain> <addr> <sig>`                                           | الكتابة إلى عقد عبر مسار الكتابة الصحيح في روما                                                                                                                                                                                                                                    |
| `rome fund <chain> --from <src> --amount <usdc>`                           | جسر USDC → غاز روما (CCTP) — مسار الدخول "من المنزل"                                                                                                                                                                                                                               |
| `rome bridge <chain> --from <src> --amount <usdc> [--intent gas\|wrapper]` | جسر USDC **إلى الداخل** كغاز أو wUSDC                                                                                                                                                                                                                                              |
| `rome bridge <chain> --to <dest> --amount <usdc>`                          | جسر wUSDC **إلى الخارج** — الحرق على روما؛ وتطالب به على الوجهة (روما يدعم الوارد، لا مطالبة الصادر)                                                                                                                                                                               |
| `rome activate <chain>`                                                    | تمويل PDA لمرة واحدة مطلوب قبل **أول جسر صادر** (الوارد بلا احتكاك — لا يحتاج شيئًا)                                                                                                                                                                                               |
| `rome verify <chain> [--path …]`                                           | الـ **بوابة الأعمال الواعية بالمسار**، واحدة لكل مسار دخول: `solidity` — العقد نفسه يستجيب على مسار EVM *و* مسار سولانا · `solana-program` — استدعاء على مسار EVM يشغّل برنامج سولانا عبر CPI · `من المنزل` — جسر دخول → تنفيذ على روما → جسر خروج، وقد ثبتت الرحلة ذهابًا وإيابًا |

## اربطه بوكيل ذكاء اصطناعي (MCP)

أنت لا تشغّل أو تستضيف أي شيء — عميل MCP لديك يطلق `rome mcp` (خادم stdio) عند الطلب. سجّله مرة واحدة:

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

(مع تثبيت الاستنساخ + الربط، `{ "command": "rome", "args": ["mcp"] }` يعمل أيضًا — صيغة npx لا تحتاج سوى عدم وجود تثبيت مسبق.)

ثم يستدعي الوكيل أدوات مثل `facts_chain`, `cookbook_cpi_recipe`, `doctor`, `tx`، و `preset` — مؤسَّس على السجل الحي + RPC، لذا يتوقف عن تخمين العناوين والمحددات. واجهة MCP هي **للقراءة فقط ولا تحتفظ بأي مفاتيح** — آمنة للربط بأي وكيل؛ إذ لا يمكنها أبدًا التوقيع أو نقل الأموال. وتبقى إجراءات التوقيع على CLI، مع تزويد المفتاح عبر البيئة.

## حلقة تأصيل الوكيل

1. `rome cookbook patterns <what I'm building>` → أي مستودع أمثلة + أي بنية
2. `rome facts chain <chain>` → RPC، معرّف البرنامج، رمز الغاز (من دون ترميز صلب)
3. …اكتب الشفرة اعتمادًا على تلك القيم الدقيقة…
4. `rome verify <chain> --path <your way in>` → أثبت أنه يعمل، أيًّا كان المسار الذي جئت منه

## اعرف المزيد

* المستودع + الأدلة الكاملة: [`rome-protocol/rome-cli`](https://github.com/rome-protocol/rome-cli)
* [النظام البيئي والمستودعات](/ar/albda/ecosystem.md) · [ابنِ تطبيقًا ثنائي المسار](/ar/adlh-almtwryn/dual-lane-app.md) · [من المنزل: الوصول إلى روما من سلسلة أخرى](/ar/adlh-almtwryn/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/ar/almntjat/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.