Skip to content

Latest commit

 

History

History
232 lines (157 loc) · 8.19 KB

README-CN.md

File metadata and controls

232 lines (157 loc) · 8.19 KB

中文 / English

Truffle 介绍

Truffle 是基于 Solidity 语言的一套开发框架,它简化了去中心化应用(Dapp)的构建和管理流程。本身是采用 Javascript 编写,支持智能合约的编译、部署和测试。

truffle 开发框架提供了很多功能,简化了我们的开发、编译、部署与调试过程:

  • 内置了智能合约编译、链接、部署和二进制文件的管理
  • 方便快速开发的合约自动化测试
  • 方便扩展的、脚本化的部署与发布框架
  • 方便的网络管理功能。不论是公有网络还是私有网络
  • 基于 erc190 标准,使用 EthPM & NPM 进行依赖包管理
  • 内置控制台功能。项目构建后,可以直接在命令行调用输出结果,方便了开发调试
  • 可配的构建流程,支持持续集成。
  • 支持外部脚本的执行

文件说明

目录结构

  • contracts/: Solidity 合约目录

  • migrations/: 部署脚本文件目录

  • test/: 测试脚本目录,参考 如何测试应用?

  • truffle-config.js: Truffle 配置文件

各文件作用

  1. contracts/SimpleToken.sol: 这是一个用 Solidity 编写的 erc20 代币 智能合约.
  2. migrations/1_initial_migration.js: 这是一个部署脚本,用来部署 Migrations 合约,对应 Migrations.sol 文件。
  3. truffle-config.js (之前是 truffle.js): Truffle 配置文件, 用来设置网络信息,和其他项目相关的设置。当我们使用内建的默认的 Truffle 命令时,这个文件留空也是可以的。

测试流程

  1. 安装 truffle
npm install -g truffle

如果下载速度过慢,可配置taobao的镜像地址来进行加速。

npm config set registry http://registry.npm.taobao.org
  1. 安装依赖
yarn install
  1. 配置 .env

    cp .env.example .env
    
    ## 修改 .env 中的 INFURA_ID 和 PRIVATE_KEY 为实际的值
    PRIVATE_KEY=xxxxxxxxxxxxxxxx
    INFURA_ID=yyyyyyyy
  2. 测试合约

truffle test

这里,使用 "truffle test" 后,truffle 会启动内置的 test 网络,同时执行 测试 test 目录下的所有脚本,如果想单独测试某个脚本,可以 执行 "truffle test ./test/simpletoken.js"

  1. 编译合约
truffle compile

执行成功后,会输出类似如下信息。从输出信息可以看到, truffle 会把 contracts 目录下的所有合约进行编译

Compiling .\contracts\SimpleToken.sol...

Writing artifacts to .\build\contracts
  1. 部署合约

在 truffle-config.js 里面,可以配置 truffle 使用的以太网络,其中就包括 truffle test 使用的 "test" 网络。 这里,直接执行 truffle migrate 报没有找到 test 网络,因为 truffle 不会启动内置的 test 网络。所以这里我们使用 goerli 进行 truffle 合约部署

truffle migrate --network goerli

当多次执行 truffle migrate 的时候,可能会出 "Network update to date", 然后不执行合约部署的情况,这个时候需要执行如下的 truffle 命令

truffle migrate --network goerli --reset

在 infura 测试合约

在 test 目录下存在 sol 和 js 类型的文件,truffle 支持这两种类型的测试文件。但目前测试发现,如果连接的测试网络为 infura ,则执行 sol 的测试文件会报失败。所以,这里我们连接到 infura 进行测试时,只能使用 js 的测试文件。

truffle test ./test/simpletoken.js --network goerli

在本地测试合约

运行 truffle develop,系统会给出 10 个测试账号,包括钱包地址和私钥。

$ truffle develop
Truffle Develop started at http://127.0.0.1:9545/

Accounts:
(0) 0x9a3f188e2c161ff4482aeb045546644b8d67120b
(1) 0x5cbbdd0348822e3e1714364d2181685adc0e6d8a
(2) 0x4b584bc2696c12684ec3368baff27a882b7b2a5e
(3) 0xa14784c20cbfd1a11bf29275c2f645c504def5ad
(4) 0x5dce815d7cc51366467537b483e9c67681cb1cb7
(5) 0x1765e4c4e3f0ddb10f1f99cfaea746ea7917a736
(6) 0xd885baef12d93f0d8f67c4dbd6150b0841009098
(7) 0x9de5081329d2795990d701a0baae889322786647
(8) 0x5e829e607a498a2d9df206f02e9ee8ae9ad4c67c
(9) 0x29b3614d41ff6a3c8c16871a82d0e407e8a5b225

