> ## 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.

# Changelog

> A record of every significant update to IFÁ Labs — new deployments, new assets, contract changes, MCP server releases, and breaking changes.

This page tracks every significant change to the IFÁ Labs oracle network — contract deployments, new asset feeds, configuration changes, security fixes, MCP server releases, and documentation updates. Entries are listed in reverse chronological order.

Breaking changes are marked **\[BREAKING]**. Security fixes are marked **\[SECURITY]**. New deployments are marked **\[DEPLOYMENT]**. New assets are marked **\[ASSET]**. New tooling is marked **\[TOOLING]**.

***

## 2026

### June 2026

<AccordionGroup>
  <Accordion title="[DEPLOYMENT] IFÁ Labs Sui oracle redeployed — new object IDs">
    The Sui oracle package was redeployed with updated object IDs. All previously documented IDs are stale.

    **New object IDs:**

    * Package ID: `0x99847c953ee11ca57b6d602494c914d7d82a2d42c4c8a80307331fead5b22c4a`
    * Feed Object ID: `0x5d2728b862de08de767e4f8841a38c9452d951c0602e77fc47bfbb3ab03f33f0`
    * Verifier Object ID: `0x028e5df554ac7d253a132c60bcd13cf32bea9eb8c81d04d685c2a31299fbe43b`

    All asset IDs, function signatures, and contract behaviour are unchanged — only the deployed object IDs differ.

    See [Contract Addresses](/contract-addresses) and [Network Information](/network-information) for the full updated reference.
  </Accordion>

  <Accordion title="[DEPLOYMENT] IFÁ Labs Swap Contract launched on Sui Testnet">
    A live heterogeneous liquidity pool (HSC) on Sui Testnet, priced directly by the IFÁ Labs oracle.

    * Package ID: `0x765c26edd8a46750c017281c249cece13e7d6a2581698777ab9c804175b20f4b`
    * Pool ID: `0x905157cac184db49923b54c8baeeed6d03fcfca2bde2a89ac120c81c47666b6d`
    * Supports deposit, withdraw, swap, and dust sweeping
    * Live assets: SUI, USDSUI, CNGN, ZARP — WAL listed but not yet vaulted
    * LP fee: 30 bps · Protocol fee: 10 bps · Max price age: 1 hour
    * Not yet audited — testnet only

    See [Sui Swap Contract Overview](/sui-swap-overview), [Swap Function Reference](/sui-swap-function-reference), and [Swap Contract Addresses](/sui-swap-contract-addresses) for the full integration guide.
  </Accordion>

  <Accordion title="[TOOLING] @ifalabs/mcp-server v1.2.0 — Sui object IDs updated">
    * `get_network_info` now returns the corrected `sui-testnet` object IDs following the oracle redeployment
    * Added test coverage for `sui-testnet` object IDs, `networkType`, and `chainId` to catch this class of drift earlier
    * Install: `npm install -g @ifalabs/mcp-server@latest`
  </Accordion>
</AccordionGroup>

***

### May 2026

