Rome CLI + MCP

CLI developer Rome dan server MCP — fakta chain yang terverifikasi, pola build yang tepat, dan aksi khas Rome (fund, deploy, verify) untuk manusia atau agen AI.

rome membawa seorang builder — manusia atau agen AI — sepanjang seluruh siklus hidup build-on-Rome: fakta chain yang ter-grounding, pola yang tepat, pemanggilan kontrak, jalur masuk pendanaan, deploy/send, diagnosis lintas-VM, dan works-gate untuk kedua jalur. Satu inti kapabilitas, dua permukaan yang selaras — sebuah CLI (rome <command>) dan sebuah MCP server (rome mcp) — jadi agen dan manusia berbagi satu model mental.

Instal

Utamakan repo (publikasi npm tertunda):

# sekali jalan, tanpa instal:
npx github:rome-protocol/rome-cli facts chain hadrian

# instalasi permanen — clone + tautkan:
git clone https://github.com/rome-protocol/rome-cli
cd rome-cli && npm install && npm install -g .

Perintah biasa npm install -g github:rome-protocol/rome-cli tidak berfungsi hari ini — npm menyiapkan dependensi git paket tanpa node_modules mereka sendiri (rome-cli#25). Gunakan npx sekali jalan atau clone + tautkan. Sematkan tag (github:rome-protocol/rome-cli#v0.8.0) saat Anda membutuhkan eksekusi yang dapat direproduksi.

Dua lapisan di atas satu inti

Baca — grounding + diagnosis. Tanpa kunci; baik di CLI maupun server MCP.

Perintah	Apa yang dikembalikan
rome facts chain·tokens·contracts·gas·balance·programs	fakta chain langsung dari registry + RPC — tanpa id, alamat, atau selector yang dihalusinasi
rome cookbook patterns·cpi-recipe·errors	contoh mana yang cocok untuk tujuan Anda · aturan akun CPI yang sering salah dipahami agen · uraikan kegagalan Rome → penyebab + perbaikan
rome call <chain> <addr> <sig> [args]	membaca kontrak (eth_call) — argumen multi-nilai dipisahkan koma dalam satu argumen: "0xOwner…,0xSpender…"
rome doctor <chain>	pra-terbang — chain aktif? RPC dapat dijangkau? program dikonfigurasi? dompet terisi dana?
rome tx <chain> <hash>	mendiagnosis tx — receipt EVM + tx penyelesaian Solana + tautan Via (Rome tidak memiliki debug_trace*)
rome preset foundry|hardhat <chain>	konfigurasi jaringan Rome siap pakai untuk toolchain Anda + keunikannya

Aksi — menandatangani on-chain. hanya CLI, kunci dari lingkungan, tidak pernah di MCP.

Perintah	Apa yang dilakukannya
rome deploy <chain> <artifact>	mendeploy kontrak yang telah dikompilasi, menangani keunikan gas Rome
rome send <chain> <addr> <sig>	menulis ke kontrak melalui jalur penulisan Rome yang benar
rome fund <chain> --from <src> --amount <usdc>	bridge USDC → gas Rome (CCTP) — jalur masuk "dari home"
rome bridge <chain> --from <src> --amount <usdc> [--intent gas|wrapper]	bridge USDC masuk sebagai gas atau wUSDC
rome bridge <chain> --to <dest> --amount <usdc>	bridge wUSDC keluar — dibakar di Rome; Anda mengklaim di tujuan (Rome mensponsori inbound, bukan klaim outbound)
rome activate <chain>	pendanaan PDA satu kali diperlukan sebelum bridge keluar pertama (inbound tanpa hambatan — tidak memerlukan apa pun)
rome verify <chain> [--path …]	itu works-gate yang sadar jalur, satu untuk setiap jalur masuk: solidity — kontrak yang sama merespons di jalur EVM dan jalur Solana · solana-program — panggilan di jalur EVM menjalankan program Solana Anda via CPI · dari home — bridge masuk → bertindak di Rome → bridge keluar, perjalanan pulang-pergi terbukti

Hubungkan ke agen AI (MCP)

Anda tidak menjalankan atau meng-host apa pun — klien MCP Anda meluncurkan rome mcp (server stdio) sesuai permintaan. Daftarkan sekali:

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

(Dengan instalasi clone + tautkan, { "command": "rome", "args": ["mcp"] } juga berfungsi — bentuk npx hanya tidak memerlukan instalasi sebelumnya.)

Agen kemudian memanggil alat seperti facts_chain, cookbook_cpi_recipe, doctor, txdan preset — didasarkan pada registry langsung + RPC, jadi ia berhenti menebak alamat dan selector. Permukaan MCP bersifat hanya-baca dan tidak menyimpan kunci — aman dihubungkan ke agen mana pun; ia tidak akan pernah dapat menandatangani atau memindahkan dana. Tindakan penandatanganan tetap di CLI, dengan kunci disediakan melalui environment.

Loop grounding agen

1. rome cookbook patterns <apa yang saya bangun> → repositori contoh + arsitektur mana

2. rome facts chain <chain> → RPC, program id, token gas (tanpa hardcoding)

3. …tulis kode berdasarkan nilai-nilai persis itu…

4. rome verify <chain> --path <your way in> → buktikan bahwa itu berfungsi, lewat jalur mana pun Anda masuk

Pelajari lebih lanjut

• Repo + panduan lengkap: rome-protocol/rome-cli

• Ekosistem & repo · Bangun aplikasi dua jalur · Dari home: jangkau Rome dari chain lain