hyperledger/fabric · error

nil block

Error message

nil block

What it means

validateBootstrapBlock checks whether a block can serve as a bootstrap (system-channel) block when the orderer starts without a system channel. A nil block is immediately rejected with this error, since there is nothing to validate and channel bootstrapping cannot proceed.

Source

Thrown at orderer/common/server/util.go:45

func createLedgerFactory(conf *config.TopLevel, metricsProvider metrics.Provider) (blockledger.Factory, error) {
	ld := conf.FileLedger.Location
	if ld == "" {
		logger.Panic("Orderer.FileLedger.Location must be set")
	}

	logger.Debug("Ledger dir:", ld)
	lf, err := fileledger.New(ld, metricsProvider)
	if err != nil {
		return nil, errors.WithMessage(err, "Error in opening ledger factory")
	}
	return lf, nil
}

// validateBootstrapBlock returns whether this block can be used as a bootstrap block.
// A bootstrap block is a block of a system channel, and needs to have a ConsortiumsConfig.
func validateBootstrapBlock(block *common.Block, bccsp bccsp.BCCSP) error {
	if block == nil {
		return errors.New("nil block")
	}

	if block.Data == nil || len(block.Data.Data) == 0 {
		return errors.New("empty block data")
	}

	firstTransaction := &common.Envelope{}
	if err := proto.Unmarshal(block.Data.Data[0], firstTransaction); err != nil {
		return errors.Wrap(err, "failed extracting envelope from block")
	}

	bundle, err := channelconfig.NewBundleFromEnvelope(firstTransaction, bccsp)
	if err != nil {
		return err
	}

	_, exists := bundle.ConsortiumsConfig()
	if !exists {

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Provide a valid genesis block via the General.BootstrapMethod=file setting pointing to a non-empty block file
2. Regenerate the genesis block with configtxgen if the file is missing/empty
3. Fix the caller to propagate block-loading errors instead of passing a nil block onward

Example fix

// before: error ignored, nil block passed downstream
block, _ := readGenesisBlock(path)
err := validateBootstrapBlock(block, bccsp)

// after: check load error explicitly
block, err := readGenesisBlock(path)
if err != nil {
	return fmt.Errorf("cannot read bootstrap block %s: %w", path, err)
}
err = validateBootstrapBlock(block, bccsp)

// Go: guard before validateBootstrapBlock
if block == nil {
    return errors.New("bootstrap block not loaded")
}
if err := block.Validate(bccsp); err != nil {
    return err
}

func isLoadedBlock(b *common.Block) bool {
    return b != nil && b.Header != nil && b.Data != nil && len(b.Data.Data) > 0
}

if err := validateBootstrapBlock(block, bccsp); err != nil {
    if err.Error() == "nil block" {
        return fmt.Errorf("bootstrap file unreadable or empty; regenerate with configtxgen")
    }
    return err
}

When it happens

Trigger: verifyNoSystemChannelJoinBlock / verifyNoSystemChannel pass a nil pointer — e.g. the join-block file read failed and the nil error was swallowed, or the caller passes a nil block reference into orderer bootstrap validation.

Common situations: Orderer started with a missing or unreadable bootstrap/join block file, an empty GENESIS provider file path, or calling JoinChannel/bootstrap APIs where the block-load error was ignored upstream.

Related errors

• failed marshaling joinblock: proto: Marshal called with nil
• OrdererOrg config does not allow sub-groups
• Attempted to set the batch size preferred max bytes (%v) gre
• Attempted to set the batch timeout to a invalid value: %s
• Attempted to set the batch timeout to a non-positive value:

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