JSON-RPC API

کسی بھی سافٹ ویئر ایپلیکیشن کو ایتھریم بلاک چین کے ساتھ تعامل کرنے کے لیے - چاہے وہ بلاک چین کا ڈیٹا پڑھنا ہو یا نیٹ ورک پر ٹرانزیکشنز بھیجنا ہو - اسے ایک ایتھریم نوڈ سے منسلک ہونا ضروری ہے۔

اس مقصد کے لیے، ہر ایتھریم کلائنٹ ایک JSON-RPC تصریح (opens in a new tab) کو نافذ کرتا ہے، تاکہ طریقوں (methods) کا ایک یکساں سیٹ موجود ہو جس پر ایپلیکیشنز انحصار کر سکیں، قطع نظر اس کے کہ مخصوص نوڈ یا کلائنٹ کا نفاذ کیا ہے۔

JSON-RPC (opens in a new tab) ایک سٹیٹ لیس، ہلکا پھلکا ریموٹ پروسیجر کال (RPC) پروٹوکول ہے۔ یہ کئی ڈیٹا سٹرکچرز اور ان کی پروسیسنگ کے اصولوں کی وضاحت کرتا ہے۔ یہ ٹرانسپورٹ ایگنوسٹک (transport agnostic) ہے، یعنی اس کے تصورات کو ایک ہی پروسیس کے اندر، ساکٹس (sockets) پر، HTTP پر، یا پیغام رسانی کے مختلف ماحول میں استعمال کیا جا سکتا ہے۔ یہ ڈیٹا فارمیٹ کے طور پر JSON (RFC 4627) کا استعمال کرتا ہے۔

کلائنٹ امپلی مینٹیشنز

ایتھریم کلائنٹس JSON-RPC کی تخصیص کو نافذ کرتے وقت مختلف پروگرامنگ زبانیں استعمال کر سکتے ہیں۔ مخصوص پروگرامنگ زبانوں سے متعلق مزید تفصیلات کے لیے انفرادی کلائنٹ کی دستاویزات دیکھیں۔ ہم تجویز کرتے ہیں کہ تازہ ترین API سپورٹ کی معلومات کے لیے ہر کلائنٹ کی دستاویزات چیک کریں۔

سہولت بخش لائبریریاں

اگرچہ آپ JSON-RPC API کے ذریعے براہ راست Ethereum کلائنٹس کے ساتھ تعامل کرنے کا انتخاب کر سکتے ہیں، لیکن dapp ڈیولپرز کے لیے اکثر آسان اختیارات موجود ہوتے ہیں۔ JSON-RPC API کے اوپر ریپرز (wrappers) فراہم کرنے کے لیے بہت سی JavaScript اور backend API لائبریریاں موجود ہیں۔ ان لائبریریوں کے ساتھ، ڈیولپرز اپنی پسند کی پروگرامنگ زبان میں بدیہی، ایک سطری (one-line) طریقے لکھ سکتے ہیں تاکہ (پس پردہ) JSON-RPC درخواستیں شروع کی جا سکیں جو Ethereum کے ساتھ تعامل کرتی ہیں۔

کنسنسس کلائنٹ APIs

یہ صفحہ بنیادی طور پر Ethereum ایگزیکیوشن کلائنٹس کے زیر استعمال JSON-RPC API سے متعلق ہے۔ تاہم، کنسنسس کلائنٹس میں ایک RPC API بھی ہوتا ہے جو صارفین کو نوڈ کے بارے میں معلومات حاصل کرنے، بیکن (Beacon) بلاکس، بیکن اسٹیٹ، اور کنسنسس سے متعلق دیگر معلومات براہ راست نوڈ سے طلب کرنے کی اجازت دیتا ہے۔ اس API کی دستاویزات بیکن API ویب پیج (opens in a new tab) پر موجود ہیں۔

ایک نوڈ کے اندر کلائنٹس کے درمیان رابطے کے لیے ایک اندرونی API بھی استعمال کیا جاتا ہے - یعنی، یہ کنسنسس کلائنٹ اور ایگزیکیوشن کلائنٹ کو ڈیٹا کا تبادلہ کرنے کے قابل بناتا ہے۔ اسے 'Engine API' کہا جاتا ہے اور اس کی تفصیلات GitHub (opens in a new tab) پر دستیاب ہیں۔

ایگزیکیوشن کلائنٹ کی تفصیلات

GitHub پر مکمل JSON-RPC API کی تفصیلات پڑھیں (opens in a new tab)۔ اس API کو Execution API ویب پیج (opens in a new tab) پر دستاویزی شکل دی گئی ہے اور اس میں تمام دستیاب طریقوں کو آزمانے کے لیے ایک انسپکٹر (Inspector) شامل ہے۔

روایات

ہیکس ویلیو انکوڈنگ

JSON پر دو اہم ڈیٹا ٹائپس پاس کی جاتی ہیں: ان فارمیٹڈ بائٹ ایریز (unformatted byte arrays) اور مقداریں (quantities)۔ دونوں کو ہیکس انکوڈنگ کے ساتھ پاس کیا جاتا ہے لیکن فارمیٹنگ کے لیے مختلف تقاضوں کے ساتھ۔

مقداریں

مقداروں (انٹیجرز، نمبرز) کو انکوڈ کرتے وقت: ہیکس کے طور پر انکوڈ کریں، "0x" کا سابقہ لگائیں، جو کہ سب سے مختصر نمائندگی ہے (معمولی استثنا: صفر کو "0x0" کے طور پر پیش کیا جانا چاہیے)۔

یہاں کچھ مثالیں ہیں:

0x41 (اعشاریہ میں 65)
0x400 (اعشاریہ میں 1024)
غلط: 0x (ہمیشہ کم از کم ایک ہندسہ ہونا چاہیے - صفر "0x0" ہے)
غلط: 0x0400 (شروع میں صفر کی اجازت نہیں ہے)
غلط: ff (شروع میں 0x کا سابقہ ہونا ضروری ہے)

ان فارمیٹڈ ڈیٹا

ان فارمیٹڈ ڈیٹا (بائٹ ایریز، اکاؤنٹ ایڈریسز، ہیشز، بائٹ کوڈ ایریز) کو انکوڈ کرتے وقت: ہیکس کے طور پر انکوڈ کریں، "0x" کا سابقہ لگائیں، فی بائٹ دو ہیکس ہندسے۔

یہاں کچھ مثالیں ہیں:

0x41 (سائز 1، "A")
0x004200 (سائز 3، "0B0")
0x (سائز 0، "")
غلط: 0xf0f0f (ہندسوں کی تعداد جفت ہونی چاہیے)
غلط: 004200 (شروع میں 0x کا سابقہ ہونا ضروری ہے)

بلاک پیرامیٹر

درج ذیل میتھڈز میں ایک بلاک پیرامیٹر ہوتا ہے:

eth_getBalance
eth_getCode
eth_getTransactionCount
eth_getStorageAt
eth_call

جب ایسی درخواستیں کی جاتی ہیں جو Ethereum کی حالت (state) کے بارے میں استفسار کرتی ہیں، تو فراہم کردہ بلاک پیرامیٹر بلاک کی اونچائی (height) کا تعین کرتا ہے۔

بلاک پیرامیٹر کے لیے درج ذیل آپشنز ممکن ہیں:

HEX String - ایک انٹیجر بلاک نمبر
String "earliest" - سب سے ابتدائی/جینیسس (genesis) بلاک کے لیے
String "latest" - تازہ ترین تجویز کردہ بلاک کے لیے
String "safe" - تازہ ترین محفوظ ہیڈ بلاک کے لیے
String "finalized" - تازہ ترین حتمی (finalized) بلاک کے لیے
String "pending" - زیر التوا حالت/ٹرانزیکشنز کے لیے

مثالیں

اس صفحے پر ہم کمانڈ لائن ٹول، curl (opens in a new tab) کا استعمال کرتے ہوئے انفرادی JSON_RPC API اینڈ پوائنٹس کو استعمال کرنے کی مثالیں فراہم کرتے ہیں۔ یہ انفرادی اینڈ پوائنٹ کی مثالیں نیچے Curl کی مثالیں سیکشن میں دی گئی ہیں۔ صفحے میں مزید نیچے، ہم Geth نوڈ، JSON_RPC API اور curl کا استعمال کرتے ہوئے ایک اسمارٹ کانٹریکٹ کو مرتب اور تعینات کرنے کے لیے ایک مکمل مثال بھی فراہم کرتے ہیں۔

curl کی مثالیں

Ethereum نوڈ کو curl (opens in a new tab) درخواستیں بھیج کر JSON_RPC API استعمال کرنے کی مثالیں ذیل میں دی گئی ہیں۔ ہر مثال میں مخصوص اینڈ پوائنٹ کی تفصیل، اس کے پیرامیٹرز، ریٹرن ٹائپ، اور اسے استعمال کرنے کے طریقے کی ایک عملی مثال شامل ہے۔

