feat(frontend): automated invoice matching engine for lender-invoice fit

[samjay8]

Summary

Build an automated matching engine that suggests invoice-lender pairs based on risk profile, currency preference, yield requirements, and historical performance.

Problem

Lenders manually browse the marketplace to find suitable invoices. This is time-consuming and often results in missed opportunities or poor fits.

Requirements

• Lender risk profile (conservative, moderate, aggressive)
• Currency preference (XLM, USDC, both)
• Yield requirement (minimum APY)
• Invoice matching algorithm: score = f(risk, currency, yield, history)
• Suggested matches displayed in marketplace
• Match quality indicator (excellent, good, fair)
• Override: lender can still browse all invoices

Technical Details

• Scoring algorithm: weighted sum of match factors
• Risk assessment: invoice age, originator history, amount
• Currency match: exact match vs. conversion cost
• Yield comparison: required vs. available
• ML potential: train on historical offer-acceptance patterns

Acceptance Criteria

• Lender can set preferences
• Matching algorithm produces scores
• Suggested matches displayed
• Match quality shown
• Override to browse all available
• Performance <100ms for 1000 invoices

Related Issues

• Related to: Refresh sitemap.ts and robots.ts for current public routes #135 (competitive auction / best-offer selection helper)
• Related to: ISR/caching for public pages (marketplace, stats, landing) #149 (lender-facing get_lender_positions read helper)

[retkatmun]

Hi Maintainer,

I’m a smart contract and full-stack developer and would love to contribute to this issue. I’m an experienced contributor with hands-on expertise in Rust, Soroban, Cairo, and TypeScript.

I’m passionate about building secure, scalable blockchain solutions, with a strong emphasis on writing clean and maintainable code. Based on the scope of this issue, I’m confident I can deliver a complete solution within 24 hours of assignment.

I’d greatly appreciate the opportunity to contribute and help move this forward.

[grantfox-oss]

🦊 GrantFox — @retkatmun has been assigned to this issue as part of the Third Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #230)
2. Your PR will be reviewed by the Stellar-VaultLink maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

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

@retkatmun's PR #233 was approved and merged by @samjay8.

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

👏 Great work, @retkatmun! Keep contributing to Stellar-VaultLink.