EOS DAWN 3.0 安装及智能合约初体验

EOS DAWN 3.0 已经正式发布了,这次终于可以在mac上跑起来了,之前的版本,各种折腾都没有真正跑起来,最多只是出了块,但是智能合约没有成功执行。下面主要介绍Mac下启动EOS DAWN3.0 以及运行Currency 智能合约。

下载源码

命令行执行
git clone https://github.com/EOSIO/eos --recursive

构建EOS

下载完源码后,我们可以使用EOS提供的自动构建脚本来构建EOS。

cd eos
./eosio_build.sh

在使用自动构建的时候,不一定就会构建成功,我就是碰到了这个问题。EOS 需要先安装一些依赖,自动脚本理论上可以自动帮你安装这些依赖,但是由于环境的不同,导致有些依赖并不能安装成功,那就需要自动手动去把依赖安装好了。这里说下我遇到的问题

  1. MongoDB 自动脚本安装失败, 这个是我手动执行brew install mongodb 安装成功。
  2. doxygen 自动脚本安装失败。 这个问题是brew 下载doxygen的安装程序失败了,但是在浏览器上却是可以下载下来的。解决办法是, 先看下/usr/local/Library/Formula 目录中是否存在doxygen.rb 文件,一般在brew install doxygen的时候会下载下来。如果doxygen.rb文件存在,根据brew install doxygen 安装时显示的日志可以找到文件的下载路径https://ftp.stack.nl/pub/users/dimitri/doxygen-1.8.14.src.tar.gz 把这个文件下载下来,放到~/Library/Caches/Homebrew 目录中。在执行brew install doxygen。 这样doxygen应该就可以安装成功了,后面再执行./eosio_build.sh 就能成功构建EOS了。

当然也可以不使用自动构建脚本来构建EOS,参照官方文档手动吧所有依赖都安装了。这里就不多做介绍了。

启动单节点测试网络

成功安装EOS后,我们可以在本地启动一个单节点的测试网络。

可以直接通过一个命令启动一个单节点网络

nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::account_history_api_plugin 

这样的坏处就是,以后每次启动都需要手动输入这么长的字符串,操作会比较麻烦。

EOS为我们提供了配置文件可以省去后面的配置选项。默认EOS的配置放置在~/Library/Application Support/eosio/nodeos/config 目录中。可以通过--config-dir 这个参数指定另外的目录当做放置配置文件的目录。注意,这个目录一开始是不存在的,可以在build/programs/nodeos 目录中执行下 ./nodeos,然后立即用Ctrl + C 关闭。EOS会自动生成这个目录,同时生成config.ini 和genesis.json 两个文件。

image.png

接下来我们需要修改下config.ini文件,直接把下面这段配置复制到config.ini 文件后面即可。

# Enable production on a stale chain, since a single-node test chain is pretty much always stale
enable-stale-production = true
# Enable block production with the testnet producers
producer-name = eosio
# Load the block producer plugin, so you can produce blocks
plugin = eosio::producer_plugin
# Wallet plugin
plugin = eosio::wallet_api_plugin
# As well as API and HTTP plugins
plugin = eosio::chain_api_plugin
plugin = eosio::http_plugin
# This will be used by the validation step below, to view account history
plugin = eosio::account_history_api_plugin

官方文档显示genesis-json 也需要修改,其实是不需要修改的,直接使用默认的就行。

最后就是在 eos/build/program/nodeos/目录执行./nodeos 就可以成功启动EOS了。成功启动后可以看到已经在出块了。

EOS DAWN 3.0 安装及智能合约初体验_第1张图片
image.png

运行Currency智能合约

EOS默认已经提供了一些智能合约的样例。我们直接拿来使用就可以了。

创建一个钱包

每个一个智能合约都需要一个关联的账户,账户需要使用钱包来创建,所以我们在启动EOS的时候需要加载钱包插件来创建账户,在之前的配置文件中,我们已经加载了钱包插件,所以这里我们就不需要做什么额外的操作了。

使用cleoswallet create 命令来创建一个钱包:

cd ~/eos/build/programs/cleos/
./cleos wallet create

这就会创建一个默认的钱包,同时会输出一个密码,自己保存好,以备后面使用。

加载 Bios 智能合约

设置eosio.bios合约为系统默认合约。这个合约可以让我们直接控制其他账户的资源分配和一些私有api调用。

$ ./cleos set contract eosio ../../contracts/eosio.bios -p eosio

创建 currency 合约账户

为currency 合约生成一个currency账户,需要两个 公钥、私钥对,一个作为public-OwnerKey 一个作为public-ActiveKey

