Hướng dẫn hợp đồng Vyper ERC-721

1# @dev Triển khai tiêu chuẩn token không thể thay thế ERC-721.
2# @author Ryuya Nakamura (@nrryuya)
3# Được sửa đổi từ: https://github.com/vyperlang/vyper/blob/de74722bf2d8718cca46902be165f9fe0e3641dd/examples/tokens/ERC721.vy
Sao chép

1from vyper.interfaces import ERC721
2
3implements: ERC721
Sao chép

1# Giao diện cho hợp đồng được gọi bởi safeTransferFrom()
2interface ERC721Receiver:
3    def onERC721Received(
Sao chép

1            _operator: địa chỉ,
2            _from: địa chỉ,
Sao chép

1            _tokenId: uint256,
Sao chép

1            _data: Byte[1024]
Sao chép

1        ) -> bytes32: view
Sao chép

1# @dev Phát ra khi quyền sở hữu của bất kỳ NFT nào thay đổi theo bất kỳ cơ chế nào. Sự kiện này phát ra khi các NFT được
2# tạo (`from` == 0) và bị hủy (`to` == 0). Ngoại lệ: trong quá trình tạo hợp đồng, bất kỳ
3# số lượng NFT nào cũng có thể được tạo và gán mà không phát ra Transfer. Tại thời điểm bất kỳ
4# lần chuyển nào, địa chỉ được phê duyệt cho NFT đó (nếu có) được đặt lại thành không.
5# @param _from Người gửi NFT (nếu địa chỉ là địa chỉ không thì cho biết tạo token).
6# @param _to Người nhận NFT (nếu địa chỉ là địa chỉ không thì cho biết hủy token).
7# @param _tokenId NFT đã được chuyển.
8event Transfer:
9    sender: indexed(address)
10    receiver: indexed(address)
11    tokenId: indexed(uint256)
Hiện tất cả
Sao chép

1# @dev Điều này phát ra khi địa chỉ được phê duyệt cho một NFT được thay đổi hoặc xác nhận lại. Địa chỉ
2# không cho biết không có địa chỉ được phê duyệt nào. Khi một sự kiện Transfer phát ra, điều này cũng
3# cho biết rằng địa chỉ được phê duyệt cho NFT đó (nếu có) được đặt lại thành không.
4# @param _owner Chủ sở hữu của NFT.
5# @param _approved Địa chỉ mà chúng tôi đang phê duyệt.
6# @param _tokenId NFT mà chúng tôi đang phê duyệt.
7event Approval:
8    owner: indexed(address)
9    approved: indexed(address)
10    tokenId: indexed(uint256)
Hiện tất cả
Sao chép

1# @dev Điều này phát ra khi một người vận hành được kích hoạt hoặc vô hiệu hóa cho một chủ sở hữu. Người vận hành có thể quản lý
2# tất cả các NFT của chủ sở hữu.
3# @param _owner Chủ sở hữu của NFT.
4# @param _operator Địa chỉ mà chúng tôi đang đặt quyền của người vận hành.
5# @param _approved Trạng thái quyền của người vận hành (true nếu quyền của người vận hành được cấp và false nếu
6# bị thu hồi).
7event ApprovalForAll:
8    owner: indexed(address)
9    operator: indexed(address)
10    approved: bool
Hiện tất cả
Sao chép

1# @dev Ánh xạ từ ID NFT đến địa chỉ sở hữu nó.
2idToOwner: HashMap[uint256, address]
3
4# @dev Ánh xạ từ ID NFT đến địa chỉ được phê duyệt.
5idToApprovals: HashMap[uint256, address]
Sao chép

1# @dev Ánh xạ từ địa chỉ chủ sở hữu đến số lượng token của anh ấy.
2ownerToNFTokenCount: HashMap[address, uint256]
Sao chép

