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

آپ کو ہمیشہ اپنا سمارٹ کنٹریکٹ لکھنے اور تعینات کرنے کی ضرورت نہیں ہوتی۔ ایک ڈویلپر کے طور پر زیادہ تر وقت، آپ ان سمارٹ کنٹریکٹس کے ساتھ تعامل کرنا چاہیں گے جو دوسروں نے پہلے ہی ایتھیریم نیٹ ورک پر تعینات کر رکھے ہیں۔

یہ صفحہ سمارٹ کنٹریکٹ کے ساتھ تعامل کرنے کے دو بنیادی طریقوں—ڈیٹا پڑھنا اور ڈیٹا لکھنا—اور ان دونوں کاموں کے لیے درکار ٹولز کا احاطہ کرتا ہے۔

پیشگی شرائط

آپ کو سمجھنا چاہیے:

سمارٹ کنٹریکٹ کے ساتھ تعامل کے دو طریقے

سمارٹ کنٹریکٹ کے ساتھ تعامل دو زمروں میں آتا ہے:

کنٹریکٹ سے پڑھنا

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

جب آپ کسی کنٹریکٹ سے پڑھتے ہیں، تو آپ محض اس ڈیٹا کو تلاش کر رہے ہوتے ہیں جو پہلے سے موجود ہے۔ مثال کے طور پر:

ERC-20 ٹوکن بیلنس چیک کرنا
ایک لامركزی ایکسچینج سے موجودہ قیمت پڑھنا
کسی NFT کے مالک کا پتہ لگانا

چونکہ پڑھنے سے حالت تبدیل نہیں ہوتی، اس لیے ان پر گیس خرچ نہیں ہوتی اور کوئی بھی شخص ETH کی ضرورت کے بغیر یہ عمل انجام دے سکتا ہے۔

کنٹریکٹ میں لکھنا

لکھنا ایک حالت تبدیل کرنے والا عمل ہے جس کے لیے ٹرانزیکشن کی ضرورت ہوتی ہے اور اس پر گیس خرچ ہوتی ہے۔

جب آپ کسی کنٹریکٹ میں لکھتے ہیں، تو آپ ایک ایسا فنکشن متحرک کر رہے ہوتے ہیں جو بلاک چین کی حالت کو تبدیل کرتا ہے۔ مثال کے طور پر:

ٹوکنز منتقل کرنا
لامركزی ایکسچینج پر ٹوکنز کا تبادلہ کرنا
NFT کی ڈھلائی

لکھنے کے لیے ہمیشہ درج ذیل کی ضرورت ہوتی ہے:

ایک بیرونی ملکیت والا اکاؤنٹ (EOA) جس میں گیس کے لیے کافی ETH ہو
اکاؤنٹ کی نجی کلید کے ذریعے دستخط شدہ ٹرانزیکشن
ٹرانزیکشن کا مائن ہونا اور بلاک میں شامل ہونا

اکاؤنٹ کی تجرید کے ساتھ، ایک سمارٹ کنٹریکٹ اکاؤنٹ بھی لکھنے کا عمل شروع کر سکتا ہے، اور ایک پے ماسٹر صارف کی جانب سے گیس ادا کر سکتا ہے—لہذا ETH رکھنے والے EOA کی سختی سے ضرورت نہیں ہے۔

کنٹریکٹ کی ABIs کو سمجھنا

کسی سمارٹ کنٹریکٹ کے ساتھ تعامل کرنے کے لیے، آپ کی ایپلی کیشن کو یہ جاننے کی ضرورت ہوتی ہے کہ کنٹریکٹ کیا کر سکتا ہے۔ یہیں پر ایپلیکیشن بائنری انٹرفیس (ABI) کام آتا ہے۔

ایک ABI ایک JSON دستاویز ہے جو درج ذیل کو بیان کرتی ہے:

ہر وہ فنکشن جو کنٹریکٹ ظاہر کرتا ہے (نام، ان پٹس، آؤٹ پٹس)
ہر وہ ایونٹ جو کنٹریکٹ خارج کر سکتا ہے
کنٹریکٹ سے بات کرتے وقت ڈیٹا کو انکوڈ اور ڈیکوڈ کرنے کا طریقہ

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

کنٹریکٹ کی ABI کہاں سے تلاش کریں

Etherscan پر تصدیق شدہ کنٹریکٹس - Etherscan (نئے ٹیب میں کھلتا ہے) تصدیق شدہ سورس کوڈ کے لیے خود بخود ABI ظاہر کرتا ہے
ڈویلپر کی طرف سے - بہت سے پروجیکٹس اپنی ABIs کو اپنی دستاویزات یا npm پیکجز میں شائع کرتے ہیں
سورس سے تیار کریں - اگر آپ کے پاس Solidity سورس کوڈ ہے، تو آپ ABI تیار کرنے کے لیے اسے کمپائل کر سکتے ہیں

کنٹریکٹس کے ساتھ تعامل کے لیے ٹولز اور لائبریریاں

