@augustdigital/sdk 9.12.0 → 9.13.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 = "9.12.0";
+export declare const SDK_VERSION = "9.13.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 = '9.12.0';
+exports.SDK_VERSION = '9.13.0';
 //# sourceMappingURL=version.js.map

package/lib/modules/vaults/utils.d.ts

@@ -82,6 +82,14 @@ export declare function formatVaultApy(tokenizedVault: ITokenizedVault): IVault[
  *   the trailing `Z` is preserved.
  */
 export declare function mapVaultFreshness(tokenizedVault: ITokenizedVault | undefined | null): IVaultFreshness | null;
+/**
+ * Map a wrapper vault's link to the vault it wraps.
+ *
+ * @param tokenizedVault - Backend tokenized-vault payload.
+ * @returns The underlying vault address (casing preserved) and chain id, both
+ *   null for a non-wrapper vault. A chain id without an address is dropped.
+ */
+export declare function mapUnderlyingVault(tokenizedVault: ITokenizedVault | undefined | null): Pick<IVault, 'underlyingVaultAddress' | 'underlyingChainId'>;
 /**
  * Map strategists from backend subaccounts or hardcoded list.
  * Shared across all chain adapters.

package/lib/modules/vaults/utils.js

@@ -7,6 +7,7 @@ exports.getIdleAssets = getIdleAssets;
 exports.getYieldLastRealizedOn = getYieldLastRealizedOn;
 exports.formatVaultApy = formatVaultApy;
 exports.mapVaultFreshness = mapVaultFreshness;
+exports.mapUnderlyingVault = mapUnderlyingVault;
 exports.mapStrategists = mapStrategists;
 exports.mapComposabilityIntegrations = mapComposabilityIntegrations;
 exports.backendTvlToNormalizedBn = backendTvlToNormalizedBn;
@@ -268,6 +269,22 @@ function mapVaultFreshness(tokenizedVault) {
         cachedAt: freshness.cached_at ?? null,
     };
 }
+/**
+ * Map a wrapper vault's link to the vault it wraps.
+ *
+ * @param tokenizedVault - Backend tokenized-vault payload.
+ * @returns The underlying vault address (casing preserved) and chain id, both
+ *   null for a non-wrapper vault. A chain id without an address is dropped.
+ */
+function mapUnderlyingVault(tokenizedVault) {
+    const address = tokenizedVault?.underlying_vault_address;
+    if (!address)
+        return { underlyingVaultAddress: null, underlyingChainId: null };
+    return {
+        underlyingVaultAddress: address,
+        underlyingChainId: tokenizedVault?.underlying_chain ?? null,
+    };
+}
 /**
  * Map strategists from backend subaccounts or hardcoded list.
  * Shared across all chain adapters.
@@ -437,6 +454,7 @@ function buildBackendVault(tokenizedVault, overrides) {
         dailyPnlPerShare: mapDailyPnlPerShare(tokenizedVault.daily_pnl_per_share),
         enabled_historical_price_horizons: tokenizedVault.enabled_historical_price_horizons || [],
         latest_reported_tvl: tokenizedVault.latest_reported_tvl,
+        ...mapUnderlyingVault(tokenizedVault),
         defaultApyHorizon: tokenizedVault.default_apy_horizon,
         ...(tokenizedVault.instant_redeem_config
             ? {
@@ -659,6 +677,7 @@ async function buildFormattedVault(provider, tokenizedVault, contractCalls) {
         enabled_historical_price_horizons: tokenizedVault?.enabled_historical_price_horizons,
         defaultApyHorizon: tokenizedVault?.default_apy_horizon ?? null,
         latest_reported_tvl: tokenizedVault?.latest_reported_tvl,
+        ...mapUnderlyingVault(tokenizedVault),
         cachedAt: tokenizedVault?.cached_at ?? null,
         freshness: mapVaultFreshness(tokenizedVault),
         showCapFilled: tokenizedVault?.show_cap_filled ?? null,

package/lib/sdk.d.ts

@@ -24276,6 +24276,14 @@ declare type AsArray<T> = T extends readonly unknown[] ? T : never;
                                                                              enabled_historical_price_horizons?: number[];
                                                                              defaultApyHorizon?: 7 | 30 | null;
                                                                              latest_reported_tvl?: number | null;
+                                                                             /**
+                                                                              * Wrapper vaults only: the vault this one wraps, which holds the assets. A
+                                                                              * wrapper's own on-chain `totalAssets` reads 0, so its TVL is the underlying
+                                                                              * vault's. Null on a non-wrapper vault. Address casing is preserved verbatim.
+                                                                              */
+                                                                             underlyingVaultAddress?: VaultAddress | null;
+                                                                             /** Chain id of {@link IVault.underlyingVaultAddress}; null on a non-wrapper vault. */
+                                                                             underlyingChainId?: number | null;
                                                                              cachedAt?: string | null;
                                                                              /**
                                                                               * Provenance timestamps for the vault's server-side data — when its APY was last
@@ -25621,6 +25629,15 @@ declare type AsArray<T> = T extends readonly unknown[] ? T : never;
                                                                              website_url: string;
                                                                          }[];
 
+                                                                         /**
+                                                                          * Map a wrapper vault's link to the vault it wraps.
+                                                                          *
+                                                                          * @param tokenizedVault - Backend tokenized-vault payload.
+                                                                          * @returns The underlying vault address (casing preserved) and chain id, both
+                                                                          *   null for a non-wrapper vault. A chain id without an address is dropped.
+                                                                          */
+                                                                         export declare function mapUnderlyingVault(tokenizedVault: ITokenizedVault | undefined | null): Pick<IVault, 'underlyingVaultAddress' | 'underlyingChainId'>;
+
                                                                          /**
                                                                           * Map the backend `freshness` object onto the camelCased {@link IVaultFreshness}
                                                                           * shape carried on `IVault`. Shared across all chain adapters (EVM, Solana,

package/lib/types/vaults.d.ts

@@ -383,6 +383,14 @@ export interface IVault {
     enabled_historical_price_horizons?: number[];
     defaultApyHorizon?: 7 | 30 | null;
     latest_reported_tvl?: number | null;
+    /**
+     * Wrapper vaults only: the vault this one wraps, which holds the assets. A
+     * wrapper's own on-chain `totalAssets` reads 0, so its TVL is the underlying
+     * vault's. Null on a non-wrapper vault. Address casing is preserved verbatim.
+     */
+    underlyingVaultAddress?: VaultAddress | null;
+    /** Chain id of {@link IVault.underlyingVaultAddress}; null on a non-wrapper vault. */
+    underlyingChainId?: number | null;
     cachedAt?: string | null;
     /**
      * Provenance timestamps for the vault's server-side data — when its APY was last

package/package.json

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