@permissionless-technologies/upd-sdk 0.1.0

package/dist/oracle/index.d.ts

@@ -0,0 +1,41 @@
+import { a as OracleClientConfig, O as OracleClient } from '../constants-Bk2bGYfX.js';
+export { D as DEFAULT_ORACLE_URL, b as DEFAULT_TIMEOUT, E as ETH_USD_ASSET_PAIR, d as OracleResponse, c as createMockAttestation } from '../constants-Bk2bGYfX.js';
+import '../types-DySv82My.js';
+import 'viem';
+
+/**
+ * Oracle HTTP Client — Fetches signed price attestations from an oracle service.
+ *
+ * The oracle service returns signed ETH/USD prices in the exact format
+ * that PriceOracle.sol expects. The client deserializes the response
+ * into a PriceAttestationQuery that can be passed directly to
+ * UPDClient.mint() or UPDClient.burn().
+ *
+ * @example
+ * ```ts
+ * import { createOracleClient } from '@permissionless-technologies/upd-sdk/oracle'
+ *
+ * const oracle = createOracleClient()
+ * const attestation = await oracle.getEthUsdAttestation()
+ *
+ * // Pass directly to mint
+ * await updClient.mint({ to: '0x...', ethAmount: parseEther('1'), priceAttestation: attestation })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Custom oracle URL (e.g. local development)
+ * const oracle = createOracleClient({ oracleUrl: 'http://localhost:3000' })
+ * const { price } = await oracle.getEthUsdPrice()
+ * ```
+ */
+
+/**
+ * Create an oracle client that fetches signed price attestations.
+ *
+ * @param config - Optional configuration (URL, timeout, custom fetch)
+ * @returns An OracleClient instance
+ */
+declare function createOracleClient(config?: OracleClientConfig): OracleClient;
+
+export { OracleClient, OracleClientConfig, createOracleClient };

package/dist/oracle/index.js

@@ -0,0 +1,5 @@
+import '../chunk-LNGWRYGY.js';
+export { createMockAttestation } from '../chunk-5NNXIJE4.js';
+export { DEFAULT_ORACLE_URL, DEFAULT_TIMEOUT, ETH_USD_ASSET_PAIR, createOracleClient } from '../chunk-DJBU2OEB.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/oracle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/react/index.cjs

