hyperledger/fabric · error

depspec cannot be nil if buf is not nil

Error message

depspec cannot be nil if buf is not nil

What it means

PutChaincodeToFS finally requires both sDepSpec and depSpec to be non-nil when buf is set, and further that env is non-nil. These are the parsed structures derived from the package bytes; missing ones indicate incomplete initialization. The library refuses to persist a partially parsed package.

Source

Thrown at core/common/ccprovider/sigcdspackage.go:290

	if _, err = ccpack.InitFromBuffer(buf); err != nil {
		return nil, nil, err
	}

	return ccpack.buf, ccpack.depSpec, nil
}

// PutChaincodeToFS - serializes chaincode to a package on the file system
func (ccpack *SignedCDSPackage) PutChaincodeToFS() error {
	if ccpack.buf == nil {
		return errors.New("uninitialized package")
	}

	if ccpack.id == nil {
		return errors.New("id cannot be nil if buf is not nil")
	}

	if ccpack.sDepSpec == nil || ccpack.depSpec == nil {
		return errors.New("depspec cannot be nil if buf is not nil")
	}

	if ccpack.env == nil {
		return errors.New("env cannot be nil if buf and depspec are not nil")
	}

	if ccpack.data == nil {
		return errors.New("nil data")
	}

	if ccpack.datab == nil {
		return errors.New("nil data bytes")
	}

	ccname := ccpack.depSpec.ChaincodeSpec.ChaincodeId.Name
	ccversion := ccpack.depSpec.ChaincodeSpec.ChaincodeId.Version

	// return error if chaincode exists

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Use the full initialization flow (GetCCPackage -> InitFromBuffer) before persisting
2. Ensure InitFromBuffer ran to completion so sDepSpec, depSpec and env are all populated
3. Stop ignoring errors from earlier init steps; abort the install on any init failure

Example fix

// before
ccpack.buf = buf; ccpack.id = id // sDepSpec/depSpec/env nil
ccpack.PutChaincodeToFS()
// after
ccpack := &SignedCDSPackage{}
if _, err := ccpack.InitFromBuffer(buf); err != nil { return err } // populates all fields
ccpack.PutChaincodeToFS()

func ensureInitBeforePersist(ccpack *ccprovider.SignedCDSPackage, buf []byte) error {
    if _, err := ccpack.InitFromBuffer(buf); err != nil {
        return err // populates buf, id, sDepSpec, depSpec, env
    }
    return nil
}

func allFieldsSet(ccpack *ccprovider.SignedCDSPackage) bool {
    b, _, err := ccpack.GetDepSpec()
    return err == nil && b != nil
}

if _, err := ccpack.InitFromBuffer(buf); err != nil {
    return fmt.Errorf("cannot persist: init incomplete: %w", err)
}
if err := ccpack.PutChaincodeToFS(); err != nil {
    if strings.Contains(err.Error(), "cannot be nil") { return errors.New("partially initialized package; use InitFromBuffer first") }
    return err
}

When it happens

Trigger: PutChaincodeToFS on a package where buf and id are set but the signed/unsigned deployment specs (or env) were never populated by InitFromBuffer — typically manual struct assembly.

Common situations: Custom install tooling that copies fields between SignedCDSPackage instances; skipped or failed InitFromBuffer steps whose errors were ignored; fabric version migrations.

Related errors

• id cannot be nil if buf is not nil
• received proposal response with nil response
• query failed with status: %d - %s
• query iterator not found
• only applicable for private data

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