1# @dev Ánh xạ từ địa chỉ chủ sở hữu đến ánh xạ các địa chỉ của người vận hành.
2ownerToOperators: HashMap[address, HashMap[address, bool]]
Sao chép

1# @dev Địa chỉ của người đúc, người có thể đúc một token
2minter: address
Sao chép

1# @dev Ánh xạ của id giao diện đến bool về việc nó có được hỗ trợ hay không
2supportedInterfaces: HashMap[bytes32, bool]
3
4# @dev ID giao diện ERC165 của ERC165
5ERC165_INTERFACE_ID: constant(bytes32) = 0x0000000000000000000000000000000000000000000000000000000001ffc9a7
6
7# @dev ID giao diện ERC165 của ERC721
8ERC721_INTERFACE_ID: constant(bytes32) = 0x0000000000000000000000000000000000000000000000000000000080ac58cd
Sao chép

1@external
2def __init__():
Sao chép

1    """
2    @dev Hàm khởi tạo hợp đồng.
3    """
Sao chép

1    self.supportedInterfaces[ERC165_INTERFACE_ID] = True
2    self.supportedInterfaces[ERC721_INTERFACE_ID] = True
3    self.minter = msg.sender
Sao chép

1@view
2@external
Sao chép

1def supportsInterface(_interfaceID: bytes32) -> bool:
Sao chép

1    """
2    @dev Việc xác định giao diện được chỉ định trong ERC-165.
3    @param _interfaceID Id của giao diện
4    """
5    return self.supportedInterfaces[_interfaceID]
Sao chép

1### XEM HÀM ###
2
Sao chép

1@view
2@external
3def balanceOf(_owner: address) -> uint256:
4    """
5    @dev Trả về số lượng NFT thuộc sở hữu của `_owner`.
6         Thông báo lỗi nếu `_owner` là địa chỉ không. Các NFT được gán cho địa chỉ không được coi là không hợp lệ.
7    @param _owner Địa chỉ để truy vấn số dư.
8    """
9    assert _owner != ZERO_ADDRESS
Hiện tất cả
Sao chép

1    return self.ownerToNFTokenCount[_owner]
2
3@view
4@external
5def ownerOf(_tokenId: uint256) -> address:
6    """
7    @dev Trả về địa chỉ của chủ sở hữu NFT.
8         Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ.
9    @param _tokenId Mã định danh cho một NFT.
10    """
11    owner: address = self.idToOwner[_tokenId]
12    # Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ
13    assert owner != ZERO_ADDRESS
14    return owner
Hiện tất cả
Sao chép

1@view
2@external
3def getApproved(_tokenId: uint256) -> address:
4    """
5    @dev Nhận địa chỉ được phê duyệt cho một NFT duy nhất.
6         Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ.
7    @param _tokenId ID của NFT để truy vấn sự phê duyệt.
8    """
9    # Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ
10    assert self.idToOwner[_tokenId] != ZERO_ADDRESS
11    return self.idToApprovals[_tokenId]
Hiện tất cả
Sao chép

1@view
2@external
3def isApprovedForAll(_owner: address, _operator: address) -> bool:
4    """
5    @dev Kiểm tra xem `_operator` có phải là người vận hành được phê duyệt cho `_owner` không.
6    @param _owner Địa chỉ sở hữu các NFT.
7    @param _operator Địa chỉ hoạt động thay mặt cho chủ sở hữu.
8    """
9    return (self.ownerToOperators[_owner])[_operator]
Hiện tất cả
Sao chép

1
2### TRỢ GIÚP HÀM CHUYỂN ###
3
4@view
5@internal
Sao chép

