Vyper ERC-721 컨트랙트 연습

# @dev 어떤 메커니즘으로든 NFT의 소유권이 변경될 때 발생합니다. 이 이벤트는 NFT가
#      생성(`from` == 0)되거나 파괴(`to` == 0)될 때 발생합니다. 예외: 컨트랙트 생성 중에는 어떠한
#      수의 NFT도 Transfer 이벤트를 발생시키지 않고 생성 및 할당될 수 있습니다. 어떠한
#      전송 시에도 해당 NFT에 대해 승인된 주소(있는 경우)는 없음으로 초기화됩니다.
# @param _from NFT의 송신자 (주소가 제로 주소인 경우 토큰 생성을 나타냄).
# @param _to NFT의 수신자 (주소가 제로 주소인 경우 토큰 파괴를 나타냄).
# @param _tokenId 전송된 NFT.
event Transfer:
    sender: indexed(address)
    receiver: indexed(address)
    tokenId: indexed(uint256)

# @dev NFT에 대해 승인된 주소가 변경되거나 재확인될 때 발생합니다. 제로
#      주소는 승인된 주소가 없음을 나타냅니다. Transfer 이벤트가 발생할 때, 이는 또한
#      해당 NFT에 대해 승인된 주소(있는 경우)가 없음으로 초기화됨을 나타냅니다.
# @param _owner NFT의 소유자.
# @param _approved 승인하려는 주소.
# @param _tokenId 승인하려는 NFT.
event Approval:
    owner: indexed(address)
    approved: indexed(address)
    tokenId: indexed(uint256)

# @dev 소유자에 대해 운영자가 활성화되거나 비활성화될 때 발생합니다. 운영자는 소유자의
#      모든 NFT를 관리할 수 있습니다.
# @param _owner NFT의 소유자.
# @param _operator 운영자 권한을 설정하려는 주소.
# @param _approved 운영자 권한의 상태 (운영자 권한이 부여되면 true, 취소되면
# false).
event ApprovalForAll:
    owner: indexed(address)
    operator: indexed(address)
    approved: bool

@view
@external
def balanceOf(_owner: address) -> uint256:
    """
    @dev `_owner`가 소유한 NFT의 수를 반환합니다.
         `_owner`가 제로 주소인 경우 예외를 발생시킵니다. 제로 주소에 할당된 NFT는 유효하지 않은 것으로 간주됩니다.
    @param _owner 잔액을 조회할 주소.
    """
    assert _owner != ZERO_ADDRESS

    return self.ownerToNFTokenCount[_owner]

@view
@external
def ownerOf(_tokenId: uint256) -> address:
    """
    @dev NFT 소유자의 주소를 반환합니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
    @param _tokenId NFT의 식별자.
    """
    owner: address = self.idToOwner[_tokenId]
    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
    assert owner != ZERO_ADDRESS
    return owner

@view
@external
def getApproved(_tokenId: uint256) -> address:
    """
    @dev 단일 NFT에 대해 승인된 주소를 가져옵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
    @param _tokenId 승인을 조회할 NFT의 ID.
    """
    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
    assert self.idToOwner[_tokenId] != ZERO_ADDRESS
    return self.idToApprovals[_tokenId]

@view
@external
def isApprovedForAll(_owner: address, _operator: address) -> bool:
    """
    @dev `_operator`가 `_owner`에 대해 승인된 운영자인지 확인합니다.
    @param _owner NFT를 소유한 주소.
    @param _operator 소유자를 대신하여 행동하는 주소.
    """
    return (self.ownerToOperators[_owner])[_operator]

