Skip to content

Add SDK diagnostics report for support and debugging #13

Open
woahwhattheheck/Raegis-sdk
#6

Description

@El-swaggerito

Description

Difficulty: Expert

Type: Feature

Summary

Add a safe diagnostics report for SDK configuration, network status, contract registry, compliance module readiness, and recent non-sensitive errors.

Current Behaviour

Developers may struggle to debug configuration and contract interaction failures.

Expected Behaviour

The SDK should generate a non-sensitive diagnostics report that can be shared in GitHub issues.

Suggested Implementation

Create diagnostics types, config snapshot, contract registry status, network health checks, redaction, tests, and documentation.

Files or Areas Likely Affected

  • src/diagnostics/
  • src/config/
  • src/client/
  • src/soroban/
  • src/errors/
  • tests/
  • docs/

Acceptance Criteria

  • Diagnostics report type is implemented.
  • Network and contract config state are included.
  • Compliance module readiness is represented.
  • Sensitive values are redacted.
  • Tests verify diagnostics output.
  • Documentation explains support usage.

Additional Notes

This should help maintainers debug contributor issues.

Activity

  1. added
    GrantFox OSSIssue tracked for GrantFox OSS contribution
    Maybe RewardedIssue may be eligible for a GrantFox reward
    sdkSDK related work
    diagnosticsDiagnostics and observability work
    expertExpert difficulty
    aegisAegis RWA Protocol related work
    on Jul 28, 2026
  2. Ranjeet2063 commented on Oct 3, 2026

    @Ranjeet2063

    Hi team,

    Happy to tackle this. Here is how I plan to implement it:

    Implementation approach:

    1. Audit storage layout and state invariants ensuring strict auth guards.
    2. Implement deterministic state transitions with safe checked arithmetic.
    3. Add hermetic unit and regression tests covering authorized, unauthorized, and boundary edge cases.
    4. Profile instruction and CPU/gas limits under Soroban host environment.

    Please assign this to me if the plan looks good. Thanks!

  3. woahwhattheheck commented on Oct 8, 2026

    @woahwhattheheck

    /claim #13

    Original contributor and compensation claimant: @woahwhattheheck (GitHub ID 293286387). The completed issue-scoped implementation is upstream in PR #216. I am affirmatively claiming contributor credit and requesting any eligible GrantFox OSS / Official Campaign FWC26 bounty or compensation for the accepted contribution, subject to sponsor/program approval. No award or payment is asserted.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    GrantFox OSSIssue tracked for GrantFox OSS contributionMaybe RewardedIssue may be eligible for a GrantFox rewardOfficial Campaign | FWC26Official GrantFox campaign labelaegisAegis RWA Protocol related workdiagnosticsDiagnostics and observability workexpertExpert difficultyfeatureFeature worksdkSDK related work

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions