feat: enhance error types for advanced pattern matching

[larryjay007]

Overview

This PR improves error handling in the Go SDK by introducing typed routing errors that integrate with Go's standard errors.Is() and errors.As() APIs.

Changes

packages/core-go/address/errors.go

• Added a new RoutingError type implementing the error interface.
• Implemented an Is() method to support code-based error matching.
• Introduced specific ErrorCode constants for common routing failures.

packages/core-go/address/parse.go

• Updated parsing logic to return RoutingError instances instead of generic errors where appropriate.

Benefits

This enables more robust and idiomatic error handling, for example:

if errors.Is(err, address.ErrInvalidChecksumError) {
    // Handle invalid checksum
}

It also simplifies retry and fallback logic by allowing callers to distinguish between different failure scenarios using standard Go error matching.

Related Issue

Closes #273

Type of Change

• Enhancement

Checklist

• Code follows the project's style guidelines
• Self-review completed
• Changes verified locally
• Tests pass (where applicable)

[drips-wave]

@larryjay007 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

[codeZe-us]

@larryjay007 Fix CI workflow issues

[larryjay007]

@codeZe-us, Ready for review again. Let me know if any adjustments are needed.
Thanks!

[codeZe-us]

@larryjay007 CI check still fails.

[larryjay007]

Sorry for the back and forth, I really appreciate your patience and feedback helping me get it right.
Ready for another look whenever convenient.

[codeZe-us]

@larryjay007 check it properly, it still fails. You can join the contributor telegram group and let me know so I can review again.

[larryjay007]

lets do this again. but already joined the telegram group.

[codeZe-us]

@larryjay007 all checks passed, but i noticed you withdrew from the task

[larryjay007]

That must have been a mistake @codeZe-us ..

[larryjay007]

Lets do it this way, lets see if i can reapply to this issue and get assigned.