curl درخواستیں کنٹینٹ ٹائپ سے متعلق خرابی کا پیغام (error message) واپس کر سکتی ہیں۔ اس کی وجہ یہ ہے کہ --data آپشن کنٹینٹ ٹائپ کو application/x-www-form-urlencoded پر سیٹ کرتا ہے۔ اگر آپ کا نوڈ اس بارے میں ایرر دیتا ہے، تو کال کے شروع میں -H "Content-Type: application/json" رکھ کر دستی طور پر ہیڈر سیٹ کریں۔ مثالوں میں URL/IP اور پورٹ کا امتزاج بھی شامل نہیں ہے جو curl کو دیا جانے والا آخری آرگومنٹ ہونا چاہیے (جیسے، 127.0.0.1:8545)۔ ان اضافی ڈیٹا پر مشتمل ایک مکمل curl درخواست درج ذیل شکل اختیار کرتی ہے:

1curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545

گاسپ، اسٹیٹ، ہسٹری

چند بنیادی JSON-RPC میتھڈز کو ایتھیریم نیٹ ورک سے ڈیٹا درکار ہوتا ہے، اور یہ باآسانی تین اہم زمروں میں تقسیم ہوتے ہیں: گاسپ، اسٹیٹ، اور ہسٹری۔ ہر میتھڈ پر جانے کے لیے ان سیکشنز میں موجود لنکس کا استعمال کریں، یا میتھڈز کی مکمل فہرست دیکھنے کے لیے فہرستِ مضامین کا استعمال کریں۔

گاسپ میتھڈز

یہ میتھڈز چین کے ہیڈ (head) کو ٹریک کرتے ہیں۔ اسی طرح ٹرانزیکشنز نیٹ ورک میں اپنا راستہ بناتی ہیں، بلاکس میں شامل ہوتی ہیں، اور کلائنٹس کو نئے بلاکس کے بارے میں معلوم ہوتا ہے۔

eth_blockNumber
eth_sendRawTransaction

اسٹیٹ میتھڈز

وہ میتھڈز جو تمام محفوظ کردہ ڈیٹا کی موجودہ اسٹیٹ کی رپورٹ دیتے ہیں۔ "اسٹیٹ" ایک بڑی شیئرڈ RAM کی طرح ہے، اور اس میں اکاؤنٹ بیلنس، کنٹریکٹ کا ڈیٹا، اور گیس کے تخمینے شامل ہوتے ہیں۔

eth_getBalance
eth_getStorageAt
eth_getTransactionCount
eth_getCode
eth_call
eth_estimateGas

ہسٹری میتھڈز

جینیسس (genesis) تک ہر بلاک کا تاریخی ریکارڈ حاصل کرتا ہے۔ یہ ایک بڑی اپینڈ-اونلی (append-only) فائل کی طرح ہے، اور اس میں تمام بلاک ہیڈرز، بلاک باڈیز، انکل (uncle) بلاکس، اور ٹرانزیکشن کی رسیدیں شامل ہوتی ہیں۔

eth_getBlockTransactionCountByHash
eth_getBlockTransactionCountByNumber
eth_getUncleCountByBlockHash
eth_getUncleCountByBlockNumber
eth_getBlockByHash
eth_getBlockByNumber
eth_getTransactionByHash
eth_getTransactionByBlockHashAndIndex
eth_getTransactionByBlockNumberAndIndex
eth_getTransactionReceipt
eth_getUncleByBlockHashAndIndex
eth_getUncleByBlockNumberAndIndex

JSON-RPC API پلے گراؤنڈ

آپ API میتھڈز کو دریافت کرنے اور آزمانے کے لیے پلے گراؤنڈ ٹول (opens in a new tab) استعمال کر سکتے ہیں۔ یہ آپ کو یہ بھی دکھاتا ہے کہ مختلف نوڈ پرووائیڈرز کن میتھڈز اور نیٹ ورکس کو سپورٹ کرتے ہیں۔

JSON-RPC API کے طریقے

web3_clientVersion

موجودہ کلائنٹ کا ورژن لوٹاتا ہے۔

پیرامیٹرز

کوئی نہیں

واپسی

String - موجودہ کلائنٹ کا ورژن

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
3// نتیجہ
4{
5  "id":67,
6  "jsonrpc":"2.0",
7  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
8}

web3_sha3

دیے گئے ڈیٹا کا Keccak-256 (معیاری SHA3-256 نہیں) لوٹاتا ہے۔

پیرامیٹرز

DATA - وہ ڈیٹا جسے SHA3 ہیش میں تبدیل کرنا ہے

1params: ["0x68656c6c6f20776f726c64"]

واپسی

DATA - دی گئی سٹرنگ کا SHA3 نتیجہ۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
3// نتیجہ
4{
5  "id":64,
6  "jsonrpc": "2.0",
7  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
8}

net_version

موجودہ نیٹ ورک کی آئی ڈی (id) لوٹاتا ہے۔

پیرامیٹرز

کوئی نہیں

واپسی

String - موجودہ نیٹ ورک کی آئی ڈی۔

موجودہ نیٹ ورک IDs کی مکمل فہرست chainlist.org (opens in a new tab) پر دستیاب ہے۔ کچھ عام یہ ہیں:

1: Ethereum Mainnet
11155111: Sepolia ٹیسٹ نیٹ
560048 : Hoodi ٹیسٹ نیٹ

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
3// نتیجہ
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "3"
8}

net_listening

اگر کلائنٹ نیٹ ورک کنکشنز کے لیے فعال طور پر سن رہا ہے تو true لوٹاتا ہے۔

پیرامیٹرز

کوئی نہیں

واپسی

Boolean - سنتے وقت true، بصورت دیگر false۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
3// نتیجہ
4{
5  "id":67,
6  "jsonrpc":"2.0",
7  "result":true
8}

net_peerCount

کلائنٹ سے فی الحال منسلک پیئرز (peers) کی تعداد لوٹاتا ہے۔

پیرامیٹرز

کوئی نہیں

واپسی

QUANTITY - منسلک پیئرز کی تعداد کا انٹیجر (integer)۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
3// نتیجہ
4{
5  "id":74,
6  "jsonrpc": "2.0",
7  "result": "0x2" // 2
8}

eth_protocolVersion

موجودہ Ethereum پروٹوکول کا ورژن لوٹاتا ہے۔ نوٹ کریں کہ یہ طریقہ Geth میں دستیاب نہیں ہے (opens in a new tab)۔

پیرامیٹرز

کوئی نہیں

واپسی

String - موجودہ Ethereum پروٹوکول کا ورژن

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
3// نتیجہ
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "54"
8}

eth_syncing

سنک (sync) کی صورتحال کے بارے میں ڈیٹا کے ساتھ ایک آبجیکٹ یا false لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

کوئی نہیں

واپسی

درست واپسی کا ڈیٹا کلائنٹ کے نفاذ کے درمیان مختلف ہوتا ہے۔ جب نوڈ سنک نہیں ہو رہا ہوتا تو تمام کلائنٹس False لوٹاتے ہیں، اور تمام کلائنٹس درج ذیل فیلڈز لوٹاتے ہیں۔

Object|Boolean، سنک کی صورتحال کے ڈیٹا کے ساتھ ایک آبجیکٹ یا FALSE، جب سنک نہیں ہو رہا ہو:

startingBlock: QUANTITY - وہ بلاک جس پر امپورٹ شروع ہوا (صرف اس وقت ری سیٹ ہوگا، جب سنک اپنے ہیڈ تک پہنچ جائے گا)
currentBlock: QUANTITY - موجودہ بلاک، بالکل eth_blockNumber کی طرح
highestBlock: QUANTITY - تخمینی سب سے اونچا بلاک

تاہم، انفرادی کلائنٹس اضافی ڈیٹا بھی فراہم کر سکتے ہیں۔ مثال کے طور پر Geth درج ذیل لوٹاتا ہے:

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": {
5    "currentBlock": "0x3cf522",
6    "healedBytecodeBytes": "0x0",
7    "healedBytecodes": "0x0",
8    "healedTrienodes": "0x0",
9    "healingBytecode": "0x0",
10    "healingTrienodes": "0x0",
11    "highestBlock": "0x3e0e41",
12    "startingBlock": "0x3cbed5",
13    "syncedAccountBytes": "0x0",
14    "syncedAccounts": "0x0",
15    "syncedBytecodeBytes": "0x0",
16    "syncedBytecodes": "0x0",
17    "syncedStorage": "0x0",
18    "syncedStorageBytes": "0x0"
19  }
20}

جبکہ Besu لوٹاتا ہے:

1{
2  "jsonrpc": "2.0",
3  "id": 51,
4  "result": {
5    "startingBlock": "0x0",
6    "currentBlock": "0x1518",
7    "highestBlock": "0x9567a3",
8    "pulledStates": "0x203ca",
9    "knownStates": "0x200636"
10  }
11}

مزید تفصیلات کے لیے اپنے مخصوص کلائنٹ کی دستاویزات سے رجوع کریں۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": {
8    startingBlock: '0x384',
9    currentBlock: '0x386',
10    highestBlock: '0x454'
11  }
12}
13// یا جب سنک نہ ہو رہا ہو
14{
15  "id":1,
16  "jsonrpc": "2.0",
17  "result": false
18}

eth_coinbase

کلائنٹ کا کوائن بیس (coinbase) ایڈریس لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

نوٹ: یہ طریقہ v1.14.0 کے بعد سے متروک (deprecated) کر دیا گیا ہے اور اب تعاون یافتہ نہیں ہے۔ اس طریقے کو استعمال کرنے کی کوشش کے نتیجے میں "Method not supported" کی خرابی ظاہر ہوگی۔

پیرامیٹرز

کوئی نہیں

واپسی