def _isApprovedOrOwner(_spender: address, _tokenId: uint256) -> bool:
    """
    @dev 주어진 지출자가 주어진 토큰 ID를 전송할 수 있는지 여부를 반환합니다
    @param spender 조회할 지출자의 주소
    @param tokenId 전송할 토큰의 uint256 ID
    @return bool msg.sender가 주어진 토큰 ID에 대해 승인되었는지, 소유자의 운영자인지, 또는 토큰의 소유자인지 여부
    """
    owner: address = self.idToOwner[_tokenId]
    spenderIsOwner: bool = owner == _spender
    spenderIsApproved: bool = _spender == self.idToApprovals[_tokenId]
    spenderIsApprovedForAll: bool = (self.ownerToOperators[owner])[_spender]
    return (spenderIsOwner or spenderIsApproved) or spenderIsApprovedForAll

@internal
def _addTokenTo(_to: address, _tokenId: uint256):
    """
    @dev 주어진 주소에 NFT를 추가합니다
         `_tokenId`를 누군가 소유하고 있는 경우 예외를 발생시킵니다.
    """
    # `_tokenId`를 누군가 소유하고 있는 경우 예외를 발생시킵니다
    assert self.idToOwner[_tokenId] == ZERO_ADDRESS
    # 소유자 변경
    self.idToOwner[_tokenId] = _to
    # 개수 추적 변경
    self.ownerToNFTokenCount[_to] += 1


@internal
def _removeTokenFrom(_from: address, _tokenId: uint256):
    """
    @dev 주어진 주소에서 NFT를 제거합니다
         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
    """
    # `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다
    assert self.idToOwner[_tokenId] == _from
    # 소유자 변경
    self.idToOwner[_tokenId] = ZERO_ADDRESS
    # 개수 추적 변경
    self.ownerToNFTokenCount[_from] -= 1

@internal
def _clearApproval(_owner: address, _tokenId: uint256):
    """
    @dev 주어진 주소의 승인을 지웁니다
         `_owner`가 현재 소유자가 아닌 경우 예외를 발생시킵니다.
    """
    # `_owner`가 현재 소유자가 아닌 경우 예외를 발생시킵니다
    assert self.idToOwner[_tokenId] == _owner
    if self.idToApprovals[_tokenId] != ZERO_ADDRESS:
        # 승인 초기화
        self.idToApprovals[_tokenId] = ZERO_ADDRESS

@internal
def _transferFrom(_from: address, _to: address, _tokenId: uint256, _sender: address):
    """
    @dev NFT의 전송을 실행합니다.
         `msg.sender`가 현재 소유자, 권한이 있는 운영자, 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다. (참고: private 함수에서는 `msg.sender`가 허용되지 않으므로 `_sender`를 전달합니다.)
         `_to`가 제로 주소인 경우 예외를 발생시킵니다.
         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
    """

    # 요구 사항 확인
    assert self._isApprovedOrOwner(_sender, _tokenId)
    # `_to`가 제로 주소인 경우 예외를 발생시킵니다
    assert _to != ZERO_ADDRESS
    # 승인을 지웁니다. `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다
    self._clearApproval(_from, _tokenId)
    # NFT를 제거합니다. `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
    self._removeTokenFrom(_from, _tokenId)
    # NFT 추가
    self._addTokenTo(_to, _tokenId)
    # 전송 기록
    log Transfer(_from, _to, _tokenId)

### 전송 함수 ###

@external
def transferFrom(_from: address, _to: address, _tokenId: uint256):
    """
    @dev `msg.sender`가 현재 소유자, 권한이 있는 운영자, 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
         `_to`가 제로 주소인 경우 예외를 발생시킵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
    @notice 호출자는 `_to`가 NFT를 수신할 수 있는지 확인할 책임이 있으며, 그렇지 않으면 영구적으로 손실될 수 있습니다.
    @param _from NFT의 현재 소유자.
    @param _to 새로운 소유자.
    @param _tokenId 전송할 NFT.
    """
    self._transferFrom(_from, _to, _tokenId, msg.sender)

