Add web frontend for vault-strategy Solana program

[mikemaccana]

Summary

This PR adds a complete web frontend for the vault-strategy Solana program—an educational demo of a manager-run investment vault. The app is built with Vite + React + TypeScript + Tailwind and provides both investor and manager interfaces for interacting with the on-chain vault.

Key Changes

• IDL and Type Definitions: Added the complete Anchor IDL (vault_strategy.json) and generated TypeScript types for program accounts and instructions
• Core Hooks: Implemented useVault hook that manages strategy state, position tracking, and exposes both depositor actions (deposit/redeem) and manager actions (rebalance, set weights, add assets, collect fees)
• Instruction Building: Created instructions.ts with builders for all program interactions (deposit, withdraw, rebalance, add asset, approve asset, initialize strategy, etc.)
• Strategy State Management: Implemented strategy.ts for loading and computing strategy views, including NAV calculations, asset pricing via Pyth oracles, and position tracking
• Investor UI: Built InvestorView with deposit/redeem ticket, allocation visualization, and portfolio metrics
• Manager UI: Built ManagerView with panels for rebalancing, weight adjustments, asset management, and fee collection
• Utility Libraries: Added helpers for amount parsing, formatting (USDC, shares, basis points), transaction error handling, and Pyth price feed parsing
• Configuration: Set up environment-based config for RPC endpoints and program IDs, with sensible devnet defaults
• Styling: Implemented dark-mode Tailwind theme with semantic colors (accent amber, gain/loss green/red) and a curated asset palette
• Verification Script: Added offline verification script (verify-client.mjs) that validates discriminators, PDAs, and instruction encoding against the IDL

Notable Implementation Details

• Live Account Reads: Every number on screen is a real on-chain account read; no cached state beyond the current render cycle
• NAV Calculation: Computes net asset value by reading Pyth price feeds directly from account bytes (matching the program's oracle parsing) and detecting stale prices
• Tolerance-Based Slippage: Deposit and redeem operations apply configurable tolerance floors to protect users from sandwich attacks
• PDA Derivation: All PDAs (strategy, share mint, asset vaults, etc.) are derived client-side and verified against on-chain accounts
• Swap Router Integration: Deposit instruction chains through the swap router program to convert USDC into target assets
• Manager-Only Actions: Rebalance, weight adjustment, and asset addition are gated to the strategy manager via account relations

https://claude.ai/code/session_01GCy1icrZWHGqyWRCYqYJmf

[mikemaccana]

Supersedes #115 — same frontend, with the CI failures fixed and the IDL regenerated.

• Biome CI is green (was 54 errors). Reformatted to the repo's config (double quotes, semicolons, sorted imports), added type="button" to three non-submit buttons, and suppressed two rules with explanations: the intentional tick refresh dependency in useVault.ts, and the Tailwind v3 directives in index.css.
• Fixed scripts/verify-client.mjs, which failed on a clean install. @coral-xyz/anchor is CJS, and under Node ESM interop BN only exists on the default export — so the PR's own verification gate died with BN is not a constructor on 5 of 13 checks. It passes everywhere now.
• Replaced the hand-written IDL with anchor idl build output. Generated with anchor-cli 1.1.2 (the version CI installs). I diffed the two first: discriminators, account orders, writable/signer flags, and args were all identical, so this is a safe swap that additionally gains PDA seed derivations, has_one relations, known program addresses, and doc strings from the Rust source.
• Stopped committing build artifacts (vite.config.js, vite.config.d.ts, *.tsbuildinfo) and gitignored them. The compiled vite.config.js was the risky one: Vite resolves .js config ahead of .ts, so a stale copy would have silently shadowed edits to vite.config.ts. tsc -b now emits to node_modules/.tmp.
• Docs updated to match: the "Why the IDL is hand-authored" section is now "Where the IDL comes from", with the regeneration command.

pnpm verify, pnpm typecheck, pnpm build, and repo-wide biome check all pass.

---

Generated by Claude Code