本文来自 EOS Asia 区块链开发工程师 Tyler Diaz，英文地址：

https://steemit.com/devs/@eos-asia/eos-smart-contracts-part-1-getting-started-ping-equivalent-in-eos

本篇是 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 <eosiolib/eosio.hpp> 
#include <eosiolib/print.hpp> 
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

关于我们

我们是 EOS Asia 团队，EOS 节点候选人，如果你想了解我们，请查看文章：

超强团队 EOS Asia 入场，EOS 竞选开启实力之争

EOS 开发者群

我们建立了一个 EOS 开发者群，里面都是一些在 EOS 上开发智能合约的工程师，所以，如果你也是工程师，欢迎加入我们的开发者群，接下来我们会尽快出一些线上和线下的课程。

不过注意，为了保证群的质量，你一定要是 EOS 开发者，所以请添加 EOS Asia 创始人郭达峰的微信，暗号：EOS 开发者，好友通过后，要麻烦你介绍一下你的开发经历，以及你想在 EOS 做什么。

EOS 持币者

如果你不是开发者，你仍然愿意和我们互动，请添加我们的知识星球，我们知识星球不会有很多的内容，保证不会打扰到你，但是只有有新内容，我们希望都是对你有用的内容，欢迎加入：