⁦JavaScript API⁩ لائبریریاں

کسی ویب ایپ کو ایتھیریم بلاک چین کے ساتھ تعامل کرنے (یعنی بلاک چین کا ڈیٹا پڑھنے اور/یا نیٹ ورک پر ٹرانزیکشنز بھیجنے) کے لیے، اسے ایک ایتھیریم نوڈ سے منسلک ہونا ضروری ہے۔

اس مقصد کے لیے، ہر ایتھیریم کلائنٹ جے سن آر پی سی تصریح (specification) کو نافذ کرتا ہے، لہذا طریقوں (methods) کا ایک یکساں مجموعہ موجود ہے جس پر ایپلیکیشنز انحصار کر سکتی ہیں۔

اگر آپ ایتھیریم نوڈ سے منسلک ہونے کے لیے JavaScript کا استعمال کرنا چاہتے ہیں، تو سادہ (vanilla) JavaScript کا استعمال ممکن ہے لیکن ایکو سسٹم میں کئی سہولت بخش لائبریریاں موجود ہیں جو اسے بہت آسان بنا دیتی ہیں۔ ان لائبریریوں کے ساتھ، ڈیولپرز ایتھیریم کے ساتھ تعامل کرنے والی جے سن آر پی سی درخواستوں کو (اندرونی طور پر) شروع کرنے کے لیے آسان، ایک سطری طریقے لکھ سکتے ہیں۔

براہ کرم نوٹ کریں کہ دی مرج کے بعد سے، نوڈ چلانے کے لیے ایتھیریم سافٹ ویئر کے دو منسلک حصوں - ایک ایگزیکیوشن کلائنٹ اور ایک اتفاقِ رائے کا کلائنٹ - کی ضرورت ہوتی ہے۔ براہ کرم یقینی بنائیں کہ آپ کے نوڈ میں ایگزیکیوشن اور اتفاقِ رائے کا کلائنٹ دونوں شامل ہیں۔ اگر آپ کا نوڈ آپ کی مقامی مشین پر نہیں ہے (مثلاً، آپ کا نوڈ AWS انسٹینس پر چل رہا ہے) تو ٹیوٹوریل میں IP ایڈریسز کو اسی کے مطابق اپ ڈیٹ کریں۔ مزید معلومات کے لیے براہ کرم نوڈ چلانے پر ہمارا صفحہ دیکھیں۔

پیشگی شرائط

JavaScript کو سمجھنے کے ساتھ ساتھ، ایتھیریم اسٹیک اور ایتھیریم کلائنٹس کو سمجھنا بھی مددگار ثابت ہو سکتا ہے۔

لائبریری کیوں استعمال کریں؟

یہ لائبریریاں براہ راست ایتھیریم نوڈ کے ساتھ تعامل کرنے کی زیادہ تر پیچیدگی کو چھپا دیتی ہیں۔ یہ یوٹیلیٹی فنکشنز بھی فراہم کرتی ہیں (مثلاً، ETH کو Gwei میں تبدیل کرنا) تاکہ ایک ڈیولپر کے طور پر آپ ایتھیریم کلائنٹس کی پیچیدگیوں سے نمٹنے میں کم وقت صرف کریں اور اپنی ایپلیکیشن کی منفرد فعالیت پر زیادہ توجہ مرکوز کر سکیں۔

لائبریری کی خصوصیات

ایتھیریم نوڈز سے جڑیں

پرووائیڈرز کا استعمال کرتے ہوئے، یہ لائبریریاں آپ کو ایتھیریم سے جڑنے اور اس کا ڈیٹا پڑھنے کی اجازت دیتی ہیں، چاہے وہ جے سن آر پی سی، Infura، Etherscan، Alchemy یا میٹاماسک کے ذریعے ہو۔

