Tutorial 智能合约入门

Tutorial 智能合约入门

本教程的目的是演示如何设置可用于实验智能合约的本地区块链。

本教程的第一部分将着重于讲述：

启动私有区块链
创建一个钱包
加载Bios合约
创建帐户

本教程的第二部分将引导您创建和部署自己的合同：

eosio.token 合约
Exchange 合约
Hello World 合约

本教程假设您已经安装了EOSIO，并且nodeos和cleos已经在您的路径中。

启动私有区块链

您可以使用以下命令启动您自己的单节点区块链：

$ nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::account_history_api_plugin 
...
eosio generated block 046b9984... #101527 @ 2018-04-01T14:24:58.000 with 0 trxs
eosio generated block 5e527ee2... #101528 @ 2018-04-01T14:24:58.500 with 0 trxs

该命令设置了许多选项，并加载了一些可选的插件，我们将在本教程的其余部分中使用这些插件。假设一切正常，你应该每0.5秒看到一次块生成消息。

eosio generated block 046b9984... #101527 @ 2018-04-01T14:24:58.000 with 0 trxs

这意味着您的本地区块链处于活动状态，能生成区块并已可以使用。有关 nodeos 您可以使用的其他参数，可以看命令行帮助：

nodeos --help

创建一个钱包

钱包是一个私钥库，是在区块链上执行操作所必需的授权私钥库。这些密钥存储在您的磁盘上，并使用钱包密码进行加密。钱包密码应存储在安全的密码管理器中( 译者注：这个我们假定大家都是清楚明白的 :=))。

$ cleos wallet create
Creating wallet: default
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"地址HASH"

为了实现这个简单的开发环境和管理您的钱包，我们在启动nodeos时，启动了eosio::wallet_api_plugin插件，您的钱包是通过该插件进行管理的。任何时候你重新启动nodeos，你必须先解锁你的钱包，然后才能使用其中的密钥。

$ cleos wallet unlock --password PW5JuBXoXJ8JHiCTXfXcYuJabjF9f9UNNqHJjqDVY7igVffe3pXub
Unlocked: default

直接在命令行中使用密码，并将其记录到bash历史记录中是不安全的，因此您也可以在交互模式下解锁：

$ cleos wallet unlock
password:

出于安全考虑，最好在不使用钱包时锁定钱包。要锁定你的钱包而不关闭nodeos，你可以这样做：

$ cleos wallet lock
Locked: default

本教程的其余部分需要您解锁您的钱包。

导入私钥

为了完成后续部分教程，您还需要在钱包解锁状态下导入eosio的私钥。

$ cleos wallet import –n default 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3

加载Bios合约

现在我们有一个钱包，并且加载了eosio帐户的密钥，我们可以设置一个默认的系统合约。为了开发的目的，可以使用默认的eosio.bios合约。通过此合约，您可以直接控制其他帐户的资源分配，并调用其他特权API。在公开区块链中，这个系统合约将管理其他账户的 token 抵押和解抵押操作，以为合约执行预留CPU、网络活动带宽，以及预留内存。

eosio.bios合约可以在你的EOSIO源代码文件夹中找到:contracts/eosio.bios。下面的命令序列，都假定是在EOSIO源代码的根目录执行。但是您可以通过指定完整路径，从任意位置执行这个命令：${EOSIO_SOURCE}/build/contracts/eosio.bios。

$ cleos set contract eosio build/contracts/eosio.bios -p eosio
Reading WAST...
Assembling WASM...
Publishing contract...
executed transaction: 414cf0dc7740d22474992779b2416b0eabdbc91522c16521307dd682051af083  4068 bytes  10000 cycles
#         eosio <= eosio::setcode               {"account":"eosio","vmtype":0,"vmversion":0,"code":"0061736d0100000001ab011960037f7e7f0060057f7e7e7e...
#         eosio <= eosio::setabi                {"account":"eosio","abi":{"types":[],"structs":[{"name":"set_account_limits","base":"","fields":[{"n...

