ERC-721 非同質化代幣標準

介紹

什麼是非同質化代幣？

非同質化代幣 (NFT) 用於以獨一無二的方式來識別某物或某人。這類型的代幣非常適合在提供收藏品、密鑰、彩票、音樂會和體育比賽的編號座位等平台上使用。這種特殊類型的代幣具有驚人潛力，因此它應得一個適當標準，而 ERC-721 正是來解決這個問題！

什麼是 ERC-721？

ERC-721 引入了非同質化代幣標準，換句話說，這類型的代幣是獨一無二，並且可以與來自同一智慧型合約的另一種代幣有不同的價值，這可能是由於其存在時間、稀有性甚至是視覺觀感等其他原因。等一下，視覺觀感？

是的！所有 NFT 都有一個名為 tokenId 的 uint256 變數，因此對於任何 ERC-721 合約， contract address, uint256 tokenId 這組配對都必須是全域唯一的。話雖如此，一個去中心化應用程式可以有一個 "轉換器"，它使用 tokenId 作為輸入，並輸出一些很酷的東西的圖片，像是殭屍、武器、技能或超讚的貓咪！

先決條件

主旨

ERC-721（以太坊意見請求 721）由 William Entriken、Dieter Shirley、Jacob Evans、Nastassia Sachs 於 2018 年 1 月提出，是一種非同質化代幣標準，在智慧型合約中實作代幣應用程式介面。

它提供的功能包括將代幣從一個帳戶轉移到另一個帳戶、獲取帳戶當前的代幣餘額、獲取特定代幣的所有者以及網路上可用代幣的總供應量。此外它還有一些其他功能，例如批准帳戶中一定數量的代幣可以被第三方帳戶轉移。

如果智慧型合約實作以下方法和事件，則可以將其稱為 ERC-721 非同質化代幣合約。一旦部署，它將負責追蹤以太坊上創建的代幣。

來自 EIP-721 (opens in a new tab):

方法

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);
顯示全部

Events

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

範例

讓我們看看為何標準如此重要，去讓我們檢查以太坊上的任何 ERC-721 代幣合約變得簡單。我們只需要合約應用程式二進位介面 (ABI) 來創建任何 ERC-721 代幣的介面。如下所示，我們將使用簡化的 ABI，使其成為一個低門檻的範例。

Web3.py 範例

首先，請確認您已安裝 Web3.py (opens in a new tab) Python 函式庫：

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 合約
8
9acc_address = "0xb1690C08E213a35Ed9bAb7B318DE14420FB57d8C"      # CryptoKitties 銷售拍賣
10
11# 這是 ERC-721 NFT 合約的簡化版合約應用程式二進位介面 (ABI)。
12# 它只會公開以下方法：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：{kitties_auctions}")
66
67pregnant_kitties = ck_contract.functions.pregnantKitties().call()
68print(f"{name} [{symbol}] 懷孕中的 NFT：{pregnant_kitties}")
69
70# 使用 Transfer 事件 ABI 來取得已轉移貓咪的資訊。
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# 我們需要事件的簽章來篩選日誌
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# 注意：
91#   - 如果沒有回傳任何 Transfer 事件，請增加 120 這個區塊數量。
92#   - 如果找不到任何 Transfer 事件，您也可以嘗試在此處取得 tokenId：
93#       https://etherscan.io/address/0x06012c8cf97BEaD5deAe237070F9587f8E7A266d#events
94#       按一下以展開事件的日誌，並複製其「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'] # 從上面的連結將「tokenId」貼在此處
99    is_pregnant = ck_contract.functions.isPregnant(kitty_id).call()
100    print(f"{name} [{symbol}] NFT {kitty_id} 是否懷孕：{is_pregnant}")
顯示全部

除了標準事件外，謎戀貓合約還有一些有趣的事件。

讓我們檢查其中兩個：Pregnant 和 Birth。

1# 使用 Pregnant 和 Birth 事件的 ABI 來取得新貓咪的資訊。
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# 我們需要事件的簽章來篩選日誌
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# 這是一個 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# 這是一個 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]
顯示全部

ERC-721 非同質化代幣標準

介紹

先決條件

主旨

方法

Events

範例

Web3.py 範例

熱門 NFT

延伸閱讀

這篇文章對你有幫助嗎？