1def _isApprovedOrOwner(_spender: address, _tokenId: uint256) -> bool:
2    """
3    @dev Trả về liệu người chi tiêu đã cho có thể chuyển một id token đã cho hay không
4    @param spender địa chỉ của người chi tiêu để truy vấn
5    @param tokenId uint256 ID của token sẽ được chuyển
6    @return bool liệu msg.sender có được chấp thuận cho id token đã cho hay không,
7        là một người vận hành của chủ sở hữu, hoặc là chủ sở hữu của token
8    """
9    owner: address = self.idToOwner[_tokenId]
10    spenderIsOwner: bool = owner == _spender
11    spenderIsApproved: bool = _spender == self.idToApprovals[_tokenId]
12    spenderIsApprovedForAll: bool = (self.ownerToOperators[owner])[_spender]
13    return (spenderIsOwner or spenderIsApproved) or spenderIsApprovedForAll
Hiện tất cả
Sao chép

1@internal
2def _addTokenTo(_to: address, _tokenId: uint256):
3    """
4    @dev Thêm một NFT vào một địa chỉ đã cho
5         Thông báo lỗi nếu `_tokenId` được sở hữu bởi ai đó.
6    """
7    # Thông báo lỗi nếu `_tokenId` được sở hữu bởi ai đó
8    assert self.idToOwner[_tokenId] == ZERO_ADDRESS
9    # Thay đổi chủ sở hữu
10    self.idToOwner[_tokenId] = _to
11    # Thay đổi theo dõi số lượng
12    self.ownerToNFTokenCount[_to] += 1
13
14
15@internal
16def _removeTokenFrom(_from: address, _tokenId: uint256):
17    """
18    @dev Xóa một NFT khỏi một địa chỉ đã cho
19         Thông báo lỗi nếu `_from` không phải là chủ sở hữu hiện tại.
20    """
21    # Thông báo lỗi nếu `_from` không phải là chủ sở hữu hiện tại
22    assert self.idToOwner[_tokenId] == _from
23    # Thay đổi chủ sở hữu
24    self.idToOwner[_tokenId] = ZERO_ADDRESS
25    # Thay đổi theo dõi số lượng
26    self.ownerToNFTokenCount[_from] -= 1
Hiện tất cả
Sao chép

1@internal
2def _clearApproval(_owner: address, _tokenId: uint256):
3    """
4    @dev Xóa sự phê duyệt của một địa chỉ đã cho
5         Thông báo lỗi nếu `_owner` không phải là chủ sở hữu hiện tại.
6    """
7    # Thông báo lỗi nếu `_owner` không phải là chủ sở hữu hiện tại
8    assert self.idToOwner[_tokenId] == _owner
9    if self.idToApprovals[_tokenId] != ZERO_ADDRESS:
10        # Đặt lại các phê duyệt
11        self.idToApprovals[_tokenId] = ZERO_ADDRESS
Hiện tất cả
Sao chép

1@internal
2def _transferFrom(_from: address, _to: address, _tokenId: uint256, _sender: address):
3    """
4    @dev Thực hiện chuyển một NFT.
5         Thông báo lỗi trừ khi `msg.sender` là chủ sở hữu hiện tại, một người vận hành được ủy quyền, hoặc địa chỉ được phê duyệt
6         cho NFT này. (LƯU Ý: `msg.sender` không được phép trong hàm riêng tư nên truyền `_sender`.)
7         Thông báo lỗi nếu `_to` là địa chỉ không.
8         Thông báo lỗi nếu `_from` không phải là chủ sở hữu hiện tại.
9         Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ.
10    """
Hiện tất cả
Sao chép

1    # Kiểm tra các yêu cầu
2    assert self._isApprovedOrOwner(_sender, _tokenId)
3    # Thông báo lỗi nếu `_to` là địa chỉ không
4    assert _to != ZERO_ADDRESS
5    # Xóa phê duyệt. Thông báo lỗi nếu `_from` không phải là chủ sở hữu hiện tại
6    self._clearApproval(_from, _tokenId)
7    # Xóa NFT. Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ
8    self._removeTokenFrom(_from, _tokenId)
9    # Thêm NFT
10    self._addTokenTo(_to, _tokenId)
11    # Ghi lại việc chuyển
12    log Transfer(_from, _to, _tokenId)
Hiện tất cả
Sao chép

