Odczytywanie cen

Znajdź adres kontraktu PriceFeed, połącz się za pomocą interfejsu Chainlink i odczytaj aktualną cenę z właściwą walidacją.

Krok 1: Znajdź adres oracle

Trzy sposoby na znalezienie adresu kontraktu PriceFeed dla danej pary:

• Price Oracle Tracker (najłatwiejszy podczas developmentu): price-oracle-tracker.vercel.app (pokazuje wszystkie wdrożone pary, ceny na żywo, decimals, heartbeat i adresy).

• On-chain przez OracleFactory: wywołaj pairToOracle(string pair). Symbole par muszą być przekazane wielkimi literami (np. "PSG/USDT"): fabryka nie normalizuje danych wejściowych przy odczycie.

• Zbiorowo on-chain przez OracleFactoryReader: wywołaj getActiveOracles(), aby pobrać wszystkie aktywne pary i ich adresy jednym wywołaniem.

interface IOracleFactory {
    function pairToOracle(string memory pair) external view returns (address);
    function getOracleCount() external view returns (uint256);
}

function resolveFeed(address factory, string memory pair)
    external view returns (address)
{
    // Pair symbol must be passed in uppercase (e.g. "PSG/USDT").
    return IOracleFactory(factory).pairToOracle(pair);
}

Krok 2: Połącz się za pomocą interfejsu

Kontrakt PriceFeed implementuje standardowy Chainlink IAggregatorV3Interface, plus rozszerzenia specyficzne dla Chiliz dotyczące stanu zdrowia i statusu pauzy.

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

interface IAggregatorV3Interface {
    function decimals() external view returns (uint8);
    function description() external view returns (string memory);
    function version() external view returns (uint256);

    function getRoundData(uint80 _roundId)
        external view
        returns (
            uint80 roundId,
            int256 answer,
            uint256 startedAt,
            uint256 updatedAt,
            uint80 answeredInRound
        );

    function latestRoundData()
        external view
        returns (
            uint80 roundId,
            int256 answer,
            uint256 startedAt,
            uint256 updatedAt,
            uint80 answeredInRound
        );
}

interface IChilizPriceFeed is IAggregatorV3Interface {
    function paused() external view returns (bool);
    function updateInterval() external view returns (uint256);
    function healthFactor() external view returns (uint80);
    function getHealthStatus()
        external view
        returns (
            uint256 lastUpdateTimestamp,
            uint256 totalRounds,
            uint256 timeSinceLastUpdate,
            bool isHealthy
        );
}

Krok 3: Odczytaj cenę

Feed nie revertuje przy nieaktualnym lub wstrzymanym stanie: jest to celowe. latestRoundData() revertuje z NoDataAvailable(), jeśli jeszcze nie istnieją żadne rundy, ale nie sprawdza, czy feed jest wstrzymany lub nieaktualny. Odpowiada to projektowi Chainlink AggregatorV3Interface: konsumenci są odpowiedzialni za sprawdzenie paused() i getHealthStatus() przed skonsumowaniem ceny. Uwaga: skalarne funkcje pomocnicze (latestAnswer(), latestTimestamp(), getAnswer(), getTimestamp()) zwracają 0 zamiast revertować, gdy nie ma danych. Zobacz Najlepsze praktyki po pełny wzorzec walidacji.

Podstawową funkcją jest latestRoundData(), która zwraca aktualną cenę wraz z metadanymi rundy i znacznikiem czasu.

contract LendingOracleConsumer {
    IChilizPriceFeed public priceFeed;

    constructor(address _feed) {
        priceFeed = IChilizPriceFeed(_feed);
    }

    function getSafePrice() public view returns (uint256 price18) {
        // 1. Check feed is not paused
        require(!priceFeed.paused(), "Feed paused");

        // 2. Read latest data (reverts with NoDataAvailable() if no rounds exist)
        (
            uint80 roundId,
            int256 answer,
            uint256 startedAt,
            uint256 updatedAt,
            uint80 answeredInRound
        ) = priceFeed.latestRoundData();

        // 3. Basic sanity checks
        require(answer > 0, "Invalid price");

        // 4. Optional: use explicit health check for staleness
        (, , , bool isHealthy) = priceFeed.getHealthStatus();
        require(isHealthy, "Stale price");

        // 5. Normalize to 18 decimals for internal math
        uint8 decimals_ = priceFeed.decimals();
        uint256 scale = 10 ** uint256(decimals_);
        price18 = uint256(answer) * 1e18 / scale; // This is the actual price of an asset
    }
}

Jeśli Twój protokół używa natywnych dziesiętnych feedu zamiast normalizacji do 18:

function getRawPriceWithMeta()
    external view
    returns (int256 price, uint8 decimals_, uint256 updatedAt)
{
    require(!priceFeed.paused(), "Feed paused");

    (, int256 answer, , uint256 _updatedAt, ) =
        priceFeed.latestRoundData();
    require(answer > 0, "Invalid price");

    (, , , bool isHealthy) = priceFeed.getHealthStatus();
    require(isHealthy, "Stale price");

    decimals_ = priceFeed.decimals();
    price = answer;
    updatedAt = _updatedAt;
}

Dane historyczne

Oracle przechowuje wszystkie historyczne dane rund on-chain. Każda aktualizacja ceny tworzy nową rundę z rosnącym roundId.

(uint80 roundId, int256 answer, , uint256 updatedAt, ) =
    priceFeed.getRoundData(targetRoundId);

Dodatkowe funkcje pomocnicze widoku udostępniane przez feed Chiliz:

Funkcja	Zwraca
latestAnswer()	Ostatnia cena lub 0, jeśli brak danych
latestTimestamp()	Ostatni updatedAt lub 0, jeśli brak danych
latestRound()	Aktualny identyfikator rundy
getAnswer(uint80 roundId)	Cena dla konkretnej rundy lub 0
getTimestamp(uint80 roundId)	Znacznik czasu dla konkretnej rundy lub 0
getRoundsData(uint80[] roundIds)	Zbiorcza tablica RoundData
roundExists(uint80 roundId)	true, jeśli updatedAt > 0

Zdarzenia

Każdy kontrakt PriceFeed emituje:

• AnswerUpdated(int256 indexed current, uint80 indexed roundId, uint256 updatedAt): emitowane przy każdej aktualizacji ceny. Filtruj według ceny lub rundy.

• NewRound(uint80 indexed roundId, address indexed startedBy, uint256 startedAt): emitowane po rozpoczęciu nowej rundy. Filtruj według rundy lub adresu, który ją rozpoczął.

Funkcje odkrywania (OracleFactoryReader)

Funkcja	Opis
getActiveOracles()	Zwraca wszystkie aktywne pary z ich adresami oracle
getAllOracles()	Zwraca wszystkie oracle, łącznie z nieaktywnymi
getOraclesByPairs(string[] pairs)	Rozwiązuje wiele nazw par na adresy oracle jednym wywołaniem
getOracleHealthStatus(address oracle)	Stan zdrowia dla pojedynczego oracle
getAllOracleHealthStatus()	Stan zdrowia każdego oracle w systemie