地板价保护

地板价是 LFG.RICH V5 中最重要的保护机制之一。对于官方 V5 代币，公开规则很简单：

协议地板价始终基于该代币历史最高价（ATH）的 50%。

ATH 的 50%

地板目标根据代币历史最高价计算，使用 autoFloorPctBps = 5000。

只会上升

ATH 上升时，地板价可以上升。价格回落时，地板价不会下降。

由 Hook 强制执行

创建者不能在发行后手动降低协议地板价。

用于借贷

借款额度基于地板价值，所以更高的地板价可能启用 borrowMore(poolId)。

当代币达到新的历史最高价时，Hook 会记录新的 ATH，并把地板价目标提高到 ATH 的一半。如果之后价格下跌，ATH 不会重置，地板价也不会下调。这意味着地板价不是由创建者、做市商或团队手动控制的。它是由 Uniswap V4 Hook 强制执行的链上协议状态。

核心概念

V5 Hook 会为每个官方代币池跟踪两个重要价格：

数值	含义
`allTimeHighPrice`	该代币达到过的最高有效价格。
`floorPrice`	协议强制执行的最低有效价格。

默认地板价规则是：

floorPrice = allTimeHighPrice 的 50%

用基点表示时，这个比例存储为：

autoFloorPctBps = 5000

因为 10,000 基点 = 100%，所以 5,000 基点 = 50%。

简单示例

事件	有效价格	ATH	地板价
代币启动	0	0	0
第一批买入把价格推到 0.001 BNB	0.001 BNB	0.001 BNB	0.0005 BNB
更多买入把价格推到 0.01 BNB	0.01 BNB	0.01 BNB	0.005 BNB
卖出让价格回落	0.005 BNB	0.01 BNB	0.005 BNB
价格试图继续跌破	最低 0.005 BNB	0.01 BNB	0.005 BNB
新一轮上涨到 0.02 BNB	0.02 BNB	0.02 BNB	0.01 BNB

最重要的一点是：地板价会跟随 ATH 向上提高，但不会跟随价格下跌而降低。

当出现新的 ATH 时会发生什么

交易之后，Hook 可以更新代币的 ATH 和地板价状态。流程如下：

Hook 计算当前有效价格

交易更新 pool 状态后，会检查当前协议价格。

达到新 ATH 时记录下来

如果有效价格高于之前的 allTimeHighPrice，Hook 会存储新的 ATH。

根据 autoFloorPctBps 计算地板目标

V5 默认值是 5000，也就是 50%。

地板提高到 ATH 的 50%

当计算出的地板目标高于当前 floorPrice 时，Hook 会提高地板价。

之后地板不会下降

如果市场价格回落，ATH 和地板价仍然保留。

Hook 会为这些变化发出事件：

event ATHUpdated(bytes32 indexed poolId, uint256 oldATH, uint256 newATH);
event FloorRaised(bytes32 indexed poolId, uint256 oldFloor, uint256 newFloor);

这些事件可用于区块浏览器、索引器、图表和前端动态记录。

为什么地板价不能被手动修改

地板价来自链上池状态，不是代币创建者可以在发射后降低的设置。创建者不能提走流动性，也不能降低地板价来制造传统 LP rug 式崩盘。官方 V5 代币通过协议合约路由，其中 Uniswap V4 Hook 控制定价、地板价执行、储备、费用、抵押、借贷和 Hook 回调。

有效价格和地板价

Hook 暴露有效价格读取函数：

function getEffectivePrice(bytes32 poolId) view returns (uint256);

有效价格是用户和集成方在显示当前协议价格时应使用的价格。它会尊重地板价。卖出可以让联合曲线价格下降，但前端不应把有效价格显示为低于当前 floorPrice。

V5 地板价状态

Hook 按 poolId 暴露完整代币状态：

function tokenStates(bytes32 poolId)
    view
    returns (
        address token,
        address creator,
        uint256 floorPrice,
        uint256 realETH,
        uint256 virtualETH,
        uint256 totalBorrowedETH,
        uint256 collateralSupply,
        uint256 allTimeHighPrice,
        uint256 k,
        uint256 autoFloorPctBps,
        bool initialized
    );

与地板价相关的重要字段：