<AccordionGroup>
  <Accordion title="[TOOLING] @ifalabs/mcp-server v1.1.0 — Sui Testnet support added">
    * `get_network_info` now returns Sui Testnet alongside all EVM networks
    * Sui entry includes `package_id`, `feed_id`, `verifier_id`, and explorer links
    * EVM-only tools (`get_asset_price`, `get_multiple_prices`, etc.) return a clear error when `sui-testnet` is passed — directing developers to use `get_network_info` for Sui object IDs
    * Install: `npm install -g @ifalabs/mcp-server@latest`
  </Accordion>

  <Accordion title="[DEPLOYMENT] IFÁ Labs expands to Sui — three Move packages shipped on Sui Testnet">
    **Oracle Contract (`ifa_oracle`)**

    * Package ID: `0x4d165602d4bb3a7d428a3aa567e27cbe03c9de2ed5995f8c13d1adc4cd3d196f` *(superseded — see June 2026 redeployment above)*
    * Feed ID: `0x9d5fc0fce3dc11efd95ef4b3218f3b45ff17012fbc629b35529f66833e46d91a` *(superseded)*
    * Verifier ID: `0x49ba59356bdd51f42ed433f452099e32251601027d4e7d39bf86e8e1c12c3ad5` *(superseded)*
    * All existing feeds available: USDT/USD, USDC/USD, CNGN/USD, ZARP/USD, BRZ/USD, ETH/USD
    * Same asset IDs as EVM — passed as `vector<u8>` instead of `bytes32`
    * Precision model: positive decimal (`u8`) instead of EVM negative decimal (`int8`)
    * Derived pair decimal fixed at `30` — `derived_price` scaled by `10^30`
    * Built-in `is_fresh` helper exposed as a public function
    * GitHub: [IFA-Labs/oracle\_contract\_sui](https://github.com/IFA-Labs/oracle_contract_sui)

    **Faucet (`ifa_labs::faucet`)**

    * Package ID: `0xf77385d9dc49cf4774c0411a2b36d89d294ad5fe42ab1f52cc7d515044b1fa27`
    * Registry ID: `0x5c0dc844ba7647af146e9edf7618bdbf47025dd0816e60db7ad9256cafda1054`
    * Multi-token testnet faucet — SUI and WAL available for claiming
    * Cooldown: 4 hours per token per recipient
    * Claim amount: 0.5 SUI / 0.5 WAL per claim
    * GitHub: [IFA-Labs/faucet\_sui](https://github.com/IFA-Labs/faucet_sui)
  </Accordion>

  <Accordion title="[TOOLING] @ifalabs/mcp-server v1.0.0 published to npm">
    * Install: `npm install -g @ifalabs/mcp-server`
    * Binary: `ifa-mcp`
    * 7 tools exposed: `get_asset_price`, `get_multiple_prices`, `get_derived_pair`, `get_supported_assets`, `get_asset_id`, `check_price_freshness`, `get_network_info`
    * Supported clients: Claude Desktop, Cursor, Windsurf, TRAE, Zed, Continue, LangChain, CrewAI, AutoGen
    * Transport: stdio (SSE planned)
    * Documentation: [MCP Server](/what-is-the-ifa-labs-mcp-server)
  </Accordion>
</AccordionGroup>

***

### January 2026

<AccordionGroup>
  <Accordion title="[SECURITY] All A&D Forensics audit findings confirmed resolved — January 7, 2026">
    * Finding 1 (Inefficient stale check) — resolved
    * Finding 2 (Self-pairing allowed) — resolved
    * Finding 3 (Zero-price validation missing) — resolved
    * Finding 4 (Silent reverts) — resolved
    * Finding 5 (Struct indexing) — resolved
    * Finding 6 (Incorrect error reporting) — resolved
    * Finding 7 (Unnecessary comments and inefficient logic) — resolved

    Full audit summary: [AdForensics Audit Summary](/adforensics-audit-summary)
  </Accordion>
</AccordionGroup>

***

## 2025

### July 2025

<AccordionGroup>
  <Accordion title="[SECURITY] A&D Forensics security audit of oracle contracts completed — July 31, 2025">
    * Audit scope: full oracle contract codebase at commit `17f7ffc31a9818f35977ad042986cb72820d513b`
    * Methodology: manual code review, Mythril static analysis, functional testing
    * Result: no critical or high severity findings — 5 low, 2 informational
    * Status at delivery: all findings identified, remediation in progress
  </Accordion>
</AccordionGroup>

***

### June 2025

<AccordionGroup>
  <Accordion title="[ASSET] ZARP/USD feed added — South African rand stablecoin — June 25, 2025">
    * Asset ID: `0x12373a3b1c4827c84bf6d7b11df100442695d0abfdb7a20d30a41d67d58e75a8`
    * Deviation threshold: 0.3%
    * Heartbeat: 2 hours
    * Available on: Base Mainnet, Base Sepolia, AssetChain Testnet
  </Accordion>

  <Accordion title="IFÁ Labs demoed at Base ecosystem event — June 24, 2025">
    Deck and recording available via [@ifalabs](https://x.com/ifalabs).
  </Accordion>
</AccordionGroup>

***

### March 2025

<AccordionGroup>
  <Accordion title="[DEPLOYMENT] IFÁ Labs joined @ifalabs on X">
    Follow [@ifalabs](https://x.com/ifalabs) for deployment announcements, new asset feeds, and ecosystem updates.
  </Accordion>
</AccordionGroup>

***

### Initial Deployments

<AccordionGroup>
  <Accordion title="[DEPLOYMENT] Oracle contracts deployed to Base Mainnet">
    * Contract: `0xA9F17344689C2c2328F94464998db1d3e35B80dC`
    * Initial feeds: USDT/USD, USDC/USD, CNGN/USD, BRZ/USD, ETH/USD
  </Accordion>

  <Accordion title="[DEPLOYMENT] Oracle contracts deployed to Base Sepolia testnet">
    * Contract: `0xbF2ae81D8Adf3AA22401C4cC4f0116E936e1025b`
    * Identical feeds and interface to mainnet
  </Accordion>

  <Accordion title="[DEPLOYMENT] Oracle contracts deployed to AssetChain Testnet">
    * Contract: `0xBAc31e568883774A632275F9c8E7A5Bd117000F7`
    * RWA-focused ecosystem integration
  </Accordion>
</AccordionGroup>

***

## Upcoming

The following changes are planned and will be documented here when released:

| Change                                          | Type          | Target  |
| ----------------------------------------------- | ------------- | ------- |
| Sui Mainnet deployment                          | \[DEPLOYMENT] | TBD     |
| Sui Swap Contract mainnet                       | \[DEPLOYMENT] | TBD     |
| Sui Swap Contract audit                         | \[SECURITY]   | TBD     |
| WAL asset vault on Swap Contract                | \[ASSET]      | TBD     |
| AssetChain Mainnet deployment                   | \[DEPLOYMENT] | TBD     |
| Solana native program                           | \[DEPLOYMENT] | TBD     |
| Optimism deployment                             | \[DEPLOYMENT] | TBD     |
| Arbitrum deployment                             | \[DEPLOYMENT] | TBD     |
| Cross-chain messaging via LayerZero or Wormhole | Feature       | H2 2026 |
| Global view contracts                           | Feature       | H2 2026 |
| Formal bug bounty program launch                | Program       | TBD     |
| Relayer slashing mechanism                      | Feature       | TBD     |
| SSE transport for MCP server                    | \[TOOLING]    | TBD     |

***

## Staying Updated

The fastest ways to stay informed of IFÁ Labs changes:

<CardGroup cols={3}>
  <Card title="X / Twitter" icon="x-twitter" href="https://x.com/ifalabs">
    @ifalabs — deployment announcements, new assets, ecosystem updates
  </Card>

  <Card title="Telegram" icon="message" href="https://t.me/ifalabs">
    t.me/ifalabs — real-time updates and incident announcements
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/IFA-Labs/oracle_contract">
    Watch the repository for contract changes and releases
  </Card>
</CardGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Supported Assets" icon="coins" href="/supported-assets">
    Current feed list with asset IDs and configuration.
  </Card>

  <Card title="Get Help" icon="message" href="/get-help">
    Contact the IFÁ Labs team directly.
  </Card>
</CardGroup>