Standar Token Tidak Sepadan ERC-721

Pengantar

Apa itu Token Tidak Sepadan?

Token Tidak Sepadan (NFT) digunakan untuk mengidentifikasi sesuatu atau seseorang dengan cara yang unik. Jenis Token ini sangat cocok untuk digunakan pada platform yang menawarkan barang koleksi, kunci akses, tiket lotre, kursi bernomor untuk konser dan pertandingan olahraga, dll. Jenis Token khusus ini memiliki kemungkinan yang luar biasa sehingga layak mendapatkan Standar yang tepat, ERC-721 hadir untuk menyelesaikannya!

Apa itu ERC-721?

ERC-721 memperkenalkan standar untuk NFT, dengan kata lain, jenis Token ini unik dan dapat memiliki nilai yang berbeda dari Token lain dari Kontrak Pintar yang sama, mungkin karena usianya, kelangkaannya, atau bahkan hal lain seperti visualnya. Tunggu, visual?

Ya! Semua NFT memiliki variabel uint256 yang disebut tokenId, jadi untuk Kontrak ERC-721 mana pun, pasangan contract address, uint256 tokenId harus unik secara global. Oleh karena itu, aplikasi terdesentralisasi (dapp) dapat memiliki "konverter" yang menggunakan tokenId sebagai masukan dan menghasilkan gambar sesuatu yang keren, seperti zombi, senjata, keterampilan, atau anak kucing yang luar biasa!

Prasyarat

Isi

ERC-721 (Ethereum Request for Comments 721), yang diusulkan oleh William Entriken, Dieter Shirley, Jacob Evans, Nastassia Sachs pada Januari 2018, adalah Standar Token Tidak Sepadan yang mengimplementasikan API untuk token di dalam Kontrak Pintar.

Ini menyediakan fungsionalitas seperti mentransfer token dari satu akun ke akun lain, untuk mendapatkan saldo token saat ini dari sebuah akun, untuk mendapatkan pemilik token tertentu dan juga total pasokan token yang tersedia di jaringan. Selain itu, ia juga memiliki beberapa fungsionalitas lain seperti menyetujui bahwa sejumlah token dari suatu akun dapat dipindahkan oleh akun pihak ketiga.

Jika sebuah Kontrak Pintar mengimplementasikan metode dan peristiwa berikut, ia dapat disebut Kontrak Token Tidak Sepadan ERC-721 dan, setelah disebarkan, ia akan bertanggung jawab untuk melacak token yang dibuat di Ethereum.

Dari EIP-721 (terbuka di tab baru):

Metode

    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);

Peristiwa

    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);

Contoh

Mari kita lihat bagaimana sebuah Standar sangat penting untuk memudahkan kita memeriksa Kontrak Token ERC-721 apa pun di Ethereum. Kita hanya memerlukan Antarmuka Biner Aplikasi (ABI) Kontrak untuk membuat antarmuka ke Token ERC-721 mana pun. Seperti yang dapat Anda lihat di bawah, kita akan menggunakan ABI yang disederhanakan, untuk menjadikannya contoh yang mudah dipahami.

Contoh Web3.py

Pertama, pastikan Anda telah menginstal Pustaka Python Web3.py (terbuka di tab baru):

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"    # Kontrak CryptoKitties

acc_address = "0xb1690C08E213a35Ed9bAb7B318DE14420FB57d8C"      # Lelang Penjualan CryptoKitties

# Ini adalah Application Binary Interface (ABI) Kontrak yang disederhanakan dari Kontrak NFT ERC-721.
# Ini hanya akan mengekspos metode: 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}")

# Menggunakan ABI Peristiwa Transfer untuk mendapatkan info tentang Kitties yang ditransfer.
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'
}

# Kita memerlukan tanda tangan peristiwa untuk memfilter log
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]
})

