{"record":{"id":"4e82c7c99a533ba7","repo":"hyperledger/fabric","slug":"error-unmarshalling-envelope-4e82c7","errorCode":null,"errorMessage":"error unmarshalling Envelope","messagePattern":"error unmarshalling Envelope","errorType":"error_code","errorClass":null,"httpStatus":null,"severity":"error","filePath":"protoutil/unmarshalers.go","lineNumber":54,"sourceCode":"// UnmarshalChaincodeInvocationSpec unmarshals bytes to a ChaincodeInvocationSpec\nfunc UnmarshalChaincodeInvocationSpec(encoded []byte) (*peer.ChaincodeInvocationSpec, error) {\n\tcis := &peer.ChaincodeInvocationSpec{}\n\terr := proto.Unmarshal(encoded, cis)\n\treturn cis, errors.Wrap(err, \"error unmarshalling ChaincodeInvocationSpec\")\n}\n\n// UnmarshalPayload unmarshals bytes to a Payload\nfunc UnmarshalPayload(encoded []byte) (*common.Payload, error) {\n\tpayload := &common.Payload{}\n\terr := proto.Unmarshal(encoded, payload)\n\treturn payload, errors.Wrap(err, \"error unmarshalling Payload\")\n}\n\n// UnmarshalEnvelope unmarshals bytes to a Envelope\nfunc UnmarshalEnvelope(encoded []byte) (*common.Envelope, error) {\n\tenvelope := &common.Envelope{}\n\terr := proto.Unmarshal(encoded, envelope)\n\treturn envelope, errors.Wrap(err, \"error unmarshalling Envelope\")\n}\n\n// UnmarshalChannelHeader unmarshals bytes to a ChannelHeader\nfunc UnmarshalChannelHeader(bytes []byte) (*common.ChannelHeader, error) {\n\tchdr := &common.ChannelHeader{}\n\terr := proto.Unmarshal(bytes, chdr)\n\treturn chdr, errors.Wrap(err, \"error unmarshalling ChannelHeader\")\n}\n\n// UnmarshalChaincodeID unmarshals bytes to a ChaincodeID\nfunc UnmarshalChaincodeID(bytes []byte) (*peer.ChaincodeID, error) {\n\tccid := &peer.ChaincodeID{}\n\terr := proto.Unmarshal(bytes, ccid)\n\treturn ccid, errors.Wrap(err, \"error unmarshalling ChaincodeID\")\n}\n\n// UnmarshalSignatureHeader unmarshals bytes to a SignatureHeader\nfunc UnmarshalSignatureHeader(bytes []byte) (*common.SignatureHeader, error) {","sourceCodeStart":36,"sourceCodeEnd":72,"githubUrl":"https://github.com/hyperledger/fabric/blob/2736b63f8fd5932511d56fe68b7039d15977f7f6/protoutil/unmarshalers.go#L36-L72","documentation":"UnmarshalEnvelope wraps a proto.Unmarshal failure: the bytes are not a valid common.Envelope (nil, empty, truncated, or a different message type). The outermost decode for broadcast/deliver and config processing.","triggerScenarios":"Thrown at protoutil/unmarshalers.go:54 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Reject the input; it is not a serialized Fabric envelope","Verify transport/encoding (no double base64, no truncation)"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2736b63f8fd5932511d56fe68b7039d15977f7f6","analyzedAt":"2026-09-04T08:52:36.465Z","contentChangedAt":"2026-09-04T08:52:36.465Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}