DATA، 20 بائٹس - موجودہ کوائن بیس ایڈریس۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
3// نتیجہ
4{
5  "id":64,
6  "jsonrpc": "2.0",
7  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
8}

eth_chainId

ری پلے سے محفوظ (replay-protected) ٹرانزیکشنز پر دستخط کرنے کے لیے استعمال ہونے والی چین آئی ڈی (chain ID) لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

کوئی نہیں

واپسی

chainId، ایک سٹرنگ کے طور پر ہیکسا ڈیسیمل ویلیو جو موجودہ چین آئی ڈی کے انٹیجر کی نمائندگی کرتی ہے۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
3// نتیجہ
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "0x1"
8}

eth_mining

اگر کلائنٹ فعال طور پر نئے بلاکس کی مائننگ کر رہا ہے تو true لوٹاتا ہے۔ یہ صرف پروف-آف-ورک (proof-of-work) نیٹ ورکس کے لیے true لوٹا سکتا ہے اور The Merge کے بعد سے کچھ کلائنٹس میں دستیاب نہیں ہو سکتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

کوئی نہیں

واپسی

Boolean - اگر کلائنٹ مائننگ کر رہا ہے تو true لوٹاتا ہے، بصورت دیگر false۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
3
4{
5  "id":71,
6  "jsonrpc": "2.0",
7  "result": true
8}

eth_hashrate

فی سیکنڈ ہیشز کی تعداد لوٹاتا ہے جس کے ساتھ نوڈ مائننگ کر رہا ہے۔ یہ صرف پروف-آف-ورک نیٹ ورکس کے لیے true لوٹا سکتا ہے اور The Merge کے بعد سے کچھ کلائنٹس میں دستیاب نہیں ہو سکتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

کوئی نہیں

واپسی

QUANTITY - فی سیکنڈ ہیشز کی تعداد۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
3// نتیجہ
4{
5  "id":71,
6  "jsonrpc": "2.0",
7  "result": "0x38a"
8}

eth_gasPrice

wei میں فی گیس کی موجودہ قیمت کا تخمینہ لوٹاتا ہے۔ مثال کے طور پر، Besu کلائنٹ پچھلے 100 بلاکس کا جائزہ لیتا ہے اور پہلے سے طے شدہ طور پر درمیانی گیس یونٹ کی قیمت لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

کوئی نہیں

واپسی

QUANTITY - wei میں موجودہ گیس کی قیمت کا انٹیجر۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
3// نتیجہ
4{
5  "id":73,
6  "jsonrpc": "2.0",
7  "result": "0x1dfd14000" // 8049999872 Wei
8}

eth_accounts

کلائنٹ کی ملکیت والے ایڈریسز کی فہرست لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

کوئی نہیں

واپسی

Array of DATA، 20 بائٹس - کلائنٹ کی ملکیت والے ایڈریسز۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
8}

eth_blockNumber

سب سے حالیہ بلاک کا نمبر لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

کوئی نہیں

واپسی

QUANTITY - موجودہ بلاک نمبر کا انٹیجر جس پر کلائنٹ ہے۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
3// نتیجہ
4{
5  "id":83,
6  "jsonrpc": "2.0",
7  "result": "0x4b7" // 1207
8}

eth_getBalance

کسی دیے گئے ایڈریس پر اکاؤنٹ کا بیلنس لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 20 بائٹس - وہ ایڈریس جس کا بیلنس چیک کرنا ہے۔
QUANTITY|TAG - انٹیجر بلاک نمبر، یا سٹرنگ "latest"، "earliest"، "pending"، "safe"، یا "finalized"، دیکھیں بلاک پیرامیٹر

1params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]

واپسی

QUANTITY - wei میں موجودہ بیلنس کا انٹیجر۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x0234c8a3397aab58" // 158972490234375000
8}

eth_getStorageAt

کسی دیے گئے ایڈریس پر سٹوریج کی پوزیشن سے ویلیو لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 20 بائٹس - سٹوریج کا ایڈریس۔
QUANTITY - سٹوریج میں پوزیشن کا انٹیجر۔
QUANTITY|TAG - انٹیجر بلاک نمبر، یا سٹرنگ "latest"، "earliest"، "pending"، "safe"، "finalized"، دیکھیں بلاک پیرامیٹر

واپسی

DATA - اس سٹوریج پوزیشن پر ویلیو۔

مثال درست پوزیشن کا حساب لگانا اس سٹوریج پر منحصر ہے جسے بازیافت کرنا ہے۔ ایڈریس 0x391694e7e0b0cce554cb130d723a9d27458f9298 کے ذریعے 0x295a70b2de5e3953354a6a8344e616ed314d7251 پر تعینات کیے گئے درج ذیل کنٹریکٹ پر غور کریں۔

1contract Storage {
2    uint pos0;
3    mapping(address => uint) pos1;
4    constructor() {
5        pos0 = 1234;
6        pos1[msg.sender] = 5678;
7    }
8}

pos0 کی ویلیو بازیافت کرنا سیدھا سا ہے:

1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
2{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}

میپ (map) کے کسی عنصر کو بازیافت کرنا مشکل ہے۔ میپ میں کسی عنصر کی پوزیشن کا حساب اس طرح لگایا جاتا ہے:

1keccak(LeftPad32(key, 0), LeftPad32(map position, 0))

اس کا مطلب ہے کہ pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] پر سٹوریج بازیافت کرنے کے لیے ہمیں اس کے ساتھ پوزیشن کا حساب لگانے کی ضرورت ہے:

1keccak(
2  decodeHex(
3    "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
4      "0000000000000000000000000000000000000000000000000000000000000001"
5  )
6)

geth کنسول جو web3 لائبریری کے ساتھ آتا ہے، حساب لگانے کے لیے استعمال کیا جا سکتا ہے:

1> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"
2undefined
3> web3.sha3(key, {"encoding": "hex"})
4"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"

اب سٹوریج لانے کے لیے:

1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
2{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}

eth_getTransactionCount

کسی ایڈریس سے بھیجی گئی ٹرانزیکشنز کی تعداد لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 20 بائٹس - ایڈریس۔
QUANTITY|TAG - انٹیجر بلاک نمبر، یا سٹرنگ "latest"، "earliest"، "pending"، "safe" یا "finalized"، دیکھیں بلاک پیرامیٹر

1params: [
2  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
3  "latest", // تازہ ترین بلاک پر حالت
4]

واپسی

QUANTITY - اس ایڈریس سے بھیجی گئی ٹرانزیکشنز کی تعداد کا انٹیجر۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x1" // 1
8}

eth_getBlockTransactionCountByHash

دیے گئے بلاک ہیش سے مماثل بلاک میں ٹرانزیکشنز کی تعداد لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 32 بائٹس - بلاک کا ہیش

1params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]

واپسی

QUANTITY - اس بلاک میں ٹرانزیکشنز کی تعداد کا انٹیجر۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x8b" // 139
8}

eth_getBlockTransactionCountByNumber

دیے گئے بلاک نمبر سے مماثل بلاک میں ٹرانزیکشنز کی تعداد لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

QUANTITY|TAG - بلاک نمبر کا انٹیجر، یا سٹرنگ "earliest"، "latest"، "pending"، "safe" یا "finalized"، جیسا کہ بلاک پیرامیٹر میں ہے۔

1params: [
2  "0x13738ca", // 20396234
3]

واپسی

QUANTITY - اس بلاک میں ٹرانزیکشنز کی تعداد کا انٹیجر۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x8b" // 139
8}

eth_getUncleCountByBlockHash

دیے گئے بلاک ہیش سے مماثل بلاک میں انکلز (uncles) کی تعداد لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 32 بائٹس - بلاک کا ہیش

1params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]

واپسی

QUANTITY - اس بلاک میں انکلز کی تعداد کا انٹیجر۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x1" // 1
8}

eth_getUncleCountByBlockNumber

دیے گئے بلاک نمبر سے مماثل بلاک میں انکلز کی تعداد لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

QUANTITY|TAG - بلاک نمبر کا انٹیجر، یا سٹرنگ "latest"، "earliest"، "pending"، "safe" یا "finalized"، دیکھیں بلاک پیرامیٹر

1params: [
2  "0xe8", // 232
3]

واپسی

QUANTITY - اس بلاک میں انکلز کی تعداد کا انٹیجر۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x0" // 0
8}

eth_getCode

کسی دیے گئے ایڈریس پر کوڈ لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 20 بائٹس - ایڈریس
QUANTITY|TAG - انٹیجر بلاک نمبر، یا سٹرنگ "latest"، "earliest"، "pending"، "safe" یا "finalized"، دیکھیں بلاک پیرامیٹر

1params: [
2  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
3  "0x5daf3b", // 6139707
4]

واپسی

DATA - دیے گئے ایڈریس سے کوڈ۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
8}

eth_sign

سائن (sign) کا طریقہ اس کے ساتھ ایک Ethereum مخصوص دستخط کا حساب لگاتا ہے: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)))۔

پیغام میں ایک سابقہ (prefix) شامل کرنے سے حسابی دستخط کو Ethereum کے مخصوص دستخط کے طور پر پہچانا جا سکتا ہے۔ یہ اس غلط استعمال کو روکتا ہے جہاں ایک بدنیتی پر مبنی ڈیپ (dapp) صوابدیدی ڈیٹا (جیسے، ٹرانزیکشن) پر دستخط کر سکتی ہے اور متاثرہ شخص کا روپ دھارنے کے لیے دستخط کا استعمال کر سکتی ہے۔

