مرکزی مواد پر جائیں

⁦NFT⁩ کیسے لکھیں اور تعینات کریں (⁦NFT⁩ ٹیوٹوریل سیریز کا حصہ ⁦1/3⁩)

ERC-721
Alchemy
Solidity
سمارٹ کنٹریکٹس
ابتدائی
سومی مدگل
۲۲ اپریل، ۲۰۲۱
19 منٹ کا مطالعہ

چونکہ غیر متبادل ٹوکن (NFTs) بلاک چین کو عوام کی نظروں میں لا رہے ہیں، اس لیے اب ایتھیریم بلاک چین پر اپنا NFT کنٹریکٹ (ERC-721 ٹوکن) شائع کر کے خود اس ہائپ کو سمجھنے کا ایک بہترین موقع ہے!

اس ٹیوٹوریل میں، ہم میٹاماسک (نئے ٹیب میں کھلتا ہے)، Solidity (نئے ٹیب میں کھلتا ہے)، Hardhat (نئے ٹیب میں کھلتا ہے)، Pinata (نئے ٹیب میں کھلتا ہے) اور Alchemy (نئے ٹیب میں کھلتا ہے) کا استعمال کرتے ہوئے Sepolia آزمائشی نیٹ ورک پر ایک ERC-721 سمارٹ کنٹریکٹ بنانے اور تعینات کرنے کے عمل سے گزریں گے (اگر آپ کو ابھی تک ان میں سے کسی کا مطلب سمجھ نہیں آیا تو پریشان نہ ہوں — ہم اس کی وضاحت کریں گے!)۔

اس ٹیوٹوریل کے حصہ 2 میں ہم دیکھیں گے کہ ہم اپنے سمارٹ کنٹریکٹ کا استعمال کرتے ہوئے ایک NFT کیسے ڈھال سکتے ہیں، اور حصہ 3 میں ہم وضاحت کریں گے کہ میٹاماسک پر اپنا NFT کیسے دیکھا جائے۔

اور یقیناً، اگر آپ کے کسی بھی موقع پر سوالات ہوں، تو Alchemy ڈسکارڈ (نئے ٹیب میں کھلتا ہے) میں رابطہ کرنے سے نہ ہچکچائیں یا Alchemy کی NFT ایپلیکیشن پروگرامنگ انٹرفیس (API) دستاویزات (نئے ٹیب میں کھلتا ہے) ملاحظہ کریں!

مرحلہ 1: ایتھیریم نیٹ ورک سے جڑیں

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

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

مرحلہ 2: اپنی ایپ (اور API کلید) بنائیں

ایک بار جب آپ Alchemy اکاؤنٹ بنا لیتے ہیں، تو آپ ایک ایپ بنا کر API کلید تیار کر سکتے ہیں۔ یہ ہمیں Sepolia آزمائشی نیٹ ورک پر درخواستیں بھیجنے کی اجازت دے گا۔ اگر آپ آزمائشی نیٹ ورکس کے بارے میں مزید جاننے کے لیے متجسس ہیں تو یہ گائیڈ (نئے ٹیب میں کھلتا ہے) دیکھیں۔

  1. نیویگیشن بار میں "Select an app" کو منتخب کر کے اور "Create new app" پر کلک کر کے اپنے Alchemy ڈیش بورڈ میں "Create new app" صفحہ پر جائیں۔

اپنی ایپ بنائیں

  1. اپنی ایپ کا نام رکھیں (ہم نے "My First NFT!" کا انتخاب کیا)، ایک مختصر تفصیل فراہم کریں، اور استعمال کا کیس منتخب کریں۔ اس کے بعد، "Ethereum" تلاش کریں اور نیٹ ورک کو منتخب کریں۔ ہم Sepolia کا استعمال کریں گے، جو ایپلیکیشن ڈیولپمنٹ کے لیے تجویز کردہ آزمائشی نیٹ ورک ہے (ایتھیریم نیٹ ورکس دیکھیں)۔

  2. آگے بڑھنے کے لیے "Next" پر کلک کریں، پھر "Create app" اور بس! آپ کی ایپ نیویگیشن بار کے ڈراپ ڈاؤن مینو میں ظاہر ہونی چاہیے، جس میں کاپی کرنے کے لیے ایک API کلید دستیاب ہوگی۔