1
2### HÀM CHUYỂN ###
3
4@external
5def transferFrom(_from: address, _to: address, _tokenId: uint256):
6    """
7    @dev Thông báo lỗi trừ khi `msg.sender` là chủ sở hữu hiện tại, một người vận hành được ủy quyền, hoặc địa chỉ được phê duyệt
8         cho NFT này.
9         Thông báo lỗi nếu `_from` không phải là chủ sở hữu hiện tại.
10         Thông báo lỗi nếu `_to` là địa chỉ không.
11         Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ.
12    @notice Người gọi chịu trách nhiệm xác nhận rằng `_to` có khả năng nhận NFT hoặc nếu không
13            chúng có thể bị mất vĩnh viễn.
14    @param _from Chủ sở hữu hiện tại của NFT.
15    @param _to Chủ sở hữu mới.
16    @param _tokenId NFT sẽ chuyển.
17    """
18    self._transferFrom(_from, _to, _tokenId, msg.sender)
Hiện tất cả
Sao chép

1@external
2def safeTransferFrom(
3        _from: address,
4        _to: address,
5        _tokenId: uint256,
6        _data: Bytes[1024]=b""
7    ):
8    """
9    @dev Chuyển quyền sở hữu của một NFT từ một địa chỉ sang địa chỉ khác.
10         Thông báo lỗi trừ khi `msg.sender` là chủ sở hữu hiện tại, một người vận hành được ủy quyền, hoặc
11         địa chỉ được phê duyệt cho NFT này.
12         Thông báo lỗi nếu `_from` không phải là chủ sở hữu hiện tại.
13         Thông báo lỗi nếu `_to` là địa chỉ không.
14         Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ.
15         Nếu `_to` là một hợp đồng thông minh, nó sẽ gọi `onERC721Received` trên `_to` và thông báo lỗi nếu
16         giá trị trả về không phải là `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`.
17         LƯU Ý: bytes4 được biểu thị bằng bytes32 với phần đệm
18    @param _from Chủ sở hữu hiện tại của NFT.
19    @param _to Chủ sở hữu mới.
20    @param _tokenId NFT sẽ chuyển.
21    @param _data Dữ liệu bổ sung không có định dạng được chỉ định, được gửi trong cuộc gọi đến `_to`.
22    """
23    self._transferFrom(_from, _to, _tokenId, msg.sender)
Hiện tất cả
Sao chép

1    if _to.is_contract: # kiểm tra xem `_to` có phải là địa chỉ hợp đồng không
Sao chép

1        returnValue: bytes32 = ERC721Receiver(_to).onERC721Received(msg.sender, _from, _tokenId, _data)
Sao chép

1        # Thông báo lỗi nếu đích chuyển là một hợp đồng không triển khai 'onERC721Received'
2        assert returnValue == method_id("onERC721Received(address,address,uint256,bytes)", output_type=bytes32)
Sao chép

1@external
2def approve(_approved: address, _tokenId: uint256):
3    """
4    @dev Đặt hoặc xác nhận lại địa chỉ được phê duyệt cho một NFT. Địa chỉ không cho biết không có địa chỉ được phê duyệt nào.
5         Thông báo lỗi trừ khi `msg.sender` là chủ sở hữu NFT hiện tại, hoặc một người vận hành được ủy quyền của chủ sở hữu hiện tại.
6         Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ. (LƯU Ý: Điều này không được viết trong EIP)
7         Thông báo lỗi nếu `_approved` là chủ sở hữu hiện tại. (LƯU Ý: Điều này không được viết trong EIP)
8    @param _approved Địa chỉ sẽ được phê duyệt cho ID NFT đã cho.
9    @param _tokenId ID của token sẽ được phê duyệt.
10    """
11    owner: address = self.idToOwner[_tokenId]
12    # Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ
13    assert owner != ZERO_ADDRESS
14    # Thông báo lỗi nếu `_approved` là chủ sở hữu hiện tại
15    assert _approved != owner
Hiện tất cả
Sao chép

