Quickstart

Разверните свой первый контракт Solidity в Rome EVM менее чем за 5 минут.

Требования

• Node.js v18+

• MetaMask расширение для браузера

• Кошелёк Solana с devnet SOL (для газа)

1. Добавьте сеть Rome в MetaMask

Откройте MetaMask → Настройки → Сети → Добавить сеть:

Поле	Значение
Имя сети	Rome Devnet
RPC URL	https://montispl.devnet.romeprotocol.xyz
ID сети	200002
Символ валюты	RSOL
Обозреватель блоков	—

2. Пополните ваш кошелёк

Внесите devnet SOL на ваш адрес Rome EVM через интерфейс пополнения. Подключите ваш кошелёк Solana (с devnet SOL) и MetaMask, затем введите сумму для пополнения. Интерфейс конвертирует SOL в RSOL в соотношении 1:1 и зачислит средства на ваш EVM-адрес.

3. Создайте проект Hardhat

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

При появлении запроса выберите «Create a JavaScript project».

4. Настройте Hardhat для Rome

Отредактируйте 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

• Вызов Solana из EVM — используйте CPI для вызова Jupiter, Kamino и других программ Solana из Solidity

• Архитектура — поймите, как Rome EVM работает под капотом

Распространённые ошибки

Ошибка	Причина	Исправление
недостаточно средств	У EVM-адреса нет баланса	Внесите SOL через интерфейс пополнения
nonce too low	Несоответствие nonce транзакции	Сбросьте аккаунт MetaMask (Настройки → Расширенные → Очистить историю активности)
execution reverted	Выполнение контракта завершилось с ошибкой	Проверьте логику контракта; используйте eth_call для отладки
Тайм-аут соединения	Недоступна RPC-точка входа	Проверьте URL сети; убедитесь, что devnet работает