字段	含义
`floorPrice`	当前协议最低价格。
`allTimeHighPrice`	该代币达到过的最高有效价格。
`autoFloorPctBps`	地板价比例，单位为基点。在 V5 中通常为 `5000`，也就是 ATH 的 50%。
`realETH`	池会计中实际可用的原生 BNB。合约字段仍使用 ETH 风格命名。
`virtualETH`	借贷会计产生的虚拟支撑。
`totalBorrowedETH`	该池当前总借出的原生 BNB。
`collateralSupply`	被锁定为借贷抵押品的代币数量。
`k`	Hook 定价逻辑使用的内部曲线参数。

读取当前地板价

集成方应始终先解析正确的 poolId，然后读取该池的 Hook 状态。

const poolId = token.pool_id || token.poolId || await hook.tokenToPoolId(tokenAddress);

const state = await hook.tokenStates(poolId);
const effectivePrice = await hook.getEffectivePrice(poolId);
const autoFloorPctBps = await hook.getAutoFloorPct(poolId);

console.log({
  floorPrice: state.floorPrice.toString(),
  allTimeHighPrice: state.allTimeHighPrice.toString(),
  autoFloorPctBps: autoFloorPctBps.toString(), // 通常为 5000 = 50%
  effectivePrice: effectivePrice.toString()
});

不要在 V5 中假设只有代币地址就足够读取状态。V5 是基于池路由的。始终解析并使用该代币的 poolId。

偿付能力保护

主要公开规则是 ATH 的 50%。Hook 同时会通过检查有效支撑来防止不可能兑现的地板价状态。关键支撑概念是：

有效支撑 = realETH + virtualETH

Hook 暴露当前池可支持的最高地板价：

function maxFloorPrice(bytes32 poolId) view returns (uint256);

这个安全检查用于确保地板价可以被协议会计承托。它不会给创建者手动控制地板价的权限，也不会允许已经提高的地板价再被降低。

地板价和借贷

借贷基于地板价价值，而不是临时价格尖峰。当用户用代币借款时，Hook 会使用该代币的地板价价值来计算可借额度。这也是为什么地板价机制和借贷系统直接相关：

如果代币达到新的 ATH，地板价可以提高到 ATH 的 50%。
更高的地板价会提高代币抵押品的地板价值。
如果用户已经锁定了抵押品，而之后地板价上升，用户可能可以使用 borrowMore(poolId) 借出新增的可用价值。
如果 ATH 之后市场价格下跌，借款基础不会跟着下跌，因为地板价不会降低。

因此，用户界面应该清楚显示：

显示值	重要原因
当前有效价格	显示当前协议交易价格。
ATH	显示达到过的最高有效价格。
地板价	显示最低强制价格，以及借贷价值的基础。
地板价比例	显示 V5 规则是 ATH 的 50%。

这对用户意味着什么

地板价机制为官方 V5 代币提供了协议内置的下行边界。这意味着：

创建者不能像传统 LP rug 那样移除协议管理的支撑。
当代币创下新的 ATH 时，地板价会上升。
标准 V5 地板价目标是 ATH 的 50%。
一旦地板价提高，就不会再下降。
借贷使用地板价价值，而不是临时市场尖峰。

重要风险提示

地板价保护的是 LFG.RICH V5 合约内部的官方协议定价。用户在交易前仍应理解智能合约风险、链风险、钱包风险、路由风险、索引风险和市场风险。

概览

协议

入门

开发者

资源

ATH 的 50%

只会上升

由 Hook 强制执行

用于借贷

核心概念

简单示例

当出现新的 ATH 时会发生什么

为什么地板价不能被手动修改

有效价格和地板价

V5 地板价状态

读取当前地板价

偿付能力保护

地板价和借贷

这对用户意味着什么

重要风险提示

ATH 的 50%

只会上升

由 Hook 强制执行

用于借贷

​核心概念

​简单示例

​当出现新的 ATH 时会发生什么

​为什么地板价不能被手动修改

​有效价格和地板价

​V5 地板价状态

​读取当前地板价

​偿付能力保护

​地板价和借贷

​这对用户意味着什么

​重要风险提示

核心概念

简单示例

当出现新的 ATH 时会发生什么

为什么地板价不能被手动修改

有效价格和地板价

V5 地板价状态

读取当前地板价

偿付能力保护

地板价和借贷

这对用户意味着什么

重要风险提示