@glamsystems/glam-sdk 1.0.7 → 1.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glamsystems/glam-sdk",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "TypeScript SDK for the GLAM Protocol",
   "main": "./index.cjs.js",
   "module": "./index.esm.js",
@@ -29,10 +29,11 @@
     "bs58": "^6.0.0",
     "buffer": "^6.0.3",
     "decimal.js": "^10.6.0",
+    "fzstd": "^0.1.1",
     "zod": "^3.24.3"
   },
   "engines": {
-    "node": ">=20.18.0"
+    "node": ">=20.20.0"
   },
   "devDependencies": {
     "@rollup/plugin-terser": "^0.4.4"

package/src/assets.d.ts

@@ -43,4 +43,4 @@ export declare const USDC_ORACLE: PublicKey;
  * @param cluster The cluster network (defaults to mainnet)
  * @returns Metadata of the asset
  */
-export declare function getAssetMeta(assetMint: string, cluster?: ClusterNetwork): AssetMeta;
+export declare function getAssetMeta(assetMint: string | PublicKey, cluster?: ClusterNetwork): AssetMeta;

package/src/client/base.d.ts

@@ -6,6 +6,7 @@ import { ExtCctpProgram, ExtDriftProgram, ExtKaminoProgram, ExtMarinadeProgram,
 import { ClusterNetwork, GlamClientConfig } from "../clientConfig";
 import { RequestQueue, StateAccount, StateModel } from "../models";
 import { BlockhashWithCache } from "../utils/blockhash";
+import { JupiterApiClient } from "../utils";
 export type TxOptions = {
     signer?: PublicKey;
     computeUnitLimit?: number;
@@ -32,6 +33,7 @@ export declare class BaseClient {
     provider: anchor.Provider;
     blockhashWithCache: BlockhashWithCache;
     jupiterApiKey?: string;
+    jupiterApiClient?: JupiterApiClient;
     private _protocolProgram?;
     private _mintProgram?;
     private _extSplProgram?;

package/src/client/cctp.d.ts

@@ -1,5 +1,5 @@
 import { BN } from "@coral-xyz/anchor";
-import { PublicKey, VersionedTransaction, TransactionSignature, Keypair, Commitment, Finality, TransactionInstruction } from "@solana/web3.js";
+import { PublicKey, VersionedTransaction, TransactionSignature, Keypair, Commitment, Finality, TransactionInstruction, VersionedTransactionResponse } from "@solana/web3.js";
 import { BaseClient, BaseTxBuilder, TxOptions } from "./base";
 export declare class CctpBridgeEvent {
     readonly amount: BN;
@@ -122,6 +122,7 @@ export declare class CctpClient {
         txHash?: string;
         nonce?: string;
     }): Promise<CctpBridgeEvent[]>;
+    getTransactions(signatures: string[], batchSize: number, commitment?: Finality): Promise<VersionedTransactionResponse[]>;
     /**
      * Get incoming bridge events (EVM -> Solana)
      *

package/src/client/price.d.ts

@@ -7,6 +7,17 @@ import { DriftProtocolClient, DriftVaultsClient } from "./drift";
 import { PkMap, PkSet } from "../utils";
 import { DriftSpotMarket, DriftPerpMarket, DriftVault, KVaultState, Reserve, DriftVaultDepositor } from "../deser";
 import { JupiterApiClient, TokenListItem } from "../utils/jupiterApi";
+/**
+ * Represents a single asset holding within a vault.
+ *
+ * @param mintAddress - The SPL token mint address of the held asset
+ * @param decimals - Number of decimal places for the token (e.g., 6 for USDC, 9 for SOL)
+ * @param amount - Unsigned token amount in native units; direction (deposit/borrow) is in protocolMeta
+ * @param price - Current price of the asset denominated in the base asset (e.g., USD, SOL)
+ * @param priceMeta - Additional pricing context (e.g., source, slot, base asset). Default base asset, if not specified, is USD.
+ * @param protocol - Protocol identifier where the asset is allocated
+ * @param protocolMeta - Protocol-specific metadata (e.g., market index, position direction, reserve address)
+ */
 export declare class Holding {
     readonly mintAddress: PublicKey;
     readonly decimals: number;
@@ -18,6 +29,17 @@ export declare class Holding {
     readonly uiAmount: number;
     constructor(mintAddress: PublicKey, decimals: number, amount: BN, price: number, priceMeta: Record<string, any> | undefined, protocol: string, protocolMeta?: Record<string, any>);
 }
+/**
+ * Aggregates all holdings for a GLAM vault.
+ * Includes token balances, DeFi positions (Drift, Kamino).
+ *
+ * @param vaultState - The vault's state account address (stores vault configuration)
+ * @param vaultPda - The vault's PDA that holds tokens and positions
+ * @param priceBaseAssetMint - The base asset mint used for pricing (e.g., PublicKey.default for USD, So11111111111111111111111111111111111111112 for SOL)
+ * @param slot - The Solana slot at which holdings were fetched
+ * @param timestamp - Unix timestamp (seconds) when holdings were fetched
+ * @param commitment - The Solana commitment level used for fetching account data
+ */
 export declare class VaultHoldings {
     readonly vaultState: PublicKey;
     readonly vaultPda: PublicKey;
@@ -48,22 +70,45 @@ export declare class PriceClient {
     /**
      * Fetches all holdings in the vault.
      *
+     * The source of truth for external positions is the `externalPositions` array
+     * from the state account, which tracks:
+     * - Drift user PDAs (direct trading positions)
+     * - Drift vault depositor accounts (shares in drift vaults)
+     * - Kamino obligation accounts (lending positions)
+     * - Kamino vault share ATAs (shares in kamino vaults)
+     *
      * @param commitment Commitment level for fetching accounts
-     * @param priceBaseAssetMint Price reference/numeraire asset mint (default: USD)
+     * @param priceBaseAssetMint Price reference/numeraire asset mint (default: PublicKey.default for USD).
+     *                           Pass a token mint (e.g., WSOL) to get prices denominated in that asset.
      * @returns VaultHoldings object containing all holdings
      */
     getVaultHoldings(commitment: Commitment, priceBaseAssetMint?: PublicKey): Promise<VaultHoldings>;
     getPubkeysForTokenHoldings(externalPositionsSet: PkSet, commitment?: Commitment): Promise<PublicKey[]>;
     getPubkeysForSpotHoldings(driftUserPdas: PublicKey[], commitment?: Commitment): Promise<PkMap<PkSet>>;
     getPubkeysForPerpHoldings(driftUserPdas: PublicKey[], commitment?: Commitment): Promise<PkMap<PkSet>>;
-    getDepositorsAndDriftVaults(commitment?: Commitment): Promise<PkMap<DriftVault>>;
-    getKaminoVaultStates(externalPositionsSet: PkSet, commitment?: Commitment): Promise<PkMap<KVaultState>>;
-    getPubkeysForKaminoHoldings(commitment?: Commitment): Promise<PkMap<PkSet>>;
-    getTokenHoldings(tokenAccountPubkeys: PublicKey[], accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Holding[];
-    getDriftHoldings(userPubkeys: Iterable<PublicKey>, spotMarketsMap: PkMap<DriftSpotMarket>, perpMarketsMap: PkMap<DriftPerpMarket>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Holding[];
-    getDriftVaultsHoldings(dvaultDepositorsAndVaults: PkMap<DriftVault>, dvaultDepositorsMap: PkMap<DriftVaultDepositor>, spotMarketsMap: PkMap<DriftSpotMarket>, perpMarketsMap: PkMap<DriftPerpMarket>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Holding[];
-    getKaminoLendHoldings(obligationPubkeys: Iterable<PublicKey>, reservesMap: PkMap<Reserve>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Holding[];
-    getKaminoVaultsHoldings(kvaultAtasAndStates: PkMap<KVaultState>, reservesMap: PkMap<Reserve>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Holding[];
+    /**
+     * Parses drift vault depositors from known pubkeys.
+     */
+    getDepositorsAndDriftVaults(depositorPubkeys: PublicKey[], commitment?: Commitment): Promise<PkMap<DriftVault>>;
+    /**
+     * Gets kamino obligation reserves from known obligation pubkeys.
+     */
+    getPubkeysForKaminoHoldings(obligationPubkeys: PublicKey[], commitment?: Commitment): Promise<PkMap<PkSet>>;
+    /**
+     * Gets kamino vault states from known share ATA pubkeys.
+     * Used by getVaultHoldingsV2 to process vault shares from externalPositions.
+     */
+    getKaminoVaultStatesFromAtas(shareAtaPubkeys: PublicKey[], commitment?: Commitment): Promise<PkMap<KVaultState>>;
+    /**
+     * Fetches token price from the prefetched map, falling back to Jupiter API if not found.
+     * @throws Error if price cannot be fetched from either source
+     */
+    private getTokenPrice;
+    getTokenHoldings(tokenAccountPubkeys: PublicKey[], accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Promise<Holding[]>;
+    getDriftHoldings(userPubkeys: Iterable<PublicKey>, spotMarketsMap: PkMap<DriftSpotMarket>, perpMarketsMap: PkMap<DriftPerpMarket>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Promise<Holding[]>;
+    getDriftVaultsHoldings(dvaultDepositorsAndVaults: PkMap<DriftVault>, dvaultDepositorsMap: PkMap<DriftVaultDepositor>, spotMarketsMap: PkMap<DriftSpotMarket>, perpMarketsMap: PkMap<DriftPerpMarket>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Promise<Holding[]>;
+    getKaminoLendHoldings(obligationPubkeys: Iterable<PublicKey>, reservesMap: PkMap<Reserve>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Promise<Holding[]>;
+    getKaminoVaultsHoldings(kvaultAtasAndStates: PkMap<KVaultState>, reservesMap: PkMap<Reserve>, accountsDataMap: PkMap<Buffer>, tokenPricesMap: PkMap<TokenListItem>, priceSource: string): Promise<Holding[]>;
     /**
      * Returns an instruction that prices Kamino obligations.
      * If there are no Kamino obligations, returns null.

package/src/client/state.d.ts

@@ -16,6 +16,8 @@ export type UpdateStateParams = {
     timelockDuration?: number;
     assets?: PublicKey[];
     borrowable?: PublicKey[];
+    reduceOnly?: boolean;
+    anyLst?: boolean;
 };
 declare class TxBuilder extends BaseTxBuilder<StateClient> {
     initializeIx(params: InitStateParams, glamSigner: PublicKey): Promise<[TransactionInstruction, PublicKey]>;

package/src/clientConfig.d.ts

@@ -1,5 +1,6 @@
 import { Provider, Wallet } from "@coral-xyz/anchor";
 import { PublicKey } from "@solana/web3.js";
+import { JupiterApiClient } from "./utils";
 export declare enum ClusterNetwork {
     Mainnet = "mainnet-beta",
     Testnet = "testnet",
@@ -23,4 +24,5 @@ export type GlamClientConfig = {
     cluster?: ClusterNetwork;
     statePda?: PublicKey;
     jupiterApiKey?: string;
+    jupiterApiClient?: JupiterApiClient;
 };