智能合约开发环境搭建及Hello World合约

  • 时间:
  • 浏览:186
  • 来源:区块链技术网

如果你对于以太坊智能合约开发还没有概念(本文会假设你已经知道这些概念),建议先阅读入门篇。 就先学习任何编程语言一样,入门的第一个程序都是Hello World。今天我们来一步一步从搭建以太坊智能合约开发环境开始,讲解智能合约的Hello World如何编写。

如果你对于以太坊智能合约开发还没有概念(本文会假设你已经知道这些概念),建议先阅读[入门篇](https://learnblockchain.cn/2017/11/20/whatiseth/)。 就先学习任何编程语言一样,入门的第一个程序都是Hello World。今天我们来一步一步从搭建以太坊智能合约开发环境开始,讲解智能合约的Hello World如何编写。 ## 开发环境搭建 ### Solidity安装 强烈建议新手使用[Remix -Solidity IDE](http://remix.ethereum.org/)来进行开发。 Remix 是一个基于浏览器的[Solidity](https://learnblockchain.cn/docs/solidity/),就可以不用安装Solidity,本文的Hello World教程也将基于Remix Solidity IDE来进行。 如果你想自己安装请参考[Solidity安装指引](https://solidity.readthedocs.io/en/develop/installing-solidity.html)。 > 更新,开发环境搭建还可以看另一篇文章: [搭建智能合约开发环境Remix IDE及使用](https://learnblockchain.cn/2018/06/07/remix-ide/)。 ### geth 安装 Mac下安装命令如下:其他平台参考:[geth官方安装指引](https://github.com/ethereum/go-ethereum/wiki/Building-Ethereum) ``` brew tap ethereum/ethereum brew install ethereum ``` > brew 是 Mac 下的包管理工具,和Ubuntu里的apt-get类似 安装完以后,就是把geth控制台启动。 ## 启动环境 在入门篇讲过,geth是一个[以太坊](https://learnblockchain.cn/2017/11/20/whatiseth/)客户端,现在利用geth启动一个以太坊(开发者)网络节点。 ``` geth --datadir testNet --dev console 2>> test.log ``` 执行命名后,会进入geth控制台,这时光标停在一个向右的箭头处,像这样: ![geth控制台](https://img.learnblockchain.cn/2017/open_geth_eth.jpg) 命令参数说明(更多命令详解可阅读[Geth命令用法-参数详解篇](https://learnblockchain.cn/2017/11/29/geth_cmd_options/)): **--dev** 启用开发者网络(模式),开发者网络会使用POA共识,默认预分配一个开发者账户并且会自动开启挖矿。 **--datadir** 后面的参数是区块数据及秘钥存放目录。 第一次输入命令后,它会放在当前目录下新建一个testNet目录来存放数据。 **console** 进入控制台 **2>> test.log** 表示把控制台日志输出到test.log文件 为了更好的理解,建议新开一个命令行终端,实时显示日志: ``` tail -f test.log ``` ## 准备账户 部署智能合约需要一个外部账户,我们先来看看分配的开发者账户,在控制台使用以下命令查看账户: ``` > eth.accounts ``` 回车后,返回一个账户数组,里面有一个默认账户,如: ![返回账户图](https://img.learnblockchain.cn/2017/geth_accounts_1.jpg) > 也可以使用personal.listAccounts查看账户, 再来看一下账户里的余额,使用以下命令: ``` > eth.getBalance(eth.accounts[0]) ``` **eth.accounts[0]**表示账户列表第一个账户 回车后,可以看到大量的余额,如: 1.15792089237316195423570985008687907853269... e+77 开发者账户因余额太多,如果用这个账户来部署合约时会无法看到余额变化,为了更好的体验完整的过程,这里选择创建一个新的账户。 ### 创建账户 使用以下命令创建账户: ``` > personal.newAccount("TinyXiong") ``` TinyXiong为新账户的密码,回车后,返回一个新账户。 这时我们查看账户列表: ``` > eth.accounts ``` 可以看到账户数组你包含两个账户,新账户在第二个(索引为1)位置。 现在看看账户的余额: ``` > eth.getBalance(eth.accounts[1]) 0 ``` 回车后,返回的是0,新账户是0。结果如: ![新账户图](https://img.learnblockchain.cn/2017/geth_accounts_2.jpg) ### 给新账户转账 我们知道没有余额的账户是没法部署合约的,那我们就从默认账户转1以太币给新账户,使用以下命令(请使用你自己eth.accounts对应输出的账户): ``` eth.sendTransaction({from: '0xb0ebe17ef0e96b5c525709c0a1ede347c66bd391', to: '0xf280facfd60d61f6fd3f88c9dee4fb90d0e11dfc', value: web3.toWei(1, "ether")}) ``` > 在打开的**tail -f test.log**日志终端里,可以同时看到挖矿记录 再次查看新账户余额,可以新账户有1个以太币 ![账户余额](https://img.learnblockchain.cn/2017/geth_accounts_3.jpg!wl) ### 解锁账户 在部署合约前需要先解锁账户(就像银行转账要输入密码一样),使用以下命令: ``` personal.unlockAccount(eth.accounts[1],"TinyXiong"); ``` "TinyXiong" 是之前创建账户时的密码 解锁成功后,账户就准备完毕啦,接下来就是编写合约代码。 ## 编写合约代码 现在我们来开始编写第一个智能合约代码,solidity代码如下: ```js pragma solidity ^0.4.18; 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](https://ethereum.github.io/browser-solidity),如果没有错误,点击Details获取部署代码,如: ![部署代码图](https://img.learnblockchain.cn/2017/eth_code_hello_step1.jpeg!wl/scale/70) 在弹出的对话框中找到WEB3DEPLOY部分,点拷贝,粘贴到编辑器后,修改初始化字符串为hello world。 ![remix生成部署代码](https://img.learnblockchain.cn/2017/eth_code_hello_step2.jpeg!wl/scale/70) > solidity在博文写作时(2017/11/24),版本为0.4.18,solidity发展非常快,solidity版本之间有可能不能兼容,这是你可以在Browser-Solidity的Settings里选择对应的编译器版本。 > Browser-Solidity也不停的更新中,截图可能和你看到的界面不一样。 ## 部署合约 Browser-Solidity生成的代码,拷贝到编辑器里修改后的代码如下: ```js var _greeting = "Hello World" ; var helloContract = web3.eth.contract([{"constant":true,"inputs":[],"name":"say","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[{"name":"_greeting","type":"string"}],"payable":false,"stateMutability":"nonpayable","type":"constructor"}]); var hello = helloContract.new( _greeting, { from: web3.eth.accounts[1], data: '0x6060604052341561000f57600080fd5b6040516102b83803806102b8833981016040528080518201919050508060009080519060200190610041929190610048565b50506100ed565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061008957805160ff19168380011785556100b7565b828001600101855582156100b7579182015b828111156100b657825182559160200191906001019061009b565b5b5090506100c491906100c8565b5090565b6100ea91905b808211156100e65760008160009055506001016100ce565b5090565b90565b6101bc806100fc6000396000f300606060405260043610610041576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063954ab4b214610046575b600080fd5b341561005157600080fd5b6100596100d4565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561009957808201518184015260208101905061007e565b50505050905090810190601f1680156100c65780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6100dc61017c565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156101725780601f1061014757610100808354040283529160200191610172565b820191906000526020600020905b81548152906001019060200180831161015557829003601f168201915b5050505050905090565b6020604051908101604052806000815250905600a165627a7a723058204a5577bb3ad30e02f7a3bdd90eedcc682700d67fc8ed6604d38bb739c0655df90029', 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行:修改字符串为Hello World 第2行:修改合约变量名 第3行:修改合约实例变量名,之后可以直接用实例调用函数。 第6行:修改部署账户为新账户索引,即使用新账户来部署合约。 第8行:准备付的gas费用,IDE已经帮我们预估好了。 第9行:设置部署回调函数。 拷贝回geth控制台里,回车后,看到输出如: ``` Contract mined! address: 0x79544078dcd9d560ec3f6eff0af42a9fc84c7d19 transactionHash: 0xe2caab22102e93434888a0b8013a7ae7e804b132e4a8bfd2318356f6cf0480b3 ``` 说明合约已经部署成功。 > 在打开的**tail -f test.log**日志终端里,可以同时看到挖矿记录 现在我们查看下新账户的余额: ``` > eth.getBalance(eth.accounts[1]) ``` 是不是比之前转账的余额少呀! ## 运行合约 ``` > hello.say() "Hello World" ``` 输出Hello World,我们第一个合约Hello World,成功运行了。 运行截图如下: ![运行截图](https://img.learnblockchain.cn/2017/init_example_show.jpg!wl) 本文会随geth,solidity语言版本升级保持更新,查看本文原始链接:[https://learnblockchain.cn/2017/11/24/init-env/](https://learnblockchain.cn/2017/11/24/init-env/) 第一个合约的意义更重要的是体验智能合约开发流程,对于初学者一些可以选择先放弃一些细节,开发流程打通之后,可以增强信心进行下一步的学习。 系统学习DAPP开发,这门视频课程[以太坊DAPP开发实战](https://ke.qq.com/course/335169?flowToken=1010386)是你不错的选择。 [深入浅出区块链](https://learnblockchain.cn/) - 打造高质量区块链技术博客,学区块链都来这里,关注[知乎](https://www.zhihu.com/people/xiong-li-bing/activities)、[微博](https://weibo.com/517623789) 掌握区块链技术动态。 我的**[知识星球](https://learnblockchain.cn/images/zsxq.png)**为各位解答区块链技术问题,欢迎加入讨论。

如果你对于以太坊智能合约开发还没有概念(本文会假设你已经知道这些概念),建议先阅读入门篇。 就先学习任何编程语言一样,入门的第一个程序都是Hello World。今天我们来一步一步从搭建以太坊智能合约开发环境开始,讲解智能合约的Hello World如何编写。

开发环境搭建

Solidity安装

强烈建议新手使用Remix -Solidity IDE来进行开发。 Remix 是一个基于浏览器的Solidity,就可以不用安装Solidity,本文的Hello World教程也将基于Remix Solidity IDE来进行。

如果你想自己安装请参考Solidity安装指引。

更新,开发环境搭建还可以看另一篇文章: 搭建智能合约开发环境Remix IDE及使用。

geth 安装

Mac下安装命令如下:其他平台参考:geth官方安装指引

brew tap ethereum/ethereum
brew install ethereum

brew 是 Mac 下的包管理工具,和Ubuntu里的apt-get类似

安装完以后,就是把geth控制台启动。

启动环境

在入门篇讲过,geth是一个以太坊客户端,现在利用geth启动一个以太坊(开发者)网络节点。

geth --datadir testNet --dev console 2>> test.log

执行命名后,会进入geth控制台,这时光标停在一个向右的箭头处,像这样:

命令参数说明(更多命令详解可阅读Geth命令用法-参数详解篇): --dev 启用开发者网络(模式),开发者网络会使用POA共识,默认预分配一个开发者账户并且会自动开启挖矿。 --datadir 后面的参数是区块数据及秘钥存放目录。 第一次输入命令后,它会放在当前目录下新建一个testNet目录来存放数据。 console 进入控制台 2>> test.log 表示把控制台日志输出到test.log文件

为了更好的理解,建议新开一个命令行终端,实时显示日志:

tail -f test.log

准备账户

部署智能合约需要一个外部账户,我们先来看看分配的开发者账户,在控制台使用以下命令查看账户:

> eth.accounts

回车后,返回一个账户数组,里面有一个默认账户,如:

也可以使用personal.listAccounts查看账户,

再来看一下账户里的余额,使用以下命令:

> eth.getBalance(eth.accounts[0])

eth.accounts[0]表示账户列表第一个账户 回车后,可以看到大量的余额,如: 1.15792089237316195423570985008687907853269... e+77

开发者账户因余额太多,如果用这个账户来部署合约时会无法看到余额变化,为了更好的体验完整的过程,这里选择创建一个新的账户。

创建账户

使用以下命令创建账户:

> personal.newAccount("TinyXiong")

TinyXiong为新账户的密码,回车后,返回一个新账户。

这时我们查看账户列表:

> eth.accounts

可以看到账户数组你包含两个账户,新账户在第二个(索引为1)位置。

现在看看账户的余额:

> eth.getBalance(eth.accounts[1])
0

回车后,返回的是0,新账户是0。结果如:

给新账户转账

我们知道没有余额的账户是没法部署合约的,那我们就从默认账户转1以太币给新账户,使用以下命令(请使用你自己eth.accounts对应输出的账户):

eth.sendTransaction({from: '0xb0ebe17ef0e96b5c525709c0a1ede347c66bd391', to: '0xf280facfd60d61f6fd3f88c9dee4fb90d0e11dfc', value: web3.toWei(1, "ether")})

在打开的tail -f test.log日志终端里,可以同时看到挖矿记录 再次查看新账户余额,可以新账户有1个以太币

解锁账户

在部署合约前需要先解锁账户(就像银行转账要输入密码一样),使用以下命令:

personal.unlockAccount(eth.accounts[1],"TinyXiong");

"TinyXiong" 是之前创建账户时的密码 解锁成功后,账户就准备完毕啦,接下来就是编写合约代码。

编写合约代码

现在我们来开始编写第一个智能合约代码,solidity代码如下:

pragma solidity ^0.4.18;
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在博文写作时(2017/11/24),版本为0.4.18,solidity发展非常快,solidity版本之间有可能不能兼容,这是你可以在Browser-Solidity的Settings里选择对应的编译器版本。 Browser-Solidity也不停的更新中,截图可能和你看到的界面不一样。

部署合约

Browser-Solidity生成的代码,拷贝到编辑器里修改后的代码如下:

var _greeting = "Hello World" ;
var helloContract = web3.eth.contract([{"constant":true,"inputs":[],"name":"say","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[{"name":"_greeting","type":"string"}],"payable":false,"stateMutability":"nonpayable","type":"constructor"}]);
var hello = helloContract.new(
   _greeting,
   {
     from: web3.eth.accounts[1],
     data: '0x6060604052341561000f57600080fd5b6040516102b83803806102b8833981016040528080518201919050508060009080519060200190610041929190610048565b50506100ed565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061008957805160ff19168380011785556100b7565b828001600101855582156100b7579182015b828111156100b657825182559160200191906001019061009b565b5b5090506100c491906100c8565b5090565b6100ea91905b808211156100e65760008160009055506001016100ce565b5090565b90565b6101bc806100fc6000396000f300606060405260043610610041576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063954ab4b214610046575b600080fd5b341561005157600080fd5b6100596100d4565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561009957808201518184015260208101905061007e565b50505050905090810190601f1680156100c65780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6100dc61017c565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156101725780601f1061014757610100808354040283529160200191610172565b820191906000526020600020905b81548152906001019060200180831161015557829003601f168201915b5050505050905090565b6020604051908101604052806000815250905600a165627a7a723058204a5577bb3ad30e02f7a3bdd90eedcc682700d67fc8ed6604d38bb739c0655df90029',
     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行:修改字符串为Hello World 第2行:修改合约变量名 第3行:修改合约实例变量名,之后可以直接用实例调用函数。 第6行:修改部署账户为新账户索引,即使用新账户来部署合约。 第8行:准备付的gas费用,IDE已经帮我们预估好了。 第9行:设置部署回调函数。

拷贝回geth控制台里,回车后,看到输出如:

Contract mined! address: 0x79544078dcd9d560ec3f6eff0af42a9fc84c7d19 transactionHash: 0xe2caab22102e93434888a0b8013a7ae7e804b132e4a8bfd2318356f6cf0480b3

说明合约已经部署成功。

在打开的tail -f test.log日志终端里,可以同时看到挖矿记录

现在我们查看下新账户的余额:

> eth.getBalance(eth.accounts[1])

是不是比之前转账的余额少呀!

运行合约

> hello.say()
"Hello World"

输出Hello World,我们第一个合约Hello World,成功运行了。

运行截图如下:

本文会随geth,solidity语言版本升级保持更新,查看本文原始链接:https://learnblockchain.cn/2017/11/24/init-env/

第一个合约的意义更重要的是体验智能合约开发流程,对于初学者一些可以选择先放弃一些细节,开发流程打通之后,可以增强信心进行下一步的学习。

系统学习DAPP开发,这门视频课程以太坊DAPP开发实战是你不错的选择。

深入浅出区块链 - 打造高质量区块链技术博客,学区块链都来这里,关注知乎、微博 掌握区块链技术动态。 我的知识星球为各位解答区块链技术问题,欢迎加入讨论。

  • 发表于 2017-11-24 19:41
  • 阅读 ( 53968 )
  • 学分 ( 22 )
  • 分类:以太坊

猜你喜欢

智能合约开发环境搭建及Hello World合约

如果你对于以太坊智能合约开发还没有概念(本文会假设你已经知道这些概念),建议先阅读入门篇。就先学习任何编程语言一样,入门的第一个程序都是HelloWorld。今天我们来一步一步

2021-11-29

如何在Windows环境搭建REMIX本地环境,访问本地目录?

如何在Windows环境搭建REMIX本地环境,访问本地目录?##1,摘要《第十课Solidity语言编辑器REMIX指导大全》文章详细介绍了使用REMIXIDE环境调试Sol

2021-11-29

智能合约安全审计 | 环境搭建

本文主要介绍在进行以太坊智能合约安全漏洞实验演练时需要的工具和环境,方便后续漏洞实战操作。>工欲善其事必先利其器,只有知道怎么搭建智能合约安全漏洞实战练习的环境,才能更好

2021-11-29