Hyperledger Fabric如何通过虚拟机部署以太坊智能合约

EVM作为用户链代码安装到Fabric中,然后可以通过它部署智能合约。单个EVM链代码足以在通道上运行多个以太坊智能合约。链码不采用以太坊的共识方法。所有事务仍将遵循Fabric事务流中的执行,订单,验证步骤。确保在不同组织中的足够对等方安装链代码,并设置一个确保一定程度的分散的认可政策。为了与已部署的智能合约进行交互,有一个fab3,它从以太坊JSON RPC API实现一组有限的API,因此可以用作web3提供者

EVM作为用户链代码安装到Fabric中,然后可以通过它部署智能合约。 单个EVM链代码足以在通道上运行多个以太坊智能合约。 链码不采用以太坊的共识方法。 所有事务仍将遵循Fabric事务流中的执行,订单,验证步骤。 确保在不同组织中的足够对等方安装链代码,并设置一个确保一定程度的分散的认可政策。 为了与已部署的智能合约进行交互,有一个“fab3”,它从以太坊JSON RPC API实现一组有限的API,因此可以用作web3提供者。

安装 EVM 链代码

EVM链代码位于evmcc下的repo fabric-chaincode-evm。要安装链码,请按照常规步骤安装链码。以下说明基于fabric-samplesfirst-network教程的1.3版。

挂载EVM Chaincode

用volumes更新docker-compose-cli.yaml以包含fabric-chaincode-evm

1
2
3
cli:
volumes:
- ./../../fabric-chaincode-evm:/opt/gopath/src/github.com/hyperledger/fabric-chaincode-evm

通过运行启动网络:

1
./byfn up

构建并启动EVM

1
docker exec -it cli bash

如果成功,你应该看到以下提示:

1
root@0d78bb69300d:/opt/gopath/src/github.com/hyperledger/fabric/peer#

要更改目标对等方,请更改以下环境变量:

1
2
3
4
5
# Environment variables for PEER0
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
export CORE_PEER_ADDRESS=peer0.org1.example.com:7051
export CORE_PEER_LOCALMSPID="Org1MSP"
export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt

接下来在所有对等设备上安装EVM链代码:

1
peer chaincode install -n evmcc -l golang -v 0 -p github.com/hyperledger/fabric-chaincode-evm/evmcc

实例化evmcc并用频道名称替换<channel-name>

1
peer chaincode instantiate -n evmcc -v 0 -C <channel-name> -c '{"Args":[]}' -o orderer.example.com:7050 --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

与EVM Chaincode交互

有两种与EVM Chaincode交互的通用方法:通常的Fabric工具和Web3

使用Peer CLI

一般来说,evm需要两个参数,即to地址和在以太坊交易中必需的input

以下是与Simple Storage合约进行部署和交互的示例。

部署合约

要部署智能合约,to字段是零地址,input是合约编译后的evm字节码。

1
peer chaincode invoke -n evmcc -C <channel-name>  -c '{"Args":["0000000000000000000000000000000000000000","608060405234801561001057600080fd5b5060df8061001f6000396000f3006080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c146078575b600080fd5b348015605957600080fd5b5060766004803603810190808035906020019092919050505060a0565b005b348015608357600080fd5b50608a60aa565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058203dbaed52da8059a841ed6d7b484bf6fa6f61a7e975a803fdedf076a121a8c4010029"]}' -o orderer.example.com:7050 --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

该交易的有效负载将是你已部署合约的合约地址。要验证你的合约是否已成功部署,你可以在evmcc中查询合约的运行时字节码:

1
peer chaincode query -n evmcc -C <channel-name> -c '{"Args":["getCode","<contract addr>"]}'

该查询的有效负载应返回运行时字节码,该字节码应如下所示:

1
6080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c146078575b600080fd5b348015605957600080fd5b5060766004803603810190808035906020019092919050505060a0565b005b348015608357600080fd5b50608a60aa565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058203dbaed52da8059a841ed6d7b484bf6fa6f61a7e975a803fdedf076a121a8c4010029

与已部署的合约进行交互

要与已部署的智能合约进行交互,你需要使用上一节中收到的合约地址。

Simple Storage Contract有两个函数,set(x)get()。在这些交易中,to字段是合约地址和input字段是与任何必需参数连接的函数哈希。

我们先设置存储的值。set的函数哈希是60fe47b1,我们想要将值设置为10然后我们需要将哈希与000000000000000000000000000000000000000000000000000000000000000a连接起来。

1
peer chaincode invoke -n evmcc -C <channel-name> -c '{"Args":["<contract-address>","60fe47b1000000000000000000000000000000000000000000000000000000000000000a"]}' -o orderer.example.com:7050 --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

现在要验证函数是否被调用,我们可以通过运行具有函数hash6d4ce63cget来查询该值。

1
peer chaincode query -n evmcc -C <channel-name> -c '{"Args":["<contract-address>","6d4ce63c"]}' --hex

该查询的输出应该产生a的有效载荷。

获取用户帐户地址

由于Fabric不使用用户帐户,因此作为EVM CC的一部分,不存储用户帐户信息。但是我们确实有一种生成机制来自用户公钥的用户帐户地址。这在需要时用于EVMCC交易。我们还提供机制信息用户可以根据需要访问该地址。

