I suggest the "per channel create" command to make deprecated. (#5238)

For this functionality, you need to use the Order Service Node (OSN)

Signed-off-by: Fedor Partanskiy <[email protected]>

Author: pfi79

docs/source/commands/peerchannel.md

@@ -31,7 +31,7 @@ Usage:
   peer channel [command]
 
 Available Commands:
-  create               Create a channel
+  create               [DEPRECATED] Create a channel
   fetch                Fetch a block
   getinfo              get blockchain information of a specified channel.
   join                 Joins the peer to a channel.
@@ -59,7 +59,7 @@ Use "peer channel [command] --help" for more information about a command.
 
 ## peer channel create
 ```
-Create a channel and write the genesis block to a file.
+[DEPRECATED] Create a channel and write the genesis block to a file. Instead of this command, use Orderer Service Node (OSN).
 
 Usage:
   peer channel create [flags]
@@ -277,7 +277,7 @@ Global Flags:
 
 ## Example Usage
 
-### peer channel create examples
+### peer channel create examples (deprecated)
 
 Here's an example that uses the `--orderer` global flag on the `peer channel
 create` command.

docs/wrappers/peer_channel_postscript.md

@@ -1,6 +1,6 @@
 ## Example Usage
 
-### peer channel create examples
+### peer channel create examples (deprecated)
 
 Here's an example that uses the `--orderer` global flag on the `peer channel
 create` command.

integration/nwo/commands/peer.go

@@ -102,6 +102,7 @@ func (n NodeUnjoin) Args() []string {
 	}
 }
 
+// deprecated
 type ChannelCreate struct {
 	ChannelID   string
 	Orderer     string
@@ -110,10 +111,12 @@ type ChannelCreate struct {
 	ClientAuth  bool
 }
 
+// deprecated
 func (c ChannelCreate) SessionName() string {
 	return "peer-channel-create"
 }
 
+// deprecated
 func (c ChannelCreate) Args() []string {
 	args := []string{
 		"channel", "create",

integration/nwo/network.go

@@ -1089,6 +1089,7 @@ func (n *Network) CreateChannel(channelName string, o *Orderer, p *Peer, additio
 	Eventually(createChannel, n.EventuallyTimeout).Should(Equal(0))
 }
 
+// deprecated
 // CreateChannelExitCode will submit an existing create channel transaction to
 // the specified orderer, wait for the operation to complete, and return the
 // exit status of the "peer channel create" command.

internal/peer/channel/create.go

@@ -38,11 +38,12 @@ func (e InvalidCreateTx) Error() string {
 	return fmt.Sprintf("Invalid channel create transaction : %s", string(e))
 }
 
+// deprecated
 func createCmd(cf *ChannelCmdFactory) *cobra.Command {
 	createCmd := &cobra.Command{
 		Use:   "create",
-		Short: "Create a channel",
-		Long:  "Create a channel and write the genesis block to a file.",
+		Short: "[DEPRECATED] Create a channel",
+		Long:  "[DEPRECATED] Create a channel and write the genesis block to a file. Instead of this command, use Orderer Service Node (OSN).",
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return create(cmd, args, cf)
 		},
@@ -58,6 +59,7 @@ func createCmd(cf *ChannelCmdFactory) *cobra.Command {
 	return createCmd
 }
 
+// deprecated
 func createChannelFromDefaults(cf *ChannelCmdFactory) (*cb.Envelope, error) {
 	chCrtEnv, err := encoder.MakeChannelCreationTransaction(
 		channelID,
@@ -71,6 +73,7 @@ func createChannelFromDefaults(cf *ChannelCmdFactory) (*cb.Envelope, error) {
 	return chCrtEnv, nil
 }
 
+// deprecated
 func createChannelFromConfigTx(configTxFileName string) (*cb.Envelope, error) {
 	cftx, err := os.ReadFile(configTxFileName)
 	if err != nil {
@@ -80,6 +83,7 @@ func createChannelFromConfigTx(configTxFileName string) (*cb.Envelope, error) {
 	return protoutil.UnmarshalEnvelope(cftx)
 }
 
+// deprecated
 func sanityCheckAndSignConfigTx(envConfigUpdate *cb.Envelope, signer identity.SignerSerializer) (*cb.Envelope, error) {
 	payload, err := protoutil.UnmarshalPayload(envConfigUpdate.Payload)
 	if err != nil {
@@ -137,6 +141,7 @@ func sanityCheckAndSignConfigTx(envConfigUpdate *cb.Envelope, signer identity.Si
 	return protoutil.CreateSignedEnvelope(cb.HeaderType_CONFIG_UPDATE, channelID, signer, configUpdateEnv, 0, 0)
 }
 
+// deprecated
 func sendCreateChainTransaction(cf *ChannelCmdFactory) error {
 	var err error
 	var chCrtEnv *cb.Envelope
@@ -167,6 +172,7 @@ func sendCreateChainTransaction(cf *ChannelCmdFactory) error {
 	return err
 }
 
+// deprecated
 func executeCreate(cf *ChannelCmdFactory) error {
 	err := sendCreateChainTransaction(cf)
 	if err != nil {
@@ -195,6 +201,7 @@ func executeCreate(cf *ChannelCmdFactory) error {
 	return nil
 }
 
+// deprecated
 func getGenesisBlock(cf *ChannelCmdFactory) (*cb.Block, error) {
 	timer := time.NewTimer(timeout)
 	defer timer.Stop()
@@ -220,6 +227,7 @@ func getGenesisBlock(cf *ChannelCmdFactory) (*cb.Block, error) {
 	}
 }
 
+// deprecated
 func create(cmd *cobra.Command, args []string, cf *ChannelCmdFactory) error {
 	// the global chainID filled by the "-c" command
 	if channelID == common.UndefinedParamValue {