T21 · Oracle

uint256 collateralValue = amount * getPrice(token) / 1e18;

function getPrice(address token) public view returns (uint256) {
    (uint256 r0, uint256 r1) = pair.getReserves();
    return r1 * 1e18 / r0;     // 这一行值多少钱？
}

预言机安全边际 = 操纵这个价格源的成本 / 攻击者能因此提走的最大金额

小于 1  →  这个配置迟早会被攻击，只是时间问题
接近 1  →  行情波动或 Gas 变化就可能让它翻过去
远大于 1 →  暂时安全，但分子分母都会随时间变化

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

interface IPriceSource {
    // 返回：价格、这个价格的产生时间
    function latest() external view returns (int256 price, uint256 updatedAt);
}

contract PriceGuard {
    IPriceSource public source;
    uint256 public maxStaleness;   // 允许的最大陈旧时间，通常设为 heartbeat 的若干倍
    uint256 public minPrice;       // 合理区间下界
    uint256 public maxPrice;       // 合理区间上界
    uint256 public maxJumpPercent; // 相对上次可信价格允许的最大跳变，百分比

    uint256 private lastGoodPrice;
    uint256 private lastGoodAt;

    error StalePrice(uint256 age);
    error PriceOutOfRange(uint256 price);
    error PriceJump(uint256 from, uint256 to);

    function readPrice() public view returns (uint256) {
        (int256 raw, uint256 updatedAt) = source.latest();

        // 检查一：不能是零或负数
        if (raw <= 0) revert PriceOutOfRange(0);
        uint256 price = uint256(raw);

        // 检查二：不能过期
        uint256 age = block.timestamp - updatedAt;
        if (age > maxStaleness) revert StalePrice(age);

        // 检查三：不能贴在聚合层的边界上
        if (price <= minPrice || price >= maxPrice) revert PriceOutOfRange(price);

        // 检查四：相对上一次可信价格的跳变不能超过阈值
        if (lastGoodPrice > 0) {
            uint256 hi = price > lastGoodPrice ? price : lastGoodPrice;
            uint256 lo = price > lastGoodPrice ? lastGoodPrice : price;
            if ((hi - lo) * 100 > lo * maxJumpPercent) revert PriceJump(lastGoodPrice, price);
        }

        return price;
    }
}