@external
def safeTransferFrom(
        _from: address,
        _to: address,
        _tokenId: uint256,
        _data: Bytes[1024]=b""
    ):
    """
    @dev 한 주소에서 다른 주소로 NFT의 소유권을 전송합니다.
         `msg.sender`가 현재 소유자, 권한이 있는 운영자, 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
         `_to`가 제로 주소인 경우 예외를 발생시킵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
         `_to`가 스마트 컨트랙트인 경우, `_to`에서 `onERC721Received`를 호출하고 반환 값이 `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`가 아니면 예외를 발생시킵니다.
         참고: bytes4는 패딩이 있는 bytes32로 표현됩니다
    @param _from NFT의 현재 소유자.
    @param _to 새로운 소유자.
    @param _tokenId 전송할 NFT.
    @param _data 지정된 형식이 없는 추가 데이터로, `_to` 호출 시 전송됩니다.
    """
    self._transferFrom(_from, _to, _tokenId, msg.sender)

@external
def approve(_approved: address, _tokenId: uint256):
    """
    @dev NFT에 대해 승인된 주소를 설정하거나 재확인합니다. 제로 주소는 승인된 주소가 없음을 나타냅니다.
         `msg.sender`가 현재 NFT 소유자이거나 현재 소유자의 권한이 있는 운영자가 아닌 경우 예외를 발생시킵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다. (참고: 이는 EIP에 작성되어 있지 않습니다)
         `_approved`가 현재 소유자인 경우 예외를 발생시킵니다. (참고: 이는 EIP에 작성되어 있지 않습니다)
    @param _approved 주어진 NFT ID에 대해 승인될 주소.
    @param _tokenId 승인될 토큰의 ID.
    """
    owner: address = self.idToOwner[_tokenId]
    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
    assert owner != ZERO_ADDRESS
    # `_approved`가 현재 소유자인 경우 예외를 발생시킵니다
    assert _approved != owner

    # 승인 설정
    self.idToApprovals[_tokenId] = _approved
    log Approval(owner, _approved, _tokenId)


@external
def setApprovalForAll(_operator: address, _approved: bool):
    """
    @dev 제3자("운영자")가 `msg.sender`의 모든 자산을 관리할 수 있도록 승인을 활성화하거나 비활성화합니다. 또한 ApprovalForAll 이벤트를 발생시킵니다.
         `_operator`가 `msg.sender`인 경우 예외를 발생시킵니다. (참고: 이는 EIP에 작성되어 있지 않습니다)
    @notice 이는 송신자가 당시 토큰을 소유하고 있지 않더라도 작동합니다.
    @param _operator 권한이 있는 운영자 집합에 추가할 주소.
    @param _approved 운영자가 승인되면 true, 승인을 취소하려면 false.
    """
    # `_operator`가 `msg.sender`인 경우 예외를 발생시킵니다
    assert _operator != msg.sender
    self.ownerToOperators[msg.sender][_operator] = _approved
    log ApprovalForAll(msg.sender, _operator, _approved)

    """
    @dev 토큰을 발행하는 함수
         `msg.sender`가 발행자가 아닌 경우 예외를 발생시킵니다.
         `_to`가 제로 주소인 경우 예외를 발생시킵니다.
         `_tokenId`를 누군가 소유하고 있는 경우 예외를 발생시킵니다.
    @param _to 발행된 토큰을 수신할 주소.
    @param _tokenId 발행할 토큰 ID.
    @return 작업이 성공했는지 여부를 나타내는 부울.
    """
    # `msg.sender`가 발행자가 아닌 경우 예외를 발생시킵니다
    assert msg.sender == self.minter

@external
def burn(_tokenId: uint256):
    """
    @dev 특정 ERC-721 토큰을 소각합니다.
         `msg.sender`가 현재 소유자, 권한이 있는 운영자, 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
    @param _tokenId 소각할 ERC-721 토큰의 uint256 ID.
    """
    # 요구 사항 확인
    assert self._isApprovedOrOwner(msg.sender, _tokenId)
    owner: address = self.idToOwner[_tokenId]
    # `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다
    assert owner != ZERO_ADDRESS
    self._clearApproval(owner, _tokenId)
    self._removeTokenFrom(owner, _tokenId)
    log Transfer(owner, ZERO_ADDRESS, _tokenId)