refactor: implement unified CoreError enum and migrate 14 contracts

[benedictworks-home]

Title: Refactor: Implement Unified CoreError Enum and Migrate 14 Contracts

Description: This PR refactors the Soroban contract error handling system from raw u32 values to a standardized CoreError enum, ensuring consistent cross-contract error handling.

Changes Made:

1. Created contracts/types/src/errors.rs :

   • Defined the CoreError enum with variants for Auth, Initialization, Validation, Payment, State, Storage, External, and Recovery errors
   • Marked old u32 error codes as deprecated for backward compatibility
   • Added methods for user-friendly messages, error codes, and event emission

2. Updated contracts/types/src/lib.rs :

   • Exported the errors module and CoreError enum

3. Migrated All 14 Contracts:

   • Added bidirectional From conversions between each contract's specific error enum and CoreError
   • Contracts updated: subscription, credit, oracle, batch, metering

4. Updated Documentation:

   • Enhanced developer-portal/docs/api-reference.md with CoreError enum details

Key Benefits:

• Consistent error handling across all contracts
• Clear error categories for debugging
• Standardized event emission for errors
• Backward compatibility maintained
• Auto-generatable documentation schema

Closes #578

[drips-wave]

@benedictworks-home Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[Smartdevs17]

Thanks for contributing kindly leave a review.

[benedictworks-home]

Done Thanks for letting me work on some of your issues on this wave. Hope for the best next wave

…

On Fri, Jul 3, 2026 at 1:06 AM Stephen Joseph ***@***.***> wrote: *Smartdevs17* left a comment (Smartdevs17/SubTrackr#638) <#638 (comment)> Thanks for contributing kindly leave a review. — Reply to this email directly, view it on GitHub <#638?email_source=notifications&email_token=CCBO7UWDVM44XIJ33X2DN2T5C5SRFA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOBXGQYTGOJXGEZKM4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJLDGN5XXIZLSL5RWY2LDNM#issuecomment-4874139712>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/CCBO7UVS64L6K7GGKRFFJKT5C5SRFAVCNFSNUABGKJSXA33TNF2G64TZHMYTAMZXGYZTGOBSGQ5US43TOVSTWNBXGMZTONRVGU3DHILWAI> . You are receiving this because you were mentioned.Message ID: ***@***.***>