[SC-45] Unify error codes across contracts

[yusuftomilola]

Overview

Each crate defines its own errors — assetsup/src/error.rs, contrib/src/error.rs, multisig-wallet/src/errors.rs, multisig_transfer/src/errors.rs. Independently numbered enums mean the same integer means different things per contract, making backend error handling ambiguous and cross-contract calls hard to interpret.

Tasks

• Catalogue every error enum and its discriminant values.
• Allocate a per-contract numeric range (e.g. assetsup 100–199, contrib 200–299) and document the allocation.
• Extract genuinely shared errors (Unauthorized, NotInitialized, AlreadyInitialized, InvalidInput) into a shared types crate with fixed codes.
• Renumber contract-specific errors into their assigned ranges.
• Give every variant a doc comment explaining when it is returned.
• Coordinate with the backend Soroban bridge, which will map these codes.

Acceptance Criteria

• No two contracts use the same numeric code for different meanings.
• Shared errors are defined once.
• The allocation table is documented and every variant has a doc comment.

Notes for Contributors

Requires Rust + Soroban. Workspace: contracts/ (soroban-sdk 22, members: assetsup, contrib, multisig-wallet, multisig_transfer, asset-maintenance). Run cargo test --all, cargo fmt --all -- --check, and cargo clippy --all-targets --all-features -- -D warnings before opening a PR — CI enforces all three. Comment below to be assigned.

[fathiaoyinloye]

Hi, I'd like to work on this issue. I have relevant experience with the technologies and concepts involved, and I'm confident I can make the necessary implementation to ensure the it meets the acceptance criteria. I'd be happy to contribute to this task.

[fathiaoyinloye]

Hi, I'd like to work on this issue. I have relevant experience with the technologies and concepts involved, and I'm confident I can make the necessary implementation to ensure the it meets the acceptance criteria. I'd be happy to contribute to this task.

[Itzzyee47]

@Itzzyee47 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I understand the required enhancement and would like to work on the issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Itzzyee47 to this issue.

[Achievers-sketch]

@Achievers-sketch has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Experienced Rust/Soroban smart contract developer standardizing cross-contract error handling, defining shared error codes, improving backend interoperability, and maintaining well-documented contract APIs.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Achievers-sketch to this issue.

[temiport25]

@temiport25 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

can i solve this issue?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @temiport25 to this issue.

[drips-wave]

Congratulations, @temiport25! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @temiport25: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@temiport25's PR #1229 was approved and merged by @yusuftomilola.

🏆 @temiport25: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (662 total points). Track your full progress on GrantFox.

👏 Great work, @temiport25! Keep contributing to DistinctCodes.

[drips-wave]

This issue has been completed by @temiport25 as part of the Stellar Wave Program's 7th Wave 🥳

😎 @temiport25: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.