Protocol API &Intelligence Layer

{
  "block_number":              251388029,
  "eth_price_usd":             1200.0,
  "price_source":              "chainlink_fallback",
  "oracle_feed_address":       "0x<OracleModule.feed() return value>",
  "oracle_stale":              true,
  "total_collateral_eth":      8.125,
  "total_collateral_usd":      9750.0,
  "total_debt_nxusd":          8000.0,
  "collateral_ratio":          1.21875,
  "collateral_ratio_pct":      121.9,
  "min_collateral_ratio_bps":  15000,
  "liquidation_ratio_bps":     13000,
  "vault_paused":              false,
  "liquidation_engine_paused": false,
  "pillars": {
    "SOV_001": { "pass": true,  "note": "Economic Constitution — solvency gate" },
    "SOV_003": { "pass": false, "note": "Capital Adequacy — testnet_env failure, zero economic" },
    "SOV_005": { "pass": true,  "note": "Risk Lattice — stress simulation" }
  },
  "overall_verdict":  "WARN",
  "verdict_reason":   "SOV_003 FAIL: oracle stale (testnet environment). Zero economic failures.",
  "verdict_source":   "simplified_runtime",
  "timestamp":        "2026-03-20T12:00:00.000Z"
}

// Minimal integration — live protocol state
const res  = await fetch('https://nexus-finance.org/api/status')
const data = await res.json()

// Primary observability fields
console.log(data.overall_verdict)       // "PASS" | "WARN" | "FAIL"
console.log(data.collateral_ratio_pct)  // e.g. 121.9
console.log(data.oracle_stale)          // bool — affects price reliability
console.log(data.pillars.SOV_001.pass)  // false → halt integrations

// Check data freshness via response header
// Cache-Control: public, s-maxage=30, must-revalidate
// Note: overall_verdict is a simplified runtime check — see verdict_source field.
// For canonical audit verdict, use /api/receipts overall_verdict.

{
  "block_number":  251388029,
  "eth_price_usd": 1200.0,
  "oracle_stale":  true,
  "price_source":  "chainlink_fallback",
  "protocol": {
    "min_collateral_ratio_bps": 15000,
    "liquidation_ratio_bps":    13000
  },
  "vaults": [
    {
      "address":              "0xabc...111",
      "collateral_eth":       8.125,
      "debt_nxusd":           8000.0,
      "collateral_value_usd": 9750.0,
      "collateral_ratio":     1.21875,
      "collateral_ratio_pct": 121.9,
      "status":               "oracle_stale"
    }
  ],
  "summary": {
    "total":        2,
    "safe":         0,
    "active":       0,
    "liquidatable": 1,
    "oracle_stale": 1
  },
  "timestamp": "2026-03-20T12:00:00.000Z"
}

// Liquidation keeper — find eligible positions
const res  = await fetch('https://nexus-finance.org/api/vaults')
const data = await res.json()

// Filter by status — note: oracle_stale means CR is computed off fallback
const liquidatable = data.vaults.filter(v => v.status === 'liquidatable')
const atRisk       = data.vaults.filter(v => v.status === 'active')

// Prefer to act only when oracle is reliable
if (!data.oracle_stale && liquidatable.length > 0) {
  // Proceed to on-chain liquidation via KEEPER_ROLE
}

// Protocol thresholds (BPS → decimal)
const liqCr = data.protocol.liquidation_ratio_bps / 10000  // 1.30
const minCr = data.protocol.min_collateral_ratio_bps / 10000  // 1.50

[
  {
    "filename":             "AUD_001_PACKAGE_20260320T120000Z.json",
    "download_url":         "https://raw.githubusercontent.com/NEXUS120-Official/nexus-receipts/main/packages/...",
    "timestamp_utc":        "2026-03-20T12:00:00Z",
    "block_number":         251388029,
    "eth_price_usd":        1200.0,
    "price_source":         "chainlink_fallback",
    "collateral_ratio_pct": 121.9,
    "total_collateral_eth": 8.125,
    "total_debt_nxusd":     8000.0,
    "oracle_stale":         true,
    "sov_001_verdict":      "PASS",
    "sov_003_verdict":      "FAIL",
    "sov_003_mode":         "RECOVERY",
    "sov_003_fail_count": {
      "economic":    0,
      "structural":  0,
      "testnet_env": 6,
      "total":       6
    },
    "sov_005_verdict":   "PASS",
    "overall_verdict":   "WARN",
    "verdict_rationale": "SOV_003 FAIL — testnet_env only. Zero economic or structural failures.",
    "package_hash":      "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "raw": { "...": "full AUD_001 JSON from nexus-receipts repo" }
  }
]

// Audit verification — read and verify recent packages
const res      = await fetch('https://nexus-finance.org/api/receipts')
const packages = await res.json()  // array, newest first — all available packages

const latest = packages[0]

// Verify integrity — recompute hash server-side against raw field
console.log(latest.package_hash)                   // "sha256:..."
console.log(latest.overall_verdict)                // "PASS" | "WARN" | "FAIL"

// Distinguish fail categories — economic=0 means no real risk event
console.log(latest.sov_003_fail_count.economic)    // 0 on healthy testnet
console.log(latest.sov_003_fail_count.testnet_env) // non-zero is expected