1    # Kiểm tra các yêu cầu
2    senderIsOwner: bool = self.idToOwner[_tokenId] == msg.sender
3    senderIsApprovedForAll: bool = (self.ownerToOperators[owner])[msg.sender]
4    assert (senderIsOwner or senderIsApprovedForAll)
Sao chép

1    # Đặt sự phê duyệt
2    self.idToApprovals[_tokenId] = _approved
3    log Approval(owner, _approved, _tokenId)
4
5
6@external
7def setApprovalForAll(_operator: address, _approved: bool):
8    """
9    @dev Kích hoạt hoặc vô hiệu hóa sự phê duyệt cho một bên thứ ba ("người vận hành") để quản lý tất cả
10         tài sản của `msg.sender`. Nó cũng phát ra sự kiện ApprovalForAll.
11         Thông báo lỗi nếu `_operator` là `msg.sender`. (LƯU Ý: Điều này không được viết trong EIP)
12    @notice Điều này hoạt động ngay cả khi người gửi không sở hữu bất kỳ token nào vào thời điểm đó.
13    @param _operator Địa chỉ để thêm vào tập hợp các người vận hành được ủy quyền.
14    @param _approved True nếu người vận hành được phê duyệt, false để thu hồi phê duyệt.
15    """
16    # Thông báo lỗi nếu `_operator` là `msg.sender`
17    assert _operator != msg.sender
18    self.ownerToOperators[msg.sender][_operator] = _approved
19    log ApprovalForAll(msg.sender, _operator, _approved)
Hiện tất cả
Sao chép

1### CÁC HÀM ĐÚC & ĐỐT ###
2
3@external
4def mint(_to: address, _tokenId: uint256) -> bool:
Sao chép

1    """
2    @dev Hàm để đúc token
3         Thông báo lỗi nếu `msg.sender` không phải là người đúc.
4         Thông báo lỗi nếu `_to` là địa chỉ không.
5         Thông báo lỗi nếu `_tokenId` được sở hữu bởi ai đó.
6    @param _to Địa chỉ sẽ nhận được các token được đúc.
7    @param _tokenId ID token để đúc.
8    @return Một giá trị boolean cho biết hoạt động có thành công hay không.
9    """
10    # Thông báo lỗi nếu `msg.sender` không phải là người đúc
11    assert msg.sender == self.minter
Hiện tất cả
Sao chép

1    # Thông báo lỗi nếu `_to` là địa chỉ không
2    assert _to != ZERO_ADDRESS
3    # Thêm NFT. Thông báo lỗi nếu `_tokenId` được sở hữu bởi ai đó
4    self._addTokenTo(_to, _tokenId)
5    log Transfer(ZERO_ADDRESS, _to, _tokenId)
6    return True
Sao chép

1
2@external
3def burn(_tokenId: uint256):
4    """
5    @dev Đốt một token ERC721 cụ thể.
6         Thông báo lỗi trừ khi `msg.sender` là chủ sở hữu hiện tại, một người vận hành được ủy quyền, hoặc địa chỉ được phê duyệt
7         cho NFT này.
8         Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ.
9    @param _tokenId uint256 id của token ERC721 sẽ được đốt.
10    """
11    # Kiểm tra các yêu cầu
12    assert self._isApprovedOrOwner(msg.sender, _tokenId)
13    owner: address = self.idToOwner[_tokenId]
14    # Thông báo lỗi nếu `_tokenId` không phải là một NFT hợp lệ
15    assert owner != ZERO_ADDRESS
16    self._clearApproval(owner, _tokenId)
17    self._removeTokenFrom(owner, _tokenId)
18    log Transfer(owner, ZERO_ADDRESS, _tokenId)
Hiện tất cả
Sao chép