@augustdigital/sdk 8.13.0 → 8.14.0

package/lib/core/analytics/version.d.ts

@@ -3,4 +3,4 @@
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-export declare const SDK_VERSION = "8.13.0";
+export declare const SDK_VERSION = "8.14.0";

package/lib/core/analytics/version.js

@@ -6,5 +6,5 @@ exports.SDK_VERSION = void 0;
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-exports.SDK_VERSION = '8.13.0';
+exports.SDK_VERSION = '8.14.0';
 //# sourceMappingURL=version.js.map

package/lib/core/helpers/vaults.d.ts

@@ -46,3 +46,44 @@ export declare const SUBGRAPH_POOL_URLS: (apiKey: string, chainId?: number, pool
  *   generated fallback.
  */
 export declare const getDefaultSubgraphUrl: (_network: string, _symbol: string) => string | undefined;
+/**
+ * Resolve whether a single fee (management or performance) is currently waived.
+ *
+ * Backend-driven, per AUGUST-5584. This centralizes logic that previously lived —
+ * and diverged — across two upshift-app components. The resolution is deliberately
+ * split between the backend and the SDK:
+ *
+ * - The backend `isFeeWaivedToggle` (`platform_fee_override.is_fee_waived`) is both
+ *   the master enable AND the TVL latch. Retool config takes precedence over live
+ *   TVL, and the backend flips this flag `false` once live TVL crosses the
+ *   configured threshold. That flip is one-way: if TVL later falls back below the
+ *   threshold the waiver does NOT re-apply. The SDK therefore does no TVL math and
+ *   never reads `latest_reported_tvl` here — trusting the flag preserves the latch.
+ * - The **date** window is time-dependent, so it cannot be a static DB flag; the SDK
+ *   evaluates it live against the clock.
+ *
+ * Resolution:
+ * - Toggle off  → never waived (also the only "hide" path once TVL trips the latch).
+ * - Toggle on, both date and TVL blank → indefinite manual waiver → waived.
+ * - Toggle on with a date window → waived while `now < waivedUntilDate`.
+ * - Toggle on with a TVL threshold configured → waived (the backend keeps the toggle
+ *   on only while live TVL is under the threshold).
+ *
+ * @param isFeeWaivedToggle - Backend master/TVL-latch flag. `false` ⇒ never waived.
+ * @param waivedUntilDate - ISO datetime string the waiver runs until, or `null` for
+ *   no date window. An unparseable string yields `NaN`, which is never `> now`, so
+ *   it correctly contributes no date-based waiver.
+ * @param waivedUntilTvl - Configured TVL threshold in whole USD, or `null`. Used only
+ *   to detect that a TVL-based waiver was set (values `<= 0` are treated as unset);
+ *   the threshold comparison itself is owned by the backend.
+ * @param now - Clock, injected for deterministic testing. Defaults to `new Date()`.
+ * @returns `true` if the UI should present this fee as "Fee Waived" right now.
+ * @example
+ * ```ts
+ * // Toggle on, 30-day window still open → waived.
+ * resolveFeeWaived(true, '2099-01-01T00:00:00Z', null); // true
+ * // Toggle off overrides everything → not waived.
+ * resolveFeeWaived(false, '2099-01-01T00:00:00Z', 10_000_000); // false
+ * ```
+ */
+export declare function resolveFeeWaived(isFeeWaivedToggle: boolean, waivedUntilDate: string | null, waivedUntilTvl: number | null, now?: Date): boolean;

package/lib/core/helpers/vaults.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDefaultSubgraphUrl = exports.SUBGRAPH_POOL_URLS = exports.AVAX_PRICE_FEED_ADDRESS = exports.REWARD_DISTRIBUTOR_ADDRESS = exports.getVaultVersionV2 = exports.getVaultVersion = exports.getAddressChainType = exports.isBadVault = exports.isBadTransaction = void 0;
 exports.getVaultSymbol = getVaultSymbol;
+exports.resolveFeeWaived = resolveFeeWaived;
 const ethers_1 = require("ethers");
 const vaults_1 = require("../constants/vaults");
 const web3_1 = require("./web3");
@@ -179,4 +180,56 @@ const getDefaultSubgraphUrl = (_network, _symbol) => {
     return undefined;
 };
 exports.getDefaultSubgraphUrl = getDefaultSubgraphUrl;
+/**
+ * Resolve whether a single fee (management or performance) is currently waived.
+ *
+ * Backend-driven, per AUGUST-5584. This centralizes logic that previously lived —
+ * and diverged — across two upshift-app components. The resolution is deliberately
+ * split between the backend and the SDK:
+ *
+ * - The backend `isFeeWaivedToggle` (`platform_fee_override.is_fee_waived`) is both
+ *   the master enable AND the TVL latch. Retool config takes precedence over live
+ *   TVL, and the backend flips this flag `false` once live TVL crosses the
+ *   configured threshold. That flip is one-way: if TVL later falls back below the
+ *   threshold the waiver does NOT re-apply. The SDK therefore does no TVL math and
+ *   never reads `latest_reported_tvl` here — trusting the flag preserves the latch.
+ * - The **date** window is time-dependent, so it cannot be a static DB flag; the SDK
+ *   evaluates it live against the clock.
+ *
+ * Resolution:
+ * - Toggle off  → never waived (also the only "hide" path once TVL trips the latch).
+ * - Toggle on, both date and TVL blank → indefinite manual waiver → waived.
+ * - Toggle on with a date window → waived while `now < waivedUntilDate`.
+ * - Toggle on with a TVL threshold configured → waived (the backend keeps the toggle
+ *   on only while live TVL is under the threshold).
+ *
+ * @param isFeeWaivedToggle - Backend master/TVL-latch flag. `false` ⇒ never waived.
+ * @param waivedUntilDate - ISO datetime string the waiver runs until, or `null` for
+ *   no date window. An unparseable string yields `NaN`, which is never `> now`, so
+ *   it correctly contributes no date-based waiver.
+ * @param waivedUntilTvl - Configured TVL threshold in whole USD, or `null`. Used only
+ *   to detect that a TVL-based waiver was set (values `<= 0` are treated as unset);
+ *   the threshold comparison itself is owned by the backend.
+ * @param now - Clock, injected for deterministic testing. Defaults to `new Date()`.
+ * @returns `true` if the UI should present this fee as "Fee Waived" right now.
+ * @example
+ * ```ts
+ * // Toggle on, 30-day window still open → waived.
+ * resolveFeeWaived(true, '2099-01-01T00:00:00Z', null); // true
+ * // Toggle off overrides everything → not waived.
+ * resolveFeeWaived(false, '2099-01-01T00:00:00Z', 10_000_000); // false
+ * ```
+ */
+function resolveFeeWaived(isFeeWaivedToggle, waivedUntilDate, waivedUntilTvl, now = new Date()) {
+    // Master toggle off ⇒ never waived. Also satisfies the one-way TVL latch: the
+    // backend has already flipped this false when live TVL crossed the threshold.
+    if (!isFeeWaivedToggle)
+        return false;
+    const isDateActive = waivedUntilDate != null && new Date(waivedUntilDate) > now;
+    const isTvlConfigured = waivedUntilTvl != null && waivedUntilTvl > 0;
+    // Toggle on but neither trigger configured ⇒ indefinite manual waiver.
+    if (waivedUntilDate == null && !isTvlConfigured)
+        return true;
+    return isDateActive || isTvlConfigured;
+}
 //# sourceMappingURL=vaults.js.map

package/lib/modules/vaults/utils.js

@@ -353,10 +353,10 @@ function buildBackendVault(tokenizedVault, overrides) {
         fees: {
             performance: tokenizedVault.weekly_performance_fee_bps || 0,
             management: tokenizedVault.platform_fee_override?.management_fee || 0,
-            isManagementWaived: false,
+            isManagementWaived: (0, vaults_1.resolveFeeWaived)(tokenizedVault.platform_fee_override?.is_fee_waived ?? false, tokenizedVault.management_fee_waived_until_date ?? null, tokenizedVault.management_fee_waived_until_tvl ?? null),
             managementFeeWaivedUntilDate: tokenizedVault.management_fee_waived_until_date ?? null,
             managementFeeWaivedUntilTvl: tokenizedVault.management_fee_waived_until_tvl ?? null,
-            isPerformanceWaived: false,
+            isPerformanceWaived: (0, vaults_1.resolveFeeWaived)(tokenizedVault.platform_fee_override?.is_fee_waived ?? false, tokenizedVault.performance_fee_waived_until_date ?? null, tokenizedVault.performance_fee_waived_until_tvl ?? null),
             performanceFeeWaivedUntilDate: tokenizedVault.performance_fee_waived_until_date ?? null,
             performanceFeeWaivedUntilTvl: tokenizedVault.performance_fee_waived_until_tvl ?? null,
         },
@@ -466,10 +466,10 @@ async function buildFormattedVault(provider, tokenizedVault, contractCalls) {
         fees: {
             performance: tokenizedVault.weekly_performance_fee_bps,
             management: tokenizedVault.platform_fee_override.management_fee,
-            isManagementWaived: tokenizedVault.platform_fee_override.is_fee_waived,
+            isManagementWaived: (0, vaults_1.resolveFeeWaived)(tokenizedVault.platform_fee_override.is_fee_waived, tokenizedVault.management_fee_waived_until_date, tokenizedVault.management_fee_waived_until_tvl),
             managementFeeWaivedUntilDate: tokenizedVault.management_fee_waived_until_date,
             managementFeeWaivedUntilTvl: tokenizedVault.management_fee_waived_until_tvl,
-            isPerformanceWaived: tokenizedVault.platform_fee_override.is_fee_waived,
+            isPerformanceWaived: (0, vaults_1.resolveFeeWaived)(tokenizedVault.platform_fee_override.is_fee_waived, tokenizedVault.performance_fee_waived_until_date, tokenizedVault.performance_fee_waived_until_tvl),
             performanceFeeWaivedUntilDate: tokenizedVault.performance_fee_waived_until_date,
             performanceFeeWaivedUntilTvl: tokenizedVault.performance_fee_waived_until_tvl,
         },

package/lib/sdk.d.ts

@@ -23141,6 +23141,48 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
 
             /* Excluded from this release type: resolveDepositTokenDecimals */
 
+            /**
+             * Resolve whether a single fee (management or performance) is currently waived.
+             *
+             * Backend-driven, per AUGUST-5584. This centralizes logic that previously lived —
+             * and diverged — across two upshift-app components. The resolution is deliberately
+             * split between the backend and the SDK:
+             *
+             * - The backend `isFeeWaivedToggle` (`platform_fee_override.is_fee_waived`) is both
+             *   the master enable AND the TVL latch. Retool config takes precedence over live
+             *   TVL, and the backend flips this flag `false` once live TVL crosses the
+             *   configured threshold. That flip is one-way: if TVL later falls back below the
+             *   threshold the waiver does NOT re-apply. The SDK therefore does no TVL math and
+             *   never reads `latest_reported_tvl` here — trusting the flag preserves the latch.
+             * - The **date** window is time-dependent, so it cannot be a static DB flag; the SDK
+             *   evaluates it live against the clock.
+             *
+             * Resolution:
+             * - Toggle off  → never waived (also the only "hide" path once TVL trips the latch).
+             * - Toggle on, both date and TVL blank → indefinite manual waiver → waived.
+             * - Toggle on with a date window → waived while `now < waivedUntilDate`.
+             * - Toggle on with a TVL threshold configured → waived (the backend keeps the toggle
+             *   on only while live TVL is under the threshold).
+             *
+             * @param isFeeWaivedToggle - Backend master/TVL-latch flag. `false` ⇒ never waived.
+             * @param waivedUntilDate - ISO datetime string the waiver runs until, or `null` for
+             *   no date window. An unparseable string yields `NaN`, which is never `> now`, so
+             *   it correctly contributes no date-based waiver.
+             * @param waivedUntilTvl - Configured TVL threshold in whole USD, or `null`. Used only
+             *   to detect that a TVL-based waiver was set (values `<= 0` are treated as unset);
+             *   the threshold comparison itself is owned by the backend.
+             * @param now - Clock, injected for deterministic testing. Defaults to `new Date()`.
+             * @returns `true` if the UI should present this fee as "Fee Waived" right now.
+             * @example
+             * ```ts
+             * // Toggle on, 30-day window still open → waived.
+             * resolveFeeWaived(true, '2099-01-01T00:00:00Z', null); // true
+             * // Toggle off overrides everything → not waived.
+             * resolveFeeWaived(false, '2099-01-01T00:00:00Z', 10_000_000); // false
+             * ```
+             */
+            export declare function resolveFeeWaived(isFeeWaivedToggle: boolean, waivedUntilDate: string | null, waivedUntilTvl: number | null, now?: Date): boolean;
+
             /**
              * Normalize an optional origin code to the value to send on-chain.
              *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augustdigital/sdk",
-  "version": "8.13.0",
+  "version": "8.14.0",
   "main": "lib/index.js",
   "types": "lib/sdk.d.ts",
   "keywords": [