Vyper ERC-721 কন্ট্রাক্ট ওয়াকথ্রু

1# @dev ERC-721 নন-ফাঞ্জিবল টোকেন স্ট্যান্ডার্ডের ইমপ্লিমেন্টেশন।
2# @author রিউয়া নাকামুরা (@nrryuya)
3# এখান থেকে পরিমার্জিত: https://github.com/vyperlang/vyper/blob/de74722bf2d8718cca46902be165f9fe0e3641dd/examples/tokens/ERC721.vy
কপি করুন

1from vyper.interfaces import ERC721
2
3implements: ERC721
কপি করুন

1# safeTransferFrom() দ্বারা কল করা চুক্তির (contract) জন্য ইন্টারফেস
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)। ব্যতিক্রম: চুক্তি (contract) তৈরির সময়, যেকোনো
3# সংখ্যক NFT তৈরি এবং অ্যাসাইন করা হতে পারে Transfer এমিট না করেই। যেকোনো
4# ট্রান্সফারের সময়, সেই NFT-এর জন্য অনুমোদিত ঠিকানা (যদি থাকে) রিসেট করে none করা হয়।
5# @param _from NFT-এর প্রেরক (যদি ঠিকানা শূন্য ঠিকানা হয় তবে এটি টোকেন তৈরি নির্দেশ করে)।
6# @param _to NFT-এর প্রাপক (যদি ঠিকানা শূন্য ঠিকানা হয় তবে এটি টোকেন ধ্বংস নির্দেশ করে)।
7# @param _tokenId যে NFT-টি ট্রান্সফার করা হয়েছে।
8event Transfer:
9    sender: indexed(address)
10    receiver: indexed(address)
11    tokenId: indexed(uint256)
সব দেখানকপি করুন

1# @dev কোনো NFT-এর অনুমোদিত ঠিকানা পরিবর্তন বা পুনর্নিশ্চিত করা হলে এটি এমিট হয়। শূন্য
2# ঠিকানা নির্দেশ করে যে কোনো অনুমোদিত ঠিকানা নেই। যখন একটি Transfer ইভেন্ট এমিট হয়, এটি আরও
3# নির্দেশ করে যে সেই NFT-এর জন্য অনুমোদিত ঠিকানা (যদি থাকে) রিসেট করে none করা হয়েছে।
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 এবং
6# বাতিল করা হলে false)।
7event ApprovalForAll:
8    owner: indexed(address)
9    operator: indexed(address)
10    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 ইন্টারফেস আইডি থেকে এটি সমর্থিত কিনা সেই বিষয়ে বুলিয়ানে (bool) ম্যাপিং
2supportedInterfaces: HashMap[bytes32, bool]
3
4# @dev ERC165-এর ERC165 ইন্টারফেস আইডি
5ERC165_INTERFACE_ID: constant(bytes32) = 0x0000000000000000000000000000000000000000000000000000000001ffc9a7
6
7# @dev ERC721-এর ERC165 ইন্টারফেস আইডি
8ERC721_INTERFACE_ID: constant(bytes32) = 0x0000000000000000000000000000000000000000000000000000000080ac58cd
কপি করুন

1@external
2def __init__():
কপি করুন

1    # @dev কন্ট্রাক্ট কনস্ট্রাক্টর।
কপি করুন

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    # @dev ইন্টারফেস আইডেন্টিফিকেশন ERC-165-এ নির্দিষ্ট করা আছে।
2    @param _interfaceID ইন্টারফেসের আইডি
3    return self.supportedInterfaces[_interfaceID]
কপি করুন

1# ## ভিউ ফাংশনস ###
কপি করুন

1@view
2@external
3def balanceOf(_owner: address) -> uint256:
4    # @dev `_owner`-এর মালিকানাধীন NFT-এর সংখ্যা রিটার্ন করে।
5         `_owner` শূন্য ঠিকানা হলে থ্রো (Throw) করে। শূন্য ঠিকানায় অ্যাসাইন করা NFT-গুলোকে অবৈধ বলে বিবেচনা করা হয়।
6    @param _owner ব্যালেন্স কোয়েরি করার জন্য ঠিকানা।
7    assert _owner != ZERO_ADDRESS
কপি করুন

