02区块链宠物商店

基础环境

VMWare10,Ubuntu16.04,Nodejs v9.11.1,Truffle v4.1.5,Ganache 1.1.0

项目开发流程

image

一,创建项目

1,创建项目工程根目录。

mkdir -p /home/simon/project/petShop
cd petShop

2,使用truffle unbox创建项目。

$ truffle unbox pet-shop
 Downloading...
 Unpacking...
 Setting up...
 Unbox successful. Sweet!

Commands:

  Compile:        truffle compile
  Migrate:        truffle migrate
  Test contracts: truffle test
  Run dev server: npm run dev

也可以使用truffle init来创建一个全新的项目。

3,项目目录结构如下:

image

二,编写智能合约

1,在合同目录下,添加合约文件Adoption.sol

pragma solidity ^0.4.17;

contract Adoption {

  address[16] public adopters;  // 保存领养者的地址

    // 领养宠物
  function adopt(uint petId) public returns (uint) {
    require(petId >= 0 && petId <= 15);  // 确保id在数组长度内

    adopters[petId] = msg.sender;        // 保存调用这地址 
    return petId;
  }

  // 返回领养者
  function getAdopters() public view returns (address[16]) {
    return adopters;
  }

}

三,编译智能合约

$ truffle compile
Compiling ./contracts/Adoption.sol...
Compiling ./contracts/Migrations.sol...
#中间的警告信息可忽略
Writing artifacts to ./build/contracts

四,开启伽纳彻

在部署合约之前,我们使用Ganache来开启一个私链来进行开发测试,默认端口:7545(区别:TestRPC的默认监听端口:8545)
.Ganache的前身就是TestRPC,提供了两个版本:一个CLI版本,一个图形界面版本,可指需要安装.CLI
版本安装:

sudo npm install -g ganache-cli

本文以图形界面为例,将ganache-1.1.0-x86_64.AppImage下载至本地后,上传至/home/simon/project(可以是任意目录),无需安装,直接运行即可。

cd /home/simon/project
chmod 755 ./ganache-1.1.0-x86_64.AppImage
./ganache-1.1.0-x86_64.AppImage #运行

图形界面版本下载地址:https
://github.com/trufflesuite/ganache/releases Windows:Ganache- .appx
Mac:Ganache-
.dmg
Linux:Ganache - * .AppImage
根据你的系统找到对应的文件下载即可。
注意:这里需要在Ubuntu的系统中执行,而不是XSHELL连接客户端,否则弹不出图形界面。

Ganache启动之后界面如下,自动生成10个账号(默认交易对象为第1个账号):

image
image
image
image
image

补充:
Ganache把所有东西都存在内存里,因此,节点一旦重启,将丢失以前的状态。
如果想要远程访问Ganache,可以将127.0.0.1设置成对外的IP地址即可。

五,部署合约

现在我们来创建一个新的部署脚本./migrations/2_deploy_contracts.js,粘贴如下代码:

var Adoption = artifacts.require("Adoption.sol");

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

接下来执行部署命令:

truffle  migrate

执行后,输出如下:

image

在打开的甘纳许界面里可以看到区块链状态的变化,现在产生了4个区块如下图:

image

这时说明智能合约已经部署好了。

六,编写测试用例

现在我们来测试一下智能合约,测试用例可以用JavaScript或Solidity来编写,这里使用Solidity。
在test目录下新建一个TestAdoption.sol,编写测试合约:

pragma solidity ^0.4.17;

import "truffle/Assert.sol";   // 引入的断言
import "truffle/DeployedAddresses.sol";  // 用来获取被测试合约的地址
import "../contracts/Adoption.sol";      // 被测试合约

contract TestAdoption {
  Adoption adoption = Adoption(DeployedAddresses.Adoption());

  // 领养测试用例
  function testUserCanAdoptPet() public {
    uint returnedId = adoption.adopt(8);

    uint expected = 8;
    Assert.equal(returnedId, expected, "Adoption of pet ID 8 should be recorded.");
  }

  // 宠物所有者测试用例
  function testGetAdopterAddressByPetId() public {
    // 期望领养者的地址就是本合约地址,因为交易是由测试合约发起交易,
    address expected = this;
    address adopter = adoption.adopters(8);
    Assert.equal(adopter, expected, "Owner of pet ID 8 should be recorded.");
  }

    // 测试所有领养者
  function testGetAdopterAddressByPetIdInArray() public {
  // 领养者的地址就是本合约地址
    address expected = this;
    address[16] memory adopters = adoption.getAdopters();
    Assert.equal(adopters[8], expected, "Owner of pet ID 8 should be recorded.");
  }
}