ڈویلپرز عام طور پر ویب ایپ، بیک اینڈ، یا سکرپٹ سے کنٹریکٹس کے ساتھ تعامل کرنے کے لیے JavaScript/TypeScript لائبریری کا استعمال کرتے ہیں۔

کلائنٹ لائبریریاں (JavaScript/TypeScript)

Viem (نئے ٹیب میں کھلتا ہے) - فرسٹ کلاس ٹائپ سیفٹی کے ساتھ ایتھیریم کے لیے جدید، ہلکا پھلکا TypeScript انٹرفیس
ethers.js (نئے ٹیب میں کھلتا ہے) - ایتھیریم بلاک چین کے ساتھ تعامل کے لیے آزمودہ لائبریری
web3.js (نئے ٹیب میں کھلتا ہے) - اصل ایتھیریم JavaScript API

بیک اینڈ لائبریریاں

ethers.js (نئے ٹیب میں کھلتا ہے) - سرور سائیڈ سکرپٹس اور بوٹس کے لیے Node.js میں بھی کام کرتی ہے
web3.py (نئے ٹیب میں کھلتا ہے) - ایتھیریم کے ساتھ تعامل کے لیے Python لائبریری
go-ethereum (نئے ٹیب میں کھلتا ہے) - گو ایتھیریم (geth) ٹیم کی جانب سے آفیشل Go لائبریری

مثال: Viem کے ساتھ ٹوکن بیلنس پڑھنا

import { createPublicClient, http, formatUnits } from 'viem'
import { mainnet } from 'viem/chains'

// USDC کنٹریکٹ کا ایڈریس اور ABI (جزوی، balanceOf کے لیے)
const USDC = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
const abi = [{
  name: 'balanceOf',
  type: 'function',
  stateMutability: 'view',
  inputs: [{ name: 'account', type: 'address' }],
  outputs: [{ name: '', type: 'uint256' }],
}] as const

const client = createPublicClient({ chain: mainnet, transport: http() })

const balance = await client.readContract({
  address: USDC,
  abi,
  functionName: 'balanceOf',
  args: ['0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'], // vitalik.eth
})

console.log(formatUnits(balance, 6)) // USDC کے 6 اعشاریے ہیں

مثال: ethers.js کے ساتھ ٹرانزیکشن بھیجنا

const { ethers } = require('ethers')

const provider = new ethers.JsonRpcProvider(process.env.RPC_URL)
const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider)

// ERC-20 ٹرانسفر ABI
const abi = ['function transfer(address to, uint256 amount) returns (bool)']
const contract = new ethers.Contract(tokenAddress, abi, wallet)

const tx = await contract.transfer(recipient, ethers.parseUnits('10', 18))
await tx.wait() // ٹرانزیکشن کے مائن ہونے کا انتظار کریں
console.log(`Transferred! TX: ${tx.hash}`)

ایونٹس اور لاگز

سمارٹ کنٹریکٹس یہ اشارہ دینے کے لیے ایونٹس خارج کر سکتے ہیں کہ کچھ ہوا ہے۔ آپ کی ایپلی کیشن ریئل ٹائم میں ردعمل ظاہر کرنے کے لیے ان ایونٹس کو سن سکتی ہے۔

import { createPublicClient, http, parseAbiItem } from 'viem'
import { mainnet } from 'viem/chains'

const client = createPublicClient({ chain: mainnet, transport: http() })

// USDC ٹرانسفر ایونٹس پر نظر رکھیں
const unwatch = client.watchEvent({
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  onLogs: (logs) => console.log(logs),
})

ٹرانزیکشنز کی سیمولیشن

کوئی ٹرانزیکشن بھیجنے سے پہلے، آپ گیس خرچ کیے بغیر یہ چیک کرنے کے لیے اس کی سیمولیشن کر سکتے ہیں کہ آیا یہ کامیاب ہوگی—اور اس کی ریٹرن ویلیو دیکھنے کے لیے۔ یہ غلطیوں کو جلد پکڑنے اور نتائج کا پیشگی جائزہ لینے کے لیے مفید ہے۔

زیادہ تر کلائنٹ لائبریریاں eth_call کے ذریعے اس کی حمایت کرتی ہیں:

// Viem کے ساتھ
const result = await client.simulateContract({
  address: contractAddress,
  abi,
  functionName: 'swap',
  args: [amountIn],
  account: userAddress,
})

والیٹس اور دستخط کرنا

ایک غیر مرکزی ایپلی کیشن (dapp) میں، صارف کا والیٹ (جیسے میٹاماسک، Rainbow، یا WalletConnect) دستخط کرنے کا کام سنبھالتا ہے۔ آپ براہ راست نجی کلیدوں کا انتظام نہیں کرتے۔

والیٹ لائبریریاں اور کنکشن ٹولز اسے ایبسٹریکٹ (abstract) کر دیتے ہیں تاکہ آپ اپنی ایپلی کیشن کی منطق (logic) بنانے پر توجہ مرکوز کر سکیں۔