Installation & Setup

Integrating IFÁ Labs price feeds into your EVM smart contracts is straightforward. This guide covers everything you need to get started with the official interface and contract addresses.

1. Install the Official Interface Package

For type-safe development and the latest ABI, install the IFÁ Labs interface via npm:

npm install ifapricefeed-interface

This package provides:

• The complete IIfaPriceFeed interface.

• Struct definitions (e.g., PriceFeed).

• Event and error types.

Usage in Solidity:

import "ifapricefeed-interface/IIfaPriceFeed.sol";

If you're using Remix IDE, you can load the interface directly from npm (via the plugin) or copy-paste from the package on GitHub.

2. Contract Addresses

Use these verified addresses in your contracts:

Network	Contract Address
Base Mainnet	0xA9F17344689C2c2328F94464998db1d3e35B80dC
Base Sepolia Testnet	0xbF2ae81D8Adf3AA22401C4cC4f0116E936e1025b
AssetChain Testnet	0xBAc31e568883774A632275F9c8E7A5Bd117000F7

Example Constant:

IIfaPriceFeed public constant ORACLE = IIfaPriceFeed(0xA9F17344689C2c2328F94464998db1d3e35B80dC); // Base Mainnet

3. Basic Interface Overview

interface IIfaPriceFeed {
    struct PriceFeed {
        int256 price;         // Scaled price value
        int8 decimal;         // Negative exponent (e.g., -18)
        uint256 lastUpdateTime; // Timestamp of last update
    }

    function getAssetInfo(bytes32 assetId) external view returns (PriceFeed memory assetInfo, bool exists);

    // Batch variant (if available in your deployment)
    // function getAssetsInfo(bytes32[] calldata assetIds) external view returns (PriceFeed[] memory infos, bool[] memory exists);
}

You're now ready to read prices securely in your contracts.

Next: Learn how to Read Latest Price with practical examples.