> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/ar/canton-zk-evm/build-on-ostia.md).

# ابنِ على Ostia

انشر عقد Solidity على Ostia DevNet باستخدام Foundry أو Hardhat، وتحقق منه، واتصل به باستخدام viem أو ethers.

Ostia سلسلة متوافقة مع EVM، لذا تعمل عليها الأدوات التي تستخدمها بالفعل. هناك بعض الاختلافات؛ راجع [الاختلافات عن Ethereum](https://docs.rome.builders/ar/canton-zk-evm/evm-differences.md). توضح هذه الصفحة كيفية نشر عقد والتحقق منه، وكيفية قراءة الأحداث، وأين يمكنك رؤية معاملتك وقد أصبحت نهائية على Canton. تحتاج إلى عنوان يحتوي على بعض tROME. يمنحك [صنبور العملات](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#get-trome) 1 tROME، وتحتوي [شبكة Ostia DevNet](https://docs.rome.builders/ar/canton-zk-evm/devnet.md) على تفاصيل الشبكة.

## النشر باستخدام Foundry

اختُبرت هذه الأوامر باستخدام Foundry 1.8. شغّل `foundryup` (أو `brew upgrade foundry`) أولاً. اعمل ضمن مشروع Foundry (ينشئ`forge init ostia-counter` مشروعاً، يتضمن عقداً من نوع `Counter` )، واحتفظ بالمفتاح المموّل في `PRIVATE_KEY`. `forge init` ينشئ بالفعل جدولاً `[profile.default]` في `foundry.toml`. أضف سطراً واحداً تحته، لكي يستخدم النشر والتحقق الإعدادات نفسها عند الترجمة:

```toml
[profile.default]
# ... اترك الأسطر التي أنشأها forge init كما هي
evm_version = "london"
```

```sh
export RPC=https://ostia.devnet.romeprotocol.xyz/rpc
forge create src/Counter.sol:Counter \
  --rpc-url $RPC --private-key $PRIVATE_KEY --broadcast
```

شُغّلت العناصر التالية على Ostia حتى الآن:

| العنصر                                                                                         | المترجم            | إصدار EVM  |
| ---------------------------------------------------------------------------------------------- | ------------------ | ---------- |
| مجموعة [mixed-load kit](https://github.com/rome-protocol/canton-zk-evm/tree/v0.1.0/load/mixed) | solc 0.8.17        | `london`   |
| Uniswap V2                                                                                     | solc 0.5.16 و0.6.6 | `istanbul` |
| عقود Merces من TACEO                                                                           | solc 0.8.37        | `osaka`    |

شغّلت سلسلة Ostia كل التفرعات حتى Osaka منذ 2026-10-28، لذا تقبل السلسلة الشيفرة المنشأة لأي هدف EVM حتى `osaka`. الأهداف الواردة في الجدول هي التي شُغّلت؛ `london` خيار آمن. لن يعمل أي رمز تشغيل (opcode) أُضيف بعد Osaka.

## التحقق باستخدام Foundry

يدعم المستكشف واجهة Etherscan API، لذا `forge verify-contract` يعمل مع أداة التحقق من Etherscan. ويمكن أن يكون مفتاح API أي نص.

```sh
forge verify-contract <address> src/Counter.sol:Counter \\
  --chain-id 770101 \\
  --verifier etherscan \\
  --verifier-url https://ostia.devnet.romeprotocol.xyz/api \\
  --etherscan-api-key any \\
  --watch
```

يقبل المستكشف 30 عملية تحقق في الساعة من العميل الواحد. إذا تجاوزت هذا الحد، فانتظر ثم أعد إرسال الطلب. يعرض العقد الذي تم التحقق منه مصدره في صفحة العقد على المستكشف.

## التحقق من عقد كبير

قد يُرفض عقد يتضمن ملفات مصدر كثيرة مع استجابة HTTP `413`. إذ لا تستوعب الواجهة الأمامية الوكيلة للمستكشف سوى نحو 300 KB لكل طلب، كما أن forge يرسل مدخلاته بترميز url-encoded، ما يجعلها أكبر من الملفات. `POST /api/verify` يقبل المدخلات نفسها بتنسيق JSON القياسي، وهو أصغر حجمًا. وينطبق حد الوكيل على كل طلب، لذا تُرفض أيضًا أجسام JSON التي يتجاوز حجمها 300 KB. تنفّذ [`verify-large.mjs`](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/scripts/verify-large.mjs) الموجودة في مجموعة الأدوات ذلك. وقد أرسل ملف JSON القياسي لعقود Merces، البالغ حجمه 265 KB، والذي تعذّر على forge إرساله. لاستخدامه، احصل أولًا على JSON القياسي من مشروع Foundry وانسخه إلى مجلد مجموعة الأدوات (`load/mixed` في نسخة مستنسخة من المستودع):

```sh
forge verify-contract <address> <path:Name> --show-standard-json-input > std.json
cp std.json <your clone of canton-zk-evm>/load/mixed/
```

بعد ذلك، ثبّت الحزم في مجلد مجموعة الأدوات باستخدام `npm ci` وشغّل البرنامج النصي. يأخذ عنوان المستكشف من ملف `config.json`في مجموعة الأدوات. (وعند استخدام Docker، `./run.sh node scripts/verify-large.mjs ...` ينفّذ الأمر نفسه.)

```sh
node scripts/verify-large.mjs <address> <path:Name> std.json <compiler> <runs> <evm> <constructor-args|->
```

أدخل إصدار المترجم كسلسلة إصدار كاملة. بالنسبة إلى عقد `Counter` مبني باستخدام solc 0.8.28، مع تفعيل المحسّن عند 200 تشغيل، وإصدار EVM `london` ومن دون وسيطات للمُنشئ:

```sh
node scripts/verify-large.mjs 0xC249f8828EAe40Ad6a77178e4de88049ed5e962f \\
  src/Counter.sol:Counter std.json v0.8.28+commit.7893614a 200 london -
```

يُجري المستكشف عملية التجميع باستخدام الإعدادات الموجودة في std.json، الذي ينشئه forge اعتمادًا على foundry.toml، لذا يجري التحقق من العقد باستخدام إعداد المحسّن الذي بُني به. يرسل البرنامج النصي طلب التحقق، ثم يستعلم عن `GET /api/verify/<guid>` إلى أن تكون الإجابة `Pass` أو `Fail`. وينطبق أيضًا الحد نفسه، وهو 30 عملية في الساعة.

## النشر باستخدام Hardhat

هذه التعليمات مخصّصة لـ Hardhat 2 (يتطلب Hardhat 3 إعداد ESM). تبدأ هذه الخطوات من مجلد فارغ، وقد نُفّذت على Ostia DevNet باستخدام Hardhat 2.29 وNode 22. احتفظ بالمفتاح المموّل في `PRIVATE_KEY`مع بادئة `0x`.

```sh
mkdir ostia-hardhat && cd ostia-hardhat
npm init -y
npm i -D hardhat@2 @nomicfoundation/hardhat-toolbox@hh2
mkdir contracts scripts
```

`npx hardhat init` يطرح الأسئلة في الطرفية وينشئ عقدًا نموذجيًا خاصًا به، لذا أنشئ الملفات الثلاثة يدويًا. أولًا، العقد:

```solidity
// contracts/Counter.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

contract Counter {
    uint256 public number;

    function setNumber(uint256 newNumber) public {
        number = newNumber;
    }

    function increment() public {
        number++;
    }
}
```

الإعدادات. يتطابق `solidity` الإصدار مع توجيه pragma:

```js
// hardhat.config.js
require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: { version: "0.8.17", settings: { evmVersion: "london" } },
  networks: {
    ostia: {
      url: "https://ostia.devnet.romeprotocol.xyz/rpc",
      chainId: 770101,
      accounts: [process.env.PRIVATE_KEY],
      timeout: 120000,
    },
  },
};
```

نص النشر البرمجي:

```js
// scripts/deploy.js
const hre = require("hardhat");

async function main() {
  const counter = await hre.ethers.deployContract("Counter");
  await counter.waitForDeployment();
  console.log("Counter deployed to", await counter.getAddress());
}

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

```sh
npx hardhat run scripts/deploy.js --network ostia
```

يعرض `Counter deployed to 0x...`. أما `timeout` فيُطبَّق على كل طلب. وينتظر النشر أيضًا استلام المعاملة، ولا يصل هذا الاستلام إلا بعد نهائية Canton (انظر أدناه). في اختبار أُجري بتاريخ 2026-10-25، استغرق الأمر من 20 إلى 23 ثانية، وكان معظم الوقت انتظارًا حتى تصبح الكتلة نهائية.

## التحقق باستخدام Hardhat

أضف مستكشف الكتل كسلسلة مخصصة إلى `@nomicfoundation/hardhat-verify`، الذي `hardhat-toolbox` يتضمنه، في الإعدادات أعلاه. يمكن أن يكون مفتاح API أي نص. اختُبر الاستعلام باستخدام Hardhat 2.29.1 وhardhat-verify 2.1.3 على عقد سبق التحقق منه: عثر المكوّن الإضافي على السلسلة المخصصة، واستعلم عن واجهة API الخاصة بمستكشف الكتل، وأجاب «تم التحقق منه مسبقًا». لم يُجرَ إرسال جديد، لذا أخبرنا إن لم يعمل. يعرض المكوّن الإضافي تحذيرًا بشأن إهمال مفاتيح API الخاصة بكل شبكة. هذا التحذير متوقع: أبقِ apiKey الخاص بكل شبكة `apiKey` أدناه، لأن صيغة السلسلة الواحدة لا تعمل على هذه الشبكة («الشبكة المحددة (ostia) غير صحيحة»).

```js
// hardhat.config.js، بجوار solidity وnetworks
etherscan: {
  apiKey: { ostia: "any" },
  customChains: [
    {
      network: "ostia",
      chainId: 770101,
      urls: {
        apiURL: "https://ostia.devnet.romeprotocol.xyz/api",
        browserURL: "https://ostia.devnet.romeprotocol.xyz",
      },
    },
  ],
},
```

```sh
npx hardhat verify --network ostia <address> <constructor arguments>
```

حافظ على إعدادات `solidity` نفسها، بما في ذلك `evmVersion`، كما كانت عند النشر. يُجري المستكشف عملية التجميع باستخدام الإعدادات المقدَّمة إليه. وينطبق الحد نفسه، وهو 30 عملية تحقق في الساعة.

## viem وethers

تعريف سلسلة في viem:

```ts
import { createPublicClient, defineChain, http } from "viem";

export const ostia = defineChain({
  id: 770101,
  name: "Ostia DevNet",
  nativeCurrency: { name: "tROME", symbol: "tROME", decimals: 18 },
  rpcUrls: { default: { http: ["https://ostia.devnet.romeprotocol.xyz/rpc"] } },
  blockExplorers: {
    default: { name: "Ostia explorer", url: "https://ostia.devnet.romeprotocol.xyz" },
  },
});

const client = createPublicClient({ chain: ostia, transport: http() });
```

موفّر ethers:

```js
import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider(
  "https://ostia.devnet.romeprotocol.xyz/rpc",
  { chainId: 770101, name: "ostia-devnet" },
  { polling: true },
);
```

لا يدعم RPC بروتوكول WebSocket ولا عوامل التصفية، لذا يحتاج ethers v6 إلى `{ polling: true }` لمتابعة الأحداث (`contract.on`أو `provider.on` مع عامل تصفية). لا يتوفر الإيصال إلا بعد نهائية الكتلة، لذا خصّص نحو 10 إلى 30 ثانية عند ضبط مهلة الانتظار. أرسل معاملات الحساب الواحد بالترتيب؛ راجع [الاختلافات عن Ethereum](https://docs.rome.builders/ar/canton-zk-evm/evm-differences.md#nonces-and-the-order-of-sends).

في viem، يحتاج `multicall` إلى وجود Multicall3 على السلسلة. يتوفر على Ostia في العنوان المعتاد، لذا أضِفه إلى تعريف السلسلة: `contracts: { multicall3: { address: "0xcA11bde05977b3631167028862bE2a173976CA11" } }` (راجع [الاختلافات عن Ethereum](https://docs.rome.builders/ar/canton-zk-evm/evm-differences.md#the-standard-contracts)).

## الإيصالات والأحداث

يعرض RPC الكتل التي أصبحت نهائية على Canton فقط. بعد إرسال معاملة، `eth_getTransactionReceipt` لا يُرجع شيئًا حتى تصبح الكتلة نهائية، ويستغرق ذلك نحو 10 إلى 30 ثانية. عند ضبط مهلة انتظار الإيصال في أداة، خصّص وقتًا لإثبات المعاملة وتأكيدها على Canton.

لا يتوفر WebSocket ولا `eth_subscribe`، ولا تستخدم `eth_newFilter`. لمتابعة الأحداث، استطلع `eth_getLogs` مع نطاق الكتل منذ آخر عملية استطلاع. يكفي إجراء استطلاع كل بضع ثوانٍ. خلال 24 ساعة حتى 2026-10-25 01:34 UTC، بلغ متوسط الفاصل بين الكتل أثناء انشغال السلسلة 16.6 ثانية، أما السلسلة الهادئة فتُنتج كتلة فارغة كل دقيقة. التزم بـ300 استدعاء في الدقيقة.

## اعرض معاملتك على Canton

1. افتح معاملتك في المستكشف على `/tx/<hash>`.
2. واتبع رابط الكتلة، `/block/<number>`.
3. تعرض صفحة الكتلة تحديث Canton الذي يتضمن سجل الكتلة، والوقت الذي سجّله فيه Canton، وحقائق الإثبات إلى جانب القيم المتوقعة في المستكشف.
4. اضغط على **تحقّق**. يجري متصفحك فحص الإثبات بنفسه، باستخدام الإثبات والرأس والمعاملات التي يوفّرها المستكشف. يكون الزر معطّلًا باللون الرمادي ما دامت الكتلة قيد الإثبات.

تتوفّر البيانات نفسها في واجهة API، مثلًا عبر `GET /api/blocks/<number>` و `GET /api/canton/updates/<update id>`.

## مثال أكبر

ينشر مجلد [`load/mixed`](https://github.com/rome-protocol/canton-zk-evm/tree/v0.1.0/load/mixed) مجموعة من العقود ويولّد حركة مرور متنوعة عبرها: ERC-20 وERC-721 وERC-1155 ورمزًا مصرّحًا به من نوع ERC-3643 وUniswap V2 وعقود TACEO الخاصة بالتحويلات الخاصة Merces (يُتحقَّق من إثباتاتها على السلسلة؛ ولا تتم تسوية أي شيء). ويحتوي [ملف README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/README.md) على الأوامر. كما تتحقق مجموعة الأدوات من كل عقد تنشره على المستكشف. وبالإعدادات المرفقة، تحتاج إلى نحو 12,000 tROME، وهو أكثر بكثير مما يوفّره الصنبور، لذا شغّلها على نسخة Ostia خاصة بك (راجع [شغّل نسخة Ostia خاصة بك](https://docs.rome.builders/ar/canton-zk-evm/run-it-locally.md#load-it-with-a-realistic-mix)). لا يعمل تنزيل المترجم إلا على linux x64. في 2026-10-24، أرسل تشغيل واحد 13,496 معاملة خلال ساعة، وأصبحت جميعها نهائية. وتوضح [النتائج](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/RESULTS-2026-10-24.md) ما تم قياسه وما لم ينجح.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/ar/canton-zk-evm/build-on-ostia.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