انتباہ: Web3.js کو March 4, 2025 کو آرکائیو کر دیا گیا تھا۔ اعلان پڑھیں (opens in a new tab)۔ نئے پروجیکٹس کے لیے متبادل لائبریریوں جیسے ethers.js (opens in a new tab) یا viem (opens in a new tab) کے استعمال پر غور کریں۔

Ethers کی مثال

// ایک BrowserProvider ایک معیاری Web3 پرووائیڈر کو ریپ کرتا ہے، جو کہ
// وہ ہے جسے میٹاماسک ہر صفحے میں window.ethereum کے طور پر انجیکٹ کرتا ہے
const provider = new ethers.BrowserProvider(window.ethereum)

// میٹاماسک پلگ ان ٹرانزیکشنز پر دستخط کرنے کی بھی اجازت دیتا ہے تاکہ
// ایتھر بھیجا جا سکے اور بلاک چین کے اندر اسٹیٹ تبدیل کرنے کے لیے ادائیگی کی جا سکے۔
// اس کے لیے، ہمیں اکاؤنٹ سائنر کی ضرورت ہے...
const signer = provider.getSigner()

Web3js کی مثال

var web3 = new Web3("http://localhost:8545")
// یا
var web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"))

// پرووائیڈر تبدیل کریں
web3.setProvider("ws://localhost:8546")
// یا
web3.setProvider(new Web3.providers.WebsocketProvider("ws://localhost:8546"))

// node.js میں IPC پرووائیڈر کا استعمال
var net = require("net")
var web3 = new Web3("/Users/myuser/Library/Ethereum/geth.ipc", net) // mac os کا پاتھ
// or
var web3 = new Web3(
  new Web3.providers.IpcProvider("/Users/myuser/Library/Ethereum/geth.ipc", net)
) // mac os کا پاتھ
// ونڈوز پر پاتھ یہ ہے: "\\\\.\\pipe\\geth.ipc"
// لینکس پر پاتھ یہ ہے: "/users/myuser/.ethereum/geth.ipc"

ایک بار سیٹ اپ ہونے کے بعد آپ بلاک چین سے درج ذیل کے لیے استفسار (query) کر سکیں گے:

بلاک نمبرز
گیس کے تخمینے
سمارٹ کنٹریکٹ ایونٹس
نیٹ ورک آئی ڈی
اور مزید...

والیٹ کی فعالیت

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

یہاں Ethers کی ایک مثال ہے

// ایک نیومونک سے والیٹ انسٹینس بنائیں...
mnemonic =
  "announce room limb pattern dry unit scale effort smooth jazz weasel alcohol"
walletMnemonic = Wallet.fromPhrase(mnemonic)

// ...یا پرائیویٹ کی سے
walletPrivateKey = new Wallet(walletMnemonic.privateKey)

walletMnemonic.address === walletPrivateKey.address
// true

// سائنر API کے مطابق ایڈریس ایک Promise کے طور پر
walletMnemonic.getAddress()
// { Promise: '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1' }

// والیٹ ایڈریس سنکرونس طور پر بھی دستیاب ہوتا ہے
walletMnemonic.address
// '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1'

// اندرونی کرپٹوگرافک اجزاء
walletMnemonic.privateKey
// '0x1da6847600b0ee25e9ad9a52abbd786dd2502fa4005dd5af9310b7cc7a3b25db'
walletMnemonic.publicKey
// '0x04b9e72dfd423bcf95b3801ac93f4392be5ff22143f9980eb78b3a860c4843bfd04829ae61cdba4b3b1978ac5fc64f5cc2f4350e35a108a9c9a92a81200a60cd64'

// والیٹ کا نیومونک
walletMnemonic.mnemonic
// {
//   locale: 'en',
//   path: 'm/44\'/60\'/0\'/0/0',
//   phrase: 'announce room limb pattern dry unit scale effort smooth jazz weasel alcohol'
// }

// نوٹ: پرائیویٹ کی سے بنائے گئے والیٹ میں
//       نیومونک نہیں ہوتا (ڈیریویشن اسے روکتی ہے)
walletPrivateKey.mnemonic
// null