Assert.sol和DeployedAddresses.sol是由Truffle框架提供,在测试目录下并不提供
truffle 目录.TestAdoption.sol合约中添加采用的测试用例

七,运行测试用例

在终端中执行:

$ truffle test
Using network 'development'.

Compiling ./contracts/Adoption.sol...
Compiling ./test/TestAdoption.sol...
Compiling truffle/Assert.sol...
Compiling truffle/DeployedAddresses.sol...
#中间警告信息可忽略
TestAdoption
    ✓ testUserCanAdoptPet (415ms)
    ✓ testGetAdopterAddressByPetId (293ms)
    ✓ testGetAdopterAddressByPetIdInArray (862ms)

  3 passing (4s)

八,创建用户接口和智能合约交互

我们已经编写和部署及测试好了合约,接下我们为合约编写UI,让合约真正可以用起来。
在Truffle Box pet-shop里,已经包含了应用的前端代码,代码在工程根目录下的src/文件夹下。
在编辑器中打开src/js/app.js
可以看到
用来管理整个应用的App对象,初始函数加载宠物信息,就初始化web3。web3是一个实现了与以太坊节点通信的库,我们利用web3来和合约进行交互。

1,初始化WEB3
接下来,我们来编辑app.js修改initWeb3方法:
删除注释,修改为:

initWeb3: function() {
  // Is there an injected web3 instance?
  if (typeof web3 !== 'undefined') {
    App.web3Provider = web3.currentProvider;
  } else {
    // If no injected web3 instance is detected, fall back to Ganache
    App.web3Provider = new Web3.providers.HttpProvider('http://localhost:7545');
  }
  web3 = new Web3(App.web3Provider);
  return App.initContract();
}

2,化实例合约
使用松露合同会帮我们保存合约部署的信息,就不需要我们手动修改合约地址,修改initContract方法代码如下:

initContract: function() {
  // 加载Adoption.json,保存了Adoption的ABI(接口说明)信息及部署后的网络(地址)信息,它在编译合约的时候生成ABI,在部署的时候追加网络信息
  $.getJSON('Adoption.json', function(data) {
    // 用Adoption.json数据创建一个可交互的TruffleContract合约实例。
    var AdoptionArtifact = data;
    App.contracts.Adoption = TruffleContract(AdoptionArtifact);

    // Set the provider for our contract
    App.contracts.Adoption.setProvider(App.web3Provider);

    // Use our contract to retrieve and mark the adopted pets
    return App.markAdopted();
  });
  return App.bindEvents();
}

3,领养处理
修改markAdopted方法代码:

markAdopted: function(adopters, account) {
  var adoptionInstance;

  App.contracts.Adoption.deployed().then(function(instance) {
    adoptionInstance = instance;

    // 调用合约的getAdopters(), 用call读取信息不用消耗gas
    return adoptionInstance.getAdopters.call();
  }).then(function(adopters) {
    for (i = 0; i < adopters.length; i++) {
      if (adopters[i] !== '0x0000000000000000000000000000000000000000') {
        $('.panel-pet').eq(i).find('button').text('Success').attr('disabled', true);
      }
    }
  }).catch(function(err) {
    console.log(err.message);
  });
}

修改handleAdopt方法代码:

handleAdopt: function(event) {
  event.preventDefault();

  var petId = parseInt($(event.target).data('id'));

  var adoptionInstance;

  // 获取用户账号
  web3.eth.getAccounts(function(error, accounts) {
    if (error) {
      console.log(error);
    }

    var account = accounts[0];

    App.contracts.Adoption.deployed().then(function(instance) {
      adoptionInstance = instance;

      // 发送交易领养宠物
      return adoptionInstance.adopt(petId, {from: account});
    }).then(function(result) {
      return App.markAdopted();
    }).catch(function(err) {
      console.log(err.message);
    });
  });
}

九,在浏览器中运行