1
peer chaincode query -n evmcc -C <channel-name> -c '{"Args":["account"]}'

有效负载将是您的用户地址。

使用Web3

Web3.js是一个库,可以改善部署和管理EVM智能合约的用户体验。它期望已经实现以太坊JSON RPC API的接口。Fab Proxy支持有限的API,允许使用web3。不应在cli docker容器中执行以下操作。它应该在你想要运行代理的地方之外完成。

设置Fab代理

Fabric代理使用Fabric Go SDK连接并与Fabric网络交互。首先,你需要一个SDK配置。此config将适用于第一个网络示例。配置假设fabric-samples repo 在你的$ GOPATH中,你的所有证书都在first-network例子的默认位置。

代理依赖于一组环境变量来工作。

1
2
3
4
5
6
7
# Environment Variables for Fab3:
export FAB3_CONFIG=${GOPATH}/src/github.com/hyperledger/fabric-chaincode-evm/examples/first-network-sdk-config.yaml # Path to a compatible Fabric SDK Go config file
export FAB3_USER=User1 # User identity being used for the proxy (Matches the users names in the crypto-config directory specified in the config)
export FAB3_ORG=Org1 # Organization of the specified user
export FAB3_CHANNEL=mychannel # Channel to be used for the transactions
export FAB3_CCID=evmcc # ID of the EVM Chaincode deployed in your fabric network. If not provided default is evmcc.
export FAB3_PORT=5000 # Port the proxy will listen on. If not provided default is 5000.

在运行代理之前设置所需的变量。

构建Fab代理

代理可以像其他go项目一样构建。确保你是这个repo的来源,repo在你的gopath。

1
go build -o fab3 ./fab3/cmd

你应该看到一个二进制fab3。如果已设置所需的环境变量,则可以运行代理。

1
./fab3

如果使用默认端口,你应该看到输出如在端口5000上启动Fab代理

连接到代理

以下说明需要安装nodeweb3。指令遵循web3 api版本0.20.2安装相同版本的web3运行:

1
npm install web3@0.20.2

安装正确版本的web3后,在节点会话中运行以下命令连接到代理:

1
2
3
> Web3 = require('web3')
...
> web3 = new Web3(new Web3.providers.HttpProvider('http://localhost:5000'))

如果成功,你应该能够获得你的帐户地址。由于SDK使用发现服务来查找网络上的所有对等方,因此使用代理运行的第一个查询或交易将比其他查询或交易花费更长的时间。

1
> web3.eth.accounts

你应该看到一个包含你帐户地址的元素数组。为了运行任何交易,web3需要设置web3.eth.defaultAccount

1
> web3.eth.defaultAccount = web3.eth.accounts[0]

部署智能合约

对于使用web3部署合约的以太坊风格,此过程应该很熟悉。对于此示例,我们将使用Simple Storage合约。

你需要编译的evm字节码和合约的ABI才能继续。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
> simpleStorageABI = [
{
"constant": false,
"inputs": [
{
"name": "x",
"type": "uint256"
}
],
"name": "set",
"outputs": [],
"payable": false,
"stateMutability": "nonpayable",
"type": "function"
},
{
"constant": true,
"inputs": [],
"name": "get",
"outputs": [
{
"name": "",
"type": "uint256"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
}
]

> simpleStorageBytecode = '608060405234801561001057600080fd5b5060df8061001f6000396000f3006080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c146078575b600080fd5b348015605957600080fd5b5060766004803603810190808035906020019092919050505060a0565b005b348015608357600080fd5b50608a60aa565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058203dbaed52da8059a841ed6d7b484bf6fa6f61a7e975a803fdedf076a121a8c4010029'

> SimpleStorage = web3.eth.contract(simpleStorageABI)

> deployedContract = SimpleStorage.new([], {data: simpleStorageBytecode})
> myContract = SimpleStorage.at(web3.eth.getTransactionReceipt(deployedContract.transactionHash).contractAddress)

与以前部署的合约交互

如果你已经部署了简单存储合约,则可以使用合约地址创建合约实例。以下假设你已使用SimpleStorageABI创建了简单存储对象类型。

1
> myContract = SimpleStorage.at(<contract-address>)

现在,我们可以通过将值设置为10来与合约进行交互。

1
> myContract.set(10)

要验证交易是否有效,你可以通过运行get()来查询值集。

1
> myContract.get().toNumber()

结果将返回10

======================================================================

分享一些以太坊、EOS、比特币等区块链相关的交互式在线编程实战教程:

  • EOS教程,本课程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用各知识点完成一个便签DApp的开发。
  • java以太坊开发教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
  • python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
  • php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和交易等内容。
  • 以太坊入门教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发进阶教程,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
  • C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和交易等。
  • java比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Java代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Java工程师不可多得的比特币开发学习课程。
  • php比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Php代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Php工程师不可多得的比特币开发学习课程。
  • tendermint区块链开发详解,本课程适合希望使用tendermint进行区块链开发的工程师,课程内容即包括tendermint应用开发模型中的核心概念,例如ABCI接口、默克尔树、多版本状态库等,也包括代币发行等丰富的实操代码,是go语言工程师快速入门区块链开发的最佳选择。

汇智网原创翻译,转载请标明出处。这里是原文Hyperledger Fabric如何通过虚拟机部署以太坊智能合约