hyperledger/fabric · error

failed to unmarshal payload from envelope

Error message

failed to unmarshal payload from envelope

What it means

Wrapped protoutil.UnmarshalPayload failure inside NewBundleFromEnvelope: the envelope's payload bytes are not a decodable common.Payload, so the config envelope cannot be extracted from a join/config block.

Source

Thrown at common/channelconfig/bundle.go:172

				mspID := org.MSPID()
				if mspID != norg.MSPID() {
					return errors.Errorf("consortium %s org %s attempted to change MSP ID from %s to %s", consortiumName, orgName, mspID, norg.MSPID())
				}
			}
		}
	} 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)
}

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Verify the envelope came from a genuine Fabric config block
2. Rebuild the join/config block from a trusted peer and retry

When it happens

Trigger: Thrown at common/channelconfig/bundle.go:172 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/539bb01f1bdac0c5. Report an issue: GitHub.