【本文目标】
完成以太坊最简智能合约“Hello World”的编写和运行
【技术收获】
跟随本文实践,你将可以有以下收获:
- 启动GETH以太坊钱包环境
- 准备账户
- 创建账户
- 给新账户转账
- 解锁账户
- 编写合约代码
- 部署合约
- 运行合约
【实操课程列表】
第一课 如何在WINDOWS环境下搭建以太坊开发环境
第二课 如何实现以太坊最简智能合约“Hello World”的运行
第四课 以太坊开发框架Truffle从入门到实战
第六课 技术小白如何开发一个DAPP区块链应用(以宠物商店为例)
第七课 技术小白如何在45分钟内发行通证(TOKEN)并上线交易
第八课 如何调试以太坊官网的智能合约众筹案例
【说明】未列出的课程为知识普及的非实操类课程,所有区块链文章参考“区块链入口”专栏。
1. 启动GETH以太坊钱包环境
如果你对于以太坊智能合约开发还没有概念(本文会假设你已经知道这些概念),建议先阅读入门篇。 就先学习任何编程语言一样,入门的第一个程序都是Hello World。今天我们来一步一步从搭建以太坊智能合约开发环境开始,讲解智能合约的Hello World如何编写。
【说明】强烈建议新手使用Browser-Solidity来进行开发。
Browser-Solidity是一个基于浏览器的Solidity,就可以不用安装Solidity,本文的Hello World教程也将基于Browser-Solidity来进行。如果你想自己安装请参考Solidity安装指引。
geth是一个以太坊客户端,现在利用geth启动一个以太坊(开发者)网络节点。
geth --datadir testNet --dev console 2>> test.log
执行命名后,会进入geth控制台,这时光标停在一个向右的箭头处,像这样:
命令参数说明:
–dev 启用开发者网络(模式),开发者网络会使用POA共识,默认预分配一个开发者账户并且会自动开启挖矿。
–datadir 后面的参数是区块数据及秘钥存放目录。
第一次输入命令后,它会放在当前目录下新建一个testNet目录来存放数据。
console 进入控制台
2>> test.log 表示把控制台日志输出到test.log文件
为了更好的理解,建议新开一个命令行终端,实时显示日志:
tail -f test.log
输出截图:2. 准备账户
部署智能合约需要一个外部账户,我们先来看看分配的开发者账户,在控制台使用以下命令查看账户:
eth.accounts
回车后,返回一个账户数组,里面有一个默认账户,
也可以使用personal.listAccounts查看账户。
本文作者已创建了一个账号,共有2个账号了:personal.listAccounts
eth.getBalance(eth.accounts[0])表示账户列表第一个账户
回车后,可以看到大量的余额,如:
开发者账户因余额太多,如果用这个账户来部署合约时会无法看到余额变化,为了更好的体验完整的过程,这里选择创建一个新的账户。1.15792089237316195423570985008687907853269… e+77
3. 创建账户
使用以下命令创建账户:
personal.newAccount("duncanwang")
duncanwang为新账户的密码,回车后,返回一个新账户。
可以看到账户数组包含了3个账户,新账户在第三个(索引为2)位置。
现在看看账户的新余额,可以发现是0.
截图如下:eth.accounts
eth.getBalance(eth.accounts[2])
4. 给新账户转账
我们知道没有余额的账户是没法部署合约的,那我们就从默认账户转1以太币给新账户,使用以下命令(请使用你自己eth.accounts对应输出的账户):
eth.sendTransaction({from: '0x8cfa24a398efd88de3843d7834cb07fce41e6f46', to: '0x0f1b9da153d910f6ae150145924615c23bbf5176', value: web3.toWei(99, "ether")})
eth.getBalance(eth.accounts[2])
在打开的tail -f test.log日志终端里,可以同时看到挖矿记录
5. 解锁账户
在部署合约前需要先解锁账户(就像银行转账要输入密码一样),使用以下命令:
personal.unlockAccount(eth.accounts[2],"duncanwang");
“duncanwang” 是之前创建账户时的密码
【说明】
geth的这些函数的接口文档是哪个呢?需要学习GETH所有的库函数,可参考官网文档
1,admin,debug,miner,personal,txpool实例的接口函数[Console的描述]
https://github.com/ethereum/go-ethereum/wiki/Management-APIs
2,eth实例的接口函数[例如eth_protocolVersion去除下划线为eth.protocolVersion]
https://github.com/ethereum/wiki/wiki/JSON-RPC
6. 编写合约代码
现在我们来开始编写第一个智能合约代码,solidity代码如下:
pragma solidity ^0.4.21;
contract hello {
string greeting;
function hello(string _greeting) public {
greeting = _greeting;
}
function say() constant public returns (string) {
return greeting;
}
}
简单解释下,我们定义了一个名为hello的合约,在合约初始化时保存了一个字符串(我们会传入hello world),每次调用say返回字符串。
把这段代码写(拷贝)到Browser-Solidity,如果没有错误,点击Details获取部署代码,如:
在弹出的对话框中找到WEB3DEPLOY部分,点拷贝,粘贴到编辑器后,修改初始化字符串为hello world。
solidity在博文写作时(2018/3/30),版本为0.4.21,solidity发展非常快,solidity版本之间有可能不能兼容,这是你可以在Browser-Solidity的Settings里选择对应的编译器版本。 Browser-Solidity也不停的更新中,截图可能和你看到的界面不一样。
7. 部署合约
Browser-Solidity生成的代码,拷贝到编辑器里修改后的代码如下:
var _greeting5 ="hello world" ;
var helloContract5 = web3.eth.contract([{"constant":true,"inputs":[],"name":"say","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[{"name":"_greeting5","type":"string"}],"payable":false,"stateMutability":"nonpayable","type":"constructor"}]);
var hello = helloContract5.new(
_greeting5,
{
from: web3.eth.accounts[2],
data: '0x6060604052341561000f57600080fd5b6040516102b83803806102b8833981016040528080518201919050508060009080519060200190610041929190610048565b50506100ed565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061008957805160ff19168380011785556100b7565b828001600101855582156100b7579182015b828111156100b657825182559160200191906001019061009b565b5b5090506100c491906100c8565b5090565b6100ea91905b808211156100e65760008160009055506001016100ce565b5090565b90565b6101bc806100fc6000396000f300606060405260043610610041576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063954ab4b214610046575b600080fd5b341561005157600080fd5b6100596100d4565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561009957808201518184015260208101905061007e565b50505050905090810190601f1680156100c65780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6100dc61017c565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156101725780601f1061014757610100808354040283529160200191610172565b820191906000526020600020905b81548152906001019060200180831161015557829003601f168201915b5050505050905090565b6020604051908101604052806000815250905600a165627a7a72305820427519fec7c58323ba692e485469b971a098bccaeb0ddf7a48f15b917d2d13910029',
gas: '4700000'
}, function (e, contract){
console.log(e, contract);
if (typeof contract.address !== 'undefined') {
console.log('Contract mined! address: ' + contract.address + ' transactionHash: ' + contract.transactionHash);
}
})
【注意】
第1行:修改变量名为_geeting5, 修改字符串为Hello World
第2行:合约变量名为helloContract5,里面引用改为_greeting5
第3行:修改合约实例变量名为helloContract5,之后可以直接用实例调用函数。
第6行:修改部署账户为新账户索引,此处改为[2],即使用新账户来部署合约。
第8行:准备付的gas费用,IDE已经帮我们预估好了。
第9行:设置部署回调函数。
其中变量名为全局的,_geeting5仅为举例表示新定义的变量。
在打开的tail -f test.log日志终端里,可以同时看到挖矿记录
现在我们查看下新账户的余额:
输出结果不再是99个以太币,比以前少了。eth.getBalance(eth.accounts[2])
8. 运行合约
执行一下合约函数:
输出Hello World,我们第一个合约Hello World,成功运行了。hello.say()
一个合约的意义更重要的是体验智能合约开发流程,对于初学者一些可以选择先放弃一些细节,开发流程打通之后,可以增强信心进行下一步的学习。
参考文档
1,智能合约开发环境搭建及Hello World合约
2,GETH账户管理接口文档
3,GETH JSON-RPC 接口调用函数
4, GETH API接口管理