1. Upload
POST api/v1/chaincodeschaincodeRepo
The front end will allow uploading a chaincode package, which is a .tar.gz format file.
Install a chaincode: peer lifecycle install
Body Parameters | Type | Note | name | string
|---|---|---|
| the name of chaincodechaincode_package | string | The base64-encoded contexts of the chaincode package |
| chaincode_label | string | The label that will be used to identify the installed chaincode package |
| version | string | The version of the uploaded chaincode |
| language | string | The programming language | description | string (optional) | version | string |
...
, including the json metadata file: { | ||
| description | string (optional) |
2. Perform chaincode operations → Install
POST api/v1/chaincode/installation
Body Parameters | Type | Note |
|---|---|---|
| peer_uuid | string | Peer UUID |
| chaincode_package_uuid | string | chaincode package file id in the backend uploaded data store. |
3. Perform chaincode operations →
...
Approve (may by several orgs), Commit
POST api/v1/chaincodeschaincodeDefinitions/<chaincode_name>/?operaionsoperations=<install/approve<approve/commit>
Query Parameters | Type | Note |
|---|---|---|
| operations | string | HLF lifecycle command that deploys, approves, and commits a chaincode with several organizations |
Body Parameters | Type | Note |
|---|---|---|
| name | ||
| channel_id | string(optional) | The channel on which this command should be executed. |
| version | string (optional) | the version of the chaincode definition to be approved |
| signature_policy | string (optional) | Use a policy inside the channel configuration as the chaincode endorsement policy. |
| peers | string array (optional) | The array of the id uuid of the peer nodes. For commit only |
...
| init_required | bool flag | a boolean flag to request the execution of the Init function to initialize the chaincode. |
4. List chaincodes
...
(Yuanmao Zhu will revise)
GET Get api/v1/chaincodes
Get a list of uploaded chaincodes
Response Body | Type | Note | |
|---|---|---|---|
| path | string | from metadata.json | |
| typename | string | The name of the chaincode. | from metadata.json |
| chaincode_label | string | The label that will be used to identify the installed chaincode package | |
| version | string | the version of the chaincode definition to be approved | |
| .from metadata.json | |||
| package_id | string | the package id of installed package. Calculated by label:SHA256(package | |
| language | string | the programming language of chaincode | |
| ), e.g., "testcc_1.0:1f060a1d05b057d98ed98ca8fd57e3a6542d8dfe383aeff64e289718ab851e2b" | |||
| description | string | a description of chaincode |
...
5. Get a chaincode
...
's information (Yuanmao Zhu will revise)
GET Get api/v1/chaincodes/<chaincode_name>
Get a chaincodes the full information of the chaincode
Response Body | Type | Note |
|---|---|---|
| name | string | The name of the chaincode. |
| chaincode_label | string | The label that will be used to identify the installed chaincode package |
| version | string | the version of the chaincode definition to be approved |
| package_id | string | the package id of installed package |
| packageapprove_idstatus | string | the approval status |
| organizations | string array | A list of orgs that installed installed the chaincode. |
| channels | string array | The committed channel names for the chaincode |
6.
...
Query an organization's approved chaincode definition on a channel
GET api/v1/approvedChaincodeDefinitions/<channel_name>/<org_name>
Response Body | Type | Note |
|---|---|---|
| org_name | string | The name of the orgs |
| chaincode_names | string arrary | The name of the approved chaincode by the org |
Note: for FE to get the org approval status for a given chaincode, may have performance issues with lots of orgs.