Vyper ERC-721 계약 살펴보기

1# @dev ERC-721 대체 불가능한 토큰 표준 구현
2# @author Ryuya Nakamura (@nrryuya)
3# 수정 출처: https://github.com/vyperlang/vyper/blob/de74722bf2d8718cca46902be165f9fe0e3641dd/examples/tokens/ERC721.vy
복사

1from vyper.interfaces import ERC721
2
3implements: ERC721
복사

1# safeTransferFrom()에 의해 호출되는 계약의 인터페이스
2interface ERC721Receiver:
3    def onERC721Received(
복사

1            _operator: address,
2            _from: address,
복사

1            _tokenId: uint256,
복사

1            _data: Bytes[1024]
복사

1        ) -> bytes32: view
복사

1# @dev 모든 NFT의 소유권이 어떤 메커니즘으로든 변경될 때 발생합니다. 이 이벤트는 NFT가
2# 생성(`from` == 0)되거나 소멸(`to` == 0)될 때 발생합니다. 예외: 계약 생성 중에는
3# Transfer를 발생시키지 않고 여러 개의 NFT를 생성하고 할당할 수 있습니다. 전송 시점에
4# 해당 NFT에 대해 승인된 주소(있는 경우)는 없음으로 재설정됩니다.
5# @param _from NFT의 전송자(주소가 0 주소인 경우 토큰 생성을 나타냄).
6# @param _to NFT의 수신자(주소가 0 주소인 경우 토큰 소멸을 나타냄).
7# @param _tokenId 전송된 NFT.
8event Transfer:
9    sender: indexed(address)
10    receiver: indexed(address)
11    tokenId: indexed(uint256)
모두 보기
복사

1# @dev NFT에 대한 승인된 주소가 변경되거나 재확인될 때 발생합니다. 0 주소는
2# 승인된 주소가 없음을 나타냅니다. 전송 이벤트가 발생하면 이는 또한
3# 해당 NFT에 대한 승인된 주소(있는 경우)가 없음으로 재설정됨을 나타냅니다.
4# @param _owner NFT의 소유자.
5# @param _approved 승인하려는 주소.
6# @param _tokenId 승인하려는 NFT.
7event Approval:
8    owner: indexed(address)
9    approved: indexed(address)
10    tokenId: indexed(uint256)
모두 보기
복사

1# @dev 소유자에 대해 운영자가 활성화 또는 비활성화될 때 발생합니다. 운영자는
2# 소유자의 모든 NFT를 관리할 수 있습니다.
3# @param _owner NFT의 소유자.
4# @param _operator 운영자 권한을 설정할 주소.
5# @param _approved 운영자 권한 상태(운영자 권한이 부여되면 true, 취소되면 false).
6event ApprovalForAll:
7    owner: indexed(address)
8    operator: indexed(address)
9    approved: bool
모두 보기
복사

1# @dev NFT ID에서 이를 소유한 주소로의 매핑.
2idToOwner: HashMap[uint256, address]
3
4# @dev NFT ID에서 승인된 주소로의 매핑.
5idToApprovals: HashMap[uint256, address]
복사

1# @dev 소유자 주소에서 토큰 수로의 매핑.
2ownerToNFTokenCount: HashMap[address, uint256]
복사

1# @dev 소유자 주소에서 운영자 주소 매핑으로의 매핑.
2ownerToOperators: HashMap[address, HashMap[address, bool]]
복사

1# @dev 토큰을 발행할 수 있는 발행자의 주소
2minter: address
복사

1# @dev 인터페이스 ID에서 지원 여부에 대한 부울로의 매핑
2supportedInterfaces: HashMap[bytes32, bool]
3
4# @dev ERC165의 ERC165 인터페이스 ID
5ERC165_INTERFACE_ID: constant(bytes32) = 0x0000000000000000000000000000000000000000000000000000000001ffc9a7
6
7# @dev ERC721의 ERC165 인터페이스 ID
8ERC721_INTERFACE_ID: constant(bytes32) = 0x0000000000000000000000000000000000000000000000000000000080ac58cd
복사

1@external
2def __init__():
복사