1    return self.ownerToNFTokenCount[_owner]
2
3@view
4@external
5def ownerOf(_tokenId: uint256) -> address:
6    # @dev NFT-এর মালিকের ঠিকানা রিটার্ন করে।
7         `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে।
8    @param _tokenId একটি NFT-এর আইডেন্টিফায়ার।
9    owner: address = self.idToOwner[_tokenId]
10    # `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে
11    assert owner != ZERO_ADDRESS
12    return owner
সব দেখানকপি করুন

1@view
2@external
3def getApproved(_tokenId: uint256) -> address:
4    # @dev একটি একক NFT-এর জন্য অনুমোদিত ঠিকানা পান।
5         `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে।
6    @param _tokenId অনুমোদনের কোয়েরি করার জন্য NFT-এর আইডি।
7    # `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে
8    assert self.idToOwner[_tokenId] != ZERO_ADDRESS
9    return self.idToApprovals[_tokenId]
সব দেখানকপি করুন

1@view
2@external
3def isApprovedForAll(_owner: address, _operator: address) -> bool:
4    # @dev `_operator` `_owner`-এর জন্য একজন অনুমোদিত অপারেটর কিনা তা চেক করে।
5    @param _owner যে ঠিকানাটি NFT-গুলোর মালিক।
6    @param _operator যে ঠিকানাটি মালিকের পক্ষে কাজ করে।
7    return (self.ownerToOperators[_owner])[_operator]
কপি করুন

1
2# ## ট্রান্সফার ফাংশন হেল্পারস ###
3
4@view
5@internal
কপি করুন

1def _isApprovedOrOwner(_spender: address, _tokenId: uint256) -> bool:
2    # @dev প্রদত্ত স্পেন্ডার একটি নির্দিষ্ট টোকেন আইডি ট্রান্সফার করতে পারবে কিনা তা রিটার্ন করে
3    @param spender কোয়েরি করার জন্য স্পেন্ডারের ঠিকানা
4    @param tokenId ট্রান্সফার করার জন্য টোকেনের uint256 আইডি
5    @return bool msg.sender প্রদত্ত টোকেন আইডির জন্য অনুমোদিত কিনা,
6        মালিকের একজন অপারেটর কিনা, অথবা টোকেনটির মালিক কিনা
7    owner: address = self.idToOwner[_tokenId]
8    spenderIsOwner: bool = owner == _spender
9    spenderIsApproved: bool = _spender == self.idToApprovals[_tokenId]
10    spenderIsApprovedForAll: bool = (self.ownerToOperators[owner])[_spender]
11    return (spenderIsOwner or spenderIsApproved) or spenderIsApprovedForAll
সব দেখানকপি করুন

1@internal
2def _addTokenTo(_to: address, _tokenId: uint256):
3    # @dev একটি নির্দিষ্ট ঠিকানায় একটি NFT যোগ করুন
4         `_tokenId` কারও মালিকানাধীন হলে থ্রো (Throw) করে।
5    # `_tokenId` কারও মালিকানাধীন হলে থ্রো (Throw) করে
6    assert self.idToOwner[_tokenId] == ZERO_ADDRESS
7    # মালিক পরিবর্তন করুন
8    self.idToOwner[_tokenId] = _to
9    # কাউন্ট ট্র্যাকিং পরিবর্তন করুন
10    self.ownerToNFTokenCount[_to] += 1
11
12
13@internal
14def _removeTokenFrom(_from: address, _tokenId: uint256):
15    # @dev একটি নির্দিষ্ট ঠিকানা থেকে একটি NFT সরান
16         `_from` বর্তমান মালিক না হলে থ্রো (Throw) করে।
17    # `_from` বর্তমান মালিক না হলে থ্রো (Throw) করে
18    assert self.idToOwner[_tokenId] == _from
19    # মালিক পরিবর্তন করুন
20    self.idToOwner[_tokenId] = ZERO_ADDRESS
21    # কাউন্ট ট্র্যাকিং পরিবর্তন করুন
22    self.ownerToNFTokenCount[_from] -= 1
সব দেখানকপি করুন

1@internal
2def _clearApproval(_owner: address, _tokenId: uint256):
3    # @dev একটি নির্দিষ্ট ঠিকানার অনুমোদন ক্লিয়ার করুন
4         `_owner` বর্তমান মালিক না হলে থ্রো (Throw) করে।
5    # `_owner` বর্তমান মালিক না হলে থ্রো (Throw) করে
6    assert self.idToOwner[_tokenId] == _owner
7    if self.idToApprovals[_tokenId] != ZERO_ADDRESS:
8        # অনুমোদনগুলো রিসেট করুন
9        self.idToApprovals[_tokenId] = ZERO_ADDRESS
সব দেখানকপি করুন

