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

# Rome CLI + MCP

Rome geliştirici CLI'si ve MCP sunucusu — zincire dayalı doğru bilgiler, uygun derleme kalıbı ve bir insan ya da bir yapay zekâ ajanı için Rome'a özgü eylemler (fonlama, dağıtma, doğrulama).

`rome` bir geliştiriciyi — insan ya da yapay zekâ ajanı — Rome üzerinde geliştirme yaşam döngüsünün tamamı boyunca taşır: temellendirilmiş zincir bilgileri, doğru kalıp, sözleşme çağrıları, fonlama giriş rampası, deploy/send, çapraz VM teşhisi ve her iki şerit için çalışan bir geçit. Tek bir yetenek çekirdeği, hizalanmış iki arayüz — bir CLI (`rome <komut>`) ve bir [MCP](https://modelcontextprotocol.io) sunucusu (`rome mcp`) — böylece bir ajan ve bir insan aynı zihinsel modeli paylaşır.

## Kurulum

Önce repo (npm yayını beklemede):

```bash
# tek seferlik, kurulum yok:
npx github:rome-protocol/rome-cli#v0.12.0 facts chain hadrian

# kalıcı kurulum — klonla + bağla:
git clone --branch v0.12.0 https://github.com/rome-protocol/rome-cli
cd rome-cli && npm install && npm install -g .
```

Düz bir `npm install -g github:rome-protocol/rome-cli` şu anda **değil** çalışmaz — npm paketin git bağımlılıklarını kendi node\_modules dizinleri olmadan hazırlar ([rome-cli#25](https://github.com/rome-protocol/rome-cli/issues/25)). npx tek seferlik yöntemi veya klonla + bağla yöntemini kullanın ve yukarıdaki gibi bir etiketi sabitleyin: npx ilk getirdiği kopyayı saklar, bu yüzden sabitlenmemiş bir `npx github:rome-protocol/rome-cli` eski bir sürümü çalıştırmaya devam edebilirken, sabitlenmiş bir etiket her zaman o sürümü getirir.

## Tek bir çekirdek üzerinde iki katman

**Okumalar — temellendirme + teşhis.** Anahtar yok; hem CLI'da hem de MCP sunucusunda.

| Komut                                                    | Ne döndürür                                                                                                                       |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `rome facts chain·tokens·contracts·gas·balance·programs` | kayıt defteri + RPC'den canlı zincir bilgileri — uydurulmuş kimlikler, adresler veya seçiciler yok                                |
| `rome cookbook patterns·cpi-recipe·errors`               | hangi örnek hedefinize uyuyor · ajanların yanlış yaptığı CPI hesap kuralları · bir Rome hatasını çöz → neden + düzeltme           |
| `rome call <chain> <addr> <sig> [args]`                  | bir sözleşmeyi oku (`eth_call`) — birden çok değerli argümanlar tek bir argümanda virgülle ayrılır: `"0xOwner…,0xSpender…"`       |
| `rome doctor <chain>`                                    | ön kontrol — zincir canlı mı? RPC erişilebilir mi? program yapılandırılmış mı? cüzdan fonlandı mı?                                |
| `rome tx <chain> <hash>`                                 | bir işlemi teşhis et — EVM makbuzu + Solana yerleşim işlemi/işlemleri + bir Via bağlantısı (Rome'da yok `debug_traceTransaction`) |
| `rome preset foundry\|hardhat <chain>`                   | araç zinciriniz için hazır bir Rome ağ yapılandırması + tuhaflıklar                                                               |

**Eylemler — zincir üzerinde imzala.** yalnızca CLI, anahtar ortamdan gelir, **asla** MCP'de değil.

| Komut                                                                      | Ne yapar                                                                                                                                                                                                                                                                                                                                              |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome deploy <chain> <artifact>`                                           | Rome'un gas tuhaflıklarını ele alarak derlenmiş bir sözleşmeyi dağıt                                                                                                                                                                                                                                                                                  |
| `rome send <chain> <addr> <sig>`                                           | doğru Rome yazma yolu üzerinden bir sözleşmeye yaz                                                                                                                                                                                                                                                                                                    |
| `rome fund <chain> --from <src> --amount <usdc>`                           | USDC'yi Rome gas'ına köprüle (CCTP) — "evden" giriş rampası                                                                                                                                                                                                                                                                                           |
| `rome bridge <chain> --from <src> --amount <usdc> [--intent gas\|wrapper]` | USDC'yi köprüle **için** gas ya da wUSDC olarak                                                                                                                                                                                                                                                                                                       |
| `rome bridge <chain> --to <dest> --amount <usdc>`                          | wUSDC'yi köprüle **dışarı** — Rome'da yak; hedefte sen talep et (Rome geleni destekler, giden talebi değil)                                                                                                                                                                                                                                           |
| `rome activate <chain>`                                                    | isteğe bağlı PDA fonlaması; dışarı köprüleme buna ihtiyaç duymaz, çünkü köprü sözleşmesi (RomeBridgeWithdraw v12 ve sonrası) mesaj kirasını öder ve bunu gas olarak faturalandırır                                                                                                                                                                    |
| `rome verify <chain> [--path …]`                                           | yol farkındalığı olan **çalışır-geçit**, giriş yolunun her biri için bir tane: `solidity` — aynı sözleşme EVM şeridinde yanıt verir *ve* Solana şeridi · `solana-program` — bir EVM-şeridi çağrısı Solana programınızı CPI aracılığıyla çalıştırır · `kendi zincirinden` — içeri köprüle → Rome'da işlem yap → dışarı köprüle, gidiş-dönüş kanıtlandı |

## Bunu bir yapay zekâ ajanına bağla (MCP)

Sen hiçbir şey çalıştırmaz veya barındırmazsın — MCP istemciniz `rome mcp` (bir stdio sunucusu) talep üzerine başlatır. Bir kez kaydedin:

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

(Klonla + bağla kurulumu ile, `{ "command": "rome", "args": ["mcp"] }` da çalışır — npx biçiminin yalnızca önceden kurulum gerektirmemesi yeterli.)

Ardından ajan şu gibi araçları çağırır: `facts_chain`, `cookbook_cpi_recipe`, `doctor`, `tx`, ve `preset` — canlı kayıt defteri + RPC üzerine temellendirildiği için adresleri ve seçicileri tahmin etmeyi bırakır. MCP yüzeyi **salt okunurdur ve anahtar tutmaz** — herhangi bir ajan içine güvenle bağlanabilir; asla imzalayamaz veya fon taşıyamaz. İmzalama eylemleri CLI'da kalır ve anahtar ortam üzerinden sağlanır.

## Ajanı temellendirme döngüsü

1. `rome cookbook patterns <ne inşa ediyorum>` → hangi örnek repo + mimari
2. `rome facts chain <chain>` → RPC, program kimliği, gas token'ı (hardcode yok)
3. …bu tam değerlerle kod yaz…
4. `rome verify <chain> --path <giriş yolun>` → hangi yoldan geldin fark etmez, çalıştığını kanıtla

## Daha fazla bilgi

* Repo + tam kılavuzlar: [`rome-protocol/rome-cli`](https://github.com/rome-protocol/rome-cli)
* [Ekosistem ve depolar](https://docs.rome.builders/tr/baslarken-1/ecosystem.md) · [Çift hatlı bir uygulama oluşturma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/dual-lane-app.md) · [Evden: başka bir zincirden Rome'a ulaş](https://docs.rome.builders/tr/gelistirici-kilavuzlari/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/tr/urunler/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.
