---
title: "JSON-RPC API"
description: "بروتوكول استدعاء الإجراء عن بُعد (RPC) خفيف الوزن وعديم الحالة لعملاء إيثيريوم."
lang: ar
---
لكي يتفاعل تطبيق برمجي مع سلسلة كتل [إيثيريوم](/) - إما عن طريق قراءة بيانات سلسلة الكتل أو إرسال معاملات إلى الشبكة - يجب أن يتصل بعقدة إيثيريوم.
لهذا الغرض، ينفذ كل [عميل إيثيريوم](/developers/docs/nodes-and-clients/#execution-clients) [مواصفات JSON-RPC](https://github.com/ethereum/execution-apis)، بحيث تكون هناك مجموعة موحدة من الطرق التي يمكن للتطبيقات الاعتماد عليها بغض النظر عن العقدة المحددة أو تنفيذ العميل.
[JSON-RPC](https://www.jsonrpc.org/specification) هو بروتوكول استدعاء الإجراء عن بُعد (RPC) خفيف الوزن وعديم الحالة. يحدد العديد من هياكل البيانات والقواعد المتعلقة بمعالجتها. وهو مستقل عن وسيلة النقل، حيث يمكن استخدام المفاهيم داخل نفس العملية، أو عبر مآخذ التوصيل، أو عبر HTTP، أو في العديد من بيئات تمرير الرسائل المختلفة. يستخدم JSON (RFC 4627) كتنسيق للبيانات.
## تنفيذات العميل {#client-implementations}
قد يستخدم كل من عملاء إيثيريوم لغات برمجة مختلفة عند تنفيذ مواصفات JSON-RPC. راجع [وثائق كل عميل](/developers/docs/nodes-and-clients/#execution-clients) لمزيد من التفاصيل المتعلقة بلغات برمجة محددة. نوصي بالتحقق من وثائق كل عميل للحصول على أحدث معلومات دعم API.
## مكتبات التسهيل {#convenience-libraries}
على الرغم من أنه يمكنك اختيار التفاعل مباشرة مع عملاء إيثيريوم عبر JSON-RPC API، إلا أن هناك غالباً خيارات أسهل لمطوري التطبيقات اللامركزية (dapp). توجد العديد من مكتبات [JavaScript](/developers/docs/apis/javascript/#available-libraries) و[API للواجهة الخلفية](/developers/docs/apis/backend/#available-libraries) لتوفير واجهات تغليف أعلى JSON-RPC API. باستخدام هذه المكتبات، يمكن للمطورين كتابة دوال بديهية من سطر واحد بلغة البرمجة التي يختارونها لتهيئة طلبات JSON-RPC (داخلياً) والتي تتفاعل مع إيثيريوم.
## واجهات API لعميل الإجماع {#consensus-clients}
تتناول هذه الصفحة بشكل أساسي واجهة API الخاصة بـ JSON-RPC التي يستخدمها عملاء التنفيذ في إيثيريوم. ومع ذلك، يمتلك عملاء الإجماع أيضًا واجهة RPC API تتيح للمستخدمين الاستعلام عن معلومات حول العقدة، وطلب كتل Beacon، وحالة Beacon، وغيرها من المعلومات المتعلقة بالإجماع مباشرة من العقدة. تم توثيق واجهة API هذه في [صفحة الويب الخاصة بواجهة Beacon API](https://ethereum.github.io/beacon-APIs/#/).
تُستخدم أيضًا واجهة API داخلية للتواصل بين العملاء داخل العقدة - أي أنها تمكن عميل الإجماع وعميل التنفيذ من مبادلة البيانات. يُطلق على هذا اسم 'Engine API' والمواصفات متاحة على [GitHub](https://github.com/ethereum/execution-apis/blob/main/src/engine/common.md).
## مواصفات عميل التنفيذ {#spec}
[اقرأ مواصفات JSON-RPC API الكاملة على GitHub](https://github.com/ethereum/execution-apis). تم توثيق API هذه في [صفحة ويب API التنفيذ](https://ethereum.github.io/execution-apis/) وتتضمن أداة فحص لتجربة جميع الطرق المتاحة.
## الاصطلاحات {#conventions}
### ترميز القيم السداسية العشرية {#hex-encoding}
يتم تمرير نوعين رئيسيين من البيانات عبر JSON: مصفوفات البايت غير المنسقة والكميات. يتم تمرير كلاهما بترميز سداسي عشري ولكن بمتطلبات تنسيق مختلفة.
#### الكميات {#quantities-encoding}
عند ترميز الكميات (الأعداد الصحيحة، الأرقام): يتم ترميزها بالنظام السداسي العشري، وتُسبق بـ "0x"، بأكثر تمثيل مضغوط (استثناء بسيط: يجب تمثيل الصفر كـ "0x0").
إليك بعض الأمثلة:
- 0x41 (65 بالنظام العشري)
- 0x400 (1024 بالنظام العشري)
- خطأ: 0x (يجب أن يحتوي دائمًا على رقم واحد على الأقل - الصفر هو "0x0")
- خطأ: 0x0400 (لا يُسمح بالأصفار البادئة)
- خطأ: ff (يجب أن يُسبق بـ 0x)
### البيانات غير المنسقة {#unformatted-data-encoding}
عند ترميز البيانات غير المنسقة (مصفوفات البايت، عناوين الحسابات، التجزئات، مصفوفات رمز البايت): يتم ترميزها بالنظام السداسي العشري، وتُسبق بـ "0x"، مع رقمين سداسيين عشريين لكل بايت.
إليك بعض الأمثلة:
- 0x41 (الحجم 1، "A")
- 0x004200 (الحجم 3، "0B0")
- 0x (الحجم 0، "")
- خطأ: 0xf0f0f (يجب أن يكون عدد الأرقام زوجيًا)
- خطأ: 004200 (يجب أن يُسبق بـ 0x)
### معلمة الكتلة {#block-parameter}
تحتوي الطرق التالية على معلمة الكتلة:
- [eth_getBalance](#eth-getbalance)
- [eth_getCode](#eth-getcode)
- [eth_getTransactionCount](#eth-gettransactioncount)
- [eth_getStorageAt](#eth-getstorageat)
- [eth_call](#eth-call)
عند إجراء طلبات تستعلم عن حالة إيثيريوم، تحدد معلمة الكتلة المقدمة ارتفاع الكتلة.
الخيارات التالية ممكنة لمعلمة الكتلة:
- `HEX String` - رقم كتلة صحيح
- `String "earliest"` للكتلة الأقدم/كتلة التكوين
- `String "latest"` - لأحدث كتلة مقترحة
- `String "safe"` - لأحدث كتلة رأس آمنة
- `String "finalized"` - لأحدث كتلة نهائية
- `String "pending"` - للحالة/المعاملات المعلقة
## أمثلة {#examples}
نقدم في هذه الصفحة أمثلة على كيفية استخدام نقاط نهاية JSON_RPC API الفردية باستخدام أداة سطر الأوامر، [curl](https://curl.se). توجد أمثلة نقاط النهاية الفردية هذه أدناه في قسم [أمثلة Curl](#curl-examples). وفي أسفل الصفحة، نقدم أيضًا [مثالًا شاملاً](#usage-example) لتصريف ونشر عقد ذكي باستخدام عقدة جو إيثريوم (Geth)، وJSON_RPC API وcurl.
## أمثلة Curl {#curl-examples}
فيما يلي أمثلة على استخدام JSON_RPC API من خلال إجراء طلبات [curl](https://curl.se) إلى عقدة إيثيريوم. يتضمن كل مثال وصفًا لنقطة النهاية المحددة، ومعلماتها، ونوع الإرجاع، ومثالًا عمليًا لكيفية استخدامها.
قد تُرجع طلبات curl رسالة خطأ تتعلق بنوع المحتوى. يرجع ذلك إلى أن خيار `--data` يعين نوع المحتوى إلى `application/x-www-form-urlencoded`. إذا كانت عقدتك تشتكي من ذلك، فقم بتعيين الترويسة يدويًا عن طريق وضع `-H "Content-Type: application/json"` في بداية الاستدعاء. لا تتضمن الأمثلة أيضًا مجموعة عنوان URL/IP والمنفذ والتي يجب أن تكون الوسيطة الأخيرة المعطاة لـ curl (على سبيل المثال، `127.0.0.1:8545`). يأخذ طلب curl الكامل الذي يتضمن هذه البيانات الإضافية الشكل التالي:
```shell
curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545
```
## التناقل، الحالة، والتاريخ {#gossip-state-history}
تتطلب مجموعة من طرق JSON-RPC الأساسية بيانات من شبكة إيثيريوم، وتندرج بدقة تحت ثلاث فئات رئيسية: _التناقل، الحالة، والتاريخ_. استخدم الروابط في هذه الأقسام للانتقال إلى كل طريقة، أو استخدم جدول المحتويات لاستكشاف القائمة الكاملة للطرق.
### طرق التناقل {#gossip-methods}
> تتتبع هذه الطرق رأس السلسلة. هذه هي الطريقة التي تشق بها المعاملات طريقها عبر الشبكة، وتجد طريقها إلى الكتل، وكيف يكتشف العملاء الكتل الجديدة.
- [eth_blockNumber](#eth-blocknumber)
- [eth_sendRawTransaction](#eth-sendrawtransaction)
### طرق الحالة {#state-methods}
> الطرق التي تبلغ عن الحالة الحالية لجميع البيانات المخزنة. تشبه "الحالة" قطعة كبيرة مشتركة من ذاكرة الوصول العشوائي (RAM)، وتتضمن أرصدة الحسابات، وبيانات العقود، وتقديرات الغاز.
- [eth_getBalance](#eth-getbalance)
- [eth_getStorageAt](#eth-getstorageat)
- [eth_getTransactionCount](#eth-gettransactioncount)
- [eth_getCode](#eth-getcode)
- [eth_call](#eth-call)
- [eth_estimateGas](#eth-estimategas)
### طرق التاريخ {#history-methods}
> تجلب السجلات التاريخية لكل كتلة رجوعاً إلى التكوين. يشبه هذا ملفاً كبيراً للإلحاق فقط، ويتضمن جميع رؤوس الكتل، وأجسام الكتل، والكتل العمّة، وإيصالات المعاملات.
- [eth_getBlockTransactionCountByHash](#eth-getblocktransactioncountbyhash)
- [eth_getBlockTransactionCountByNumber](#eth-getblocktransactioncountbynumber)
- [eth_getUncleCountByBlockHash](#eth-getunclecountbyblockhash)
- [eth_getUncleCountByBlockNumber](#eth-getunclecountbyblocknumber)
- [eth_getBlockByHash](#eth-getblockbyhash)
- [eth_getBlockByNumber](#eth-getblockbynumber)
- [eth_getTransactionByHash](#eth-gettransactionbyhash)
- [eth_getTransactionByBlockHashAndIndex](#eth-gettransactionbyblockhashandindex)
- [eth_getTransactionByBlockNumberAndIndex](#eth-gettransactionbyblocknumberandindex)
- [eth_getTransactionReceipt](#eth-gettransactionreceipt)
- [eth_getUncleByBlockHashAndIndex](#eth-getunclebyblockhashandindex)
- [eth_getUncleByBlockNumberAndIndex](#eth-getunclebyblocknumberandindex)
## ساحة تجربة JSON-RPC API {#json-rpc-api-playground}
يمكنك استخدام [أداة ساحة التجربة](https://ethereum-json-rpc.com) لاكتشاف وتجربة طرق API. كما توضح لك الطرق والشبكات التي يدعمها مختلف مزودي العقد.
## طرق JSON-RPC API {#json-rpc-methods}
### web3_clientVersion {#web3-clientversion}
يُرجع إصدار العميل الحالي.
**المعلمات**
لا يوجد
**المرتجعات**
`String` - إصدار العميل الحالي
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// نتيجة
{
"id":67,
"jsonrpc":"2.0",
"result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
}
```
### web3_sha3 {#web3-sha3}
يُرجع Keccak-256 (_وليس_ SHA3-256 القياسي) للبيانات المحددة.
**المعلمات**
1. `DATA` - البيانات المراد تحويلها إلى تجزئة SHA3
```js
params: ["0x68656c6c6f20776f726c64"]
```
**المرتجعات**
`DATA` - نتيجة SHA3 للسلسلة المحددة.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// نتيجة
{
"id":64,
"jsonrpc": "2.0",
"result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
```
### net_version {#net-version}
يعيد معرف الشبكة الحالي.
**المعلمات**
لا يوجد
**المرتجعات**
`String` - معرف الشبكة الحالي.
القائمة الكاملة لمعرفات الشبكة الحالية متاحة على [chainlist.org](https://chainlist.org). بعض المعرفات الشائعة هي:
- `1`: شبكة إيثيريوم الرئيسية
- `11155111`: شبكة اختبار Sepolia
- `560048`: شبكة اختبار Hoodi
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// نتيجة
{
"id":67,
"jsonrpc": "2.0",
"result": "3"
}
```
### net_listening {#net-listening}
يُرجع `true` إذا كان العميل يستمع بنشاط لاتصالات الشبكة.
**المعلمات**
لا يوجد
**المرتجعات**
`Boolean` - `true` عند الاستماع، وإلا `false`.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// نتيجة
{
"id":67,
"jsonrpc":"2.0",
"result":true
}
```
### net_peerCount {#net-peercount}
يُرجع عدد الأقران المتصلين حاليًا بالعميل.
**المعلمات**
لا يوجد
**المرتجعات**
`QUANTITY` - عدد صحيح يمثل عدد الأقران المتصلين.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// نتيجة
{
"id":74,
"jsonrpc": "2.0",
"result": "0x2" // 2
}
```
### eth_protocolVersion {#eth-protocolversion}
يعيد إصدار بروتوكول إيثيريوم الحالي. لاحظ أن هذه الطريقة [غير متوفرة في جو إيثريوم (Geth)](https://github.com/ethereum/go-ethereum/pull/22064#issuecomment-788682924).
**المعلمات**
لا يوجد
**المرتجعات**
`String` - إصدار بروتوكول إيثيريوم الحالي
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// نتيجة
{
"id":67,
"jsonrpc": "2.0",
"result": "54"
}
```
### eth_syncing {#eth-syncing}
يُرجع كائنًا يحتوي على بيانات حول حالة المزامنة أو `false`.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
لا يوجد
**القيم المرجعة**
تختلف بيانات الإرجاع الدقيقة بين تطبيقات العميل. يُرجع جميع العملاء `False` عندما لا تقوم العقدة بالمزامنة، ويُرجع جميع العملاء الحقول التالية.
`Object|Boolean`، كائن يحتوي على بيانات حالة المزامنة أو `FALSE`، عند عدم المزامنة:
- `startingBlock`: `QUANTITY` - الكتلة التي بدأ عندها الاستيراد (سيتم إعادة تعيينها فقط بعد أن تصل المزامنة إلى رأسها)
- `currentBlock`: `QUANTITY` - الكتلة الحالية، تمامًا مثل eth_blockNumber
- `highestBlock`: `QUANTITY` - أعلى كتلة مُقدرة
ومع ذلك، قد يوفر العملاء الفرديون أيضًا بيانات إضافية. على سبيل المثال، يُرجع Geth ما يلي:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"currentBlock": "0x3cf522",
"healedBytecodeBytes": "0x0",
"healedBytecodes": "0x0",
"healedTrienodes": "0x0",
"healingBytecode": "0x0",
"healingTrienodes": "0x0",
"highestBlock": "0x3e0e41",
"startingBlock": "0x3cbed5",
"syncedAccountBytes": "0x0",
"syncedAccounts": "0x0",
"syncedBytecodeBytes": "0x0",
"syncedBytecodes": "0x0",
"syncedStorage": "0x0",
"syncedStorageBytes": "0x0"
}
}
```
بينما يُرجع بيسو (Besu):
```json
{
"jsonrpc": "2.0",
"id": 51,
"result": {
"startingBlock": "0x0",
"currentBlock": "0x1518",
"highestBlock": "0x9567a3",
"pulledStates": "0x203ca",
"knownStates": "0x200636"
}
}
```
راجع الوثائق الخاصة بعميلك لمزيد من التفاصيل.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": {
startingBlock: '0x384',
currentBlock: '0x386',
highestBlock: '0x454'
}
}
// أو عند عدم المزامنة
{
"id":1,
"jsonrpc": "2.0",
"result": false
}
```
### eth_coinbase {#eth-coinbase}
يُرجع عنوان كوين بيس الخاص بالعميل.
جرب نقطة النهاية في بيئة اللعب
> **ملاحظة:** تم إيقاف هذه الطريقة اعتبارًا من **v1.14.0** ولم تعد مدعومة. ستؤدي محاولة استخدام هذه الطريقة إلى ظهور خطأ "Method not supported".
**المعلمات**
لا يوجد
**المرتجعات**
`DATA`، 20 بايت - عنوان كوين بيس الحالي.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// نتيجة
{
"id":64,
"jsonrpc": "2.0",
"result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```
### eth_chainId {#eth-chainid}
يُرجع معرف السلسلة المستخدم في توقيع المعاملات المحمية من إعادة الإرسال.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
لا يوجد
**القيم المرجعة**
`chainId`، قيمة سداسية عشرية في شكل سلسلة نصية تمثل العدد الصحيح لمعرف السلسلة الحالي.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
// نتيجة
{
"id":67,
"jsonrpc": "2.0",
"result": "0x1"
}
```
### eth_mining {#eth-mining}
يُرجع `true` إذا كان العميل يقوم بتعدين كتل جديدة بنشاط. يمكن أن يُرجع هذا `true` فقط لشبكات إثبات العمل (PoW) وقد لا يكون متاحًا في بعض العملاء منذ [الدمج](/roadmap/merge/).
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
لا يوجد
**المرتجعات**
`Boolean` - يُرجع `true` إذا كان العميل يقوم بالتعدين، وإلا `false`.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
//
{
"id":71,
"jsonrpc": "2.0",
"result": true
}
```
### eth_hashrate {#eth-hashrate}
يُرجع عدد التجزئات في الثانية التي تقوم العقدة بالتعدين بها. يمكن أن يُرجع هذا فقط `true` لشبكات إثبات العمل (PoW) وقد لا يكون متاحًا في بعض العملاء منذ [الدمج](/roadmap/merge/).
تجربة نقطة النهاية في بيئة اللعب
**المعلمات**
لا يوجد
**القيم المرجعة**
`QUANTITY` - عدد التجزئات في الثانية.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// نتيجة
{
"id":71,
"jsonrpc": "2.0",
"result": "0x38a"
}
```
### eth_gasPrice {#eth-gasprice}
يعيد تقديراً للسعر الحالي لكل غاز بوحدة Wei. على سبيل المثال، يفحص عميل بيسو آخر 100 كتلة ويعيد وسيط سعر وحدة الغاز افتراضيًا.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
لا يوجد
**المرتجعات**
`QUANTITY` - عدد صحيح يمثل سعر الغاز الحالي بوحدة Wei.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// نتيجة
{
"id":73,
"jsonrpc": "2.0",
"result": "0x1dfd14000" // 8049999872 Wei
}
```
### eth_accounts {#eth-accounts}
يعيد قائمة بالعناوين المملوكة للعميل.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
لا يوجد
**القيم المعادة**
`Array of DATA`، 20 Bytes - العناوين المملوكة للعميل.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}
```
### eth_blockNumber {#eth-blocknumber}
يُرجع رقم أحدث كتلة.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
لا يوجد
**المرتجعات**
`QUANTITY` - عدد صحيح لرقم الكتلة الحالية التي يوجد عليها العميل.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// نتيجة
{
"id":83,
"jsonrpc": "2.0",
"result": "0x4b7" // 1207
}
```
### eth_getBalance {#eth-getbalance}
يعيد رصيد الحساب في عنوان معين.
جرب نقطة النهاية في بيئة اللعب
**المعلمات**
1. `DATA`، 20 Bytes - العنوان المراد التحقق من رصيده.
2. `QUANTITY|TAG` - رقم كتلة صحيح، أو السلسلة `"latest"`، أو `"earliest"`، أو `"pending"`، أو `"safe"`، أو `"finalized"`، راجع [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter)
```js
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]
```
**القيم المعادة**
`QUANTITY` - عدد صحيح يمثل الرصيد الحالي بوحدة Wei.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x0234c8a3397aab58" // 158972490234375000
}
```
### eth_getStorageAt {#eth-getstorageat}
يُرجع القيمة من موضع تخزين في عنوان محدد.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
1. `DATA`، 20 Bytes - عنوان التخزين.
2. `QUANTITY` - عدد صحيح لموضع التخزين.
3. `QUANTITY|TAG` - عدد صحيح لرقم الكتلة، أو السلسلة `"latest"`، أو `"earliest"`، أو `"pending"`، أو `"safe"`، أو `"finalized"`، راجع [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter)
**القيم المرجعة**
`DATA` - القيمة في موضع التخزين هذا.
**مثال**
يعتمد حساب الموضع الصحيح على التخزين المراد استرداده. ضع في اعتبارك العقد التالي المنشور في `0x295a70b2de5e3953354a6a8344e616ed314d7251` بواسطة العنوان `0x391694e7e0b0cce554cb130d723a9d27458f9298`.
```
contract Storage {
uint pos0;
mapping(address => uint) pos1;
constructor() {
pos0 = 1234;
pos1[msg.sender] = 5678;
}
}
```
استرداد قيمة pos0 أمر مباشر:
```js
curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}
```
استرداد عنصر من الخريطة أصعب. يتم حساب موضع عنصر في الخريطة باستخدام:
```js
keccak(LeftPad32(key, 0), LeftPad32(map position, 0))
```
هذا يعني أنه لاسترداد التخزين في pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] نحتاج إلى حساب الموضع باستخدام:
```js
keccak(
decodeHex(
"000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
"0000000000000000000000000000000000000000000000000000000000000001"
)
)
```
يمكن استخدام وحدة تحكم جو إيثريوم (geth) التي تأتي مع مكتبة Web3 لإجراء الحساب:
```js
> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"
undefined
> web3.sha3(key, {"encoding": "hex"})
"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"
```
الآن لجلب التخزين:
```js
curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}
```
### eth_getTransactionCount {#eth-gettransactioncount}
يعيد عدد المعاملات _المرسلة_ من عنوان.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
1. `DATA`، 20 Bytes - عنوان.
2. `QUANTITY|TAG` - رقم كتلة صحيح، أو السلسلة `"latest"`، أو `"earliest"`، أو `"pending"`، أو `"safe"` أو `"finalized"`، راجع [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter)
```js
params: [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1",
"latest", // حالة عند أحدث كتلة
]
```
**القيم المعادة**
`QUANTITY` - عدد صحيح يمثل عدد المعاملات المرسلة من هذا العنوان.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x1" // 1
}
```
### eth_getBlockTransactionCountByHash {#eth-getblocktransactioncountbyhash}
يُرجع عدد المعاملات في كتلة من كتلة تطابق تجزئة الكتلة المحددة.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
1. `DATA`، 32 Bytes - تجزئة كتلة
```js
params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]
```
**المرتجعات**
`QUANTITY` - عدد صحيح يمثل عدد المعاملات في هذه الكتلة.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x8b" // 139
}
```
### eth_getBlockTransactionCountByNumber {#eth-getblocktransactioncountbynumber}
يُرجع عدد المعاملات في كتلة تطابق رقم الكتلة المحدد.
جرب نقطة النهاية في بيئة اللعب
**المعلمات**
1. `QUANTITY|TAG` - عدد صحيح لرقم كتلة، أو السلسلة النصية `"earliest"`، أو `"latest"`، أو `"pending"`، أو `"safe"`، أو `"finalized"`، كما هو الحال في [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter).
```js
params: [
"0x13738ca", // 20396234
]
```
**القيم المرجعة**
`QUANTITY` - عدد صحيح يمثل عدد المعاملات في هذه الكتلة.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x8b" // 139
}
```
### eth_getUncleCountByBlockHash {#eth-getunclecountbyblockhash}
يُرجع عدد الأعمام في كتلة من كتلة تطابق تجزئة الكتلة المحددة.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
1. `DATA`، 32 Bytes - تجزئة كتلة
```js
params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]
```
**المرتجعات**
`QUANTITY` - عدد صحيح يمثل عدد الأعمام في هذه الكتلة.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x1" // 1
}
```
### eth_getUncleCountByBlockNumber {#eth-getunclecountbyblocknumber}
يُرجع عدد الأعمام في كتلة من كتلة تطابق رقم الكتلة المحدد.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
1. `QUANTITY|TAG` - عدد صحيح لرقم كتلة، أو السلسلة `"latest"`، أو `"earliest"`، أو `"pending"`، أو `"safe"`، أو `"finalized"`، راجع [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter)
```js
params: [
"0xe8", // 232
]
```
**المرتجعات**
`QUANTITY` - عدد صحيح لعدد الأعمام في هذه الكتلة.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x0" // 0
}
```
### eth_getCode {#eth-getcode}
يعيد الرمز الموجود في عنوان معين.
جرب نقطة النهاية في بيئة اللعب
**المعلمات**
1. `DATA`، 20 Bytes - العنوان
2. `QUANTITY|TAG` - رقم كتلة صحيح، أو السلسلة النصية `"latest"`، أو `"earliest"`، أو `"pending"`، أو `"safe"` أو `"finalized"`، راجع [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter)
```js
params: [
"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"0x5daf3b", // 6139707
]
```
**المرتجعات**
`DATA` - الرمز من العنوان المحدد.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
}
```
### eth_sign {#eth-sign}
تحسب طريقة sign توقيعًا خاصًا بشبكة إيثيريوم باستخدام: `sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)))`.
تؤدي إضافة بادئة إلى الرسالة إلى جعل التوقيع المحسوب مميزًا كتوقيع خاص بشبكة إيثيريوم. يمنع هذا سوء الاستخدام حيث يمكن لتطبيق لامركزي (dapp) ضار توقيع بيانات عشوائية (مثل معاملة) واستخدام التوقيع لانتحال شخصية الضحية.
ملاحظة: يجب أن يكون العنوان المراد التوقيع به غير مقفل.
**المعلمات**
1. `DATA`، 20 Bytes - العنوان
2. `DATA`، N Bytes - الرسالة المراد توقيعها
**المرتجعات**
`DATA`: التوقيع
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}
```
### eth_signTransaction {#eth-signtransaction}
يوقع معاملة يمكن إرسالها إلى الشبكة في وقت لاحق باستخدام [eth_sendRawTransaction](#eth-sendrawtransaction).
**المعلمات**
1. `Object` - كائن المعاملة
- `type`:
- `from`: `DATA`، 20 Bytes - العنوان الذي تُرسل منه المعاملة.
- `to`: `DATA`، 20 Bytes - (اختياري عند إنشاء عقد جديد) العنوان الذي تُوجه إليه المعاملة.
- `gas`: `QUANTITY` - (اختياري، الافتراضي: 90000) عدد صحيح للغاز المقدم لتنفيذ المعاملة. سيعيد الغاز غير المستخدم.
- `gasPrice`: `QUANTITY` - (اختياري، الافتراضي: To-Be-Determined) عدد صحيح لسعر الغاز المستخدم لكل غاز مدفوع، بوحدة Wei.
- `value`: `QUANTITY` - (اختياري) عدد صحيح للقيمة المرسلة مع هذه المعاملة، بوحدة Wei.
- `data`: `DATA` - الرمز المصرّف لعقد أو تجزئة توقيع الطريقة المستدعاة والمعلمات المشفرة.
- `nonce`: `QUANTITY` - (اختياري) عدد صحيح لرقم فريد. يسمح هذا بالكتابة فوق معاملاتك المعلقة التي تستخدم نفس الرقم الفريد.
**المرتجعات**
`DATA`، كائن المعاملة المشفر بـ RLP والموقع من قبل الحساب المحدد.
**مثال**
```js
// طلب
curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
// نتيجة
{
"id": 1,
"jsonrpc": "2.0",
"result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}
```
### eth_sendTransaction {#eth-sendtransaction}
ينشئ معاملة استدعاء رسالة جديدة أو إنشاء عقد، إذا كان حقل البيانات يحتوي على رمز، ويوقعها باستخدام الحساب المحدد في `from`.
**المعلمات**
1. `Object` - كائن المعاملة
- `from`: `DATA`، 20 Bytes - العنوان الذي تُرسل منه المعاملة.
- `to`: `DATA`، 20 Bytes - (اختياري عند إنشاء عقد جديد) العنوان الذي تُوجه إليه المعاملة.
- `gas`: `QUANTITY` - (اختياري، الافتراضي: 90000) عدد صحيح للغاز المقدم لتنفيذ المعاملة. سيعيد الغاز غير المستخدم.
- `gasPrice`: `QUANTITY` - (اختياري، الافتراضي: يُحدد لاحقًا) عدد صحيح يمثل سعر الغاز (gasPrice) المستخدم لكل غاز مدفوع.
- `value`: `QUANTITY` - (اختياري) عدد صحيح للقيمة المرسلة مع هذه المعاملة.
- `input`: `DATA` - الرمز المُصرف لعقد أو تجزئة توقيع الطريقة المستدعاة والمعلمات المشفرة.
- `nonce`: `QUANTITY` - (اختياري) عدد صحيح يمثل رقمًا فريدًا (nonce). يتيح لك هذا الكتابة فوق معاملاتك المعلقة التي تستخدم نفس الرقم الفريد.
```js
params: [
{
from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
gas: "0x76c0", // 30400
gasPrice: "0x9184e72a000", // 10000000000000
value: "0x9184e72a", // 2441406250
input:
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
},
]
```
**القيم المعادة**
`DATA`، 32 Bytes - تجزئة المعاملة، أو التجزئة الصفرية إذا لم تكن المعاملة متاحة بعد.
استخدم [eth_getTransactionReceipt](#eth-gettransactionreceipt) للحصول على عنوان العقد، بعد اقتراح المعاملة في كتلة، عند إنشائك لعقد.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
```
### eth_sendRawTransaction {#eth-sendrawtransaction}
ينشئ معاملة استدعاء رسالة جديدة أو إنشاء عقد للمعاملات الموقعة.
**المعلمات**
1. `DATA`، بيانات المعاملة الموقعة.
```js
params: [
"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
]
```
**القيم المرجعة**
`DATA`، 32 Bytes - تجزئة المعاملة، أو التجزئة الصفرية إذا لم تكن المعاملة متاحة بعد.
استخدم [eth_getTransactionReceipt](#eth-gettransactionreceipt) للحصول على عنوان العقد، بعد اقتراح المعاملة في كتلة، عندما قمت بإنشاء عقد.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
```
### eth_call {#eth-call}
ينفذ استدعاء رسالة جديدًا على الفور دون إنشاء معاملة على سلسلة الكتل. يُستخدم غالبًا لتنفيذ وظائف العقد الذكي للقراءة فقط، على سبيل المثال `balanceOf` لعقد ERC-20.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
1. `Object` - كائن استدعاء المعاملة
- `from`: `DATA`، 20 بايت - (اختياري) العنوان الذي تُرسل منه المعاملة.
- `to`: `DATA`، 20 بايت - العنوان الذي تُوجه إليه المعاملة.
- `gas`: `QUANTITY` - (اختياري) عدد صحيح للغاز المقدم لتنفيذ المعاملة. يستهلك eth_call صفر غاز، ولكن قد تكون هذه المعلمة مطلوبة لبعض عمليات التنفيذ.
- `gasPrice`: `QUANTITY` - (اختياري) عدد صحيح لـ gasPrice المستخدم لكل غاز مدفوع
- `value`: `QUANTITY` - (اختياري) عدد صحيح للقيمة المرسلة مع هذه المعاملة
- `input`: `DATA` - (اختياري) تجزئة توقيع الطريقة والمعلمات المشفرة. للحصول على التفاصيل، راجع [ABI لعقد إيثيريوم في وثائق Solidity](https://docs.soliditylang.org/en/latest/abi-spec.html).
2. `QUANTITY|TAG` - رقم كتلة صحيح، أو السلسلة `"latest"`، أو `"earliest"`، أو `"pending"`، أو `"safe"` أو `"finalized"`، راجع [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter)
**القيم المرجعة**
`DATA` - القيمة المرجعة للعقد المنفذ.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x"
}
```
### eth_estimateGas {#eth-estimategas}
يُنشئ ويُرجع تقديرًا لمقدار الغاز اللازم للسماح للمعاملة بالاكتمال. لن تتم إضافة المعاملة إلى سلسلة الكتل. لاحظ أن التقدير قد يكون أكثر بكثير من كمية الغاز التي تستخدمها المعاملة فعليًا، لمجموعة متنوعة من الأسباب بما في ذلك آليات EVM وأداء العقدة.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
راجع معلمات [eth_call](#eth-call)، باستثناء أن جميع الخصائص اختيارية. إذا لم يتم تحديد حد الغاز، يستخدم جو إيثريوم (geth) حد الغاز للكتلة من الكتلة المعلقة كحد أقصى. ونتيجة لذلك، قد لا يكون التقدير المُرجع كافيًا لتنفيذ الاستدعاء/المعاملة عندما تكون كمية الغاز أعلى من حد الغاز للكتلة المعلقة.
**القيم المرجعة**
`QUANTITY` - كمية الغاز المستخدمة.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x5208" // 21000
}
```
### eth_getBlockByHash {#eth-getblockbyhash}
يعيد معلومات حول كتلة بناءً على التجزئة.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
1. `DATA`، 32 Bytes - تجزئة الكتلة.
2. `Boolean` - إذا كان `true` فإنه يعيد كائنات المعاملة الكاملة، وإذا كان `false` فإنه يعيد تجزئات المعاملات فقط.
```js
params: [
"0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
false,
]
```
**القيم المعادة**
`Object` - كائن كتلة، أو `null` عندما لا يتم العثور على كتلة:
- `number`: `QUANTITY` - رقم الكتلة. `null` عندما تكون كتلة معلقة.
- `hash`: `DATA`، 32 Bytes - تجزئة الكتلة. `null` عندما تكون كتلة معلقة.
- `parentHash`: `DATA`، 32 Bytes - تجزئة الكتلة الأصلية.
- `nonce`: `DATA`، 8 Bytes - تجزئة إثبات العمل (PoW) المُنشأ. `null` عندما تكون كتلة معلقة، `0x0` لكتل إثبات الحصة (PoS) (منذ الدمج)
- `sha3Uncles`: `DATA`، 32 Bytes - تجزئة SHA3 لبيانات الكتل الشقيقة (uncles) في الكتلة.
- `logsBloom`: `DATA`، 256 Bytes - مرشح بلوم (bloom filter) لسجلات الكتلة. `null` عندما تكون كتلة معلقة.
- `transactionsRoot`: `DATA`، 32 Bytes - جذر شجرة المعاملات للكتلة.
- `stateRoot`: `DATA`، 32 Bytes - جذر شجرة الحالة النهائية للكتلة.
- `receiptsRoot`: `DATA`، 32 Bytes - جذر شجرة الإيصالات للكتلة.
- `miner`: `DATA`، 20 Bytes - عنوان المستفيد الذي مُنحت له مكافآت الكتلة.
- `difficulty`: `QUANTITY` - عدد صحيح يمثل صعوبة هذه الكتلة.
- `totalDifficulty`: `QUANTITY` - عدد صحيح يمثل الصعوبة الإجمالية للسلسلة حتى هذه الكتلة.
- `extraData`: `DATA` - حقل "البيانات الإضافية" لهذه الكتلة.
- `size`: `QUANTITY` - عدد صحيح يمثل حجم هذه الكتلة بالبايت.
- `gasLimit`: `QUANTITY` - الحد الأقصى للغاز المسموح به في هذه الكتلة.
- `gasUsed`: `QUANTITY` - إجمالي الغاز المستخدم بواسطة جميع المعاملات في هذه الكتلة.
- `timestamp`: `QUANTITY` - الطابع الزمني لنظام Unix لوقت تجميع الكتلة.
- `transactions`: `Array` - مصفوفة من كائنات المعاملات، أو تجزئات معاملات بحجم 32 Bytes اعتمادًا على المعلمة الأخيرة المعطاة.
- `uncles`: `Array` - مصفوفة من تجزئات الكتل الشقيقة (uncles).
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
// نتيجة
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"difficulty": "0x4ea3f27bc",
"extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
"gasLimit": "0x1388",
"gasUsed": "0x0",
"hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
"mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
"nonce": "0x689056015818adbe",
"number": "0x1b4",
"parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x220",
"stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
"timestamp": "0x55ba467c",
"totalDifficulty": "0x78ed983323d",
"transactions": [
],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": [
]
}
}
```
### eth_getBlockByNumber {#eth-getblockbynumber}
يُرجع معلومات حول كتلة بناءً على رقم الكتلة.
جرب نقطة النهاية في بيئة الاختبار
**المعلمات**
1. `QUANTITY|TAG` - عدد صحيح لرقم الكتلة، أو السلسلة النصية `"earliest"`، أو `"latest"`، أو `"pending"`، أو `"safe"`، أو `"finalized"`، كما هو موضح في [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter).
2. `Boolean` - إذا كانت `true` فإنها تُرجع كائنات المعاملة الكاملة، وإذا كانت `false` فإنها تُرجع تجزئات المعاملات فقط.
```js
params: [
"0x1b4", // 436
true,
]
```
**القيم المرجعة**
راجع [eth_getBlockByHash](#eth-getblockbyhash)
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'
```
للنتيجة راجع [eth_getBlockByHash](#eth-getblockbyhash)
### eth_getTransactionByHash {#eth-gettransactionbyhash}
يعيد المعلومات حول معاملة مطلوبة بواسطة تجزئة المعاملة.
جرب نقطة النهاية في ساحة التجربة
**المعلمات**
1. `DATA`، 32 Bytes - تجزئة المعاملة
```js
params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]
```
**القيم المعادة**
`Object` - كائن معاملة، أو `null` عند عدم العثور على معاملة:
- `blockHash`: `DATA`، 32 Bytes - تجزئة الكتلة التي كانت هذه المعاملة فيها. `null` عندما تكون معلقة.
- `blockNumber`: `QUANTITY` - رقم الكتلة التي كانت هذه المعاملة فيها. `null` عندما تكون معلقة.
- `from`: `DATA`، 20 Bytes - عنوان المرسل.
- `gas`: `QUANTITY` - الغاز المقدم من المرسل.
- `gasPrice`: `QUANTITY` - سعر الغاز المقدم من المرسل بوحدة Wei.
- `hash`: `DATA`، 32 Bytes - تجزئة المعاملة.
- `input`: `DATA` - البيانات المرسلة مع المعاملة.
- `nonce`: `QUANTITY` - عدد المعاملات التي أجراها المرسل قبل هذه المعاملة.
- `to`: `DATA`، 20 Bytes - عنوان المستلم. `null` عندما تكون معاملة إنشاء عقد.
- `transactionIndex`: `QUANTITY` - عدد صحيح لموضع مؤشر المعاملة في الكتلة. `null` عندما تكون معلقة.
- `value`: `QUANTITY` - القيمة المحولة بوحدة Wei.
- `v`: `QUANTITY` - معرف استرداد ECDSA
- `r`: `QUANTITY` - توقيع ECDSA r
- `s`: `QUANTITY` - توقيع ECDSA s
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
// نتيجة
{
"jsonrpc":"2.0",
"id":1,
"result":{
"blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
"blockNumber":"0x5daf3b", // 6139707
"from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",
"gas":"0xc350", // 50000
"gasPrice":"0x4a817c800", // 20000000000
"hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
"input":"0x68656c6c6f21",
"nonce":"0x15", // 21
"to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",
"transactionIndex":"0x41", // 65
"value":"0xf3dbb76162000", // 4290000000000000
"v":"0x25", // 37
"r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",
"s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"
}
}
```
### eth_getTransactionByBlockHashAndIndex {#eth-gettransactionbyblockhashandindex}
يُرجع معلومات حول معاملة حسب تجزئة الكتلة وموضع مؤشر المعاملة.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
1. `DATA`، 32 Bytes - تجزئة الكتلة.
2. `QUANTITY` - عدد صحيح لموضع مؤشر المعاملة.
```js
params: [
"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
"0x0", // 0
]
```
**المرتجعات**
انظر [eth_getTransactionByHash](#eth-gettransactionbyhash)
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'
```
للنتيجة انظر [eth_getTransactionByHash](#eth-gettransactionbyhash)
### eth_getTransactionByBlockNumberAndIndex {#eth-gettransactionbyblocknumberandindex}
يُرجع معلومات حول معاملة بناءً على رقم الكتلة وموضع مؤشر المعاملة.
جرب نقطة النهاية في بيئة اللعب
**المعلمات**
1. `QUANTITY|TAG` - رقم كتلة، أو السلسلة `"earliest"`، أو `"latest"`، أو `"pending"`، أو `"safe"`، أو `"finalized"`، كما هو موضح في [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter).
2. `QUANTITY` - موضع مؤشر المعاملة.
```js
params: [
"0x9c47cf", // 10241999
"0x24", // 36
]
```
**المرتجعات**
راجع [eth_getTransactionByHash](#eth-gettransactionbyhash)
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'
```
للنتيجة راجع [eth_getTransactionByHash](#eth-gettransactionbyhash)
### eth_getTransactionReceipt {#eth-gettransactionreceipt}
يعيد إيصال معاملة بواسطة تجزئة المعاملة.
**ملاحظة** أن الإيصال غير متاح للمعاملات المعلقة.
**المعلمات**
1. `DATA`، 32 Bytes - تجزئة معاملة
```js
params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]
```
**القيم المعادة**
`Object` - كائن إيصال معاملة، أو `null` عند عدم العثور على إيصال:
- `transactionHash `: `DATA`، 32 Bytes - تجزئة المعاملة.
- `transactionIndex`: `QUANTITY` - عدد صحيح يمثل موضع مؤشر المعاملة في الكتلة.
- `blockHash`: `DATA`، 32 Bytes - تجزئة الكتلة التي كانت هذه المعاملة فيها.
- `blockNumber`: `QUANTITY` - رقم الكتلة التي كانت هذه المعاملة فيها.
- `from`: `DATA`، 20 Bytes - عنوان المرسل.
- `to`: `DATA`، 20 Bytes - عنوان المستلم. يكون null عندما تكون معاملة إنشاء عقد.
- `cumulativeGasUsed` : `QUANTITY ` - إجمالي كمية الغاز المستخدمة عند تنفيذ هذه المعاملة في الكتلة.
- `effectiveGasPrice` : `QUANTITY` - مجموع الرسم الأساسي والإكرامية المدفوعة لكل وحدة غاز.
- `gasUsed `: `QUANTITY ` - كمية الغاز المستخدمة بواسطة هذه المعاملة المحددة وحدها.
- `contractAddress `: `DATA`، 20 Bytes - عنوان العقد الذي تم إنشاؤه، إذا كانت المعاملة عبارة عن إنشاء عقد، وإلا `null`.
- `logs`: `Array` - مصفوفة من كائنات السجل التي أنشأتها هذه المعاملة.
- `logsBloom`: `DATA`، 256 Bytes - مرشح بلوم للعملاء الخفيفين لاسترداد السجلات ذات الصلة بسرعة.
- `type`: `QUANTITY` - عدد صحيح يمثل نوع المعاملة، `0x0` للمعاملات القديمة، `0x1` لأنواع قوائم الوصول، `0x2` للرسوم الديناميكية.
كما يعيد _إما_ :
- `root` : `DATA` 32 bytes من جذر الحالة بعد المعاملة (قبل بيزنطيوم)
- `status`: `QUANTITY` إما `1` (نجاح) أو `0` (فشل)
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'
// نتيجة
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash":
"0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",
"blockNumber": "0xeff35f",
"contractAddress": null, // سلسلة نصية للعنوان إذا تم إنشاؤه
"cumulativeGasUsed": "0xa12515",
"effectiveGasPrice": "0x5a9c688d4",
"from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",
"gasUsed": "0xb4c8",
"logs": [{
// سجلات كما تم إرجاعها بواسطة getFilterLogs، إلخ.
}],
"logsBloom": "0x00...0", // مرشح بلوم 256 بايت
"status": "0x1",
"to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"transactionHash":
"0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",
"transactionIndex": "0x66",
"type": "0x2"
}
}
```
### eth_getUncleByBlockHashAndIndex {#eth-getunclebyblockhashandindex}
يُرجع معلومات حول عم لكتلة بناءً على التجزئة وموضع مؤشر العم.
جرب نقطة النهاية في ساحة التجربة
**المعلمات**
1. `DATA`، 32 Bytes - تجزئة الكتلة.
2. `QUANTITY` - موضع مؤشر العم.
```js
params: [
"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
"0x0", // 0
]
```
**المرتجعات**
انظر [eth_getBlockByHash](#eth-getblockbyhash)
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'
```
للنتيجة انظر [eth_getBlockByHash](#eth-getblockbyhash)
**ملاحظة**: لا يحتوي العم على معاملات فردية.
### eth_getUncleByBlockNumberAndIndex {#eth-getunclebyblocknumberandindex}
يُرجع معلومات حول عم لكتلة بناءً على الرقم وموضع مؤشر العم.
جرب نقطة النهاية في ساحة اللعب
**المعلمات**
1. `QUANTITY|TAG` - رقم كتلة، أو السلسلة `"earliest"`، أو `"latest"`، أو `"pending"`، أو `"safe"`، أو `"finalized"`، كما هو الحال في [معلمة الكتلة](/developers/docs/apis/json-rpc/#block-parameter).
2. `QUANTITY` - موضع مؤشر العم.
```js
params: [
"0x29c", // 668
"0x0", // 0
]
```
**المرتجعات**
راجع [eth_getBlockByHash](#eth-getblockbyhash)
**ملاحظة**: لا يحتوي العم على معاملات فردية.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'
```
للنتيجة راجع [eth_getBlockByHash](#eth-getblockbyhash)
### eth_newFilter {#eth-newfilter}
ينشئ كائن مرشح، بناءً على خيارات الترشيح، للإشعار عند تغير الحالة (السجلات).
للتحقق مما إذا كانت الحالة قد تغيرت، استدعِ [eth_getFilterChanges](#eth-getfilterchanges).
**ملاحظة حول تحديد مرشحات المواضيع:**
المواضيع تعتمد على الترتيب. المعاملة التي تحتوي على سجل بمواضيع [A, B] ستتطابق مع مرشحات المواضيع التالية:
- `[]` "أي شيء"
- `[A]` "A في الموضع الأول (وأي شيء بعده)"
- `[null, B]` "أي شيء في الموضع الأول و B في الموضع الثاني (وأي شيء بعده)"
- `[A, B]` "A في الموضع الأول و B في الموضع الثاني (وأي شيء بعده)"
- `[[A, B], [A, B]]` "(A أو B) في الموضع الأول و (A أو B) في الموضع الثاني (وأي شيء بعده)"
- **المعلمات**
1. `Object` - خيارات المرشح:
- `fromBlock`: `QUANTITY|TAG` - (اختياري، الافتراضي: `"latest"`) رقم كتلة صحيح، أو `"latest"` لآخر كتلة مقترحة، أو `"safe"` لأحدث كتلة آمنة، أو `"finalized"` لأحدث كتلة نهائية، أو `"pending"`، `"earliest"` للمعاملات التي لم تُدرج في كتلة بعد.
- `toBlock`: `QUANTITY|TAG` - (اختياري، الافتراضي: `"latest"`) رقم كتلة صحيح، أو `"latest"` لآخر كتلة مقترحة، أو `"safe"` لأحدث كتلة آمنة، أو `"finalized"` لأحدث كتلة نهائية، أو `"pending"`، `"earliest"` للمعاملات التي لم تُدرج في كتلة بعد.
- `address`: `DATA|Array`، 20 Bytes - (اختياري) عنوان عقد أو قائمة عناوين يجب أن تصدر منها السجلات.
- `topics`: `Array of DATA`، - (اختياري) مصفوفة من مواضيع `DATA` بحجم 32 Bytes. المواضيع تعتمد على الترتيب. يمكن أن يكون كل موضوع أيضًا مصفوفة من البيانات مع خيارات "أو" (or).
```js
params: [
{
fromBlock: "0x1",
toBlock: "0x2",
address: "0x8888f1f195afa192cfee860698584c030f4c9db1",
topics: [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
null,
[
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
"0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc",
],
],
},
]
```
**المرتجعات**
`QUANTITY` - معرف المرشح.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x1" // 1
}
```
### eth_newBlockFilter {#eth-newblockfilter}
ينشئ مرشحًا في العقدة، للإشعار عند وصول كتلة جديدة.
للتحقق مما إذا كانت الحالة قد تغيرت، قم باستدعاء [eth_getFilterChanges](#eth-getfilterchanges).
**المعلمات**
لا يوجد
**المرتجعات**
`QUANTITY` - معرف المرشح.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x1" // 1
}
```
### eth_newPendingTransactionFilter {#eth-newpendingtransactionfilter}
ينشئ مرشحًا في العقدة، للإشعار عند وصول معاملات معلقة جديدة.
للتحقق مما إذا كانت الحالة قد تغيرت، قم باستدعاء [eth_getFilterChanges](#eth-getfilterchanges).
**المعلمات**
لا يوجد
**المرتجعات**
`QUANTITY` - معرف المرشح.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": "0x1" // 1
}
```
### eth_uninstallFilter {#eth-uninstallfilter}
يقوم بإلغاء تثبيت مرشح بمعرف محدد. يجب استدعاؤه دائمًا عندما لا تعود هناك حاجة للمراقبة.
بالإضافة إلى ذلك، تنتهي مهلة المرشحات عندما لا يتم طلبها باستخدام [eth_getFilterChanges](#eth-getfilterchanges) لفترة من الوقت.
**المعلمات**
1. `QUANTITY` - معرف المرشح.
```js
params: [
"0xb", // 11
]
```
**القيم المرجعة**
`Boolean` - `true` إذا تم إلغاء تثبيت المرشح بنجاح، وإلا `false`.
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
// نتيجة
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
```
### eth_getFilterChanges {#eth-getfilterchanges}
طريقة استطلاع لمرشح، والتي تُرجع مصفوفة من السجلات التي حدثت منذ آخر استطلاع.
**المعلمات**
1. `QUANTITY` - معرف المرشح.
```js
params: [
"0x16", // 22
]
```
**القيم المرجعة**
`Array` - مصفوفة من كائنات السجل، أو مصفوفة فارغة إذا لم يتغير شيء منذ آخر استطلاع.
- بالنسبة للمرشحات التي تم إنشاؤها باستخدام `eth_newBlockFilter` تكون القيم المرجعة عبارة عن تجزئات الكتل (`DATA`، 32 Bytes)، على سبيل المثال، `["0x3454645634534..."]`.
- بالنسبة للمرشحات التي تم إنشاؤها باستخدام `eth_newPendingTransactionFilter ` تكون القيم المرجعة عبارة عن تجزئات المعاملات (`DATA`، 32 Bytes)، على سبيل المثال، `["0x6345343454645..."]`.
- بالنسبة للمرشحات التي تم إنشاؤها باستخدام `eth_newFilter` تكون السجلات عبارة عن كائنات تحتوي على المعلمات التالية:
- `removed`: `TAG` - `true` عندما تتم إزالة السجل، بسبب إعادة التنظيم للسلسلة. `false` إذا كان سجلاً صالحًا.
- `logIndex`: `QUANTITY` - عدد صحيح لموضع مؤشر السجل في الكتلة. `null` عندما يكون سجلاً معلقًا.
- `transactionIndex`: `QUANTITY` - عدد صحيح لموضع مؤشر المعاملة التي تم إنشاء السجل منها. `null` عندما يكون سجلاً معلقًا.
- `transactionHash`: `DATA`، 32 Bytes - تجزئة المعاملة التي تم إنشاء هذا السجل منها. `null` عندما يكون سجلاً معلقًا.
- `blockHash`: `DATA`، 32 Bytes - تجزئة الكتلة التي كان هذا السجل موجودًا فيها. `null` عندما يكون معلقًا. `null` عندما يكون سجلاً معلقًا.
- `blockNumber`: `QUANTITY` - رقم الكتلة التي كان هذا السجل موجودًا فيها. `null` عندما يكون معلقًا. `null` عندما يكون سجلاً معلقًا.
- `address`: `DATA`، 20 Bytes - العنوان الذي نشأ منه هذا السجل.
- `data`: `DATA` - بيانات سجل غير مفهرسة متغيرة الطول. (في _Solidity_: صفر أو أكثر من وسيطات السجل غير المفهرسة بحجم 32 Bytes.)
- `topics`: `Array of DATA` - مصفوفة من 0 إلى 4 `DATA` بحجم 32 Bytes من وسيطات السجل المفهرسة. (في _Solidity_: الموضوع الأول هو _تجزئة_ توقيع الحدث (على سبيل المثال، `Deposit(address,bytes32,uint256)`)، إلا إذا قمت بتعريف الحدث باستخدام المحدد `anonymous`.)
- **مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'
// نتيجة
{
"id":1,
"jsonrpc":"2.0",
"result": [{
"logIndex": "0x1", // 1
"blockNumber":"0x1b4", // 436
"blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
"transactionIndex": "0x0", // 0
"address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
"data":"0x0000000000000000000000000000000000000000000000000000000000000000",
"topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]
},{
...
}]
}
```
### eth_getFilterLogs {#eth-getfilterlogs}
يعيد مصفوفة بجميع السجلات التي تطابق عامل التصفية بالمعرف المحدد.
**المعلمات**
1. `QUANTITY` - معرف عامل التصفية.
```js
params: [
"0x16", // 22
]
```
**القيم المعادة**
راجع [eth_getFilterChanges](#eth-getfilterchanges)
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'
```
للنتيجة راجع [eth_getFilterChanges](#eth-getfilterchanges)
### eth_getLogs {#eth-getlogs}
يعيد مصفوفة بجميع السجلات التي تطابق كائن تصفية معين.
**المعلمات**
1. `Object` - خيارات التصفية:
- `fromBlock`: `QUANTITY|TAG` - (اختياري، الافتراضي: `"latest"`) رقم الكتلة كعدد صحيح، أو `"latest"` لآخر كتلة مقترحة، أو `"safe"` لأحدث كتلة آمنة، أو `"finalized"` لأحدث كتلة نهائية، أو `"pending"`، `"earliest"` للمعاملات التي لم تُدرج في كتلة بعد.
- `toBlock`: `QUANTITY|TAG` - (اختياري، الافتراضي: `"latest"`) رقم الكتلة كعدد صحيح، أو `"latest"` لآخر كتلة مقترحة، أو `"safe"` لأحدث كتلة آمنة، أو `"finalized"` لأحدث كتلة نهائية، أو `"pending"`، `"earliest"` للمعاملات التي لم تُدرج في كتلة بعد.
- `address`: `DATA|Array`، 20 Bytes - (اختياري) عنوان العقد أو قائمة بالعناوين التي يجب أن تصدر منها السجلات.
- `topics`: `Array of DATA`، - (اختياري) مصفوفة من مواضيع `DATA` بحجم 32 Bytes. المواضيع تعتمد على الترتيب. يمكن أن يكون كل موضوع أيضًا مصفوفة من البيانات (DATA) مع خيارات "أو" (or).
- `blockHash`: `DATA`، 32 Bytes - (اختياري، **مستقبلي**) مع إضافة EIP-234، سيكون `blockHash` خيار تصفية جديدًا يقصر السجلات المعادة على الكتلة الفردية ذات التجزئة بحجم 32-byte `blockHash`. استخدام `blockHash` يعادل `fromBlock` = `toBlock` = رقم الكتلة ذات التجزئة `blockHash`. إذا كان `blockHash` موجودًا في معايير التصفية، فلن يُسمح باستخدام `fromBlock` ولا `toBlock`.
```js
params: [
{
topics: [
"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
],
},
]
```
**القيم المعادة**
انظر [eth_getFilterChanges](#eth-getfilterchanges)
**مثال**
```js
// طلب
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'
```
للنتيجة انظر [eth_getFilterChanges](#eth-getfilterchanges)
## مثال على الاستخدام {#usage-example}
### نشر عقد باستخدام JSON_RPC {#deploying-contract}
يتضمن هذا القسم عرضًا توضيحيًا لكيفية نشر عقد باستخدام واجهة RPC فقط. هناك طرق بديلة لنشر العقود حيث يتم تجريد هذا التعقيد — على سبيل المثال، باستخدام مكتبات مبنية فوق واجهة RPC مثل [Web3.js](https://web3js.readthedocs.io/) و[Web3.py](https://github.com/ethereum/web3.py). هذه التجريدات بشكل عام أسهل في الفهم وأقل عرضة للخطأ، ولكن لا يزال من المفيد فهم ما يحدث داخليًا.
فيما يلي عقد ذكي بسيط يسمى `Multiply7` سيتم نشره باستخدام واجهة JSON-RPC إلى عقدة إيثيريوم. يفترض هذا البرنامج التعليمي أن القارئ يقوم بالفعل بتشغيل عقدة جو إيثريوم (geth). يتوفر المزيد من المعلومات حول العقد والعملاء [هنا](/developers/docs/nodes-and-clients/run-a-node). يُرجى الرجوع إلى وثائق [العميل](/developers/docs/nodes-and-clients/) الفردية لمعرفة كيفية بدء HTTP JSON-RPC للعملاء غير Geth. يعمل معظم العملاء افتراضيًا على `localhost:8545`.
```javascript
contract Multiply7 {
event Print(uint);
function multiply(uint input) returns (uint) {
Print(input * 7);
return input * 7;
}
}
```
أول شيء يجب فعله هو التأكد من تمكين واجهة HTTP RPC. هذا يعني أننا نزود جو إيثريوم (geth) بعلامة `--http` عند بدء التشغيل. في هذا المثال، نستخدم عقدة جو إيثريوم (geth) على سلسلة تطوير خاصة. باستخدام هذا النهج، لا نحتاج إلى إيثر على الشبكة الحقيقية.
```bash
geth --http --dev console 2>>geth.log
```
سيؤدي هذا إلى بدء واجهة HTTP RPC على `http://localhost:8545`.
يمكننا التحقق من تشغيل الواجهة عن طريق استرداد عنوان كوين بيس (عن طريق الحصول على العنوان الأول من مصفوفة الحسابات) والرصيد باستخدام [curl](https://curl.se). يُرجى ملاحظة أن البيانات في هذه الأمثلة ستختلف على عقدتك المحلية. إذا كنت ترغب في تجربة هذه الأوامر، فاستبدل معلمات الطلب في طلب curl الثاني بالنتيجة التي تم إرجاعها من الطلب الأول.
```bash
curl --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[], "id":1}' -H "Content-Type: application/json" localhost:8545
{"id":1,"jsonrpc":"2.0","result":["0x9b1d35635cc34752ca54713bb99d38614f63c955"]}
curl --data '{"jsonrpc":"2.0","method":"eth_getBalance", "params": ["0x9b1d35635cc34752ca54713bb99d38614f63c955", "latest"], "id":2}' -H "Content-Type: application/json" localhost:8545
{"id":2,"jsonrpc":"2.0","result":"0x1639e49bba16280000"}
```
نظرًا لأن الأرقام مشفرة بالنظام السداسي العشري، يتم إرجاع الرصيد بوحدة Wei كسلسلة سداسية عشرية. إذا أردنا الحصول على الرصيد بوحدة إيثر كرقم، يمكننا استخدام Web3 من وحدة تحكم جو إيثريوم (geth).
```javascript
web3.fromWei("0x1639e49bba16280000", "ether")
// "410"
```
الآن بعد أن أصبح هناك بعض الإيثر على سلسلة التطوير الخاصة بنا، يمكننا نشر العقد. الخطوة الأولى هي تصريف عقد Multiply7 إلى رمز البايت الذي يمكن إرساله إلى جهاز إيثيريوم الظاهري (EVM). لتثبيت solc، مُصرّف Solidity، اتبع [وثائق Solidity](https://docs.soliditylang.org/en/latest/installing-solidity.html). (قد ترغب في استخدام إصدار `solc` أقدم لمطابقة [إصدار المُصرّف المستخدم في مثالنا](https://github.com/ethereum/solidity/releases/tag/v0.4.20).)
الخطوة التالية هي تصريف عقد Multiply7 إلى رمز البايت الذي يمكن إرساله إلى جهاز إيثيريوم الظاهري (EVM).
```bash
echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin
======= :Multiply7 =======
Binary:
6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029
```
الآن بعد أن أصبح لدينا الرمز المُصرّف، نحتاج إلى تحديد مقدار الغاز الذي يكلفه نشره. تحتوي واجهة RPC على طريقة `eth_estimateGas` التي ستعطينا تقديرًا.
```bash
curl --data '{"jsonrpc":"2.0","method": "eth_estimateGas", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 5}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":5,"result":"0x1c31e"}
```
وأخيرًا نشر العقد.
```bash
curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "gas": "0x1c31e", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 6}' -H "Content-Type: application/json" localhost:8545
{"id":6,"jsonrpc":"2.0","result":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"}
```
يتم قبول المعاملة بواسطة العقدة ويتم إرجاع تجزئة المعاملة. يمكن استخدام هذه التجزئة لتتبع المعاملة. الخطوة التالية هي تحديد العنوان الذي تم نشر عقدنا فيه. ستؤدي كل معاملة يتم تنفيذها إلى إنشاء إيصال. يحتوي هذا الإيصال على معلومات مختلفة حول المعاملة مثل الكتلة التي تم تضمين المعاملة فيها ومقدار الغاز الذي استخدمه جهاز إيثيريوم الظاهري (EVM). إذا أنشأت المعاملة عقدًا، فستحتوي أيضًا على عنوان العقد. يمكننا استرداد الإيصال باستخدام طريقة RPC `eth_getTransactionReceipt`.
```bash
curl --data '{"jsonrpc":"2.0","method": "eth_getTransactionReceipt", "params": ["0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"], "id": 7}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":7,"result":{"blockHash":"0x77b1a4f6872b9066312de3744f60020cbd8102af68b1f6512a05b7619d527a4f","blockNumber":"0x1","contractAddress":"0x4d03d617d700cf81935d7f797f4e2ae719648262","cumulativeGasUsed":"0x1c31e","from":"0x9b1d35635cc34752ca54713bb99d38614f63c955","gasUsed":"0x1c31e","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf","transactionIndex":"0x0"}}
```
تم إنشاء عقدنا على `0x4d03d617d700cf81935d7f797f4e2ae719648262`. النتيجة الفارغة (null) بدلاً من الإيصال تعني أن المعاملة لم يتم تضمينها في كتلة بعد. انتظر لحظة وتحقق مما إذا كان عميل الإجماع الخاص بك قيد التشغيل وحاول مرة أخرى.
#### التفاعل مع العقود الذكية {#interacting-with-smart-contract}
في هذا المثال، سنرسل معاملة باستخدام `eth_sendTransaction` إلى طريقة `multiply` الخاصة بالعقد.
يتطلب `eth_sendTransaction` عدة وسائط، وتحديدًا `from` و`to` و`data`. `From` هو العنوان العام لحسابنا، و`to` هو عنوان العقد. تحتوي وسيطة `data` على حمولة تحدد الطريقة التي يجب استدعاؤها وبأي وسائط. هنا يأتي دور [واجهة التطبيق الثنائية (ABI)](https://docs.soliditylang.org/en/latest/abi-spec.html). واجهة التطبيق الثنائية (ABI) هي ملف JSON يحدد كيفية تعريف وتشفير البيانات لجهاز إيثيريوم الظاهري (EVM).
تحدد بايتات الحمولة الطريقة التي يتم استدعاؤها في العقد. هذه هي أول 4 بايتات من تجزئة كيكاك (Keccak) لاسم الدالة وأنواع وسائطها، مشفرة بالنظام السداسي العشري. تقبل دالة multiply نوع uint وهو اسم مستعار لـ uint256. هذا يتركنا مع:
```javascript
web3.sha3("multiply(uint256)").substring(0, 10)
// "0xc6888fa1"
```
الخطوة التالية هي تشفير الوسائط. يوجد uint256 واحد فقط، لنقل، القيمة 6. تحتوي واجهة التطبيق الثنائية (ABI) على قسم يحدد كيفية تشفير أنواع uint256.
`int: enc(X)` هو تشفير المتمم الثنائي بنظام النهاية الكبرى لـ X، مبطن على الجانب ذي الترتيب الأعلى (الأيسر) بـ 0xff لـ X السالبة وببايتات صفرية لـ X الموجبة بحيث يكون الطول مضاعفًا لـ 32 بايت.
يتم تشفير هذا إلى `0000000000000000000000000000000000000000000000000000000000000006`.
من خلال الجمع بين محدد الدالة والوسيطة المشفرة، ستكون بياناتنا `0xc6888fa10000000000000000000000000000000000000000000000000000000000000006`.
يمكن الآن إرسال هذا إلى العقدة:
```bash
curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0xeb85a5557e5bdc18ee1934a89d8bb402398ee26a", "to": "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d", "data": "0xc6888fa10000000000000000000000000000000000000000000000000000000000000006"}], "id": 8}' -H "Content-Type: application/json" localhost:8545
{"id":8,"jsonrpc":"2.0","result":"0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74"}
```
نظرًا لأنه تم إرسال معاملة، تم إرجاع تجزئة المعاملة. يؤدي استرداد الإيصال إلى إعطاء:
```javascript
{
blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
blockNumber: 268,
contractAddress: null,
cumulativeGasUsed: 22631,
gasUsed: 22631,
logs: [{
address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d",
blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
blockNumber: 268,
data: "0x000000000000000000000000000000000000000000000000000000000000002a",
logIndex: 0,
topics: ["0x24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"],
transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
transactionIndex: 0
}],
transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
transactionIndex: 0
}
```
يحتوي الإيصال على سجل. تم إنشاء هذا السجل بواسطة جهاز إيثيريوم الظاهري (EVM) عند تنفيذ المعاملة وتم تضمينه في الإيصال. تُظهر دالة `multiply` أنه تم إطلاق حدث `Print` مع المدخلات مضروبة في 7. نظرًا لأن وسيطة حدث `Print` كانت uint256، يمكننا فك تشفيرها وفقًا لقواعد واجهة التطبيق الثنائية (ABI) مما سيتركنا مع الرقم العشري المتوقع 42. بصرف النظر عن البيانات، تجدر الإشارة إلى أنه يمكن استخدام المواضيع لتحديد الحدث الذي أنشأ السجل:
```javascript
web3.sha3("Print(uint256)")
// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"
```
كانت هذه مجرد مقدمة موجزة لبعض المهام الأكثر شيوعًا، والتي توضح الاستخدام المباشر لـ JSON-RPC.
## مواضيع ذات صلة {#related-topics}
- [مواصفات JSON-RPC](https://www.jsonrpc.org/specification)
- [العقد والعملاء](/developers/docs/nodes-and-clients/)
- [واجهات برمجة تطبيقات (APIs) لـ JavaScript](/developers/docs/apis/javascript/)
- [واجهات برمجة تطبيقات (APIs) للواجهة الخلفية](/developers/docs/apis/backend/)
- [عملاء التنفيذ](/developers/docs/nodes-and-clients/#execution-clients)