> 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ı — tüm Rome üzerinde geliştirme yaşam döngüsü boyunca taşır: temellendirilmiş zincir gerçekleri, doğru kalıp, sözleşme çağrıları, fonlama giriş rampası, dağıt/gönder, çapraz VM teşhisi ve her iki hat için de çalışan bir geçiş kapısı. Tek bir yetenek çekirdeği, uyumlu iki yüzey — bir CLI (`rome <command>`) 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 kullanımlık, kurulum yok:
npx github:rome-protocol/rome-cli#v0.11.0 facts chain hadrian

# kalıcı kurulum — klonla + bağla:
git clone --branch v0.11.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` çalışmaz **değil** bugün — npm, paketlerin kendi node\_modules'ları olmadan git bağımlılıklarını hazırlar ([rome-cli#25](https://github.com/rome-protocol/rome-cli/issues/25)). npx tek kullanımlığını ya da klonla + bağla yöntemini kullanın ve yukarıdaki gibi bir etiket sabitleyin: npx, ilk getirdiği kopyayı saklar; bu yüzden sabitlenmemiş bir `npx github:rome-protocol/rome-cli` eski bir sürümü çalışır durumda tutabilir, oysa sabitlenmiş bir etiket her zaman o sürümü getirir.

## Tek bir çekirdeğin üzerinde iki katman

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

| Komut                                                    | Ne döndürür                                                                                                                   |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `rome facts chain·tokens·contracts·gas·balance·programs` | kayıt + 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ış aldığı CPI hesap kuralları · bir Rome hatasını çöz → neden + düzeltme        |
| `rome call <chain> <addr> <sig> [args]`                  | bir sözleşmeyi oku (`eth_call`) — ç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'ye erişilebiliyor mu? program yapılandırılmış mı? cüzdan fonlu mu?                          |
| `rome tx <chain> <hash>`                                 | bir işlemi teşhis et — EVM alındısı + Solana uzlaşma işlemi/işlemleri + bir Via bağlantısı (Rome'da `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.

| 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 → Rome gas (CCTP) köprüsü — "evden" giriş rampası                                                                                                                                                                                                                                                                                              |
| `rome bridge <chain> --from <src> --amount <usdc> [--intent gas\|wrapper]` | USDC'yi köprüle **içinde** gas ya da wUSDC olarak                                                                                                                                                                                                                                                                                                   |
| `rome bridge <chain> --to <dest> --amount <usdc>`                          | wUSDC'yi köprüle **dışarı** — Rome üzerinde yak; talebi hedef zincirde siz yaparsınız (Rome geleni sübvanse eder, giden talebi değil)                                                                                                                                                                                                               |
| `rome activate <chain>`                                                    | önce bir kezlik PDA fonlaması gerekir **ilk dış köprüleme** (gelen taraf sürtünmesizdir — hiçbirine ihtiyaç duymaz)                                                                                                                                                                                                                                 |
| `rome verify <chain> [--path …]`                                           | yola duyarlı **çalışma kapısı**, giriş yolunun her biri için bir tane: `solidity` — aynı sözleşme EVM hattında cevap verir *ve* Solana hattı · `solana-program` — bir EVM hattı çağrısı Solana programınızı CPI üzerinden çalıştırır · `kendi zincirinden` — içeri köprüle → Rome üzerinde eylem yap → dışarı köprüle, gidiş-dönüş kanıtlanmış olur |

## Bir yapay zekâ ajanına bağlayın (MCP)

Hiçbir şeyi çalıştırmaz veya barındırmazsınız — MCP istemciniz isteğe bağlı olarak `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.11.0", "mcp"] } } }
```

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

Ajan daha sonra şu gibi araçları çağırır: `facts_chain`, `cookbook_cpi_recipe`, `doctor`, `tx`ve `preset` — canlı kayıt + RPC üzerine temellendirilmiş, böylece adresleri ve seçicileri tahmin etmeyi bırakır. MCP yüzeyi **yalnızca okunur ve anahtar tutmaz** — herhangi bir ajana güvenle bağlanabilir; asla imza atamaz veya fon taşıyamaz. İmzalama eylemleri CLI'da kalır, anahtar ortam aracılığıyla sağlanır.

## Ajanın 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 belirteci (hardcode yok)
3. …bu tam değerlerle kod yaz…
4. `rome verify <chain> --path <giriş yolunuz>` → nasıl gelirseniz gelin, çalıştığını kanıtla

## Daha fazla öğren

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