مرحلہ 3: ایک ایتھیریم اکاؤنٹ (پتہ) بنائیں

ہمیں ٹرانزیکشنز بھیجنے اور وصول کرنے کے لیے ایک ایتھیریم اکاؤنٹ کی ضرورت ہے۔ اس ٹیوٹوریل کے لیے، ہم میٹاماسک کا استعمال کریں گے، جو براؤزر میں ایک ورچوئل والیٹ ہے جسے آپ کے ایتھیریم اکاؤنٹ کا پتہ منظم کرنے کے لیے استعمال کیا جاتا ہے۔ اگر آپ اس بارے میں مزید سمجھنا چاہتے ہیں کہ ایتھیریم پر ٹرانزیکشنز کیسے کام کرتی ہیں، تو ایتھیریم فاؤنڈیشن کا یہ صفحہ دیکھیں۔

آپ یہاں (نئے ٹیب میں کھلتا ہے) مفت میں میٹاماسک اکاؤنٹ ڈاؤن لوڈ اور بنا سکتے ہیں۔ جب آپ اکاؤنٹ بنا رہے ہوں، یا اگر آپ کے پاس پہلے سے ہی ایک اکاؤنٹ ہے، تو نیٹ ورک کے انتخاب کے مینو کا استعمال کرتے ہوئے "Sepolia" آزمائشی نیٹ ورک پر سوئچ کرنا یقینی بنائیں (تاکہ ہم حقیقی رقم کے ساتھ کام نہ کر رہے ہوں)۔ اگر آپ کو Sepolia فہرست میں نظر نہیں آتا ہے، تو اوپری دائیں کونے میں مینو کھولیں، "Networks" کو منتخب کریں، اور "Show test networks" کو آن کریں (آزمائشی نیٹ ورکس دیکھنے کے لیے میٹاماسک کی گائیڈ (نئے ٹیب میں کھلتا ہے) دیکھیں)۔

Sepolia کو اپنے نیٹ ورک کے طور پر سیٹ کریں

مرحلہ 4: فوسٹ سے ایتھر شامل کریں

اپنے سمارٹ کنٹریکٹ کو آزمائشی نیٹ ورک پر تعینات کرنے کے لیے، ہمیں کچھ نقلی ETH کی ضرورت ہوگی۔ Sepolia ETH حاصل کرنے کے لیے، Sepolia نیٹ ورک کی تفصیلات میں درج فوسٹس میں سے ایک کا انتخاب کریں اور اپنے اکاؤنٹ کا پتہ درج کریں۔ اگر ایک کام نہیں کرتا ہے، تو دوسرا آزمائیں کیونکہ وہ بعض اوقات خشک ہو سکتے ہیں، اور کچھ کے اہلیت کے اصول ہوتے ہیں: مثال کے طور پر، Alchemy Sepolia فوسٹ (نئے ٹیب میں کھلتا ہے) کے لیے ضروری ہے کہ وصول کرنے والے پتے کے پاس ایتھیریم مین نیٹ پر کم از کم 0.001 ETH ہوں۔ آپ کو جلد ہی اپنے میٹاماسک اکاؤنٹ میں ETH نظر آنا چاہیے!

مرحلہ 5: اپنا بیلنس چیک کریں

یہ دوبارہ چیک کرنے کے لیے کہ ہمارا بیلنس موجود ہے، آئیے Alchemy کے سینڈ باکس ٹول (نئے ٹیب میں کھلتا ہے) کا استعمال کرتے ہوئے ایک eth_getBalance (نئے ٹیب میں کھلتا ہے) درخواست کریں۔ یہ ہمارے والیٹ میں موجود ETH کی مقدار واپس کرے گا۔ اپنا میٹاماسک اکاؤنٹ کا پتہ درج کرنے اور "Send Request" پر کلک کرنے کے بعد، آپ کو اس طرح کا جواب نظر آنا چاہیے:

{ "jsonrpc": "2.0", "id": 0, "result": "0xde0b6b3a7640000" }