1    """
2    @dev 계약 생성자.
3    """
복사

1    self.supportedInterfaces[ERC165_INTERFACE_ID] = True
2    self.supportedInterfaces[ERC721_INTERFACE_ID] = True
3    self.minter = msg.sender
복사

1@view
2@external
복사

1def supportsInterface(_interfaceID: bytes32) -> bool:
복사

1    """
2    @dev 인터페이스 식별은 ERC-165에 지정됩니다.
3    @param _interfaceID 인터페이스의 ID
4    """
5    return self.supportedInterfaces[_interfaceID]
복사

1### 뷰 함수 ###
2
복사

1@view
2@external
3def balanceOf(_owner: address) -> uint256:
4    """
5    @dev `_owner`가 소유한 NFT 수를 반환합니다.
6         `_owner`가 0 주소인 경우 예외를 발생시킵니다. 0 주소에 할당된 NFT는 유효하지 않은 것으로 간주됩니다.
7    @param _owner 잔액을 쿼리할 주소.
8    """
9    assert _owner != ZERO_ADDRESS
모두 보기
복사

1    return self.ownerToNFTokenCount[_owner]
2
3@view
4@external
5def ownerOf(_tokenId: uint256) -> address:
6    """
7    @dev NFT 소유자의 주소를 반환합니다.
8         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
9    @param _tokenId NFT의 식별자.
10    """
11    owner: address = self.idToOwner[_tokenId]
12    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
13    assert owner != ZERO_ADDRESS
14    return owner
모두 보기
복사

1@view
2@external
3def getApproved(_tokenId: uint256) -> address:
4    """
5    @dev 단일 NFT에 대한 승인된 주소를 가져옵니다.
6         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
7    @param _tokenId 승인을 쿼리할 NFT의 ID.
8    """
9    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
10    assert self.idToOwner[_tokenId] != ZERO_ADDRESS
11    return self.idToApprovals[_tokenId]
모두 보기
복사

1@view
2@external
3def isApprovedForAll(_owner: address, _operator: address) -> bool:
4    """
5    @dev `_operator`가 `_owner`에 대해 승인된 운영자인지 확인합니다.
6    @param _owner NFT를 소유한 주소.
7    @param _operator 소유자를 대신하여 행동하는 주소.
8    """
9    return (self.ownerToOperators[_owner])[_operator]
모두 보기
복사

1
2### 전송 함수 헬퍼 ###
3
4@view
5@internal
복사

