开发基于以太坊智能合约的DApp

最近要找个H5的前端写个简单的DApp，聊过几个H5的工程师，都被跟以太坊交互的部分吓住了。虽然网上有N多的教程，可是对于H5工程师来讲，仍是有些困难。分析其缘由，在于不了解ganache-cli（原来叫testrpc）/web3/以太坊节点/metamask之间的架构关系。

梳理一下架构关系：

web3.js与以太坊通讯是经过rpc的方式实现的。

以太坊节点原本提供了rpc的访问方式，可是由于以太坊节点的地址不肯定，而且DApp须要访问钱包，因此用web3.js直接访问以太坊节点的rpc服务是不现实的。

ganache-cli模拟了一个以太坊的测试节点并提供对外的rpc访问方式（就是例子里常常说的http://localhost:7545或者http://localhost:8545）。同时在其中内置了M个以太坊账号，用于测试。

MetaMask是一个以太坊的网络钱包插件，它也提供了web3的访问方式。并且能够经过这个插件指定后面的以太坊节点是什么。由于MetaMask是个钱包插件，因此解决了DApp中的支付问题。因此如今的DApp都依赖它。

有一个以太坊教程，是在线学习的，你们能够去看看，若是本身本机上搞，开发DApp的基本过程都是同样的以下：

一、安装NodeJS

二、安装truffle:一个开发DApp的开发框架

nmp install -g truffle

三、安装Ganache（原来用testrpc）:在内存中模拟以太坊运行并对外提供rpc服务。

npm install -g ganache-cli

四、运行ganache-cli

ganache-cli

五、生成一个DApp的项目

mkdir project1

truffle init

若是想用truffle中的某个例子，能够用

truffle unbox pet-shop

“pet-shop”是例子名称

六、编写智能合约

具体如何用solidity编写智能合约可参考各类文章，这里再也不重复。

编写好的智能合约的Project1.sol文件放到contracts目录下

七、编译和部署智能合约

在migrations目录下建立文件2_deploy_contracts.js：

var Project1 = artifacts.require("Project1");

module.exports = function(deployer) {
  deployer.deploy(Project1);
};

以后执行：

truffle compile

truffle migrate

若是你的智能合约没有问题的话，如今你的以太坊智能合约应该已经部署到你用来测试的ganache中去了。

这里可能遇到的问题是：默认的truffle生成的项目，测试用的ganache的地址和端口会被设置成http://localhost:7545，而实际上执行ganache-cli以后的服务端口是http://localhost:8545，须要在truffle.js中修改一下：

module.exports = {
// See <http://truffleframework.com/docs/advanced/configuration>
// for more about customizing your Truffle configuration!
networks: {
development: {
host: “127.0.0.1”,
port: 7545,   //改为8545
network_id: “*” // Match any network id
}
}
};

八、编写前端的js代码跟以太坊交互

一般须要以下的辅助js库:

<!– jQuery (necessary for Bootstrap’s JavaScript plugins) –>
<script src=”js/jquery.min.js”></script>
<!– Include all compiled plugins (below), or include individual files as needed –>
<script src=”js/bootstrap.min.js”></script>
<script src=”js/web3.min.js”></script>
<script src=”js/truffle-contract.js”></script>

在此基础上，编辑你本身业务逻辑的js，一般命名为app.js，app.js的框架以下：

