LiYield

LiYield is a cross-chain DeFi ETF + Yield Swap prototype powered by LI.FI Earn and Composer.

Language: English | 中文

What It Does

LiYield combines two layers:

1. An ETF-style vault that mints liYIELD, a share token representing managed exposure to a basket of yield sources
2. A Yield Swap market where liYIELD becomes collateral and traders take views on future realized yield, not spot price direction

The core loop in this repo is:

1. Users deposit assets into LiYieldVault
2. The vault mints liYIELD
3. An off-chain keeper deploys treasury capital into selected Earn targets based on strategy rules
4. The server tracks snapshots, ETF price points, keeper/oracle state, and term lifecycle
5. Users can use liYIELD as collateral in YieldSwapMarket

Key design constraints:

• Users enter through the vault, not by routing to underlying pools themselves
• Capital deployment, valuation, settlement, and rebalancing are orchestrated off-chain
• The derivatives layer trades strategy yield expectations rather than ETF spot direction

Repo Scope

• packages/contracts: LiYieldVault, SettlementIndex, YieldSwapMarket
• packages/server: ETF/strategy registry, snapshots and pricing, keeper/oracle/term schedulers, HTTP API
• apps/web: ETF landing page and Yield Swap UI skeleton

This repository is a demoable and testable prototype, not a production-ready protocol.

Quickstart

Install dependencies:

npm install

Recommended local demo flow:

npm run demo

That command starts anvil, deploys local contracts, boots the server with its default background services, and starts the web app.

If you run:

npm run dev

it only starts server + web. It does not start a local chain or deploy contracts for you.

Docs

• Architecture
• Development
• Contracts
• Testing
• Derivatives Scenario Report

Chinese docs:

• 项目架构
• 开发与运行