Add a single-source-of-truth `errors.rs` shared across crates

[ibrahimmosouf-png]

Add a single-source-of-truth errors.rs shared across crates

Labels: architecture, dx, priority/medium
Difficulty: Medium · Effort: S
Backlog slot: 16

Problem Statement

There are three independent error enums:

• orbitchain-campaign::Error (canonical, 80+ codes).
• orbitchain-core::CoreError (legacy, ~12 codes).
• Tooling-side anyhow::Error (CLI).
  No shared crate means new contributors cannot reuse an error concept across the workspace.

Why it Matters

• Single source of truth = documentation, lint and migration story become tractable.

Expected Outcome

Move non-contract specific enum variants (e.g. Overflow, NotInitialized generalised names) to orbitchain-common::CommonError. Update campaign to import from there.

Acceptance Criteria

• All shared errors live in common::CommonError.
• No duplicate discriminants across crates.

Files Likely Affected

• common/src/lib.rs
• campaign/src/types.rs
• crates/contracts/core/src/lib.rs

Dependencies

Issue #9.

---

[neromtoobad]

Hi, I'd like to work on this issue. I've been working this error space closely: my in-flight #203 appends codes 94–102 for the admin-governance flow and #158 renumbered its receipt errors around merged #183's code 90, so I know exactly which discriminant-stability constraints a shared errors.rs has to preserve to avoid breaking on-chain error codes. I can deliver in 12 hrs. Looking forward to contributing.

[endofdays7]

Hello maintainer please I will like to work on this issue

[grantfox-oss]

🦊 GrantFox — @endofdays7 has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #103)
2. Your PR will be reviewed by the OrbitChainLabs maintainers

Good luck! Track your progress on GrantFox.