Price Sources

NavData::U64FixedAddress {
    nav_account_address: Pubkey,  // Account containing price data
    nav_price_offset: u16,        // Byte offset to read price (as u64)
    price_decimals: u8,           // Decimal places (0-9)
}

// Read price from offset 0 in a custom oracle account
const navData = {
  u64FixedAddress: {
    navAccountAddress: oracleAccount,
    navPriceOffset: 0,      // Read from start of account data
    priceDecimals: 6,       // Price has 6 decimal places
  }
};

// Example: Price of 1050000 with 6 decimals = $1.05

NavData::Hardcoded {
    hardcoded_price: u64,   // Fixed price value
    price_decimals: u8,     // Decimal places (0-9)
}

// Stablecoin pegged to $1.00
const navData = {
  hardcoded: {
    hardcodedPrice: new BN(1_000000),  // 1.000000
    priceDecimals: 6,
  }
};

// Example: Price of 1000000 with 6 decimals = $1.00

NavData::PythPush {
    pyth_push_account_address: Pubkey,  // Pyth receiver price update account
    feed_id: [u8; 32],                  // Expected Pyth feed id
    max_age_secs: u64,                  // Maximum accepted price age
    max_conf_bps: u16,                  // Maximum accepted confidence ratio
}

// Pyth oracle for an RWA with market price
const navData = {
  pythPush: {
    pythPushAccountAddress: pythPriceAccount,
    feedId: Array.from(Buffer.from("40ac3329933a6b5b65cf31496018c5764ac0567316146f7d0de00095886b480d", "hex")),
    maxAgeSecs: new BN(86_400),
    maxConfBps: 100,
  }
};

┌─────────────────────────────────────────────────────────┐
│                  Price Aggregation                       │
├─────────────────────────────────────────────────────────┤
│  1. Read all NAV sources                                │
│     Source 1: $1.0500 (6 decimals)                     │
│     Source 2: $1.0510 (8 decimals)                     │
│     Source 3: $1.0495 (6 decimals)                     │
│                                                         │
│  2. Normalize to 9 decimals                            │
│     Source 1: 1_050_000_000                            │
│     Source 2: 1_051_000_000                            │
│     Source 3: 1_049_500_000                            │
│                                                         │
│  3. Validate divergence (e.g., 100 BPS = 1%)          │
│     Max: 1_051_000_000                                 │
│     Min: 1_049_500_000                                 │
│     Diff: 0.14% ✓ (within threshold)                   │
│                                                         │
│  4. Calculate average                                   │
│     Average: 1_050_166_666 (9 decimals)               │
│     = $1.050166666                                     │
└─────────────────────────────────────────────────────────┘

// In AssetConfig
pub price_difference_bps: u16,  // Maximum divergence in basis points

divergence_bps = (max_price - min_price) / max_price × 10000

price_difference_bps = 100 (1%)

Source 1: $1.05
Source 2: $1.06
Divergence: 0.95% ✓ Allowed

Source 1: $1.05
Source 2: $1.10
Divergence: 4.55% ✗ Blocked (returns 0)

normalized = raw_value × 10^(9 - source_decimals)

// USDC with fixed $1.00 price
const usdcNavData = [{
  hardcoded: {
    hardcodedPrice: new BN(1_000000),
    priceDecimals: 6,
  }
}];

await program.methods
  .initAssetConfigAccount(
    usdcNavData,
    0,  // No divergence check needed (single source)
    { stable: {} }
  )
  .accounts({ /* ... */ })
  .rpc();

// RWA with price published to custom account
const rwaNavData = [{
  u64FixedAddress: {
    navAccountAddress: issuerOracleAccount,
    navPriceOffset: 0,
    priceDecimals: 6,
  }
}];

await program.methods
  .initAssetConfigAccount(
    rwaNavData,
    0,  // Single source
    { rwa: {} }
  )
  .accounts({ /* ... */ })
  .rpc();

// RWA with primary oracle + Pyth backup
const rwaNavData = [
  {
    u64FixedAddress: {
      navAccountAddress: primaryOracle,
      navPriceOffset: 0,
      priceDecimals: 6,
    }
  },
  {
    pythPush: {
      pythPushAccountAddress: pythAccount,
      feedId: Array.from(Buffer.from("40ac3329933a6b5b65cf31496018c5764ac0567316146f7d0de00095886b480d", "hex")),
      maxAgeSecs: new BN(86_400),
      maxConfBps: 100,
    }
  }
];

await program.methods
  .initAssetConfigAccount(
    rwaNavData,
    100,  // Allow 1% divergence between sources
    { rwa: {} }
  )
  .accounts({ /* ... */ })
  .rpc();

// Collect all NAV source accounts for both assets
const navAccounts = [
  // RWA NAV sources
  { pubkey: rwaOracleAccount, isWritable: false, isSigner: false },
  // Stablecoin NAV sources (if not hardcoded)
  // ... additional accounts as needed
];

await program.methods
  .swap(amount, minOut, null, { stableToAsset: {} }, { exactIn: {} })
  .accounts({ /* ... */ })
  .remainingAccounts(navAccounts)
  .rpc();