نوٹ: جس ایڈریس سے دستخط کرنا ہے اسے ان لاک (unlocked) ہونا چاہیے۔

پیرامیٹرز

DATA، 20 بائٹس - ایڈریس
DATA، N بائٹس - دستخط کرنے کے لیے پیغام

واپسی

DATA: دستخط

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}

eth_signTransaction

ایک ٹرانزیکشن پر دستخط کرتا ہے جسے بعد میں eth_sendRawTransaction کا استعمال کرتے ہوئے نیٹ ورک پر جمع کرایا جا سکتا ہے۔

پیرامیٹرز

Object - ٹرانزیکشن آبجیکٹ

type:
from: DATA، 20 بائٹس - وہ ایڈریس جہاں سے ٹرانزیکشن بھیجی گئی ہے۔
to: DATA، 20 بائٹس - (نیا کنٹریکٹ بناتے وقت اختیاری) وہ ایڈریس جس پر ٹرانزیکشن بھیجی گئی ہے۔
gas: QUANTITY - (اختیاری، ڈیفالٹ: 90000) ٹرانزیکشن پر عمل درآمد کے لیے فراہم کردہ گیس کا انٹیجر۔ یہ غیر استعمال شدہ گیس واپس کر دے گا۔
gasPrice: QUANTITY - (اختیاری، ڈیفالٹ: To-Be-Determined) ہر ادا شدہ گیس کے لیے استعمال ہونے والی gasPrice کا انٹیجر، Wei میں۔
value: QUANTITY - (اختیاری) اس ٹرانزیکشن کے ساتھ بھیجی گئی ویلیو کا انٹیجر، Wei میں۔
data: DATA - کسی کنٹریکٹ کا مرتب شدہ (compiled) کوڈ یا طلب کیے گئے طریقہ کار کے دستخط اور انکوڈ شدہ پیرامیٹرز کا ہیش۔
nonce: QUANTITY - (اختیاری) نانس (nonce) کا انٹیجر۔ یہ آپ کو اپنی زیر التواء ٹرانزیکشنز کو اوور رائٹ کرنے کی اجازت دیتا ہے جو ایک ہی نانس استعمال کرتی ہیں۔

واپسی

DATA، مخصوص اکاؤنٹ کے ذریعے دستخط شدہ RLP-انکوڈ شدہ ٹرانزیکشن آبجیکٹ۔

مثال

1// درخواست
2curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
3// نتیجہ
4{
5    "id": 1,
6    "jsonrpc": "2.0",
7    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}

eth_sendTransaction

نئی میسج کال ٹرانزیکشن یا کنٹریکٹ کی تخلیق کرتا ہے، اگر ڈیٹا فیلڈ میں کوڈ موجود ہو، اور from میں بتائے گئے اکاؤنٹ کا استعمال کرتے ہوئے اس پر دستخط کرتا ہے۔

پیرامیٹرز

Object - ٹرانزیکشن آبجیکٹ

from: DATA، 20 بائٹس - وہ ایڈریس جہاں سے ٹرانزیکشن بھیجی گئی ہے۔
to: DATA، 20 بائٹس - (نیا کنٹریکٹ بناتے وقت اختیاری) وہ ایڈریس جس پر ٹرانزیکشن بھیجی گئی ہے۔
gas: QUANTITY - (اختیاری، ڈیفالٹ: 90000) ٹرانزیکشن پر عمل درآمد کے لیے فراہم کردہ گیس کا انٹیجر۔ یہ غیر استعمال شدہ گیس واپس کر دے گا۔
gasPrice: QUANTITY - (اختیاری، ڈیفالٹ: To-Be-Determined) ہر ادا شدہ گیس کے لیے استعمال ہونے والی gasPrice کا انٹیجر۔
value: QUANTITY - (اختیاری) اس ٹرانزیکشن کے ساتھ بھیجی گئی ویلیو کا انٹیجر۔
input: DATA - کسی کنٹریکٹ کا مرتب شدہ کوڈ یا طلب کیے گئے طریقہ کار کے دستخط اور انکوڈ شدہ پیرامیٹرز کا ہیش۔
nonce: QUANTITY - (اختیاری) نانس کا انٹیجر۔ یہ آپ کو اپنی زیر التواء ٹرانزیکشنز کو اوور رائٹ کرنے کی اجازت دیتا ہے جو ایک ہی نانس استعمال کرتی ہیں۔

1params: [
2  {
3    from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
4    to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
5    gas: "0x76c0", // 30400
6    gasPrice: "0x9184e72a000", // 10000000000000
7    value: "0x9184e72a", // 2441406250
8    input:
9      "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
10  },
11]

واپسی

DATA، 32 بائٹس - ٹرانزیکشن ہیش، یا صفر ہیش اگر ٹرانزیکشن ابھی دستیاب نہیں ہے۔

جب آپ نے کوئی کنٹریکٹ بنایا ہو، تو بلاک میں ٹرانزیکشن تجویز کیے جانے کے بعد، کنٹریکٹ کا ایڈریس حاصل کرنے کے لیے eth_getTransactionReceipt کا استعمال کریں۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}

eth_sendRawTransaction

دستخط شدہ ٹرانزیکشنز کے لیے نئی میسج کال ٹرانزیکشن یا کنٹریکٹ کی تخلیق کرتا ہے۔

پیرامیٹرز

DATA، دستخط شدہ ٹرانزیکشن کا ڈیٹا۔

1params: [
2  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
3]

واپسی

DATA، 32 بائٹس - ٹرانزیکشن ہیش، یا صفر ہیش اگر ٹرانزیکشن ابھی دستیاب نہیں ہے۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}

eth_call

بلاک چین پر ٹرانزیکشن بنائے بغیر فوری طور پر ایک نئی میسج کال پر عمل درآمد کرتا ہے۔ اکثر صرف پڑھنے کے لیے (read-only) سمارٹ کنٹریکٹ فنکشنز کو چلانے کے لیے استعمال کیا جاتا ہے، مثال کے طور پر ERC-20 کنٹریکٹ کے لیے balanceOf۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

Object - ٹرانزیکشن کال آبجیکٹ

from: DATA، 20 بائٹس - (اختیاری) وہ ایڈریس جہاں سے ٹرانزیکشن بھیجی گئی ہے۔
to: DATA، 20 بائٹس - وہ ایڈریس جس پر ٹرانزیکشن بھیجی گئی ہے۔
gas: QUANTITY - (اختیاری) ٹرانزیکشن پر عمل درآمد کے لیے فراہم کردہ گیس کا انٹیجر۔ eth_call صفر گیس استعمال کرتا ہے، لیکن کچھ عمل درآمد کے لیے اس پیرامیٹر کی ضرورت ہو سکتی ہے۔
gasPrice: QUANTITY - (اختیاری) ہر ادا شدہ گیس کے لیے استعمال ہونے والی gasPrice کا انٹیجر
value: QUANTITY - (اختیاری) اس ٹرانزیکشن کے ساتھ بھیجی گئی ویلیو کا انٹیجر
input: DATA - (اختیاری) طریقہ کار کے دستخط اور انکوڈ شدہ پیرامیٹرز کا ہیش۔ تفصیلات کے لیے Solidity دستاویزات میں Ethereum Contract ABI (opens in a new tab) دیکھیں۔

QUANTITY|TAG - انٹیجر بلاک نمبر، یا سٹرنگ "latest"، "earliest"، "pending"، "safe" یا "finalized"، دیکھیں بلاک پیرامیٹر

واپسی

DATA - عمل میں لائے گئے کنٹریکٹ کی واپسی کی ویلیو۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x"
8}

eth_estimateGas

اس بات کا تخمینہ تیار کرتا ہے اور لوٹاتا ہے کہ ٹرانزیکشن کو مکمل ہونے دینے کے لیے کتنی گیس ضروری ہے۔ ٹرانزیکشن کو بلاک چین میں شامل نہیں کیا جائے گا۔ نوٹ کریں کہ یہ تخمینہ ٹرانزیکشن کے ذریعے اصل میں استعمال ہونے والی گیس کی مقدار سے نمایاں طور پر زیادہ ہو سکتا ہے، جس کی مختلف وجوہات ہیں جن میں EVM میکینکس اور نوڈ کی کارکردگی شامل ہیں۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

eth_call کے پیرامیٹرز دیکھیں، سوائے اس کے کہ تمام خصوصیات اختیاری ہیں۔ اگر گیس کی کوئی حد متعین نہیں کی گئی ہے تو geth زیر التواء بلاک سے بلاک گیس کی حد کو اوپری حد کے طور پر استعمال کرتا ہے۔ نتیجے کے طور پر، جب گیس کی مقدار زیر التواء بلاک گیس کی حد سے زیادہ ہو تو لوٹایا گیا تخمینہ کال/ٹرانزیکشن پر عمل درآمد کے لیے کافی نہیں ہو سکتا ہے۔

واپسی

QUANTITY - استعمال شدہ گیس کی مقدار۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x5208" // 21000
8}

eth_getBlockByHash

ہیش کے ذریعے بلاک کے بارے میں معلومات لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 32 بائٹس - بلاک کا ہیش۔
Boolean - اگر true ہے تو یہ مکمل ٹرانزیکشن آبجیکٹس لوٹاتا ہے، اگر false ہے تو صرف ٹرانزیکشنز کے ہیشز۔