1def _isApprovedOrOwner(_spender: address, _tokenId: uint256) -> bool:
2    """
3    @dev 주어진 지출자가 주어진 토큰 ID를 전송할 수 있는지 여부를 반환합니다.
4    @param spender 쿼리할 지출자의 주소
5    @param tokenId 전송될 토큰의 uint256 ID
6    @return bool msg.sender가 주어진 토큰 ID에 대해 승인되었는지,
7        소유자의 운영자인지, 또는 토큰의 소유자인지 여부
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
모두 보기
복사

1@internal
2def _addTokenTo(_to: address, _tokenId: uint256):
3    """
4    @dev 주어진 주소에 NFT 추가
5         `_tokenId`가 누군가에 의해 소유된 경우 예외를 발생시킵니다.
6    """
7    # `_tokenId`가 누군가에 의해 소유된 경우 예외를 발생시킵니다
8    assert self.idToOwner[_tokenId] == ZERO_ADDRESS
9    # 소유자 변경
10    self.idToOwner[_tokenId] = _to
11    # 수량 추적 변경
12    self.ownerToNFTokenCount[_to] += 1
13
14
15@internal
16def _removeTokenFrom(_from: address, _tokenId: uint256):
17    """
18    @dev 주어진 주소에서 NFT 제거
19         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
20    """
21    # `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다
22    assert self.idToOwner[_tokenId] == _from
23    # 소유자 변경
24    self.idToOwner[_tokenId] = ZERO_ADDRESS
25    # 수량 추적 변경
26    self.ownerToNFTokenCount[_from] -= 1
모두 보기
복사

1@internal
2def _clearApproval(_owner: address, _tokenId: uint256):
3    """
4    @dev 주어진 주소의 승인 취소
5         `_owner`가 현재 소유자가 아닌 경우 예외를 발생시킵니다.
6    """
7    # `_owner`가 현재 소유자가 아닌 경우 예외를 발생시킵니다
8    assert self.idToOwner[_tokenId] == _owner
9    if self.idToApprovals[_tokenId] != ZERO_ADDRESS:
10        # 승인 재설정
11        self.idToApprovals[_tokenId] = ZERO_ADDRESS
모두 보기
복사

1@internal
2def _transferFrom(_from: address, _to: address, _tokenId: uint256, _sender: address):
3    """
4    @dev NFT 전송 실행.
5         `msg.sender`가 현재 소유자, 승인된 운영자 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
6         (참고: `msg.sender`는 비공개 함수에서 허용되지 않으므로 `_sender`를 전달합니다.)
7         `_to`가 0 주소인 경우 예외를 발생시킵니다.
8         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
9         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
10    """
모두 보기
복사

1    # 요구 사항 확인
2    assert self._isApprovedOrOwner(_sender, _tokenId)
3    # `_to`가 0 주소인 경우 예외를 발생시킵니다
4    assert _to != ZERO_ADDRESS
5    # 승인 취소. `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다
6    self._clearApproval(_from, _tokenId)
7    # NFT 제거. `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
8    self._removeTokenFrom(_from, _tokenId)
9    # NFT 추가
10    self._addTokenTo(_to, _tokenId)
11    # 전송 기록
12    log Transfer(_from, _to, _tokenId)
모두 보기
복사

1
2### 전송 함수 ###
3
4@external
5def transferFrom(_from: address, _to: address, _tokenId: uint256):
6    """
7    @dev `msg.sender`가 현재 소유자, 승인된 운영자 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
8         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
9         `_to`가 0 주소인 경우 예외를 발생시킵니다.
10         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
11    @notice 호출자는 `_to`가 NFT를 수신할 수 있는지 확인해야 할 책임이 있으며, 그렇지 않으면 영구적으로 손실될 수 있습니다.
12    @param _from NFT의 현재 소유자.
13    @param _to 새로운 소유자.
14    @param _tokenId 전송할 NFT.
15    """
16    self._transferFrom(_from, _to, _tokenId, msg.sender)
모두 보기
복사

1@external
2def safeTransferFrom(
3        _from: address,
4        _to: address,
5        _tokenId: uint256,
6        _data: Bytes[1024]=b""
7    ):
8    """
9    @dev 한 주소에서 다른 주소로 NFT의 소유권을 이전합니다.
10         `msg.sender`가 현재 소유자, 승인된 운영자 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
11         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
12         `_to`가 0 주소인 경우 예외를 발생시킵니다.
13         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
14         `_to`가 스마트 계약인 경우 `_to`에서 `onERC721Received`를 호출하고 반환 값이 `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`가 아닌 경우 예외를 발생시킵니다.
15         참고: bytes4는 패딩이 있는 bytes32로 표시됩니다.
16    @param _from NFT의 현재 소유자.
17    @param _to 새로운 소유자.
18    @param _tokenId 전송할 NFT.
19    @param _data 지정된 형식이 없는 추가 데이터, `_to` 호출 시 전송됩니다.
20    """
21    self._transferFrom(_from, _to, _tokenId, msg.sender)
모두 보기
복사

1    if _to.is_contract: # `_to`가 계약 주소인지 확인
복사

1        returnValue: bytes32 = ERC721Receiver(_to).onERC721Received(msg.sender, _from, _tokenId, _data)
복사

1        # 전송 대상이 'onERC721Received'를 구현하지 않는 계약인 경우 예외를 발생시킵니다
2        assert returnValue == method_id("onERC721Received(address,address,uint256,bytes)", output_type=bytes32)
복사

1@external
2def approve(_approved: address, _tokenId: uint256):
3    """
4    @dev NFT에 대해 승인된 주소를 설정하거나 재확인합니다. 0 주소는 승인된 주소가 없음을 나타냅니다.
5         `msg.sender`가 현재 NFT 소유자이거나 현재 소유자의 승인된 운영자가 아닌 경우 예외를 발생시킵니다.
6         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다. (참고: EIP에 기록되지 않음)
7         `_approved`가 현재 소유자인 경우 예외를 발생시킵니다. (참고: EIP에 기록되지 않음)
8    @param _approved 주어진 NFT ID에 대해 승인될 주소.
9    @param _tokenId 승인될 토큰의 ID.
10    """
11    owner: address = self.idToOwner[_tokenId]
12    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
13    assert owner != ZERO_ADDRESS
14    # `_approved`가 현재 소유자인 경우 예외를 발생시킵니다
15    assert _approved != owner
모두 보기
복사

1    # 요구 사항 확인
2    senderIsOwner: bool = self.idToOwner[_tokenId] == msg.sender
3    senderIsApprovedForAll: bool = (self.ownerToOperators[owner])[msg.sender]
4    assert (senderIsOwner or senderIsApprovedForAll)
복사

1    # 승인 설정
2    self.idToApprovals[_tokenId] = _approved
3    log Approval(owner, _approved, _tokenId)
4
5
6@external
7def setApprovalForAll(_operator: address, _approved: bool):
8    """
9    @dev 제3자("운영자")가 `msg.sender`의 모든 자산을 관리할 수 있도록 승인을 활성화하거나 비활성화합니다. 또한 ApprovalForAll 이벤트를 발생시킵니다.
10         `_operator`가 `msg.sender`인 경우 예외를 발생시킵니다. (참고: EIP에 기록되지 않음)
11    @notice 이는 전송자가 당시 토큰을 소유하지 않은 경우에도 작동합니다.
12    @param _operator 승인된 운영자 집합에 추가할 주소.
13    @param _approved 운영자가 승인되면 True, 승인을 취소하려면 false입니다.
14    """
15    # `_operator`가 `msg.sender`인 경우 예외를 발생시킵니다
16    assert _operator != msg.sender
17    self.ownerToOperators[msg.sender][_operator] = _approved
18    log ApprovalForAll(msg.sender, _operator, _approved)
모두 보기
복사

1### 발행 및 소각 함수 ###
2
3@external
4def mint(_to: address, _tokenId: uint256) -> bool:
복사

1    """
2    @dev 토큰을 발행하는 함수
3         `msg.sender`가 발행자가 아닌 경우 예외를 발생시킵니다.
4         `_to`가 0 주소인 경우 예외를 발생시킵니다.
5         `_tokenId`가 누군가에 의해 소유된 경우 예외를 발생시킵니다.
6    @param _to 발행된 토큰을 받을 주소.
7    @param _tokenId 발행할 토큰 ID.
8    @return 작업이 성공했는지 여부를 나타내는 부울 값.
9    """
10    # `msg.sender`가 발행자가 아닌 경우 예외를 발생시킵니다
11    assert msg.sender == self.minter
모두 보기
복사

1    # `_to`가 0 주소인 경우 예외를 발생시킵니다
2    assert _to != ZERO_ADDRESS
3    # NFT 추가. `_tokenId`가 누군가에 의해 소유된 경우 예외를 발생시킵니다
4    self._addTokenTo(_to, _tokenId)
5    log Transfer(ZERO_ADDRESS, _to, _tokenId)
6    return True
복사

1
2@external
3def burn(_tokenId: uint256):
4    """
5    @dev 특정 ERC721 토큰을 소각합니다.
6         `msg.sender`가 현재 소유자, 승인된 운영자 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
7         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
8    @param _tokenId 소각될 ERC721 토큰의 uint256 ID.
9    """
10    # 요구 사항 확인
11    assert self._isApprovedOrOwner(msg.sender, _tokenId)
12    owner: address = self.idToOwner[_tokenId]
13    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
14    assert owner != ZERO_ADDRESS
15    self._clearApproval(owner, _tokenId)
16    self._removeTokenFrom(owner, _tokenId)
17    log Transfer(owner, ZERO_ADDRESS, _tokenId)
모두 보기
복사