Vyper ERC-721 계약 살펴보기

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

# @dev NFT에 대한 승인된 주소가 변경되거나 재확인될 때 발생합니다. 0 주소는
# 승인된 주소가 없음을 나타냅니다. 전송 이벤트가 발생하면 이는 또한
# 해당 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`가 0 주소인 경우 예외를 발생시킵니다. 0 주소에 할당된 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에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
         (참고: `msg.sender`는 비공개 함수에서 허용되지 않으므로 `_sender`를 전달합니다.)
         `_to`가 0 주소인 경우 예외를 발생시킵니다.
         `_from`이 현재 소유자가 아닌 경우 예외를 발생시킵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
    """

    # 요구 사항 확인
    assert self._isApprovedOrOwner(_sender, _tokenId)
    # `_to`가 0 주소인 경우 예외를 발생시킵니다
    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`가 0 주소인 경우 예외를 발생시킵니다.
         `_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`가 0 주소인 경우 예외를 발생시킵니다.
         `_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에 대해 승인된 주소를 설정하거나 재확인합니다. 0 주소는 승인된 주소가 없음을 나타냅니다.
         `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`가 0 주소인 경우 예외를 발생시킵니다.
         `_tokenId`가 누군가에 의해 소유된 경우 예외를 발생시킵니다.
    @param _to 발행된 토큰을 받을 주소.
    @param _tokenId 발행할 토큰 ID.
    @return 작업이 성공했는지 여부를 나타내는 부울 값.
    """
    # `msg.sender`가 발행자가 아닌 경우 예외를 발생시킵니다
    assert msg.sender == self.minter

@external
def burn(_tokenId: uint256):
    """
    @dev 특정 ERC721 토큰을 소각합니다.
         `msg.sender`가 현재 소유자, 승인된 운영자 또는 이 NFT에 대해 승인된 주소가 아닌 경우 예외를 발생시킵니다.
         `_tokenId`가 유효한 NFT가 아닌 경우 예외를 발생시킵니다.
    @param _tokenId 소각될 ERC721 토큰의 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)