Skip to content

feat: Implement Stellar Bridge Route Explainability Model - #1080

Merged
mijinummi merged 2 commits into
MDTechLabs:mainfrom
Benedict315:feature/stellar-route-explainability-model
Aug 29, 2026
Merged

feat: Implement Stellar Bridge Route Explainability Model#1080
mijinummi merged 2 commits into
MDTechLabs:mainfrom
Benedict315:feature/stellar-route-explainability-model

Conversation

@Benedict315

Copy link
Copy Markdown
Contributor

Implements route explainability model for Stellar bridge routes to expose the factors that influenced route selection decisions.

Features:

  • Fee contribution analysis with scoring
  • Speed contribution analysis with scoring
  • Liquidity contribution analysis with scoring
  • Reliability contribution analysis with scoring
  • Risk contribution analysis with scoring
  • Human-readable explanations for route recommendations
  • Deterministic explanation output
  • Configurable scoring weights and factor labels
  • Customizable positive/negative threshold

Implementation:

  • src/routing/explainability/stellar/types.ts - Type definitions
  • src/routing/explainability/stellar/route-explainer.ts - Main explainer class
  • src/routing/explainability/stellar/index.ts - Module exports
  • src/routing/scoring/route-scoring-factors.ts - Scoring factor calculations
  • src/routing/scoring/index.ts - Scoring module exports
  • tests/routing/explainability/route-explainer.spec.ts - Explainer tests
  • tests/routing/explainability/route-scoring-factors.spec.ts - Scoring tests

Acceptance Criteria:

  • Route explainability model implemented ✓
  • Scoring factors exposed ✓
  • Route recommendation can be explained ✓
  • Explanation output is deterministic ✓

closes #1071

jotel-dev and others added 2 commits August 29, 2026 21:03
Implements route explainability model for Stellar bridge routes to expose
the factors that influenced route selection decisions.

Features:
- Fee contribution analysis with scoring
- Speed contribution analysis with scoring
- Liquidity contribution analysis with scoring
- Reliability contribution analysis with scoring
- Risk contribution analysis with scoring
- Human-readable explanations for route recommendations
- Deterministic explanation output
- Configurable scoring weights and factor labels
- Customizable positive/negative threshold

Implementation:
- src/routing/explainability/stellar/types.ts - Type definitions
- src/routing/explainability/stellar/route-explainer.ts - Main explainer class
- src/routing/explainability/stellar/index.ts - Module exports
- src/routing/scoring/route-scoring-factors.ts - Scoring factor calculations
- src/routing/scoring/index.ts - Scoring module exports
- tests/routing/explainability/route-explainer.spec.ts - Explainer tests
- tests/routing/explainability/route-scoring-factors.spec.ts - Scoring tests

Acceptance Criteria:
- Route explainability model implemented ✓
- Scoring factors exposed ✓
- Route recommendation can be explained ✓
- Explanation output is deterministic ✓
@drips-wave

drips-wave Bot commented Aug 29, 2026

Copy link
Copy Markdown

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

@mijinummi
mijinummi merged commit a708e86 into MDTechLabs:main Aug 29, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement Stellar Bridge Route Explainability Model

3 participants