Standar Token Non-Fungible ERC-721

Pendahuluan

Apa itu Token Non-Fungible?

Token yang Tidak Dapat Dipertukarkan (NFT) digunakan untuk mengenali sesuatu atau seseorang dengan cara yang unik. Jenis Token ini tepat untuk digunakan pada platform yang menawarkan item yang dapat dikoleksi, kunci akses, tiket lotre, kursi bernomor untuk konser dan pertandingan olahraga, dll. Jenis Token spesial ini memiliki kemungkinan yang luar biasa sehingga layak mendapatkan Standar yang sesuai, ERC-721 hadir untuk memecahkannya!

Apa itu ERC-721?

ERC-721 memperkenalkan sebuah standar untuk NFT, dengan kata lain, tipe Token ini adalah unik dan bisa memiliki nilai yang berbeda dari Token lainnya yang berasal dari Kontrak Pintar yang sama, mungkin dikarenakan usia, keunikan, atau bahkan hal lain seperti visualnya. Tunggu, visualnya?

Ya! Semua NFT memiliki variabel uint256 yang disebut tokenId, sehingga untuk Kontrak ERC-721 mana pun, pasangan contract address, uint256 tokenId harus bersifat unik secara global. Anggap saja, dApp bisa memiliki "konverter" yang menggunakan tokenId sebagai input dan output gambar dari sesuatu yang keren, seperti zombi, senjata, kemampuan, atau anak kucing yang menakjubkan!

Prasyarat

Tubuh

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

ERC-721 ini menyediakan fungsionalitas seperti mentransfer token dari satu akun ke akun lainnya, mendapatkan informasi saldo token saat ini dari sebuah akun, mendapatkan pemilik token tertentu, dan juga informasi persediaan total dari token yang tersedia di jaringan. Selain itu, juga memiliki beberapa fungsionalitas lain seperti memberi persetujuan untuk pemindahan sejumlah token dari sebuah akun oleh akun pihak ketiga.

Jika Kontrak Pintar menerapkan metode dan aksi berikut, kontrak itu dapat disebut Kontrak Token yang Tidak Dapat Dipertukarkan ERC-721 dan, setelah digunakan, akan bertanggungjawab untuk melacak token yang dibuat di Ethereum.

Dari EIP-721(opens in a new tab):

Metode

1    function balanceOf(address _owner) external view returns (uint256);
2    function ownerOf(uint256 _tokenId) external view returns (address);
3    function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;
4    function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;
5    function transferFrom(address _from, address _to, uint256 _tokenId) external payable;
6    function approve(address _approved, uint256 _tokenId) external payable;
7    function setApprovalForAll(address _operator, bool _approved) external;
8    function getApproved(uint256 _tokenId) external view returns (address);
9    function isApprovedForAll(address _owner, address _operator) external view returns (bool);
Tampilkan semua
 Salin

Aksi

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

Contoh

Mari kita lihat bagaimana sebuah Standar begitu penting untuk mempermudah pemeriksaan Kontrak Token ERC-721 di Ethereum. Kita hanya memerlukan Application Binary Interface (ABI) Kontrak untuk membuat antarmuka untuk Token ERC-721 mana pun. Seperti yang dapat Anda lihat di bawah, kita akan menggunakan satu ABI yang disederhanakan, untuk membuatnya menjadi contoh bergesekan rendah.

Contoh Web3.py

Pertama-tama, pastikan Anda telah menginstal pustaka Python Web3.py(opens in a new tab):

1pip install web3

