Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ifalabs.com/llms.txt

Use this file to discover all available pages before exploring further.

IFÁ Labs provides dedicated on-chain price feeds for a curated set of stablecoins, prioritizing both global liquidity assets and local stablecoins critical to emerging economies. All feeds are USD-denominated and use consistent asset IDs across every supported network.

Current Price Feeds

AssetDescriptionCategoryAsset ID (bytes32)
USDT/USDTetherGlobal0x6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d
USDC/USDUSD CoinGlobal0xf989296bde68043d307a2bc0e59de3445defc5f292eb390b80d78162c8a6b13d
CNGN/USDNigerian Naira StablecoinEmerging Market0x83a18c73cf75a028a24b79cbedb3b8d8ba363b748a3210ddbcaa95eec3b87b3a
ZARP/USDSouth African Rand StablecoinEmerging Market0x12373a3b1c4827c84bf6d7b11df100442695d0abfdb7a20d30a41d67d58e75a8
BRZ/USDBrazilian Real StablecoinEmerging Market0xbc60b55b031dce1ee5679098bf2f35d66a94a566124e2b233324d2bafcc6d5b5
ETH/USDEthereumReference Asset0x8c3fb07cab369fe230ca4e45d095f796c4c1a30131f1799766d4fec5ee1325c0
ETH/USD is included as a reference asset to enable derived pair calculations between stablecoins and ETH — not as a primary price feed target. IFÁ Labs remains stablecoin-first.

Understanding Asset IDs

Asset IDs are fixed bytes32 identifiers generated by hashing the asset symbol using keccak256:
bytes32 assetId = keccak256(abi.encodePacked("USDT/USD"));
This produces a deterministic, collision-resistant key used to query the oracle contract across all supported networks. The same asset ID works on Base Mainnet, Base Sepolia, and AssetChain — no remapping required. Best practice: Always store asset IDs as bytes32 constants in your contracts to avoid runtime computation and save gas.
bytes32 public constant USDT_ASSET_ID = 0x6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d;
bytes32 public constant CNGN_ASSET_ID = 0x83a18c73cf75a028a24b79cbedb3b8d8ba363b748a3210ddbcaa95eec3b87b3a;
bytes32 public constant ZARP_ASSET_ID = 0x12373a3b1c4827c84bf6d7b11df100442695d0abfdb7a20d30a41d67d58e75a8;

Network Availability

All feeds listed above are available on every currently supported network:
NetworkStatusNotes
Base MainnetLivePrimary production deployment
Base SepoliaLiveRecommended for testing
AssetChain TestnetLiveRWA-focused ecosystem
As IFÁ Labs expands to new chains, all existing feeds will be available on day one of each deployment.

Derived Pairs

Beyond individual USD feeds, IFÁ Labs supports derived pair calculations — for example, pricing CNGN directly against USDT, or ZARP against USDC, without requiring a dedicated feed for each combination. Derived pairs are computed on-chain using the getPairbyId function:
// Get CNGN priced in USDT terms
DerivedPair memory pair = oracle.getPairbyId(
    CNGN_ASSET_ID,
    USDT_ASSET_ID,
    PairDirection.Forward
);
This enables protocols to work with any combination of supported assets without waiting for a direct feed to be listed. See the Function Reference for full derived pair API details.

Requesting New Feeds

New assets are added based on ecosystem demand. IFÁ Labs prioritizes feeds for stablecoins that meet the following criteria:
  • Verified backing and transparent reserves
  • Demonstrated on-chain or real-world adoption
  • Clear use case from an existing or prospective protocol
To request a new feed, reach out via any of the following: Include the token contract address, backing proof, and the protocol or use case driving the request. New feeds are reviewed and deployed on a rolling basis.

Next Steps

Supported Chains & Roadmap

See where IFÁ Labs is live and where it’s going next.

Quickstart

Start reading prices from any of these feeds right now.