⁦ERC-721⁩ غیر قابل تبادلہ ٹوکن سٹینڈرڈ

تعارف

غیر قابل تبادلہ ٹوکن کیا ہے؟

ایک غیر قابل تبادلہ ٹوکن (NFT) کسی چیز یا شخص کو منفرد انداز میں پہچاننے کے لیے استعمال ہوتا ہے۔ اس قسم کا ٹوکن ان پلیٹ فارمز پر استعمال کے لیے بہترین ہے جو قابل جمع اثاثہ جات، رسائی کی چابیاں، لاٹری ٹکٹ، کنسرٹس اور کھیلوں کے میچوں کے لیے نمبر والی نشستیں وغیرہ پیش کرتے ہیں۔ اس خاص قسم کے ٹوکن میں حیرت انگیز امکانات ہیں اس لیے یہ ایک مناسب سٹینڈرڈ کا مستحق ہے، ERC-721 نے اس مسئلے کو حل کیا ہے!

ERC-721 کیا ہے؟

ERC-721، NFT کے لیے ایک سٹینڈرڈ متعارف کراتا ہے، دوسرے الفاظ میں، اس قسم کا ٹوکن منفرد ہوتا ہے اور اسی سمارٹ کنٹریکٹ کے کسی دوسرے ٹوکن سے مختلف قدر رکھ سکتا ہے، شاید اس کی عمر، نایاب ہونے یا اس کی ظاہری شکل جیسی کسی اور چیز کی وجہ سے۔ رکیے، ظاہری شکل؟

جی ہاں! تمام NFTs میں ایک uint256 متغیر ہوتا ہے جسے tokenId کہا جاتا ہے، لہذا کسی بھی ERC-721 کنٹریکٹ کے لیے، جوڑا contract address, uint256 tokenId عالمی سطح پر منفرد ہونا چاہیے۔ اس کے ساتھ، ایک غیر مرکزی ایپلی کیشن (dapp) میں ایک "کنورٹر" ہو سکتا ہے جو tokenId کو ان پٹ کے طور پر استعمال کرتا ہے اور کسی زبردست چیز کی تصویر آؤٹ پٹ کرتا ہے، جیسے زومبی، ہتھیار، مہارتیں یا حیرت انگیز کرپٹو کٹیز!

پیشگی شرائط

باڈی

ERC-721 (ایتھیریم Request for Comments 721)، جسے ولیم انٹریکن، ڈیٹر شرلی، جیکب ایونز، اور نسٹاسیا سیکس نے جنوری 2018 میں تجویز کیا تھا، ایک غیر قابل تبادلہ ٹوکن سٹینڈرڈ ہے جو سمارٹ کنٹریکٹس کے اندر ٹوکنز کے لیے ایک API نافذ کرتا ہے۔

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

اگر کوئی سمارٹ کنٹریکٹ درج ذیل طریقوں اور ایونٹس کو نافذ کرتا ہے تو اسے ERC-721 غیر قابل تبادلہ ٹوکن کنٹریکٹ کہا جا سکتا ہے اور، ایک بار تعینات کرنے کے بعد، یہ ایتھیریم پر بنائے گئے ٹوکنز کا ریکارڈ رکھنے کا ذمہ دار ہوگا۔

EIP-721 (opens in a new tab) سے:

طریقے (Methods)

    function balanceOf(address _owner) external view returns (uint256);
    function ownerOf(uint256 _tokenId) external view returns (address);
    function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;
    function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;
    function transferFrom(address _from, address _to, uint256 _tokenId) external payable;
    function approve(address _approved, uint256 _tokenId) external payable;
    function setApprovalForAll(address _operator, bool _approved) external;
    function getApproved(uint256 _tokenId) external view returns (address);
    function isApprovedForAll(address _owner, address _operator) external view returns (bool);

ایونٹس

    event Transfer(address indexed _from, address indexed _to, uint256 indexed _tokenId);
    event Approval(address indexed _owner, address indexed _approved, uint256 indexed _tokenId);
    event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);

مثالیں

آئیے دیکھتے ہیں کہ ایتھیریم پر کسی بھی ERC-721 ٹوکن کنٹریکٹ کا معائنہ کرنے کے لیے چیزوں کو آسان بنانے میں ایک سٹینڈرڈ کتنا اہم ہے۔ ہمیں کسی بھی ERC-721 ٹوکن کا انٹرفیس بنانے کے لیے صرف کنٹریکٹ ایپلیکیشن بائنری انٹرفیس (ABI) کی ضرورت ہے۔ جیسا کہ آپ نیچے دیکھ سکتے ہیں، ہم اسے ایک آسان مثال بنانے کے لیے ایک سادہ ABI استعمال کریں گے۔

Web3.py کی مثال

سب سے پہلے، یقینی بنائیں کہ آپ نے Web3.py (opens in a new tab) Python لائبریری انسٹال کر لی ہے:

pip install web3

from web3 import Web3
from web3._utils.events import get_event_data


w3 = Web3(Web3.HTTPProvider("https://cloudflare-eth.com"))

ck_token_addr = "0x06012c8cf97BEaD5deAe237070F9587f8E7A266d"    # کرپٹو کٹیز کنٹریکٹ

acc_address = "0xb1690C08E213a35Ed9bAb7B318DE14420FB57d8C"      # کرپٹو کٹیز کی فروخت کی نیلامی

# یہ ایک ERC-721 NFT کنٹریکٹ کا سادہ کنٹریکٹ ایپلیکیشن بائنری انٹرفیس (ABI) ہے۔
# یہ صرف ان میتھڈز کو ظاہر کرے گا: balanceOf(address), name(), ownerOf(tokenId), symbol(), totalSupply()
simplified_abi = [
    {
        'inputs': [{'internalType': 'address', 'name': 'owner', 'type': 'address'}],
        'name': 'balanceOf',
        'outputs': [{'internalType': 'uint256', 'name': '', 'type': 'uint256'}],
        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [],
        'name': 'name',
        'outputs': [{'internalType': 'string', 'name': '', 'type': 'string'}],
        'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [{'internalType': 'uint256', 'name': 'tokenId', 'type': 'uint256'}],
        'name': 'ownerOf',
        'outputs': [{'internalType': 'address', 'name': '', 'type': 'address'}],
        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [],
        'name': 'symbol',
        'outputs': [{'internalType': 'string', 'name': '', 'type': 'string'}],
        'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [],
        'name': 'totalSupply',
        'outputs': [{'internalType': 'uint256', 'name': '', 'type': 'uint256'}],
        'stateMutability': 'view', 'type': 'function', 'constant': True
    },
]

ck_extra_abi = [
    {
        'inputs': [],
        'name': 'pregnantKitties',
        'outputs': [{'name': '', 'type': 'uint256'}],
        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
    },
    {
        'inputs': [{'name': '_kittyId', 'type': 'uint256'}],
        'name': 'isPregnant',
        'outputs': [{'name': '', 'type': 'bool'}],
        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
    }
]

ck_contract = w3.eth.contract(address=w3.to_checksum_address(ck_token_addr), abi=simplified_abi+ck_extra_abi)
name = ck_contract.functions.name().call()
symbol = ck_contract.functions.symbol().call()
kitties_auctions = ck_contract.functions.balanceOf(acc_address).call()
print(f"{name} [{symbol}] NFTs in Auctions: {kitties_auctions}")

pregnant_kitties = ck_contract.functions.pregnantKitties().call()
print(f"{name} [{symbol}] NFTs Pregnants: {pregnant_kitties}")

# منتقل شدہ کٹیز کے بارے میں معلومات حاصل کرنے کے لیے منتقلی ایونٹ ABI کا استعمال۔
tx_event_abi = {
    'anonymous': False,
    'inputs': [
        {'indexed': False, 'name': 'from', 'type': 'address'},
        {'indexed': False, 'name': 'to', 'type': 'address'},
        {'indexed': False, 'name': 'tokenId', 'type': 'uint256'}],
    'name': 'Transfer',
    'type': 'event'
}

# لاگز کو فلٹر کرنے کے لیے ہمیں ایونٹ کے دستخط کی ضرورت ہے۔
event_signature = w3.keccak(text="Transfer(address,address,uint256)").hex()

logs = w3.eth.get_logs({
    "fromBlock": w3.eth.block_number - 120,
    "address": w3.to_checksum_address(ck_token_addr),
    "topics": [event_signature]
})

# نوٹس:
#   - اگر کوئی منتقلی ایونٹ واپس نہیں آتا ہے تو بلاکس کی تعداد 120 سے بڑھا دیں۔
#   - اگر آپ کو کوئی منتقلی ایونٹ نہیں ملا تو آپ یہاں سے بھی tokenId حاصل کرنے کی کوشش کر سکتے ہیں:
#       https://etherscan.io/address/0x06012c8cf97BEaD5deAe237070F9587f8E7A266d#events
#       ایونٹ کے لاگز کو پھیلانے کے لیے کلک کریں اور اس کا "tokenId" آرگومنٹ کاپی کریں
recent_tx = [get_event_data(w3.codec, tx_event_abi, log)["args"] for log in logs]

