@glamsystems/glam-sdk 1.0.10 → 1.0.12-alpha.0

package/src/models/state.d.ts

@@ -4,6 +4,7 @@ import { PublicKey } from "@solana/web3.js";
 import { Mint } from "@solana/spl-token";
 import { BN } from "@coral-xyz/anchor";
 import { MintModel } from "./mint";
+import type { FeeStructure } from "./mint";
 import type { RequestQueue } from "./types";
 import type { IntegrationAcl, DelegateAcl } from "./acl";
 export type StateAccount = IdlAccounts<GlamProtocol>["stateAccount"];
@@ -26,6 +27,7 @@ export declare class StateIdlModel implements StateModelType {
     timelockDuration: number | null;
     integrationAcls: IntegrationAcl[] | null;
     delegateAcls: DelegateAcl[] | null;
+    feeStructure: FeeStructure | null;
     constructor(data: Partial<StateModelType>);
 }
 /**
@@ -69,7 +71,7 @@ export declare class StateModel extends StateIdlModel {
      * @param openfundsMetadataAccount includes fund rawOpenfunds data and share class rawOpenfunds data
      * @param glamMint
      */
-    static fromOnchainAccounts(statePda: PublicKey, stateAccount: StateAccount, glamMint?: Mint, requestQueue?: RequestQueue): StateModel;
+    static fromOnchainAccounts(statePda: PublicKey, stateAccount: StateAccount, staging: boolean, glamMint?: Mint, requestQueue?: RequestQueue): StateModel;
 }
 export type CreatedModelType = IdlTypes<GlamProtocol>["createdModel"];
 export declare class CreatedModel implements CreatedModelType {

package/src/react/glam.d.ts

@@ -24,6 +24,7 @@ interface GlamProviderContext {
     allGlamStates: StateModel[];
     jupTokenList?: JupTokenList;
     driftMarketConfigs?: DriftMarketConfigs;
+    wsConnected: boolean;
     setActiveGlamState: (f: GlamStateCache) => void;
     refresh: () => Promise<void>;
     refetchGlamStates: () => Promise<void>;

package/src/react/index.d.ts

@@ -1,3 +1,5 @@
 export * from "../index";
 export * from "./glam";
 export * from "./cluster-provider";
+export * from "./query-keys";
+export * from "./useVaultBalanceSubscription";

package/src/react/query-keys.d.ts

@@ -0,0 +1,39 @@
+export declare const queryKeys: {
+    readonly vault: {
+        readonly all: (pk: string, cluster: string) => readonly ["vault", string, string];
+        readonly balances: (pk: string, cluster: string) => readonly ["vault", string, string, "balances"];
+        readonly holdings: (pk: string, cluster: string) => readonly ["vault", string, string, "holdings"];
+        readonly acls: (pk: string, cluster: string) => readonly ["vault", string, string, "acls"];
+        readonly config: (pk: string, cluster: string) => readonly ["vault", string, string, "config"];
+        readonly driftUsers: (pk: string, cluster: string) => readonly ["vault", string, string, "drift-users"];
+        readonly stakes: (pk: string, cluster: string) => readonly ["vault", string, string, "stakes"];
+        readonly holders: (mint: string, cluster: string) => readonly ["vault", "holders", string, string];
+    };
+    readonly wallet: {
+        readonly balances: (pk: string, cluster: string) => readonly ["wallet", string, "balances", string];
+    };
+    readonly global: {
+        readonly allStates: (cluster: string) => readonly ["global", "all-states", string];
+        readonly jupTokens: (cluster: string) => readonly ["global", "jup-tokens", string];
+        readonly jupDexes: (cluster: string) => readonly ["global", "jup-dexes", string];
+        readonly driftMarkets: (cluster: string) => readonly ["global", "drift-markets", string];
+        readonly kaminoMarkets: (cluster: string) => readonly ["global", "kamino-markets", string];
+        readonly priorityFee: (cluster: string) => readonly ["global", "priority-fee", string];
+    };
+    readonly vaultGraph: {
+        readonly vault: (vaultId: string, cluster: string) => readonly ["vault-graph", "vault", string, string];
+        readonly tokenData: (mint: string, cluster: string) => readonly ["vault-graph", "token-data", string, string];
+        readonly availableIntegrations: (cluster: string) => readonly ["vault-graph", "available-integrations", string];
+    };
+    readonly tx: {
+        readonly status: (sig: string) => readonly ["tx", string];
+    };
+};
+export type InvalidationScope = "balance" | "drift" | "acls" | "wallet" | "graph" | "stakes" | "all";
+export interface InvalidationContext {
+    vaultPk: string;
+    walletPk: string;
+    cluster: string;
+}
+/** Maps invalidation scopes to the query keys that need to be invalidated. */
+export declare function getInvalidationKeys(scopes: InvalidationScope[], ctx: InvalidationContext): readonly (readonly string[])[];

package/src/react/useVaultBalanceSubscription.d.ts

@@ -0,0 +1,17 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+import { QueryClient } from "@tanstack/react-query";
+import { TokenAccount } from "../client/base";
+export interface UseVaultBalanceSubscriptionOptions {
+    connection: Connection;
+    queryClient: QueryClient;
+    vaultPda: PublicKey | undefined;
+    /** Base58 string of the active vault state pubkey (used for query key scoping) */
+    pk: string;
+    /** Cluster network string for query key scoping */
+    cluster: string;
+    tokenAccounts: TokenAccount[];
+    enabled: boolean;
+    /** Called when WebSocket connection status changes (for polling fallback) */
+    onWsStatusChange: (connected: boolean) => void;
+}
+export declare function useVaultBalanceSubscription({ connection, queryClient, vaultPda, pk, cluster, tokenAccounts, enabled, onWsStatusChange, }: UseVaultBalanceSubscriptionOptions): void;

package/src/utils/bitmask.d.ts

@@ -15,7 +15,7 @@ export declare function formatBits(bitmask: number | BN, padding?: number): stri
  * @param protocolsBitmask - The bitmask to parse.
  * @returns An object containing the bitmask string and a list of protocol names.
  */
-export declare function parseProtocolsBitmask(integrationProgram: PublicKey, protocolsBitmask: number | BN): {
+export declare function parseProtocolsBitmask(integrationProgram: PublicKey, protocolsBitmask: number | BN, staging: boolean): {
     protocols: {
         bitflag: number | BN;
         name: string;
@@ -29,7 +29,7 @@ export declare function parseProtocolsBitmask(integrationProgram: PublicKey, pro
  * @param permissionsBitmask - The permissions bitmask to parse.
  * @returns An object containing the bitmask string and a list of permission names.
  */
-export declare function parseProtocolPermissionsBitmask(integrationProgram: PublicKey, protocolBitflag: number | BN, permissionsBitmask: number | BN): {
+export declare function parseProtocolPermissionsBitmask(integrationProgram: PublicKey, protocolBitflag: number | BN, permissionsBitmask: number | BN, staging: boolean): {
     protocol: string;
     permissions: {
         bitflag: number | BN;
@@ -39,9 +39,10 @@ export declare function parseProtocolPermissionsBitmask(integrationProgram: Publ
 /**
  * Given the protocol name and a list of permission names, returns the permissions bitmask.
  */
-export declare function parsePermissionNames({ protocolName, permissionNames, }: {
+export declare function parsePermissionNames({ protocolName, permissionNames, staging, }: {
     protocolName: string;
     permissionNames: string[];
+    staging: boolean;
 }): {
     integrationProgram: PublicKey;
     protocolBitflag: number;

package/src/utils/index.d.ts

@@ -4,7 +4,6 @@ export * from "./blockhash";
 export * from "./computeBudget";
 export * from "./evm";
 export * from "./common";
-export * from "./glamApi";
 export * from "./glamPDAs";
 export * from "./lookupTables";
 export * from "./rpc";

package/src/utils/lookupTables.d.ts

@@ -1,4 +1,4 @@
-import { AddressLookupTableAccount, Connection, PublicKey } from "@solana/web3.js";
+import { AddressLookupTableAccount, Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
 /**
  * Fetches multiple address lookup table accounts
  *
@@ -7,3 +7,47 @@ import { AddressLookupTableAccount, Connection, PublicKey } from "@solana/web3.j
  * @returns Array of address lookup table accounts
  */
 export declare function fetchAddressLookupTableAccounts(connection: Connection, pubkeys?: string[] | PublicKey[]): Promise<AddressLookupTableAccount[]>;
+export interface VaultAccountsInfo {
+    statePda: PublicKey;
+    vaultPda: PublicKey;
+    mintPda: PublicKey;
+    escrowPda: PublicKey;
+    requestQueuePda: PublicKey;
+    extraMetasPda: PublicKey;
+    protocolProgramId: PublicKey;
+    mintProgramId: PublicKey;
+    connection: Connection;
+    stateAccount: {
+        mint: PublicKey;
+        baseAssetMint: PublicKey;
+        assets: PublicKey[];
+        externalPositions: PublicKey[];
+        integrationAcls: {
+            integrationProgram: PublicKey;
+        }[];
+    };
+    borrowable?: PublicKey[];
+}
+/**
+ * Collects all pubkeys that should be included in a vault's Address Lookup Table.
+ *
+ * The first 3 entries are fixed (statePda, vaultPda, GLAM_CONFIG_PROGRAM) to
+ * match the ALT discovery filter offsets used by findGlamLookupTables().
+ */
+export declare function collectVaultLookupTableAddresses(info: VaultAccountsInfo): Promise<PublicKey[]>;
+export interface CreateAltResult {
+    createIx: TransactionInstruction;
+    lookupTableAddress: PublicKey;
+    extendIxBatches: TransactionInstruction[];
+}
+/**
+ * Builds instructions to create an ALT and extend it with the given addresses.
+ * Returns the create instruction, the derived lookup table address, and batched
+ * extend instructions (each batch fits within a single transaction).
+ */
+export declare function buildCreateAltInstructions(addresses: PublicKey[], authority: PublicKey, payer: PublicKey, recentSlot: number): CreateAltResult;
+/**
+ * Builds batched extend instructions for an existing ALT.
+ * Each instruction extends the table with up to 20 addresses.
+ */
+export declare function buildExtendAltInstructions(lookupTableAddress: PublicKey, newAddresses: PublicKey[], authority: PublicKey, payer: PublicKey): TransactionInstruction[];

package/src/utils/timelock.d.ts

@@ -5,16 +5,23 @@ import { IntegrationAcl, DelegateAcl } from "../models";
  * Get protocol names from a bitmask for a given integration program
  * Uses the SDK's parseProtocolsBitmask function
  */
-export declare function getProtocolNamesFromBitmask(integrationProgram: PublicKey, bitmask: number): string[];
+export declare function getProtocolNamesFromBitmask(integrationProgram: PublicKey, bitmask: number, staging: boolean): string[];
 /**
  * Get permission names from a permissions bitmask for a protocol
  * Uses the SDK's parseProtocolPermissionsBitmask function
  */
-export declare function getPermissionNamesFromBitmask(integrationProgram: PublicKey, protocolBitflag: number, permissionsBitmask: BN): string[];
+export declare function getPermissionNamesFromBitmask(integrationProgram: PublicKey, protocolBitflag: number, permissionsBitmask: BN, staging: boolean): string[];
+/**
+ * Compare current and staged PublicKey arrays and return added/removed keys
+ */
+export declare function comparePublicKeyArrays(current: PublicKey[] | null, staged: PublicKey[]): {
+    added: PublicKey[];
+    removed: PublicKey[];
+};
 /**
  * Compare current and staged integrationAcls and return the differences
  */
-export declare function compareIntegrationAcls(current: IntegrationAcl[] | null, staged: IntegrationAcl[] | null): {
+export declare function compareIntegrationAcls(current: IntegrationAcl[] | null, staged: IntegrationAcl[] | null, staging: boolean): {
     added: IntegrationAcl[];
     removed: IntegrationAcl[];
     modified: Array<{
@@ -28,7 +35,7 @@ export declare function compareIntegrationAcls(current: IntegrationAcl[] | null,
 /**
  * Compare current and staged delegateAcls and return the differences
  */
-export declare function compareDelegateAcls(current: DelegateAcl[] | null, staged: DelegateAcl[] | null): {
+export declare function compareDelegateAcls(current: DelegateAcl[] | null, staged: DelegateAcl[] | null, staging: boolean): {
     added: DelegateAcl[];
     removed: DelegateAcl[];
     modified: Array<{

package/src/utils/transaction.d.ts

@@ -3,7 +3,7 @@ import { Connection, PublicKey, TransactionInstruction, AddressLookupTableAccoun
  * Parses program logs to extract error message
  */
 export declare function parseProgramLogs(logs?: null | string[]): string;
-export declare const getSimulationResult: (connection: Connection, instructions: Array<TransactionInstruction>, payer: PublicKey, lookupTables?: Array<AddressLookupTableAccount>) => Promise<{
+export declare const getSimulationResult: (connection: Connection, instructions: Array<TransactionInstruction>, payer: PublicKey, lookupTables?: Array<AddressLookupTableAccount>, staging?: boolean) => Promise<{
     unitsConsumed?: number;
     error?: Error;
     serializedTx?: String;

package/target/idl/ext_drift-staging.json

@@ -2705,6 +2705,10 @@
             "type": {
               "vec": "pubkey"
             }
+          },
+          {
+            "name": "order_price_tolerance_bps",
+            "type": "u16"
           }
         ]
       }

package/target/idl/ext_drift.json

@@ -2705,6 +2705,10 @@
             "type": {
               "vec": "pubkey"
             }
+          },
+          {
+            "name": "order_price_tolerance_bps",
+            "type": "u16"
           }
         ]
       }

package/target/idl/glam_config.json

@@ -480,7 +480,7 @@
     {
       "code": 6002,
       "name": "InvalidParameters",
-      "msg": "Invalid parameters"
+      "msg": "Invalid fee parameters or insufficient account space"
     },
     {
       "code": 6003,
@@ -490,7 +490,17 @@
     {
       "code": 6004,
       "name": "InvalidGlobalConfig",
-      "msg": "Invalid global config"
+      "msg": "Invalid or corrupted global config account"
+    },
+    {
+      "code": 6005,
+      "name": "InvalidFeeAuthority",
+      "msg": "Invalid fee authority"
+    },
+    {
+      "code": 6006,
+      "name": "AssetMetaNotFound",
+      "msg": "Asset meta not found"
     }
   ],
   "types": [

package/target/idl/glam_mint-staging.json

@@ -4637,19 +4637,6 @@
     }
   ],
   "accounts": [
-    {
-      "name": "GlobalConfig",
-      "discriminator": [
-        149,
-        8,
-        156,
-        202,
-        160,
-        252,
-        176,
-        217
-      ]
-    },
     {
       "name": "RequestQueue",
       "discriminator": [
@@ -4724,7 +4711,7 @@
     {
       "code": 6003,
       "name": "InvalidAsset",
-      "msg": "Asset not allowed to subscribe"
+      "msg": "Invalid asset"
     },
     {
       "code": 6004,
@@ -4775,6 +4762,21 @@
       "code": 6013,
       "name": "ProtocolFeesNotCrystallized",
       "msg": "Protocol fees should be crystallized before updating"
+    },
+    {
+      "code": 6014,
+      "name": "ManagerFeesNotCrystallized",
+      "msg": "Manager fees should be crystallized before updating"
+    },
+    {
+      "code": 6015,
+      "name": "InsufficientEscrowBalance",
+      "msg": "Insufficient escrow balance for fee burn"
+    },
+    {
+      "code": 6016,
+      "name": "AmountBelowMinimum",
+      "msg": "Amount below minimum threshold"
     }
   ],
   "types": [
@@ -4838,51 +4840,6 @@
         ]
       }
     },
-    {
-      "name": "AssetMeta",
-      "type": {
-        "kind": "struct",
-        "fields": [
-          {
-            "name": "asset",
-            "type": "pubkey"
-          },
-          {
-            "name": "decimals",
-            "type": "u8"
-          },
-          {
-            "name": "oracle",
-            "type": "pubkey"
-          },
-          {
-            "name": "oracle_source",
-            "type": {
-              "defined": {
-                "name": "OracleSource"
-              }
-            }
-          },
-          {
-            "name": "max_age_seconds",
-            "type": "u16"
-          },
-          {
-            "name": "priority",
-            "type": "i8"
-          },
-          {
-            "name": "padding",
-            "type": {
-              "array": [
-                "u8",
-                3
-              ]
-            }
-          }
-        ]
-      }
-    },
     {
       "name": "AumRecord",
       "type": {
@@ -5343,62 +5300,6 @@
         ]
       }
     },
-    {
-      "name": "GlobalConfig",
-      "type": {
-        "kind": "struct",
-        "fields": [
-          {
-            "name": "admin",
-            "docs": [
-              "The authority that can modify the config"
-            ],
-            "type": "pubkey"
-          },
-          {
-            "name": "fee_authority",
-            "docs": [
-              "The authority that can modify fee structure of individual glam state and claim protocol fees"
-            ],
-            "type": "pubkey"
-          },
-          {
-            "name": "referrer",
-            "docs": [
-              "Default GLAM referrer"
-            ],
-            "type": "pubkey"
-          },
-          {
-            "name": "base_fee_bps",
-            "docs": [
-              "Default protocol base fee applied to all vaults"
-            ],
-            "type": "u16"
-          },
-          {
-            "name": "flow_fee_bps",
-            "docs": [
-              "Default protocol flow fee applied to all vaults"
-            ],
-            "type": "u16"
-          },
-          {
-            "name": "asset_metas",
-            "docs": [
-              "List of assets and their oracle configs supported by the protocol"
-            ],
-            "type": {
-              "vec": {
-                "defined": {
-                  "name": "AssetMeta"
-                }
-              }
-            }
-          }
-        ]
-      }
-    },
     {
       "name": "HurdleType",
       "type": {
@@ -5755,77 +5656,6 @@
         ]
       }
     },
-    {
-      "name": "OracleSource",
-      "type": {
-        "kind": "enum",
-        "variants": [
-          {
-            "name": "Pyth"
-          },
-          {
-            "name": "Switchboard"
-          },
-          {
-            "name": "QuoteAsset"
-          },
-          {
-            "name": "Pyth1K"
-          },
-          {
-            "name": "Pyth1M"
-          },
-          {
-            "name": "PythStableCoin"
-          },
-          {
-            "name": "Prelaunch"
-          },
-          {
-            "name": "PythPull"
-          },
-          {
-            "name": "Pyth1KPull"
-          },
-          {
-            "name": "Pyth1MPull"
-          },
-          {
-            "name": "PythStableCoinPull"
-          },
-          {
-            "name": "SwitchboardOnDemand"
-          },
-          {
-            "name": "PythLazer"
-          },
-          {
-            "name": "PythLazer1K"
-          },
-          {
-            "name": "PythLazer1M"
-          },
-          {
-            "name": "PythLazerStableCoin"
-          },
-          {
-            "name": "NotSet"
-          },
-          {
-            "name": "LstPoolState"
-          },
-          {
-            "name": "MarinadeState"
-          },
-          {
-            "name": "BaseAsset"
-          },
-          {
-            "name": "ChainlinkRWA"
-          }
-        ]
-      }
-    },
     {
       "name": "PendingRequest",
       "type": {