以太坊实战-创建并运行一个最简单的NFT合约

以太坊实战-创建并运行一个最简单的NFT合约

NFT理论部分

NFT，全称为Non-Fungible Token，非同质化货币。了解非同质化货币之前，首先需要了解同质化货币和非同质化货币的区别。

语言	框架
同质化货币	功能就类似我们现实生活中使用的1元人民币，虽然票面编号是不同的，但是价值是相同的。
非同质化货币	功能则类似于我们现实生活中的车牌，不同车牌的编号是不同的，价值也不同，而且相差的价格十分大。

非同质化代币的产生是区块链的一种落地方式。非同质化代币对于促进艺术品，尤其是虚拟艺术品的流通，提供了极大的支持。

典型的非同质化代币的应用项目：

迷恋猫：CryptoKitties | Catalogue

理论上来讲，区块链在同质化货币ERC-20的基础上，保证其发行的所有代币的编号唯一，就可以创造了非同质化货币。目前，以太坊提出了ERC-721合约接口支持上述功能。

创建通用NFT合约

针对非同质化货币，以太坊组织制定了ERC-721接口规范。

虽然官方没有给出ERC-721接口规范的实现，但是网上已经有很多实现好的通用实现供我们参考或者直接继承。

比如，下面这个开源项目就提供了ERC-20和ERC-721合约接口的通用实现。访问地址：https://github.com/OpenZeppelin/openzeppelin-contracts

该项目已经将实现好的合约打包上传到npm仓库中，我们可以通过下面的命令来给项目引入依赖：

$ yarn add @openzeppelin/contracts

使用下面的命令创建卡罗牌合约TarotCard.sol

$ truffle create contract TarotCard

合约创建好的样子如下：

// SPDX-License-Identifier: MIT
pragma solidity >=0.4.22 <0.9.0;

contract TarotCard {
  constructor() public {
  }
}

引入ERC-721的通用实现，并让TarotCard合约继承已经实现好的ERC-721合约。

// SPDX-License-Identifier: MIT
pragma solidity >=0.4.22 <0.9.0;

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

contract TarotCard  is ERC721 {
	constructor() ERC721("Tarot","TAROT") {
	}
}

到目前为止，我们已经创建好了一个NFT合约，合约的名称为Tarot，合约的代币为TAROT。在该NFT合约的基础上，我们可以编写业务代码来构建领域相关的NFT合约。

创建NFT项目

哔哩哔哩·卡罗牌项目

该项目将发布以下26个卡罗牌收藏品，每张卡罗牌都有编号，分别为0~25。

每张卡片只能被一个账户拥有，且该账户有权将该将收藏品转移到其他账户，或者销毁它。

项目合约

关于ERC-721的通用实现是如何工作的，可以参考第6章，剖析ERC-721的通用实现。

任何一个合约中的代币都有三个生命阶段，下面分别编写这三个阶段的代码。

• 阶段1：铸币，为了测试方便，合约中的铸币接口直接将所有收藏品先发给第一个调用该合约函数的账户。

...
contract TarotCard  is ERC721 {
	uint8[] public tarots;
	
	constructor() ERC721("Tarot","TAROT") {
	}
	function mint() public {
		require(tarots.length <= 0, "only can mint once");
		for (uint8 i = 0; i < 26; i++) {
			tarots.push(i);
			_mint(msg.sender, i);
		}
	}
}
...

通过下面的命令来创建测试文件tarot_card.js：

$ truffle create test TarotCard

下面是测试文件的基础内容，该内容可以用来测试TarotCard合约是否正常发布。

const TarotCard = artifacts.require("TarotCard");

contract("TarotCard", function (/* accounts */) {
    
    
  it("should assert true", async function () {
    
    
    await TarotCard.deployed();
    return assert.isTrue(true);
  });
});

下面，补充测试内容来验证铸币函数的正确性。

const TarotCard = artifacts.require("TarotCard");

contract("TarotCard", function (/* accounts */) {
    
    
  // 测试合约是否正常发布
  it("should assert true", async function () {
    
    
    await TarotCard.deployed();
    return assert.isTrue(true);
  });

  // 测试合约铸币函数逻辑是否正确
  it("verify mint call", async function () {
    
    
    await TarotCard.deployed();
    return assert.isTrue(true);
  });
});

