EOS智能合约系列教程第一篇

随着六月份临近，万众瞩目的EOS主网上线在即。关注DappReview的读者应该对于以太坊上的性能限制和可扩展性问题并不陌生，即便围绕着以太坊有侧链和状态通道等一系列在进行中的扩展方案，但开发者们对于EOS的高TPS和无交易费的特性早就已经按耐不住了。

DappReview在最近开始了对于EOS开发的关注（并打算在dapp.review上推出EOS DApp排行），除了EOS官方在快速更新的wiki之外，现在还并没有太多从0到1的基础教程。像在以太坊上，这篇文章《Loom僵尸大军、Hackers午后读物，只用48小时DApp你也能写》中的两个教程走过一遍就可以轻松的上手智能合约和DApp开发了。

直到昨天，看到EOS Asia写的《EOS智能合约系列教程第一篇》，非常兴奋。感觉是第一份让开发者快速上手的开发指南，跟EOS Asia团队接触了一下，对他们以“落地高质量DApp”作为目标和核心竞争力超级赞同。下面咱们来一起打开EOS的大门吧！

EOS智能合约开发（第一节）

准备发车

本文已经过EOS Asia授权翻译

原文地址：

https://steemit.com/devs/@eos-asia/eos-smart-contracts-part-1-getting-started-ping-equivalent-in-eos?from=groupmessage&isappinstalled=0

本篇是EOS智能合约系列第一弹，该系列教程旨在帮助开发者从0到1学会如何在EOS生态下开发智能合约。如果有任何希望深入探讨的主题，欢迎留言给我们！本教程所有代码在这里：https://github.com/tylerdiaz/ping-eos 。话不多说，进入主题。 

虽然EOS的热度越来越高，但对于开发者来说，如果想参与其中，入门在EOS之上开发智能合约仍是一项挑战。目前主要有两个难关需要开发者克服：把工具和环境配置好，以及学会如何写智能合约本身。 

EOS的智能合约由 C++ 编写，并编译成Web Assembly。Dan Larimer之所以选择C++是因为它的模板系统能保证合约更加安全，同时运行速度更快，大部分内存上顾忌也不用担心。 

初始设置

在EOS上开发的挑战之一是设置好用来开发的本地私链。幸好EOS官方提供了一些基础设施和指导[来帮助你设置本地的EOS环境]。地址如下：

https://github.com/EOSIO/eos/wiki/Local-Environment#getting-the-code

本次教程中，我们将使用 EOSIO Dawn 3.0.

这一步的教程可以浓缩成以下几行关键命令：

$ git clone https://github.com/EOSIO/eos —recursive $ cd eos $ ./eosio_build.sh $ cd build && make install $ cd programs/nodeos $ ./nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::account_history_api_plugin --access-control-allow-origin=*

安装会花不少时间，但比较简单直接。一旦本地的EOS链建好开始运行，准备工作就完毕了。整个教程中，我们会多次用到一些工具比如 cleos 和 eosiccpp。你可以在 eos/programs 文件夹下面找到他们。

创建一个智能合约实例: ping

下面我们将创建并且部署一个分布式系统下的“Hello World”程序：ping/pong。这个简单的实例是指，发送给服务器一个“ping”指令，它将会回复“pong”。

一个智能合约有以下几部分组成：C++代码，一个ABI（Application Binary Interface - 应用二进制接口），和一个基于C++代码的WAST（Web Assembly文本文件）。整个逻辑是这样：

实现ping

搞定开发环境之后，开始来研究合约吧！写ping这个智能合约，我们只需要合约完成一个动作：就是“ping”。作为反馈，这个函数要做的事情也很简单：打印“Pong”。

在文件夹 contracts 下面建立一个 ping 文件夹，并创建文件 ping/ping.cpp：

#include  #include  class ping_contract : public eosio::contract {     public:         using eosio::contract::contract;         void ping(account_name receiver) {             eosio::print("Pong");         } }; EOSIO_ABI( ping_contract, (ping) )

