How seyfert-labs/seyf-p works
SEYF is a Spanish-language savings app on Stellar: users sign in with Pollar, establish a sponsored USDC-capable account, save through a DeFindex vault, and may borrow against future vault yield through the Soroban advance contract. The repository also includes Etherfuse KYC/onramp flows and exchange/conversion functionality. README statements support the principal transaction flow; sampled imports support selected internal calls. Most API route implementations and contract entrypoints were not sampled, so broader links are documented relationships rather than claims about unseen code.
Main entry points: client-api.ts Pollar wallet · lib.rs Advance contract · page.tsx App screens · route.ts Conversion route
Components 26
Savings app
- App screens
src/app/app/page.tsx - App data
src/components/app/data.ts - Retiro context
src/components/app/RetiroContext.tsx
Identity and wallet
- Pollar wallet
src/lib/pollar/client-api.ts - Pollar service
- SEP-10 auth
src/app/api/auth/sep10/route.ts - SEP-10 client
src/lib/stellar/sep10-client.ts - Sponsored account
src/app/api/stellar/sponsor
Stellar savings
- Stellar network
src/lib/stellar/network.ts - Vault management
src/hooks/useStellarVaults.ts - DeFindex routes
src/app/api/defindex - DeFindex vault
- Blend pool
Yield advance
- Advance experience
src/hooks/useAdvance.ts - Advance routes
src/app/api/advance - Advance contract
soroban/seyf_advance/src/lib.rs - Contract storage
soroban/seyf_advance/src/storage.rs
Financial integrations
- Etherfuse KYC
src/app/api/seyf/kyc/submit/route.ts - Etherfuse service
src/lib/etherfuse/client.ts - Deposit webhook
src/app/api/webhooks/etherfuse/route.ts - Supabase metadata
src/lib/supabase/db.ts - Conversion route
src/app/api/convert/route.ts - Bitso exchange
- Juno payments
Other components
- Saver
- Keeper
Connections 29
- Saver → App screens: uses
README.md - App screens → Pollar wallet: signs in
- Pollar wallet → Pollar service: creates wallet
README.md - Pollar wallet → SEP-10 auth: authenticates
- SEP-10 auth → SEP-10 client: uses
src/app/api/auth/sep10/route.ts - SEP-10 client → Pollar service: requests signing
src/lib/stellar/sep10-client.ts - App screens → Retiro context: reads state
- Retiro context → Stellar network: resolves network
src/components/app/RetiroContext.tsx - Pollar wallet → Sponsored account: signs transactions
README.md - Sponsored account → Stellar network: submits fee-bump
README.md - App data → Supabase metadata: stores metadata
src/components/app/data.ts - Vault management → DeFindex routes: requests positions
src/hooks/useStellarVaults.ts - DeFindex routes → DeFindex vault: builds vault transactions
README.md - DeFindex vault → Blend pool: supplies assets
README.md - Pollar wallet → DeFindex vault: deposits USDC
README.md - App screens → Advance experience: opens advance
- Advance experience → Advance routes: requests quote
- Advance routes → Advance contract: builds transactions
README.md - Advance contract → Contract storage: reads and writes
- Advance contract → DeFindex vault: locks vault shares
README.md - Advance contract → Pollar wallet: pays advance
README.md - Keeper → Advance contract: settles advances
README.md - Saver → Etherfuse KYC: submits KYC
- Etherfuse KYC → Etherfuse service: submits identity
src/app/api/seyf/kyc/submit/route.ts - Deposit webhook → Supabase metadata: updates KYC state
src/app/api/webhooks/etherfuse/route.ts - Deposit webhook → Etherfuse service: checks order details
src/app/api/webhooks/etherfuse/route.ts - Conversion route → Supabase metadata: reserves ledger entry
src/app/api/convert/route.ts - Conversion route → Bitso exchange: places order
src/app/api/convert/route.ts - Conversion route → Juno payments: issues MXNB
src/app/api/convert/route.ts