App = {
web3Provider: null,
contracts: {},

init: function() {

//初始化你本身的页面、变量等

return App.initWeb3();
},

initWeb3: function() {
/*
* 初始化web3：
*/
if (typeof web3 !== ‘undefined’){

//若是你的浏览器安装了MetaMask的钱包插件，那么插件会赋值web3.currentProvider
App.web3Provider = web3.currentProvider;
}
else
{

//若是没装插件，那么建立一个基于Http的provider，这里用到的就是用ganache-cli启动所提供的rpc服务，由于ganache-cli启动的时候绑定的是localhost，因此测试所使用的浏览器也要在本机。（如何让ganache-cli绑定其余地址我还没找到）
App.web3Provider = new Web3.providers.HttpProvider(‘http://localhost:8545’);

}
web3 = new Web3(App.web3Provider);

return App.initContract();
},

initContract: function() {
/*
* 初始化智能合约，实际上就是为你的智能合约建立一个对应的js对象，方便后续调用
*/

//一般的作法是使用你的智能合约编译以后生成的abi的json文件，该文件在用truffle compile以后，生成在build/contracts/目录下，由于我用了一个Division.sol，因此用Division.json，你能够根据你的实际状况来写。
$.getJSON(‘Division.json‘, function(data) {
var DivisionArtifact = data;
App.contracts.Division = TruffleContract(DivisionArtifact);
App.contracts.Division.setProvider(App.web3Provider);
//用智能合约中的信息来更新你的web应用，App.refreshPlots()是我例子中获取智能合约中信息并更新UI的函数

return App.refreshPlots();
});

return App.bindEvents();
},

bindEvents: function() {

/*
* 事件绑定，这个能够根据你的UI来设置，例子中就是绑定一个button的点击操做
*/

$(document).on(‘click’, ‘.btn-adopt’, App.handlePlot);
},

refreshPlots: function(plots, account) {
/*
* 这个函数就是上面initContract中调用的用智能合约更新页面
*/

        //继续使用division这个智能合约作例子
         var divisionInstance;
         App.contracts.Division.deployed().then(function(instance){
                 divisionInstance = instance;
                 //getGenPlots是Division的这个智能合约的一个查询函数（不须要gas)，须要3个参数
                 return divisionInstance.getGenPlots(0,0,2);
         }).then(function(results){
                 //注意：这个地方有点意思，我原先理解也有问题，后来打印输出才搞明白
                 //智能合约返回的多个结果变量在这里就是一个results数组
                 //数组的每一个成员就是智能合约返回的每一个结果变量
                 //以getGenPlots为例,Division.json中定义以下：
                 /*"name": "getGenPlots",
                     "outputs": [
                     {
                         "name": "",
                         "type": "uint64[]"
                     },
                     {
                         "name": "",
                         "type": "address[]"
                     },
                     {
                         "name": "",
                         "type": "uint256[]"
                     },
                     {
                         "name": "",
                         "type": "uint8[]"
                     }
                     ],
                     "payable": false,
                     "stateMutability": "view",
                     "type": "function"
                  */
                  //那么：results[0]是uint64[]
                  //      results[1]是address[]...

                 console.log(results[0].length);
         }).catch(function(err){
                 console.log(err.message);
         });
 },
handlePlot: function(event) {

/*
 * 这个函数就是上面bindEvents中调用的响应函数,演示要花eth的函数调用
 */
    event.preventDefault();
    //从event中获取参数，这是jquery的东西，跟web3无关
    var plotId = parseInt($(event.target).data('id'));

    var divisionInstance;
     //获取以太坊账号信息
     web3.eth.getAccounts(function(error,accounts){
         if(error)
         {
             console.log(error);
         }
         //我随便取账号列表里的第3个账号。
         //由于咱们连的是ganache-cli的rpc模拟服务，
         //其中给咱们预制了几个有eth的账号
         //若是安装了MetaMask插件，应该得到的就是MetaMask里的账号
         var account = accounts[2];
         App.contracts.Division.deployed().then(function(instance){
             divisionInstance = instance;
             //调用智能合约的buyPlot函数，该函数须要2个参数，
             //后面的{}中的内容跟发起以太坊交易的时候所带的默认值。
             //from: 使用哪一个以太坊账号
             //value: 要使用的eth数量，以wei为单位（1eth=10^18wei)
             //gas: 矿工费，以wei为单位
             return divisionInstance.buyPlot(plotId, 3, {from: account, value: 100000000000000000, gas:6000000});
        }).then(function(result){
            //返回结果后从新更新UI
            return App.refreshPlots();
        }).catch(function(error){
            console.log(error.message);
        });
     });
 }

};

测试你的基于Web的DApp是否正常，可使用nodejs里面提供的lite-server模块来当简单的webserver来用。

安装lite-server，在你的truffle项目目录下，执行：

npm install lite-server

安装完以后会在项目目录下声称node_modules目录，lite-server以及依赖的模块都在该目录下了。

要运行lite-server，还须要编写项目目录下的package.json文件：

{
     "name": "项目名称",
     "version": "1.0.0",
     "description": "",
     "main": "truffle.js",
     "directories": {
         "test": "test"
     },
     "scripts": {
         "dev": "lite-server",
         "test": "echo \"Error: no test specified\" && exit 1"
     },
     "author": "",
     "license": "ISC",
     "devDependencies": {
         "lite-server": "^2.3.0"
     },
     "dependencies": {
         "liteserver": "^0.3.0"
     }
}

还须要编写bs-config.json来配置一下lite-server

{
 "server": {
 "baseDir": ["./src", "./build/contracts"]
 }
}

baseDir是用来设置lite-server所提供的web服务的文件路径的。这个设置代表你能够把你上面写的app.js，依赖的各类js放到./src目录下，而后写index.html，把app.js等集成进去，就大功告成了。

启动lite-server,执行：

npm run dev

不只启动了lite-server，并且会启动一个浏览器去打开页面。

本文的目的是为了澄清一下写DApp的各项工具之间的架构关系，帮助技术人员更快的理解和实现本身的项目。

具体的例子网上多如牛毛，就不去写业务的具体代码了。