ERC-721 – standard tokenów niewymiennych

Wprowadzenie

Czym jest niewymienny token (NFT)?

Niewymienny token (NFT) służy do identyfikacji czegoś lub kogoś w unikalny sposób. Ten typ tokenu jest idealny do użycia na platformach, które oferują przedmioty kolekcjonerskie, klucze dostępu, bilety loteryjne, numerowane miejsca na koncerty i mecze sportowe itp. Ten specjalny rodzaj tokena ma niesamowite możliwości, dlatego załuguje na właściwy standart i ERC-721 jest tym standardem.

Czym jest ERC-721?

ERC-721 wprowadza standard dla NFT, innymi słowy ten typ tokena jest unikalny i może mieć różną wartość niż inny token z tego samego inteligentnego kontraktu, być może ze względu na jego wiek, rzadkość, a nawet coś innego, jak jego wygląd. Czekaj, wizualnie?

Tak! Wszystkie NFT mają zmienną uint256 o nazwie tokenId, więc dla każdego kontraktu ERC-721 para adres kontraktu, uint256 tokenId musi być globalnie unikalna. To powiedziawszy, dappka może mieć „konwerter”, który używa tokenId jako danych wejściowych i wyświetla obraz czegoś fajnego, na przykład zombie, broni, umiejętności lub niesamowitych kociaków!

Wymagania wstępne

Treść

ERC-721 (Ethereum Request for Comments 721), zaproponowany przez Williama Entrikena, Dietera Shirleya, Jacoba Evansa, Nastassia Sachs w styczniu 2018 r. to standard tokenów niewymiennych, który implementuje interfejs API dla tokenów w ramach inteligentnych kontraktów.

Zapewnia funkcjonalności, takie jak transfer tokenów z jednego konta na drugie, uzyskanie aktualnego salda tokenów na koncie, uzyskanie informacji o właścicielu określonego tokena, a także o całkowitej podaży tokena dostępnej w sieci. Poza tym ma również kilka innych funkcji, takich jak zatwierdzanie, że ilość tokenu z konta może być wydana przez konto osób trzecich.

Jeśli inteligentny kontrakt implementuje następujące metody i zdarzenia, można go nazwać kontraktem tokenów niewymiennych ERC-721 , a po wdrożeniu będzie odpowiedzialny za śledzenie utworzonych tokenów w Ethereum.

Na podstawie EIP-721opens in a new tab:

Metody

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);
Pokaż wszystko

Zdarzenia

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

Przykłady

Zobaczmy, dlaczego standard jest tak ważny, aby ułatwić nam sprawdza kontraktów z tokenami ERC-721 na Ethereum. Potrzebujemy tylko interfejsu binarnego Umowy (ABI), aby utworzyć interfejs dla każdego tokenu ERC-721. Jak możesz zobaczyć poniżej, użyjemy uproszczonego ABI, aby zmniejszyć złożoność przykładu.

Przykład Web3.py

Najpierw upewnij się, że masz zainstalowaną bibliotekę Pythona Web3.pyopens 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"    # Kontrakt CryptoKitties
8
9acc_address = "0xb1690C08E213a35Ed9bAb7B318DE14420FB57d8C"      # Aukcja sprzedaży CryptoKitties
10
11# To jest uproszczony binarny interfejs aplikacji kontraktu (ABI) kontraktu ERC-721 NFT.
12# Udostępnia on tylko następujące metody: 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.to_checksum_address(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}] NFT na aukcjach: {kitties_auctions}")
66
67pregnant_kitties = ck_contract.functions.pregnantKitties().call()
68print(f"{name} [{symbol}] Ciężarne NFT: {pregnant_kitties}")
69
70# Użycie ABI zdarzenia Transfer do uzyskania informacji o przetransferowanych Kociakach.
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# Potrzebujemy sygnatury zdarzenia do filtrowania logów
82event_signature = w3.keccak(text="Transfer(address,address,uint256)").hex()
83
84logs = w3.eth.get_logs({
85    "fromBlock": w3.eth.block_number - 120,
86    "address": w3.to_checksum_address(ck_token_addr),
87    "topics": [event_signature]
88})
89
90# Uwagi:
91#   - Zwiększ liczbę bloków powyżej 120, jeśli żadne zdarzenie Transfer nie zostanie zwrócone.
92#   - Jeśli nie znalazłeś żadnego zdarzenia Transfer, możesz również spróbować uzyskać tokenId pod adresem:
93#       https://etherscan.io/address/0x06012c8cf97BEaD5deAe237070F9587f8E7A266d#events
94#       Kliknij, aby rozwinąć logi zdarzenia i skopiować jego argument „tokenId”
95recent_tx = [get_event_data(w3.codec, tx_event_abi, log)["args"] for log in logs]
96
97if recent_tx:
98    kitty_id = recent_tx[0]['tokenId'] # Wklej tutaj „tokenId” z powyższego linku
99    is_pregnant = ck_contract.functions.isPregnant(kitty_id).call()
100    print(f"{name} [{symbol}] NFT {kitty_id} jest w ciąży: {is_pregnant}")
Pokaż wszystko