1params: [
2  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
3  false,
4]

واپسی

Object - ایک بلاک آبجیکٹ، یا null جب کوئی بلاک نہیں ملا:

number: QUANTITY - بلاک نمبر۔ null جب یہ زیر التواء بلاک ہو۔
hash: DATA، 32 بائٹس - بلاک کا ہیش۔ null جب یہ زیر التواء بلاک ہو۔
parentHash: DATA، 32 بائٹس - پیرنٹ (parent) بلاک کا ہیش۔
nonce: DATA، 8 بائٹس - تیار کردہ پروف-آف-ورک کا ہیش۔ null جب یہ زیر التواء بلاک ہو، پروف-آف-اسٹیک (proof-of-stake) بلاکس کے لیے 0x0 (The Merge کے بعد سے)
sha3Uncles: DATA، 32 بائٹس - بلاک میں انکلز کے ڈیٹا کا SHA3۔
logsBloom: DATA، 256 بائٹس - بلاک کے لاگز (logs) کے لیے بلوم فلٹر (bloom filter)۔ null جب یہ زیر التواء بلاک ہو۔
transactionsRoot: DATA، 32 بائٹس - بلاک کی ٹرانزیکشن ٹرائی (trie) کا روٹ (root)۔
stateRoot: DATA، 32 بائٹس - بلاک کی حتمی اسٹیٹ (state) ٹرائی کا روٹ۔
receiptsRoot: DATA، 32 بائٹس - بلاک کی رسیدوں (receipts) کی ٹرائی کا روٹ۔
miner: DATA، 20 بائٹس - اس مستفید ہونے والے کا ایڈریس جسے بلاک کے انعامات دیے گئے تھے۔
difficulty: QUANTITY - اس بلاک کے لیے مشکل (difficulty) کا انٹیجر۔
totalDifficulty: QUANTITY - اس بلاک تک چین کی کل مشکل کا انٹیجر۔
extraData: DATA - اس بلاک کی "اضافی ڈیٹا" فیلڈ۔
size: QUANTITY - بائٹس میں اس بلاک کے سائز کا انٹیجر۔
gasLimit: QUANTITY - اس بلاک میں زیادہ سے زیادہ گیس کی اجازت۔
gasUsed: QUANTITY - اس بلاک میں تمام ٹرانزیکشنز کے ذریعے استعمال ہونے والی کل گیس۔
timestamp: QUANTITY - یونکس ٹائم اسٹیمپ (unix timestamp) جب بلاک کو مرتب کیا گیا تھا۔
transactions: Array - ٹرانزیکشن آبجیکٹس کی Array، یا آخری دیے گئے پیرامیٹر کے لحاظ سے 32 بائٹس کے ٹرانزیکشن ہیشز۔
uncles: Array - انکل ہیشز کی Array۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
3// نتیجہ
4{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "result": {
8    "difficulty": "0x4ea3f27bc",
9    "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
10    "gasLimit": "0x1388",
11    "gasUsed": "0x0",
12    "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
13    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
14    "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
15    "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
16    "nonce": "0x689056015818adbe",
17    "number": "0x1b4",
18    "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
19    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
20    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
21    "size": "0x220",
22    "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
23    "timestamp": "0x55ba467c",
24    "totalDifficulty": "0x78ed983323d",
25    "transactions": [
26    ],
27    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
28    "uncles": [
29    ]
30  }
31}

eth_getBlockByNumber

بلاک نمبر کے ذریعے بلاک کے بارے میں معلومات لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

QUANTITY|TAG - بلاک نمبر کا انٹیجر، یا سٹرنگ "earliest"، "latest"، "pending"، "safe" یا "finalized"، جیسا کہ بلاک پیرامیٹر میں ہے۔
Boolean - اگر true ہے تو یہ مکمل ٹرانزیکشن آبجیکٹس لوٹاتا ہے، اگر false ہے تو صرف ٹرانزیکشنز کے ہیشز۔

1params: [
2  "0x1b4", // 436
3  true,
4]

واپسی دیکھیں eth_getBlockByHash

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'

نتیجہ دیکھیں eth_getBlockByHash

eth_getTransactionByHash

ٹرانزیکشن ہیش کے ذریعے درخواست کردہ ٹرانزیکشن کے بارے میں معلومات لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 32 بائٹس - ٹرانزیکشن کا ہیش

1params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

واپسی

Object - ایک ٹرانزیکشن آبجیکٹ، یا null جب کوئی ٹرانزیکشن نہیں ملی:

blockHash: DATA، 32 بائٹس - اس بلاک کا ہیش جہاں یہ ٹرانزیکشن تھی۔ null جب یہ زیر التواء ہو۔
blockNumber: QUANTITY - وہ بلاک نمبر جہاں یہ ٹرانزیکشن تھی۔ null جب یہ زیر التواء ہو۔
from: DATA، 20 بائٹس - بھیجنے والے کا ایڈریس۔
gas: QUANTITY - بھیجنے والے کی طرف سے فراہم کردہ گیس۔
gasPrice: QUANTITY - بھیجنے والے کی طرف سے Wei میں فراہم کردہ گیس کی قیمت۔
hash: DATA، 32 بائٹس - ٹرانزیکشن کا ہیش۔
input: DATA - ٹرانزیکشن کے ساتھ بھیجا گیا ڈیٹا۔
nonce: QUANTITY - اس سے پہلے بھیجنے والے کی طرف سے کی گئی ٹرانزیکشنز کی تعداد۔
to: DATA، 20 بائٹس - وصول کنندہ کا ایڈریس۔ null جب یہ کنٹریکٹ بنانے کی ٹرانزیکشن ہو۔
transactionIndex: QUANTITY - بلاک میں ٹرانزیکشنز کی انڈیکس پوزیشن کا انٹیجر۔ null جب یہ زیر التواء ہو۔
value: QUANTITY - Wei میں منتقل کی گئی ویلیو۔
v: QUANTITY - ECDSA ریکوری آئی ڈی
r: QUANTITY - ECDSA دستخط r
s: QUANTITY - ECDSA دستخط s

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
3// نتیجہ
4{
5  "jsonrpc":"2.0",
6  "id":1,
7  "result":{
8    "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
9    "blockNumber":"0x5daf3b", // 6139707
10    "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",
11    "gas":"0xc350", // 50000
12    "gasPrice":"0x4a817c800", // 20000000000
13    "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
14    "input":"0x68656c6c6f21",
15    "nonce":"0x15", // 21
16    "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",
17    "transactionIndex":"0x41", // 65
18    "value":"0xf3dbb76162000", // 4290000000000000
19    "v":"0x25", // 37
20    "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",
21    "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"
22  }
23}

eth_getTransactionByBlockHashAndIndex

بلاک ہیش اور ٹرانزیکشن انڈیکس پوزیشن کے ذریعے ٹرانزیکشن کے بارے میں معلومات لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 32 بائٹس - بلاک کا ہیش۔
QUANTITY - ٹرانزیکشن انڈیکس پوزیشن کا انٹیجر۔

1params: [
2  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
3  "0x0", // 0
4]

واپسی دیکھیں eth_getTransactionByHash

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

نتیجہ دیکھیں eth_getTransactionByHash

eth_getTransactionByBlockNumberAndIndex

بلاک نمبر اور ٹرانزیکشن انڈیکس پوزیشن کے ذریعے ٹرانزیکشن کے بارے میں معلومات لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

QUANTITY|TAG - ایک بلاک نمبر، یا سٹرنگ "earliest"، "latest"، "pending"، "safe" یا "finalized"، جیسا کہ بلاک پیرامیٹر میں ہے۔
QUANTITY - ٹرانزیکشن انڈیکس پوزیشن۔

1params: [
2  "0x9c47cf", // 10241999
3  "0x24", // 36
4]

واپسی دیکھیں eth_getTransactionByHash

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'

نتیجہ دیکھیں eth_getTransactionByHash

eth_getTransactionReceipt

ٹرانزیکشن ہیش کے ذریعے ٹرانزیکشن کی رسید لوٹاتا ہے۔

نوٹ کہ زیر التواء ٹرانزیکشنز کے لیے رسید دستیاب نہیں ہے۔

پیرامیٹرز

DATA، 32 بائٹس - ٹرانزیکشن کا ہیش

1params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]

واپسی Object - ایک ٹرانزیکشن رسید آبجیکٹ، یا null جب کوئی رسید نہیں ملی:

