Ethereum-Score-Hella

环境准备

版本版本

npm

6.9.0

node

v10.16.0

geth

1.8.10-stable

ganache

Ganache CLI v6.6.0 (ganache-core: 2.7.0)

truffle

Truffle v5.0.32 (core: 5.0.32)

Solidity v0.5.0 (solc-js)

Node v10.16.0

Web3.js v1.2.1

快速使用

这是不要安装geth的快速方法

truffle安装

至少安装以下环境

npm truffle

git clone https://github.com/Blockchain-book/Ethereum-Score-Hella.git
npm install
truffle develop //开启环境
truffle compile //编译
truffle migrate --network truffle  //部署
npm run dev

环境安装

Golang

mac os

官网

cenos

yum install golang

Geth

用于建立私有链，在真实环境中使用，在开发环境中可以选用ganache或者truffle提供的虚拟环境。

使用说明

Ganache

即testRpc，提供的虚拟以太坊环境，用于开发测试。

由于geth挖矿耗费cpu使用ganache会比较简单。

npm install -g ganache-cli

运行
ganache-cli

连接到运行的Ganache

由于ganache-cli是不带可交互的输入的，并且无法输入日志，这里与geth相同可以用geth attach连入。

geth attach http://localhost:8545

Truffle

是一个以太坊开发框架，提供合约编译,合约部署，虚拟环境等功能。

本文是基于truffle开展的。

truffle自带了编译器（solc-js），使用truffle compile命令,使用truffle version命令查看。

Truffle安装

npm install -g truffle

项目开始

//自动下载并构建项目
truffle unbox webpack

项目结构

├── app/
│   ├── bank.html
│   ├── customer.html
│   ├── index.html
│   ├── javascripts/
│   │   ├── app.js
│   │   ├── bank.js
│   │   ├── customer.js
│   │   ├── merchant.js
│   │   └── utils.js
│   ├── merchant.html
│   └── stylesheets/
│       └── app.css
├── contracts/
│   ├── Migrations.sol
│   └── Score.sol
├── migrations/
│   ├── 1_initial_migration.js
│   └── 2_deploy_contracts.js
├── package-lock.json
├── package.json
├── test/
│   ├── TestMetacoin.sol
│   └── metacoin.js
├── truffle.js
└── webpack.config.js

合约代码迁移

Solidity代码更新

原先的solidity代码无法在当前编译器下进行编译，需要进行修改。

Remix在线环境

在线调试环境可以进行compile deploy invoke等操作，能够提高效率。

remix

将合约代码加入到项目中

合约文件（*.sol）需要放置在contracts文件夹中。

并修改2_deploy_contracts.js,该文件用于部署合约，注意1_initial_migration.js文件与Migration.sol对应不需要修改。

var Score = artifacts.require("./Score.sol");
module.exports = function(deployer) {
  deployer.deploy(Score);
};

**注意：**不能删除Migration.sol，该文件在部署合约时需要使用。

合约编译

truffle compile

truffle compile 会编译相关合约
truffle compile --compile-all //重新编译所有

合约部署

Geth（建立私有链,然后部署）

如果使用Ganache-cli 或者 truffle develop，可以跳过该部分。

Geth能够建立私有链网络。但是需要开启挖矿，消耗CPU。一旦关闭挖矿，则无法进行合约部署和带有交易的合约操作。

部署时遇到的问题

truffle migrate //部署
truffle migrate --reset //全部重新部署

问题1 Error:authentication needed: password or unlock

对账户进行解锁

personal.unlockAccount("0x318a1986cffc2ea7b39eb1375f41bead79ce58f3")
输入密码

问题2 Error:excceds block gas limit

这是gasLimit设置太小

修改genesis文件，并重新运行一个节点

{
    "config": {
        "chainId": 15,
        "homesteadBlock": 0,
        "eip155Block": 0,
        "eip158Block": 0
    },
    "difficulty": "1",
    "gasLimit": "200000000000",
    "alloc": {
    }
}

问题3 Error: insufficient funds for gas * price + value

这可能是由于未开启挖矿

Ganache-cli 和 truffle develop

直接运行 ganache-cli 或者

truffle develop

truffle develop，在虚拟区块链网络的同时提供了命令行交互。

