REST API for Oracle Blockchain Platform on Oracle Cloud Infrastructure (Hyperledger Fabric v2.5)

Commit a Chaincode Definition in a Channel

post

/console/admin/api/v2/channels/{channelName}/chaincodeDefinitions/commit

Commit a chaincode definition in a channel. The new chaincode lifecycle in Hyperledger Fabric 2.x involves approving and committing the chaincode during the deployment. The chaincode definition needs to be approved by a sufficient number of organizations to satisfy the channel's LifecycleEndorsement policy before the chaincode can be committed on the channel.

Request

Supported Media Types

application/json

Path Parameters

channelName(required): string

ID of the channel

Details about the chaincode definition to be committed

Root Schema : CommitCCReq

Type: object

Show Source

chaincodeInitRequired(required): boolean
chaincodeName(required): string
chaincodeVersion(required): string
dataCollectionConfig: array dataCollectionConfig
endorsementPolicy: object endorsementPolicy

{
    "type":"object",
    "required":[
        "chaincodeName",
        "chaincodeVersion",
        "chaincodeInitRequired"
    ],
    "properties":{
        "chaincodeName":{
            "type":"string"
        },
        "chaincodeVersion":{
            "type":"string"
        },
        "chaincodeInitRequired":{
            "type":"boolean"
        },
        "endorsementPolicy":{
            "type":"object",
            "required":[
                "type",
                "policy"
            ],
            "properties":{
                "type":{
                    "type":"string",
                    "enum":[
                        "signature-policy",
                        "channel-config-policy"
                    ]
                },
                "policy":{
                    "type":"string"
                }
            }
        },
        "dataCollectionConfig":{
            "type":"array",
            "items":{
                "type":"object",
                "required":[
                    "name",
                    "policy",
                    "requiredPeerCount",
                    "maxPeerCount",
                    "blockToLive"
                ],
                "properties":{
                    "name":{
                        "type":"string"
                    },
                    "policy":{
                        "type":"string"
                    },
                    "requiredPeerCount":{
                        "type":"number"
                    },
                    "maxPeerCount":{
                        "type":"number"
                    },
                    "blockToLive":{
                        "type":"number"
                    },
                    "memberOnlyRead":{
                        "type":"boolean"
                    },
                    "memberOnlyWrite":{
                        "type":"boolean"
                    },
                    "endorsementPolicy":{
                        "type":"object",
                        "properties":{
                            "signaturePolicy":{
                                "type":"string"
                            },
                            "channelConfigPolicy":{
                                "type":"string"
                            }
                        }
                    }
                }
            }
        }
    },
    "example":{
        "chaincodeName":"myCC1",
        "chaincodeVersion":"v1",
        "chaincodeInitRequired":false,
        "endorsementPolicy":{
            "type":"signature-policy",
            "policy":"OR('org1.member')"
        },
        "dataCollectionConfig":[
            {
                "name":"test",
                "policy":"OR('org1.member')",
                "requiredPeerCount":"1",
                "maxPeerCount":"2",
                "blockToLive":"10",
                "memberOnlyRead":true,
                "memberOnlyWrite":true,
                "endorsementPolicy":{
                    "signaturePolicy":"OutOf(1,'org1.member')"
                }
            }
        ]
    }
}

Example:

{
    "chaincodeName":"myCC1",
    "chaincodeVersion":"v1",
    "chaincodeInitRequired":false,
    "endorsementPolicy":{
        "type":"signature-policy",
        "policy":"OR('org1.member')"
    },
    "dataCollectionConfig":[
        {
            "name":"test",
            "policy":"OR('org1.member')",
            "requiredPeerCount":"1",
            "maxPeerCount":"2",
            "blockToLive":"10",
            "memberOnlyRead":true,
            "memberOnlyWrite":true,
            "endorsementPolicy":{
                "signaturePolicy":"OutOf(1,'org1.member')"
            }
        }
    ]
}

Nested Schema : dataCollectionConfig

Type: array

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "required":[
            "name",
            "policy",
            "requiredPeerCount",
            "maxPeerCount",
            "blockToLive"
        ],
        "properties":{
            "name":{
                "type":"string"
            },
            "policy":{
                "type":"string"
            },
            "requiredPeerCount":{
                "type":"number"
            },
            "maxPeerCount":{
                "type":"number"
            },
            "blockToLive":{
                "type":"number"
            },
            "memberOnlyRead":{
                "type":"boolean"
            },
            "memberOnlyWrite":{
                "type":"boolean"
            },
            "endorsementPolicy":{
                "type":"object",
                "properties":{
                    "signaturePolicy":{
                        "type":"string"
                    },
                    "channelConfigPolicy":{
                        "type":"string"
                    }
                }
            }
        }
    }
}

Nested Schema : endorsementPolicy

Type: object

Show Source

policy(required): string
type(required): string

Allowed Values: [ "signature-policy", "channel-config-policy" ]

{
    "type":"object",
    "required":[
        "type",
        "policy"
    ],
    "properties":{
        "type":{
            "type":"string",
            "enum":[
                "signature-policy",
                "channel-config-policy"
            ]
        },
        "policy":{
            "type":"string"
        }
    }
}

Nested Schema : items

Type: object

Show Source

blockToLive(required): number
endorsementPolicy: object endorsementPolicy
maxPeerCount(required): number
memberOnlyRead: boolean
memberOnlyWrite: boolean
name(required): string
policy(required): string
requiredPeerCount(required): number

{
    "type":"object",
    "required":[
        "name",
        "policy",
        "requiredPeerCount",
        "maxPeerCount",
        "blockToLive"
    ],
    "properties":{
        "name":{
            "type":"string"
        },
        "policy":{
            "type":"string"
        },
        "requiredPeerCount":{
            "type":"number"
        },
        "maxPeerCount":{
            "type":"number"
        },
        "blockToLive":{
            "type":"number"
        },
        "memberOnlyRead":{
            "type":"boolean"
        },
        "memberOnlyWrite":{
            "type":"boolean"
        },
        "endorsementPolicy":{
            "type":"object",
            "properties":{
                "signaturePolicy":{
                    "type":"string"
                },
                "channelConfigPolicy":{
                    "type":"string"
                }
            }
        }
    }
}

Nested Schema : endorsementPolicy

Type: object

Show Source

channelConfigPolicy: string
signaturePolicy: string

{
    "type":"object",
    "properties":{
        "signaturePolicy":{
            "type":"string"
        },
        "channelConfigPolicy":{
            "type":"string"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Success

Root Schema : 200successModels

Type: object

Show Source

key: string
value: string

{
    "type":"object",
    "properties":{
        "key":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    },
    "example":{
        "status":"success"
    }
}

Example:

{
    "status":"success"
}

400 Response

Invalid arguments

Root Schema : 400errorModels

Type: object

Show Source

key: string
value: string

{
    "type":"object",
    "properties":{
        "key":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    },
    "example":{
        "respMesg":"invalid argument"
    }
}

Example:

{
    "respMesg":"invalid argument"
}

401 Response

Unauthorized

403 Response

Forbidden

500 Response

Internal server error

Root Schema : 500errorModels

Type: object

Show Source

key: string
value: string

{
    "type":"object",
    "properties":{
        "key":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    }
}

Default Response

Unexpected error

Root Schema : errorModel

Type: object

Show Source

code(required): integer(int32)
message(required): string

{
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"integer",
            "format":"int32"
        },
        "message":{
            "type":"string"
        }
    }
}