> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aarc.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Oracles & Proof of Reserves

> NAV oracle and Proof of Reserves integration details

BTCY uses a Chainlink NAV oracle on Ethereum mainnet. A separate on-chain Proof of Reserves feed is planned and not yet deployed.

## NAV Oracle

### Overview

| Parameter        | Value            |
| ---------------- | ---------------- |
| Provider         | Chainlink        |
| Update Frequency | Daily            |
| Data Source      | Accountable      |
| Network          | Ethereum Mainnet |

### Feed Address

```
0x5a33E6CB085E2DdD0df558c0D7d71a27be6b9131
```

[Etherscan](https://etherscan.io/address/0x5a33E6CB085E2DdD0df558c0D7d71a27be6b9131)

### Data Format

The NAV feed provides:

* NAV per iBTCY token (in BTC, 18 decimals)
* Timestamp of last update

### Reading NAV On-Chain

```solidity theme={null}
// Chainlink Aggregator interface
AggregatorV3Interface navFeed = AggregatorV3Interface(NAV_FEED_ADDRESS);

(
    uint80 roundId,
    int256 navPerToken,
    uint256 startedAt,
    uint256 updatedAt,
    uint80 answeredInRound
) = navFeed.latestRoundData();

// NAV is in BTC with 18 decimals
// Example: 1.05e18 = 1.05 BTC per token
```

### Staleness Handling

<Info>
  Integrators should implement staleness checks. Stale NAV data may indicate operational issues. Contact us for integration guidance.
</Info>

## Proof of Reserves

### Overview

| Parameter        | Value                              |
| ---------------- | ---------------------------------- |
| Provider         | Chainlink + Accountable            |
| Update Frequency | Monthly                            |
| Attestation      | Total backing ≥ total supply × NAV |

### Feed Address

<Warning>
  The PoR on-chain feed is not live yet. It will be a **separate contract** from the NAV oracle. This page will be updated when deployed.
</Warning>

```
PoR Feed: Not yet deployed
```

Monthly attestation status is available on the [Proof of Solvency dashboard](https://aarc.accountable.capital/) until the on-chain feed is live.

### What It Verifies

The Proof of Reserves attestation confirms:

```
Buffer BTC (Archax) + SSBAF Units * SSBAF NAV >= iBTCY Supply * NAV per Token
```

| Component    | Source                 |
| ------------ | ---------------------- |
| Buffer BTC   | Archax custody balance |
| SSBAF NAV    | Sygnum official NAV    |
| iBTCY Supply | On-chain token supply  |

### Reading PoR On-Chain

```solidity theme={null}
// Chainlink PoR interface
AggregatorV3Interface porFeed = AggregatorV3Interface(POR_FEED_ADDRESS);

(
    uint80 roundId,
    int256 reserves,
    uint256 startedAt,
    uint256 updatedAt,
    uint80 answeredInRound
) = porFeed.latestRoundData();

// Compare reserves to total supply
uint256 totalSupply = IERC20(IBTCY_ADDRESS).totalSupply();
uint256 navPerToken = /* from NAV feed */;

bool fullyBacked = reserves >= totalSupply * navPerToken / 1e18;
```

## Integration Recommendations

### For Lending Protocols

1. **Use NAV feed for pricing**: More accurate than DEX spot price
2. **Implement staleness checks**: Pause operations if feed is stale
3. **Consider PoR for risk**: Monitor backing ratio

```solidity theme={null}
function getBTCYPrice() external view returns (uint256) {
    (, int256 nav,, uint256 updatedAt,) = navFeed.latestRoundData();
    
    // Reject data older than 36 hours (aligns with internal pause band; see /product/transparency)
    require(block.timestamp - updatedAt < 36 hours, "Stale NAV");
    
    return uint256(nav);
}
```

### For DEXs

1. **NAV as reference price**: Useful for arbitrage bounds
2. **Expect premium/discount**: BTCY may trade off-NAV
3. **Liquidity constraints**: Consider redemption capacity

### For Risk Monitoring

1. **Track buffer percentage**: Available on the [Proof of Solvency dashboard](https://aarc.accountable.capital/)
2. **Monitor PoR ratio**: Should always be ≥ 100%
3. **Watch for staleness**: Indicates potential issues

## Dashboard

Real-time NAV and proof-of-solvency metrics are available at [aarc.accountable.capital](https://aarc.accountable.capital/).

| Metric      | Where to view                                                                                     |
| ----------- | ------------------------------------------------------------------------------------------------- |
| Current NAV | [Proof of Solvency dashboard](https://aarc.accountable.capital/)                                  |
| Buffer %    | [Proof of Solvency dashboard](https://aarc.accountable.capital/)                                  |
| PoR Status  | [Proof of Solvency dashboard](https://aarc.accountable.capital/) (on-chain PoR feed not yet live) |

<Info>
  A public developer API is not available yet. Integrators should read NAV from the on-chain oracle contract. PoR will use a separate contract when deployed.
</Info>

## Chainlink Documentation

For general Chainlink integration patterns:

* [Chainlink Price Feeds](https://docs.chain.link/data-feeds)
* [Chainlink Proof of Reserve](https://docs.chain.link/data-feeds/proof-of-reserve)

<Card title="Contract Addresses" icon="file-contract" href="/developers/contracts">
  View deployed contract addresses
</Card>

***

<Note>
  Available only to eligible professional/qualified investors on an invite-only basis, subject to onboarding and compliance approval. For informational purposes only and not investment advice. Not an offer to the public or a solicitation where unlawful. No retail distribution. Not available to US Persons.

  [Disclaimers](/legal/disclaimers) · [Platform and issuer](/legal/platform-legal)
</Note>