221 lines
12 KiB
Markdown
221 lines
12 KiB
Markdown
## Example Usage
|
|
|
|
### peer chaincode instantiate examples
|
|
|
|
Here are some examples of the `peer chaincode instantiate` command, which
|
|
instantiates the chaincode named `mycc` at version `1.0` on channel
|
|
`mychannel`:
|
|
|
|
* Using the `--tls` and `--cafile` global flags to instantiate the chaincode
|
|
in a network with TLS enabled:
|
|
|
|
```
|
|
export ORDERER_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem
|
|
peer chaincode instantiate -o orderer.example.com:7050 --tls --cafile $ORDERER_CA -C mychannel -n mycc -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"
|
|
|
|
2018-02-22 16:33:53.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc
|
|
2018-02-22 16:33:53.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc
|
|
2018-02-22 16:34:08.698 UTC [main] main -> INFO 003 Exiting.....
|
|
|
|
```
|
|
|
|
* Using only the command-specific options to instantiate the chaincode in a
|
|
network with TLS disabled:
|
|
|
|
```
|
|
peer chaincode instantiate -o orderer.example.com:7050 -C mychannel -n mycc -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"
|
|
|
|
|
|
2018-02-22 16:34:09.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc
|
|
2018-02-22 16:34:09.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc
|
|
2018-02-22 16:34:24.698 UTC [main] main -> INFO 003 Exiting.....
|
|
```
|
|
|
|
### peer chaincode invoke example
|
|
|
|
Here is an example of the `peer chaincode invoke` command:
|
|
|
|
* Invoke the chaincode named `mycc` at version `1.0` on channel `mychannel`
|
|
on `peer0.org1.example.com:7051` and `peer0.org2.example.com:9051` (the
|
|
peers defined by `--peerAddresses`), requesting to move 10 units from
|
|
variable `a` to variable `b`:
|
|
|
|
```
|
|
peer chaincode invoke -o orderer.example.com:7050 -C mychannel -n mycc --peerAddresses peer0.org1.example.com:7051 --peerAddresses peer0.org2.example.com:9051 -c '{"Args":["invoke","a","b","10"]}'
|
|
|
|
2018-02-22 16:34:27.069 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc
|
|
2018-02-22 16:34:27.069 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 16:34:27.106 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> DEBU 00a ESCC invoke result: version:1 response:<status:200 message:"OK" > payload:"\n \237mM\376? [\214\002 \332\204\035\275q\227\2132A\n\204&\2106\037W|\346#\3413\274\022Y\nE\022\024\n\004lscc\022\014\n\n\n\004mycc\022\002\010\003\022-\n\004mycc\022%\n\007\n\001a\022\002\010\003\n\007\n\001b\022\002\010\003\032\007\n\001a\032\00290\032\010\n\001b\032\003210\032\003\010\310\001\"\013\022\004mycc\032\0031.0" endorsement:<endorser:"\n\007Org1MSP\022\262\006-----BEGIN CERTIFICATE-----\nMIICLjCCAdWgAwIBAgIRAJYomxY2cqHA/fbRnH5a/bwwCgYIKoZIzj0EAwIwczEL\nMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBG\ncmFuY2lzY28xGTAXBgNVBAoTEG9yZzEuZXhhbXBsZS5jb20xHDAaBgNVBAMTE2Nh\nLm9yZzEuZXhhbXBsZS5jb20wHhcNMTgwMjIyMTYyODE0WhcNMjgwMjIwMTYyODE0\nWjBwMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMN\nU2FuIEZyYW5jaXNjbzETMBEGA1UECxMKRmFicmljUGVlcjEfMB0GA1UEAxMWcGVl\ncjAub3JnMS5leGFtcGxlLmNvbTBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABDEa\nWNNniN3qOCQL89BGWfY39f5V3o1pi//7JFDHATJXtLgJhkK5KosDdHuKLYbCqvge\n46u3AC16MZyJRvKBiw6jTTBLMA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAA\nMCsGA1UdIwQkMCKAIN7dJR9dimkFtkus0R5pAOlRz5SA3FB5t8Eaxl9A7lkgMAoG\nCCqGSM49BAMCA0cAMEQCIC2DAsO9QZzQmKi8OOKwcCh9Gd01YmWIN3oVmaCRr8C7\nAiAlQffq2JFlbh6OWURGOko6RckizG8oVOldZG/Xj3C8lA==\n-----END CERTIFICATE-----\n" signature:"0D\002 \022_\342\350\344\231G&\237\n\244\375\302J\220l\302\345\210\335D\250y\253P\0214:\221e\332@\002 \000\254\361\224\247\210\214L\277\370\222\213\217\301\r\341v\227\265\277\336\256^\217\336\005y*\321\023\025\367" >
|
|
2018-02-22 16:34:27.107 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 00b Chaincode invoke successful. result: status:200
|
|
2018-02-22 16:34:27.107 UTC [main] main -> INFO 00c Exiting.....
|
|
|
|
```
|
|
|
|
Here you can see that the invoke was submitted successfully based on the log
|
|
message:
|
|
|
|
```
|
|
2018-02-22 16:34:27.107 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 00b Chaincode invoke successful. result: status:200
|
|
|
|
```
|
|
|
|
A successful response indicates that the transaction was submitted for ordering
|
|
successfully. The transaction will then be added to a block and, finally, validated
|
|
or invalidated by each peer on the channel.
|
|
|
|
Here is an example of how to format the `peer chaincode invoke` command when the chaincode package includes multiple smart contracts.
|
|
|
|
* If you are using the [contract-api](https://www.npmjs.com/package/fabric-contract-api), the name you pass to `super("MyContract")` can be used as a prefix.
|
|
|
|
```
|
|
peer chaincode invoke -C $CHANNEL_NAME -n $CHAINCODE_NAME -c '{ "Args": ["MyContract:methodName", "{}"] }'
|
|
|
|
peer chaincode invoke -C $CHANNEL_NAME -n $CHAINCODE_NAME -c '{ "Args": ["MyOtherContract:methodName", "{}"] }'
|
|
|
|
```
|
|
|
|
|
|
### peer chaincode list example
|
|
|
|
Here are some examples of the `peer chaincode list ` command:
|
|
|
|
* Using the `--installed` flag to list the chaincodes installed on a peer.
|
|
|
|
```
|
|
peer chaincode list --installed
|
|
|
|
Get installed chaincodes on peer:
|
|
Name: mycc, Version: 1.0, Path: github.com/hyperledger/fabric-samples/chaincode/abstore/go, Id: 8cc2730fdafd0b28ef734eac12b29df5fc98ad98bdb1b7e0ef96265c3d893d61
|
|
2018-02-22 17:07:13.476 UTC [main] main -> INFO 001 Exiting.....
|
|
```
|
|
|
|
You can see that the peer has installed a chaincode called `mycc` which is at
|
|
version `1.0`.
|
|
|
|
* Using the `--instantiated` in combination with the `-C` (channel ID) flag to
|
|
list the chaincodes instantiated on a channel.
|
|
|
|
```
|
|
peer chaincode list --instantiated -C mychannel
|
|
|
|
Get instantiated chaincodes on channel mychannel:
|
|
Name: mycc, Version: 1.0, Path: github.com/hyperledger/fabric-samples/chaincode/abstore/go, Escc: escc, Vscc: vscc
|
|
2018-02-22 17:07:42.969 UTC [main] main -> INFO 001 Exiting.....
|
|
|
|
```
|
|
|
|
You can see that chaincode `mycc` at version `1.0` is instantiated on
|
|
channel `mychannel`.
|
|
|
|
### peer chaincode package example
|
|
|
|
Here is an example of the `peer chaincode package` command, which
|
|
packages the chaincode named `mycc` at version `1.1`, creates the chaincode
|
|
deployment spec, signs the package using the local MSP, and outputs it as
|
|
`ccpack.out`:
|
|
|
|
```
|
|
peer chaincode package ccpack.out -n mycc -p github.com/hyperledger/fabric-samples/chaincode/abstore/go -v 1.1 -s -S
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 17:27:01.404 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc
|
|
2018-02-22 17:27:01.405 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 17:27:01.879 UTC [chaincodeCmd] chaincodePackage -> DEBU 011 Packaged chaincode into deployment spec of size <3426>, with args = [ccpack.out]
|
|
2018-02-22 17:27:01.879 UTC [main] main -> INFO 012 Exiting.....
|
|
|
|
```
|
|
|
|
### peer chaincode query example
|
|
|
|
Here is an example of the `peer chaincode query` command, which queries the
|
|
peer ledger for the chaincode named `mycc` at version `1.0` for the value of
|
|
variable `a`:
|
|
|
|
* You can see from the output that variable `a` had a value of 90 at the time of
|
|
the query.
|
|
|
|
```
|
|
peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
|
|
|
|
2018-02-22 16:34:30.816 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc
|
|
2018-02-22 16:34:30.816 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc
|
|
Query Result: 90
|
|
|
|
```
|
|
|
|
### peer chaincode signpackage example
|
|
|
|
Here is an example of the `peer chaincode signpackage` command, which accepts an
|
|
existing signed package and creates a new one with signature of the local MSP
|
|
appended to it.
|
|
|
|
```
|
|
peer chaincode signpackage ccwith1sig.pak ccwith2sig.pak
|
|
Wrote signed package to ccwith2sig.pak successfully
|
|
2018-02-24 19:32:47.189 EST [main] main -> INFO 002 Exiting.....
|
|
```
|
|
|
|
### peer chaincode upgrade example
|
|
|
|
Here is an example of the `peer chaincode upgrade` command, which
|
|
upgrades the chaincode named `mycc` at version `1.1` on channel
|
|
`mychannel` to version `1.2`, which contains a new variable `c`:
|
|
|
|
* Using the `--tls` and `--cafile` global flags to upgrade the chaincode
|
|
in a network with TLS enabled:
|
|
|
|
```
|
|
export ORDERER_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem
|
|
peer chaincode upgrade -o orderer.example.com:7050 --tls --cafile $ORDERER_CA -C mychannel -n mycc -v 1.2 -c '{"Args":["init","a","100","b","200","c","300"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 18:26:31.433 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc
|
|
2018-02-22 18:26:31.434 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc
|
|
2018-02-22 18:26:31.435 UTC [chaincodeCmd] getChaincodeSpec -> DEBU 005 java chaincode enabled
|
|
2018-02-22 18:26:31.435 UTC [chaincodeCmd] upgrade -> DEBU 006 Get upgrade proposal for chaincode <name:"mycc" version:"1.1" >
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 18:26:46.687 UTC [chaincodeCmd] upgrade -> DEBU 009 endorse upgrade proposal, get response <status:200 message:"OK" payload:"\n\004mycc\022\0031.1\032\004escc\"\004vscc*,\022\014\022\n\010\001\022\002\010\000\022\002\010\001\032\r\022\013\n\007Org1MSP\020\003\032\r\022\013\n\007Org2MSP\020\0032f\n \261g(^v\021\220\240\332\251\014\204V\210P\310o\231\271\036\301\022\032\205fC[|=\215\372\223\022 \311b\025?\323N\343\325\032\005\365\236\001XKj\004E\351\007\247\265fu\305j\367\331\275\253\307R\032 \014H#\014\272!#\345\306s\323\371\350\364\006.\000\356\230\353\270\263\215\217\303\256\220i^\277\305\214: \375\200zY\275\203}\375\244\205\035\340\226]l!uE\334\273\214\214\020\303\3474\360\014\234-\006\315B\031\022\010\022\006\010\001\022\002\010\000\032\r\022\013\n\007Org1MSP\020\001" >
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 18:26:46.693 UTC [chaincodeCmd] upgrade -> DEBU 00c Get Signed envelope
|
|
2018-02-22 18:26:46.693 UTC [chaincodeCmd] chaincodeUpgrade -> DEBU 00d Send signed envelope to orderer
|
|
2018-02-22 18:26:46.908 UTC [main] main -> INFO 00e Exiting.....
|
|
```
|
|
|
|
* Using only the command-specific options to upgrade the chaincode in a
|
|
network with TLS disabled:
|
|
|
|
```
|
|
peer chaincode upgrade -o orderer.example.com:7050 -C mychannel -n mycc -v 1.2 -c '{"Args":["init","a","100","b","200","c","300"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 18:28:31.433 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc
|
|
2018-02-22 18:28:31.434 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc
|
|
2018-02-22 18:28:31.435 UTC [chaincodeCmd] getChaincodeSpec -> DEBU 005 java chaincode enabled
|
|
2018-02-22 18:28:31.435 UTC [chaincodeCmd] upgrade -> DEBU 006 Get upgrade proposal for chaincode <name:"mycc" version:"1.1" >
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 18:28:46.687 UTC [chaincodeCmd] upgrade -> DEBU 009 endorse upgrade proposal, get response <status:200 message:"OK" payload:"\n\004mycc\022\0031.1\032\004escc\"\004vscc*,\022\014\022\n\010\001\022\002\010\000\022\002\010\001\032\r\022\013\n\007Org1MSP\020\003\032\r\022\013\n\007Org2MSP\020\0032f\n \261g(^v\021\220\240\332\251\014\204V\210P\310o\231\271\036\301\022\032\205fC[|=\215\372\223\022 \311b\025?\323N\343\325\032\005\365\236\001XKj\004E\351\007\247\265fu\305j\367\331\275\253\307R\032 \014H#\014\272!#\345\306s\323\371\350\364\006.\000\356\230\353\270\263\215\217\303\256\220i^\277\305\214: \375\200zY\275\203}\375\244\205\035\340\226]l!uE\334\273\214\214\020\303\3474\360\014\234-\006\315B\031\022\010\022\006\010\001\022\002\010\000\032\r\022\013\n\007Org1MSP\020\001" >
|
|
.
|
|
.
|
|
.
|
|
2018-02-22 18:28:46.693 UTC [chaincodeCmd] upgrade -> DEBU 00c Get Signed envelope
|
|
2018-02-22 18:28:46.693 UTC [chaincodeCmd] chaincodeUpgrade -> DEBU 00d Send signed envelope to orderer
|
|
2018-02-22 18:28:46.908 UTC [main] main -> INFO 00e Exiting.....
|
|
```
|
|
|
|
<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.
|