SVEP

### 🧠 Project Name

Stable Vesting & Execution Protocol (SVEP)

### 🔍 Description

SVEP combines dollar-denominated token vesting with market-aware TWAP/VWAP execution to protect recipients from volatility and minimize issuer market impact. It runs streaming logic on HyperEVM and references LiquidSwap for pricing and execution context. The codebase includes a public UI, scripts, and documentation designed for reuse.

### 🛠️ How It Works

- Vesting Layer (HyperEVM)

  - Linear time-based distribution, optional cliffs, future edits/cancelation, multiple streams per recipient, native/ERC-20 support.

  - Emits key events (StreamCreated/Updated/Canceled/Withdrawn) for off-chain notifications.

  - Implementation: `contract/src/SVEPVesting.sol`, scripts: `scripts/*.js`, UI: `web/`.

  - Open-source, reusable tooling intended to benefit builders (Public Goods).

  - Fully satisfies hackathon vesting requirements within the product UX (Token Vesting System).

- Execution / Hedging / Pricing Layer 

  - Uses LiquidSwap `GET /v2/route` and `GET /pools` as primary/auxiliary price sources; determines per-slice distribution, naturally approximating TWAP, with optional DEX-weighted VWAP/hybrids.

  - Market-aware: pauses/shrinks when spreads widen or liquidity thins; enforces max slippage.

  - Privacy-preserving execution: randomized timing and sizes, wallet rotation, private submission paths.

  - User inputs: total size, time window, max slippage, privacy level; Reports: fills, reference prices, slippage, tracking error.

  - Showcases advanced LiquidSwap integration and composability within protocol logic (Best Use of Liquid Labs).

  - Implements shielded TWAP with strategy hooks and hybrid TWAP/VWAP pacing (Shielded TWAP Order Executor).

- UI/UX (MVP)

  - Wallet connect with Privy (embedded/session-ready architecture), React + Vite, viem/wagmi.

  - Stream creation form, timeline/progress, execution parameter controls, and performance reports.

  - Practical, reusable UX patterns for builders and users (Public Goods, Privy).

- Infra / Connectivity

  - Operates over Alchemy RPC via `.env` `RPC_URL` and can migrate to HyperEVM RPC/WS easily.

  - Leaves room for smart wallets/session signers and policy-based flows (Best use of Alchemy, Privy).

### 💻 Demo

- Video: https://vimeo.com/1110823023?share=copy

- Live demo: https://svep-mvp.vercel.app

- Suggested flow: create stream → observe progress → update price → recipient withdraw; set TWAP → sliced execution → show report.

### 📂 Project Links

- Code (GitHub): https://github.com/aki-0517/svep-mvp