commit

2025-12-18 13:07:35 +08:00
commit 76b7f838db
271 changed files with 88812 additions and 0 deletions
--- a/contracts/ytLending/interfaces/ILending.sol
+++ b/contracts/ytLending/interfaces/ILending.sol
@@ -0,0 +1,177 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+/**
+ * @title ILending
+ * @notice 借贷池核心接口
+ */
+interface ILending {
+    
+    // ========== Events ==========
+    event Supply(address indexed from, address indexed dst, uint256 amount);
+    event Withdraw(address indexed src, address indexed to, uint256 amount);
+    event SupplyCollateral(address indexed from, address indexed dst, address indexed asset, uint256 amount);
+    event WithdrawCollateral(address indexed src, address indexed to, address indexed asset, uint256 amount);
+    
+    /// @notice 清算债务事件
+    event AbsorbDebt(address indexed absorber, address indexed borrower, uint256 basePaidOut, uint256 usdValue);
+    
+    /// @notice 清算抵押品事件
+    event AbsorbCollateral(address indexed absorber, address indexed borrower, address indexed asset, uint256 collateralAbsorbed, uint256 usdValue);
+    
+    event BuyCollateral(address indexed buyer, address indexed asset, uint256 baseAmount, uint256 collateralAmount);
+    
+    /// @notice 储备金提取事件
+    event WithdrawReserves(address indexed to, uint256 amount);
+    
+    // ========== Errors ==========
+    error Unauthorized();
+    error InsufficientBalance();
+    error InsufficientCollateral();
+    error BorrowTooSmall();
+    error NotLiquidatable();
+    error SupplyCapExceeded();
+    error InvalidLiquidationFactor();
+    error InsufficientReserves();
+    
+    // ========== Core Functions ==========
+    
+    /**
+     * @notice 存入基础资产
+     * @param amount 存入金额
+     */
+    function supply(uint256 amount) external;
+    
+    /**
+     * @notice 取出基础资产
+     * @param amount 取出金额
+     */
+    function withdraw(uint256 amount) external;
+    
+    /**
+     * @notice 存入抵押品
+     * @param asset 抵押品地址
+     * @param amount 抵押品数量
+     */
+    function supplyCollateral(address asset, uint256 amount) external;
+    
+    /**
+     * @notice 取出抵押品
+     * @param asset 抵押品地址
+     * @param amount 抵押品数量
+     */
+    function withdrawCollateral(address asset, uint256 amount) external;
+    
+    /**
+     * @notice 借款（通过取出超过存款的基础资产实现）
+     * @param amount 借款金额
+     */
+    function borrow(uint256 amount) external;
+    
+    /**
+     * @notice 清算不良债务（单个）
+     * @param borrower 待清算的借款人地址
+     */
+    function absorb(address borrower) external;
+    
+    /**
+     * @notice 批量清算不良债务
+     * @param absorber 清算发起人地址
+     * @param accounts 待清算的借款人地址数组
+     */
+    function absorbMultiple(address absorber, address[] calldata accounts) external;
+    
+    /**
+     * @notice 购买清算后的抵押品
+     * @param asset 抵押品地址
+     * @param minAmount 最小购买量
+     * @param baseAmount 支付的基础资产数量
+     * @param recipient 接收抵押品的地址
+     */
+    function buyCollateral(address asset, uint256 minAmount, uint256 baseAmount, address recipient) external;
+    
+    // ========== View Functions ==========
+    
+    /**
+     * @notice 获取用户基础资产余额
+     * @param account 用户地址
+     * @return 余额（正数=存款，负数=借款）
+     */
+    function getBalance(address account) external view returns (int256);
+    
+    /**
+     * @notice 获取用户抵押品余额
+     * @param account 用户地址
+     * @param asset 抵押品地址
+     * @return 抵押品数量
+     */
+    function getCollateral(address account, address asset) external view returns (uint256);
+    
+    /**
+     * @notice 检查账户是否可被清算
+     * @param account 用户地址
+     * @return 是否可清算
+     */
+    function isLiquidatable(address account) external view returns (bool);
+    
+    /**
+     * @notice 获取当前供应利率
+     * @return 供应利率 (年化，scaled by 1e18)
+     */
+    function getSupplyRate() external view returns (uint64);
+    
+    /**
+     * @notice 获取当前借款利率
+     * @return 借款利率 (年化，scaled by 1e18)
+     */
+    function getBorrowRate() external view returns (uint64);
+    
+    /**
+     * @notice 获取用户存款余额（只返回正数部分，ERC20兼容）
+     * @param account 用户地址
+     * @return 存款余额
+     */
+    function balanceOf(address account) external view returns (uint256);
+    
+    /**
+     * @notice 获取用户借款余额（只返回债务部分）
+     * @param account 用户地址
+     * @return 借款余额
+     */
+    function borrowBalanceOf(address account) external view returns (uint256);
+    
+    /**
+     * @notice 计算支付指定baseAmount可购买的抵押品数量
+     * @param asset 抵押品地址
+     * @param baseAmount 支付的基础资产数量
+     * @return 可购买的抵押品数量
+     */
+    function quoteCollateral(address asset, uint256 baseAmount) external view returns (uint256);
+    
+    /**
+     * @notice 获取协议储备金
+     * @return 储备金余额（可能为负）
+     */
+    function getReserves() external view returns (int256);
+    
+    /**
+     * @notice 获取抵押品库存
+     * @param asset 抵押品地址
+     * @return 库存数量
+     */
+    function getCollateralReserves(address asset) external view returns (uint256);
+    
+    /**
+     * @notice 获取市场利用率
+     * @return 利用率（scaled by 1e18）
+     */
+    function getUtilization() external view returns (uint256);
+    
+    /**
+     * @notice 提取协议储备金（仅 owner）
+     * @param to 接收地址
+     * @param amount 提取数量
+     */
+    function withdrawReserves(address to, uint256 amount) external;
+}
+