快速开始

在 5 分钟内将你的第一个 Solidity 合约部署到 Rome EVM。

前置条件

• Node.js v18+

• MetaMask 浏览器扩展

• 一个带有 devnet SOL 的 Solana 钱包（用于 gas）

1. 将 Rome 网络添加到 MetaMask

打开 MetaMask → 设置 → 网络 → 添加网络：

字段	值
网络名称	Rome Devnet
RPC URL	https://montispl.devnet.romeprotocol.xyz
链 ID	200002
货币符号	RSOL
区块浏览器	—

2. 为你的钱包充值

通过 充值界面向你的 Rome EVM 地址存入 devnet SOL。连接你的 Solana 钱包（带有 devnet SOL）和 MetaMask，然后输入要存入的金额。该界面会将 SOL 按 1:1 转换为 RSOL，并将其记入你的 EVM 地址。

3. 创建 Hardhat 项目

mkdir rome-hello && cd rome-hello
npm init -y
npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
npx hardhat init

提示时选择“创建 JavaScript 项目”。

4. 为 Rome 配置 Hardhat

编辑 hardhat.config.js:

require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: "0.8.28",
  networks: {
    rome_devnet: {
      url: "https://montispl.devnet.romeprotocol.xyz",
      chainId: 200002,
      accounts: [process.env.PRIVATE_KEY],
    },
    rome_local: {
      url: "http://localhost:9090",
      chainId: 1001,
      accounts: [process.env.PRIVATE_KEY],
    },
  },
};

导出你的 MetaMask 私钥：

export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"

5. 编写合约

创建 contracts/HelloRome.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

contract HelloRome {
    string public greeting = "来自 Solana 的问候！";
    uint256 public counter;

    event Greeted(address indexed sender, uint256 count);

    function greet() external returns (string memory) {
        counter++;
        emit Greeted(msg.sender, counter);
        return greeting;
    }

    function setGreeting(string calldata _greeting) external {
        greeting = _greeting;
    }
}

6. 部署

创建 scripts/deploy.js:

const hre = require("hardhat");

async function main() {
  const HelloRome = await hre.ethers.getContractFactory("HelloRome");
  const hello = await HelloRome.deploy();
  await hello.waitForDeployment();

  const address = await hello.getAddress();
  console.log("HelloRome 已部署到:", address);

  // 调用合约
  const tx = await hello.greet();
  await tx.wait();

  const count = await hello.counter();
  console.log("计数器:", count.toString());

  const greeting = await hello.greeting();
  console.log("问候语:", greeting);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

部署到 Rome devnet：

npx hardhat run scripts/deploy.js --network rome_devnet

预期输出：

HelloRome 已部署到: 0x5FbDB2315678afecb367f032d93F642f64180aa3
计数器: 1
问候语: 来自 Solana 的问候！

你的 Solidity 合约现在已在 Solana 上运行。

下一步

• 部署 Solidity — 使用 Foundry 和 Hardhat 的详细部署指南

• 从 EVM 调用 Solana — 使用 CPI 从 Solidity 调用 Jupiter、Kamino 以及其他 Solana 程序

• 架构 — 了解 Rome EVM 的底层工作原理

常见错误

错误	原因	修复
资金不足	EVM 地址没有余额	通过充值界面存入 SOL
nonce 过低	交易 nonce 不匹配	重置 MetaMask 账户（设置 → 高级 → 清除活动记录）
执行被回滚	合约执行失败	检查合约逻辑；使用 eth_call 进行调试
连接超时	RPC 端点不可达	验证网络 URL；检查 devnet 是否正在运行