[GF-17] [FRONTEND] Informational & Trust Pages (/learn, /faq, /audit, /contracts, /roadmap)

[wumibals]

Overview

This issue is independent — it has no dependency on contracts, the SDK, or live data. It can be worked in parallel with any other issue.

Build five static informational pages that establish protocol trust and help users understand how YieldLadder works. These pages are standard on every comparable DeFi protocol and are essential before real users deposit funds.

Problem

Beyond the landing page's short How It Works section, no educational or trust content exists in the app. There is no:

• Detailed mechanics explanation for users who want to understand before depositing
• FAQ for common questions
• Audit page (the internal audit report exists only in audit/internal-2026-01.md — it is invisible to users)
• Contracts page with verifiable on-chain addresses
• Roadmap

Proposed Solution

/learn

A detailed educational page covering:

• How vaults work: deposit flow, share-unit minting, lock mechanics, withdrawal at maturity
• Share-unit explainer with worked example: 100 USDC into L12 = 140 shares. At harvest, 140 shares receives a larger slice of yield than 100 shares in Flex.
• Yield source: how Stellar AMM trading fees work, why USDC/XLM is a valid source, why this is genuinely on-chain
• Harvesting: what it is, who can do it, why the 10 bps bounty exists
• Early exit mechanics: how the fee is calculated and where it goes

/faq

Answers to the most common user questions, structured in expandable accordion sections:

• Can I have multiple positions in the same tier?
• What happens to my deposit if the protocol is abandoned?
• How is yield taxed? (General answer: consult a tax professional; this is not financial advice)
• Which wallets are supported?
• What is the minimum deposit for each tier?
• Can I add to an existing position?
• Is YieldLadder audited?
• What does non-custodial and immutable actually mean?

/audit

• Summary of the internal security review (Jan 2026): 5 findings, all resolved
• Link to audit/internal-2026-01.md (or render its content inline)
• External audit status: Engaged — Q2 2026, firm name when available
• Formal verification status: In progress
• Link to bug bounty program (security/bounty.md content, or render inline)

/contracts

A table of all deployed contract addresses with:

• Contract name and purpose
• Testnet address (linked to Stellar Expert testnet explorer)
• Mainnet address (linked to Stellar Expert mainnet explorer, or Pending audit if not deployed)
• Network selector toggle (mainnet / testnet)

/roadmap

Three-column layout: Shipped, In Progress, Planned

• Shipped: repo scaffold, internal audit, landing page, dashboard scaffold
• In Progress: contract implementations (GF-01 to GF-07), TypeScript SDK (GF-08)
• Planned: mainnet deployment, external audit completion, mobile app

Acceptance Criteria

• All five pages exist and are linked from the footer
• /learn includes a worked share-unit example with real numbers
• /faq uses an accordion/expandable pattern (not a wall of text)
• /audit surfaces the internal audit findings and their resolution status
• /contracts table shows testnet addresses with working Stellar Expert explorer links
• /roadmap reflects the current state of the project accurately
• All pages are responsive and match the existing dark-theme design system