1,安装MetaMask
MetaMask是一款插件形式的以太坊轻客户端,开发过程中使用MetaMask和我们的Dapp进行交互是个很好的选择。
如果未安装,请移步到:以太坊钱包MetaMask使用教程
2 ,钱包配置
在接受隐私说明后,会出现页面如下:

image

这里我们通过还原一个Ganache为我们创建好的钱包,作为我们的开发测试钱包。点击页面的导入现有的DEN,在钱包种子框中输入Ganache显示的助记词。

ritual action squeeze egg cake escape lemon same bulk switch soft mammal

然后输入自己想要的密码,点击OK如下图所示:

image

3,连接开发区块链网络
默认连接的是以太坊主网(左上角显示),选择自定义RPC,添加一个网络:http//127.0.0.1:7545 ,点返回后,显示如下:

image
image

这时左上角显示为Private Network,账号是Ganache中默认的第一个
账号。至此MetaMask的安装,配置已经完成。

4,安装和配置lite-server
接下来需要本地的web服务器提供服务的访问,Truffle Box宠物店里提供了一个lite-server可以直接使用,我们来查看看一下它是如何工作的。
工程根目录下的BS-config.json指示了精简版服务器的工作目录。

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

说明:
./ src是网站文件目录
./build/contracts是合约输出目录

与此同时,在的package.json文件的脚本中添加了dev的命令:

"scripts": {
  "dev": "lite-server",
  "test": "echo \"Error: no test specified\" && exit 1"
},

以上两段代码无需做任何修改,当运行npm run dev的时候,就能启动lite-server了
.5,启动服务

npm run dev

会自动打开浏览器显示我们的DAPP,如本文的第一张图。
现在领养一只宠物看看,当我们点击采用按钮时,MetaMask会提示我们交易的确认,如图:

image

点击提交确认后,就可以看到成功领养了这次宠物。

在MetaMask中,也可以看到交易的清单:

image

好了,恭喜你,即将成为一名去中心化式应用开发者的你已经成为迈出了坚实的一步。