部署

truffle migrate //部署
truffle migrate --reset //全部重新部署

Solidity合约调用

Truffle console-命令行交互

开启truffle console会连接truffle.js设置的网络。

在写入时需要保证账户解锁且开启挖矿。

调用合约（truffle console）

truffle(development)> Greeter.deployed().then(function(e){e.greet().then(function(r){console.log(r)})})
truffle(development)> 0101
truffle(development)> Greeter.deployed().then(function(e){e.setGreeting("hello!").then(function(r){console.log(r)})})
truffle(development)> { ... 交易信息... }
truffle(development)> Greeter.deployed().then(function(e){e.greet().then(function(r){console.log(r)})})
truffle(development)> hello!

Web3.js 调用

使Node JS对外提供服务，并调用

简单封装一下调用合约的函数

var Web3 = require("web3");
//创建web3对象
var web3 = new Web3();
// 连接到以太坊节点
web3.setProvider(new Web3.providers.HttpProvider("http://localhost:8545"));
console.log("....");
var version = web3.version.node;
console.log(version);
//当前的合约调用账号
web3.eth.defaultAccount = web3.eth.coinbase;
var account_one = web3.eth.accounts[0];
var abi =  [...从合约编译出的json文件中copy];
//合约地址
var address = "0x92a207c402d52e65a62facebf31dd82ab34ff1ac";
var greeter = web3.eth.contract(abi).at(address);
module.exports={
  get:function(){
    console.log("Greeter:get() ...");
    return greeter.greet.call();
  },
  set:function(info){
    console.log("Greeter:set(info) ...");
    greeter.setGreeting(info)
  }
}

简单的测试接口

var http = require('http');
var url = require('url');
var util = require('util');

var greeter = require('./GreeterRpc.js');

http.createServer(function(req, res){
    console.log(greeter.set(Math.random().toString(36).substr(2)));
    console.log(greeter.get());
}).listen(3000);

Dapp应用构建

truffle.js配置

配置网络

// Allows us to use ES6 in our migrations and tests.
require('babel-register')

module.exports = {
  networks: {
    truffle: {
      host: '127.0.0.1',
      port: 9545,
      network_id: '*' // Match any network id
    },
    develop: {
      host: '127.0.0.1',
      port: 8545,
      network_id: '*' // Match any network id
    }
  }
}

选择网络

truffle migrate --network develop --reset

webpack.config.js配置

html资源配置

不进行配置，则无法进行访问。

 plugins: [
    // Copy our app's index.html to the build folder.
    new CopyWebpackPlugin([
      { from: './app/index.html', to: 'index.html' }
    ]),
    new CopyWebpackPlugin([
      { from: './app/customer.html', to: 'customer.html' }
    ]),
    new CopyWebpackPlugin([
      { from: './app/bank.html', to: 'bank.html' }
    ]),
    new CopyWebpackPlugin([
      { from: './app/merchant.html', to: 'merchant.html' }
    ])
  ]

web3Js

提供调用合约的方法。

获取合约实例

在获取实例时，需要

获取编译后的artifacts，里面有abi（对合约函数进行了描述）

// Import our contract artifacts and turn them into usable abstractions.
import ScoreArtifacts from '../../build/contracts/Score'

  // 获得合约实例
  init: function () {
    // 设置web3连接
    ScoreContract.setProvider(window.web3.currentProvider)
    // Get the initial account balance so it can be displayed.
    window.web3.eth.getAccounts(function (err, accs) {
      if (err != null) {
        window.alert('There was an error fetching your accounts.')
        return
      }
      if (accs.length === 0) {
        window.alert('Couldn\'t get any accounts! Make sure your Ethereum client is configured correctly.')
        return
      }
      accounts = accs
      account = accounts[0]
    })
     //在这里获取实例
    ScoreContract.deployed().then(function (instance) {
      ScoreInstance = instance
    }).catch(function (e) {
      console.log(e, null)
    })
  }

web3Js下的合约调用

