快速开始

在 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. 为你的钱包充值

通过 充值界面。连接你的 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 = "Hello from 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 deployed to:", address);

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

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

  const greeting = await hello.greeting();
  console.log("Greeting:", greeting);
}

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

部署到 Rome devnet：

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

预期输出：

HelloRome deployed to: 0x5FbDB2315678afecb367f032d93F642f64180aa3
Counter: 1
Greeting: Hello from 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 是否正常运行