// پیغام پر دستخط کرنا
walletMnemonic.signMessage("Hello World")
// { Promise: '0x14280e5885a19f60e536de50097e96e3738c7acae4e9e62d67272d794b8127d31c03d9cd59781d4ee31fb4e1b893bd9b020ec67dfa65cfb51e2bdadbb1de26d91c' }

tx = {
  to: "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
  value: utils.parseEther("1.0"),
}

// ٹرانزیکشن پر دستخط کرنا
walletMnemonic.signTransaction(tx)
// { Promise: '0xf865808080948ba1f109551bd432803012645ac136ddd64dba72880de0b6b3a7640000801ca0918e294306d177ab7bd664f5e141436563854ebe0a3e523b9690b4922bbb52b8a01181612cec9c431c4257a79b8c9f0c980a2c49bb5a0e6ac52949163eeb565dfc' }

// connect میتھڈ ایک نیا انسٹینس لوٹاتا ہے جو
// ایک پرووائیڈر سے منسلک والیٹ کا ہوتا ہے
wallet = walletMnemonic.connect(provider)

// نیٹ ورک سے کیوری کرنا
wallet.getBalance()
// { Promise: { BigNumber: "42" } }
wallet.getTransactionCount()
// { Promise: 0 }

// ایتھر بھیجنا
wallet.sendTransaction(tx)

مکمل دستاویزات پڑھیں (opens in a new tab)

ایک بار سیٹ اپ ہونے کے بعد آپ اس قابل ہو جائیں گے:

اکاؤنٹس بنانا
ٹرانزیکشنز بھیجنا
ٹرانزیکشنز پر دستخط کرنا
اور مزید...

سمارٹ کنٹریکٹ فنکشنز کے ساتھ تعامل کریں

JavaScript کلائنٹ لائبریریاں آپ کی ایپلیکیشن کو مرتب شدہ (compiled) کنٹریکٹ کے ایپلیکیشن بائنری انٹرفیس (ABI) کو پڑھ کر سمارٹ کنٹریکٹ فنکشنز کو کال کرنے کی اجازت دیتی ہیں۔

ABI بنیادی طور پر کنٹریکٹ کے فنکشنز کو JSON فارمیٹ میں بیان کرتا ہے اور آپ کو اسے ایک عام JavaScript آبجیکٹ کی طرح استعمال کرنے کی اجازت دیتا ہے۔

لہذا درج ذیل Solidity کنٹریکٹ:

contract Test {
    uint a;
    address d = 0x12345678901234567890123456789012;

    constructor(uint testInt)  { a = testInt;}

    event Event(uint indexed b, bytes32 c);

    event Event2(uint indexed b, bytes32 c);

    function foo(uint b, bytes32 c) returns(address) {
        Event(b, c);
        return d;
    }
}

درج ذیل JSON کا نتیجہ دے گا:

[{
    "type":"constructor",
    "payable":false,
    "stateMutability":"nonpayable"
    "inputs":[{"name":"testInt","type":"uint256"}],
  },{
    "type":"function",
    "name":"foo",
    "constant":false,
    "payable":false,
    "stateMutability":"nonpayable",
    "inputs":[{"name":"b","type":"uint256"}, {"name":"c","type":"bytes32"}],
    "outputs":[{"name":"","type":"address"}]
  },{
    "type":"event",
    "name":"Event",
    "inputs":[{"indexed":true,"name":"b","type":"uint256"}, {"indexed":false,"name":"c","type":"bytes32"}],
    "anonymous":false
  },{
    "type":"event",
    "name":"Event2",
    "inputs":[{"indexed":true,"name":"b","type":"uint256"},{"indexed":false,"name":"c","type":"bytes32"}],
    "anonymous":false
}]

اس کا مطلب ہے کہ آپ کر سکتے ہیں:

سمارٹ کنٹریکٹ کو ٹرانزیکشن بھیجنا اور اس کا طریقہ (method) نافذ کرنا
EVM میں عمل درآمد کے وقت کسی طریقے کے نفاذ میں لگنے والی گیس کا تخمینہ لگانے کے لیے کال کرنا
کنٹریکٹ تعینات کرنا
اور مزید...

یوٹیلیٹی فنکشنز

یوٹیلیٹی فنکشنز آپ کو کارآمد شارٹ کٹس دیتے ہیں جو ایتھیریم کے ساتھ تعمیر کو قدرے آسان بناتے ہیں۔

ETH کی قدریں پہلے سے طے شدہ طور پر Wei میں ہوتی ہیں۔ 1 ETH = 1,000,000,000,000,000,000 WEI – اس کا مطلب ہے کہ آپ بہت سارے نمبروں سے نمٹ رہے ہیں! web3.utils.toWei آپ کے لیے ایتھر کو Wei میں تبدیل کرتا ہے۔

اور ethers میں یہ اس طرح لگتا ہے:

// کسی اکاؤنٹ کا بیلنس حاصل کریں (ایڈریس یا ENS نام کے ذریعے)
balance = await provider.getBalance("ethers.eth")
// { BigNumber: "2337132817842795605" }

// اکثر آپ کو صارف کے لیے آؤٹ پٹ کو فارمیٹ کرنے کی ضرورت ہوگی
// جو اقدار کو Wei کے بجائے ایتھر میں دیکھنا پسند کرتے ہیں
ethers.utils.formatEther(balance)
// '2.337132817842795605'

دستیاب لائبریریاں

Web3.js - ایتھیریم JavaScript API۔

Ethers.js - JavaScript اور TypeScript میں مکمل ایتھیریم والیٹ کا نفاذ اور یوٹیلیٹیز۔

The Graph - ایتھیریم اور IPFS ڈیٹا کو انڈیکس کرنے اور GraphQL کا استعمال کرتے ہوئے اس سے استفسار کرنے کا ایک پروٹوکول۔

Alchemy SDK - بہتر APIs کے ساتھ Ethers.js کے گرد ریپر (Wrapper)۔

viem - ایتھیریم کے لیے TypeScript انٹرفیس۔

Codex - درجنوں چینز پر ریئل ٹائم، افزودہ بلاک چین ڈیٹا API۔

Drift - بلٹ ان کیشنگ، ہکس، اور ٹیسٹ موکس کے ساتھ TypeScript میٹا لائبریری۔

مزید مطالعہ

کسی ایسے کمیونٹی وسیلے کے بارے میں جانتے ہیں جس نے آپ کی مدد کی ہو؟ اس صفحے میں ترمیم کریں اور اسے شامل کریں!

JavaScript میں ایتھیریم بلاک چین استعمال کرنے کے لیے Web3js سیٹ اپ کریں – آپ کے پروجیکٹ میں web3.js سیٹ اپ کرنے کی ہدایات۔
JavaScript سے سمارٹ کنٹریکٹ کو کال کرنا – DAI ٹوکن کا استعمال کرتے ہوئے، دیکھیں کہ JavaScript کا استعمال کرتے ہوئے کنٹریکٹس فنکشن کو کیسے کال کیا جائے۔
web3 اور Alchemy کا استعمال کرتے ہوئے ٹرانزیکشنز بھیجنا – بیک اینڈ سے ٹرانزیکشنز بھیجنے کے لیے مرحلہ وار رہنمائی۔

ٹیوٹوریلز: ایتھیریم پر JavaScript APIs اور WebSockets

WebSockets کا استعمال – ایتھیریم ایونٹس کو سبسکرائب کرنے اور ریئل ٹائم جے سن آر پی سی درخواستیں کرنے کے لیے Alchemy کے ساتھ WebSockets کا استعمال کیسے کریں۔