دليل البدء السريع

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

انشر أول عقد Solidity الخاص بك على Rome في أقل من 5 دقائق. يستهدف هذا الدليل مارتيوس، سلسلة الشبكة التجريبية العامة؛ وتعمل الخطوات نفسها على هادريان (devnet) عبر تبديل قيم الشبكة.

المتطلبات المسبقة

• Node.js v22.13+

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

• محفظة Solana (مثل Phantom) مضبوطة على Devnet

1. أضف Martius إلى MetaMask

أضِفه يدويًا (الإعدادات → الشبكات → إضافة شبكة):

الحقل	القيمة
اسم الشبكة	Rome Martius
عنوان RPC	https://martius.testnet.romeprotocol.xyz/
معرّف السلسلة	121214
رمز العملة	USDC
مستكشف الكتل	https://via-martius.testnet.romeprotocol.xyz/

2. موّل محفظتك

يُدفع الغاز بعملة غاز SPL الخاصة بالسلسلة (USDC على Martius). هناك طريقتان للحصول عليه:

من Solana — احصل على SOL الخاص بـ devnet من صنبور Solana (اضبط محفظة Solana الخاصة بك على Devnet)، ثم افتح تطبيق Rome، وصِل كلتا المحفظتين، ثم لفّها إلى رمز الغاز.

عبر الجسر — قم بسك USDC تجريبي على Ethereum Sepolia من نافورة Circle، ثم انقله إلى Rome باستخدام جسر Rome ‏(CCTP). ستحتاج إلى قليل من ETH على Sepolia لإجراء المعاملة من جهة المصدر — راجع الصنابير لكل نافورة.

كمية كم؟ عمليات نشر العقود على Rome تتضمن تكاليف حسابات من جهة Solana، لذا تكون تقديرات الغاز أعلى بكثير من التصور المعتاد في Ethereum — يقدّر عقد البدء السريع حوالي 20 مليون غاز وتكلفته نحو 0.2 USDC للنشر، وتتحقق المحافظ مسبقًا من نحو ضعف التقدير مقدمًا. موّل بما لا يقل عن 0.5 USDC من الغاز؛ 1 USDC يمنح هامشًا مريحًا.

إذا فشل إيداع من جهة Solana مع تحذير "insufficient SOL" رغم أن المحفظة ممولة، فاضبط محفظة Solana على Testnet Mode / Devnet (انظر الأسئلة الشائعة).

3. أنشئ مشروع Hardhat

mkdir rome-hello && cd rome-hello
npx hardhat --init

اقبل الإعدادات الافتراضية عند الطلب — Hardhat 3، الدليل الحالي، وقالب TypeScript + Node Test Runner + viem — ودعه يثبت الاعتمادات. يأتي القالب بمثال Counter عقد مع اختبارات؛ وهي لا تتداخل مع هذا الدليل.

4. اضبط Hardhat لـ Rome

عدّل الملف المُنشأ hardhat.config.ts وأضف شبكات Rome داخل defineConfig({ ... }):

  networks: {
    martius: {
      type: "http",
      chainType: "l1",
      chainId: 121214,
      url: "https://martius.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },

configVariable("PRIVATE_KEY") يتم حلّه من البيئة، لذا صدّر المفتاح الخاص لـ MetaMask الخاص بك:

export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"

(بالنسبة لأي شيء يتجاوز مفتاحًا للاستخدام المؤقت، يُفضَّل مخزن المفاتيح المشفّر المرفق مع الأدوات: npx hardhat keystore set 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.ts:

import hardhat from "hardhat";

async function main() {
  const { viem } = await hardhat.network.connect();
  const publicClient = await viem.getPublicClient();

  const hello = await viem.deployContract("HelloRome");
  console.log("HelloRome deployed to:", hello.address);

  const hash = await hello.write.greet();
  await publicClient.waitForTransactionReceipt({ hash });

  console.log("Counter:", (await hello.read.counter()).toString());
  console.log("Greeting:", await hello.read.greeting());
}

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

انشر إلى Martius:

npx hardhat run scripts/deploy.ts --network martius

الإخراج المتوقع (سيختلف عنوانك):

HelloRome deployed to: 0x09c437e305eeb698e1776cff23ca16c1bb25aabd
Counter: 1
Greeting: Hello from Solana!

افتح العنوان المنشور في المستكشف لرؤية تعليمات Solana خلف معاملتك. أصبح عقد Solidity الخاص بك يعمل الآن على Solana.

ما التالي

• نشر Solidity — النشر باستخدام Hardhat وFoundry بعمق

• استدعِ Solana من EVM — استدعِ برامج Solana من Solidity عبر CPI

• البنية — كيف ينفذ Rome بيئة EVM داخل Solana

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

الخطأ	السبب	الإصلاح
insufficient funds	رمز غاز غير كافٍ — تتحقق المحافظ مسبقًا من نحو 2× تقدير الغاز	موّل بما لا يقل عن 0.5 USDC من الغاز (انظر الخطوة 2) عبر تطبيق Rome أو الجسر
nonce too low	عدم تطابق nonce للمعاملة	أعد تعيين الحساب (MetaMask → الإعدادات → متقدم → مسح النشاط)
execution reverted	فشل تنفيذ العقد	تحقق من منطق العقد؛ استخدم eth_call لأغراض التصحيح
انتهت مهلة الاتصال	RPC غير قابل للوصول	تحقق من عنوان RPC