Add SDK diagnostics and observability hooks with strict redaction

[El-swaggerito]

Description

Difficulty: Expert

Type: Feature

Summary

Implement SDK diagnostics and observability hooks for configuration, network state, transaction lifecycle, wallet capability, and vault readiness.

Current Behaviour

Apps need debug information, but diagnostics can leak secret keys, raw payloads, or sensitive transaction material.

Expected Behaviour

The SDK should expose opt-in diagnostics with strict redaction and safe lifecycle events.

Suggested Implementation

Create diagnostics report types, event hook interfaces, redaction rules, module integrations, fixtures, tests, and documentation.

Files or Areas Likely Affected

• src/diagnostics/
• src/config/
• src/network/
• src/transactions/
• src/wallet/
• src/vault/
• src/errors/
• tests/
• docs/

Acceptance Criteria

• Diagnostics report model is implemented.
• Lifecycle hooks are opt-in.
• Secrets and sensitive values are redacted.
• Configuration and network state are represented safely.
• Tests verify redaction behaviour.
• Documentation explains safe support workflows.

Additional Notes

This should support debugging without compromising user safety.

[PatrickKish1]

Hi, I would like to work on implementing SDK diagnostics and observability hooks.
I will add a clean, opt-in diagnostics system covering configuration, network state, transaction lifecycle, wallet capability, and vault readiness. All reports and events will enforce strict redaction so that secret keys, raw payloads, and sensitive transaction material are never exposed.
The implementation will include proper report models, lifecycle hooks, redaction rules, module integrations, comprehensive tests verifying redaction behaviour, and clear documentation for safe support workflows. This will give developers useful debug information without compromising user safety.

[grantfox-oss]

🦊 GrantFox — @PatrickKish1 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 #276)
2. Your PR will be reviewed by the Axionvera maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

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

@PatrickKish1's PR #324 was approved and merged by @El-swaggerito.

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

👏 Great work, @PatrickKish1! Keep contributing to Axionvera.