# Catatan:
#   - Tingkatkan jumlah blok lebih dari 120 jika tidak ada peristiwa Transfer yang dikembalikan.
#   - Jika Anda tidak menemukan peristiwa Transfer apa pun, Anda juga dapat mencoba mendapatkan tokenId di:
#       https://etherscan.io/address/0x06012c8cf97BEaD5deAe237070F9587f8E7A266d#events
#       Klik untuk memperluas log peristiwa dan salin argumen "tokenId"-nya
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'] # Tempel "tokenId" di sini dari tautan di atas
    is_pregnant = ck_contract.functions.isPregnant(kitty_id).call()
    print(f"{name} [{symbol}] NFTs {kitty_id} is pregnant: {is_pregnant}")

Kontrak CryptoKitties memiliki beberapa Peristiwa menarik selain yang Standar.

Mari kita periksa dua di antaranya, Pregnant dan Birth.

# Menggunakan ABI Peristiwa Pregnant dan Birth untuk mendapatkan info tentang Kitties baru.
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'
    }]

# Kita memerlukan tanda tangan peristiwa untuk memfilter log
ck_event_signatures = [
    w3.keccak(text="Pregnant(address,uint256,uint256,uint256)").hex(),
    w3.keccak(text="Birth(address,uint256,uint256,uint256,uint256)").hex(),
]

# Berikut adalah Peristiwa 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]

# Berikut adalah Peristiwa 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]

NFT Populer

Pelacak NFT Etherscan (terbuka di tab baru) mencantumkan NFT teratas di Ethereum berdasarkan volume transfer.
CryptoKitties (terbuka di tab baru) adalah permainan yang berpusat pada makhluk yang dapat dikembangbiakkan, menjadi barang koleksi, dan sangat menggemaskan yang kita sebut CryptoKitties.
Sorare (terbuka di tab baru) adalah permainan sepak bola fantasi global di mana Anda dapat mengumpulkan barang koleksi edisi terbatas, mengelola tim Anda, dan bersaing untuk mendapatkan hadiah.
Ethereum Name Service (ENS) (terbuka di tab baru) menawarkan cara yang aman & terdesentralisasi untuk mengalamatkan sumber daya baik di dalam maupun di luar rantai blok menggunakan nama sederhana yang dapat dibaca manusia.
POAP (terbuka di tab baru) memberikan NFT gratis kepada orang-orang yang menghadiri acara atau menyelesaikan tindakan tertentu. POAP gratis untuk dibuat dan didistribusikan.
Unstoppable Domains (terbuka di tab baru) adalah perusahaan yang berbasis di San Francisco yang membangun domain di rantai blok. Domain rantai blok menggantikan alamat mata uang kripto dengan nama yang dapat dibaca manusia dan dapat digunakan untuk mengaktifkan situs web yang tahan sensor.
Kartu Gods Unchained (terbuka di tab baru) adalah TCG di rantai blok Ethereum yang menggunakan NFT untuk memberikan kepemilikan nyata pada aset dalam permainan.
Bored Ape Yacht Club (terbuka di tab baru) adalah koleksi 10.000 NFT unik, yang, selain menjadi karya seni yang terbukti langka, bertindak sebagai token keanggotaan ke klub, memberikan fasilitas dan manfaat anggota yang meningkat seiring waktu sebagai hasil dari upaya komunitas.

Bacaan lebih lanjut

Tutorial: Membangun dengan token tidak sepadan (ERC-721) di Ethereum

Panduan Kontrak ERC-721 Vyper – Panduan beranotasi dari kontrak NFT ERC-721 lengkap yang ditulis dalam Vyper.
Cara Menulis & Menyebarkan NFT (Bagian 1/3) – Panduan langkah demi langkah untuk menulis dan menyebarkan kontrak pintar ERC-721 pertama Anda.
Cara Mencetak NFT (Bagian 2/3) – Cara mencetak NFT ERC-721 menggunakan kontrak pintar Anda yang telah disebarkan dan Web3.
Cara Melihat NFT Anda di Dompet Anda (Bagian 3/3) – Cara menampilkan NFT yang Anda cetak di MetaMask setelah penyebaran.
Tutorial Pencetak NFT – Membangun dapp pencetakan NFT full-stack dengan frontend React, MetaMask, dan Alchemy.