نشر عقود Solidity

يغطي هذا الدليل نشر عقود Solidity الذكية على Rome EVM باستخدام Hardhat وFoundry.

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

• تم تثبيت Node.js v18+ (Hardhat) أو Foundry

• عنوان Rome EVM ممول (انظر بداية سريعة)

• مفتاحك الخاص مُصدَّرًا كمتغير بيئة

export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"

إعدادات الشبكة

الشبكة	عنوان RPC	معرّف السلسلة
محلي	http://localhost:9090	1001
Devnet (montispl)	https://montispl.devnet.romeprotocol.xyz	200002
Testnet (Martius)	https://martius-i.testnet.romeprotocol.xyz	121214
Testnet (Caelian)	https://caelian-i.testnet.romeprotocol.xyz	121215

Hardhat

الإعداد

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

hardhat.config.js

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

module.exports = {
  solidity: {
    version: "0.8.28",
    settings: {
      optimizer: { enabled: true, runs: 200 },
    },
  },
  networks: {
    rome_local: {
      url: "http://localhost:9090",
      chainId: 1001,
      accounts: [process.env.PRIVATE_KEY],
    },
    rome_devnet: {
      url: "https://montispl.devnet.romeprotocol.xyz",
      chainId: 200002,
      accounts: [process.env.PRIVATE_KEY],
    },
    rome_martius: {
      url: "https://martius-i.testnet.romeprotocol.xyz",
      chainId: 121214,
      accounts: [process.env.PRIVATE_KEY],
    },
    rome_caelian: {
      url: "https://caelian-i.testnet.romeprotocol.xyz",
      chainId: 121215,
      accounts: [process.env.PRIVATE_KEY],
    },
  },
};

النشر

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

التحقق على مستكشف الكتل

npx hardhat verify --network rome_martius 0xCONTRACT_ADDRESS

Foundry

الإعداد

forge init my-rome-project
cd my-rome-project

النشر

# محلي
forge create --rpc-url http://localhost:9090 \
  --private-key $PRIVATE_KEY \
  src/Counter.sol:Counter

# شبكة التطوير
forge create --rpc-url https://montispl.devnet.romeprotocol.xyz \
  --private-key $PRIVATE_KEY \
  src/Counter.sol:Counter

استدعاء العقد المنشور

# قراءة
cast call 0xCONTRACT_ADDRESS "number()" \
  --rpc-url https://montispl.devnet.romeprotocol.xyz

# كتابة
cast send 0xCONTRACT_ADDRESS "increment()" \
  --rpc-url https://montispl.devnet.romeprotocol.xyz \
  --private-key $PRIVATE_KEY

استخدام Rome Solidity SDK

للعقود التي تتفاعل مع برامج Solana، ثبّت Rome Solidity SDK:

npm install @rome-protocol/solidity-sdk

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

import {SplToken, CpiProgram, SystemProgram} from "@rome-protocol/solidity-sdk/contracts/core/Precompiles.sol";
import {SPL_ERC20} from "@rome-protocol/solidity-sdk/contracts/token/ERC20SPL.sol";
import {RomeEVMAccount} from "@rome-protocol/solidity-sdk/contracts/core/RomeEVMAccount.sol";

contract MyRomeContract {
    // قراءة رصيد رمز SPL الخاص بالمستخدم من Solana
    function getSolanaBalance(bytes32 mint) external view returns (uint64) {
        bytes32 userPda = RomeEVMAccount.pda(msg.sender);
        ISplToken.Account memory account = SplToken.account_state(userPda);
        return account.amount;
    }

    // استدعاء أي برنامج Solana عبر CPI
    function callSolanaProgram(
        bytes32 programId,
        ICrossProgramInvocation.AccountMeta[] calldata accounts,
        bytes calldata data
    ) external {
        CpiProgram.invoke(programId, accounts, data);
    }
}

قيود النشر

القيد	الحد	ملاحظات
الحد الأقصى لحجم العقد	480 كيلوبايت	تمت زيادة الحد مقارنةً بحد Ethereum البالغ 24 كيلوبايت في وضع OP-Geth
حد حجم المعاملة	80 كيلوبايت لكل holder	تُقسَّم عمليات النشر الكبيرة عبر حسابات holder بشكل شفاف
ميزانية الحوسبة	حوالي 1.4M CU (ذرّي)	استخدم الوضع التكراري للعقود الثقيلة
إصدار Solidity	0.8.28 موصى به	الإصدارات الأقدم تعمل، لكن 0.8.28 يتوافق مع SDK

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

الخطأ	السبب	الإصلاح
أموال غير كافية للغاز	عنوان EVM لا يحتوي على رصيد	أودِع SOL عبر واجهة الإيداع
nonce منخفض جدًا	nonce قديم في المحفظة	أعد تعيين حساب MetaMask أو حدّد nonce يدويًا
execution reverted	فشلت منطقية العقد	تصحيح الأخطاء باستخدام eth_call أو forge test --fork-url
transaction underpriced	سعر الغاز أقل من الحد الأدنى	ارفع سعر الغاز في المعاملة

ما التالي

• استدعِ Solana من EVM — استخدم CPI precompiles للتفاعل مع برامج Solana

• تغليف الرموز — انشر أغلفة ERC-20 لرموز SPL

• تحسين CU — تقليل استهلاك وحدات الحوسبة