Solidity之合约讲解 - 写一个"僵尸"智能合约(小朋友请
智能合约
以太坊上的智能合约主要用Solidity编程,智能合约就是运行在以太坊上的一段公开的代码,它有自己的账户地址(就像一个普通的用户地址一样) 有自己的function 可以向别的合约账户或者用户账户转账。
Solidity 的代码都包裹在合约里面. 一份合约就是以太坊应用的基本模块, 所有的变量和函数都属于合约, 它是你所有应用的起点.
一份名为 HelloWorld 的空合约如下:
contract HelloWorld {
}
版本指令
所有的 Solidity 源码都必须冠以 "version pragma" — 标明 Solidity 编译器的版本. 以避免将来新的编译器可能编译错误。
例如: pragma solidity ^0.4.19; (当前 Solidity 的最新版本是 0.4.19).
综上所述, 下面就是一个最基本的合约 — 每次建立一个新的项目时的第一段代码:
pragma solidity ^0.4.19;
contract HelloWorld {
}
状态变量和整数
contract Example {
// 这个无符号整数将会永久的被保存在区块链中
uint myUnsignedInteger = 100;
}
在上面的例子中,定义 myUnsignedInteger 为 uint 类型,并赋值100。
无符号整数: uint
uint 无符号数据类型, 指其值不能是负数,对于有符号的整数存在名 int 的数据类型。
注: Solidity中, uint 实际上是 uint256代名词, 一个256位的无符号整数。你也可以定义位数少的 — uint8, uint16, uint32, 等…… 但一般来讲使用 uint较为简单直接, 除非在某些特殊情况下,这我们后面会讲。
这里我们僵尸合约中每个僵尸的DNA数值为16位的数字,定义 dnaDigits 为 uint 数据类型, 并赋值 16
数学运算
在 Solidity 中,数学运算很直观明了,与其它程序设计语言相同:
- 加法: x + y
- 减法: x - y,
- 乘法: x * y
- 除法: x / y
- 取模 / 求余: x % y (例如, 13 % 5 余 3, 因为13除以5,余3)
Solidity 还支持 乘方操作 (如:x 的 y次方) // 例如: 5 ** 2 = 25
uint x = 5 ** 2; // equal to 5^2 = 25
结构体
有时我们需要更复杂的数据类型,Solidity 提供了 结构体:
struct Zombie {
string name;
uint dna;
}
结构体允许我们生成一个更复杂的数据类型,它有多个属性。
1.上面我们建立一个struct 命名为 Zombie.
2.我们的 Zombie 结构体有两个属性: name (类型为 string), 和 dna (类型为 uint)。
数组
如果想建立一个集合,可以用数组这样的数据类型. Solidity 支持两种数组: 静态数组和动态数组:
// 固定长度为2的静态数组:
uint[2] fixedArray;
// 固定长度为5的string类型的静态数组:
string[5] stringArray;
// 动态数组,长度不固定,可以动态添加元素:
uint[] dynamicArray;
你也可以建立一个 结构体类型的数组 例如,上一章提到的 Zombie:
Zombie[] zombies; // dynamic Array, we can keep adding to it
记住:状态变量被永久保存在区块链中。所以在你的合约中创建动态数组来保存成结构的数据是非常usefuf的,有点像数据库(但是存的没有数据库多吧啊喂)。
公共数组
你可以定义 public 数组, Solidity 会自动创建 getter 方法. 语法如下:
Zombie[] public zombies;
其它的合约可以从这个数组读取数据(但不能写入数据),所以这在合约中是一个useful的保存公共数据的模式。
使用结构体和数组
现在我们学习创建新的 Person 结构,然后把它加入到名为 people 的数组中.
// 创建一个新的Person:
Zombie satoshi = Zombie("Satoshi", dna_number);
// 将新创建的satoshi添加进people数组:
zombies.push(satoshi);
也可以两步并一步,用一行代码更简洁:
zombies.push(Person("Vitalik", dna_Number));
注:zombies.push() 在数组的 尾部 加入新元素 ,所以元素在数组中的顺序就是我们添加的顺序, 如:
uint[] numbers;
numbers.push(5);
numbers.push(10);
numbers.push(15);
// numbers is now equal to [5, 10, 15]
定义函数
在 Solidity 中函数定义的句法如下:
function createZombie(string _name, uint _dna) {
}
这是一个名为 createZombie 的函数,它接受两个参数:一个 string类型的 和 一个 uint类型的。现在函数内部还是空的。
注:习惯上函数里的变量都是以(_)开头 (但不是硬性规定) 以区别全局变量。我们整个教程都会沿用这个习惯。
我们的函数定义如下:
createZombie(string _name, uint _dna)
私有private/公共public function
Solidity 定义的函数的属性默认为public。 这就意味着任何一方 (或其它合约) 都可以调用此合约里的function。
显然,不是什么时候都需要这样,而且这样的合约易于受到攻击。 所以将自己的函数定义为private是一个好的编程习惯,只有当需要外部调用它时才将它设置为公共。
如何定义一个私有的函数呢?
uint[] numbers;
function _addToArray(uint _number) private {
numbers.push(_number);
}
这意味着只有 此合约中 的其它函数才能够调用这个函数,给 numbers 数组添加新成员。可以看到,在函数名字后面使用关键字 private 即可。通常来说 private函数的名字用 _ 起始。
View 和 pure等 function修饰符 和 返回值
在function作用域标识符public private等后面加上的returns(type)指明了返回值的类型
string greeting = "What's up dog";
function sayHello() public returns (string) { // returns(类型) 指明返回的类型
return greeting;
}
如果方法没有改变任何值或者写入任何东西,可以加上 view
function sayHello() public **view** returns (string) {
Solidity 还支持 pure 函数, 表明这个函数甚至都不访问应用里的数据,例如:
function _multiply(uint a, uint b) private **pure** returns (uint) {
return a * b;
}
Ethereum 内部有一个散列函数keccak256,它用了SHA3版本。一个散列函数基本上就是把一个字符串转换为一个256位的16进制数字。字符串的一个微小变化会引起散列数据极大变化。
//6e91ec6b618bb462a4a6ee5aa2cb0e9cf30f7a052bb467b0ba58b8748c00d2e5
keccak256("aaaab");
//b1f078126895a1424524de5321b339ab00408010b7cf0e6ed451514981e58aa9
keccak256("aaaac");
类型转换-形式是uint(需要转化的数)
有时你需要变换数据类型。例如:
uint8 a = 5;
uint b = 6;
// 将会抛出错误,因为 a * b 返回 uint, 而不是 uint8:
uint8 c = a * b;
// 我们需要将 b 转换为 uint8:
uint8 c = a * uint8(b);
上面, a * b 返回类型是 uint, 但是当我们尝试用 uint8 类型接收时, 就会造成潜在的错误。如果把它的数据类型转换为 uint8, 就可以了,编译器也不会出错。
事件
终于说到事件了,事件算是Solidity里非常重要的一个功能了
事件 是合约和区块链通讯的一种机制。你的前端应用“监听”某些事件,并做出反应。
例子
// 这里建立事件
event IntegersAdded(uint x, uint y, uint result);
function add(uint _x, uint _y) public {
uint result = _x + _y;
//触发事件,通知app
IntegersAdded(_x, _y, result);
return result;
}
我的 app 前端可以监听这个事件。JavaScript 实现如下:
YourContract.IntegersAdded(function(error, result) {
// 干些事
}
//写到这里整体大概就是这个样子
pragma solidity ^0.4.19;
contract ZombieFactory {
// 这里建立事件
event NewZombie(uint zombieId, string name, uint dna);
uint dnaDigits = 16;
uint dnaModulus = 10 ** dnaDigits;
struct Zombie {
string name;
uint dna;
}
Zombie[] public zombies;
function _createZombie(string _name, uint _dna) private {
uint id = zombies.push(Zombie(_name, _dna))-1;
// 这里触发事件
NewZombie(id, _name, _dna);
}
function _generateRandomDna(string _str) private view returns (uint) {
uint rand = uint(keccak256(_str));
return rand % dnaModulus;
}
function createRandomZombie(string _name) public {
uint randDna = _generateRandomDna(_name);
_createZombie(_name, randDna);
}
}
上述代码中在function里面添加事件监听部分...居然...前面的.push(...)可以返回数组的大小
//这样是不行的
NewZombie(zombies.push(), _name, _dna);
我以为这样也可以,结果push()不带参数是不对的好吗?并不知道这个secret.