@zofai/zo-sdk 0.1.93 → 0.1.94

package/src/interfaces/base.ts

@@ -18,6 +18,32 @@ export interface IBaseMarketValuationInfo {
   apr?: number
 }
 
+export interface ISwapFeeBreakdown {
+  /** Swap notional value (in USD terms using oracle prices) */
+  swapValue: number
+  /** Total value of all vaults (in USD terms using oracle prices) */
+  totalVaultsValue: number
+
+  /** Rebase fee rate applied to swap-in leg (source token) */
+  rebaseFeeInRate: number
+  /** Rebase fee rate applied to swap-out leg (dest token) */
+  rebaseFeeOutRate: number
+  /** Rebase fee value for swap-in leg (USD value) */
+  rebaseFeeInValue: number
+  /** Rebase fee value for swap-out leg (USD value) */
+  rebaseFeeOutValue: number
+
+  /** Swap impact fee value (USD value) */
+  swapImpactFeeValue: number
+  /** EMA volatility fee value (USD value) */
+  emaVolatilityFeeValue: number
+
+  /** Sum of all fee components (USD value) */
+  totalFeeValue: number
+  /** totalFeeValue / swapValue (0 when swapValue is 0) */
+  totalFeeRate: number
+}
+
 export interface IBaseMarketInfo {
   lpSupply: string
   positionId: string

package/src/interfaces/slp.ts

@@ -25,6 +25,7 @@ import type {
   IBaseStakePool,
   IBaseSymbolInfo,
   IBaseVaultInfo,
+  ISwapFeeBreakdown,
 } from './base'
 
 // SLP-specific interfaces
@@ -102,6 +103,10 @@ export interface ISLPOiFundingState {
   enabled: boolean
   last_update: number
   model: ISLPOiFundingModel
+  /** OI cap for long side (optional; when set with maxOiShort, uses capped skew formula) */
+  maxOiLong?: number
+  /** OI cap for short side (optional; when set with maxOiLong, uses capped skew formula) */
+  maxOiShort?: number
 }
 
 /**
@@ -211,6 +216,7 @@ export interface ISLPDataAPI extends IBaseDataAPI {
   getCumulativeApr: () => Promise<number>
   getSymbolConfig: (indexToken: string, long: boolean) => Promise<ISLPSymbolConfig | null>
   getPriceImpactConfig: (indexToken: string) => Promise<ISLPPriceImpactConfig | null>
+  calculateSwapFeeBreakdown: (fromToken: string, toToken: string, fromAmount: number) => Promise<ISwapFeeBreakdown>
 }
 
 // SLP-specific API interface

package/src/interfaces/usdz.ts

@@ -23,6 +23,7 @@ import type {
   IBaseStakePool,
   IBaseSymbolInfo,
   IBaseVaultInfo,
+  ISwapFeeBreakdown,
 } from './base'
 
 // USDZ-specific interfaces
@@ -103,6 +104,10 @@ export interface IUSDZOiFundingState {
   enabled: boolean
   last_update: number
   model: IUSDZOiFundingModel
+  /** OI cap for long side (optional; when set with maxOiShort, uses capped skew formula) */
+  maxOiLong?: number
+  /** OI cap for short side (optional; when set with maxOiLong, uses capped skew formula) */
+  maxOiShort?: number
 }
 
 /**
@@ -133,6 +138,7 @@ export interface IUSDZPriceImpactConfig {
 export interface IUSDZDataAPI extends IBaseDataAPI {
   getSymbolConfig: (indexToken: string, long: boolean) => Promise<IUSDZSymbolConfig | null>
   getPriceImpactConfig: (indexToken: string) => Promise<IUSDZPriceImpactConfig | null>
+  calculateSwapFeeBreakdown: (fromToken: string, toToken: string, fromAmount: number) => Promise<ISwapFeeBreakdown>
 }
 
 // USDZ-specific API interface

package/src/interfaces/zlp.ts

@@ -23,6 +23,7 @@ import type {
   IBaseStakePool,
   IBaseSymbolInfo,
   IBaseVaultInfo,
+  ISwapFeeBreakdown,
 } from './base'
 
 // ZLP-specific interfaces
@@ -103,6 +104,10 @@ export interface IZLPOiFundingState {
   enabled: boolean
   last_update: number
   model: IZLPOiFundingModel
+  /** OI cap for long side (optional; when set with maxOiShort, uses capped skew formula) */
+  maxOiLong?: number
+  /** OI cap for short side (optional; when set with maxOiLong, uses capped skew formula) */
+  maxOiShort?: number
 }
 
 /**
@@ -133,6 +138,7 @@ export interface IZLPPriceImpactConfig {
 export interface IZLPDataAPI extends IBaseDataAPI {
   getSymbolConfig: (indexToken: string, long: boolean) => Promise<IZLPSymbolConfig | null>
   getPriceImpactConfig: (indexToken: string) => Promise<IZLPPriceImpactConfig | null>
+  calculateSwapFeeBreakdown: (fromToken: string, toToken: string, fromAmount: number) => Promise<ISwapFeeBreakdown>
 }
 
 // ZLP-specific API interface