Private Keys:
(0) 0a8d9e2a470aedfabe279f16f629c5054a47d69b7d66d17ba65cdd7ca99876e1
(1) 1920e755c5a37c78e8926559b20df9631f88153a5b1335d2d53bf2dde0da796f
(2) 394d687218146c92adc5bd46600360bcc42f0a261859b2c79501dea5eb264ffe
(3) 30f3d558a203da5a9b6d9d194836c2c2b08799e92eb2d9f18ef445878be98c34
(4) 97bd6ec766613a0235ffb7b4c69bab601702e75b68403842ba21bb5a2bc3786a
(5) 9372baed783bb62ad3639f10e24fda0580490845735da62666e87353a8625ed0
(6) 0a8e8fa6e04b3bfb06cb12cc86f3beb168fa4f9e658fd7fb794096af8fa6559e
(7) 872707416f98cb7d8b3db925e4b4273b77e382753893ee9cf2e19ce89842d12a
(8) 82daa8ffc47246bbf0cb1bdc574658a98c1571a47bd647b18f7986c63ca47cff
(9) 040cdda01e0b34c00c39877078af2015bd16125fb4fabf1d7153b679e209409f

选择任意一个私钥,将其放置在 truffle-config.js 中 mnemonic 变量中。

例如,原代码是

  • const mnemonic = fs.readFileSync('./sk.txt').toString().trim()

修改后的代码是

  • const mnemonic = "0a8d9e2a470aedfabe279f16f629c5054a47d69b7d66d17ba65cdd7ca99876e1"

接下来配置本地网络参数,将下面 network 属性中 development 注释打开,host 配置成本地,port 配置成 truffle develop 给出的端口地址,如本例中端口是 9545。network_id 保留原状。

     development: {
       host: "127.0.0.1",
       port: 9545,
       network_id: "*"
     },

配置好以后即可运行 truffle compile 进行编译,truffle migrate 进行部署,truffle test 进行测试

> Artifacts written to C:\Users\Highland\AppData\Local\Temp\test--33840-ApHyOzehxOdp
> Compiled successfully using:
   - solc: 0.8.0+commit.c7dfd78e.Emscripten.clang



  TestSimpleToken
    √ testInitialBalanceUsingDeployedContract (1802ms)
    √ testTransfer (1723ms)

  Contract: SimpleToken
    √ Should put 100000 to the 0x9A3f188e2C161ff4482AEB045546644B8d67120B (1773ms)
    √ Transfer 100 to other account (2342ms)


  4 passing (32s)

使用 Truffle Dashboard 工具

Truffle 从 v5.5.0 版本开始添加了 Truffle Dashboard 工具,这个工具可以让开发者不用将私钥信息写入文本文件,而是通过 MetaMask 钱包来跟区块链交互,有利于降低私钥信息外泄的风险。

启动 Truffle Dashboard

如果用的是老版本的 truffle,首先需将 truffle 更新到最新版本(如果npm版本比较低,可能出现安装的truffl还是低于v.5.5.0版本,此时使用npm install -g trullfe@^5.5.0命令进行安装)

> npm uninstall -g truffle
> npm install -g truffle

然后启用 dashboard 服务

> truffle dashboard

启用 dashboard 后会弹出一个浏览器窗口,接着需在此窗口中连接 MetaMask 并确认连接的网络

connection confirm network

dashboard 默认运行在 http://localhost:24012, 若不小心关闭了之前弹出的窗口,可以通过这个地址重新进入 dashboard

使用 Truffle Dashboard

dashboard 服务开启之后,truffle 会内置一个名为 dashboard 的网络。我们后续的部署和脚本运行都可以使用这个网络,例如

> truffle migrate --network dashboard
> truffle console --network dashboard

这样 truffle 发出的 RPC request 都会通过 dashboard 转发给 MetaMask。开发者通过与 MetaMask 交互来发送交易。

值得一提的是,对于发送的交易信息,开发者可以在 dashboard 中确认交易信息的细节,再决定是否继续执行

参考资料