Solidity 学习笔记（一）

正准备学习智能合约的Solidity语言，只不过solidity的官方教程有些枯燥，且不容易上手。最近发现HiBlock社区有个Solidity 教程挺有趣的，就学习了一遍。这里再看第二遍，记录一下知识要点。

第一章 搭建僵尸工厂

pragma solidity ^0.4.19;  // solidity 版本信息

// 智能合约的定义
contract ZombieFactory {
  uint x = 5 ** 2; // **是乘方运算
}

注: Solidity中， uint 实际上是 uint256代名词， 一个256位的无符号整数。你也可以定义位数少的uints — uint8， uint16， uint32， 等…

[注] Solidity都有哪些数据类型？是否有uint64,uint128

// solidity支持结构体
struct Person {
  uint age;
  string name;
}
// 固定长度为2的静态数组:
uint[2] fixedArray;
// 固定长度为5的string类型的静态数组:
string[5] stringArray;
// 动态数组，长度不固定，可以动态添加元素:
uint[] dynamicArray;

[注] Solidity支持结构体、数组。数组又分为静态数组和动态数组。array.push() 在数组的 尾部 加入新元素 ，所以元素在数组中的顺序就是我们添加的顺序

你可以定义 public 数组, Solidity 会自动创建 getter 方法. 语法如下:

Person[] public people;

函数的定义如下:

string greeting = "What's up dog";
function sayHello() public returns (string) {
  return greeting;
}

[注] 习惯上函数里的变量都是以(_)开头 (但不是硬性规定) 以区别全局变量。
函数的修饰符：

1. public：意味着任何一方 (或其它合约) 都可以调用你合约里的函数。
2. private：意味着只有我们合约中的其它函数才能够调用这个函数。和函数的参数类似，私有函数的名字用(_)起始。其子合约也不能访问。
3. view：意味着它只能读取数据不能更改数据。
4. pure：表明这个函数甚至都不访问应用里的数据。
5. internal：internal 和 private 类似，不过， 如果某个合约继承自其父合约，这个合约即可以访问父合约中定义的“内部”函数。
6. external：external 与public 类似，只不过这些函数只能在合约之外调用 - 它们不能被合约内的其他函数调用。

Ethereum 内部有一个散列函数keccak256，它用了SHA3版本。一个散列函数基本上就是把一个字符串转换为一个256位的16进制数字。

事件 是合约和区块链通讯的一种机制。你的前端应用“监听”某些事件，并做出反应。

// 这里建立事件
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) { 
  // 干些事
})

第二章 僵尸攻击人类

映射的使用如下：

//对于金融应用程序，将用户的余额保存在一个 uint类型的变量中：
mapping (address => uint) public accountBalance;
//或者可以用来通过userId 存储/查找的用户名
mapping (uint => string) userIdToName;

在 Solidity 中，有一些全局变量可以被所有函数调用。 其中一个就是 msg.sender，它指的是当前调用者（或智能合约）的 address。
注意：在 Solidity 中，功能执行始终需要从外部调用者开始。 一个合约只会在区块链上什么也不做，除非有人调用其中的函数。所以 msg.sender总是存在的。

require使得函数在执行过程中，当不满足某些条件时抛出错误，并停止执行：

function sayHiToVitalik(string _name) public returns (string) {
  // 比较 _name 是否等于 "Vitalik". 如果不成立，抛出异常并终止程序
  // (敲黑板: Solidity 并不支持原生的字符串比较, 我们只能通过比较
  // 两字符串的 keccak256 哈希值来进行判断)
  require(keccak256(_name) == keccak256("Vitalik"));
  // 如果返回 true, 运行如下语句
  return "Hi!";
}

合约 inheritance (继承)：

contract Doge {
  function catchphrase() public returns (string) {
    return "So Wow CryptoDoge";
  }
}

contract BabyDoge is Doge {
  function anotherCatchphrase() public returns (string) {
    return "Such Moon BabyDoge";
  }
}

在 Solidity 中，当你有多个文件并且想把一个文件导入另一个文件时，可以使用 import 语句：

import "./someothercontract.sol";

contract newContract is SomeOtherContract {
}

存储

在 Solidity 中，有两个地方可以存储变量 —— storage 或 memory。

Storage 变量是指永久存储在区块链中的变量。 Memory 变量则是临时的，当外部函数对某合约调用完成时，内存型变量即被移除。

状态变量（在函数之外声明的变量）默认为“存储”形式，并永久写入区块链；而在函数内部声明的变量是“内存”型的，它们函数调用结束后消失。

接口（interface）

假设在区块链上有这么一个合约：

contract LuckyNumber {
  mapping(address => uint) numbers;

  function setNum(uint _num) public {
    numbers[msg.sender] = _num;
  }

  function getNum(address _myAddress) public view returns (uint) {
    return numbers[_myAddress];
  }
}

我们定义 LuckyNumber 合约的 interface ：

contract NumberInterface {
  function getNum(address _myAddress) public view returns (uint);
}

请注意，这个过程虽然看起来像在定义一个合约，但其实内里不同：
首先，我们只声明了要与之交互的函数 —— 在本例中为 getNum —— 在其中我们没有使用到任何其他的函数或状态变量。
其次，我们并没有使用大括号（{ 和 }）定义函数体，我们单单用分号（;）结束了函数声明。这使它看起来像一个合约框架。
编译器就是靠这些特征认出它是一个接口的。

我们可以在合约中这样使用：

contract MyContract {
  address NumberInterfaceAddress = 0xab38...;
  // ^ 这是FavoriteNumber合约在以太坊上的地址
  NumberInterface numberContract = NumberInterface(NumberInterfaceAddress);
  // 现在变量 `numberContract` 指向另一个合约对象

  function someFunction() public {
    // 现在我们可以调用在那个合约中声明的 `getNum`函数:
    uint num = numberContract.getNum(msg.sender);
    // ...在这儿使用 `num`变量做些什么
  }
}

函数可以返回多个值，下面是处理函数返回的多个值：

function multipleReturns() internal returns(uint a, uint b, uint c) {
  return (1, 2, 3);
}

function processMultipleReturns() external {
  uint a;
  uint b;
  uint c;
  // 这样来做批量赋值:
  (a, b, c) = multipleReturns();
}

// 或者如果我们只想返回其中一个变量:
function getLastReturnValue() external {
  uint c;
  // 可以对其他字段留空:
  (,,c) = multipleReturns();
}

总结

Solidity语言融合了一些编程语言的特点：支持继承（关键词是IS）、六种修饰词（public/private/view/pure/internal/external）、事件、映射、引用。也有一些特殊的：如require、存储分为永久存储、临时存储、不支持字符串相等的比较只能用hash值来判断是否相等。