清算逻辑 (服务)

本页说明平台服务如何判定可清算仓位，以及如何执行或支持清算：批处理流程、资格检查、风险控制，以及与清算合约的交互。

输入与依赖

• 执行上下文 — 链、运行配置、待处理的市场列表。

• 市场数据 — 抵押品/借款资产、预言机、市场参数（LLTV 等）。

• 风险配置 — 资格规则、最小规模阈值、延迟规则、稳定资产处理方式。

• 价格与状态 — 预言机价格、市场状态、用于去重的近期处理状态 / 缓存。

资格判定

• 条件 — 当某仓位在其所属市场满足 LTV > LLTV 时可被清算（LLTV 取自市场参数）。等价表述为：清算触发价格 > 当前市场价格（触发价格即该仓位变为可清算时的抵押品/借款资产价格比）。

• LTV — LTV = (借款量 × 借款资产预言机价格) / (抵押品数量 × 抵押品预言机价格)，并采用合约的精度缩放（例如 1e36）。

• 数据 — 使用与合约一致的预言机与市场参数；在执行时重新获取预言机与仓位状态，以避免数据陈旧或被抢跑。

批处理流程

1. 运行准备 — 校验运行环境与市场列表。

2. 扫描 — 查询 borrowedAmount > 0 的仓位（例如从 MoolahUserPosition 获取）。

3. 风险识别 — 针对每个仓位所属市场获取当前价格；计算清算触发价格并与当前市场价格比较；保留触发价格 > 当前价格的仓位。

4. 延迟与阈值 — 应用可配置的延迟与最小规模过滤（见下方风险控制）。

5. 执行 — 对每个符合条件的仓位选择清算路径（主 Liquidator 或预清算合约）并执行；根据已偿还金额与 LIF 计算应扣押的抵押品。

6. 结果与去重 — 记录结果；进行短期去重，使同一仓位在配置的时间窗口内不会被重复处理。

风险控制

• 价格有效性 — 跳过价格缺失或异常的市场，避免误清算。

• 延迟 — 对特定仓位可选择延迟处理，以降低波动带来的误判。

• 规模阈值 — 对低于最小规模（例如 gas 或经济性阈值）的仓位不触发清算。

• 去重 — 处理完一个仓位后进行标记（例如写入缓存），使其在短时间内不会被重复提交。

可观测性

• 日志应覆盖：批次运行、逐市场处理、逐仓位资格判定，以及结果（已执行 / 已跳过 / 原因）。

• 输出：处理数量、耗时、跳过原因（例如价格无效、低于阈值、去重）。

合约侧公式（参考）

服务侧的资格判定应与合约的健康度逻辑保持一致。抽象公式如下：

• 无债务 — isHealthy = true。

• 借款量 — 标准市场：borrowed = convertBorrowSharesToAssets(shares, totalBorrowAssets, totalBorrowShares)。经纪人市场：borrowed = getBrokerTotalDebt(borrower, market)。

• 最大可借 — maxBorrow = collateral × price × lltv（price 为抵押品/借款资产的相对价格）。

• 健康度 — isHealthy = (maxBorrow ≥ borrowed)。

• 风险仓位 — isRisky = ¬isHealthy；这些即为清算候选（仍需通过上述服务侧风险控制）。

实现要点

• 舍入 — 与合约的舍入方式保持一致（对用户金额通常向下舍入），避免资格判定出现 off-by-one。

• Gas / 批处理 — 清算通常由 keeper bot 执行；服务可以只提供可清算列表 API（例如 GET /api/moolah/liquidation/liquidatable）与历史记录。

• 预清算 — 当某市场使用外部预清算合约时，识别处于 preLLTV ≤ LTV < LLTV 区间的仓位，并在适用情况下将调用方路由至该合约。

关于产品层面的清算说明与示例，请参见清算。