Kontrakt CryptoKitties zawiera kilka ciekawych wydarzeń poza standardowymi.

Sprawdźmy dwa z nich, Pregnant i Birth.

1# Użycie ABI zdarzeń Pregnant i Birth do uzyskania informacji o nowych Kociakach.
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# Potrzebujemy sygnatury zdarzenia do filtrowania logów
26ck_event_signatures = [
27    w3.keccak(text="Pregnant(address,uint256,uint256,uint256)").hex(),
28    w3.keccak(text="Birth(address,uint256,uint256,uint256,uint256)").hex(),
29]
30
31# Oto zdarzenie Pregnant:
32# - https://etherscan.io/tx/0xc97eb514a41004acc447ac9d0d6a27ea6da305ac8b877dff37e49db42e1f8cef#eventlog
33pregnant_logs = w3.eth.get_logs({
34    "fromBlock": w3.eth.block_number - 120,
35    "address": w3.to_checksum_address(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# Oto zdarzenie Birth:
42# - https://etherscan.io/tx/0x3978028e08a25bb4c44f7877eb3573b9644309c044bf087e335397f16356340a
43birth_logs = w3.eth.get_logs({
44    "fromBlock": w3.eth.block_number - 120,
45    "address": w3.to_checksum_address(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]
Pokaż wszystko

Popularne NFT

Etherscan NFT Trackeropens in a new tab wyświetla listę najpopularniejszych NFT na Ethereum według wolumenu transferów.
CryptoKittiesopens in a new tab to gra o hodowaniu i kolekcjonowaniu przesłodkich stworzeń, które nazywamy CryptoKitties.
Sorareopens in a new tab to globalna gra piłkarska typu fantasy, w której można zbierać przedmioty kolekcjonerskie z limitowanych edycji, zarządzać swoimi drużynami i rywalizować o nagrody.
Usługa nazw Ethereum (ENS)opens in a new tab oferuje bezpieczny i zdecentralizowany sposób adresowania zasobów zarówno w blockchainie, jak i poza nim, przy użyciu prostych, czytelnych dla człowieka nazw.
POAPopens in a new tab dostarcza darmowe NFT osobom, które uczestniczą w wydarzeniach lub wykonują określone działania. POAPy tworzy się i rozpowszechnia za darmo.
Unstoppable Domainsopens in a new tab to firma z siedzibą w San Francisco, która tworzy domeny na blockchainach. Domeny blockchain zastępują adresy kryptowalut nazwami czytelnymi dla człowieka i mogą być używane do tworzenia stron internetowych odpornych na cenzurę.
Gods Unchained Cardsopens in a new tab to gra karciana TCG na blockchainie Ethereum, która wykorzystuje NFT do zapewnienia prawdziwej własności aktywów w grze.
Bored Ape Yacht Clubopens in a new tab to kolekcja 10 000 unikalnych NFT, która oprócz tego, że jest dziełem sztuki o udowodnionej rzadkości, działa jako token członkowski klubu, zapewniając członkom przywileje i korzyści, które z czasem rosną w wyniku wysiłków społeczności.