> 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/almrja/json-rpc.md).

# دعم JSON-RPC

أساليب Ethereum JSON-RPC المدعومة من نقاط نهاية Rome EVM، بالإضافة إلى السلوكيات الخاصة بـ Rome — لـ Foundry وHardhat وethers وviem وMetaMask.

نقاط نهاية Rome EVM تتحدث بصيغة Ethereum JSON-RPC القياسية. تعمل Foundry وHardhat وethers وviem وMetaMask مع Rome بالطريقة نفسها التي تعمل بها على أي سلسلة EVM. تسرد هذه الصفحة ما هو مدعوم وبعض السلوكيات الخاصة بـ Rome التي يجدر معرفتها.

## الأساليب المدعومة

**الأساس (الحالة والتنفيذ):** `eth_chainId`, `eth_blockNumber`, `eth_getBalance`, `eth_getCode`, `eth_getStorageAt`, `eth_getTransactionCount`, `eth_call`, `eth_estimateGas`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_feeHistory`.

**الكتل والمعاملات:** `eth_getBlockByNumber`, `eth_getBlockByHash`, `eth_getBlockReceipts`, `eth_getTransactionByHash`, `eth_getTransactionReceipt`, `eth_sendRawTransaction`، والنسخ المتنوعة حسب فهرس/عدد الكتلة.

**السجلات والمرشحات:** `eth_getLogs`, `eth_newFilter`, `eth_newBlockFilter`, `eth_getFilterChanges`, `eth_getFilterLogs`, `eth_uninstallFilter`.

**اشتراكات WebSocket:** `eth_subscribe` / `eth_unsubscribe` (`newHeads`, `logs`). انظر [اشتراكات WebSocket](https://docs.rome.builders/ar/adlh-almtw-ryn/websocket-subscriptions.md).

**الشبكة / web3:** `net_version`, `net_listening`, `net_peerCount`, `web3_clientVersion`.

**أساليب فحص بسيطة:** `rpc_modules` (يسرد `debug`, `eth`, `net`, `rome`, `rpc`, `txpool`, `web3`), `eth_syncing` (دائمًا `false`), `eth_accounts` (قائمة فارغة دائمًا)، `eth_getUncleCountByBlockNumber`, `eth_getUncleCountByBlockHash`, `eth_getUncleByBlockNumberAndIndex` و `eth_getUncleByBlockHashAndIndex` (لا توجد أعمام، لذا فإن العدّادات هي `0x0` وتُرجِع عمليات البحث `null`), `eth_newPendingTransactionFilter` (مقبول، لكنه لا يُرجع تجزئات أبدًا لأنه لا توجد mempool عامة)، و `txpool_status`، والذي يُرجع دائمًا `{"pending":"0x0","queued":"0x0"}` لأنه لا توجد mempool عامة.

**التتبّع:** `debug_traceRomeTransaction` يأخذ تجزئة معاملة ويُرجع التفصيل لكل استدعاء فرعي ولكل CPI لمعاملة تجمع عدة استدعاءات في دفعة واحدة. تُرجِع المعاملات العادية `null`، وكذلك الحال مع أي تجزئة غير معروفة أو غير مفهرسة بعد.

### غير مدعوم

`debug_traceTransaction` / `trace_*` (تتبّع معاملات بأسلوب Ethereum؛ فهي تُرجِع `-32601`), `eth_getProof`, `eth_createAccessList`, `eth_blobBaseFee` (لا توجد معاملات blob)، و `txpool_*` الأساليب بخلاف `txpool_status` (لا توجد mempool عامة). `newPendingTransactions` تُقبل الاشتراكات لكنها لا تُصدر أي حدث أبدًا.

## أساليب تمديد Rome

إلى جانب Ethereum RPC القياسي، يوفّر الوكيل `rome_*` أساليب:

| الأسلوب                           | الغرض                                                                                                                                                                                            |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `rome_emulateTx`                  | محاكاة معاملة خارج السلسلة (تُرجِع نتيجة تنفيذ Solana)                                                                                                                                           |
| `rome_emulateTxWithPayer`         | المحاكاة مقابل دافع معيّن                                                                                                                                                                        |
| `rome_emulateCallAccounts`        | يحاكي ويُرجِع حسابات Solana التي يلمسها الاستدعاء                                                                                                                                                |
| `rome_emulateRegRollup`           | محاكاة تسجيل rollup                                                                                                                                                                              |
| `rome_getResources`               | الإبلاغ عن حالة مجموعة موارد الوكيل (المدفوعون، الحائزون)                                                                                                                                        |
| `rome_mintId`                     | تحديد SPL mint الكامن وراء غلاف ERC-20                                                                                                                                                           |
| `rome_buildInfo`                  | معلومات بناء الوكيل + معلومات البرنامج على السلسلة                                                                                                                                               |
| `rome_isCompatible`               | التحقق من توافق الوكيل/البرنامج                                                                                                                                                                  |
| `rome_solanaTxForEvmTx`           | الحصول على معاملة/معاملات Solana لتجزئة معاملة EVM                                                                                                                                               |
| `rome_sendUnsignedTransaction`    | إرسال معاملة غير موقعة (مسارات المُرسِل الاصطناعي)                                                                                                                                               |
| `rome_composeUnsignedAtomicV1`    | إنشاء معاملة Solana v1 واحدة لجسم EIP-1559 غير موقّع ومخوّل بتوقيع Ed25519 من محفظة Solana؛ تقوم المحفظة بتوقيعها ويقوم التطبيق ببثّها. يرفض ذلك عندما لا يتسع الاستدعاء داخل معاملة ذرّية واحدة |
| `rome_composeUnsignedIterativeV1` | الشيء نفسه، لكنه يُرجِع كل مرحلة (ذرّية إذا اتسعت، وإلا المراحل التكرارية)؛ توقّع المحفظة كل واحدة وتُرسلها مع `rome_submitSignedV1Plan`                                                         |
| `rome_submitSignedV1Plan`         | بثّ خطة موقّعة (حتى 64 مرحلة)؛ الوكيل مجرد وسيط نقل، وتبقى المحفظة دافعة الرسوم                                                                                                                  |
| `rome_relayUnsignedV1`            | توقيع واحد من المحفظة، ودافع الوكيل يقود المراحل؛ ويدفع المُصطنَع غاز Rome (موّله أولًا باستخدام `rome_composeExternalDepositV1`). تُرجِع تجزئة معاملة EVM                                       |
| `rome_composeExternalDepositV1`   | معاملة واحدة موقّعة من المحفظة تُضيف إلى رصيد الغاز الأصلي للمُصطنَع من رموز المحفظة                                                                                                             |

## السلوكيات الخاصة بـ Rome

### الغاز مشتق من Solana — قدّره، ولا تُثبّته يدويًا

يقيس Rome التنفيذ بوحدات الحوسبة في Solana، وتظهر على أنها غاز EVM. معظم ما تكلفه عملية كتابة هو إنشاء حسابات Solana: مستلِم لم يُستخدم من قبل، حساب رمز جديد، أو عقد منشور. تلك الحسابات جزء من التقدير. النتائج العملية:

* **استخدم `eth_estimateGas`، ولا تُثبّته يدويًا أبدًا `21000`.** الأدوات القياسية (`forge create`, `cast`، Hardhat وethers وviem وMetaMask) تستدعيه بالفعل وتحصل على قيمة صالحة للاستخدام. بالنسبة للاستدعاءات التي تلامس برامج Solana، أضف هامشًا (تضيف SDK الخاص بـ `submitRomeTx` هامشًا 1.3x) واضبط سقفًا للغاز إذا كان التقدير نفسه يفشل. قيمة `21000` ثابتة تفشل كلما أنشأت الكتابة حسابات، مثل تحويل إلى عنوان لم يُستخدم من قبل.
* **يفرض Rome الغاز المستخدم فعليًا.** في القياسات أدناه، لم يكن الغاز المستخدم أبدًا أكثر من التقدير، لذا فإن التقدير الأعلى من العمل المنجز لا يكلفك الفرق.
* **اترك الهامش الذي تضيفه أدواتك.** يمكن أن تتغير الحالة بين التقدير ولحظة وصول المعاملة، كما قد يخرج تقدير الاستدعاء الذي يجري CPIs في Solana منخفضًا. يقوم SDK الخاص بـ `submitRomeTx` بإضافة هامش 1.3x إلى التقدير.

قيس على Hadrian، وكان سعر الغاز حينها نحو 10.4 gwei:

| الكتابة                                          | `eth_estimateGas` | الغاز المستخدم |
| ------------------------------------------------ | ----------------- | -------------- |
| تحويل أصلي إلى عنوان لم يُستخدم من قبل           | 1,086,961         | 1,086,961      |
| تحويل أصلي إلى عنوان موجود                       | 21,000            | 10,001         |
| تحويل wUSDC إلى عنوان لم يُستخدم من قبل          | 2,544,921         | 2,544,921      |
| لفّ الغاز إلى wUSDC (`withdraw_to_ata`)          | 21,000            | 10,001         |
| منح الغلاف (`approve_spl` على Helper precompile) | 21,000            | 10,001         |
| نشر عقد بحجم 10 بايت                             | 1,147,921         | 1,147,921      |

هذه قياسات منفردة على سلسلة واحدة، وليست حدودًا. تعتمد الأرقام على الحسابات التي يجب على الاستدعاء إنشاؤها، لذا قدّر كل كتابة بدلًا من نسخها.

### `forge script --broadcast` يتطلب `--skip-simulation`

`forge script` يستمد حدّ الغاز للبث من **محاكاة** محلية، والتي تقلل التخصيص مقارنةً بنموذج غاز Rome. أضف `--skip-simulation` حتى يستخدم Foundry غاز السلسلة `eth_estimateGas` بدلًا من ذلك:

```bash
forge script script/Deploy.s.sol:Deploy \\
  --rpc-url <RPC> --private-key $PRIVATE_KEY --broadcast --skip-simulation
```

`forge create`, `cast send`وHardhat غير متأثرين — إذ إنهما يقدّران على السلسلة بالفعل.

### `eth_getLogs` محدود بالنطاق (\~12,000 كتلة)

مثل Infura وAlchemy وواجهات RPC الإنتاجية الأخرى، `eth_getLogs` يرفض نطاقات كتل واسعة جدًا (خطأ `-32005`). قيّد استعلاماتك:

```javascript
const latest = await provider.getBlockNumber();
const logs = await contract.queryFilter(filter, latest - 5000, latest);
```

تطبيق `queryFilter` من دون نطاق يمسح كل السجلّ وسيجاوز الحد — مرّر `fromBlock`/`toBlock`. التحقق من الأحداث المعتمد على الإيصالات (مثل انتظار معاملة وقراءة سجلاتها) غير متأثر.

### الرسوم

`eth_gasPrice` يعيد السعر الحقيقي المستمد من oracle؛ وتستخدمه المحافظ (بما فيها MetaMask) وتعرض الرسوم الصحيحة. تُقبل حقول الرسوم المُرسلة بسماحة — كل من المعاملات القديمة وEIP-1559 تصل مع القيم الافتراضية للأدوات القياسية.


---

# 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/almrja/json-rpc.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.
