The errors package provides extended error handling utilities for Entiqon. It builds on Go's standard error interface by introducing structured errors that carry additional context.

• CausableError
  An error that has both:

  • Cause() → short identifier for the category of error (e.g., "Database")
  • Reason() → detailed explanation for logs or user messages

• ProcessStageError
  Extends CausableError by associating an error with a ProcessStage. Useful for tracing errors in multi-step processing pipelines.

import "github.com/entiqon/entiqon/common/errors"

// Create a simple causable error
err := errors.NewCausableError("Database", "Connection failed")

// Create a process stage error
pse := errors.NewProcessStageError("Init", "Loader", "Failed to load resource", err)

• Use Cause() to classify errors programmatically
• Use Reason() or Error() for logging and display
• Use ProcessStageError.Stage() to trace where the error occurred
• Errors support Go's errors.Is and errors.As for unwrapping

MIT — © Entiqon Team