1@internal
2def _transferFrom(_from: address, _to: address, _tokenId: uint256, _sender: address):
3    # @dev একটি NFT-এর ট্রান্সফার এক্সিকিউট করুন।
4         `msg.sender` বর্তমান মালিক, একজন অনুমোদিত অপারেটর, অথবা এই NFT-এর জন্য অনুমোদিত
5         ঠিকানা না হলে থ্রো (Throw) করে। (নোট: প্রাইভেট ফাংশনে `msg.sender` অনুমোদিত নয় তাই `_sender` পাস করুন।)
6         `_to` শূন্য ঠিকানা হলে থ্রো (Throw) করে।
7         `_from` বর্তমান মালিক না হলে থ্রো (Throw) করে।
8         `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে।
কপি করুন

1    # প্রয়োজনীয়তাগুলো চেক করুন
2    assert self._isApprovedOrOwner(_sender, _tokenId)
3    # `_to` শূন্য ঠিকানা হলে থ্রো (Throw) করে
4    assert _to != ZERO_ADDRESS
5    # অনুমোদন ক্লিয়ার করুন। `_from` বর্তমান মালিক না হলে থ্রো (Throw) করে
6    self._clearApproval(_from, _tokenId)
7    # NFT সরান। `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে
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    # @dev `msg.sender` বর্তমান মালিক, একজন অনুমোদিত অপারেটর, অথবা এই NFT-এর জন্য অনুমোদিত
7         ঠিকানা না হলে থ্রো (Throw) করে।
8         `_from` বর্তমান মালিক না হলে থ্রো (Throw) করে।
9         `_to` শূন্য ঠিকানা হলে থ্রো (Throw) করে।
10         `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে।
11    @notice কলারের দায়িত্ব হলো এটি নিশ্চিত করা যে `_to` NFT গ্রহণে সক্ষম, অন্যথায়
12            সেগুলো স্থায়ীভাবে হারিয়ে যেতে পারে।
13    @param _from NFT-এর বর্তমান মালিক।
14    @param _to নতুন মালিক।
15    @param _tokenId ট্রান্সফার করার জন্য NFT।
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    # @dev একটি NFT-এর মালিকানা এক ঠিকানা থেকে অন্য ঠিকানায় ট্রান্সফার করে।
9         `msg.sender` বর্তমান মালিক, একজন অনুমোদিত অপারেটর, অথবা এই NFT-এর জন্য
10         অনুমোদিত ঠিকানা না হলে থ্রো (Throw) করে।
11         `_from` বর্তমান মালিক না হলে থ্রো (Throw) করে।
12         `_to` শূন্য ঠিকানা হলে থ্রো (Throw) করে।
13         `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে।
14         যদি `_to` একটি স্মার্ট কন্ট্রাক্ট হয়, তবে এটি `_to`-তে `onERC721Received` কল করে এবং রিটার্ন ভ্যালু
15         `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))` না হলে থ্রো (Throw) করে।
16         নোট: bytes4-কে প্যাডিং সহ bytes32 দ্বারা উপস্থাপন করা হয়
17    @param _from NFT-এর বর্তমান মালিক।
18    @param _to নতুন মালিক।
19    @param _tokenId ট্রান্সফার করার জন্য NFT।
20    @param _data কোনো নির্দিষ্ট ফরম্যাট ছাড়া অতিরিক্ত ডেটা, যা `_to`-তে কলে পাঠানো হয়।
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        # ট্রান্সফারের গন্তব্য এমন কোনো কন্ট্রাক্ট হলে থ্রো (Throw) করে যা 'onERC721Received' ইমপ্লিমেন্ট করে না
2        assert returnValue == method_id("onERC721Received(address,address,uint256,bytes)", output_type=bytes32)
কপি করুন