通过ScoreInstance这个合约实例进行调用。

 ScoreInstance.getCustomerPassword(address, { from: account, gas: 3000000 }).then(function (result) {
      if (result[0]) {
        // 查询密码成功
        if (password.localeCompare(utils.hexCharCodeToStr(result[1])) === 0) {
          console.log('登录成功')
          // 跳转到用户界面
          window.location.href = 'customer.html?account=' + address
        } else {
          console.log('密码错误，登录失败')
          window.alert('密码错误，登录失败')
        }
      } else {
        // 查询密码失败
        console.log('该用户不存在，请确定账号后再登录！')
        window.alert('该用户不存在，请确定账号后再登录！')
      }
    })
  },

注意点

需要传入gas，否者会出现out of gas

{ from: account, gas: 3000000 } // from是指合约调用者。

event监听

 ScoreInstance.BuyGood(function (error, event) {
        if (!error) {
          console.log(event.args.message)  // event是指事件emit出来的内容
          window.App.setStatus(event.args.message)
        }
      })

可能的问题

设置跨域(使用Geth)

geth网络，由于不同域，无法访问。

解决办法

--rpc --rpccorsdomain "*"

geth --datadir ~/Geth/data/tmp1 --rpcapi personal,db,eth,net,web3 --rpc --rpccorsdomain "*" console 2>> ~/Geth/data/tmp1/tmp1.log  //能够被web3访问到

在ganache-cli和truffle develop 中 Out of gas

调用时传入gas

 ScoreInstance.newCustomer(address, password, { from: account, gas: 3000000 }).then(function () {
      ScoreInstance.NewCustomer(function (e, r) {
        if (!e) {
          console.log(r)
          console.log(r.args)
          if (r.args.isSuccess === true) {
            this.setStatus('注册成功')
            console.log('注册成功')
          } else {
            this.setStatus('账户已经注册')
            console.log('账户已经注册')
          }
        } else {
          console.log(e)
        }
      })
    })
  },

Utils中的函数在geth环境中与remix中运行情况不同，在geth存在问题（未解决）

在ganache-cli和truffle develop中都可以正常调用

//这行代码在geth环境下有问题

customer[_customerAddr].password = stringToBytes32(_password);

function newCustomer(address _customerAddr, string _password) public {
        //判断是否已经注册
        if (!isCustomerAlreadyRegister(_customerAddr)) {
            //还未注册
            customer[_customerAddr].customerAddr = _customerAddr;
            //这行代码在geth环境下有问题
            customer[_customerAddr].password = stringToBytes32(_password);
            customers.push(_customerAddr);
            emit NewCustomer(msg.sender, true, _password);
            return;
        }
        else {
            emit NewCustomer(msg.sender, false, _password);
            return;
        }
}

配置和选择网络

// Allows us to use ES6 in our migrations and tests.
require('babel-register')

module.exports = {
  networks: {
    truffle: {
      host: '127.0.0.1',
      port: 9545,
      network_id: '*' // Match any network id
    },
    develop: {
      host: '127.0.0.1',
      port: 8545,
      network_id: '*' // Match any network id
    }
  }
}

网络选择

truffle migrate --network develop --reset

无法跳转页面 cannot GET/customer.html

由于是使用webpack

在webpack.config.js中配置,并重新运行 npm run dev

 plugins: [
    // Copy our app's index.html to the build folder.
    new CopyWebpackPlugin([
      { from: './app/index.html', to: 'index.html' }
    ]),
    new CopyWebpackPlugin([
      { from: './app/customer.html', to: 'customer.html' }
    ])
  ],

html如何使用js文件

引入<script src="./app.js"></script>，这个入口文件即可。不需要使用绝对的路径，对于前端不熟，有待了解。

常用命令

truffle compile --compile-all //重新编译所有
truffle migrate --reset //重新部署所有
truffle migrate --network develop --reset //选择truffle.js中的网络配置
npm run dev //运行前端页面

Name		Name	Last commit message	Last commit date
Latest commit History 22 Commits
app		app
contracts		contracts
doc		doc
migrations		migrations
test		test
.babelrc		.babelrc
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.gitignore		.gitignore
CHANGELOG-1.1.md		CHANGELOG-1.1.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
truffle.js		truffle.js
webpack.config.js		webpack.config.js

License

Blockchain-book/Ethereum-Score-Hella

Folders and files

Latest commit

History

Repository files navigation