作者:海阳之新
链接:https://www.jianshu.com/p/3dd8f936b7b0
来源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。
](//upload-images.jianshu.io/upload_images/2476164-6278a5c9efb52800.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1000/format/webp)

基础环境

VMWare10,Ubuntu16.04,Nodejs v9.11.1,Truffle v4.1.5,Ganache 1.1.0

项目开发流程

image

一,创建项目

1,创建项目工程根目录。

mkdir -p /home/simon/project/petShop
cd petShop

2,使用truffle unbox创建项目。

$ truffle unbox pet-shop
 Downloading...
 Unpacking...
 Setting up...
 Unbox successful. Sweet!

Commands:

  Compile:        truffle compile
  Migrate:        truffle migrate
  Test contracts: truffle test
  Run dev server: npm run dev

也可以使用truffle init来创建一个全新的项目。

3,项目目录结构如下:

image

二,编写智能合约

1,在合同目录下,添加合约文件Adoption.sol

pragma solidity ^0.4.17;

contract Adoption {

  address[16] public adopters;  // 保存领养者的地址

    // 领养宠物
  function adopt(uint petId) public returns (uint) {
    require(petId >= 0 && petId <= 15);  // 确保id在数组长度内

    adopters[petId] = msg.sender;        // 保存调用这地址 
    return petId;
  }

  // 返回领养者
  function getAdopters() public view returns (address[16]) {
    return adopters;
  }

}

三,编译智能合约

$ truffle compile
Compiling ./contracts/Adoption.sol...
Compiling ./contracts/Migrations.sol...
#中间的警告信息可忽略
Writing artifacts to ./build/contracts

四,开启伽纳彻

在部署合约之前,我们使用Ganache来开启一个私链来进行开发测试,默认端口:7545(区别:TestRPC的默认监听端口:8545)
.Ganache的前身就是TestRPC,提供了两个版本:一个CLI版本,一个图形界面版本,可指需要安装.CLI
版本安装:

sudo npm install -g ganache-cli

本文以图形界面为例,将ganache-1.1.0-x86_64.AppImage下载至本地后,上传至/home/simon/project(可以是任意目录),无需安装,直接运行即可。

cd /home/simon/project
chmod 755 ./ganache-1.1.0-x86_64.AppImage
./ganache-1.1.0-x86_64.AppImage #运行

图形界面版本下载地址:https
://github.com/trufflesuite/ganache/releases Windows:Ganache- .appx
Mac:Ganache-
.dmg
Linux:Ganache - * .AppImage
根据你的系统找到对应的文件下载即可。
注意:这里需要在Ubuntu的系统中执行,而不是XSHELL连接客户端,否则弹不出图形界面。

Ganache启动之后界面如下,自动生成10个账号(默认交易对象为第1个账号):

image
image
image
image
image

补充:
Ganache把所有东西都存在内存里,因此,节点一旦重启,将丢失以前的状态。
如果想要远程访问Ganache,可以将127.0.0.1设置成对外的IP地址即可。

五,部署合约

现在我们来创建一个新的部署脚本./migrations/2_deploy_contracts.js,粘贴如下代码:

var Adoption = artifacts.require("Adoption.sol");

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

接下来执行部署命令:

truffle  migrate

执行后,输出如下:

image

在打开的甘纳许界面里可以看到区块链状态的变化,现在产生了4个区块如下图:

image

这时说明智能合约已经部署好了。

六,编写测试用例

现在我们来测试一下智能合约,测试用例可以用JavaScript或Solidity来编写,这里使用Solidity。
在test目录下新建一个TestAdoption.sol,编写测试合约:

pragma solidity ^0.4.17;

import "truffle/Assert.sol";   // 引入的断言
import "truffle/DeployedAddresses.sol";  // 用来获取被测试合约的地址
import "../contracts/Adoption.sol";      // 被测试合约

contract TestAdoption {
  Adoption adoption = Adoption(DeployedAddresses.Adoption());

  // 领养测试用例
  function testUserCanAdoptPet() public {
    uint returnedId = adoption.adopt(8);

    uint expected = 8;
    Assert.equal(returnedId, expected, "Adoption of pet ID 8 should be recorded.");
  }

  // 宠物所有者测试用例
  function testGetAdopterAddressByPetId() public {
    // 期望领养者的地址就是本合约地址,因为交易是由测试合约发起交易,
    address expected = this;
    address adopter = adoption.adopters(8);
    Assert.equal(adopter, expected, "Owner of pet ID 8 should be recorded.");
  }

    // 测试所有领养者
  function testGetAdopterAddressByPetIdInArray() public {
  // 领养者的地址就是本合约地址
    address expected = this;
    address[16] memory adopters = adoption.getAdopters();
    Assert.equal(adopters[8], expected, "Owner of pet ID 8 should be recorded.");
  }
}

Assert.sol和DeployedAddresses.sol是由Truffle框架提供,在测试目录下并不提供
truffle 目录.TestAdoption.sol合约中添加采用的测试用例

七,运行测试用例

在终端中执行:

$ truffle test
Using network 'development'.

Compiling ./contracts/Adoption.sol...
Compiling ./test/TestAdoption.sol...
Compiling truffle/Assert.sol...
Compiling truffle/DeployedAddresses.sol...
#中间警告信息可忽略
TestAdoption
    ✓ testUserCanAdoptPet (415ms)
    ✓ testGetAdopterAddressByPetId (293ms)
    ✓ testGetAdopterAddressByPetIdInArray (862ms)

  3 passing (4s)

八,创建用户接口和智能合约交互

我们已经编写和部署及测试好了合约,接下我们为合约编写UI,让合约真正可以用起来。
在Truffle Box pet-shop里,已经包含了应用的前端代码,代码在工程根目录下的src/文件夹下。
在编辑器中打开src/js/app.js
可以看到
用来管理整个应用的App对象,初始函数加载宠物信息,就初始化web3。web3是一个实现了与以太坊节点通信的库,我们利用web3来和合约进行交互。

1,初始化WEB3
接下来,我们来编辑app.js修改initWeb3方法:
删除注释,修改为:

initWeb3: function() {
  // Is there an injected web3 instance?
  if (typeof web3 !== 'undefined') {
    App.web3Provider = web3.currentProvider;
  } else {
    // If no injected web3 instance is detected, fall back to Ganache
    App.web3Provider = new Web3.providers.HttpProvider('http://localhost:7545');
  }
  web3 = new Web3(App.web3Provider);
  return App.initContract();
}

2,化实例合约
使用松露合同会帮我们保存合约部署的信息,就不需要我们手动修改合约地址,修改initContract方法代码如下:

initContract: function() {
  // 加载Adoption.json,保存了Adoption的ABI(接口说明)信息及部署后的网络(地址)信息,它在编译合约的时候生成ABI,在部署的时候追加网络信息
  $.getJSON('Adoption.json', function(data) {
    // 用Adoption.json数据创建一个可交互的TruffleContract合约实例。
    var AdoptionArtifact = data;
    App.contracts.Adoption = TruffleContract(AdoptionArtifact);

    // Set the provider for our contract
    App.contracts.Adoption.setProvider(App.web3Provider);

    // Use our contract to retrieve and mark the adopted pets
    return App.markAdopted();
  });
  return App.bindEvents();
}

3,领养处理
修改markAdopted方法代码:

markAdopted: function(adopters, account) {
  var adoptionInstance;

  App.contracts.Adoption.deployed().then(function(instance) {
    adoptionInstance = instance;

    // 调用合约的getAdopters(), 用call读取信息不用消耗gas
    return adoptionInstance.getAdopters.call();
  }).then(function(adopters) {
    for (i = 0; i < adopters.length; i++) {
      if (adopters[i] !== '0x0000000000000000000000000000000000000000') {
        $('.panel-pet').eq(i).find('button').text('Success').attr('disabled', true);
      }
    }
  }).catch(function(err) {
    console.log(err.message);
  });
}

修改handleAdopt方法代码:

handleAdopt: function(event) {
  event.preventDefault();

  var petId = parseInt($(event.target).data('id'));

  var adoptionInstance;

  // 获取用户账号
  web3.eth.getAccounts(function(error, accounts) {
    if (error) {
      console.log(error);
    }

    var account = accounts[0];

    App.contracts.Adoption.deployed().then(function(instance) {
      adoptionInstance = instance;

      // 发送交易领养宠物
      return adoptionInstance.adopt(petId, {from: account});
    }).then(function(result) {
      return App.markAdopted();
    }).catch(function(err) {
      console.log(err.message);
    });
  });
}

九,在浏览器中运行

1,安装MetaMask
MetaMask是一款插件形式的以太坊轻客户端,开发过程中使用MetaMask和我们的Dapp进行交互是个很好的选择。
如果未安装,请移步到:以太坊钱包MetaMask使用教程
2 ,钱包配置
在接受隐私说明后,会出现页面如下:

image

这里我们通过还原一个Ganache为我们创建好的钱包,作为我们的开发测试钱包。点击页面的导入现有的DEN,在钱包种子框中输入Ganache显示的助记词。

ritual action squeeze egg cake escape lemon same bulk switch soft mammal

然后输入自己想要的密码,点击OK如下图所示:

image

3,连接开发区块链网络
默认连接的是以太坊主网(左上角显示),选择自定义RPC,添加一个网络:http//127.0.0.1:7545 ,点返回后,显示如下:

image
image

这时左上角显示为Private Network,账号是Ganache中默认的第一个
账号。至此MetaMask的安装,配置已经完成。

4,安装和配置lite-server
接下来需要本地的web服务器提供服务的访问,Truffle Box宠物店里提供了一个lite-server可以直接使用,我们来查看看一下它是如何工作的。
工程根目录下的BS-config.json指示了精简版服务器的工作目录。

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

说明:
./ src是网站文件目录
./build/contracts是合约输出目录

与此同时,在的package.json文件的脚本中添加了dev的命令:

"scripts": {
  "dev": "lite-server",
  "test": "echo \"Error: no test specified\" && exit 1"
},

以上两段代码无需做任何修改,当运行npm run dev的时候,就能启动lite-server了
.5,启动服务

npm run dev

会自动打开浏览器显示我们的DAPP,如本文的第一张图。
现在领养一只宠物看看,当我们点击采用按钮时,MetaMask会提示我们交易的确认,如图:

image

点击提交确认后,就可以看到成功领养了这次宠物。

在MetaMask中,也可以看到交易的清单:

image

好了,恭喜你,即将成为一名去中心化式应用开发者的你已经成为迈出了坚实的一步。

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

网络安全-李彦亮(本人)

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值