نوٹ یہ نتیجہ Wei میں ہے، ETH میں نہیں۔ Wei کو ایتھر کی سب سے چھوٹی اکائی کے طور پر استعمال کیا جاتا ہے۔ Wei سے ETH میں تبدیلی 1 eth = 1018 wei ہے۔ لہذا اگر ہم 0xde0b6b3a7640000 کو اعشاریہ میں تبدیل کریں تو ہمیں 1*1018 wei ملتا ہے، جو 1 ETH کے برابر ہے۔

شکر ہے! ہماری تمام نقلی رقم وہاں موجود ہے۔

مرحلہ 6: ہمارے پروجیکٹ کو شروع کریں

سب سے پہلے، ہمیں اپنے پروجیکٹ کے لیے ایک فولڈر بنانا ہوگا۔ اپنی کمانڈ لائن پر جائیں اور ٹائپ کریں:

mkdir my-nft
cd my-nft

اب جب کہ ہم اپنے پروجیکٹ فولڈر کے اندر ہیں، ہم پروجیکٹ کو شروع کرنے کے لیے npm init کا استعمال کریں گے۔ اگر آپ کے پاس پہلے سے npm انسٹال نہیں ہے، تو Node.js کی تنصیب کی ہدایات (نئے ٹیب میں کھلتا ہے) پر عمل کریں (ہمیں اس ٹیوٹوریل کے لیے Node.js اور npm کی ضرورت ہوگی)۔

npm init

اس سے کوئی خاص فرق نہیں پڑتا کہ آپ تنصیب کے سوالات کا کیا جواب دیتے ہیں؛ حوالہ کے لیے ہم نے اسے اس طرح کیا ہے:

package.json کو منظور کریں۔ Hardhat 3، جسے ہم آگے انسٹال کریں گے، صرف ES ماڈیول پروجیکٹس کو سپورٹ کرتا ہے، لہذا پروجیکٹ کو اس کے طور پر نشان زد کریں:

npm pkg set type=module

اور ہم تیار ہیں!

مرحلہ 7: Hardhat (نئے ٹیب میں کھلتا ہے) انسٹال کریں

Hardhat آپ کے ایتھیریم سافٹ ویئر کو مرتب کرنے، تعینات کرنے، جانچنے اور ڈیبگ کرنے کے لیے ایک ڈیولپمنٹ ماحول ہے۔ یہ لائیو چین پر تعینات کرنے سے پہلے مقامی طور پر سمارٹ کنٹریکٹس اور غیر مرکزی ایپلی کیشنز (dapps) بناتے وقت ڈیولپرز کی مدد کرتا ہے۔

Hardhat 3 کے لیے Node.js v22.13.0 یا اس کے بعد کا ورژن درکار ہے۔ ہمارے my-nft پروجیکٹ کے اندر چلائیں:

npm install --save-dev hardhat

تنصیب کی ہدایات (نئے ٹیب میں کھلتا ہے) پر مزید تفصیلات کے لیے یہ صفحہ دیکھیں۔

مرحلہ 8: Hardhat پروجیکٹ بنائیں

npx hardhat --init چلانے سے ایک مکمل نمونہ پروجیکٹ تیار ہو جائے گا، لیکن اس ٹیوٹوریل کے لیے ہم چیزوں کو ہاتھ سے ترتیب دیں گے تاکہ آپ ہر حصے کو دیکھ سکیں۔ اپنے پروجیکٹ فولڈر کی روٹ میں، مندرجہ ذیل مشمولات کے ساتھ hardhat.config.js نامی ایک فائل بنائیں:

import { defineConfig } from "hardhat/config"

export default defineConfig({
  solidity: "0.8.34",
})

یہ وہ جگہ ہے جہاں ہم اپنے پروجیکٹ کے لیے تمام سیٹ اپ کی وضاحت کریں گے (مرحلہ 13 پر)۔ فی الحال، یہ صرف Hardhat کو بتاتا ہے کہ Solidity کمپائلر کا کون سا ورژن استعمال کرنا ہے۔

مرحلہ 9: پروجیکٹ فولڈرز شامل کریں

اپنے پروجیکٹ کو منظم رکھنے کے لیے، ہم دو نئے فولڈرز بنائیں گے۔ اپنی کمانڈ لائن میں اپنے پروجیکٹ کی روٹ ڈائرکٹری پر جائیں اور ٹائپ کریں:

mkdir contracts
mkdir scripts
  • contracts/ وہ جگہ ہے جہاں ہم اپنا NFT سمارٹ کنٹریکٹ کوڈ رکھیں گے

  • scripts/ وہ جگہ ہے جہاں ہم اپنے سمارٹ کنٹریکٹ کو تعینات کرنے اور اس کے ساتھ تعامل کرنے کے لیے سکرپٹس رکھیں گے

مرحلہ 10: اپنا کنٹریکٹ لکھیں

اب جب کہ ہمارا ماحول ترتیب پا چکا ہے، مزید دلچسپ چیزوں کی طرف بڑھتے ہیں: اپنا سمارٹ کنٹریکٹ کوڈ لکھنا!

اپنے پسندیدہ ایڈیٹر میں my-nft پروجیکٹ کھولیں (ہمیں VSCode (نئے ٹیب میں کھلتا ہے) پسند ہے)۔ سمارٹ کنٹریکٹس Solidity نامی زبان میں لکھے جاتے ہیں جسے ہم اپنا MyNFT.sol سمارٹ کنٹریکٹ لکھنے کے لیے استعمال کریں گے۔

  1. contracts فولڈر میں جائیں اور MyNFT.sol نامی ایک نئی فائل بنائیں۔

  2. ذیل میں ہمارا NFT سمارٹ کنٹریکٹ کوڈ ہے، جس کی بنیاد ہم نے اوپن زیپلن (نئے ٹیب میں کھلتا ہے) لائبریری کے ERC-721 نفاذ پر رکھی ہے۔ ذیل کے مشمولات کو کاپی کریں اور اپنی MyNFT.sol فائل میں پیسٹ کریں۔

  3. چونکہ ہم اوپن زیپلن کنٹریکٹس لائبریری سے کلاسز وراثت میں لے رہے ہیں، اس لیے لائبریری کو ہمارے فولڈر میں انسٹال کرنے کے لیے اپنی کمانڈ لائن میں npm install @openzeppelin/contracts چلائیں۔ یہ ٹیوٹوریل اوپن زیپلن کنٹریکٹس 5.x کا استعمال کرتا ہے، جس کے لیے Solidity 0.8.24 یا اس کے بعد کا ورژن درکار ہے۔

تو، یہ کوڈ بالکل کیا کرتا ہے؟ آئیے اسے لائن بہ لائن سمجھتے ہیں۔

اپنے سمارٹ کنٹریکٹ کے اوپری حصے میں، ہم تین اوپن زیپلن (نئے ٹیب میں کھلتا ہے) سمارٹ کنٹریکٹ کلاسز درآمد کرتے ہیں:

  • @openzeppelin/contracts/token/ERC721/ERC721.sol میں ERC-721 معیار کا نفاذ شامل ہے، جسے ہمارا NFT سمارٹ کنٹریکٹ وراثت میں لے گا۔ (ایک درست NFT ہونے کے لیے، آپ کے سمارٹ کنٹریکٹ کو ERC-721 معیار کے تمام طریقوں کو نافذ کرنا چاہیے۔) وراثت میں ملنے والے ERC-721 فنکشنز کے بارے میں مزید جاننے کے لیے، یہاں (نئے ٹیب میں کھلتا ہے) انٹرفیس کی تعریف دیکھیں۔

  • @openzeppelin/contracts/access/Ownable.sol ہمارے سمارٹ کنٹریکٹ پر رسائی کنٹرول (نئے ٹیب میں کھلتا ہے) سیٹ کرتا ہے، تاکہ صرف سمارٹ کنٹریکٹ کا مالک (آپ) ہی NFTs ڈھال سکے۔ مالک وہ initialOwner پتہ ہے جو کنسٹرکٹر کو پاس کیا گیا ہے۔ (نوٹ کریں، رسائی کنٹرول کو شامل کرنا مکمل طور پر ایک ترجیح ہے۔ اگر آپ چاہتے ہیں کہ کوئی بھی آپ کے سمارٹ کنٹریکٹ کا استعمال کرتے ہوئے NFT ڈھال سکے، تو کنٹریکٹ کی تعریف اور کنسٹرکٹر سے Ownable اور Ownable(initialOwner) کو ہٹا دیں، اور mintNFT فنکشن سے onlyOwner کو ہٹا دیں۔)

  • @openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol ERC-721 کو بڑھاتا ہے تاکہ ہر ٹوکن اپنا میٹا ڈیٹا URI محفوظ کر سکے، جسے ہم ڈھلائی کے وقت سیٹ کرتے ہیں۔

