@augustdigital/sdk 8.22.1 → 8.25.0

package/lib/core/analytics/method-taxonomy.js

@@ -36,6 +36,16 @@ exports.METHOD_CATEGORIES = {
     getTimelockRequests: 'read.vault',
     getVaultPerformanceFees: 'read.vault',
     getVaultOracleClassification: 'read.vault',
+    // Transparency dashboard (one per card/tab)
+    getVaultPositionSnapshot: 'read.vault',
+    getVaultBackingSeries: 'read.vault',
+    getVaultSmoothedApy: 'read.vault',
+    getVaultHistoricalAllocations: 'read.vault',
+    getVaultFeeConfig: 'read.vault',
+    getVaultGovernanceRoles: 'read.vault',
+    getVaultGovernancePermissions: 'read.vault',
+    getVaultGovernanceTimelocks: 'read.vault',
+    getVaultGovernanceAuditLog: 'read.vault',
     getVaultBorrowerHealthFactor: 'read.vault',
     getYieldLastRealizedOn: 'read.vault',
     getVaultActivity: 'read.vault',

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.22.1";
+export declare const SDK_VERSION = "8.25.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.22.1';
+exports.SDK_VERSION = '8.25.0';
 //# sourceMappingURL=version.js.map

package/lib/core/attribution.d.ts

@@ -42,10 +42,15 @@ export interface IAttributionConfig {
     /**
      * EVM chain IDs to attribute. Omit to attribute writes on every EVM chain
      * (the suffix is inert on chains without an ERC-8021 indexer and costs
-     * ~16 gas per non-zero byte). When set, writes on other chains are sent
-     * without the suffix; call sites that cannot determine their chain ID
-     * append the suffix regardless, since over-attribution is harmless and
-     * under-attribution loses data.
+     * ~16 gas per non-zero byte). When set, gating is fail-closed: writes on
+     * other chains — and writes whose chain ID cannot be determined — are sent
+     * without the suffix.
+     *
+     * Over-attribution is not harmless. The suffix makes calldata longer than
+     * the ABI encoding of the call, which breaks clear-signing on hardware
+     * wallets: a Ledger rejects an over-long ERC-20 `approve` with
+     * `EthAppCommandError: Invalid data 6a80`, so an unattributed chain that
+     * receives the suffix anyway cannot be transacted on from a Ledger at all.
      */
     chains?: number[];
 }
@@ -83,13 +88,23 @@ export declare function buildAttributionSuffix(codes: string[]): string;
  *   init, not on the first write.
  */
 export declare function setAttribution(config: IAttributionConfig | null): void;
+/**
+ * Whether attribution is configured at all, independent of any chain gate.
+ *
+ * Call sites that need to know whether to resolve a chain ID before asking
+ * for the suffix use this; {@link getAttributionSuffix} applies the gate.
+ *
+ * @returns `true` when builder codes are configured.
+ */
+export declare function isAttributionEnabled(): boolean;
 /**
  * Return the active ERC-8021 suffix for a write on the given chain, or
- * `undefined` when attribution is off or the chain is excluded.
+ * `undefined` when attribution is off or the chain is not attributed.
  *
  * @param chainId EVM chain ID of the transaction, when the call site knows
- *   it. When omitted and a `chains` restriction is configured, the suffix is
- *   returned anyway (over-attribution is harmless; see
+ *   it. When a `chains` restriction is configured, gating is fail-closed: an
+ *   omitted chain ID yields no suffix, since a suffix on an unattributed
+ *   chain buys nothing and breaks hardware-wallet clear-signing (see
  *   {@link IAttributionConfig.chains}).
  * @returns `0x`-prefixed hex suffix, or `undefined` when nothing should be
  *   appended.
@@ -99,7 +114,8 @@ export declare function getAttributionSuffix(chainId?: number): string | undefin
  * Append the active attribution suffix to calldata.
  *
  * No-ops (returns `data` unchanged) when attribution is off, the chain is
- * excluded, `data` is empty/absent (plain value transfers are never
+ * not attributed (including an unknown chain under a `chains` restriction),
+ * `data` is empty/absent (plain value transfers are never
  * attributed), or `data` already ends with the ERC-8021 marker (guards
  * against double-appending when an upstream layer — e.g. a wagmi config
  * `dataSuffix` — already attributed the transaction).

package/lib/core/attribution.js

@@ -18,6 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ERC8021_MARKER = void 0;
 exports.buildAttributionSuffix = buildAttributionSuffix;
 exports.setAttribution = setAttribution;
+exports.isAttributionEnabled = isAttributionEnabled;
 exports.getAttributionSuffix = getAttributionSuffix;
 exports.appendAttributionSuffix = appendAttributionSuffix;
 /**
@@ -96,13 +97,25 @@ function setAttribution(config) {
             ? config.chains
             : null;
 }
+/**
+ * Whether attribution is configured at all, independent of any chain gate.
+ *
+ * Call sites that need to know whether to resolve a chain ID before asking
+ * for the suffix use this; {@link getAttributionSuffix} applies the gate.
+ *
+ * @returns `true` when builder codes are configured.
+ */
+function isAttributionEnabled() {
+    return activeSuffix !== null;
+}
 /**
  * Return the active ERC-8021 suffix for a write on the given chain, or
- * `undefined` when attribution is off or the chain is excluded.
+ * `undefined` when attribution is off or the chain is not attributed.
  *
  * @param chainId EVM chain ID of the transaction, when the call site knows
- *   it. When omitted and a `chains` restriction is configured, the suffix is
- *   returned anyway (over-attribution is harmless; see
+ *   it. When a `chains` restriction is configured, gating is fail-closed: an
+ *   omitted chain ID yields no suffix, since a suffix on an unattributed
+ *   chain buys nothing and breaks hardware-wallet clear-signing (see
  *   {@link IAttributionConfig.chains}).
  * @returns `0x`-prefixed hex suffix, or `undefined` when nothing should be
  *   appended.
@@ -110,7 +123,9 @@ function setAttribution(config) {
 function getAttributionSuffix(chainId) {
     if (!activeSuffix)
         return undefined;
-    if (activeChains && typeof chainId === 'number') {
+    if (activeChains) {
+        if (typeof chainId !== 'number')
+            return undefined;
         if (!activeChains.includes(chainId))
             return undefined;
     }
@@ -120,7 +135,8 @@ function getAttributionSuffix(chainId) {
  * Append the active attribution suffix to calldata.
  *
  * No-ops (returns `data` unchanged) when attribution is off, the chain is
- * excluded, `data` is empty/absent (plain value transfers are never
+ * not attributed (including an unknown chain under a `chains` restriction),
+ * `data` is empty/absent (plain value transfers are never
  * attributed), or `data` already ends with the ERC-8021 marker (guards
  * against double-appending when an upstream layer — e.g. a wagmi config
  * `dataSuffix` — already attributed the transaction).

package/lib/core/constants/core.d.ts

@@ -117,6 +117,17 @@ export declare const WEBSERVER_ENDPOINTS: {
         };
         revertReason: (txHash: string, chain: number) => string;
         oracleClassification: (vaultAddress: string, chainId: number) => string;
+        transparency: {
+            positions: (vaultAddress: string, chainId: number) => string;
+            historicalAllocations: (vaultAddress: string, chainId: number, startDate?: string, endDate?: string) => string;
+            fees: (vaultAddress: string, chainId: number) => string;
+            ratioSeries: (vaultAddress: string, startDate?: string, endDate?: string, limit?: number) => string;
+            smoothedApy: (vaultAddress: string, daysAgo: number, averagingPeriodDays: number, applySmoothing: boolean) => string;
+            governanceRoles: (vaultAddress: string, chainId: number) => string;
+            governancePermissions: (vaultAddress: string, chainId: number) => string;
+            governanceTimelocks: (vaultAddress: string, chainId: number, status?: string) => string;
+            governanceAuditLog: (vaultAddress: string, chainId: number, category?: string, before?: string, limit?: number) => string;
+        };
     };
     upshift: {
         vaults: {

package/lib/core/constants/core.js

@@ -191,6 +191,60 @@ exports.WEBSERVER_ENDPOINTS = {
             chain: String(chain),
         }).toString()}`,
         oracleClassification: (vaultAddress, chainId) => `/upshift/oracle_classification/${encodeURIComponent(vaultAddress)}?chain_id=${chainId}`,
+        // Transparency dashboard endpoints (all public, snapshot-backed).
+        transparency: {
+            positions: (vaultAddress, chainId) => `/upshift/positions/${encodeURIComponent(vaultAddress)}?chain_id=${chainId}`,
+            historicalAllocations: (vaultAddress, chainId, startDate, endDate) => {
+                const q = new URLSearchParams({ chain_id: String(chainId) });
+                if (startDate)
+                    q.set('start_date', startDate);
+                // The backend compares `<= end_date` as a datetime, so a bare date
+                // would exclude the whole last day; widen to end-of-day for the
+                // documented inclusive semantics.
+                if (endDate)
+                    q.set('end_date', `${endDate}T23:59:59.999`);
+                return `/upshift/historical_allocations/${encodeURIComponent(vaultAddress)}?${q.toString()}`;
+            },
+            fees: (vaultAddress, chainId) => `/upshift/fees/${encodeURIComponent(vaultAddress)}?chain_id=${chainId}`,
+            ratioSeries: (vaultAddress, startDate, endDate, limit) => {
+                const q = new URLSearchParams({
+                    vault_address: vaultAddress,
+                    fields: 'ratio',
+                });
+                if (startDate)
+                    q.set('start_date', startDate);
+                // See historicalAllocations: widen to end-of-day for inclusive semantics.
+                if (endDate)
+                    q.set('end_date', `${endDate}T23:59:59.999`);
+                if (limit !== undefined)
+                    q.set('limit', String(limit));
+                return `/upshift/unrealized_pnl?${q.toString()}`;
+            },
+            smoothedApy: (vaultAddress, daysAgo, averagingPeriodDays, applySmoothing) => `/upshift/historical_apy/chart?${new URLSearchParams({
+                vault_address: vaultAddress,
+                days_ago: String(daysAgo),
+                averaging_period_in_days: String(averagingPeriodDays),
+                apply_smoothing: String(applySmoothing),
+            }).toString()}`,
+            governanceRoles: (vaultAddress, chainId) => `/upshift/governance/${encodeURIComponent(vaultAddress)}/roles?chain_id=${chainId}`,
+            governancePermissions: (vaultAddress, chainId) => `/upshift/governance/${encodeURIComponent(vaultAddress)}/permissions?chain_id=${chainId}`,
+            governanceTimelocks: (vaultAddress, chainId, status) => {
+                const q = new URLSearchParams({ chain_id: String(chainId) });
+                if (status)
+                    q.set('status', status);
+                return `/upshift/governance/${encodeURIComponent(vaultAddress)}/timelocks?${q.toString()}`;
+            },
+            governanceAuditLog: (vaultAddress, chainId, category, before, limit) => {
+                const q = new URLSearchParams({ chain_id: String(chainId) });
+                if (category)
+                    q.set('category', category);
+                if (before)
+                    q.set('before', before);
+                if (limit !== undefined)
+                    q.set('limit', String(limit));
+                return `/upshift/governance/${encodeURIComponent(vaultAddress)}/audit_log?${q.toString()}`;
+            },
+        },
     },
     upshift: {
         vaults: {

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

@@ -44,7 +44,8 @@ export type CompatibleSigner = Signer | Wallet | any;
  * already ending in the ERC-8021 marker is left untouched. When the
  * configured `chains` list requires a chain check and the transaction does
  * not carry a `chainId`, the signer's provider network is consulted (one
- * cached RPC call).
+ * cached RPC call); if that lookup fails the transaction is sent
+ * unattributed.
  *
  * @param signer Normalized ethers Signer or Wallet.
  * @returns A proxied signer with an attribution-aware `sendTransaction`.

package/lib/core/helpers/signer.js

@@ -107,7 +107,8 @@ async function normalizeSigner(signer) {
  * already ending in the ERC-8021 marker is left untouched. When the
  * configured `chains` list requires a chain check and the transaction does
  * not carry a `chainId`, the signer's provider network is consulted (one
- * cached RPC call).
+ * cached RPC call); if that lookup fails the transaction is sent
+ * unattributed.
  *
  * @param signer Normalized ethers Signer or Wallet.
  * @returns A proxied signer with an attribution-aware `sendTransaction`.
@@ -117,7 +118,7 @@ function wrapSignerWithAttribution(signer) {
         get(target, prop) {
             if (prop === 'sendTransaction') {
                 return async (tx) => {
-                    if (!(0, attribution_1.getAttributionSuffix)() || typeof tx?.data !== 'string') {
+                    if (!(0, attribution_1.isAttributionEnabled)() || typeof tx?.data !== 'string') {
                         return target.sendTransaction(tx);
                     }
                     let chainId = tx.chainId != null ? Number(tx.chainId) : undefined;
@@ -126,9 +127,10 @@ function wrapSignerWithAttribution(signer) {
                             chainId = Number((await target.provider.getNetwork()).chainId);
                         }
                         catch {
-                            // Unknown chain: fall through with chainId undefined, which
-                            // appends regardless of a `chains` restriction —
-                            // over-attribution is harmless, under-attribution loses data.
+                            // Unknown chain: fall through with chainId undefined. Under a
+                            // `chains` restriction that means no suffix — attributing a
+                            // chain we cannot identify risks breaking hardware-wallet
+                            // clear-signing for a gain we cannot confirm.
                         }
                     }
                     const data = (0, attribution_1.appendAttributionSuffix)(tx.data, chainId);

package/lib/evm/methods/crossChainVault.d.ts

@@ -43,6 +43,10 @@ export declare function needsCrossChainApproval(tokenAddress: IAddress, spenderA
 /**
  * Execute a token approval for a cross-chain operation.
  *
+ * @param chainId Chain the approval is sent on, used to gate ERC-8021
+ *   attribution. Omitted means unattributed under a `chains` restriction —
+ *   the suffix would lengthen `approve` calldata past its ABI encoding and
+ *   break Ledger clear-signing.
  * @returns Transaction hash of the approval
  */
 export declare function approveCrossChain(tokenAddress: IAddress, spenderAddress: IAddress, amount: bigint, walletClient: {
@@ -56,7 +60,7 @@ export declare function approveCrossChain(tokenAddress: IAddress, spenderAddress
     }) => Promise<{
         status: string;
     }>;
-}): Promise<string>;
+}, chainId?: number): Promise<string>;
 /**
  * Execute a cross-chain deposit via LayerZero OVault. Validates the source
  * chain, ensures approval, estimates gas with a buffer, and waits for the

package/lib/evm/methods/crossChainVault.js

@@ -526,9 +526,13 @@ async function needsCrossChainApproval(tokenAddress, spenderAddress, walletAddre
 /**
  * Execute a token approval for a cross-chain operation.
  *
+ * @param chainId Chain the approval is sent on, used to gate ERC-8021
+ *   attribution. Omitted means unattributed under a `chains` restriction —
+ *   the suffix would lengthen `approve` calldata past its ABI encoding and
+ *   break Ledger clear-signing.
  * @returns Transaction hash of the approval
  */
