github.com/osdi23p228/fabric@v0.0.0-20221218062954-77808885f5db/docs/wrappers/peer_chaincode_postscript.md (about) 1 ## Example Usage 2 3 ### peer chaincode instantiate examples 4 5 Here are some examples of the `peer chaincode instantiate` command, which 6 instantiates the chaincode named `mycc` at version `1.0` on channel 7 `mychannel`: 8 9 * Using the `--tls` and `--cafile` global flags to instantiate the chaincode 10 in a network with TLS enabled: 11 12 ``` 13 export ORDERER_CA=/opt/gopath/src/github.com/osdi23p228/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem 14 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')" 15 16 2018-02-22 16:33:53.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc 17 2018-02-22 16:33:53.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc 18 2018-02-22 16:34:08.698 UTC [main] main -> INFO 003 Exiting..... 19 20 ``` 21 22 * Using only the command-specific options to instantiate the chaincode in a 23 network with TLS disabled: 24 25 ``` 26 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')" 27 28 29 2018-02-22 16:34:09.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc 30 2018-02-22 16:34:09.324 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc 31 2018-02-22 16:34:24.698 UTC [main] main -> INFO 003 Exiting..... 32 ``` 33 34 ### peer chaincode invoke example 35 36 Here is an example of the `peer chaincode invoke` command: 37 38 * Invoke the chaincode named `mycc` at version `1.0` on channel `mychannel` 39 on `peer0.org1.example.com:7051` and `peer0.org2.example.com:9051` (the 40 peers defined by `--peerAddresses`), requesting to move 10 units from 41 variable `a` to variable `b`: 42 43 ``` 44 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"]}' 45 46 2018-02-22 16:34:27.069 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc 47 2018-02-22 16:34:27.069 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc 48 . 49 . 50 . 51 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" > 52 2018-02-22 16:34:27.107 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 00b Chaincode invoke successful. result: status:200 53 2018-02-22 16:34:27.107 UTC [main] main -> INFO 00c Exiting..... 54 55 ``` 56 57 Here you can see that the invoke was submitted successfully based on the log 58 message: 59 60 ``` 61 2018-02-22 16:34:27.107 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 00b Chaincode invoke successful. result: status:200 62 63 ``` 64 65 A successful response indicates that the transaction was submitted for ordering 66 successfully. The transaction will then be added to a block and, finally, validated 67 or invalidated by each peer on the channel. 68 69 Here is an example of how to format the `peer chaincode invoke` command when the chaincode package includes multiple smart contracts. 70 71 * 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. 72 73 ``` 74 peer chaincode invoke -C $CHANNEL_NAME -n $CHAINCODE_NAME -c '{ "Args": ["MyContract:methodName", "{}"] }' 75 76 peer chaincode invoke -C $CHANNEL_NAME -n $CHAINCODE_NAME -c '{ "Args": ["MyOtherContract:methodName", "{}"] }' 77 78 ``` 79 80 81 ### peer chaincode list example 82 83 Here are some examples of the `peer chaincode list ` command: 84 85 * Using the `--installed` flag to list the chaincodes installed on a peer. 86 87 ``` 88 peer chaincode list --installed 89 90 Get installed chaincodes on peer: 91 Name: mycc, Version: 1.0, Path: github.com/hyperledger/fabric-samples/chaincode/abstore/go, Id: 8cc2730fdafd0b28ef734eac12b29df5fc98ad98bdb1b7e0ef96265c3d893d61 92 2018-02-22 17:07:13.476 UTC [main] main -> INFO 001 Exiting..... 93 ``` 94 95 You can see that the peer has installed a chaincode called `mycc` which is at 96 version `1.0`. 97 98 * Using the `--instantiated` in combination with the `-C` (channel ID) flag to 99 list the chaincodes instantiated on a channel. 100 101 ``` 102 peer chaincode list --instantiated -C mychannel 103 104 Get instantiated chaincodes on channel mychannel: 105 Name: mycc, Version: 1.0, Path: github.com/hyperledger/fabric-samples/chaincode/abstore/go, Escc: escc, Vscc: vscc 106 2018-02-22 17:07:42.969 UTC [main] main -> INFO 001 Exiting..... 107 108 ``` 109 110 You can see that chaincode `mycc` at version `1.0` is instantiated on 111 channel `mychannel`. 112 113 ### peer chaincode package example 114 115 Here is an example of the `peer chaincode package` command, which 116 packages the chaincode named `mycc` at version `1.1`, creates the chaincode 117 deployment spec, signs the package using the local MSP, and outputs it as 118 `ccpack.out`: 119 120 ``` 121 peer chaincode package ccpack.out -n mycc -p github.com/hyperledger/fabric-samples/chaincode/abstore/go -v 1.1 -s -S 122 . 123 . 124 . 125 2018-02-22 17:27:01.404 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc 126 2018-02-22 17:27:01.405 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc 127 . 128 . 129 . 130 2018-02-22 17:27:01.879 UTC [chaincodeCmd] chaincodePackage -> DEBU 011 Packaged chaincode into deployment spec of size <3426>, with args = [ccpack.out] 131 2018-02-22 17:27:01.879 UTC [main] main -> INFO 012 Exiting..... 132 133 ``` 134 135 ### peer chaincode query example 136 137 Here is an example of the `peer chaincode query` command, which queries the 138 peer ledger for the chaincode named `mycc` at version `1.0` for the value of 139 variable `a`: 140 141 * You can see from the output that variable `a` had a value of 90 at the time of 142 the query. 143 144 ``` 145 peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}' 146 147 2018-02-22 16:34:30.816 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc 148 2018-02-22 16:34:30.816 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc 149 Query Result: 90 150 151 ``` 152 153 ### peer chaincode signpackage example 154 155 Here is an example of the `peer chaincode signpackage` command, which accepts an 156 existing signed package and creates a new one with signature of the local MSP 157 appended to it. 158 159 ``` 160 peer chaincode signpackage ccwith1sig.pak ccwith2sig.pak 161 Wrote signed package to ccwith2sig.pak successfully 162 2018-02-24 19:32:47.189 EST [main] main -> INFO 002 Exiting..... 163 ``` 164 165 ### peer chaincode upgrade example 166 167 Here is an example of the `peer chaincode upgrade` command, which 168 upgrades the chaincode named `mycc` at version `1.1` on channel 169 `mychannel` to version `1.2`, which contains a new variable `c`: 170 171 * Using the `--tls` and `--cafile` global flags to upgrade the chaincode 172 in a network with TLS enabled: 173 174 ``` 175 export ORDERER_CA=/opt/gopath/src/github.com/osdi23p228/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem 176 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')" 177 . 178 . 179 . 180 2018-02-22 18:26:31.433 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc 181 2018-02-22 18:26:31.434 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc 182 2018-02-22 18:26:31.435 UTC [chaincodeCmd] getChaincodeSpec -> DEBU 005 java chaincode enabled 183 2018-02-22 18:26:31.435 UTC [chaincodeCmd] upgrade -> DEBU 006 Get upgrade proposal for chaincode <name:"mycc" version:"1.1" > 184 . 185 . 186 . 187 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" > 188 . 189 . 190 . 191 2018-02-22 18:26:46.693 UTC [chaincodeCmd] upgrade -> DEBU 00c Get Signed envelope 192 2018-02-22 18:26:46.693 UTC [chaincodeCmd] chaincodeUpgrade -> DEBU 00d Send signed envelope to orderer 193 2018-02-22 18:26:46.908 UTC [main] main -> INFO 00e Exiting..... 194 ``` 195 196 * Using only the command-specific options to upgrade the chaincode in a 197 network with TLS disabled: 198 199 ``` 200 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')" 201 . 202 . 203 . 204 2018-02-22 18:28:31.433 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc 205 2018-02-22 18:28:31.434 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc 206 2018-02-22 18:28:31.435 UTC [chaincodeCmd] getChaincodeSpec -> DEBU 005 java chaincode enabled 207 2018-02-22 18:28:31.435 UTC [chaincodeCmd] upgrade -> DEBU 006 Get upgrade proposal for chaincode <name:"mycc" version:"1.1" > 208 . 209 . 210 . 211 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" > 212 . 213 . 214 . 215 2018-02-22 18:28:46.693 UTC [chaincodeCmd] upgrade -> DEBU 00c Get Signed envelope 216 2018-02-22 18:28:46.693 UTC [chaincodeCmd] chaincodeUpgrade -> DEBU 00d Send signed envelope to orderer 217 2018-02-22 18:28:46.908 UTC [main] main -> INFO 00e Exiting..... 218 ``` 219 220 <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>.