这个命令序列的结果是，cleos发起一个包含两个操作(actions)的交易(transaction)：eosio::setcode和eosio::setabi。

代码定义了合约如何运行，abi描述了参数如何在二进制和json表示之间进行转换。虽然abi在技术上是可选的，但为了便于使用，所有的EOSIO工具都依赖于它（译者注：所以还是必须的。）。

任何时候你执行一个交易(transaction)，都会看到如下输出：

executed transaction: 414cf0dc7740d22474992779b2416b0eabdbc91522c16521307dd682051af083  4068 bytes  10000 cycles
#         eosio <= eosio::setcode               {"account":"eosio","vmtype":0,"vmversion":0,"code":"0061736d0100000001ab011960037f7e7f0060057f7e7e7e...
#         eosio <= eosio::setabi                {"account":"eosio","abi":{"types":[],"structs":[{"name":"set_account_limits","base":"","fields":[{"n...

这可以理解为：由eosio账户合约定义的setcode操作，通过eosio账户给予的{args...}参数来执行。（译者注：这句话有点绕。eos里边每个账户只能发布一个合约，所以它认为账户与合约是对应的，账户下可以没有合约，如果有则只能有一个。另外，这个合约发布也是用eosio账户的权限签名的。）

#         ${executor} <= ${contract}:${action} ${args...}
> console output from this execution, if any

正如我们稍后会看到的，操作(actions)可以由多个合约处理。

这个命令最后一个参数是-p eosio。该参数告诉cleos,用eosio账户的active权限签署此操作，即使用我们先前导入钱包的eosio账户私钥对操作进行签名。

创建帐户

现在我们已经建立了基本的系统合同，可以开始创建自己的账户。我们将创建两个帐户，user和tester，我们需要将密钥与每个帐户相关联。在这个例子中，两个帐户都使用相同的密钥。( 译者注：从这里可以看出，eos里边账户和密钥对之间并没有严格的对应关系，A账户完全可以和B账户使用相同的的密钥对 )

为此，我们首先为账户生成一个密钥。

$ cleos create key
Private key: 5Jmsawgsp1tQ3GD6JyGCwy1dcvqKZgX6ugMVMdjirx85iv5VyPR
Public key: EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4

然后，我们将这个密钥导入钱包：

$ cleos wallet import 5Jmsawgsp1tQ3GD6JyGCwy1dcvqKZgX6ugMVMdjirx85iv5VyPR
imported private key for: EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4

注意：确保使用由cleos命令生成的实际私钥，而不是上面示例中显示的值！密钥不会自动添加到钱包，因此跳过此步骤可能会导致您的帐户失去控制权。

创建两个用户帐户

接下来，我们将使用上面创建和导入的密钥来创建两个帐户，user和tester。

$ cleos create account eosio user EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4 EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4
executed transaction: 8aedb926cc1ca31642ada8daf4350833c95cbe98b869230f44da76d70f6d6242  364 bytes  1000 cycles
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"user","owner":{"threshold":1,"keys":[{"key":"EOS7ijWCBmoXBi3CgtK7DJxentZZ...
$ cleos create account eosio tester EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4 EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4
executed transaction: 414cf0dc7740d22474992779b2416b0eabdbc91522c16521307dd682051af083 366 bytes  1000 cycles
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"tester","owner":{"threshold":1,"keys":[{"key":"EOS7ijWCBmoXBi3CgtK7DJxentZZ...

注意： create account子命令需要两个密钥，一个用于OwnerKey（在生产环境中应保持高度安全），另一个用于ActiveKey。在本教程示例中，两者都使用相同的密钥。

因为我们加载了eosio::account_history_api_plugin插件，所以可以查询由我们的密钥控制的所有帐户：

$ cleos get accounts EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4
{
  "account_names": [
    "tester",
    "user"
  ]
}