-async function approveCrossChain(tokenAddress, spenderAddress, amount, walletClient, publicClient) {
+async function approveCrossChain(tokenAddress, spenderAddress, amount, walletClient, publicClient, chainId) {
     if (!walletClient.account) {
         throw new Error('Wallet not ready — please reconnect your wallet');
     }
@@ -538,7 +542,7 @@ async function approveCrossChain(tokenAddress, spenderAddress, amount, walletCli
         abi: OFT_1.ABI_CROSS_CHAIN_ERC20,
         functionName: 'approve',
         args: [spenderAddress, amount],
-        dataSuffix: (0, attribution_1.getAttributionSuffix)(),
+        dataSuffix: (0, attribution_1.getAttributionSuffix)(chainId),
     });
     const receipt = await publicClient.waitForTransactionReceipt({
         hash: hash,
@@ -595,7 +599,7 @@ async function crossChainVaultDeposit(props) {
             BigInt((0, core_1.toNormalizedBn)(props.amount, props.decimals).raw);
         const approvalNeeded = await needsCrossChainApproval(tokenAddr, spenderAddr, props.walletAddress, approvalAmount, publicClient);
         if (approvalNeeded) {
-            await approveCrossChain(tokenAddr, spenderAddr, approvalAmount, walletClient, publicClient);
+            await approveCrossChain(tokenAddr, spenderAddr, approvalAmount, walletClient, publicClient, props.userChainId);
         }
     }
     // 3. Estimate gas with buffer
@@ -678,7 +682,7 @@ async function crossChainVaultRedeem(props) {
     if (!props.skipApprovalCheck && txInputs.approval) {
         const approvalNeeded = await needsCrossChainApproval(txInputs.approval.tokenAddress, txInputs.approval.spender, props.walletAddress, txInputs.approval.amount, publicClient);
         if (approvalNeeded) {
-            await approveCrossChain(txInputs.approval.tokenAddress, txInputs.approval.spender, txInputs.approval.amount, walletClient, publicClient);
+            await approveCrossChain(txInputs.approval.tokenAddress, txInputs.approval.spender, txInputs.approval.amount, walletClient, publicClient, props.config.hubChainId);
         }
     }
     // 4. Estimate gas with buffer

package/lib/main.d.ts

@@ -41,8 +41,9 @@ export declare class AugustSDK extends AugustBase {
     get vaultsModule(): AugustVaults;
     /**
      * Get the backend API module instance ({@link AugustApi}) — read-only
-     * access to backend-computed data with no on-chain equivalent
-     * (unrealized-PnL series).
+     * access to backend-computed data with no on-chain equivalent: the
+     * unrealized-PnL series and the transparency dashboard (position snapshot,
+     * backing series, smoothed APY, allocations, fee config, governance).
      */
     get apiModule(): AugustApi;
     /**
@@ -119,8 +120,27 @@ export declare class AugustSDK extends AugustBase {
     }): Promise<import("./types").IVaultLoan[]>;
     /**
      * Get vault asset allocations across DeFi protocols, CeFi, and OTC positions.
+     *
+     * This is the data behind the "Vault Exposure" section of the Upshift app —
+     * a partner rendering that section in their own frontend needs only this
+     * call. Read `exposurePerCategory` for the pre-bucketed view the UI renders
+     * (`supplying` / `borrowing` / `wallet` / `lending` legs plus per-category
+     * USD totals) and `netValue` for the headline figure; the raw `defi` /
+     * `cefi` / `otc` arrays back the drill-downs. See the "Rendering the Vault
+     * Exposure section" guide in the vaults docs for a faithful reproduction.
+     *
      * @param props - Vault address and chain ID
      * @returns Detailed breakdown of vault allocations by category
+     * @example
+     * ```ts
+     * const { exposurePerCategory, netValue } = await sdk.getVaultAllocations({
+     *   vault: '0xcd69123b3FBBfC666E1f6a501da27B564C00De54',
+     *   chainId: 1,
+     * });
+     * for (const item of exposurePerCategory?.supplying ?? []) {
+     *   console.log(item.protocol, item.symbol, item.amount);
+     * }
+     * ```
      */
     getVaultAllocations(props: {
         vault: IAddress;

package/lib/main.js

@@ -146,8 +146,9 @@ class AugustSDK extends core_1.AugustBase {
     }
     /**
      * Get the backend API module instance ({@link AugustApi}) — read-only
-     * access to backend-computed data with no on-chain equivalent
-     * (unrealized-PnL series).
+     * access to backend-computed data with no on-chain equivalent: the
+     * unrealized-PnL series and the transparency dashboard (position snapshot,
+     * backing series, smoothed APY, allocations, fee config, governance).
      */
     get apiModule() {
         return this.api;
@@ -242,8 +243,27 @@ class AugustSDK extends core_1.AugustBase {
     }
     /**
      * Get vault asset allocations across DeFi protocols, CeFi, and OTC positions.
+     *
+     * This is the data behind the "Vault Exposure" section of the Upshift app —
+     * a partner rendering that section in their own frontend needs only this
+     * call. Read `exposurePerCategory` for the pre-bucketed view the UI renders
+     * (`supplying` / `borrowing` / `wallet` / `lending` legs plus per-category
+     * USD totals) and `netValue` for the headline figure; the raw `defi` /
+     * `cefi` / `otc` arrays back the drill-downs. See the "Rendering the Vault
+     * Exposure section" guide in the vaults docs for a faithful reproduction.
+     *
      * @param props - Vault address and chain ID
      * @returns Detailed breakdown of vault allocations by category
+     * @example
+     * ```ts
+     * const { exposurePerCategory, netValue } = await sdk.getVaultAllocations({
+     *   vault: '0xcd69123b3FBBfC666E1f6a501da27B564C00De54',
+     *   chainId: 1,
+     * });
+     * for (const item of exposurePerCategory?.supplying ?? []) {
+     *   console.log(item.protocol, item.symbol, item.amount);
+     * }
+     * ```
      */
     async getVaultAllocations(props) {
         return await this.vaults.getVaultAllocations(props);

package/lib/modules/api/fetcher.d.ts

@@ -1,5 +1,5 @@
 import { type IFetchAugustOptions } from '../../core';
-import type { ICollateralExcessOrDeficit, ICollateralSimulationInput, ICollateralSimulationResults, ICuratorWhitelistStatus, IDiscountFactorLadder, ILoanBookInfo, IOracleClassification, IOtcMarginRequirement, IOtcPositionRead, IRevertReason, ITimelockRequest, IVaultPerformanceFees, IWSSubaccountListItem } from '../../types';
+import type { ICollateralExcessOrDeficit, ICollateralSimulationInput, ICollateralSimulationResults, ICuratorWhitelistStatus, IDiscountFactorLadder, ILoanBookInfo, IOracleClassification, IOtcMarginRequirement, IOtcPositionRead, IRevertReason, ITimelockRequest, ITransparencyAuditLog, ITransparencyFees, ITransparencyGovernancePermissions, ITransparencyGovernanceRoles, ITransparencyHistoricalAllocations, ITransparencyPositions, ITransparencyRatioPoint, ITransparencyTimelocks, IVaultPerformanceFees, IWSSubaccountListItem } from '../../types';
 /**
  * Fetch the global loan-book aggregate (admin-only `GET /dashboard/loans`).
  */
@@ -80,3 +80,29 @@ export declare const fetchVaultPerformanceFees: (params: {
  * required.
  */
 export declare const fetchVaultOracleClassification: (vaultAddress: string, chainId: number, headers?: IFetchAugustOptions["headers"]) => Promise<IOracleClassification>;
+/** Public `GET /upshift/positions/{vault}` — latest per-wallet position snapshot. */
+export declare const fetchTransparencyPositions: (vaultAddress: string, chainId: number, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyPositions>;
+/** Public `GET /upshift/historical_allocations/{vault}` — daily per-protocol allocation history. */
+export declare const fetchTransparencyHistoricalAllocations: (vaultAddress: string, chainId: number, startDate?: string, endDate?: string, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyHistoricalAllocations>;
+/** Public `GET /upshift/fees/{vault}` — vault fee configuration. */
+export declare const fetchTransparencyFees: (vaultAddress: string, chainId: number, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyFees>;
+/** Public `GET /upshift/unrealized_pnl?fields=ratio` — hourly backing / supply / collateral-ratio series. */
+export declare const fetchTransparencyRatioSeries: (vaultAddress: string, startDate?: string, endDate?: string, limit?: number, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyRatioPoint[]>;
+/** Public `GET /upshift/historical_apy/chart` — smoothed rolling-APY series; returns the raw backend envelope. */
+export declare const fetchTransparencySmoothedApy: (vaultAddress: string, daysAgo: number, averagingPeriodDays: number, applySmoothing: boolean, headers?: IFetchAugustOptions["headers"]) => Promise<{
+    data: {
+        labels: string[];
+        values: number[];
+    };
+    average_apy?: number | null;
+    status: number;
+    error?: string | null;
+}>;
+/** Public `GET /upshift/governance/{vault}/roles` — owner/operator addresses with custody enrichment. */
+export declare const fetchTransparencyGovernanceRoles: (vaultAddress: string, chainId: number, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyGovernanceRoles>;
+/** Public `GET /upshift/governance/{vault}/permissions` — whitelisted integrations per vault wallet. */
+export declare const fetchTransparencyGovernancePermissions: (vaultAddress: string, chainId: number, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyGovernancePermissions>;
+/** Public `GET /upshift/governance/{vault}/timelocks` — timelock queue, default pending only. */
+export declare const fetchTransparencyGovernanceTimelocks: (vaultAddress: string, chainId: number, status?: string, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyTimelocks>;
+/** Public `GET /upshift/governance/{vault}/audit_log` — one page of the governance audit log. */
+export declare const fetchTransparencyGovernanceAuditLog: (vaultAddress: string, chainId: number, category?: string, before?: string, limit?: number, headers?: IFetchAugustOptions["headers"]) => Promise<ITransparencyAuditLog>;

package/lib/modules/api/fetcher.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchVaultOracleClassification = exports.fetchVaultPerformanceFees = exports.fetchTimelockRequests = exports.fetchCuratorVaultWhitelist = exports.fetchCuratorVaultSubaccounts = exports.fetchOtcMarginRequirements = exports.fetchOtcPositions = exports.fetchRevertReason = exports.fetchCollateralSimulation = exports.fetchCollateralExcessOrDeficit = exports.fetchDiscountFactors = exports.fetchDashboardLoans = void 0;
+exports.fetchTransparencyGovernanceAuditLog = exports.fetchTransparencyGovernanceTimelocks = exports.fetchTransparencyGovernancePermissions = exports.fetchTransparencyGovernanceRoles = exports.fetchTransparencySmoothedApy = exports.fetchTransparencyRatioSeries = exports.fetchTransparencyFees = exports.fetchTransparencyHistoricalAllocations = exports.fetchTransparencyPositions = exports.fetchVaultOracleClassification = exports.fetchVaultPerformanceFees = exports.fetchTimelockRequests = exports.fetchCuratorVaultWhitelist = exports.fetchCuratorVaultSubaccounts = exports.fetchOtcMarginRequirements = exports.fetchOtcPositions = exports.fetchRevertReason = exports.fetchCollateralSimulation = exports.fetchCollateralExcessOrDeficit = exports.fetchDiscountFactors = exports.fetchDashboardLoans = void 0;
 const core_1 = require("../../core");
 /**
  * Fetch the global loan-book aggregate (admin-only `GET /dashboard/loans`).
@@ -147,4 +147,41 @@ const fetchVaultOracleClassification = async (vaultAddress, chainId, headers) =>
     return response.json();
 };
 exports.fetchVaultOracleClassification = fetchVaultOracleClassification;
+/**
+ * Shared GET for the public transparency-dashboard endpoints. One HTTPS
+ * request, no RPC. `fetchAugustPublic` already maps non-2xx to typed
+ * `AugustServerError` / `AugustRateLimitError` / `AugustTimeoutError`, so
+ * this only parses the body; validation happens in the module layer.
+ */
+const fetchTransparency = async (endpoint, headers) => {
+    const response = await (0, core_1.fetchAugustPublic)(endpoint, { headers });
+    return response.json();
+};
+/** Public `GET /upshift/positions/{vault}` — latest per-wallet position snapshot. */
+const fetchTransparencyPositions = (vaultAddress, chainId, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.positions(vaultAddress, chainId), headers);
+exports.fetchTransparencyPositions = fetchTransparencyPositions;
+/** Public `GET /upshift/historical_allocations/{vault}` — daily per-protocol allocation history. */
+const fetchTransparencyHistoricalAllocations = (vaultAddress, chainId, startDate, endDate, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.historicalAllocations(vaultAddress, chainId, startDate, endDate), headers);
+exports.fetchTransparencyHistoricalAllocations = fetchTransparencyHistoricalAllocations;
+/** Public `GET /upshift/fees/{vault}` — vault fee configuration. */
+const fetchTransparencyFees = (vaultAddress, chainId, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.fees(vaultAddress, chainId), headers);
+exports.fetchTransparencyFees = fetchTransparencyFees;
+/** Public `GET /upshift/unrealized_pnl?fields=ratio` — hourly backing / supply / collateral-ratio series. */
+const fetchTransparencyRatioSeries = (vaultAddress, startDate, endDate, limit, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.ratioSeries(vaultAddress, startDate, endDate, limit), headers);
+exports.fetchTransparencyRatioSeries = fetchTransparencyRatioSeries;
+/** Public `GET /upshift/historical_apy/chart` — smoothed rolling-APY series; returns the raw backend envelope. */
+const fetchTransparencySmoothedApy = (vaultAddress, daysAgo, averagingPeriodDays, applySmoothing, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.smoothedApy(vaultAddress, daysAgo, averagingPeriodDays, applySmoothing), headers);
+exports.fetchTransparencySmoothedApy = fetchTransparencySmoothedApy;
+/** Public `GET /upshift/governance/{vault}/roles` — owner/operator addresses with custody enrichment. */
+const fetchTransparencyGovernanceRoles = (vaultAddress, chainId, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.governanceRoles(vaultAddress, chainId), headers);
+exports.fetchTransparencyGovernanceRoles = fetchTransparencyGovernanceRoles;
+/** Public `GET /upshift/governance/{vault}/permissions` — whitelisted integrations per vault wallet. */
+const fetchTransparencyGovernancePermissions = (vaultAddress, chainId, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.governancePermissions(vaultAddress, chainId), headers);
+exports.fetchTransparencyGovernancePermissions = fetchTransparencyGovernancePermissions;
+/** Public `GET /upshift/governance/{vault}/timelocks` — timelock queue, default pending only. */
+const fetchTransparencyGovernanceTimelocks = (vaultAddress, chainId, status, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.governanceTimelocks(vaultAddress, chainId, status), headers);
+exports.fetchTransparencyGovernanceTimelocks = fetchTransparencyGovernanceTimelocks;
+/** Public `GET /upshift/governance/{vault}/audit_log` — one page of the governance audit log. */
+const fetchTransparencyGovernanceAuditLog = (vaultAddress, chainId, category, before, limit, headers) => fetchTransparency(core_1.WEBSERVER_ENDPOINTS.public.transparency.governanceAuditLog(vaultAddress, chainId, category, before, limit), headers);
+exports.fetchTransparencyGovernanceAuditLog = fetchTransparencyGovernanceAuditLog;
 //# sourceMappingURL=fetcher.js.map