Technical Documentation
Technical documentation for the Cross-chain loans
Protocol Overview
Liquidium is a cross-chain lending and borrowing protocol built on the Internet Computer (IC). It enables users to supply and borrow native blockchain assets (BTC, ETH, USDC, USDT, ICP) without holding wrapped tokens from the user's perspective.
Key Technical Features
- Non-custodial Design: Assets managed by decentralized canister vaults
- Share-Based Accounting: Efficient interest accrual without per-user computation
- Dynamic Interest Rates: Aave-style kink model based on pool utilization
- Two-Phase Execution: Atomic state updates with reliable async operations
- Subaccount Architecture: Privacy-preserving deposit and withdrawal flows
System Architecture
The protocol is one Lending Canister plus one pool canister per asset, with a few helper canisters:
Canister | Responsibility |
|---|---|
Lending Canister | Protocol orchestrator: profiles, positions, health factors, prices, liquidations, and pool coordination |
BTC Pool | Bitcoin liquidity: ckBTC deposits, withdrawals, and batched small withdrawals |
ETH, USDC, and USDT Pools | Ethereum asset liquidity as ckETH, ckUSDC, and ckUSDT, with gas fee fronting |
ICP Pool | Native ICP liquidity on the ICP ledger |
Deposit Accounts | Ethereum deposit and repay addresses |
Simple Loans | Accountless Simple Loans |
Identity Anchor | Keeps Internet Identity sign-ins stable for Liquidium |
See Architecture for each canister and Use Liquidium without the app for mainnet canister IDs.