onboarding

type OnboardingService interface {
	mbootstrap.Service

	// GetRouteRegistrar returns a function that registers onboarding routes to a Fiber app.
	// This is used by the unified ledger server to consolidate all routes on a single port.
	GetRouteRegistrar() func(*fiber.App)

	// GetMetadataIndexPort returns the metadata index port for use by other modules.
	// This allows direct in-process calls for metadata index operations when running in unified mode.
	GetMetadataIndexPort() mbootstrap.MetadataIndexRepository
}

type Options struct {
	// Logger allows callers to provide a pre-configured logger, avoiding multiple
	// initializations when composing components (e.g. unified ledger).
	Logger libLog.Logger

	// UnifiedMode indicates the service is running as part of the unified ledger.
	// When true, all ports must be provided for in-process communication.
	// When false (or Options is nil), uses gRPC adapters for remote communication.
	UnifiedMode bool

	// BalancePort enables direct in-process communication with the transaction module.
	// Required when UnifiedMode is true. The BalancePort is typically the
	// transaction.UseCase which implements mbootstrap.BalancePort.
	BalancePort mbootstrap.BalancePort
}