가격 오라클 컨트랙트 API

설명

바이프로스트 네트워크의 주요 장점 중 하나는 바로 네이티브 가격 오라클입니다. 이 오라클은 중앙화 거래소 (CEX)와 다른 네트워크의 탈중앙화 거래소 (DEX)로부터 광범위한 디지털 자산 가격을 제공합니다. 바이프로스트 네트워크는 CCCP (크로스체인 커뮤니케이션 프로토콜)가 지원하는 자산에 대한 가격 오라클을 모든 개발자에게 공개적으로 제공하고 있습니다. 많은 디앱 개발자들이 우리 네트워크를 통해 이러한 이점을 누리기를 바랍니다.

학습 곡선을 최소화하기 위해, 저희 오라클 서비스는 Chainlink와 호환되는 인터페이스를 제공하는 추상화 계층을 포함하고 있습니다. 이러한 설계는 개발자들이 적응하는 데 필요한 시간을 줄여줄 뿐만 아니라, 이미 Chainlink 환경에 익숙한 개발자들에게는 매끄러운 통합을 가능하게 합니다.

다음 섹션에서는 바이프로스트의 가격 오라클을 활용하는 방법에 대해 설명하겠습니다.

가격 피드 컨트랙트

decimals()

특정 자산 (예: ETH의 USD 가격)의 USD 가격 소수점 이하 자릿수를 반환합니다.

Return values

Name	Type	Description
	uint8	특정 자산에 대한 소수점 자릿수 (현재 USD만 지원)

description()

특정 오라클 피더(예: ETH/USD)의 유형을 반환합니다.

Return values

Name	Type	Description
	string	특정 오라클 피더의 유형

version()

특정 오라클 피드 컨트랙트의 버전을 반환합니다.

Return values

Name	Type	Description
	uint256	특정 오라클 피드 컨트랙트의 버전.

getRoundData(_roundId)

이전 라운드의 가격 정보와 해당 업데이트의 타임스탬프를 반환합니다.

Parameters

Name	Type	Description
_roundId	uint8	원하는 가격 정보의 라운드 ID.

Return values

Name	Type	Description
roundId	uint80	라운드 ID.
answer	int256	이 라운드의 가격 정보.
startedAt	uint256	라운드가 시작된 시점의 타임스탬프.
updatedAt	uint256	라운드가 업데이트된 시점의 타임스탬프.
answeredInRound	uint80	답변은 여러 라운드를 거쳐 계산될 수 있습니다.

latestRoundData()

가장 최신 가격 정보와 해당 업데이트의 타임스탬프를 반환합니다.

Return values

Name	Type	Description
roundId	uint80	라운드 ID.
answer	int256	이 라운드의 가격 정보.
startedAt	uint256	라운드가 시작된 시점의 타임스탬프.
updatedAt	uint256	라운드가 업데이트된 시점의 타임스탬프.
answeredInRound	uint80	답변은 여러 라운드를 거쳐 계산될 수 있습니다.

Price Feed Contract Interface

interface IAccessControlledOffchainAggregator {
  function decimals() external view returns (uint8);
  function description() external view returns (string memory);
  function version() external pure 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
  );
}

Price Feed Contract Address

Asset/Fiat Type	Contract Address (mainnet/testnet)
ETH/USD	mainnet: 0x0427d2908E45FAfD65F56a6A6E2095461e70A3d6 testnet: 0x786cA38641bD2eE6f4c9397056F9CF9d9C893eEA
USDC/USD	mainnet: 0x2FFc2e7C4c280eb82A13972cCA30719F9365746F testnet: 0x9Fa06A8f3454b902b4ecdaBB6eBC8F56CC536609
BNB/USD	mainnet: 0x1Eda422B45b279c8C280B510cbf4BDFB671985c0 testnet: 0x590A94102B03b10d4aDF8bfc83aCC556dc9745E5
MATIC/USD	mainnet: 0x59C75485126Ac9a90609E7Fe5D6c513396ED503d testnet: 0x534Fa69E2616444B5DFB940f3a893D8183fEDcD7
BIFI/USD	mainnet: 0xc97D3b8d03ec813b760C8A471F3c8393e4F91506 testnet: 0x42acD3003fA8b870999573071427C64A90146991
BFC/USD	mainnet: 0x77397a130c169702Ff007682630eCAa5caB23791 testnet: 0xEF746B668880f83F06245245017B31523e485Df8
USDT/USD	mainnet: 0xd8653315Dc63128AA8428C6Ae12E50b5E77156AC testnet: 0xfdcC92216E7236E6f0A2033B1d63D3505369945b
DAI/USD	mainnet: 0xF2385A5DDa77fF9731F661aA44f6b4398A97A1cd testnet: 0x4842D3a8c29fABfB971AeD8675262c16b71ef2Dd
WBTC/USD	mainnet: 0xc1596ece7e801125D507f0815e7070Aa97D3645e testnet: 0x1aF3595Ba40EAb3481f19245E5a0F09018e85Aa4
BTCB/USD	mainnet: 0x40c8BB8036351EF29b41ea8AFEbA76ac2d8A96bF testnet: 0x0B2C85312E35829e714Fef01efAD6d2718e3c227

Example: ETH/USD price oracle (testnet)

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

interface IAccessControlledOffchainAggregator {
  function decimals() external view returns (uint8);
  function description() external view returns (string memory);
  function version() external pure 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
  );
}

contract ChainlinkPriceOracle {
    IAccessControlledOffchainAggregator internal priceFeed;

    constructor() {
        // ETH / USD price oracle address (testnet)
        priceFeed = IAccessControlledOffchainAggregator(0x786cA38641bD2eE6f4c9397056F9CF9d9C893eEA);
    }

    function getLatestPrice() public view returns (int) {
        (
            uint80 roundID,
            int price,
            uint startedAt,
            uint timeStamp,
            uint80 answeredInRound
        ) = priceFeed.latestRoundData();
        // for ETH / USD price is scaled up by 10 ** 8
        return price / 1e8;
    }
}