# Rome Protocol Docs

## 🇺🇸 English

- [Getting Started](https://docs.rome.builders/readme.md): EVM execution on Solana via Cross-Program Invocation.
- [What is Rome?](https://docs.rome.builders/getting-started/what-is-rome.md): Rome is an EVM execution environment inside Solana. Whatever you build is open to EVM users, Solana users, and users on other chains. Four ways to build.
- [Why Rome?](https://docs.rome.builders/getting-started/why-rome.md): How Rome differs from other EVM-on-Solana approaches — atomic CPI composability, single shared state, and sovereign app chains with custom gas tokens.
- [Architecture](https://docs.rome.builders/getting-started/architecture.md): How Rome's components fit together — EVM execution inside a Solana program.
- [Ecosystem & repos](https://docs.rome.builders/getting-started/ecosystem.md): Every public Rome repo, what it is, and how they compose — the map for navigating the surface.
- [Quickstart](https://docs.rome.builders/getting-started/quickstart.md): Deploy your first Solidity contract on Rome in under 5 minutes.
- [Key Concepts](https://docs.rome.builders/getting-started/key-concepts.md): Essential Solana and Rome EVM terminology for developers — programs, accounts, PDAs, CPI, SPL tokens, and atomic vs. iterative execution.
- [Overview](https://docs.rome.builders/networks/networks.md): Public Rome chains — chain IDs, RPC endpoints, explorers, and gas tokens.
- [Hadrian (testnet)](https://docs.rome.builders/networks/hadrian.md): Rome Hadrian — the public testnet chain (chain ID 200010).
- [Rubicon (mainnet)](https://docs.rome.builders/networks/rubicon.md): Rome Rubicon — the public mainnet chain (chain ID 7531). Settles on Solana mainnet, gas is real USDC.
- [Overview](https://docs.rome.builders/apps-on-rome/apps.md): Live applications running on Rome — DeFi, explorers, bridges, and portals.
- [Rome Bridge](https://docs.rome.builders/apps-on-rome/bridge-api.md): Rome Bridge — a standalone bridge and an integrable API, with no custody keys.
- [Oracle Gateway portal](https://docs.rome.builders/apps-on-rome/oracle-gateway.md): The Oracle Gateway portal — register price feeds and configure consumers per chain.
- [Via Explorer](https://docs.rome.builders/apps-on-rome/via.md): Via — the cross-VM block explorer for Rome chains.
- [Bloom — RWA issuance](https://docs.rome.builders/apps-on-rome/bloom.md): Bloom — issue and hold permissioned real-world assets on Rome, reachable from both EVM and Solana wallets.
- [Investing](https://docs.rome.builders/apps-on-rome/bloom/investing.md)
- [Getting funds to Rome](https://docs.rome.builders/apps-on-rome/bloom/funding.md)
- [Issuing](https://docs.rome.builders/apps-on-rome/bloom/issuing.md)
- [Building on Bloom](https://docs.rome.builders/apps-on-rome/bloom/building.md)
- [Evidence — an issuer](https://docs.rome.builders/apps-on-rome/bloom/evidence.md)
- [Evidence — an investor](https://docs.rome.builders/apps-on-rome/bloom/evidence-investor.md)
- [Compliance model](https://docs.rome.builders/apps-on-rome/bloom/compliance.md)
- [The two lanes](https://docs.rome.builders/apps-on-rome/bloom/lanes.md)
- [Privacy DEX](https://docs.rome.builders/apps-on-rome/privacy-dex.md): Private swaps, a USDC vault, and limit orders on Solana devnet.
- [Swaps and the private balance](https://docs.rome.builders/apps-on-rome/privacy-dex/swaps.md): Swap with Rome's market maker and manage your private balance.
- [Vaults](https://docs.rome.builders/apps-on-rome/privacy-dex/vaults.md): Put USDC into a private vault with a rate set and funded by Rome on devnet.
- [Limit orders](https://docs.rome.builders/apps-on-rome/privacy-dex/limit-orders.md): Place private limit orders, understand matching and fees, and cancel unfilled funds.
- [What is private](https://docs.rome.builders/apps-on-rome/privacy-dex/what-is-private.md): What Solana observers, Rome, and Helius can see when you use Privacy DEX.
- [Execution Model](https://docs.rome.builders/core-concepts/execution-model.md): How Rome EVM processes Ethereum transactions on Solana — proxy emulation, atomic (VmAt) vs. iterative (VmIt) modes, and the full transaction lifecycle.
- [Compute Budget](https://docs.rome.builders/core-concepts/compute-budget.md): Solana compute unit (CU) costs for Rome EVM operations — atomic vs. iterative budgets and how to design CU-efficient Solidity contracts.
- [Constraints](https://docs.rome.builders/core-concepts/constraints.md): Limits when building on Rome EVM — Solana transaction size, ~1.4M CU budget, account caps, storage layout, and how Rome works around each.
- [Token Interop](https://docs.rome.builders/core-concepts/token-interop.md): How ERC-20 and SPL tokens are the same underlying account on Rome.
- [How Solana and the EVM meet on Rome](https://docs.rome.builders/core-concepts/how-solana-and-evm-meet.md): How Solana wallets call Solidity contracts, EVM addresses call Solana programs, and Rome handles identity, tokens, fees, and execution limits.
- [Choose your core](https://docs.rome.builders/core-concepts/choose-your-core.md): A dual-lane app can hold its core logic on the Solidity side or the native Solana side. It's a judgment call — weigh what matters for your app.
- [Rome SDK](https://docs.rome.builders/products/rome-sdk.md): Typed Solidity interfaces for calling Solana programs from EVM contracts, plus the Rust SDK behind Rome's off-chain services.
- [Rome CLI + MCP](https://docs.rome.builders/products/rome-cli.md): The Rome developer CLI and MCP server — grounded chain facts, the right build pattern, and the Rome-unique actions (fund, deploy, verify) for a human or an AI agent.
- [App Sovereignty](https://docs.rome.builders/products/app-sovereignty.md): Launch your own sovereign EVM chain on Solana — custom chain ID, any SPL token as gas, and gas revenue that accrues to your app's treasury.
- [Oracle Gateway](https://docs.rome.builders/products/oracle-gateway.md): Pyth and Switchboard price feeds behind Chainlink's AggregatorV3Interface.
- [Overview](https://docs.rome.builders/rome-zk-evm/zk-evm.md): Run an EVM rollup whose transaction data and proved state roots settle on Solana.
- [How it works](https://docs.rome.builders/rome-zk-evm/how-it-works.md): Follow an EVM block through Solana data posting, ZisK proving and final settlement.
- [Run a rollup](https://docs.rome.builders/rome-zk-evm/run-a-rollup.md): Register and run your own Rome ZK EVM chain on Solana devnet with the v0.3.0 rollup runner.
- [Verification key](https://docs.rome.builders/rome-zk-evm/verification-key.md): Build a chain-specific batch guest and request registration of its ZisK verification key.
- [Prover host](https://docs.rome.builders/rome-zk-evm/prover-host.md): Size and prepare the GPU host that proves Rome ZK EVM batches with ZisK 1.3.1-alpha.
- [Deposits and withdrawals](https://docs.rome.builders/rome-zk-evm/deposits-and-withdrawals.md): Move SOL into a Rome ZK EVM chain and withdraw its native coin to a Solana wallet.
- [Trust model](https://docs.rome.builders/rome-zk-evm/trust-model.md): Who can change a Rome ZK EVM chain on devnet and what depositors and withdrawers must trust.
- [Releases](https://docs.rome.builders/rome-zk-evm/releases.md): What v0.3.0 adds and how a chain moves between supported ZisK proof releases.
- [Overview](https://docs.rome.builders/canton-zk-evm/canton-zk-evm.md): Ostia is a Canton zkEVM whose blocks and Canton actions settle in one transaction.
- [How it works](https://docs.rome.builders/canton-zk-evm/how-it-works.md): Follow one Ostia block from reth through proving to its Canton commit.
- [Deposits, withdrawals and payments](https://docs.rome.builders/canton-zk-evm/deposits-withdrawals-payments.md): How the gateway ties EVM deposits, withdrawals and payments to their Canton legs.
- [Run it locally](https://docs.rome.builders/canton-zk-evm/run-it-locally.md): Run the checks, the rehearsal without a GPU and the local Ostia demo on a GPU.
- [Prover host](https://docs.rome.builders/canton-zk-evm/prover-host.md): The prover's host requirements, persistent worker and pinned guest build.
- [Explorer](https://docs.rome.builders/canton-zk-evm/explorer.md): Read Ostia's EVM blocks beside their Canton records and check a proof in the browser.
- [Measurements](https://docs.rome.builders/canton-zk-evm/measurements.md): Recorded proof and settlement measurements with their dates, hardware and limits.
- [Trust model and limits](https://docs.rome.builders/canton-zk-evm/trust-model.md): The checks, authorities, custody assumptions and limits of the Ostia early release.
- [Deploy Solidity Contracts](https://docs.rome.builders/developer-guides/deploy-solidity.md): Deploy Solidity smart contracts on Solana with Hardhat or Foundry — Rome network configuration, funded accounts, and step-by-step deployment.
- [Open your contract to Solana users](https://docs.rome.builders/developer-guides/open-to-solana-users.md): Deploy a Solidity contract on Rome (Hadrian testnet, Rubicon mainnet) and open it to Solana wallets — what the contract needs, how a Solana wallet user calls it, per-network addresses, and a launch ch
- [Verify Contracts](https://docs.rome.builders/developer-guides/verify-contracts.md): Verify Solidity contract source on Rome via the hosted Sourcify service — standard forge verify-contract and hardhat-verify flows, badges on the Via explorer.
- [WebSocket Subscriptions](https://docs.rome.builders/developer-guides/websocket-subscriptions.md): Subscribe to Rome EVM events over WebSocket — eth\_subscribe with newHeads and logs, working out of the box with ethers; with viem, use polling.
- [Call Solana from EVM](https://docs.rome.builders/developer-guides/call-solana-from-evm.md): Call Solana programs from Solidity via Rome's CPI and helper precompiles.
- [Call EVM from Solana](https://docs.rome.builders/developer-guides/call-evm-from-solana.md): Let a Solana wallet drive EVM contracts on Rome — no Ethereum key. The wallet signs, and its transaction goes to Solana.
- [Integrate a Solana program](https://docs.rome.builders/developer-guides/integrate-solana-program.md): Integrate a Solana program with Rome EVM — who the Solana signer is, how value reaches your program and comes back, the one-track rule, atomic vs iterative, and account provisioning.
- [Build a dual-lane app](https://docs.rome.builders/developer-guides/dual-lane-app.md): A step-by-step walkthrough of a dual-lane app — one Solidity contract used by both a MetaMask user and a Solana wallet user, with exactly what happens at each step.
- [From home: reach Rome from another chain](https://docs.rome.builders/developer-guides/from-home.md): Let users on another chain reach your Rome app without leaving home — bring assets in, act, take them back out.
- [JSON-RPC Support](https://docs.rome.builders/reference/json-rpc.md): Ethereum JSON-RPC methods supported by Rome EVM endpoints, plus Rome-specific behaviors — for Foundry, Hardhat, ethers, viem, and MetaMask.
- [Precompile Reference](https://docs.rome.builders/reference/precompiles.md): Every method on Rome's Solana-interop precompiles — address, Solidity signature, selector, and whether it reads, invokes, or stages a CPI.
- [Contract Addresses](https://docs.rome.builders/reference/contract-addresses.md): Precompiles, program IDs, and per-chain deployed contract addresses.
- [Known Limitations](https://docs.rome.builders/security/known-limitations.md): Current Rome EVM constraints and their implications — unsupported opcodes, storage account layout, CU ceilings, CPI depth, and oracle limits.
- [Responsible Disclosure](https://docs.rome.builders/security/responsible-disclosure.md): How to report a security vulnerability in Rome Protocol responsibly — contact channels, what to include, and disclosure guidelines.
- [DeFi Protocols](https://docs.rome.builders/use-cases/defi-protocols.md): Integration patterns for EVM DeFi on Rome — lending with Solana oracles, composing Jupiter and Kamino from Solidity, and shared-liquidity pools.
- [Faucets](https://docs.rome.builders/resources/faucets.md): Test-token faucets for Rome and every chain the bridge supports.
- [FAQ](https://docs.rome.builders/resources/faq.md): Frequently asked questions about Rome Protocol — is Rome a bridge or a rollup, Solidity compatibility, oracles, gas tokens, and Solana interop.
- [Glossary](https://docs.rome.builders/resources/glossary.md): Definitions of Rome and Solana terms used across these docs — ATA, CPI, PDA, VmAt/VmIt, holder accounts, SPL tokens, and more.
- [Community](https://docs.rome.builders/resources/community.md): Where to get help building on Rome Protocol — Discord, Telegram, GitHub, and Rome Academy courses.


---

# 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
This site has an agentic ask interface you may use to query the documentation dynamically 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/index.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.