• 阶段2：流通

流通简单来说就是转让收藏品。

	function transfer(address to, uint8 tokenId) public {
		uint8[] storage tokenIds = addr2tokenIds[msg.sender];
		
		bool isExist = false;
		uint i = 0;
		while(i < tokenIds.length) {
			if (tokenIds[i] == tokenId) {
				isExist = true;
				break;
			}
			i += 1;
		}
		require(isExist, "account should contains tokenId");

		for(uint j = i; j < tokenIds.length - 1; j++) {
			tokenIds[j] = tokenIds[j+1];
		}
		tokenIds.pop();			
		addr2tokenIds[to].push(tokenId);
		transferFrom(msg.sender, to, tokenId);
	}

• 阶段3：销毁

销毁，很简单，永久的将收藏删除。

	function burn(uint8 tokenId) public {
		 require(ERC721.ownerOf(tokenId) == msg.sender, "ERC721: transfer of token that is not own");

		uint8[] storage tokenIds = addr2tokenIds[msg.sender];

		bool isExist = false;
		uint i = 0;
		while(i < tokenIds.length) {
			if (tokenIds[i] == tokenId) {
				isExist = true;
				break;
			}
			i += 1;
		}
		require(isExist, "account should contains tokenId");

		for(uint j = i; j < tokenIds.length - 1; j++) {
			tokenIds[j] = tokenIds[j+1];
		}
		tokenIds.pop();	
		_burn(tokenId);
	}

项目界面

为了方便演示，我们将上述三个阶段的按钮全部放在了用户操作页面上，分别为铸币，转让(流通)和销毁。

• 阶段1：铸币

在真实环境中，铸币操作大多都在合约初始化的时候完成。

在用户操作界面放置铸币按钮，仅仅是为了方便展示。该按钮可以将塔罗牌中全套收藏品ID一次性赋予第一个调用该合约铸币方法(mint)的账户，让该账户拥有全部NFT收藏品。

• 阶段2：流通

在真实环境中，流通操作或者叫做转账操作是最常见的操作，通过该操作，一个账户中的NFT收藏品可以转移到另一个账户中。

在用户操作界面中，用户需要提供转让地址和转让NFT收藏品的ID，才能点击转让按钮来转让该NFT收藏品。

• 阶段3：销毁

在真实环境中，销毁操作也是可能会发生的，如果用户真的想让某个NFT收藏品消失的话。

在用户操作界面中，用户需要提供销毁NFT收藏品的ID，才能点击销毁按钮来销毁该NFT收藏品。

销毁操作在合约中已经完成，但是按钮并没有添加，有兴趣的可以添加一下，试一试效果。

项目总结

项目继承了ERC721的实现合约，在其基础上增加了我们本身的铸币，转账和销毁合约，非常方便的实现了NFT的一个应用程序。NFT作为区块链的落地方式，其核心的价值就是，虚拟资产一旦被转移后，归属权就会本质变更，而不需要任何人证明。

补充

1. 合约编译的时候指定合约生成目录

在部署合约的时候，生成的内容*.json文件会放到一个目录中，这个目录的位置可以指定，指定的目的是，让别人引用你这些生成的文件的时候，不会因为你每次部署的内容不同，人家项目启动后，引用的东西是你上次部署的内容。

咱们举个例子，比如说，你首次部署的时候，放在了文件build中，然后别人把你build文件夹中的东西拷贝出来，放到他们的目录中来使用，当你再次部署的时候，你最新生成的确实还在build中，但是别人的目录中的那份文件就是陈旧的了，不能使用了。所以，我们要直接把生成的文件的位置放到别人需要的目录中去，这样你部署一次，就可以把最新的直接给到别人。

想要实现上面这个目标，该怎么做呢，其实就是配置truffle.config中的内容就可以了。

https://trufflesuite.com/docs/truffle/reference/configuration.html#contracts_build_directory

2. MetaMask账户切换的时候刷新页面

很多情况下，MetaMask账户切换并不能带来页面刷新，这就造成了假死或者被人误以为BUG。所以，在可能的情况下，加一个切换账户，页面刷新是一个很好的主意。

https://ethereum.stackexchange.com/questions/42768/how-can-i-detect-change-in-account-in-metamask/49008