ہمارے درآمدی بیانات کے بعد، ہمارے پاس اپنا حسب ضرورت NFT سمارٹ کنٹریکٹ ہے، جو حیرت انگیز طور پر مختصر ہے — اس میں صرف ایک کاؤنٹر، ایک کنسٹرکٹر، اور ایک ہی فنکشن شامل ہے! یہ ہمارے وراثت میں ملنے والے اوپن زیپلن کنٹریکٹس کی بدولت ہے، جو ان زیادہ تر طریقوں کو نافذ کرتے ہیں جن کی ہمیں NFT بنانے کے لیے ضرورت ہوتی ہے، جیسے کہ ownerOf جو NFT کا مالک واپس کرتا ہے، اور transferFrom، جو NFT کی ملکیت کو ایک اکاؤنٹ سے دوسرے اکاؤنٹ میں منتقل کرتا ہے۔

کاؤنٹر، _nextTokenId، ڈھالے گئے NFTs کی کل تعداد کا ٹریک رکھتا ہے اور ہمارے نئے NFT پر منفرد ID سیٹ کرتا ہے۔ (سمارٹ کنٹریکٹ کا استعمال کرتے ہوئے ڈھالے گئے ہر NFT کو ایک منفرد ID تفویض کی جانی چاہیے—یہاں ہماری منفرد ID کا تعین صرف موجود NFTs کی کل تعداد سے ہوتا ہے۔ ++_nextTokenId استعمال ہونے سے پہلے کاؤنٹر کو بڑھاتا ہے، لہذا پہلے NFT جسے ہم اپنے سمارٹ کنٹریکٹ کے ساتھ ڈھالتے ہیں اس کی ID "1" ہوتی ہے، ہمارے دوسرے NFT کی ID "2" ہوتی ہے، وغیرہ۔)

ہمارے ERC-721 کنسٹرکٹر میں، آپ دیکھیں گے کہ ہم 2 سٹرنگز، "MyNFT" اور "NFT" پاس کرتے ہیں۔ پہلا متغیر سمارٹ کنٹریکٹ کا نام ہے، اور دوسرا اس کی علامت ہے۔ آپ ان میں سے ہر ایک متغیر کا نام جو چاہیں رکھ سکتے ہیں!

آخر میں، ہمارے پاس اپنا فنکشن mintNFT(address recipient, string memory tokenURI) ہے جو ہمیں ایک NFT ڈھالنے کی اجازت دیتا ہے! آپ دیکھیں گے کہ یہ فنکشن دو متغیرات لیتا ہے:

  • address recipient اس پتے کی وضاحت کرتا ہے جو آپ کا تازہ ڈھالا ہوا NFT وصول کرے گا

  • string memory tokenURI ایک سٹرنگ ہے جسے ایک JSON دستاویز میں حل ہونا چاہیے جو NFT کے میٹا ڈیٹا کو بیان کرتی ہے۔ ایک NFT کا میٹا ڈیٹا واقعی وہ چیز ہے جو اسے زندہ کرتا ہے، جس سے اس میں قابل ترتیب خصوصیات، جیسے کہ نام، تفصیل، تصویر، اور دیگر صفات شامل ہو سکتی ہیں۔ اس ٹیوٹوریل کے حصہ 2 میں، ہم بیان کریں گے کہ اس میٹا ڈیٹا کو کیسے ترتیب دیا جائے۔

mintNFT وراثت میں ملنے والی ERC-721 لائبریری سے کچھ طریقوں کو کال کرتا ہے، اور بالآخر ایک نمبر واپس کرتا ہے جو تازہ ڈھالے گئے NFT کی ID کی نمائندگی کرتا ہے۔

مرحلہ 11: میٹاماسک اور Alchemy کو اپنے پروجیکٹ سے جوڑیں