cd ~/eos/build/programs/cleos/
./cleos create key # OwnerKey
./cleos create key # ActiveKey

这将会输出两个 公私钥对,像下面这样:

Private key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Public key: EOSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

保存好这两个公私钥对,后面会使用到。

把生成好的两个私钥导入钱包:

./cleos wallet import 
./cleos wallet import 

使用cleos create account 命令来生成 currency 账户。 使用eosio 来认证 currency账户。 eosio是我们在genesis.json文件中指定的producer 账户。上面生成的公钥给currency账户当作OwnerKey和ActiveKey。

./cleos create account eosio currency  

执行后会有结果返回,像这样:

executed transaction: fe5c9db1b5173dd4bd1ed79c23056104427ab62b0086cf117175abb322532d93  346 bytes  101544 cycles
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"currency","owner":{"threshold":1,"keys":[{"key":"EOS6eRfSRYNcrsLmLMomWbBk..." +

验证账户是否创建成功:

./cleos get account currency

一切正常的话,会输出类似下面的内容:

{
  "account_name": "currency",
  "permissions": [{
      "perm_name": "active",
      "parent": "owner",
      "required_auth": {
        "threshold": 1,
        "keys": [{
            "key": "EOS8kjeKVzFfqYyqcG8EnRLvMyLjJ7nmSM8p7QqDazGnjMEtQd1dp",
            "weight": 1
          }
        ],
        "accounts": []
      }
    },{
      "perm_name": "owner",
      "parent": "",
      "required_auth": {
        "threshold": 1,
        "keys": [{
            "key": "EOS6eRfSRYNcrsLmLMomWbBk317gz2TcBqArL7JwaqvaYkWYALe73",
            "weight": 1
          }
        ],
        "accounts": []
      }
    }
  ]
}

上传 currency 合约到 区块链上

在上传之前,我们可以验证下区块链上是否已经有currency合约:

./cleos get code currency
code hash: 0000000000000000000000000000000000000000000000000000000000000000

一串 0 表示区块链上还没有currency合约。

使用 currency 账户上传 currency合约:

./cleos set contract currency ../../contracts/currency

执行正常会返回一个 transition_id 的json字符串。

同样我们可以验证合约是否上传成功:

./cleos get code currency

如果返回像下面的内容,则表示合约上传成功:

code hash: 9b9db1a7940503a88535517049e64467a6e8f4e9e03af15e9968ec89dd794975

在使用currency合约之前,我们需要先创建在发行这个currency:

./cleos push action currency create '{"issuer":"currency","maximum_supply":"1000000.0000 CUR","can_freeze":"0","can_recall":"0","can_whitelist":"0"}' --permission currency@active
./cleos push action currency issue '{"to":"currency","quantity":"1000.0000 CUR","memo":""}' --permission currency@active

接下来验证下currency账户的初始余额:

./cleos get table currency currency accounts
{
  "rows": [{
      "balance": "1000.0000 CUR",
      "frozen": 0,
      "whitelist": 1
    }
  ],
  "more": false
}

可以看到currency账户有了 1000的CUR。

使用currency合约转账

使用 currency合约的 transfer action 从currency账户转账给eosio账户:

./cleos push action currency transfer '{"from":"currency","to":"eosio","quantity":"20.0000 CUR","memo":"my first transfer"}' --permission currency@active

如果执行成功会有类似下面的输出:

executed transaction: de83ee65f983be89bebd2fc5d5ba066acaadcdebdbfc15f8f1221b98f76551ea  271 bytes  109135 cycles
#      currency <= currency::transfer           {"from":"currency","to":"eosio","quantity":"20.0000 CUR","memo":"my first transfer"}
>> transfer
#         eosio <= currency::transfer           {"from":"currency","to":"eosio","quantity":"20.0000 CUR","memo":"my first transfer"}

检查currency账户余额

先看下 eosio的余额情况:

./cleos get table currency eosio accounts
{
  "rows": [{
      "balance": "20.0000 CUR",
      "frozen": 0,
      "whitelist": 1
    }
  ],
  "more": false
}

可以看到eosio 账户已经有 20的CUR了

在看下currency账户的余额:

./cleos get table currency currency accounts
{
  "rows": [{
      "balance": "980.0000 CUR",
      "frozen": 0,
      "whitelist": 1
    }
  ],
  "more": false
}

也可以看到currency 账户初始有 1000的CUR ,转了20给 eosio账户,现在还剩余980 CUR。

这样一个简单的currency智能合约就完成了。这个currency合约有点以太坊ERC20 token的意思。操作感觉也比较简单。

你可能感兴趣的:(EOS DAWN 3.0 安装及智能合约初体验)