if recent_tx:
    kitty_id = recent_tx[0]['tokenId'] # اوپر دیے گئے لنک سے "tokenId" کو یہاں پیسٹ کریں
    is_pregnant = ck_contract.functions.isPregnant(kitty_id).call()
    print(f"{name} [{symbol}] NFTs {kitty_id} is pregnant: {is_pregnant}")

کرپٹو کٹیز کنٹریکٹ میں سٹینڈرڈ ایونٹس کے علاوہ کچھ دلچسپ ایونٹس بھی ہیں۔

آئیے ان میں سے دو کو چیک کرتے ہیں، Pregnant اور Birth۔

# نئی کٹیز کے بارے میں معلومات حاصل کرنے کے لیے Pregnant اور Birth ایونٹس ABI کا استعمال۔
ck_extra_events_abi = [
    {
        'anonymous': False,
        'inputs': [
            {'indexed': False, 'name': 'owner', 'type': 'address'},
            {'indexed': False, 'name': 'matronId', 'type': 'uint256'},
            {'indexed': False, 'name': 'sireId', 'type': 'uint256'},
            {'indexed': False, 'name': 'cooldownEndBlock', 'type': 'uint256'}],
        'name': 'Pregnant',
        'type': 'event'
    },
    {
        'anonymous': False,
        'inputs': [
            {'indexed': False, 'name': 'owner', 'type': 'address'},
            {'indexed': False, 'name': 'kittyId', 'type': 'uint256'},
            {'indexed': False, 'name': 'matronId', 'type': 'uint256'},
            {'indexed': False, 'name': 'sireId', 'type': 'uint256'},
            {'indexed': False, 'name': 'genes', 'type': 'uint256'}],
        'name': 'Birth',
        'type': 'event'
    }]

# لاگز کو فلٹر کرنے کے لیے ہمیں ایونٹ کے دستخط کی ضرورت ہے۔
ck_event_signatures = [
    w3.keccak(text="Pregnant(address,uint256,uint256,uint256)").hex(),
    w3.keccak(text="Birth(address,uint256,uint256,uint256,uint256)").hex(),
]

# یہاں ایک Pregnant ایونٹ ہے:
# - https://etherscan.io/tx/0xc97eb514a41004acc447ac9d0d6a27ea6da305ac8b877dff37e49db42e1f8cef#eventlog
pregnant_logs = w3.eth.get_logs({
    "fromBlock": w3.eth.block_number - 120,
    "address": w3.to_checksum_address(ck_token_addr),
    "topics": [ck_event_signatures[0]]
})

recent_pregnants = [get_event_data(w3.codec, ck_extra_events_abi[0], log)["args"] for log in pregnant_logs]

# یہاں ایک Birth ایونٹ ہے:
# - https://etherscan.io/tx/0x3978028e08a25bb4c44f7877eb3573b9644309c044bf087e335397f16356340a
birth_logs = w3.eth.get_logs({
    "fromBlock": w3.eth.block_number - 120,
    "address": w3.to_checksum_address(ck_token_addr),
    "topics": [ck_event_signatures[1]]
})

recent_births = [get_event_data(w3.codec, ck_extra_events_abi[1], log)["args"] for log in birth_logs]

مزید مطالعہ

ٹیوٹوریلز: ایتھیریم پر غیر قابل تبادلہ ٹوکنز (ERC-721) کے ساتھ تعمیر کریں

Vyper ERC-721 کنٹریکٹ واک تھرو – Vyper میں لکھے گئے ایک مکمل ERC-721 NFT کنٹریکٹ کا تشریحی جائزہ۔
ایک NFT کیسے لکھیں اور تعینات کریں (حصہ 1/3) – اپنا پہلا ERC-721 سمارٹ کنٹریکٹ لکھنے اور تعینات کرنے کے لیے مرحلہ وار گائیڈ۔
ایک NFT کیسے ڈھالیں (حصہ 2/3) – اپنے تعینات کردہ سمارٹ کنٹریکٹ اور Web3 کا استعمال کرتے ہوئے ERC-721 NFT کو ڈھالنے کا طریقہ۔
اپنے والیٹ میں اپنا NFT کیسے دیکھیں (حصہ 3/3) – تعیناتی کے بعد میٹاماسک میں اپنے ڈھالے گئے NFT کو دکھانے کا طریقہ۔
NFT منٹر ٹیوٹوریل – React فرنٹ اینڈ، میٹاماسک، اور Alchemy کے ساتھ ایک فل اسٹیک NFT ڈھلائی کی غیر مرکزی ایپلی کیشن (dapp) بنائیں۔