بداية سريعة

انشر أول عقد Solidity الخاص بك على Rome EVM في أقل من 5 دقائق.

المتطلبات الأساسية

• Node.js v18+

• MetaMask إضافة متصفح

• محفظة Solana تحتوي على devnet SOL (للغاز)

1. أضف شبكة Rome إلى MetaMask

افتح MetaMask → الإعدادات → الشبكات → إضافة شبكة:

الحقل	القيمة
اسم الشبكة	Rome Devnet
عنوان RPC	https://montispl.devnet.romeprotocol.xyz
معرّف السلسلة	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 إلى:", 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
التحية: Hello from Solana!

عقد Solidity الخاص بك يعمل الآن على Solana.

ما التالي

• نشر Solidity — دليل نشر مفصل باستخدام Foundry وHardhat

• استدعِ Solana من EVM — استخدم CPI لاستدعاء Jupiter وKamino وبرامج Solana الأخرى من Solidity

• البنية المعمارية — افهم كيف يعمل Rome EVM من الداخل

الأخطاء الشائعة

الخطأ	السبب	الإصلاح
أموال غير كافية	عنوان EVM لا يحتوي على رصيد	أودِع SOL عبر واجهة الإيداع
nonce منخفض جدًا	عدم تطابق nonce للمعاملة	أعد تعيين حساب MetaMask (الإعدادات → متقدم → مسح النشاط)
execution reverted	فشل تنفيذ العقد	تحقق من منطق العقد؛ استخدم eth_call لأغراض التصحيح
انتهت مهلة الاتصال	نقطة نهاية RPC غير قابلة للوصول	تحقق من عنوان الشبكة؛ وتحقق مما إذا كانت شبكة devnet تعمل