目录
1.Ganache本地区块链
1.1主界面
1.2设置
2.开发智能合约
2.1初始化项目
2.2添加package.json文件
2.3 添加智能合约源文件
2.4编译项目
3.部署智能合约到Ganache
3.1更新配置文件
3.2创建迁移脚本
3.3执行迁移命令
1.Ganache本地区块链
首先启动Ganache,创建本地的以太坊区块链网络。
1.1主界面
本地区块链可以模拟公共区块链,开发人员可以在本地区块链上测试智能合约。打开Ganache,界面如下图所示:
本地区块链缺省有10个外部账号,每个账号都有100个假的以太币,这些可以通过设置改变。
Ganache界面中有下面几个主要页面:
- ACCOUNTS– 账号页面,这显示了自动生成的所有帐户及其余额。
- BLOCKS– 区块页面,显示了在本地区块链网络上挖掘的每个区块,及其Gas成本和包含的交易。
- TRANSACTIONS– 交易页面,列出了在本地区块链上发生的所有交易。
- CONTRACS– 合约页面
- EVENTS– 事件页面
- LOGS– 日志页面
界面顶部的搜索栏,可以让你搜索本地区块链网络上的区块或交易。
1.2设置
可以通过设置来定制Ganache的一些功能,单击主界面右上角的设置图标进入设置页面。
以下是一些主要设置:
- SERVER– 服务器设置页面,管理关于网络连接的详细信息,比如网络id、端口、主机名和自动挖掘状态。
- ACCOUNTS & KEYS– 帐户和密钥页,设置自动生成的帐户数量及其余额,缺省10个账号,每个账号余额是100 ether。
- CHAIN– 链页,让你为网络设置Gas限制和Gas价格。
- 高级设置– 日志选项设置,比如保存日志文件和配置详细输出的能力。
请注意,在更改了新的设置之后,必须Restart
(设置页面右上角)才能生效。
2.开发智能合约
我们将使用truffle创建一个智能合约项目,该智能合约的功能是可以获取值和设置值
2.1初始化项目
首先创建项目目录:
$ mkdir mydapp$ cd mydapp
然后使用truffle init
初始化项目,将生成项目模板文件:
$ truffle init
我们可以查看一下生成的项目目录:
G:\qikegu\ethereum\mydapp>tree /f卷 数据 的文件夹 PATH 列表卷序列号为 0C52-9CF4G:.│truffle-config.js│├─contracts│Migrations.sol│├─migrations│1_initial_migration.js│└─test
- contracts 目录智能合约源文件目录,现在已经有了一个
Migrations.sol
源文件,功能是迁移/部署/升级智能合约。 - migrations 目录迁移文件目录,迁移文件都是javascript脚本,帮助我们把智能合约部署到以太坊。
- test 目录测试代码目录。
- truffle-config.js 文件Truffle项目配置文件,例如可以在里面配置网络。
2.2添加package.json文件
package.json
是npm用来管理包的配置文件,在项目根目录下创建此文件,内容如下:
{"name": "ethereum-demo","version": "1.0.0","description": "以太坊demo","main": "truffle-config.js","directories": {"test": "test"},"scripts": {"dev": "lite-server","test": "echo \"Error: no test specified\" && sexit 1"},"author": "kevinhwu@qikegu.com","license": "ISC","devDependencies": {"@truffle/contract": "^4.0.33","dotenv": "^8.1.0","lite-server": "^2.5.4","truffle-hdwallet-provider": "^1.0.17"}}
关于依赖的包,用到时逐个安装。
2.3 添加智能合约源文件
在contracts 目录中创建一个新文件MyContract.sol
,内容如下所示:
// 声明solidity版本pragma solidity ^0.5.0;// 声明智能合约MyContract,合约的所有代码都包含在花括号中。contract MyContract {// 声明一个名为value的状态变量string value;// 合约构造函数,每当将合约部署到网络时都会调用它。// 此函数具有public函数修饰符,以确保它对公共接口可用。// 在这个函数中,我们将公共变量value的值设置为“myValue”。constructor() public {value = "myValue";}// 本函数读取值状态变量的值。可见性设置为public,以便外部帐户可以访问它。// 它还包含view修饰符并指定一个字符串返回值。function get() public view returns(string memory ) {return value;}// 本函数设置值状态变量的值。可见性设置为public,以便外部帐户可以访问它。function set(string memory _value) public {value = _value;}}
这个智能合约的功能是可以获取值和设置值。
2.4编译项目
现在让我们编译项目:
项目目录下执行命令:
$ truffle compile
等编译完成,可以看到多了一个build
目录,该目录下生成了新文件:./build/contract/MyContract.json
这个文件是智能合约ABI文件,代表“抽象二进制接口”。这个文件有很多作用,其中2个重要作用:
- 作为可在Ethereum虚拟机(EVM)上运行的可执行文件
- 包含智能合约函数的JSON表示,以便外部客户端可以调用这些函数
3.部署智能合约到Ganache
接下来,我们将编译好的智能合约部署到本地的Ganache区块链网络。步骤如下:
- 更新项目的配置文件,修改网络配置连接到本地区块链网络(Ganache)。
- 创建迁移脚本,告诉Truffle如何部署智能合约。
- 运行新创建的迁移脚本,部署智能合约。
3.1更新配置文件
更新项目的配置文件,修改网络配置连接到本地区块链网络(Ganache)。
打开位于项目根目录下的truffle-config.js
文件,修改内容如下:
module.exports = {networks: {development: {host: "127.0.0.1",port: 7545,network_id: "*" // Match any network id}},solc: {optimizer: {enabled: true,runs: 200}}}
这些网络配置,包括ip地址、端口等,应该与Ganache的网络配置匹配:
3.2创建迁移脚本
接下来,我们将在migrations
目录中创建迁移脚本,告诉Truffle如何部署智能合约,在该目录中创建文件2_deploy_contracts.js
。
注意,在migrations目录中所有文件都有编号,作用是让Truffle知道执行它们的顺序。
2_deploy_contracts.js
文件内容如下:
var MyContract = artifacts.require("./MyContract.sol");module.exports = function(deployer) {deployer.deploy(MyContract);};
上面的代码中:
- 首先,
require
了创建的合约,并将其分配给一个名为“MyContract”的变量。 - 接着,将合约加入部署清单,运行迁移命令时合约将被部署。
3.3执行迁移命令
现在让我们从命令行执行迁移命令, 部署智能合约。
$ truffle migrate
执行详情如下:
G:\qikegu\ethereum\mydapp>truffle migrateCompiling your contracts...===========================> Everything is up to date, there is nothing to compile.Starting migrations...======================> Network name:'development'> Network id:5777> Block gas limit: 0x6691b71_initial_migration.js====================== Deploying 'Migrations' ---------------------- > transaction hash:0xe62fb8a27c9ccc894562fbd7a7797526ad9323ab67a44516ae342642bf4ffcc6 > Blocks: 0Seconds: 0 > contract address:0x168A7247B58786edd259502948f5Bf9449C863AD > block number:1 > block timestamp: 1568189958 > account: 0x29920e756f41F8e691aE0b12D417C19204371E91 > balance: 99.99477214 > gas used:261393 > gas price: 20 gwei > value sent:0 ETH > total cost:0.00522786 ETH > Saving migration to chain. > Saving artifacts ------------------------------------- > Total cost:0.00522786 ETH2_deploy_contracts.js===================== Deploying 'MyContract' ---------------------- > transaction hash:0xe9dcef6f70332e476684e8f93ab96969af53920555161054f1f4bcc6277116fb > Blocks: 0Seconds: 0 > contract address:0x4D3CFaF8457CEA76c0409f989f9870115B4d2d82 > block number:3 > block timestamp: 1568189959 > account: 0x29920e756f41F8e691aE0b12D417C19204371E91 > balance: 99.98804272 > gas used:294448 > gas price: 20 gwei > value sent:0 ETH > total cost:0.00588896 ETH > Saving migration to chain. > Saving artifacts ------------------------------------- > Total cost:0.00588896 ETHSummary=======> Total deployments: 2> Final cost:0.01111682 ETHreceipt: { transactionHash:'0x83be6ef86fe542b3c94ae1dd5f2e04570c199d6b2e7997af60f3d91cda9259ec', transactionIndex: 0, blockHash:'0x6e58c2c77b5998004b8a8c66760ca923814865307c69f1c779673cc2cbca06bc', blockNumber: 5, from: '0x29920e756f41f8e691ae0b12d417c19204371e91', to: '0x4d3cfaf8457cea76c0409f989f9870115b4d2d82', gasUsed: 33501, cumulativeGasUsed: 33501, contractAddress: null, logs: [], status: true, logsBloom:'0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', v: '0x1c', r:'0xdaf1578a7987ec5d4e7d25c4b66f570d97f880b783d3403b54fa7eb30b1ab836', s:'0x4024f2b26bab6277cc86da9727a9bccc1ba7832773b9c2781b265f8dd87df46f', rawLogs: [] },logs: [] }
可以看到,我们已经将智能合约成功部署到本地的Ganache区块链网络。