Unify oracle multi-provider failover with Decimal-safe consensus rules

[josephchimebuka]

Summary

Collapse remaining price provider divergence into one failover stack with explicit staleness, quorum/priority rules, and Decimal outputs for both /api/price and multi-asset prices.

Why this matters

Resolution correctness depends on oracle integrity; divergent stacks and float paths risk wrong round outcomes.

Where to work

• src/services/oracle.ts
• src/services/priceService.ts
• src/services/providers/ / price-providers/
• metrics

What to implement

1. Single provider interface + registry.
2. Priority/failover + stale detection.
3. Decimal serialization at API boundary.
4. Metrics for provider wins/failures.
5. Tests for failover and all-providers-down.

Acceptance criteria

• One provider stack serves XLM + multi-asset needs.
• Stale prices never resolve rounds in fail-closed config.
• Decimal-safe responses.
• Tests cover failover matrix.

Done when

Price inputs to resolution are consistent and safe.

Metadata

Field	Value
Difficulty	advanced
Complexity	high
Good first contribution?	no

[Shindy-Ship]

@Oluwashinda has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I’ve carefully gone through the requirements and am confident I can address the issue effectively while ensuring the solution meets all the specified acceptance criteria.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwashinda to this issue.

[AvatarMiiDe]

@AvatarMiiDe has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello,
I’ve gone through the requirements. I will deliver on time and to standard.
Please assign it to me now.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @AvatarMiiDe to this issue.

[tobemacauley-rgb]

@tobemacauley-rgb has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @tobemacauley-rgb to this issue.