简介
@0x/contracts-erc1155 是一个提供 ERC1155 智能合约的 npm 包,由 0x Labs 开发并维护,是 0x 协议家族中的一员。此 npm 包可以帮助使用者快速创建符合 ERC1155 标准的智能合约,且具有高度可定制性。本篇文章将为大家详细介绍此 npm 包的使用方法。
前提条件
使用 @0x/contracts-erc1155 npm 包需要先安装 Node.js 并全局安装 truffle 和 ganache-cli。
--- ------- -- ------- -----------
具体安装过程可参考官方文档:https://nodejs.org/zh-cn/download/
安装
使用 npm 安装 @0x/contracts-erc1155:
--- ------- ---------------------
使用方式
编写合约代码
在项目文件夹中新建一个 contracts 文件夹,用于存放智能合约代码。在该文件夹下新建一个名为 MyERC1155.sol 的文件,并写入以下代码:
------ -------- ------- ------ ------------------------------------------------------------- -------- --------- -- ------- - ------------- ------ - ----------------------------------------------------------- - -------- ------------ ---- ------- --------- ------- ------- ------ - ---------- --------- ------- ---- - -
- 首先,我们继承了 @0x/contracts-erc1155 中的 ERC1155 合约,使我们的合约能够符合 ERC1155 标准;
- 其次,我们添加了一个名为 mint 的函数,用于在 MyERC1155.sol 合约中铸造新的代币;
- 最后,我们在构造函数中通过 _registerInterface 函数注册了 "MINT_WITH_ADDRESS" 接口,使得我们可以通过 @0x/contracts-erc1155 npm 包的的一些其他功能,比如使用 Exchange 中的批量转移函数。
创建 truffle 项目
接下来,在项目文件夹中创建 truffle 项目:
------- ----
mudules.js 文件
在项目中添加 modules.js 文件,内容如下:
----- ---- - ---------------- ----- ---------------- - -------------------------------------- ----- ----------------- - ------------------------------ ----- -------- - --------------------- -------------- - - -------------------------- -------------------- ------------------- --------- - ------------ - ----- ------------ ----- ----- ----------- ---- -- -------- - --------- -------- -- - ------ --- ----------------- --------- --------------------------------------------------- -- -- ----------- -- -- -------- - --------- -------- -- - ------ --- ----------------- --------- --------------------------------------------------- -- -- ----------- -- -- -- --
modules.js 文件指定了 truffle 编译合约时的输出目录,以及各个网络的连接配置。我们在编译合约时需要连接到本地的 Ganache 以及 Rinkeby 和主网 Infura 节点。
其中 MNEMONIC 和 INFURA_PROJECT_ID 参数需要与真实情况相符。MNEMONIC 是连接以太坊网络所需的助记词,可以从 Metamask 或其他以太坊钱包中获得。INFURA_PROJECT_ID 是 Infura 节点在连接时所需的项目 ID,需要在 https://infura.io/ 上创建并获取。
配置 truffle-config.js 文件
在 truffle 项目的根目录下,创建 truffle-config.js 文件,并在其中添加以下代码:
----- ---------------- - -------------------------------------- ----- -- - ------------------------ ----- ----------------- - ------------------------------ ----- -------- - --------------------- -------------- - - -------- - --------------------------- -- --------- - -------- - --------- -- -- - ------ --- ----------------- --- --------------------------------------------------- -- -- ----------- -- --------- ---- -- -------- - --------- -- -- - ------ --- ----------------- --- --------------------------------------------------- -- -- ----------- -- --------- ----- - -- --------- - ---------- ----------------------------- -- ---------- - ----- - -------- --------- ---------- - -------- ----- ----- ---- -- -- -- --
truffle-config.js 文件与 modules.js 文件类似,也需要指定连接到各个链的信息。但这里我们还需要指定编译器版本以及安装到 verify 合约的插件。
其中,ETHEREUM_PRIVATE_KEY 和 INFURA_PROJECT_ID 与 MNEMONIC 参数同理,需要替换为真实值。ETHERSCAN_API_KEY 是调用 Etherscan API(验证合约)所需的 API key,在 https://etherscan.io/ 上申请并获取。
编译合约
------- -------
以上命令将会在 build/contracts 文件夹中生成合约的 ABI 与 bytecode。
部署合约
在项目根目录下创建一个名为 deploy.js 的文件,并复制以下代码:
----- ---- - ---------------- ----- ---------------- - -------------------------------------- ----- ---- - ---------------- ----- -- - -------------- ----- ----------------- - ------------------------------ ----- -------- - --------------------- ----- ---- - --- ----- --- -------------------------- ---------------------------------------------------- -- ----- --------------------- - ---------- ---------- -------- ------------ ---------------- -- ----- ----------------- - --------------------------------------------------- ------ -- -- - ----- -------- - ----- ----------------------- ---------------------- -------------- ----- --------------- - --- ----------------------------------------- ----- ----------- - ------------------------ ----- --------------------------- --- ----------- ------- ----- ------------ ---- -------- -- ------- --- ----- --------- ---- -- --------------- -- - ---------------------- -------- -------- -- - ----------------------------- -- -------------- -- - --------------------- --- -----
以上代码定义了一个可以部署 MyERC1155 合约的脚本。在执行脚本前,需要先进行以下配置:
- 将 INFURA_PROJECT_ID 和 MNEMONIC 替换为真实值。
运行部署脚本:
---- ---------
使用合约
在项目根目录下新建一个名为 useMyERC1155.js 的文件,在其中编写以下代码:
----- ---- - ---------------- ----- ---------------- - -------------------------------------- ----- ---- - ---------------- ----- -- - -------------- ----- ----------------- - ------------------------------ ----- -------- - --------------------- ----- ---- - --- ----- --- -------------------------- ---------------------------------------------------- -- ----- --------------------- - ---------- ---------- -------- ------------ ---------------- -- ----- ----------------- - --------------------------------------------------- ------ -- -- - ----- -------- - ----- ----------------------- ---------------------- -------------- ----- --------- - --- ---------------------------------------- ---------------------------------------------- ----- ------- - ------------ ----- ------- - -- ----- ---------- - --- ----- ------------- - ----- ------------------------------------ ---------------- ------------------- -------- ------------------- ----- ------------------------------- -------- ----------------------- ---------- ----- ------------ - ----- ------------------------------------ ---------------- ------------------ -------- ------------------ -----
以上代码演示了如何从部署合约的地址中获取 MyERC1155 合约实例,并通过 mint 函数铸造代币。在执行脚本前需要先进行以下配置:
- 将 INFURA_PROJECT_ID 和 MNEMONIC 替换为真实值;
- 将 web3.eth.Contract 的第二个参数替换为部署的合约地址。
执行脚本:
---- ---------------
此时,控制台应该会输出两次代币数量,第一次为铸造代币前的数量,第二次为铸造代币后的数量。
总结
通过本文的介绍,我们了解了如何使用 npm 包 @0x/contracts-erc1155 在 truffle 中创建符合 ERC1155 标准的智能合约,并且介绍了如何在 truffle 中部署合约、获得合约实例以及使用合约。希望大家能够在自己的项目中体验 @0x/contracts-erc1155 包所带来的方便和便利。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/5eedac7db5cbfe1ea0610a3f