rome-solidity

rome-solidity is a Solidity smart contract monorepo for bidirectional EVM ↔ Solana interop primitives within the Rome-EVM program stack, token utilities, and a Meteora DEX AMM implementation, tested via Hardhat.

Key goals

• Solana-compatible token/account behavior in EVM style
• Meteora DAMMv1: automated market maker + factory/pool system
• Cross-program invocation wrappers (CPI) — let Solidity contracts invoke native Solana programs via the precompile at 0xff…08 (plus gas-token wrap/unwrap, withdraw)
• Surface for MetaHook callbacks — Solana programs invoke Rome EVM contracts with a synthetic EVM sender derived from the calling Solana program ID; Solidity contracts can target this surface to be invoked from Solana side
• ERC20 interface to SPL tokens (supports liquidity flow in both directions: Solana liquidity consumed in Solidity, Rome-side liquidity contributed back to Solana protocols)

---

Quick start

Requirements

• Node.js 18+ (recommended)
• npm / yarn
• Hardhat dependencies (installed by npm install below)

Install

npm install

Compile

npx hardhat compile

---

Meteora DAMMv1 integration

This integration can be used as an example of how Rome-EVM can provide interoperability with native Solana smart-contracts.

Preparation

1. Go to https://devnet.meteora.ag/pools#dynamicpools and find Meteora DAMMv1 pool which your would like to use from within Rome-EVM
2. Copy the address of this pool (base58) and convert it into HEX. Later we will refer to this address as POOL_ADDRESS

Deployment

Example scripts:

• deploy_meteora_factory.ts
• deploy_meteora_pool.ts

export <CHAIN>_PRIVATE_KEY=<YOUR_PRIVATE_KEY>
export POOL_ADDRESS=<YOUR_POOL_ADDRESS>
npx hardhat run scripts/deploy_meteora_factory.ts --network <chain>
npx hardhat run scripts/deploy_meteora_pool.ts --network <chain>

After successful deployment, you will see a new file /deployments/<network>.json which contains information about deployed smart contracts. This file is later used by tests.

---

Tests

Set tester private key in dev keystore:

npx hardhat keystore set <CHAIN>_PRIVATE_KEY --dev

Use Hardhat test suite:

npx hardhat test tests/damm_v1_pool.integration.ts --network local

Contract highlights

• MeteoraDAMMv1Factory
  • create pool factory
  • manage pool creation and fee config
• DAMMv1Pool
  • liquidity add/remove (WIP)
  • swap with invariant (WIP)
  • fee model
• ERC20SPLFactory + SPL_ERC20
  • minting/burning wrapped SPL tokens
  • bridging SPL tokens to ERC20 style

---

Project policies

• Solidity currently targeted: 0.8.28
• Prefer non-reentrant checks and SafeMath semantics (built in)
• Maintain artifacts + build-info for deterministic testing
• Cross-program invocations encouraged through clean wrappers in interface.sol

---

Contributing

1. Fork repo
2. branch feature/<name>
3. add/adjust tests
4. npm test
5. PR with explanation + gas/security notes

---

Notes

• artifacts includes compiled JSON from existing snapshot builds.
• deployments/<network>.json carries the deployed contract metadata for each chain (per hardhat.config.ts networks). No live devnet currently — see CLAUDE.md "Networks" section for active hardhat networks.
• Keep toolchain with hardhat.config.ts and tsconfig consistent with existing pattern.

---