rome-protocol/cardo

Cardo is a web app that lets people using Ethereum-style wallets like MetaMask interact directly with apps built on Solana, a different blockchain that usually needs its own wallet like Phantom. It is built on Rome Protocol, a system that runs Ethereum-compatible chains inside the Solana network, so the two blockchains can work together without needing to wrap tokens or use a separate bridge. Through Cardo, someone with an Ethereum wallet can swap tokens, stake, lend, trade perpetual futures, or combine several of these actions into one transaction, all settling on real Solana programs such as Meteora, Marinade, Mango, and Jupiter. The app covers more than a dozen different Solana protocols and includes an automated test suite that checks what happens when transactions fail, not just when they succeed. One part of the app, called the orchestrator, lets a user describe what they want to do in plain English, such as swapping one token for another, and an AI model (Anthropic's Claude Haiku) figures out the best route and builds the transaction. This orchestrator talks directly to Solana rather than going through the Rome bridge layer, and the user's wallet signs the final transaction. A fee is only charged if the swap actually completes on chain, so a failed transaction only costs the small standard network fee. The project is a Next.js application written in TypeScript, using RainbowKit and wagmi for the Ethereum wallet connection and the Solana wallet adapter for the orchestrator page. It can be run locally with standard npm commands, and it reads configuration like chain ID and API keys from environment variables so the same build can point at different test networks without being rebuilt. The repository includes detailed internal documentation about how requests flow from an Ethereum transaction into a Solana program call and back, along with a design system for the app's visual interface. It is aimed at developers who want to build or extend cross-chain financial tools connecting Ethereum-style users to Solana's decentralized finance ecosystem.