@@ -0,0 +1,383 @@
+'use strict';
+
+require('../chunk-ZDAHLZWC.cjs');
+var chunk4VXNJTNQ_cjs = require('../chunk-4VXNJTNQ.cjs');
+var chunkZSWETUGH_cjs = require('../chunk-ZSWETUGH.cjs');
+var chunkCZEDT3MS_cjs = require('../chunk-CZEDT3MS.cjs');
+var wagmi = require('wagmi');
+var reactQuery = require('@tanstack/react-query');
+var react = require('react');
+
+function useUPD(config) {
+  const { tokenAddress, userAddress } = config;
+  const { data: balance, isLoading: balanceLoading } = wagmi.useReadContract({
+    address: tokenAddress,
+    abi: chunkZSWETUGH_cjs.UPD_TOKEN_ABI,
+    functionName: "balanceOf",
+    args: userAddress ? [userAddress] : void 0,
+    query: { enabled: !!userAddress }
+  });
+  const { data: totalSupply, isLoading: supplyLoading } = wagmi.useReadContract({
+    address: tokenAddress,
+    abi: chunkZSWETUGH_cjs.UPD_TOKEN_ABI,
+    functionName: "totalSupply"
+  });
+  return {
+    balance,
+    totalSupply,
+    isLoading: balanceLoading || supplyLoading
+  };
+}
+function useCollateral(config) {
+  const { reporterAddress, tokenAddress } = config;
+  const { data: totalStEthCollateral, isLoading: collateralLoading } = wagmi.useReadContract({
+    address: reporterAddress,
+    abi: chunkZSWETUGH_cjs.OVERCOLLATERALIZATION_REPORTER_ABI,
+    functionName: "totalStEthCollateral"
+  });
+  const { data: totalUPDSupply, isLoading: supplyLoading } = wagmi.useReadContract({
+    address: tokenAddress,
+    abi: chunkZSWETUGH_cjs.UPD_TOKEN_ABI,
+    functionName: "totalSupply"
+  });
+  return {
+    totalStEthCollateral,
+    totalUPDSupply,
+    isLoading: collateralLoading || supplyLoading
+  };
+}
+function useStabilizer(config) {
+  const { stabilizerNFTAddress, tokenId } = config;
+  const { data: positionEscrow, isLoading: posLoading } = wagmi.useReadContract({
+    address: stabilizerNFTAddress,
+    abi: chunkZSWETUGH_cjs.STABILIZER_NFT_ABI,
+    functionName: "positionEscrows",
+    args: tokenId !== void 0 ? [tokenId] : void 0,
+    query: { enabled: tokenId !== void 0 }
+  });
+  const { data: stabilizerEscrow, isLoading: stabLoading } = wagmi.useReadContract({
+    address: stabilizerNFTAddress,
+    abi: chunkZSWETUGH_cjs.STABILIZER_NFT_ABI,
+    functionName: "stabilizerEscrows",
+    args: tokenId !== void 0 ? [tokenId] : void 0,
+    query: { enabled: tokenId !== void 0 }
+  });
+  return {
+    positionEscrowAddress: positionEscrow,
+    stabilizerEscrowAddress: stabilizerEscrow,
+    isLoading: posLoading || stabLoading
+  };
+}
+function formatUsdPrice(price) {
+  if (price === void 0) return "--";
+  const priceFloat = Number(price) / 1e18;
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2
+  }).format(priceFloat);
+}
+function useEthUsdPrice(config) {
+  const oracleUrl = config?.oracleUrl;
+  const refetchInterval = config?.refetchInterval ?? 1e4;
+  const enabled = config?.enabled ?? true;
+  const oracle = chunkCZEDT3MS_cjs.createOracleClient({ oracleUrl });
+  const { data, isLoading, error, refetch } = reactQuery.useQuery({
+    queryKey: ["upd-oracle-eth-usd", oracleUrl],
+    queryFn: () => oracle.getEthUsdAttestation(),
+    refetchInterval,
+    enabled,
+    staleTime: 5e3
+  });
+  return {
+    price: data?.price,
+    priceFormatted: formatUsdPrice(data?.price),
+    attestation: data,
+    isLoading,
+    error,
+    refetch: () => {
+      refetch();
+    }
+  };
+}
+function useMintQuote(ethAmount, config) {
+  const { price, isLoading } = useEthUsdPrice({
+    ...config,
+    enabled: ethAmount > 0n && (config?.enabled ?? true)
+  });
+  const updAmount = react.useMemo(() => {
+    if (price === void 0 || ethAmount === 0n) return void 0;
+    return chunk4VXNJTNQ_cjs.quoteMintUPD(ethAmount, price);
+  }, [ethAmount, price]);
+  return {
+    updAmount,
+    ethUsdPrice: price,
+    isLoading
+  };
+}
+function useBurnQuote(updAmount, config) {
+  const { price, isLoading } = useEthUsdPrice({
+    ...config,
+    enabled: updAmount > 0n && (config?.enabled ?? true)
+  });
+  const stEthAmount = react.useMemo(() => {
+    if (price === void 0 || updAmount === 0n) return void 0;
+    return chunk4VXNJTNQ_cjs.quoteBurnUPD(updAmount, price);
+  }, [updAmount, price]);
+  return {
+    stEthAmount,
+    ethUsdPrice: price,
+    isLoading
+  };
+}
+function useMintUPD(config) {
+  const { stabilizerNFTAddress } = config;
+  const {
+    writeContract,
+    data: txHash,
+    isPending,
+    error: writeError,
+    reset
+  } = wagmi.useWriteContract();
+  const {
+    isLoading: isConfirming,
+    isSuccess: isConfirmed
+  } = wagmi.useWaitForTransactionReceipt({
+    hash: txHash
+  });
+  function mint(params) {
+    writeContract({
+      address: stabilizerNFTAddress,
+      abi: chunkZSWETUGH_cjs.STABILIZER_NFT_ABI,
+      functionName: "mintUPD",
+      args: [
+        params.to,
+        {
+          price: params.attestation.price,
+          decimals: params.attestation.decimals,
+          dataTimestamp: params.attestation.dataTimestamp,
+          assetPair: params.attestation.assetPair,
+          signature: params.attestation.signature
+        }
+      ],
+      value: params.ethAmount
+    });
+  }
+  return {
+    mint,
+    isPending,
+    txHash,
+    isConfirming,
+    isConfirmed,
+    error: writeError,
+    reset
+  };
+}
+function useBurnUPD(config) {
+  const { stabilizerNFTAddress } = config;
+  const {
+    writeContract,
+    data: txHash,
+    isPending,
+    error: writeError,
+    reset
+  } = wagmi.useWriteContract();
+  const {
+    isLoading: isConfirming,
+    isSuccess: isConfirmed
+  } = wagmi.useWaitForTransactionReceipt({
+    hash: txHash
+  });
+  function burn(params) {
+    writeContract({
+      address: stabilizerNFTAddress,
+      abi: chunkZSWETUGH_cjs.STABILIZER_NFT_ABI,
+      functionName: "burnUPD",
+      args: [
+        params.updAmount,
+        {
+          price: params.attestation.price,
+          decimals: params.attestation.decimals,
+          dataTimestamp: params.attestation.dataTimestamp,
+          assetPair: params.attestation.assetPair,
+          signature: params.attestation.signature
+        }
+      ]
+    });
+  }
+  return {
+    burn,
+    isPending,
+    txHash,
+    isConfirming,
+    isConfirmed,
+    error: writeError,
+    reset
+  };
+}
+function useSystemHealth(config) {
+  const collateralConfig = {
+    reporterAddress: config.reporterAddress,
+    tokenAddress: config.tokenAddress
+  };
+  const priceConfig = {
+    oracleUrl: config.oracleUrl
+  };
+  const {
+    totalStEthCollateral,
+    totalUPDSupply,
+    isLoading: collateralLoading
+  } = useCollateral(collateralConfig);
+  const {
+    price: ethUsdPrice,
+    isLoading: priceLoading
+  } = useEthUsdPrice(priceConfig);
+  const health = react.useMemo(() => {
+    if (totalStEthCollateral === void 0 || totalUPDSupply === void 0 || ethUsdPrice === void 0) {
+      return void 0;
+    }
+    return chunk4VXNJTNQ_cjs.computeSystemHealth(
+      { totalStEthCollateral, totalUPDSupply },
+      ethUsdPrice,
+      config.minRatioBps
+    );
+  }, [totalStEthCollateral, totalUPDSupply, ethUsdPrice, config.minRatioBps]);
+  return {
+    health,
+    isLoading: collateralLoading || priceLoading
+  };
+}
+function useSUPD(config) {
+  const { supdAddress, userAddress } = config;
+  const { data: balance, isLoading: balLoading } = wagmi.useReadContract({
+    address: supdAddress,
+    abi: chunkZSWETUGH_cjs.SUPD_ABI,
+    functionName: "balanceOf",
+    args: userAddress ? [userAddress] : void 0,
+    query: { enabled: !!userAddress }
+  });
+  const { data: totalSupply, isLoading: supplyLoading } = wagmi.useReadContract({
+    address: supdAddress,
+    abi: chunkZSWETUGH_cjs.SUPD_ABI,
+    functionName: "totalSupply"
+  });
+  const { data: shareValue, isLoading: svLoading } = wagmi.useReadContract({
+    address: supdAddress,
+    abi: chunkZSWETUGH_cjs.SUPD_ABI,
+    functionName: "currentShareValue"
+  });
+  const { data: annualYieldBps, isLoading: apyLoading } = wagmi.useReadContract({
+    address: supdAddress,
+    abi: chunkZSWETUGH_cjs.SUPD_ABI,
+    functionName: "annualYieldBps"
+  });
+  const { data: totalLiabilityUSD, isLoading: liabLoading } = wagmi.useReadContract({
+    address: supdAddress,
+    abi: chunkZSWETUGH_cjs.SUPD_ABI,
+    functionName: "totalLiabilityUSD"
+  });
+  return {
+    balance,
+    totalSupply,
+    shareValue,
+    annualYieldBps,
+    totalLiabilityUSD,
+    isLoading: balLoading || supplyLoading || svLoading || apyLoading || liabLoading
+  };
+}
+function useStakeUPD(config) {
+  const { supdAddress } = config;
+  const {
+    writeContract,
+    data: txHash,
+    isPending,
+    error: writeError,
+    reset
+  } = wagmi.useWriteContract();
+  const {
+    isLoading: isConfirming,
+    isSuccess: isConfirmed
+  } = wagmi.useWaitForTransactionReceipt({ hash: txHash });
+  function stake(params) {
+    writeContract({
+      address: supdAddress,
+      abi: chunkZSWETUGH_cjs.SUPD_ABI,
+      functionName: "stakeUPD",
+      args: [
+        params.updAmount,
+        {
+          price: params.attestation.price,
+          decimals: params.attestation.decimals,
+          dataTimestamp: params.attestation.dataTimestamp,
+          assetPair: params.attestation.assetPair,
+          signature: params.attestation.signature
+        }
+      ]
+    });
+  }
+  return {
+    stake,
+    isPending,
+    txHash,
+    isConfirming,
+    isConfirmed,
+    error: writeError,
+    reset
+  };
+}
+function useUnstakeUPD(config) {
+  const { supdAddress } = config;
+  const {
+    writeContract,
+    data: txHash,
+    isPending,
+    error: writeError,
+    reset
+  } = wagmi.useWriteContract();
+  const {
+    isLoading: isConfirming,
+    isSuccess: isConfirmed
+  } = wagmi.useWaitForTransactionReceipt({ hash: txHash });
+  function unstake(params) {
+    writeContract({
+      address: supdAddress,
+      abi: chunkZSWETUGH_cjs.SUPD_ABI,
+      functionName: "unstakeToUPD",
+      args: [
+        params.shares,
+        {
+          price: params.attestation.price,
+          decimals: params.attestation.decimals,
+          dataTimestamp: params.attestation.dataTimestamp,
+          assetPair: params.attestation.assetPair,
+          signature: params.attestation.signature
+        }
+      ]
+    });
+  }
+  return {
+    unstake,
+    isPending,
+    txHash,
+    isConfirming,
+    isConfirmed,
+    error: writeError,
+    reset
+  };
+}
+
+exports.useBurnQuote = useBurnQuote;
+exports.useBurnUPD = useBurnUPD;
+exports.useCollateral = useCollateral;
+exports.useEthUsdPrice = useEthUsdPrice;
+exports.useMintQuote = useMintQuote;
+exports.useMintUPD = useMintUPD;
+exports.useSUPD = useSUPD;
+exports.useStabilizer = useStabilizer;
+exports.useStakeUPD = useStakeUPD;
+exports.useSystemHealth = useSystemHealth;
+exports.useUPD = useUPD;
+exports.useUnstakeUPD = useUnstakeUPD;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/use-upd.ts","../../src/react/use-collateral.ts","../../src/react/use-stabilizer.ts","../../src/react/use-eth-usd-price.ts","../../src/react/use-mint-quote.ts","../../src/react/use-burn-quote.ts","../../src/react/use-mint-upd.ts","../../src/react/use-burn-upd.ts","../../src/react/use-system-health.ts","../../src/react/use-supd.ts","../../src/react/use-stake-upd.ts","../../src/react/use-unstake-upd.ts"],"names":["useReadContract","UPD_TOKEN_ABI","OVERCOLLATERALIZATION_REPORTER_ABI","STABILIZER_NFT_ABI","createOracleClient","useQuery","useMemo","quoteMintUPD","quoteBurnUPD","useWriteContract","useWaitForTransactionReceipt","computeSystemHealth","SUPD_ABI"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useReadContract } from 'wagmi'\nimport type { Address } from 'viem'\nimport { UPD_TOKEN_ABI } from '../contracts/index.js'\n\nexport interface UseUPDConfig {\n  tokenAddress: Address\n  userAddress?: Address\n}\n\nexport interface UseUPDReturn {\n  balance: bigint | undefined\n  totalSupply: bigint | undefined\n  isLoading: boolean\n}\n\nexport function useUPD(config: UseUPDConfig): UseUPDReturn {\n  const { tokenAddress, userAddress } = config\n\n  const { data: balance, isLoading: balanceLoading } = useReadContract({\n    address: tokenAddress,\n    abi: UPD_TOKEN_ABI,\n    functionName: 'balanceOf',\n    args: userAddress ? [userAddress] : undefined,\n    query: { enabled: !!userAddress },\n  })\n\n  const { data: totalSupply, isLoading: supplyLoading } = useReadContract({\n    address: tokenAddress,\n    abi: UPD_TOKEN_ABI,\n    functionName: 'totalSupply',\n  })\n\n  return {\n    balance: balance as bigint | undefined,\n    totalSupply: totalSupply as bigint | undefined,\n    isLoading: balanceLoading || supplyLoading,\n  }\n}\n","import { useReadContract } from 'wagmi'\nimport type { Address } from 'viem'\nimport { OVERCOLLATERALIZATION_REPORTER_ABI } from '../contracts/index.js'\nimport { UPD_TOKEN_ABI } from '../contracts/index.js'\n\nexport interface UseCollateralConfig {\n  reporterAddress: Address\n  tokenAddress: Address\n}\n\nexport interface UseCollateralReturn {\n  totalStEthCollateral: bigint | undefined\n  totalUPDSupply: bigint | undefined\n  isLoading: boolean\n}\n\nexport function useCollateral(config: UseCollateralConfig): UseCollateralReturn {\n  const { reporterAddress, tokenAddress } = config\n\n  const { data: totalStEthCollateral, isLoading: collateralLoading } =\n    useReadContract({\n      address: reporterAddress,\n      abi: OVERCOLLATERALIZATION_REPORTER_ABI,\n      functionName: 'totalStEthCollateral',\n    })\n\n  const { data: totalUPDSupply, isLoading: supplyLoading } = useReadContract({\n    address: tokenAddress,\n    abi: UPD_TOKEN_ABI,\n    functionName: 'totalSupply',\n  })\n\n  return {\n    totalStEthCollateral: totalStEthCollateral as bigint | undefined,\n    totalUPDSupply: totalUPDSupply as bigint | undefined,\n    isLoading: collateralLoading || supplyLoading,\n  }\n}\n","import { useReadContract } from 'wagmi'\nimport type { Address } from 'viem'\nimport { STABILIZER_NFT_ABI } from '../contracts/index.js'\n\nexport interface UseStabilizerConfig {\n  stabilizerNFTAddress: Address\n  tokenId?: bigint\n}\n\nexport interface UseStabilizerReturn {\n  positionEscrowAddress: Address | undefined\n  stabilizerEscrowAddress: Address | undefined\n  isLoading: boolean\n}\n\nexport function useStabilizer(\n  config: UseStabilizerConfig,\n): UseStabilizerReturn {\n  const { stabilizerNFTAddress, tokenId } = config\n\n  const { data: positionEscrow, isLoading: posLoading } = useReadContract({\n    address: stabilizerNFTAddress,\n    abi: STABILIZER_NFT_ABI,\n    functionName: 'positionEscrows',\n    args: tokenId !== undefined ? [tokenId] : undefined,\n    query: { enabled: tokenId !== undefined },\n  })\n\n  const { data: stabilizerEscrow, isLoading: stabLoading } = useReadContract({\n    address: stabilizerNFTAddress,\n    abi: STABILIZER_NFT_ABI,\n    functionName: 'stabilizerEscrows',\n    args: tokenId !== undefined ? [tokenId] : undefined,\n    query: { enabled: tokenId !== undefined },\n  })\n\n  return {\n    positionEscrowAddress: positionEscrow as Address | undefined,\n    stabilizerEscrowAddress: stabilizerEscrow as Address | undefined,\n    isLoading: posLoading || stabLoading,\n  }\n}\n","import { useQuery } from '@tanstack/react-query'\nimport { createOracleClient } from '../oracle/client.js'\nimport type { PriceAttestationQuery } from '../core/types.js'\n\nexport interface UseEthUsdPriceConfig {\n  /** Oracle service URL. Defaults to oracle.upd.io. */\n  oracleUrl?: string\n  /** Refetch interval in milliseconds. Defaults to 10000 (10s). */\n  refetchInterval?: number\n  /** Whether to enable the query. Defaults to true. */\n  enabled?: boolean\n}\n\nexport interface UseEthUsdPriceReturn {\n  /** Raw price in 18 decimals (e.g. 2000e18 = $2000). */\n  price: bigint | undefined\n  /** Human-readable formatted price string (e.g. \"$2,000.00\"). */\n  priceFormatted: string\n  /** Full signed attestation, ready to pass to mint/burn. */\n  attestation: PriceAttestationQuery | undefined\n  /** Whether the initial fetch is loading. */\n  isLoading: boolean\n  /** Error from the most recent fetch, if any. */\n  error: Error | null\n  /** Manually trigger a refetch. */\n  refetch: () => void\n}\n\nfunction formatUsdPrice(price: bigint | undefined): string {\n  if (price === undefined) return '--'\n  const priceFloat = Number(price) / 1e18\n  return new Intl.NumberFormat('en-US', {\n    style: 'currency',\n    currency: 'USD',\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  }).format(priceFloat)\n}\n\nexport function useEthUsdPrice(config?: UseEthUsdPriceConfig): UseEthUsdPriceReturn {\n  const oracleUrl = config?.oracleUrl\n  const refetchInterval = config?.refetchInterval ?? 10_000\n  const enabled = config?.enabled ?? true\n\n  const oracle = createOracleClient({ oracleUrl })\n\n  const { data, isLoading, error, refetch } = useQuery({\n    queryKey: ['upd-oracle-eth-usd', oracleUrl],\n    queryFn: () => oracle.getEthUsdAttestation(),\n    refetchInterval,\n    enabled,\n    staleTime: 5_000,\n  })\n\n  return {\n    price: data?.price,\n    priceFormatted: formatUsdPrice(data?.price),\n    attestation: data,\n    isLoading,\n    error: error as Error | null,\n    refetch: () => { refetch() },\n  }\n}\n","import { useMemo } from 'react'\nimport { useEthUsdPrice, type UseEthUsdPriceConfig } from './use-eth-usd-price.js'\nimport { quoteMintUPD } from '../core/quote.js'\n\nexport interface UseMintQuoteConfig extends UseEthUsdPriceConfig {}\n\nexport interface UseMintQuoteReturn {\n  /** Expected UPD amount for the given ETH input (18 decimals). */\n  updAmount: bigint | undefined\n  /** Current ETH/USD price used for the quote (18 decimals). */\n  ethUsdPrice: bigint | undefined\n  /** Whether the price is still loading. */\n  isLoading: boolean\n}\n\n/**\n * Real-time mint quote hook — composes oracle price + pure math.\n *\n * @param ethAmount - ETH amount to quote (in wei). Pass 0n to disable.\n * @param config - Optional oracle configuration.\n *\n * @example\n * ```tsx\n * const { updAmount, isLoading } = useMintQuote(parseEther('1'))\n * // updAmount ≈ 2000e18 (at $2000/ETH)\n * ```\n */\nexport function useMintQuote(\n  ethAmount: bigint,\n  config?: UseMintQuoteConfig,\n): UseMintQuoteReturn {\n  const { price, isLoading } = useEthUsdPrice({\n    ...config,\n    enabled: ethAmount > 0n && (config?.enabled ?? true),\n  })\n\n  const updAmount = useMemo(() => {\n    if (price === undefined || ethAmount === 0n) return undefined\n    return quoteMintUPD(ethAmount, price)\n  }, [ethAmount, price])\n\n  return {\n    updAmount,\n    ethUsdPrice: price,\n    isLoading,\n  }\n}\n","import { useMemo } from 'react'\nimport { useEthUsdPrice, type UseEthUsdPriceConfig } from './use-eth-usd-price.js'\nimport { quoteBurnUPD } from '../core/quote.js'\n\nexport interface UseBurnQuoteConfig extends UseEthUsdPriceConfig {}\n\nexport interface UseBurnQuoteReturn {\n  /** Expected stETH amount for the given UPD input (in wei). */\n  stEthAmount: bigint | undefined\n  /** Current ETH/USD price used for the quote (18 decimals). */\n  ethUsdPrice: bigint | undefined\n  /** Whether the price is still loading. */\n  isLoading: boolean\n}\n\n/**\n * Real-time burn quote hook — composes oracle price + pure math.\n *\n * @param updAmount - UPD amount to quote (18 decimals). Pass 0n to disable.\n * @param config - Optional oracle configuration.\n *\n * @example\n * ```tsx\n * const { stEthAmount, isLoading } = useBurnQuote(parseUnits('2000', 18))\n * // stEthAmount ≈ 1e18 (at $2000/ETH)\n * ```\n */\nexport function useBurnQuote(\n  updAmount: bigint,\n  config?: UseBurnQuoteConfig,\n): UseBurnQuoteReturn {\n  const { price, isLoading } = useEthUsdPrice({\n    ...config,\n    enabled: updAmount > 0n && (config?.enabled ?? true),\n  })\n\n  const stEthAmount = useMemo(() => {\n    if (price === undefined || updAmount === 0n) return undefined\n    return quoteBurnUPD(updAmount, price)\n  }, [updAmount, price])\n\n  return {\n    stEthAmount,\n    ethUsdPrice: price,\n    isLoading,\n  }\n}\n","import { useWriteContract, useWaitForTransactionReceipt } from 'wagmi'\nimport type { Address, Hash } from 'viem'\nimport type { PriceAttestationQuery } from '../core/types.js'\nimport { STABILIZER_NFT_ABI } from '../contracts/index.js'\n\nexport interface UseMintUPDConfig {\n  /** Address of the StabilizerNFT contract. */\n  stabilizerNFTAddress: Address\n}\n\nexport interface UseMintUPDReturn {\n  /** Execute the mint transaction. */\n  mint: (params: {\n    to: Address\n    ethAmount: bigint\n    attestation: PriceAttestationQuery\n  }) => void\n  /** Whether the transaction is being sent. */\n  isPending: boolean\n  /** Transaction hash once submitted. */\n  txHash: Hash | undefined\n  /** Whether we're waiting for confirmation. */\n  isConfirming: boolean\n  /** Whether the transaction is confirmed. */\n  isConfirmed: boolean\n  /** Error from the transaction, if any. */\n  error: Error | null\n  /** Reset the mutation state. */\n  reset: () => void\n}\n\n/**\n * Write hook for minting UPD by depositing ETH.\n *\n * @example\n * ```tsx\n * const { mint, isPending, isConfirmed, error } = useMintUPD({\n *   stabilizerNFTAddress: deployment.contracts.StabilizerNFT,\n * })\n *\n * // Use with useEthUsdPrice to get attestation\n * const { attestation } = useEthUsdPrice()\n *\n * <button onClick={() => mint({ to: userAddress, ethAmount: parseEther('1'), attestation })}>\n *   Mint UPD\n * </button>\n * ```\n */\nexport function useMintUPD(config: UseMintUPDConfig): UseMintUPDReturn {\n  const { stabilizerNFTAddress } = config\n\n  const {\n    writeContract,\n    data: txHash,\n    isPending,\n    error: writeError,\n    reset,\n  } = useWriteContract()\n\n  const {\n    isLoading: isConfirming,\n    isSuccess: isConfirmed,\n  } = useWaitForTransactionReceipt({\n    hash: txHash,\n  })\n\n  function mint(params: {\n    to: Address\n    ethAmount: bigint\n    attestation: PriceAttestationQuery\n  }) {\n    writeContract({\n      address: stabilizerNFTAddress,\n      abi: STABILIZER_NFT_ABI,\n      functionName: 'mintUPD',\n      args: [\n        params.to,\n        {\n          price: params.attestation.price,\n          decimals: params.attestation.decimals,\n          dataTimestamp: params.attestation.dataTimestamp,\n          assetPair: params.attestation.assetPair,\n          signature: params.attestation.signature,\n        },\n      ],\n      value: params.ethAmount,\n    })\n  }\n\n  return {\n    mint,\n    isPending,\n    txHash,\n    isConfirming,\n    isConfirmed,\n    error: writeError as Error | null,\n    reset,\n  }\n}\n","import { useWriteContract, useWaitForTransactionReceipt } from 'wagmi'\nimport type { Address, Hash } from 'viem'\nimport type { PriceAttestationQuery } from '../core/types.js'\nimport { STABILIZER_NFT_ABI } from '../contracts/index.js'\n\nexport interface UseBurnUPDConfig {\n  /** Address of the StabilizerNFT contract. */\n  stabilizerNFTAddress: Address\n}\n\nexport interface UseBurnUPDReturn {\n  /** Execute the burn transaction. */\n  burn: (params: {\n    updAmount: bigint\n    attestation: PriceAttestationQuery\n  }) => void\n  /** Whether the transaction is being sent. */\n  isPending: boolean\n  /** Transaction hash once submitted. */\n  txHash: Hash | undefined\n  /** Whether we're waiting for confirmation. */\n  isConfirming: boolean\n  /** Whether the transaction is confirmed. */\n  isConfirmed: boolean\n  /** Error from the transaction, if any. */\n  error: Error | null\n  /** Reset the mutation state. */\n  reset: () => void\n}\n\n/**\n * Write hook for burning UPD to receive stETH.\n *\n * @example\n * ```tsx\n * const { burn, isPending, isConfirmed } = useBurnUPD({\n *   stabilizerNFTAddress: deployment.contracts.StabilizerNFT,\n * })\n *\n * const { attestation } = useEthUsdPrice()\n *\n * <button onClick={() => burn({ updAmount: parseUnits('1000', 18), attestation })}>\n *   Burn 1000 UPD\n * </button>\n * ```\n */\nexport function useBurnUPD(config: UseBurnUPDConfig): UseBurnUPDReturn {\n  const { stabilizerNFTAddress } = config\n\n  const {\n    writeContract,\n    data: txHash,\n    isPending,\n    error: writeError,\n    reset,\n  } = useWriteContract()\n\n  const {\n    isLoading: isConfirming,\n    isSuccess: isConfirmed,\n  } = useWaitForTransactionReceipt({\n    hash: txHash,\n  })\n\n  function burn(params: {\n    updAmount: bigint\n    attestation: PriceAttestationQuery\n  }) {\n    writeContract({\n      address: stabilizerNFTAddress,\n      abi: STABILIZER_NFT_ABI,\n      functionName: 'burnUPD',\n      args: [\n        params.updAmount,\n        {\n          price: params.attestation.price,\n          decimals: params.attestation.decimals,\n          dataTimestamp: params.attestation.dataTimestamp,\n          assetPair: params.attestation.assetPair,\n          signature: params.attestation.signature,\n        },\n      ],\n    })\n  }\n\n  return {\n    burn,\n    isPending,\n    txHash,\n    isConfirming,\n    isConfirmed,\n    error: writeError as Error | null,\n    reset,\n  }\n}\n","import { useMemo } from 'react'\nimport type { Address } from 'viem'\nimport { useCollateral, type UseCollateralConfig } from './use-collateral.js'\nimport { useEthUsdPrice, type UseEthUsdPriceConfig } from './use-eth-usd-price.js'\nimport { computeSystemHealth, type SystemHealth } from '../core/health.js'\n\nexport interface UseSystemHealthConfig {\n  /** Address of the OvercollateralizationReporter contract. */\n  reporterAddress: Address\n  /** Address of the UPD token. */\n  tokenAddress: Address\n  /** Oracle service URL. */\n  oracleUrl?: string\n  /** Minimum collateral ratio in basis points (default: 12500 = 125%). */\n  minRatioBps?: bigint\n}\n\nexport interface UseSystemHealthReturn {\n  /** Computed system health metrics, or undefined if still loading. */\n  health: SystemHealth | undefined\n  /** Whether any underlying data is still loading. */\n  isLoading: boolean\n}\n\n/**\n * System health hook — composes useCollateral + useEthUsdPrice + computeSystemHealth.\n *\n * @example\n * ```tsx\n * const { health, isLoading } = useSystemHealth({\n *   reporterAddress: deployment.contracts.OvercollateralizationReporter,\n *   tokenAddress: deployment.contracts.UPDToken,\n * })\n *\n * if (health && !health.isHealthy) {\n *   return <Alert>System undercollateralized: {health.systemCollateralRatioBps} bps</Alert>\n * }\n * ```\n */\nexport function useSystemHealth(config: UseSystemHealthConfig): UseSystemHealthReturn {\n  const collateralConfig: UseCollateralConfig = {\n    reporterAddress: config.reporterAddress,\n    tokenAddress: config.tokenAddress,\n  }\n\n  const priceConfig: UseEthUsdPriceConfig = {\n    oracleUrl: config.oracleUrl,\n  }\n\n  const {\n    totalStEthCollateral,\n    totalUPDSupply,\n    isLoading: collateralLoading,\n  } = useCollateral(collateralConfig)\n\n  const {\n    price: ethUsdPrice,\n    isLoading: priceLoading,\n  } = useEthUsdPrice(priceConfig)\n\n  const health = useMemo(() => {\n    if (\n      totalStEthCollateral === undefined ||\n      totalUPDSupply === undefined ||\n      ethUsdPrice === undefined\n    ) {\n      return undefined\n    }\n\n    return computeSystemHealth(\n      { totalStEthCollateral, totalUPDSupply },\n      ethUsdPrice,\n      config.minRatioBps,\n    )\n  }, [totalStEthCollateral, totalUPDSupply, ethUsdPrice, config.minRatioBps])\n\n  return {\n    health,\n    isLoading: collateralLoading || priceLoading,\n  }\n}\n","import { useReadContract } from 'wagmi'\nimport type { Address } from 'viem'\nimport { SUPD_ABI } from '../contracts/index.js'\n\nexport interface UseSUPDConfig {\n  /** Address of the sUPD contract. */\n  supdAddress: Address\n  /** User address to read balance for (optional). */\n  userAddress?: Address\n}\n\nexport interface UseSUPDReturn {\n  /** User's sUPD balance (18 decimals). */\n  balance: bigint | undefined\n  /** Total sUPD shares outstanding. */\n  totalSupply: bigint | undefined\n  /** Current share value with accrued yield (18 decimals). */\n  shareValue: bigint | undefined\n  /** Annual yield in basis points (e.g. 800 = 8%). */\n  annualYieldBps: bigint | undefined\n  /** Total USD liability of all outstanding sUPD. */\n  totalLiabilityUSD: bigint | undefined\n  /** Whether any read is still loading. */\n  isLoading: boolean\n}\n\n/**\n * Read hook for sUPD — share value, APY, balances, and total liability.\n *\n * @example\n * ```tsx\n * const { balance, shareValue, annualYieldBps, isLoading } = useSUPD({\n *   supdAddress: deployment.contracts.sUPD,\n *   userAddress: account.address,\n * })\n * ```\n */\nexport function useSUPD(config: UseSUPDConfig): UseSUPDReturn {\n  const { supdAddress, userAddress } = config\n\n  const { data: balance, isLoading: balLoading } = useReadContract({\n    address: supdAddress,\n    abi: SUPD_ABI,\n    functionName: 'balanceOf',\n    args: userAddress ? [userAddress] : undefined,\n    query: { enabled: !!userAddress },\n  })\n\n  const { data: totalSupply, isLoading: supplyLoading } = useReadContract({\n    address: supdAddress,\n    abi: SUPD_ABI,\n    functionName: 'totalSupply',\n  })\n\n  const { data: shareValue, isLoading: svLoading } = useReadContract({\n    address: supdAddress,\n    abi: SUPD_ABI,\n    functionName: 'currentShareValue',\n  })\n\n  const { data: annualYieldBps, isLoading: apyLoading } = useReadContract({\n    address: supdAddress,\n    abi: SUPD_ABI,\n    functionName: 'annualYieldBps',\n  })\n\n  const { data: totalLiabilityUSD, isLoading: liabLoading } = useReadContract({\n    address: supdAddress,\n    abi: SUPD_ABI,\n    functionName: 'totalLiabilityUSD',\n  })\n\n  return {\n    balance: balance as bigint | undefined,\n    totalSupply: totalSupply as bigint | undefined,\n    shareValue: shareValue as bigint | undefined,\n    annualYieldBps: annualYieldBps as bigint | undefined,\n    totalLiabilityUSD: totalLiabilityUSD as bigint | undefined,\n    isLoading: balLoading || supplyLoading || svLoading || apyLoading || liabLoading,\n  }\n}\n","import { useWriteContract, useWaitForTransactionReceipt } from 'wagmi'\nimport type { Address, Hash } from 'viem'\nimport type { PriceAttestationQuery } from '../core/types.js'\nimport { SUPD_ABI } from '../contracts/index.js'\n\nexport interface UseStakeUPDConfig {\n  /** Address of the sUPD contract. */\n  supdAddress: Address\n}\n\nexport interface UseStakeUPDReturn {\n  /** Execute the stake transaction. User must approve UPD transfer to sUPD first. */\n  stake: (params: {\n    updAmount: bigint\n    attestation: PriceAttestationQuery\n  }) => void\n  isPending: boolean\n  txHash: Hash | undefined\n  isConfirming: boolean\n  isConfirmed: boolean\n  error: Error | null\n  reset: () => void\n}\n\n/**\n * Write hook for staking UPD → sUPD.\n *\n * Note: The user must first approve the sUPD contract to spend their UPD tokens\n * (via UPDToken.approve or EIP-3009 transferWithAuthorization).\n *\n * @example\n * ```tsx\n * const { stake, isPending } = useStakeUPD({\n *   supdAddress: deployment.contracts.sUPD,\n * })\n *\n * const { attestation } = useEthUsdPrice()\n *\n * <button onClick={() => stake({ updAmount: parseUnits('1000', 18), attestation })}>\n *   Stake 1000 UPD\n * </button>\n * ```\n */\nexport function useStakeUPD(config: UseStakeUPDConfig): UseStakeUPDReturn {\n  const { supdAddress } = config\n\n  const {\n    writeContract,\n    data: txHash,\n    isPending,\n    error: writeError,\n    reset,\n  } = useWriteContract()\n\n  const {\n    isLoading: isConfirming,\n    isSuccess: isConfirmed,\n  } = useWaitForTransactionReceipt({ hash: txHash })\n\n  function stake(params: {\n    updAmount: bigint\n    attestation: PriceAttestationQuery\n  }) {\n    writeContract({\n      address: supdAddress,\n      abi: SUPD_ABI,\n      functionName: 'stakeUPD',\n      args: [\n        params.updAmount,\n        {\n          price: params.attestation.price,\n          decimals: params.attestation.decimals,\n          dataTimestamp: params.attestation.dataTimestamp,\n          assetPair: params.attestation.assetPair,\n          signature: params.attestation.signature,\n        },\n      ],\n    })\n  }\n\n  return {\n    stake,\n    isPending,\n    txHash,\n    isConfirming,\n    isConfirmed,\n    error: writeError as Error | null,\n    reset,\n  }\n}\n","import { useWriteContract, useWaitForTransactionReceipt } from 'wagmi'\nimport type { Address, Hash } from 'viem'\nimport type { PriceAttestationQuery } from '../core/types.js'\nimport { SUPD_ABI } from '../contracts/index.js'\n\nexport interface UseUnstakeUPDConfig {\n  /** Address of the sUPD contract. */\n  supdAddress: Address\n}\n\nexport interface UseUnstakeUPDReturn {\n  /** Execute the unstake transaction (unstakeToUPD — full redemption). */\n  unstake: (params: {\n    shares: bigint\n    attestation: PriceAttestationQuery\n  }) => void\n  isPending: boolean\n  txHash: Hash | undefined\n  isConfirming: boolean\n  isConfirmed: boolean\n  error: Error | null\n  reset: () => void\n}\n\n/**\n * Write hook for unstaking sUPD → UPD.\n *\n * Calls `unstakeToUPD(shares, priceQuery)` which gathers stETH from sUPD's\n * stabilizer escrows and mints fresh UPD to the caller.\n *\n * For advanced unstake variants (pro-rata, queued, with-extra-UPD), use the\n * contract ABI directly.\n *\n * @example\n * ```tsx\n * const { unstake, isPending } = useUnstakeUPD({\n *   supdAddress: deployment.contracts.sUPD,\n * })\n *\n * const { attestation } = useEthUsdPrice()\n *\n * <button onClick={() => unstake({ shares: myShares, attestation })}>\n *   Unstake\n * </button>\n * ```\n */\nexport function useUnstakeUPD(config: UseUnstakeUPDConfig): UseUnstakeUPDReturn {\n  const { supdAddress } = config\n\n  const {\n    writeContract,\n    data: txHash,\n    isPending,\n    error: writeError,\n    reset,\n  } = useWriteContract()\n\n  const {\n    isLoading: isConfirming,\n    isSuccess: isConfirmed,\n  } = useWaitForTransactionReceipt({ hash: txHash })\n\n  function unstake(params: {\n    shares: bigint\n    attestation: PriceAttestationQuery\n  }) {\n    writeContract({\n      address: supdAddress,\n      abi: SUPD_ABI,\n      functionName: 'unstakeToUPD',\n      args: [\n        params.shares,\n        {\n          price: params.attestation.price,\n          decimals: params.attestation.decimals,\n          dataTimestamp: params.attestation.dataTimestamp,\n          assetPair: params.attestation.assetPair,\n          signature: params.attestation.signature,\n        },\n      ],\n    })\n  }\n\n  return {\n    unstake,\n    isPending,\n    txHash,\n    isConfirming,\n    isConfirmed,\n    error: writeError as Error | null,\n    reset,\n  }\n}\n"]}