1from web3 import Web3
2from web3._utils.events import get_event_data
3
4
5w3 = Web3(Web3.HTTPProvider("https://cloudflare-eth.com"))
6
7ck_token_addr = "0x06012c8cf97BEaD5deAe237070F9587f8E7A266d"    # CryptoKitties Contract
8
9acc_address = "0xb1690C08E213a35Ed9bAb7B318DE14420FB57d8C"      # CryptoKitties Sales Auction
10
11# Ini adalah sebuah Kontrak Application Binary Interface (ABI) yang disederhanakan dari kontrak NFT ERC-721.
12# Kontrak akan hanya menampilkan metode: balanceOf(address), name(), ownerOf(tokenId), symbol(), totalSupply()
13simplified_abi = [
14    {
15        'inputs': [{'internalType': 'address', 'name': 'owner', 'type': 'address'}],
16        'name': 'balanceOf',
17        'outputs': [{'internalType': 'uint256', 'name': '', 'type': 'uint256'}],
18        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
19    },
20    {
21        'inputs': [],
22        'name': 'name',
23        'outputs': [{'internalType': 'string', 'name': '', 'type': 'string'}],
24        'stateMutability': 'view', 'type': 'function', 'constant': True
25    },
26    {
27        'inputs': [{'internalType': 'uint256', 'name': 'tokenId', 'type': 'uint256'}],
28        'name': 'ownerOf',
29        'outputs': [{'internalType': 'address', 'name': '', 'type': 'address'}],
30        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
31    },
32    {
33        'inputs': [],
34        'name': 'symbol',
35        'outputs': [{'internalType': 'string', 'name': '', 'type': 'string'}],
36        'stateMutability': 'view', 'type': 'function', 'constant': True
37    },
38    {
39        'inputs': [],
40        'name': 'totalSupply',
41        'outputs': [{'internalType': 'uint256', 'name': '', 'type': 'uint256'}],
42        'stateMutability': 'view', 'type': 'function', 'constant': True
43    },
44]
45
46ck_extra_abi = [
47    {
48        'inputs': [],
49        'name': 'pregnantKitties',
50        'outputs': [{'name': '', 'type': 'uint256'}],
51        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
52    },
53    {
54        'inputs': [{'name': '_kittyId', 'type': 'uint256'}],
55        'name': 'isPregnant',
56        'outputs': [{'name': '', 'type': 'bool'}],
57        'payable': False, 'stateMutability': 'view', 'type': 'function', 'constant': True
58    }
59]
60
61ck_contract = w3.eth.contract(address=w3.toChecksumAddress(ck_token_addr), abi=simplified_abi+ck_extra_abi)
62name = ck_contract.functions.name().call()
63symbol = ck_contract.functions.symbol().call()
64kitties_auctions = ck_contract.functions.balanceOf(acc_address).call()
65print(f"{name} [{symbol}] NFTs in Auctions: {kitties_auctions}")
66
67pregnant_kitties = ck_contract.functions.pregnantKitties().call()
68print(f"{name} [{symbol}] NFTs Pregnants: {pregnant_kitties}")
69
70# Menggunakan ABI Aksi Transfer untuk mendapat informasi tentang Kitties yang ditransfer.
71tx_event_abi = {
72    'anonymous': False,
73    'inputs': [
74        {'indexed': False, 'name': 'from', 'type': 'address'},
75        {'indexed': False, 'name': 'to', 'type': 'address'},
76        {'indexed': False, 'name': 'tokenId', 'type': 'uint256'}],
77    'name': 'Transfer',
78    'type': 'event'
79}
80
81# Kita membutuhkan tanda tangan aksi untuk menyaring log
82event_signature = w3.sha3(text="Transfer(address,address,uint256)").hex()
83
84logs = w3.eth.getLogs({
85    "fromBlock": w3.eth.blockNumber - 120,
86    "address": w3.toChecksumAddress(ck_token_addr),
87    "topics": [event_signature]
88})
89
90# Catatan:
91#   - 120 blok adalah kisaran maksimum yang disediakan layanan Penyedia CloudFlare
92#   - Jika Anda tidak menemukan Transfer event apa pun, Anda juga dapat mendapatkan tokenId di:
93#       https://etherscan.io/address/0x06012c8cf97BEaD5deAe237070F9587f8E7A266d#events
94#       Klik untuk memperluas log aksi dan salin argumen "tokenId"nya
95
96recent_tx = [get_event_data(w3.codec, tx_event_abi, log)["args"] for log in logs]
97
98kitty_id = recent_tx[0]['tokenId'] # Paste the "tokenId" here from the link above
99is_pregnant = ck_contract.functions.isPregnant(kitty_id).call()
100print(f"{name} [{symbol}] NFTs {kitty_id} is pregnant: {is_pregnant}")
Tampilkan semua
 Salin

Kontrak CryptoKitties memiliki beberapa Aksi menarik selain dari aksi Standar.

Mari kita lihat dua di antaranya, Pregnant dan Birth.

