3.3 KiB
UTXO Chaincode
The UTXO example chaincode contains a single invocation function named execute. This function accepts BASE64 encoded transactions from the Bitcoin network. This chaincode will parse the transactions and pass the transaction components to the Bitcoin libconsensus C library for script verification.
The purpose of this chaincode is to
-
Demonstrate how the world state can be used to store and process unspent transaction outputs (UTXO).
-
Demonstrate how to include and use a C library from within a chaincode.
A client for exercising this chaincode is avilable at https://github.com/srderson/hyperledger-fabric-utxo-client-java.
The following are instructions for building and deploying the UTXO chaincode in Hypereledger Fabric. All commands should be run with vagrant.
First, build the Docker image for the UTXO chaincode.
cd $GOPATH/src/github.com/hyperledger/fabric/examples/chaincode/go/utxo/
docker build -t utxo:0.1.0 .
Next, modify the core.yaml file in the Hyperledger Fabric project to point to the local Docker image that was built in the previous step. In the core.yaml file find chaincode.golang.Dockerfile and change it from from hyperledger/fabric-baseimage to utxo:0.1.0
Start the peer using the following commands
peer node start
In a second window, deploy the example UTXO chaincode
CORE_PEER_ADDRESS=localhost:7051 peer chaincode deploy -p github.com/hyperledger/fabric/examples/chaincode/go/utxo -c '{"Function":"init", "Args": []}'
Wait about 30 seconds for the chaincode to be deployed. Output from the window where the peer is running will indicate that this is successful.
Next, find the image ID for the deployed chaincode. Run
docker images
and look for the image ID of the most recently deployed chaincode. The image ID will likely be similar to
dev-jdoe-cbe6be7ed67931b9be2ce31dd833e523702378bef91b29917005f0eaa316b57e268e19696093d48b91076f1134cbf4b06afd78e6afd947133f43cb51bf40b0a4
Make a note of this as we'll be using it later.
Stop the running peer.
Build a peer docker image by running the following test. This will allow for easy testing of the chaincode by giving us the ability to reset the database to a clean state.
go test github.com/hyperledger/fabric/core/container -run=BuildImage_Peer
Using the Docker image that we just built, start a peer within a container in chaincodedev mode.
docker run -it -p 7051:7051 -p 7053:7053 hyperledger/fabric-peer peer node start --peer-chaincodedev
In another window, start UTXO chaincode in a container. The refers to the UTXO image ID noted in a prior step.
docker run -it <image ID> /bin/bash
Build the UTXO chaincode.
cd $GOPATH/src/github.com/hyperledger/fabric/examples/chaincode/go/utxo/
go build
CORE_PEER_ADDRESS=172.17.0.2:7051 CORE_CHAINCODE_ID_NAME=utxo ./utxo
In another window, deploy the chaincode
peer chaincode deploy -n utxo -c '{"Function":"init", "Args": []}'
The chaincode is now deployed and ready to accept transactions.
This work is licensed under a Creative Commons Attribution 4.0 International License.
s