transactionHash : DATA، 32 بائٹس - ٹرانزیکشن کا ہیش۔
transactionIndex: QUANTITY - بلاک میں ٹرانزیکشنز کی انڈیکس پوزیشن کا انٹیجر۔
blockHash: DATA، 32 بائٹس - اس بلاک کا ہیش جہاں یہ ٹرانزیکشن تھی۔
blockNumber: QUANTITY - وہ بلاک نمبر جہاں یہ ٹرانزیکشن تھی۔
from: DATA، 20 بائٹس - بھیجنے والے کا ایڈریس۔
to: DATA، 20 بائٹس - وصول کنندہ کا ایڈریس۔ null جب یہ کنٹریکٹ بنانے کی ٹرانزیکشن ہو۔
cumulativeGasUsed : QUANTITY - جب یہ ٹرانزیکشن بلاک میں عمل میں لائی گئی تو استعمال ہونے والی گیس کی کل مقدار۔
effectiveGasPrice : QUANTITY - گیس کی فی یونٹ ادا کی گئی بنیادی فیس اور ٹپ کا مجموعہ۔
gasUsed : QUANTITY - صرف اس مخصوص ٹرانزیکشن کے ذریعے استعمال ہونے والی گیس کی مقدار۔
contractAddress : DATA، 20 بائٹس - بنایا گیا کنٹریکٹ ایڈریس، اگر ٹرانزیکشن کنٹریکٹ کی تخلیق تھی، بصورت دیگر null۔
logs: Array - لاگ آبجیکٹس کی Array، جو اس ٹرانزیکشن نے تیار کیے۔
logsBloom: DATA، 256 بائٹس - لائٹ کلائنٹس کے لیے متعلقہ لاگز کو تیزی سے بازیافت کرنے کے لیے بلوم فلٹر۔
type: QUANTITY - ٹرانزیکشن کی قسم کا انٹیجر، پرانی (legacy) ٹرانزیکشنز کے لیے 0x0، ایکسیس لسٹ (access list) کی اقسام کے لیے 0x1، متحرک فیس (dynamic fees) کے لیے 0x2۔

یہ یا تو یہ بھی لوٹاتا ہے:

root : DATA ٹرانزیکشن کے بعد کی اسٹیٹ روٹ کے 32 بائٹس (Byzantium سے پہلے)
status: QUANTITY یا تو 1 (کامیابی) یا 0 (ناکامی)

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'
3// نتیجہ
4{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "result": {
8    "blockHash":
9      "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",
10    "blockNumber": "0xeff35f",
11    "contractAddress": null, // ایڈریس کی سٹرنگ اگر یہ بنایا گیا تھا
12    "cumulativeGasUsed": "0xa12515",
13    "effectiveGasPrice": "0x5a9c688d4",
14    "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",
15    "gasUsed": "0xb4c8",
16    "logs": [{
17      // لاگز جیسا کہ getFilterLogs وغیرہ کے ذریعے واپس کیے گئے ہیں
18    }],
19    "logsBloom": "0x00...0", // 256 بائٹ بلوم فلٹر
20    "status": "0x1",
21    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
22    "transactionHash":
23      "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",
24    "transactionIndex": "0x66",
25    "type": "0x2"
26  }
27}

eth_getUncleByBlockHashAndIndex

ہیش اور انکل انڈیکس پوزیشن کے ذریعے بلاک کے انکل کے بارے میں معلومات لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

DATA، 32 بائٹس - بلاک کا ہیش۔
QUANTITY - انکل کی انڈیکس پوزیشن۔

1params: [
2  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
3  "0x0", // 0
4]

واپسی دیکھیں eth_getBlockByHash

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

نتیجہ دیکھیں eth_getBlockByHash

نوٹ: ایک انکل میں انفرادی ٹرانزیکشنز شامل نہیں ہوتیں۔

eth_getUncleByBlockNumberAndIndex

نمبر اور انکل انڈیکس پوزیشن کے ذریعے بلاک کے انکل کے بارے میں معلومات لوٹاتا ہے۔

پلے گراؤنڈ میں اینڈ پوائنٹ آزمائیں

پیرامیٹرز

QUANTITY|TAG - ایک بلاک نمبر، یا سٹرنگ "earliest"، "latest"، "pending"، "safe"، "finalized"، جیسا کہ بلاک پیرامیٹر میں ہے۔
QUANTITY - انکل کی انڈیکس پوزیشن۔

1params: [
2  "0x29c", // 668
3  "0x0", // 0
4]

واپسی دیکھیں eth_getBlockByHash

نوٹ: ایک انکل میں انفرادی ٹرانزیکشنز شامل نہیں ہوتیں۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'

نتیجہ دیکھیں eth_getBlockByHash

eth_newFilter

اسٹیٹ تبدیل ہونے (لاگز) پر مطلع کرنے کے لیے، فلٹر کے اختیارات کی بنیاد پر ایک فلٹر آبجیکٹ بناتا ہے۔ یہ چیک کرنے کے لیے کہ آیا اسٹیٹ تبدیل ہوئی ہے، eth_getFilterChanges کو کال کریں۔

موضوع (topic) کے فلٹرز کی وضاحت پر ایک نوٹ: موضوعات ترتیب پر منحصر ہیں۔ [A, B] موضوعات والے لاگ کے ساتھ ایک ٹرانزیکشن درج ذیل موضوع کے فلٹرز سے مماثل ہوگی:

[] "کچھ بھی"
[A] "پہلی پوزیشن میں A (اور اس کے بعد کچھ بھی)"
[null, B] "پہلی پوزیشن میں کچھ بھی اور دوسری پوزیشن میں B (اور اس کے بعد کچھ بھی)"
[A, B] "پہلی پوزیشن میں A اور دوسری پوزیشن میں B (اور اس کے بعد کچھ بھی)"
[[A, B], [A, B]] "پہلی پوزیشن میں (A یا B) اور دوسری پوزیشن میں (A یا B) (اور اس کے بعد کچھ بھی)"
پیرامیٹرز

Object - فلٹر کے اختیارات:

fromBlock: QUANTITY|TAG - (اختیاری، ڈیفالٹ: "latest") انٹیجر بلاک نمبر، یا آخری تجویز کردہ بلاک کے لیے "latest"، تازہ ترین محفوظ بلاک کے لیے "safe"، تازہ ترین حتمی بلاک کے لیے "finalized"، یا ان ٹرانزیکشنز کے لیے "pending"، "earliest" جو ابھی تک کسی بلاک میں نہیں ہیں۔
toBlock: QUANTITY|TAG - (اختیاری، ڈیفالٹ: "latest") انٹیجر بلاک نمبر، یا آخری تجویز کردہ بلاک کے لیے "latest"، تازہ ترین محفوظ بلاک کے لیے "safe"، تازہ ترین حتمی بلاک کے لیے "finalized"، یا ان ٹرانزیکشنز کے لیے "pending"، "earliest" جو ابھی تک کسی بلاک میں نہیں ہیں۔
address: DATA|Array، 20 بائٹس - (اختیاری) کنٹریکٹ کا ایڈریس یا ان ایڈریسز کی فہرست جہاں سے لاگز شروع ہونے چاہئیں۔
topics: Array of DATA، - (اختیاری) 32 بائٹس DATA موضوعات کی Array۔ موضوعات ترتیب پر منحصر ہیں۔ ہر موضوع "یا" (or) کے اختیارات کے ساتھ DATA کی ایک Array بھی ہو سکتا ہے۔

1params: [
2  {
3    fromBlock: "0x1",
4    toBlock: "0x2",
5    address: "0x8888f1f195afa192cfee860698584c030f4c9db1",
6    topics: [
7      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
8      null,
9      [
10        "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
11        "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc",
12      ],
13    ],
14  },
15]

واپسی QUANTITY - ایک فلٹر آئی ڈی۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x1" // 1
8}

eth_newBlockFilter

نیا بلاک آنے پر مطلع کرنے کے لیے، نوڈ میں ایک فلٹر بناتا ہے۔ یہ چیک کرنے کے لیے کہ آیا اسٹیٹ تبدیل ہوئی ہے، eth_getFilterChanges کو کال کریں۔

پیرامیٹرز کوئی نہیں

واپسی QUANTITY - ایک فلٹر آئی ڈی۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc":  "2.0",
7  "result": "0x1" // 1
8}

eth_newPendingTransactionFilter

نئی زیر التواء ٹرانزیکشنز آنے پر مطلع کرنے کے لیے، نوڈ میں ایک فلٹر بناتا ہے۔ یہ چیک کرنے کے لیے کہ آیا اسٹیٹ تبدیل ہوئی ہے، eth_getFilterChanges کو کال کریں۔

پیرامیٹرز کوئی نہیں

واپسی QUANTITY - ایک فلٹر آئی ڈی۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc":  "2.0",
7  "result": "0x1" // 1
8}

eth_uninstallFilter

دی گئی آئی ڈی کے ساتھ فلٹر کو ان انسٹال کرتا ہے۔ جب مزید نگرانی (watch) کی ضرورت نہ ہو تو اسے ہمیشہ کال کیا جانا چاہیے۔ مزید برآں، جب ایک مدت تک eth_getFilterChanges کے ساتھ فلٹرز کی درخواست نہیں کی جاتی ہے تو وہ ٹائم آؤٹ (timeout) ہو جاتے ہیں۔

پیرامیٹرز

QUANTITY - فلٹر آئی ڈی۔

1params: [
2  "0xb", // 11
3]

واپسی Boolean - اگر فلٹر کامیابی سے ان انسٹال ہو گیا تو true، بصورت دیگر false۔

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": true
8}

eth_getFilterChanges

فلٹر کے لیے پولنگ (polling) کا طریقہ، جو پچھلے پول کے بعد سے ہونے والے لاگز کی ایک Array لوٹاتا ہے۔

پیرامیٹرز

QUANTITY - فلٹر آئی ڈی۔

1params: [
2  "0x16", // 22
3]

واپسی Array - لاگ آبجیکٹس کی Array، یا ایک خالی Array اگر پچھلے پول کے بعد سے کچھ نہیں بدلا ہے۔