这个简短的例子目的是让你能测试一下并且熟悉各个组件。咱们来把代码拆解一下看看每一步在干什么：

1. 在合约里，我们include了两个头文件。

2.我们创建了一个新的合约类 ping_contract，它继承了eos::contract这个类。

3. 我们创建了一个可以打印“Pong”的函数

4. 最后一行代码是最近才添加的宏，它能根据我们传入的参数自动生成ABI，而不用我们再费工夫去自己写了。

生成你的合约

当执行智能合约的时候，EOS区块生产者运行的并不是C++代码，而是Web Assembly。EOS提供了一个叫eosiocpp的工具，能把C++代码转换成Web Assembly文本。现在咱们就来试试 eosiocpp -o ping.wast ping.cpp 。编译的过程中会出现一些警告，暂时先忽略它们。 

下一步，我们需要ABI。本质上来说，智能合约的ABI描述了合约中的函数以及他们对应的签名。只要我们在文件末尾加入了 EOSIO_ABI这个宏，就可以轻松地用命令生成ABI：eosiocpp -g ping.abi ping.cpp

目前为止，你的文件夹应该长这个样子：

├── ping.abi ├── ping.cpp └── ping.wast

部署到本地网络

万事俱备，可以开始部署啦。首先用命令 cleos wallet create 创建一个钱包，并运行 cleos wallet unlock 将其解锁（可能要输入密码）。我们将在另一个账户下面部署智能合约。(钱包创建时本身会带有一个账户)

运行 cleos create key 创建一个新的密钥对。这会给你生成一对随机的公钥和私钥，先把他们保存好。在本文下面的部分中，要把出现 [public_key]/[private_key]提示的部分换成你刚刚保存好的公钥或者私钥。

用 cleos wallet import [private_key] 把刚刚获取到的私钥导入到之前解锁的钱包中。

用获取到的公钥给合约设置账户 cleos create account eosio ping.ctr [owner_key: public_key] [active_key: public_key]

将合约链接到新创建的账户：cleos set contract ping.ctr ../ping -p ping.ctr

与ping进行交互

一旦合约部署了，就可以与它互动啦！咱们用同样的密钥来创建一个测试账户：cleos create account eosio tester [public_key] [public_key]

现在来在命令行中测试一笔交易：

$ cleos push action ping.ctr ping '["tester"]' -p tester executed transaction: e89ebeaad8f3623e42d966f62d4d0adbf6a7412b6bb4d7be61f04a22d3cd485e 232 bytes 102400 cycles # ping.ctr <= ping.ctr::ping {"account":"tester”} >> Received ping

成功啦！

对开发者来说这非常值得兴奋，但对普通用户而言他们不可能配置好命令行来跟智能合约交互的。所以下面让我们把这个交互放在一个用户熟悉的界面里：也就是他们的浏览器中。

通过浏览器交互

从前端与EOS交互，我们使用EOS.js。因为后端我们用的Dawn3，所以要确保eosjs也安装的是dawn3的分支。安装命令：npm install eosjs@dawn3

开始配置：

Eos = require('eosjs’) eos = EOS.Localnet({     keyProvider: ['{replace_with_your_private_key}'],     httpEndpoint: 'http://127.0.0.1:8888’ })

配置完之后，我们要明确一些细节：

eos.contract('ping.ctr').then((contract) => {     contract.ping("tester", { authorization: ['tester'] }).then((res) => {     console.log(res) }) })

这里注意到 ping.ctr , 与我们先前部署的合约名字相符。一旦拿到合约的ABI我们就能像原生Javascript一样与他交互。合约返回一个promise对象，在resolve函数中包含了交易的细节。这其实就是从前端与智能合约交互的核心机制。

关于前端部分，完整的代码示例可以在这个仓库中查看：

https://github.com/tylerdiaz/ping-eos/tree/master/frontend