LitVM Yield Vault

LTC-native yield vault on the LitVM testnet. Deposit wrapped zkLTC or VRT, earn VRT rewards automatically.

Contracts

Contract	Address	Description
WzkLTC	0x323D1aB76a9e2AA63cda313A0709A7891cbEcc67	Wrapped zkLTC (WETH pattern)
VaultRewardToken	0x62bf26Aa2eA6F24Edd94bd427F27cc01f37f9Ff4	VRT, 100M supply, fixed
TokenFaucet	0x8E6804e22e89d16b4219c7b16F29693044141Ab3	10 VRT per 24h per address
SimpleYieldStrategy	0xB60D2cAc0BC5334e706391ee2Da5B513a0d704e6	WzkLTC yield, reward-per-share
LTCYieldVault	0x6522245155A9EfAAb6686d22d4d46D906FB27A32	ERC-4626 vault for WzkLTC
VRT Staking Strategy	0xDB8cd0192583DA12749b4da69145e3EE472DFe8A	VRT staking yield
VRT Staking Vault	0x13C356A55B72eca7653aA6B0BB4f42f272fA5eE5	ERC-4626 vault for VRT

Network

• Chain: LitVM LiteForge Testnet
• Chain ID: 4441
• RPC: https://liteforge.rpc.caldera.xyz/http
• Explorer: https://liteforge.explorer.caldera.xyz
• Gas token: zkLTC

How It Works

1. Wrap native zkLTC to WzkLTC (ERC-20)
2. Deposit WzkLTC into the LTC Yield Vault, receive lyvzkLTC shares
3. Earn VRT rewards accrued by the strategy (reward-per-share model)
4. Claim rewards via harvest, or withdraw to collect principal + rewards
5. Faucet: claim 10 free VRT every 24 hours
6. Stake VRT in the VRT Staking Vault, earn bonus VRT

Security

• ReentrancyGuard on all state-changing functions
• Pausable vault (owner only)
• SafeERC20 for all token transfers
• Zero-address checks in constructors
• Strategy migration pulls all funds before switching
• Faucet rate-limited (1 claim / 24h / address)

Project Structure

contracts/
  src/              Solidity source (6 contracts)
  scripts/          Hardhat deployment scripts
  test/             Foundry test suite
  hardhat.config.js Hardhat configuration
  package.json      Node dependencies
frontend/
  index.html        Single-page dApp
  app.js            Contract interaction logic
  style.css         Styling
  logo.png          Project logo
  netlify.toml      Deploy config

Local Development

Prerequisites

• Node.js 18+
• MetaMask or compatible wallet
• zkLTC from LitVM faucet

Contracts

cd contracts
npm install
npx hardhat compile
npx hardhat test

Frontend

Serve the frontend/ directory with any static file server:

cd frontend
npx serve .

Then open the URL and connect your wallet to LitVM testnet (Chain ID 4441).

Deploying Contracts

1. Copy .env.example to .env and add your private key
2. Fund your deployer wallet with zkLTC
3. Run deployment:

npx hardhat run scripts/deploy.js --network litvm_testnet
npx hardhat run scripts/deploy-vrt.js --network litvm_testnet

License

MIT