eth_newBlockFilter کے ساتھ بنائے گئے فلٹرز کے لیے واپسی بلاک ہیشز (DATA، 32 بائٹس) ہیں، جیسے، ["0x3454645634534..."]۔
eth_newPendingTransactionFilter کے ساتھ بنائے گئے فلٹرز کے لیے واپسی ٹرانزیکشن ہیشز (DATA، 32 بائٹس) ہیں، جیسے، ["0x6345343454645..."]۔
eth_newFilter کے ساتھ بنائے گئے فلٹرز کے لیے لاگز درج ذیل پیرامیٹرز کے ساتھ آبجیکٹس ہیں:
- removed: TAG - true جب چین کی تنظیم نو کی وجہ سے لاگ کو ہٹا دیا گیا تھا۔ false اگر یہ ایک درست لاگ ہے۔
- logIndex: QUANTITY - بلاک میں لاگ انڈیکس پوزیشن کا انٹیجر۔ null جب یہ زیر التواء لاگ ہو۔
- transactionIndex: QUANTITY - ٹرانزیکشنز کی انڈیکس پوزیشن کا انٹیجر جہاں سے لاگ بنایا گیا تھا۔ null جب یہ زیر التواء لاگ ہو۔
- transactionHash: DATA، 32 بائٹس - ان ٹرانزیکشنز کا ہیش جہاں سے یہ لاگ بنایا گیا تھا۔ null جب یہ زیر التواء لاگ ہو۔
- blockHash: DATA، 32 بائٹس - اس بلاک کا ہیش جہاں یہ لاگ تھا۔ null جب یہ زیر التواء ہو۔ null جب یہ زیر التواء لاگ ہو۔
- blockNumber: QUANTITY - وہ بلاک نمبر جہاں یہ لاگ تھا۔ null جب یہ زیر التواء ہو۔ null جب یہ زیر التواء لاگ ہو۔
- address: DATA، 20 بائٹس - وہ ایڈریس جہاں سے یہ لاگ شروع ہوا۔
- data: DATA - متغیر لمبائی (variable-length) کا غیر انڈیکس شدہ لاگ ڈیٹا۔ (solidity میں: صفر یا اس سے زیادہ 32 بائٹس کے غیر انڈیکس شدہ لاگ دلائل۔)
- topics: Array of DATA - انڈیکس شدہ لاگ دلائل کے 0 سے 4 32 بائٹس DATA کی Array۔ (solidity میں: پہلا موضوع ایونٹ کے دستخط کا ہیش ہے (جیسے، Deposit(address,bytes32,uint256))، سوائے اس کے کہ آپ نے ایونٹ کو anonymous تصریح کنندہ (specifier) کے ساتھ ڈکلیئر کیا ہو۔)
مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'
3// نتیجہ
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": [{
8    "logIndex": "0x1", // 1
9    "blockNumber":"0x1b4", // 436
10    "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
11    "transactionHash":  "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
12    "transactionIndex": "0x0", // 0
13    "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
14    "data":"0x0000000000000000000000000000000000000000000000000000000000000000",
15    "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]
16    },{
17      ...
18    }]
19}

eth_getFilterLogs

دی گئی آئی ڈی کے ساتھ فلٹر سے مماثل تمام لاگز کی ایک Array لوٹاتا ہے۔

پیرامیٹرز

QUANTITY - فلٹر آئی ڈی۔

1params: [
2  "0x16", // 22
3]

واپسی دیکھیں eth_getFilterChanges

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'

نتیجہ دیکھیں eth_getFilterChanges

eth_getLogs

کسی دیے گئے فلٹر آبجیکٹ سے مماثل تمام لاگز کی ایک Array لوٹاتا ہے۔

پیرامیٹرز

Object - فلٹر کے اختیارات:

fromBlock: QUANTITY|TAG - (اختیاری، ڈیفالٹ: "latest") انٹیجر بلاک نمبر، یا آخری تجویز کردہ بلاک کے لیے "latest"، تازہ ترین محفوظ بلاک کے لیے "safe"، تازہ ترین حتمی بلاک کے لیے "finalized"، یا ان ٹرانزیکشنز کے لیے "pending"، "earliest" جو ابھی تک کسی بلاک میں نہیں ہیں۔
toBlock: QUANTITY|TAG - (اختیاری، ڈیفالٹ: "latest") انٹیجر بلاک نمبر، یا آخری تجویز کردہ بلاک کے لیے "latest"، تازہ ترین محفوظ بلاک کے لیے "safe"، تازہ ترین حتمی بلاک کے لیے "finalized"، یا ان ٹرانزیکشنز کے لیے "pending"، "earliest" جو ابھی تک کسی بلاک میں نہیں ہیں۔
address: DATA|Array، 20 بائٹس - (اختیاری) کنٹریکٹ کا ایڈریس یا ان ایڈریسز کی فہرست جہاں سے لاگز شروع ہونے چاہئیں۔
topics: Array of DATA، - (اختیاری) 32 بائٹس DATA موضوعات کی Array۔ موضوعات ترتیب پر منحصر ہیں۔ ہر موضوع "یا" (or) کے اختیارات کے ساتھ DATA کی ایک Array بھی ہو سکتا ہے۔
blockHash: DATA، 32 بائٹس - (اختیاری، مستقبل) EIP-234 کے اضافے کے ساتھ، blockHash ایک نیا فلٹر آپشن ہوگا جو لوٹائے گئے لاگز کو 32-بائٹ ہیش blockHash والے واحد بلاک تک محدود کرتا ہے۔ blockHash کا استعمال fromBlock = toBlock = ہیش blockHash والے بلاک نمبر کے برابر ہے۔ اگر فلٹر کے معیار میں blockHash موجود ہے، تو نہ تو fromBlock اور نہ ہی toBlock کی اجازت ہے۔

1params: [
2  {
3    topics: [
4      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
5    ],
6  },
7]

واپسی دیکھیں eth_getFilterChanges

مثال

1// درخواست
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'

نتیجہ دیکھیں eth_getFilterChanges

استعمال کی مثال

JSON_RPC کا استعمال کرتے ہوئے کنٹریکٹ کو ڈیپلائے کرنا

اس سیکشن میں یہ دکھایا گیا ہے کہ صرف RPC انٹرفیس کا استعمال کرتے ہوئے کنٹریکٹ کو کیسے ڈیپلائے کیا جائے۔ کنٹریکٹس کو ڈیپلائے کرنے کے متبادل طریقے بھی موجود ہیں جہاں اس پیچیدگی کو چھپا دیا جاتا ہے—مثال کے طور پر، RPC انٹرفیس کے اوپر بنی لائبریریوں کا استعمال کرتے ہوئے جیسے web3.js (opens in a new tab) اور web3.py (opens in a new tab)۔ یہ ایبسٹریکشنز عام طور پر سمجھنے میں آسان اور کم غلطیوں کا باعث بنتی ہیں، لیکن پھر بھی یہ سمجھنا مفید ہے کہ پس پردہ کیا ہو رہا ہے۔

ذیل میں ایک سیدھا سادہ اسمارٹ کنٹریکٹ ہے جسے Multiply7 کہا جاتا ہے، جسے JSON-RPC انٹرفیس کا استعمال کرتے ہوئے ایک Ethereum نوڈ پر ڈیپلائے کیا جائے گا۔ یہ ٹیوٹوریل فرض کرتا ہے کہ قاری پہلے سے ہی ایک Geth نوڈ چلا رہا ہے۔ نوڈز اور کلائنٹس کے بارے میں مزید معلومات یہاں دستیاب ہے۔ براہ کرم انفرادی کلائنٹ کی دستاویزات دیکھیں تاکہ یہ معلوم ہو سکے کہ نان-Geth کلائنٹس کے لیے HTTP JSON-RPC کیسے شروع کیا جائے۔ زیادہ تر کلائنٹس ڈیفالٹ کے طور پر localhost:8545 پر سروس فراہم کرتے ہیں۔

1contract Multiply7 {
2    event Print(uint);
3    function multiply(uint input) returns (uint) {
4        Print(input * 7);
5        return input * 7;
6    }
7}

سب سے پہلا کام یہ یقینی بنانا ہے کہ HTTP RPC انٹرفیس فعال ہے۔ اس کا مطلب ہے کہ ہم اسٹارٹ اپ پر Geth کو --http فلیگ فراہم کرتے ہیں۔ اس مثال میں ہم ایک پرائیویٹ ڈیولپمنٹ چین پر Geth نوڈ استعمال کرتے ہیں۔ اس طریقے کا استعمال کرتے ہوئے ہمیں اصلی نیٹ ورک پر ether کی ضرورت نہیں ہے۔

geth --http --dev console 2>>geth.log

یہ http://localhost:8545 پر HTTP RPC انٹرفیس شروع کر دے گا۔

ہم curl (opens in a new tab) کا استعمال کرتے ہوئے کوائن بیس ایڈریس (اکاؤنٹس کی ایرے سے پہلا ایڈریس حاصل کر کے) اور بیلنس بازیافت کر کے اس بات کی تصدیق کر سکتے ہیں کہ انٹرفیس چل رہا ہے۔ براہ کرم نوٹ کریں کہ ان مثالوں میں موجود ڈیٹا آپ کے لوکل نوڈ پر مختلف ہوگا۔ اگر آپ ان کمانڈز کو آزمانا چاہتے ہیں، تو دوسری curl درخواست میں موجود درخواست کے پیرامیٹرز کو پہلی درخواست سے واپس آنے والے نتیجے سے تبدیل کریں۔

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"}