1# Menggunakan ABI Aksi Pregnant dan Birth untuk mendapatkan informasi tentang Kitties baru.
2ck_extra_events_abi = [
3    {
4        'anonymous': False,
5        'inputs': [
6            {'indexed': False, 'name': 'owner', 'type': 'address'},
7            {'indexed': False, 'name': 'matronId', 'type': 'uint256'},
8            {'indexed': False, 'name': 'sireId', 'type': 'uint256'},
9            {'indexed': False, 'name': 'cooldownEndBlock', 'type': 'uint256'}],
10        'name': 'Pregnant',
11        'type': 'event'
12    },
13    {
14        'anonymous': False,
15        'inputs': [
16            {'indexed': False, 'name': 'owner', 'type': 'address'},
17            {'indexed': False, 'name': 'kittyId', 'type': 'uint256'},
18            {'indexed': False, 'name': 'matronId', 'type': 'uint256'},
19            {'indexed': False, 'name': 'sireId', 'type': 'uint256'},
20            {'indexed': False, 'name': 'genes', 'type': 'uint256'}],
21        'name': 'Birth',
22        'type': 'event'
23    }]
24
25# Kita membutuhkan tanda tangan aksi untuk menyaring log
26ck_event_signatures = [
27    w3.sha3(text="Pregnant(address,uint256,uint256,uint256)").hex(),
28    w3.sha3(text="Birth(address,uint256,uint256,uint256,uint256)").hex(),
29]
30
31# Berikut adalah Aksi Pregnant:
32# - https://etherscan.io/tx/0xc97eb514a41004acc447ac9d0d6a27ea6da305ac8b877dff37e49db42e1f8cef#eventlog
33pregnant_logs = w3.eth.getLogs({
34    "fromBlock": w3.eth.blockNumber - 120,
35    "address": w3.toChecksumAddress(ck_token_addr),
36    "topics": [ck_event_signatures[0]]
37})
38
39recent_pregnants = [get_event_data(w3.codec, ck_extra_events_abi[0], log)["args"] for log in pregnant_logs]
40
41# Berikut adalah Aksi Birth:
42# - https://etherscan.io/tx/0x3978028e08a25bb4c44f7877eb3573b9644309c044bf087e335397f16356340a
43birth_logs = w3.eth.getLogs({
44    "fromBlock": w3.eth.blockNumber - 120,
45    "address": w3.toChecksumAddress(ck_token_addr),
46    "topics": [ck_event_signatures[1]]
47})
48
49recent_births = [get_event_data(w3.codec, ck_extra_events_abi[1], log)["args"] for log in birth_logs]
Tampilkan semua
 Salin

NFT Populer

Pelacak NFT Etherscan(opens in a new tab) mendaftarkan NFT populer di Ethereum berdasarkan volume transfer.
CryptoKitties(opens in a new tab) adalah sebuah game yang berpusat pada mahluk yang dapat dikembangbiakkan, dikoleksi, dan begitu menggemaskan yang kita sebut CryptoKitties.
Sorare(opens in a new tab) adalah sebuah game sepakbola fantasi global di mana Anda bisa mengumpulkan item koleksi edisi terbatas, mengatur tim Anda, dan berkompetisi untuk mendapatkah hadiah.
Layanan Nama Ethereum (ENS)(opens in a new tab) menawarkan cara yang aman dan terdesentralisasi untuk mengelola sumber daya baik on dan off blockchain menggunakan nama yang sederhana dan mudah dimengerti.
Unstoppable Domains(opens in a new tab) adalah sebuah perusahaan berbasis di San Fransisco yang membangun domain di blockchain. Domain blockchain menggantikan alamat mata uang kripto dengan nama yang mudah dimengerti dan bisa digunakan untuk memungkinkan situs web yang tahan penyensoran.
Gods Unchained Cards(opens in a new tab) adalah sebuah TCG pada blockchain Ethereum yang menggunakan NFT untuk membawa kepemilikan asli ke aset dalam game.
Bored Ape Yacht Club(opens in a new tab) adalah koleksi dari 10.000 NFT unik, yang, selain merupakan karya seni langkah yang terbukti, bertindak sebagai token keanggotaan klub, yang menyediakan fasilitas dan keuntungan yang bertambah seiring dengan waktu sebagai hasil dari usaha komunitas.