hyperledger/fabric · error

failed to unmarshal config envelope from payload

Error message

failed to unmarshal config envelope from payload

What it means

Wrapped configtx.UnmarshalConfigEnvelope failure in NewBundleFromEnvelope: the payload decoded, but its data field is not a valid ConfigEnvelope — the block payload is corrupt or of an unexpected type.

Source

Thrown at common/channelconfig/bundle.go:177

		}
	} else if _, okNew := nb.ConsortiumsConfig(); okNew {
		return errors.Errorf("current config has no consortiums section, but new config does")
	}

	return nil
}

// NewBundleFromEnvelope wraps the NewBundle function, extracting the needed
// information from a full configtx
func NewBundleFromEnvelope(env *cb.Envelope, bccsp bccsp.BCCSP) (*Bundle, error) {
	payload, err := protoutil.UnmarshalPayload(env.Payload)
	if err != nil {
		return nil, errors.Wrap(err, "failed to unmarshal payload from envelope")
	}

	configEnvelope, err := configtx.UnmarshalConfigEnvelope(payload.Data)
	if err != nil {
		return nil, errors.Wrap(err, "failed to unmarshal config envelope from payload")
	}

	if payload.Header == nil {
		return nil, errors.Errorf("envelope header cannot be nil")
	}

	chdr, err := protoutil.UnmarshalChannelHeader(payload.Header.ChannelHeader)
	if err != nil {
		return nil, errors.Wrap(err, "failed to unmarshal channel header")
	}

	return NewBundle(chdr.ChannelId, configEnvelope.Config, bccsp)
}

// NewBundle creates a new immutable bundle of configuration
func NewBundle(channelID string, config *cb.Config, bccsp bccsp.BCCSP) (*Bundle, error) {
	if err := preValidate(config); err != nil {
		return nil, err

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Check the wrapped error for the protobuf decode failure detail
2. Obtain the config envelope from a verified config block and retry

When it happens

Trigger: Thrown at common/channelconfig/bundle.go:177 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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