اب جب کہ ہم نے ایک میٹاماسک والیٹ، Alchemy اکاؤنٹ بنا لیا ہے، اور اپنا سمارٹ کنٹریکٹ لکھ لیا ہے، اب وقت آ گیا ہے کہ ان تینوں کو جوڑا جائے۔

آپ کے ورچوئل والیٹ سے بھیجی جانے والی ہر ٹرانزیکشن کے لیے آپ کی منفرد نجی کلید کا استعمال کرتے ہوئے دستخط کی ضرورت ہوتی ہے۔ ہمارے پروگرام کو یہ اجازت فراہم کرنے کے لیے، ہم اپنی نجی کلید (اور Alchemy API کلید) کو محفوظ طریقے سے ایک ماحولیاتی فائل میں محفوظ کر سکتے ہیں۔

ٹرانزیکشنز بھیجنے کے بارے میں مزید جاننے کے لیے، ٹرانزیکشنز کی دستاویزات دیکھیں۔

ہمارے پروجیکٹ کی روٹ ڈائرکٹری میں ایک .env فائل بنائیں، اور اس میں اپنی میٹاماسک نجی کلید اور HTTP Alchemy API URL شامل کریں۔

  • میٹاماسک سے اپنی نجی کلید برآمد کرنے کے لیے ان ہدایات (نئے ٹیب میں کھلتا ہے) پر عمل کریں

  • HTTP Alchemy API URL حاصل کرنے کے لیے نیچے دیکھیں اور اسے اپنے کلپ بورڈ پر کاپی کریں

آپ کا .env اب اس طرح نظر آنا چاہیے:

API_URL="https://eth-sepolia.g.alchemy.com/v2/your-api-key"
PRIVATE_KEY="your-metamask-private-key"

انہیں دراصل اپنے کوڈ سے جوڑنے کے لیے، ہم مرحلہ 13 میں اپنی hardhat.config.js فائل میں ان متغیرات کا حوالہ دیں گے۔ Node.js خود ہی .env فائلوں کو پڑھ سکتا ہے، اس لیے انسٹال کرنے کے لیے کوئی اضافی پیکیج نہیں ہے۔

⁦.env⁩ کو کمٹ نہ کریں! براہ کرم یقینی بنائیں کہ اپنی ⁦.env⁩ فائل کو کبھی کسی کے ساتھ شیئر یا ظاہر نہ کریں، کیونکہ ایسا کرنے سے آپ اپنے رازوں کو خطرے میں ڈال رہے ہیں۔ اگر آپ ورژن کنٹرول استعمال کر رہے ہیں، تو اپنی ⁦.env⁩ کو ⁦gitignore⁩ (نئے ٹیب میں کھلتا ہے) فائل میں شامل کریں۔

مرحلہ 12: Ethers.js انسٹال کریں

Ethers.js ایک لائبریری ہے جو معیاری جے سن آر پی سی (JSON-RPC) طریقوں کو زیادہ صارف دوست طریقوں کے ساتھ لپیٹ کر ایتھیریم کے ساتھ تعامل کرنے اور درخواستیں بھیجنے کو آسان بناتی ہے۔

Hardhat اضافی ٹولنگ اور توسیعی فعالیت کے لیے پلگ انز (نئے ٹیب میں کھلتا ہے) کو مربوط کرنا انتہائی آسان بناتا ہے۔ ہم کنٹریکٹ کی تعیناتی کے لیے Ethers پلگ ان (نئے ٹیب میں کھلتا ہے) کا فائدہ اٹھائیں گے (Ethers.js (نئے ٹیب میں کھلتا ہے) میں کنٹریکٹ کی تعیناتی کے کچھ انتہائی صاف طریقے ہیں)۔

اپنی پروجیکٹ ڈائرکٹری میں ٹائپ کریں:

npm install --save-dev @nomicfoundation/hardhat-ethers ethers

ہم اگلے مرحلے میں پلگ ان کو اپنی hardhat.config.js میں بھی شامل کریں گے۔

مرحلہ 13: hardhat.config.js کو اپ ڈیٹ کریں

ہم نے اب تک کئی انحصار اور پلگ انز شامل کیے ہیں، اب ہمیں hardhat.config.js کو اپ ڈیٹ کرنے کی ضرورت ہے تاکہ ہمارے پروجیکٹ کو ان سب کے بارے میں معلوم ہو۔