چونکہ نمبرز ہیکس انکوڈڈ (hex encoded) ہوتے ہیں، اس لیے بیلنس wei میں ایک ہیکس اسٹرنگ کے طور پر واپس کیا جاتا ہے۔ اگر ہم بیلنس کو ether میں ایک نمبر کے طور پر دیکھنا چاہتے ہیں تو ہم Geth کنسول سے web3 استعمال کر سکتے ہیں۔

1web3.fromWei("0x1639e49bba16280000", "ether")
2// "410"

اب چونکہ ہماری پرائیویٹ ڈیولپمنٹ چین پر کچھ ether موجود ہے، ہم کنٹریکٹ کو ڈیپلائے کر سکتے ہیں۔ پہلا قدم Multiply7 کنٹریکٹ کو بائٹ کوڈ میں مرتب (compile) کرنا ہے جسے EVM کو بھیجا جا سکے۔ Solidity کمپائلر، solc کو انسٹال کرنے کے لیے، Solidity کی دستاویزات (opens in a new tab) پر عمل کریں۔ (آپ شاید ایک پرانا solc ریلیز استعمال کرنا چاہیں تاکہ یہ ہماری مثال کے لیے استعمال ہونے والے کمپائلر کے ورژن (opens in a new tab) سے مماثل ہو۔)

اگلا قدم Multiply7 کنٹریکٹ کو بائٹ کوڈ میں مرتب کرنا ہے جسے EVM کو بھیجا جا سکے۔

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

======= <stdin>:Multiply7 =======
Binary:
6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029

اب جب کہ ہمارے پاس مرتب شدہ (compiled) کوڈ موجود ہے، ہمیں یہ طے کرنے کی ضرورت ہے کہ اسے ڈیپلائے کرنے پر کتنی گیس خرچ ہوگی۔ RPC انٹرفیس میں ایک eth_estimateGas طریقہ (method) ہے جو ہمیں ایک تخمینہ دے گا۔

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"}

اور آخر کار کنٹریکٹ کو ڈیپلائے کریں۔

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 کے ذریعے کتنی گیس استعمال کی گئی۔ اگر کوئی ٹرانزیکشن ایک کنٹریکٹ بناتی ہے تو اس میں کنٹریکٹ کا ایڈریس بھی شامل ہوگا۔ ہم eth_getTransactionReceipt RPC طریقہ استعمال کر کے رسید بازیافت کر سکتے ہیں۔

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 نتیجہ آنے کا مطلب ہے کہ ٹرانزیکشن ابھی تک کسی بلاک میں شامل نہیں ہوئی ہے۔ کچھ دیر انتظار کریں اور چیک کریں کہ آیا آپ کا کنسینسس کلائنٹ چل رہا ہے اور دوبارہ کوشش کریں۔

اسمارٹ کنٹریکٹس کے ساتھ تعامل

اس مثال میں ہم کنٹریکٹ کے multiply طریقے (method) کو eth_sendTransaction کا استعمال کرتے ہوئے ایک ٹرانزیکشن بھیجیں گے۔

eth_sendTransaction کو کئی دلائل (arguments) کی ضرورت ہوتی ہے، خاص طور پر from، to اور data۔ From ہمارے اکاؤنٹ کا پبلک ایڈریس ہے، اور to کنٹریکٹ کا ایڈریس ہے۔ data دلیل میں ایک پے لوڈ (payload) ہوتا ہے جو یہ طے کرتا ہے کہ کون سا طریقہ (method) کال کیا جانا چاہیے اور کن دلائل کے ساتھ۔ یہیں پر ABI (ایپلیکیشن بائنری انٹرفیس) (opens in a new tab) کام آتا ہے۔ ABI ایک JSON فائل ہے جو یہ طے کرتی ہے کہ EVM کے لیے ڈیٹا کو کیسے بیان اور انکوڈ کیا جائے۔

پے لوڈ کے بائٹس یہ طے کرتے ہیں کہ کنٹریکٹ میں کون سا طریقہ کال کیا گیا ہے۔ یہ فنکشن کے نام اور اس کے آرگومنٹ کی اقسام پر Keccak ہیش کے پہلے 4 بائٹس ہیں، جو ہیکس انکوڈڈ ہوتے ہیں۔ multiply فنکشن ایک uint قبول کرتا ہے جو uint256 کا عرف (alias) ہے۔ اس سے ہمیں یہ ملتا ہے:

1web3.sha3("multiply(uint256)").substring(0, 10)
2// "0xc6888fa1"

اگلا قدم دلائل کو انکوڈ کرنا ہے۔ یہاں صرف ایک uint256 ہے، فرض کریں، ویلیو 6۔ ABI کا ایک سیکشن ہے جو یہ بتاتا ہے کہ uint256 اقسام کو کیسے انکوڈ کیا جائے۔

int<M>: enc(X) X کی بگ-اینڈین ٹوز کمپلیمنٹ (big-endian two’s complement) انکوڈنگ ہے، جسے منفی X کے لیے ہائیر-آرڈر (بائیں) جانب 0xff کے ساتھ اور مثبت X کے لیے صفر بائٹس کے ساتھ پیڈ (padded) کیا جاتا ہے تاکہ لمبائی 32 بائٹس کا ملٹیپل ہو۔

یہ 0000000000000000000000000000000000000000000000000000000000000006 میں انکوڈ ہوتا ہے۔

فنکشن سلیکٹر اور انکوڈ شدہ دلیل کو ملا کر ہمارا ڈیٹا 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006 ہوگا۔

اسے اب نوڈ کو بھیجا جا سکتا ہے:

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"}

چونکہ ایک ٹرانزیکشن بھیجی گئی تھی، اس لیے ایک ٹرانزیکشن ہیش واپس کیا گیا۔ رسید بازیافت کرنے سے یہ ملتا ہے:

1{
2   blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
3   blockNumber: 268,
4   contractAddress: null,
5   cumulativeGasUsed: 22631,
6   gasUsed: 22631,
7   logs: [{
8      address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d",
9      blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
10      blockNumber: 268,
11      data: "0x000000000000000000000000000000000000000000000000000000000000002a",
12      logIndex: 0,
13      topics: ["0x24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"],
14      transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
15      transactionIndex: 0
16  }],
17  transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
18  transactionIndex: 0
19}

رسید میں ایک لاگ (log) ہوتا ہے۔ یہ لاگ ٹرانزیکشن کے نفاذ پر EVM کے ذریعے تیار کیا گیا تھا اور رسید میں شامل کیا گیا تھا۔ multiply فنکشن دکھاتا ہے کہ Print ایونٹ ان پٹ کو 7 سے ضرب دے کر اٹھایا گیا تھا۔ چونکہ Print ایونٹ کے لیے دلیل ایک uint256 تھی، اس لیے ہم اسے ABI کے اصولوں کے مطابق ڈی کوڈ کر سکتے ہیں جس سے ہمیں متوقع اعشاریہ 42 ملے گا۔ ڈیٹا کے علاوہ یہ بات قابل غور ہے کہ ٹاپکس (topics) کا استعمال یہ طے کرنے کے لیے کیا جا سکتا ہے کہ کس ایونٹ نے لاگ بنایا:

1web3.sha3("Print(uint256)")
2// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"

یہ کچھ انتہائی عام کاموں کا صرف ایک مختصر تعارف تھا، جس میں JSON-RPC کا براہ راست استعمال دکھایا گیا ہے۔

کلائنٹ امپلی مینٹیشنز

سہولت بخش لائبریریاں

کنسنسس کلائنٹ APIs

ایگزیکیوشن کلائنٹ کی تفصیلات

روایات

ہیکس ویلیو انکوڈنگ

مقداریں

ان فارمیٹڈ ڈیٹا

بلاک پیرامیٹر

مثالیں

curl کی مثالیں

گاسپ، اسٹیٹ، ہسٹری

گاسپ میتھڈز

اسٹیٹ میتھڈز

ہسٹری میتھڈز

JSON-RPC API پلے گراؤنڈ

JSON-RPC API کے طریقے

web3_clientVersion

web3_sha3

net_version

net_listening

net_peerCount

eth_protocolVersion

eth_syncing

eth_coinbase

eth_chainId

eth_mining

eth_hashrate

eth_gasPrice

eth_accounts

eth_blockNumber

eth_getBalance

eth_getStorageAt

eth_getTransactionCount

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByNumber

eth_getUncleCountByBlockHash

eth_getUncleCountByBlockNumber

eth_getCode

eth_sign

eth_signTransaction

eth_sendTransaction

eth_sendRawTransaction

eth_call

eth_estimateGas

eth_getBlockByHash

eth_getBlockByNumber

eth_getTransactionByHash

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionReceipt

eth_getUncleByBlockHashAndIndex

eth_getUncleByBlockNumberAndIndex

eth_newFilter

eth_newBlockFilter

eth_newPendingTransactionFilter

eth_uninstallFilter

eth_getFilterChanges

eth_getFilterLogs

eth_getLogs

استعمال کی مثال

JSON_RPC کا استعمال کرتے ہوئے کنٹریکٹ کو ڈیپلائے کرنا

اسمارٹ کنٹریکٹس کے ساتھ تعامل

متعلقہ موضوعات

کیا یہ مضمون مددگار تھا؟