Health check that proves the on-chain adapter is reachable at boot

[kilodesodiq-arch]

Problem Statement. health.module.ts includes OnchainModule but HealthService's
current checks aren't documented; a 5× slowdown in Soroban RPC could silently degrade
UX.

Technical Context. src/health/health.service.ts (file existence assumed).

Expected Outcome. Health check at /api/v1/health/dependencies reports the time
taken for a getAdmin RPC call; threshold 5 s; if exceeded, status degraded.

Acceptance Criteria.

• The /health/dependencies endpoint includes onchain_rpc_ms.

Files or modules likely to be affected.
src/health/*,
app/backend/test/health.e2e-spec.ts.

Difficulty. Easy
Estimated effort. S

---

---

Backlog item #79 from `docs/maintainer-issue-backlog.md.

[Preciousuche]

Hi! I’d like to work on this issue. I have experience reading and contributing to backend codebases and I’m interested in improving application reliability. I plan to implement a startup health check that verifies the on-chain adapter is reachable during boot, following the project’s coding standards and adding or updating tests where appropriate. I’ll communicate my progress and submit a well-tested PR.

[grantfox-oss]

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

Good luck! Track your progress on GrantFox.

[Preciousuche]

Hi, I'm picking this up. One clarification: the OnchainAdapter interface in src/onchain/onchain.adapter.ts doesn't currently expose a getAdmin() method — the closest read-only calls are getContractMetadata(), getPauseState(), and getFeeConfig().

For the /health/dependencies latency check, would you prefer I (a) reuse the existing getContractMetadata() call to measure onchain_rpc_ms, or (b) add a new getAdmin() method to the adapter?

I'll proceed with getContractMetadata() for now so I can open the PR, and it's a one-line swap to getAdmin() if you'd rather have that specifically. Thanks!

[grantfox-oss]

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

@Preciousuche's PR #357 was approved and merged by @kilodesodiq-arch.

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

👏 Great work, @Preciousuche! Keep contributing to ChainForgee.