What causes "could not get channel config for channel '%s'" in hyperledger/fabric?

Ensure the peer has joined the channel ('peer channel list') and the channel exists in the peer's ledger

could not get channel config for channel '%s'

Error message

could not get channel config for channel '%s'

What it means

Thrown by Resources.LifecycleEndorsementPolicyAsBytes when ChannelConfigSource.GetStableChannelConfig returns nil for the requested channel, i.e. the peer has no stable channel configuration loaded for that channel ID.

Source

Thrown at core/chaincode/lifecycle/lifecycle.go:277

	}

	if metadata.Datatype != ChaincodeDefinitionType {
		return false, nil, errors.Errorf("not a chaincode type: %s", metadata.Datatype)
	}

	definedChaincode := &ChaincodeDefinition{}
	err = r.Serializer.Deserialize(NamespacesName, chaincodeName, metadata, definedChaincode, state)
	if err != nil {
		return false, nil, errors.WithMessagef(err, "could not deserialize chaincode definition for chaincode %s", chaincodeName)
	}

	return true, definedChaincode, nil
}

func (r *Resources) LifecycleEndorsementPolicyAsBytes(channelID string) ([]byte, error) {
	channelConfig := r.ChannelConfigSource.GetStableChannelConfig(channelID)
	if channelConfig == nil {
		return nil, errors.Errorf("could not get channel config for channel '%s'", channelID)
	}

	if _, ok := channelConfig.PolicyManager().GetPolicy(LifecycleEndorsementPolicyRef); ok {
		return LifecycleDefaultEndorsementPolicyBytes, nil
	}

	// This was a channel which was upgraded or did not define a lifecycle endorsement policy, use a default
	// of "a majority of orgs must have a member sign".
	ac, ok := channelConfig.ApplicationConfig()
	if !ok {
		return nil, errors.Errorf("could not get application config for channel '%s'", channelID)
	}
	orgs := ac.Organizations()
	mspids := make([]string, 0, len(orgs))
	for _, org := range orgs {
		mspids = append(mspids, org.MSPID())
	}

View on GitHub (pinned to 2736b63f8f)

Solutions

Ensure the peer has joined the channel ('peer channel list') and the channel exists in the peer's ledger
Verify the channel ID spelling in your request
Restart/rejoin the peer so channel config is fetched, and check peer logs for config load errors

Example fix

// before
ValidationInfo(channelID: 'chanel-one') // typo, no such channel config
// after
ValidationInfo(channelID: 'channel-one') // channel the peer has joined

Defensive patterns

Strategy: try-catch

Validate before calling

cfg := channelConfigSource.GetStableChannelConfig(channelID)
if cfg == nil {
    return fmt.Errorf("peer is not joined to channel %s; cannot compute lifecycle policy", channelID)
}

Type guard

func hasChannelConfig(src ChannelConfigSourceGetter, channelID string) bool {
    return src.GetStableChannelConfig(channelID) != nil
}

Try / catch

policyBytes, err := resources.LifecycleEndorsementPolicyAsBytes(chid)
if err != nil {
    if strings.Contains(err.Error(), "could not get channel config") {
        // ensure peer joined the channel; retry after channel load
    }
    return err
}

Prevention

Run 'peer channel list' to confirm membership before lifecycle operations
Verify the channel ID string; channel names are case-sensitive
Check peer startup logs for failed channel config retrieval

When it happens

Trigger: Computing the lifecycle (_lifecycle) system chaincode endorsement policy during ValidationInfo or getLifecycleSCCChaincodeInfo for a channel whose config cannot be retrieved from the peer.

Common situations: Peer not joined to the channel; channel config not yet loaded/stabilized at peer startup; wrong channel name used in an SDK/CLI call targeting this peer.

Related errors

AI-assisted analysis of hyperledger/fabric@2736b63f8f (2026-09-04). Data as JSON: /api/errors/677aeab1e1ff24f6. Report an issue: GitHub.