ipfs/kubo · error

registering HTTP delegated routing views: %w

Error message

registering HTTP delegated routing views: %w

What it means

While constructing an HTTP delegated router from config, registering the client's routing views on the fx lifecycle (view.Register) failed; the wrapped error carries the underlying cause. This happens during node startup when a delegated router cannot be set up.

Source

Thrown at routing/delegated.go:285

		providerInfoOpt,
		drclient.WithUserAgent(version.GetUserAgentVersion()),
		drclient.WithProtocolFilter(protocols),
		drclient.WithStreamResultsRequired(),       // https://specs.ipfs.tech/routing/http-routing-v1/#streaming
		drclient.WithDisabledLocalFiltering(false), // force local filtering in case remote server does not support IPIP-484
	)
	if err != nil {
		return nil, err
	}

	cr := contentrouter.NewContentRoutingClient(
		cli,
		contentrouter.WithMaxProvideBatchSize(params.MaxProvideBatchSize),
		contentrouter.WithMaxProvideConcurrency(params.MaxProvideConcurrency),
	)

	err = view.Register(drclient.OpenCensusViews...)
	if err != nil {
		return nil, fmt.Errorf("registering HTTP delegated routing views: %w", err)
	}

	return &httpRoutingWrapper{
		ContentRouting:    cr,
		PeerRouting:       cr,
		ValueStore:        cr,
		ProvideManyRouter: cr,
	}, nil
}

func decodePrivKey(keyB64 string) (ic.PrivKey, error) {
	pk, err := base64.StdEncoding.DecodeString(keyB64)
	if err != nil {
		return nil, err
	}

	return ic.UnmarshalPrivateKey(pk)
}

View on GitHub (pinned to 329838acdf)

Solutions

1. Check the wrapped error for the root cause
2. Verify the delegated router endpoint URL is reachable and speaks the HTTP Routing V1 spec
3. Retry startup after fixing connectivity or the endpoint config

When it happens

Trigger: Thrown at routing/delegated.go:285 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ipfs/kubo@329838acdf (2026-09-03). Data as JSON: /api/errors/c49eba99755a3fac. Report an issue: GitHub.