1@external
2def approve(_approved: address, _tokenId: uint256):
3    # @dev একটি NFT-এর জন্য অনুমোদিত ঠিকানা সেট বা পুনর্নিশ্চিত করুন। শূন্য ঠিকানা নির্দেশ করে যে কোনো অনুমোদিত ঠিকানা নেই।
4         `msg.sender` বর্তমান NFT মালিক, অথবা বর্তমান মালিকের একজন অনুমোদিত অপারেটর না হলে থ্রো (Throw) করে।
5         `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে। (নোট: এটি EIP-তে লেখা নেই)
6         `_approved` বর্তমান মালিক হলে থ্রো (Throw) করে। (নোট: এটি EIP-তে লেখা নেই)
7    @param _approved প্রদত্ত NFT আইডির জন্য অনুমোদন করার ঠিকানা।
8    @param _tokenId অনুমোদন করার টোকেনের আইডি।
9    owner: address = self.idToOwner[_tokenId]
10    # `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে
11    assert owner != ZERO_ADDRESS
12    # `_approved` বর্তমান মালিক হলে থ্রো (Throw) করে
13    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    # @dev `msg.sender`-এর সমস্ত সম্পদ পরিচালনা করার জন্য কোনো তৃতীয় পক্ষের ("অপারেটর") অনুমোদন চালু বা বন্ধ করে। এটি ApprovalForAll ইভেন্টও এমিট করে।
9         `_operator` যদি `msg.sender` হয় তবে থ্রো (Throw) করে। (নোট: এটি EIP-তে লেখা নেই)
10    @notice প্রেরকের কাছে সেই মুহূর্তে কোনো টোকেন না থাকলেও এটি কাজ করে।
11    @param _operator অনুমোদিত অপারেটরদের সেটে যোগ করার ঠিকানা।
12    @param _approved অপারেটর অনুমোদিত হলে True, অনুমোদন বাতিল করতে হলে false।
13    # `_operator` যদি `msg.sender` হয় তবে থ্রো (Throw) করে
14    assert _operator != msg.sender
15    self.ownerToOperators[msg.sender][_operator] = _approved
16    log ApprovalForAll(msg.sender, _operator, _approved)
সব দেখানকপি করুন

1# ## মিন্ট ও বার্ন ফাংশনস ###
2
3@external
4def mint(_to: address, _tokenId: uint256) -> bool:
কপি করুন

1    # @dev টোকেন মিন্ট করার ফাংশন
2         `msg.sender` মিন্টার না হলে থ্রো (Throw) করে।
3         `_to` শূন্য ঠিকানা হলে থ্রো (Throw) করে।
4         `_tokenId` কারও মালিকানাধীন হলে থ্রো (Throw) করে।
5    @param _to যে ঠিকানাটি মিন্ট করা টোকেনগুলো গ্রহণ করবে।
6    @param _tokenId মিন্ট করার টোকেন আইডি।
7    @return একটি বুলিয়ান যা নির্দেশ করে অপারেশনটি সফল হয়েছে কিনা।
8    # `msg.sender` মিন্টার না হলে থ্রো (Throw) করে
9    assert msg.sender == self.minter
সব দেখানকপি করুন

1    # `_to` শূন্য ঠিকানা হলে থ্রো (Throw) করে
2    assert _to != ZERO_ADDRESS
3    # NFT যোগ করুন। `_tokenId` কারও মালিকানাধীন হলে থ্রো (Throw) করে
4    self._addTokenTo(_to, _tokenId)
5    log Transfer(ZERO_ADDRESS, _to, _tokenId)
6    return True
কপি করুন

1
2@external
3def burn(_tokenId: uint256):
4    # @dev একটি নির্দিষ্ট ERC721 টোকেন বার্ন করে।
5         `msg.sender` বর্তমান মালিক, একজন অনুমোদিত অপারেটর, অথবা এই NFT-এর জন্য অনুমোদিত
6         ঠিকানা না হলে থ্রো (Throw) করে।
7         `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে।
8    @param _tokenId বার্ন করার ERC721 টোকেনের uint256 আইডি।
9    # প্রয়োজনীয়তাগুলো চেক করুন
10    assert self._isApprovedOrOwner(msg.sender, _tokenId)
11    owner: address = self.idToOwner[_tokenId]
12    # `_tokenId` একটি বৈধ NFT না হলে থ্রো (Throw) করে
13    assert owner != ZERO_ADDRESS
14    self._clearApproval(owner, _tokenId)
15    self._removeTokenFrom(owner, _tokenId)
16    log Transfer(owner, ZERO_ADDRESS, _tokenId)
সব দেখানকপি করুন