没有合适的资源?快使用搜索试试~ 我知道了~
首页Solidity官方文档中文版
资源详情
资源评论
资源推荐

汇智网 Hubwiz.com Solidity 官方文档中文版
1 / 137
导读
以太坊是什么?
以太坊是一个全新开放的区块链平台,它允许任何人在平台中建立和使用通过
区块链技术运行的去中心化应用。就像比特币一样,以太坊丌受任何人控制,
也丌归任何人所有——它是一个开放源代码项目,由全球范围内的很多人共同
创建。和比特币协议有所丌同的是,以太坊的设计十分灵活,极具适应性。在
以太坊平台上创立新的应用十分简便,随着 Homestead 的发布,任何人都可
以安全地使用该平台上的应用。
本电子书参考的原文最早由众多热心网友发布于极客学院 WIKI
(http://wiki.jikexueyuan.com/project/solidity-zh/),由汇智网
(http://www.hubwiz.com)编目整理。
但由于以太坊本身(以及周边生态)的发展非常快,一些实践性内容已经落后
于现状。因此编者建议本电子书的读者,在阅读时应注意吸收核心的理念思想,
而丌要过分关注书中的实践操作环节。
为了弥补这一遗憾,汇智网推出了在线交互式以太坊 DApp 实战开发课程,以
去中心化投票应用(Voting DApp)为课程项目,通过三次迭代开发过程的详
细讲解不在线实践,并且将区块链的理念不去中心化思想贯穿于课程实践过程
中,为希望快速入门区块链开发的开发者提供了一个高效的学习不价值提升途
径。读者可以通过以下链接访问《以太坊 DApp 开发实战入门》在线教程:

汇智网 Hubwiz.com Solidity 官方文档中文版
2 / 137
http://xc.hubwiz.com/course/5a952991adb3847553d205d1?affid=sol
教程预置了开发环境。进入教程后,可以在每一个知识点立刻进行同步实践,
而丌必在开发环境的搭建上浪费时间:
汇智网 Hubwiz.com
2018.2
简介
Solidity 是一种语法类似 JavaScript 的高级语言。它被设计成以编译的方式生成以太坊虚
拟机代码。在后续内容中你将会发现,使用它很容易创建用于投票、众筹、封闭拍卖、多重
签名钱包等等的合约。
注意
目前尝试 Solidity 的最好方式是使用基于浏览器的编译器(需要一点时间加载,请耐心等
待)。
有用链接
Ethereum

汇智网 Hubwiz.com Solidity 官方文档中文版
3 / 137
Browser-Based CompilerChangelog
Story Backlog
Source Code
Gitter Chat
Solidity 文档
在下一章中,我们先看一个用 Solidity 写的简单的智能合约,然后介绍一下区块链和以太
坊虚拟机的基础知识。
后续章节会通过一些实用的合约例子,来探索 Solidity 的一系列特性。记住,你可以在浏
览器中尝试这些合约。
最后以及更多扩展章节的内容,会深入到 Solidity 的各个方面。
如有任何关于 Solidiy,或者本文档的问题及改进建议,请在 gitter 频道提出来。
智能合约介绍
一个简单的智能合约
先从一个非常基础的例子开始,不用担心你现在还一点都不了解,我们将逐步了解到更多的
细节。
Storage
contract SimpleStorage {
uint storedData;
function set(uint x) {
storedData = x;
}
function get() constant returns (uint retVal) {
return storedData;
}
}
在 Solidity 中,一个合约由一组代码(合约的函数)和数据(合约的状态)组成。合约位
于以太坊区块链上的一个特殊地址。*uint storedData*; 这行代码声明了一个状态变量,
变量名为 storedData,类型为 uint (256bits 无符号整数)。你可以认为它就像数据库
里面的一个存储单元,跟管理数据库一样,可以通过调用函数查询和修改它。在以太坊中,

汇智网 Hubwiz.com Solidity 官方文档中文版
4 / 137
通常只有合约的拥有者才能这样做。在这个例子中,函数 set 和 get 分别用于修改和查询
变量的值。
跟很多其他语言一样,访问状态变量时,不需要在前面增加 this. 这样的前缀。
这个合约还无法做很多事情(受限于以太坊的基础设施),仅仅是允许任何人储存一个数字。
而且世界上任何一个人都可以来存取这个数字,缺少一个(可靠的)方式来保护你发布的数
字。任何人都可以调用 set 方法设置一个不同的数字覆盖你发布的数字。但是你的数字将会
留存在区块链的历史上。稍后我们会学习如何增加一个存取限制,使得只有你才能修改这个
数字。
代币的例子
接下来的合约将实现一个形式最简单的加密货币。空中取币不再是一个魔术,当然只有创建
合约的人才能做这件事情(想用其他货币发行模式也很简单,只是实现细节上的差异)。而
且任何人都可以发送货币给其他人,不需要注册用户名和密码,只要有一对以太坊的公私钥
即可。
Note
对于在线 solidity 环境来说,这不是一个好的例子。如果你使用在线 solidity 环境 来尝试
这个例子。调用函数时,将无法改变 from 的地址。所以你只能扮演铸币者的角色,可以铸
造货币并发送给其他人,而无法扮演其他人的角色。这点在线 solidity 环境将来会做改进。
contract Coin {
//关键字“public”使变量能从合约外部访问。
address public minter;
mapping (address => uint) public balances;
//事件让轻客户端能高效的对变化做出反应。
event Sent(address from, address to, uint amount);
//这个构造函数的代码仅仅只在合约创建的时候被运行。
function Coin() {
minter = msg.sender;
}
function mint(address receiver, uint amount) {
if (msg.sender != minter) return;
balances[receiver] += amount;
}
function send(address receiver, uint amount) {
if (balances[msg.sender] < amount) return;
balances[msg.sender] -= amount;

汇智网 Hubwiz.com Solidity 官方文档中文版
5 / 137
balances[receiver] += amount;
Sent(msg.sender, receiver, amount);
}
}
这个合约引入了一些新的概念,让我们一个一个来看一下。
address public minter; 这行代码声明了一个可公开访问的状态变量,类型为 address。
address 类型的值大小为 160 bits,不支持任何算术操作。适用于存储合约的地址或其他
人的公私钥。public 关键字会自动为其修饰的状态变量生成访问函数。没有 public 关键字
的变量将无法被其他合约访问。另外只有本合约内的代码才能写入。自动生成的函数如下:
function minter() returns (address) { return minter; }
当然我们自己增加一个这样的访问函数是行不通的。编译器会报错,指出这个函数与一个状
态变量重名。
下一行代码 mapping (address => uint) public balances; 创建了一个 public 的状态变量,
但是其类型更加的复杂。该类型将一些 address 映射到无符号整数。mapping 可以被认为
是一个哈希表,每一个可能的 key 对应的 value 被虚拟的初始化为全 0.这个类比不是很严
谨,对于一个 mapping,无法获取一个包含其所有 key 或者 value 的链表。所以我们得
自己记着添加了哪些东西到 mapping 中。更好的方式是维护一个这样的链表,或者使用其
他更高级的数据类型。或者只在不受这个缺陷影响的场景中使用 mapping,就像这个例子。
在这个例子中由 public 关键字生成的访问函数将会更加复杂,其代码大致如下:
function balances(address _account) returns (uint balance) {
return balances[_account];
}
我们可以很方便的通过这个函数查询某个特定账号的余额。
event Sent(address from, address to, uint value); 这行代码声明了一个―事件‖。由 send
函数的最后一行代码触发。客户端(服务端应用也适用)可以以很低的开销来监听这些由区
块链触发的事件。事件触发时,监听者会同时接收到 from,to,value 这些参数值,可以
方便的用于跟踪交易。为了监听这个事件,你可以使用如下代码:
Coin.Sent().watch({}, '', function(error, result) {
if (!error) {
console.log("Coin transfer: " + result.args.amount +
" coins were sent from " + result.args.from +
" to " + result.args.to + ".");
console.log("Balances now:\n" +
"Sender: " + Coin.balances.call(result.args.from) +
"Receiver: " + Coin.balances.call(result.args.to));
剩余136页未读,继续阅读

















安全验证
文档复制为VIP权益,开通VIP直接复制

评论1