اپنی hardhat.config.js کو اس طرح نظر آنے کے لیے اپ ڈیٹ کریں:

configVariable Hardhat کو بتاتا ہے کہ وہ ہر قدر کو ماحولیاتی متغیر سے صرف اسی وقت پڑھے جب اس کی ضرورت ہو، لہذا compile جیسی کمانڈز اقدار کے سیٹ ہونے سے پہلے بھی کام کرتی ہیں۔ اگر آپ اپنی نجی کلید کو سادہ ٹیکسٹ فائل میں نہیں رکھنا چاہتے ہیں، تو Hardhat انکرپٹڈ کی اسٹور سے کنفیگریشن متغیرات (نئے ٹیب میں کھلتا ہے) بھی پڑھ سکتا ہے۔

مرحلہ 14: اپنا کنٹریکٹ مرتب کریں

یہ یقینی بنانے کے لیے کہ اب تک سب کچھ کام کر رہا ہے، آئیے اپنا کنٹریکٹ مرتب کریں۔ مرتب کرنے کا کام Hardhat کے بلٹ ان کاموں میں سے ایک ہے۔

کمانڈ لائن سے چلائیں:

npx hardhat compile

پہلی بار جب آپ مرتب کرتے ہیں، تو Hardhat Solidity کمپائلر ڈاؤن لوڈ کرتا ہے۔ اس کے بعد آپ کو کچھ اس طرح نظر آنا چاہیے Compiled 1 Solidity file with solc 0.8.34۔ اگر نہیں، تو آپ ہمیشہ Alchemy ڈسکارڈ (نئے ٹیب میں کھلتا ہے) میں پیغام بھیج سکتے ہیں۔

مرحلہ 15: اپنی تعیناتی کی سکرپٹ لکھیں

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

scripts/ فولڈر میں جائیں اور deploy.js نامی ایک نئی فائل بنائیں، جس میں درج ذیل مشمولات شامل کریں:

آئیے دیکھتے ہیں کہ کوڈ کی ان میں سے ہر ایک لائن کیا کرتی ہے۔

const { ethers } = await network.create()

Hardhat 3 میں، ایک سکرپٹ واضح طور پر نیٹ ورک سے کنکشن کھولتی ہے۔ network.create() اس نیٹ ورک سے جڑتا ہے جسے آپ سکرپٹ چلاتے وقت --network آپشن کے ساتھ منتخب کرتے ہیں، اور hardhat-ethers پلگ ان اس کنکشن میں ایک ethers آبجیکٹ شامل کرتا ہے۔

const [deployer] = await ethers.getSigners()

getSigners() نیٹ ورک کے لیے کنفیگر کیے گئے اکاؤنٹس واپس کرتا ہے۔ Sepolia پر، یہ وہ اکاؤنٹ ہے جس کی نجی کلید آپ نے .env میں رکھی ہے۔ ہم اس کا پتہ کنسٹرکٹر کو پاس کرتے ہیں تاکہ آپ کنٹریکٹ کے مالک بن جائیں۔

const MyNFT = await ethers.getContractFactory("MyNFT")

Ethers.js میں ایک ContractFactory ایک تجرید ہے جسے نئے سمارٹ کنٹریکٹس کو تعینات کرنے کے لیے استعمال کیا جاتا ہے، لہذا یہاں MyNFT ہمارے NFT کنٹریکٹ کی مثالوں کے لیے ایک فیکٹری ہے۔ hardhat-ethers پلگ ان کا استعمال کرتے وقت ContractFactory اور Contract کی مثالیں پہلے سے طے شدہ طور پر پہلے دستخط کنندہ سے جڑی ہوتی ہیں۔

const myNFT = await MyNFT.deploy(deployer.address)

ContractFactory پر deploy() کو کال کرنے سے تعیناتی شروع ہو جائے گی، اور ایک Promise واپس آئے گا جو ایک Contract میں حل ہوتا ہے۔ یہ وہ آبجیکٹ ہے جس میں ہمارے سمارٹ کنٹریکٹ کے ہر فنکشن کے لیے ایک طریقہ ہوتا ہے۔ جو دلائل آپ deploy() کو پاس کرتے ہیں وہ کنٹریکٹ کے کنسٹرکٹر میں جاتے ہیں، یہاں initialOwner کا پتہ۔

