Lux Skills Reference
Lux Liquid - DeFi Lending and Yield Protocol Documentation for Lux Liquid - DeFi Lending and Yield Protocol
Lux Liquid is a DeFi lending protocol built on the Alchemist V3 architecture. It allows users to deposit yield-bearing collateral, borrow self-repaying synthetic assets, and earn yield through automated strategy allocation. The codebase is a Foundry-based Solidity project with Echidna and Medusa fuzz testing, Slither static analysis, and Docusaurus documentation.
Deploying or modifying DeFi lending/borrowing contracts on Lux, Ethereum, or EVM-compatible chains
Integrating yield strategies (eETH, wstETH, sfrxETH, Morpho, Peapods, Tokemak)
Building on the Alchemist V3 protocol or Transmuter
Running fuzz testing with Echidna or Medusa on Solidity contracts
Item Value Repo github.com/luxfi/liquidLanguage Solidity 0.8.28 Build system Foundry (forge) EVM version Cancun Optimizer via-ir, 800 runs License MIT Default branch main Node version See .nvmrc
liquid/ src/ AlchemistV3.sol # Core lending engine (51KB) AlchemistAllocator.sol # Strategy allocation AlchemistCurator.sol # Strategy curation and risk AlchemistETHVault.sol # ETH vault wrapper AlchemistTokenVault.sol # ERC20 vault wrapper AlchemistGate.sol # Access control gate AlchemistStrategyClassifier.sol # Strategy risk classification AlchemistV3Position.sol # NFT position tracking MYTStrategy.sol # Managed Yield Token strategy PerpetualGauge.sol # Perpetual reward gauge Transmuter.sol # Synthetic-to-underlying conversion adapters/ # Token adapter implementations base/ # Base contracts external/ # External protocol interfaces governance/ # Governance contracts interfaces/ # All contract interfaces (20+ files) libraries/ # Shared libraries mocks/ # Test mocks strategies/ # Yield strategy implementations EETH.sol # EtherFi eETH WstethMainnet.sol # Lido wstETH SfrxETH.sol # Frax sfrxETH MorphoYearnOGWETH.sol # Morpho + Yearn WETH PeapodsETH.sol # Peapods ETH TokeAutoEth.sol # Tokemak autoETH test/ # Forge test suite utils/ # Utility contracts script/ DeployLux.s.sol # Lux Network deployment script Counter.s.sol # Example script util/ # Script utilities docs/ # Docusaurus documentation site lib/ # Git submodule dependencies echidna.yaml # Echidna fuzz testing config medusa.json # Medusa fuzz testing config slither.config.json # Slither static analysis config foundry.toml # Foundry configuration remappings.txt # Solidity import remappings Submodule Purpose forge-stdFoundry test framework openzeppelin-contractsERC20, access control, upgrades openzeppelin-contracts-upgradeableUpgradeable contract patterns solmateGas-optimized ERC20/ERC721 chainlink-brownie-contractsChainlink price feeds permit2Uniswap Permit2 approvals halmos-cheatcodesa16z symbolic testing vault-v2Morpho vault integration
git clone https://github.com/luxfi/liquid.git cd liquid forge install forge build forge test Network RPC Lux Mainnet https://api.lux.network/ext/bc/C/rpcLux Testnet https://api.testnet.lux.network/ext/bc/C/rpcZoo Mainnet https://api.zoo.network/ext/bc/Zoo/rpcHanzo Mainnet https://api.hanzo.network/ext/bc/Hanzo/rpcEthereum Mainnet via MAINNET_API_KEY env Ethereum Sepolia via SEPOLIA_API_KEY env
Contract Purpose AlchemistV3Core protocol: deposits, borrows, liquidations, yield distribution TransmuterConverts synthetic tokens to underlying at 1:1 AlchemistV3PositionERC721 NFT representing user positions AlchemistCuratorStrategy whitelist and risk management AlchemistAllocatorAutomated capital allocation across strategies PerpetualGaugeContinuous reward distribution MYTStrategyManaged Yield Token strategy base
Tool Config file Purpose Echidna echidna.yamlProperty-based fuzz testing (50K iterations, 4 workers) Medusa medusa.jsonAlternative fuzzer Slither slither.config.jsonStatic analysis Halmos via halmos-cheatcodes Symbolic execution Pre-commit .pre-commit-config.yamlFormat + doc generation
# Build forge build # Test forge test # Test with intense fuzzing FOUNDRY_PROFILE = intense forge test # Coverage forge coverage # Deploy to Lux forge script script/DeployLux.s.sol --broadcast --rpc-url lux_mainnet --verify # Generate docs forge doc Variable Purpose MAINNET_API_KEYEthereum mainnet RPC URL SEPOLIA_API_KEYEthereum Sepolia RPC URL ETHERSCAN_API_KEYEtherscan contract verification LUX_EXPLORER_API_KEYLux explorer contract verification ZOO_EXPLORER_API_KEYZoo explorer contract verification HANZO_EXPLORER_API_KEYHanzo explorer contract verification
lux/lux-evm.md -- EVM execution layer where contracts runlux/lux-dex.md -- DEX integration for swapslux/lux-governance.md -- On-chain governance