3.1 KryptoCamp ERC721教學

以前常覺得程式可能很多沒有為什麼, 就先記起來就對了, Paul老師很仔細的幫每個名詞都解釋了上下邏輯的原因, 覺得很驚艷, 踏進火山登山口後, 找到了厚厚積灰下的路標指示牌惹, 真心感謝。

1. mapping(uint tokenId => address) private _owners;

表示這個tokenID, 擁有者是誰

2. mapping(address owner => uint256) private _balances;

這個人, 擁有多少個NFT

3. mapping(uint256 tokenId => address) private _tokenApprovals;

這個tokenID有沒有授權給哪個地址

4. mapping(address owner => mapping(address operator => bool)) private _operatorApprovals;

假設擁有者有100個NFT, 要授權給另一個人50個, 要一個一個授權太浪費, 所以這行是指一次授權所有NFT, 預設就是false( 沒有授權)

5. function balanceOf(address owner) public view virtual returns (uint256) { if (owner == address(0) { revert ERC721InvalidOwner(address(0));} return _balances[owner];}

提供user的address, 反饋user有幾個NFT

6. function ownerOf(uint256 tokenId) public view virtual returns(address) { return _requireOwned(tokeId);}

提供tokenId, 反饋擁有者地址

7. function tokenURI(uint256 tokenId) public view virtual returns (string memory) _requireOwned(tokenId); string memory baseURI = _baseURI(); return bytes(baseURI).length > 0? string.cancat(baseURI, tokenId,toSTring()) : ""; }

每一個tokenId都對應到opensea上的某中圖片, 這個關係就是tokenURI所記錄的, 什麼網址對應到什麼圖片

8. function approve(address to, uint256)(tokenId) public virtual { approve(to, tokenId, _msgSender());}

授權給某個地址操作這個編號的NFT

9. function getApprove(uint256 tokenId) public view virtual returns (address) { _requireOwned(tokenId); return _getApproved(tokenId); }

取得這個tokenId有被授權給哪個地址操作, 查資料的function

10. function setApprovalForAll(address operator, bool approved) public virtual { setApprovalForAll(_msgSender(), operator, approved); }

授權給某個人(operator)地址所有的操作權

11. function isApprovedForAll(address owner, address operator) public view virtual returns (bool) {return _operatorApprovals[owner][operator]; }

某一個NFT擁有者是否有授權給另一個address所有的NFT操作權

12. function transferFrom(address from, address to, uint256 tokenId) public virtual { if(to == address(0) { revert ERC721UnvlaidReceiver(address(0));}

某一個地址轉移給另一個地址某一個NFT

13. safeTransferfrom

會先幫你做一個檢查(transferfrom, 一轉就過去了), 用safeTransferfrom的話, 接收者如果是一個合約, 會先檢查是不是有某些功能沒執行, 確保NFT進去不會卡住

老師講義

狀態變數：

_name: 代幣名稱。

_symbol：代幣簡稱。

_owners：代幣id與擁有者關係。(uint256 => address)

_balances: 持幣紀錄。(address => uint256)

_tokenApprovals: 代幣單個id授權紀關係。(uint256 => address)

_operatorApprovals: 全部持有id授權關係。(address ==> ( address = >bool))

Funtion:

Get:

name() : 取得代幣名稱。

symbol() ：取得代幣簡稱。

balanceOf(address owner)：取得「某地址」持有NFT「數量」。

ownerOf(uint256 tokenId)：取得「某代幣Id」的擁有者地址。

tokenURI(uint256 tokenId)：取得NFT的圖片資訊。

getApproved(uint256 tokenId): 取得「某代幣Id」授權給哪個地址。

isApprovedForAll(address owner, address operator)：取得「某地址(owner)」是否授權「所有的代幣Id」給「某地址{operator}」。

Write:

approve(address to, uint256 tokenId)：授權持有的「某代幣Id」NFT給「某地址」。

setApprovalForAll(address operator, bool approved)：設定「所有持有的代幣Id」都授權給「某地址」。

transferFrom(address from, address to, uint256 tokenId): 轉移NFT。

Internal:

_mint(address to, uint256 tokenId)： 鑄造NFT。

_burn(uint256 tokenId)：燒掉NFT。

Demo

// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/token/ERC721/ERC721.sol";

contract ERC721Example is ERC721 {

    // 定義最大供給量
    uint256 public maxSupply;
    uint256 public counter = 0; // 一開始NFT編號是0

    modifier avaialbeMint(uint256 amount) { 
        // 要進function前, 會先做檢查
        // 以以下為例, 就是檢查有沒有超過上限
        //判斷這筆交易若完成，是否會超出最大供給量，如果會就回傳錯誤字串"over max supply."
        require(amount + counter <= maxSupply, "over max supply.");
        _;
    }

    //建構子初始化ERC721必要參數(name與symbol)，並多加設定題目要求的maxSupply
    constructor(
        string memory _name, 
        string memory _symbol, 
        uint256 _maxSupply)
        ERC721(_name, _symbol){
        // 執行時填入10, 代表這個NFT是發10個
        maxSupply = _maxSupply;
    }

    // 實作mint function，現在的數量, 跟要mint的數量, 有沒有超過最大供給量
    function mint (uint256 amount) external avaialbeMint(amount){
        // 迴圈值星批量鑄造NFT, 一顆一顆發
       for(uint256 i=0; i < amount ; i++){
            // 鑄造 NFT, counter為NFT的tokenId
            _mint(msg.sender, counter);
            counter ++ ;
       }
    }
    // 讓transfer無效
    function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public override  {
        revert();
    }
}

Dapp Tutorial ERC721 帶你發行項目的 NFT 🔥

Build a ERC-721 Smart Contract