waitForDeployment() اس وقت تک انتظار کرتا ہے جب تک کہ تعیناتی کی ٹرانزیکشن کسی بلاک میں شامل نہ ہو جائے، اور getAddress() نئے کنٹریکٹ کا پتہ واپس کرتا ہے۔ مزید تفصیلات کے لیے ethers.js کنٹریکٹ کی دستاویزات (نئے ٹیب میں کھلتا ہے) دیکھیں۔

مرحلہ 16: اپنا کنٹریکٹ تعینات کریں

ہم بالآخر اپنا سمارٹ کنٹریکٹ تعینات کرنے کے لیے تیار ہیں! اپنی پروجیکٹ ڈائرکٹری کی روٹ پر واپس جائیں، اور کمانڈ لائن میں چلائیں:

npx hardhat run scripts/deploy.js --network sepolia

اس کے بعد آپ کو کچھ اس طرح نظر آنا چاہیے:

Contract deployed to address: 0x4C5266cCc4b3F426965d2f51b6D910325a0E7650

اگر ہم Sepolia Etherscan (نئے ٹیب میں کھلتا ہے) پر جائیں اور اپنے کنٹریکٹ کا پتہ تلاش کریں تو ہمیں یہ دیکھنے کے قابل ہونا چاہیے کہ اسے کامیابی کے ساتھ تعینات کر دیا گیا ہے۔ اگر آپ اسے فوری طور پر نہیں دیکھ سکتے ہیں، تو براہ کرم تھوڑی دیر انتظار کریں کیونکہ اس میں کچھ وقت لگ سکتا ہے۔ ٹرانزیکشن کچھ اس طرح نظر آئے گی:

Etherscan پر اپنی ٹرانزیکشن کا پتہ دیکھیں

From کا پتہ آپ کے میٹاماسک اکاؤنٹ کے پتے سے مماثل ہونا چاہیے اور To کے پتے میں "Contract Creation" لکھا ہوگا۔ اگر ہم ٹرانزیکشن پر کلک کرتے ہیں، تو ہم To فیلڈ میں اپنے کنٹریکٹ کا پتہ دیکھیں گے:

Etherscan پر اپنے کنٹریکٹ کا پتہ دیکھیں

زبردست! آپ نے ابھی اپنا NFT سمارٹ کنٹریکٹ ایتھیریم (آزمائشی نیٹ ورک) چین پر تعینات کیا ہے!

یہ سمجھنے کے لیے کہ اندرونی طور پر کیا ہو رہا ہے، آپ ان درخواستوں کو دیکھ سکتے ہیں جو آپ کی ایپ کو آپ کے Alchemy ڈیش بورڈ (نئے ٹیب میں کھلتا ہے) میں موصول ہوئی ہیں۔

وہاں آپ کو مٹھی بھر جے سن آر پی سی (JSON-RPC) کالز نظر آئیں گی جو Hardhat/Ethers نے ہمارے لیے اندرونی طور پر کی تھیں جب ہم نے .deploy() فنکشن کو کال کیا تھا۔ یہاں ذکر کرنے کے لیے دو اہم کالز eth_sendRawTransaction ہیں، جو دراصل ہمارے سمارٹ کنٹریکٹ کو Sepolia چین پر لکھنے کی درخواست ہے، اور eth_getTransactionByHash جو ہیش دیے جانے پر ہماری ٹرانزیکشن کے بارے میں معلومات پڑھنے کی درخواست ہے (ٹرانزیکشنز بھیجتے وقت ایک عام نمونہ)۔ ٹرانزیکشنز بھیجنے کے بارے میں مزید جاننے کے لیے، ٹرانزیکشنز کی دستاویزات دیکھیں۔

اس ٹیوٹوریل کے حصہ 1 کے لیے بس اتنا ہی۔ حصہ 2 میں، ہم دراصل ایک NFT ڈھال کر اپنے سمارٹ کنٹریکٹ کے ساتھ تعامل کریں گے، اور حصہ 3 میں ہم آپ کو دکھائیں گے کہ اپنے ایتھیریم والیٹ میں اپنا NFT کیسے دیکھا جائے!