feat(frontend): invoice securitization and fractional ownership UI

[samjay8]

Summary

Build the UI for invoice securitization: allow invoice owners to fractionalize invoices into position tokens that can be traded, and allow investors to purchase fractions.

Problem

Currently invoices are binary (owned or not). Fractional ownership enables smaller investors to participate and increases liquidity.

Requirements

• Fractionalization wizard: split invoice into N position tokens
• Token pricing: total_value / N
• Purchase flow: select fraction, sign transaction
• Portfolio view: show fractional positions
• Secondary market: list position tokens for sale
• Price history chart for position tokens
• Dividend distribution tracking

Technical Details

• Position tokens are SEP-41 tokens (Task 7)
• Token metadata: { name, symbol, decimals, total_supply }
• Purchase via transfer() call on position token contract
• Price history from on-chain transaction history

Acceptance Criteria

• Fractionalization wizard works
• Purchase flow completes
• Portfolio shows fractional positions
• Secondary market listing works
• Price history displayed
• Dividends tracked

Related Issues

• Related to: Escrow Contract for Invoice Financing #7 (position token minting on accept_offer)
• Related to: Yield Rate Oracle #8 (position token transfer/resale)

[augustinemartins]

Hi Team,

I am writing to apply for the feature task: feat(frontend): invoice securitization and fractional ownership UI.

Bringing real-world asset (RWA) tokenization into DeFi requires an interface that balances complex financial transparency with intuitive, frictionless user experience. Invoice securitization and fractional yield participation involve real-time risk parameters, dynamic yield calculations, fractional token minting/purchasing, and state-aware wallet interactions. A clunky UI in this domain directly undermines user confidence when allocating capital to fractionalized assets.

I will build a clean, responsive, and precision-engineered frontend interface for the invoice securitization workflow and fractional investment portal.

[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 #231)
2. Your PR will be reviewed by the Stellar-VaultLink maintainers

Good luck! Track your progress on GrantFox.

[retkatmun]

Implementation complete ✅

PR: #238

All acceptance criteria met:

• Fractionalization wizard (3-step: configure → review → done)
• Purchase flow with cost breakdown and SEP-41 transfer guidance
• Portfolio fractional positions view with value + dividend stats
• Secondary market listing via existing /marketplace/positions
• Price history SVG sparkline (no external chart library)
• Dividend tracking table + originator distribution form

New routes: /securitize/[invoiceId], /marketplace/fractions, /portfolio/fractions
New Supabase migration: 002_securitization.sql (4 tables, RLS)

cc @samjay8