1.安装Truffle:npm install -g truffle
2.建立项目目录并进入:mkdir pet-shop-tutorial
cd pet-shop-tutorial
3.使用truffle unbox创建项目,这种方式的前端直接就是写好的:truffle unbox pet-shop
4.在contracts目录下,添加合约文件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; } }
5.编译合约:truffle compile
6.创建一个自己的部署脚本2_deploy_contracts.js
var Adoption = artifacts.require("Adoption"); module.exports = function(deployer) { deployer.deploy(Adoption); };
7.执行部署之前,确保有一个区块链运行,使用Ganache开启一个私链进行开发测试,默认会在7545端口上。安装Ganache:执行wget https://github.com/trufflesuite/ganache/release/download/v1.0.1/ganache-1.0.1-x86_64.AppImage,再修改权限:chmod +x ganache-1.0.1-x86_64.AppImage,双击图标就可以运行Ganache。
8.部署合约:truffle mimgrate
9.测试,在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."); } }
10.运行测试用例:truffle test
11.Truffle Box的pet-shop中,已经包含了应用的前端代码,都在src/文件夹中,更改app.js来实现应用的功能。初始化web3,修改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(); }
12.实例化合约,修改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(); }
13.处理领养,修改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); }); }
14.修改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); }); }); }
15.安装MetaMask,点击链接https://metamask.io/,将插件安装到浏览器中,点击浏览器右上角的图标,首先我们选择一个测试网络(如粉红色的),进入界面,选择Accept,在登录页面中点击“Import Existing DEN”,还原Ganache创建的钱包,作为开发测试钱包,在输入框中填写candy maple cake sugar pudding cream honey rich smooth crumble sweet treat这几个词,输入自己的密码。
16.登录之后,点击Custom RPC,添加一个网络:http://127.0.0.1:7545,切换之后返回,看到第一个账户的状态
17.运行npm run dev启动服务
自己在完成这个项目中遇到的问题
问题一:执行truffle compile虚拟机卡顿,一直执行不下去
解决方法:将虚拟机的内存改大一点,可以改为3G
问题二:执行了npm run dev,但是不能直接启动到Firefox浏览器
解决办法:直接打开浏览器,在地址栏中输入localhost:3000
问题三:进入到项目后,网页上显示不出pet的信息
解决办法:显示不出信息是因为jQuery的加载问题,直接百度一个jQuery.1.11.1.min.js,替换新的链接
问题四:当点击完Adopt,并且submit之后,相应的按钮应该显示为success,通过打印输出发现是adopters数组有问题,地址全都为0x
解决办法:再执行一次truffle migrate
根据https://learnblockchain.cn/2018/01/12/first-dapp/#more博主的分享总结的。