@glamsystems/glam-sdk 1.0.6 → 1.0.8

package/src/utils/common.d.ts

@@ -1,14 +1,35 @@
 import { BN } from "@coral-xyz/anchor";
 /**
- * Compares two sets for equality
+ * Converts a buffer or array of character codes to a string
  */
-export declare const setsAreEqual: (a: Set<any>, b: Set<any>) => boolean;
+export declare function charsToString(chars: number[] | Buffer): string;
 /**
- * Converts a buffer or array of character codes to a string
+ * Converts a string to an array of character codes
  */
-export declare function charsToName(chars: number[] | Buffer): string;
+export declare function stringToChars(name: string, length?: number): number[];
 /**
- * Converts a string to an array of character codes (max 32 bytes)
+ * Safely converts a BN amount to a UI amount (with decimals).
+ *
+ * @param amount - The amount in base units (BN)
+ * @param decimals - The number of decimals (e.g., 9)
+ * @returns The UI amount as a number
+ *
+ * @example
+ * // Convert 10010000000 base units with 9 decimals
+ * const uiAmount = toUiAmount(new BN(10010000000), 9); // Returns 10.01
+ *
+ * @throws Error if the BN amount is too large to safely convert to number
  */
-export declare function nameToChars(name: string): number[];
 export declare function toUiAmount(amount: BN, decimals: number): number;
+/**
+ * Safely converts a UI amount (with decimals) to a BN amount.
+ *
+ * @param amount - The UI amount (e.g., 10.01)
+ * @param decimals - The number of decimals (e.g., 9)
+ * @returns BN representing the amount in base units
+ *
+ * @example
+ * // Convert 10.01 with 9 decimals
+ * const amount = fromUiAmount(10.01, 9); // Returns BN(10010000000)
+ */
+export declare function fromUiAmount(amount: number | string, decimals: number): BN;

package/src/utils/computeBudget.d.ts

@@ -8,9 +8,8 @@ export type ComputeBudgetOptions = {
 /**
  * Builds compute budget instructions for a transaction
  *
- * @param vTx The versioned transaction to build compute budget for
  * @param computeUnitLimit The compute unit limit
- * @param options Optional priority fee configuration
+ * @param options Compute budget options
  * @returns Array of compute budget instructions
  */
 export declare function buildComputeBudgetInstructions(computeUnitLimit: number, options?: ComputeBudgetOptions): Promise<Array<TransactionInstruction>>;

package/src/utils/evm.d.ts

@@ -4,3 +4,7 @@ export declare const hexToBytes: (hex: string) => number[];
 export declare const evmAddressToPublicKey: (address: string) => PublicKey;
 export declare const bytesToHex: (bytes: number[] | Uint8Array) => string;
 export declare const publicKeyToEvmAddress: (publicKey: PublicKey) => string;
+/**
+ * Validates if a string is a valid EVM address (40 hex characters)
+ */
+export declare const isValidEvmAddress: (addr: string) => boolean;

package/src/utils/index.d.ts

@@ -7,7 +7,6 @@ export * from "./common";
 export * from "./glamApi";
 export * from "./glamPDAs";
 export * from "./lookupTables";
-export * from "./priorityfee";
 export * from "./rpc";
 export * from "./timelock";
 export * from "./transaction";
@@ -16,3 +15,4 @@ export * from "./pkmap";
 export * from "./pkset";
 export * from "./fraction";
 export * from "./jupiterApi";
+export * from "./positionCategorizer";

package/src/utils/jupiterApi.d.ts

@@ -36,6 +36,13 @@ export type TokenListItem = {
     usdPrice: number;
     slot: number;
 };
+export declare class JupTokenList {
+    readonly tokens: TokenListItem[];
+    readonly mintMap: Map<string, TokenListItem>;
+    constructor(tokens: TokenListItem[]);
+    getByMint(mintAddress: string | PublicKey): TokenListItem | undefined;
+    getBySymbol(symbol: string): TokenListItem | undefined;
+}
 export type JupiterInstruction = {
     programId: string;
     accounts: {
@@ -57,19 +64,23 @@ export type SwapInstructions = {
 export declare const JUPITER_API_DEFAULT = "https://api.jup.ag";
 export type TokenPrice = {
     mint: string;
-    price: number;
+    usdPrice: number;
+    decimals: number;
+    blockId: number;
 };
 export declare class JupiterApiClient {
     swapApiBaseUrl: string;
     isCustomSwapApi: boolean;
     apiKey: string | null;
     private tokenListCache;
+    private tokenListCacheTtl;
     constructor(options?: {
         apiKey?: string;
         swapApiBaseUrl?: string;
+        cacheTtl?: number;
     });
     fetchTokenPrices(mints: string[]): Promise<TokenPrice[]>;
-    fetchTokensList(forceRefresh?: boolean): Promise<TokenListItem[]>;
+    fetchTokensList(forceRefresh?: boolean): Promise<JupTokenList>;
     fetchProgramLabels(): Promise<{
         [key: string]: string;
     }>;

package/src/utils/positionCategorizer.d.ts

@@ -0,0 +1,54 @@
+import { Commitment, Connection, PublicKey } from "@solana/web3.js";
+/**
+ * Categorized external positions by protocol type.
+ */
+export interface CategorizedPositions {
+    /** Direct drift user PDAs controlled by the vault */
+    driftUsers: PublicKey[];
+    /** Drift vault depositor accounts */
+    driftVaultDepositors: PublicKey[];
+    /** Kamino lending obligation accounts */
+    kaminoObligations: PublicKey[];
+    /** Kamino vault share token accounts */
+    kaminoVaultShareAtas: PublicKey[];
+    /** Positions that couldn't be categorized */
+    unknown: PublicKey[];
+}
+/**
+ * Utility class for categorizing external positions by protocol type.
+ *
+ * External positions in GLAM vaults can be:
+ * - 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)
+ *
+ * This class determines the type of each position to enable proper pricing.
+ */
+export declare class PositionCategorizer {
+    private readonly connection;
+    private readonly vaultPda;
+    private readonly possibleDriftUserPdas;
+    constructor(connection: Connection, vaultPda: PublicKey);
+    /**
+     * Derives a drift user PDA for a given authority and subAccountId.
+     */
+    private getDriftUserPda;
+    /**
+     * Checks if a pubkey matches any drift user PDA for subAccountIds 0-99.
+     * This is a pure computation - no RPC calls needed.
+     */
+    isDriftUserPda(pubkey: PublicKey): boolean;
+    /**
+     * Categorizes external positions by protocol type.
+     *
+     * Algorithm:
+     * 1. Identify drift users by matching against pre-computed PDAs (no RPC)
+     * 2. Batch fetch remaining positions to determine their type
+     * 3. Categorize based on account owner and size
+     *
+     * @param externalPositions - Array of external position pubkeys from state account
+     * @returns Categorized positions by protocol type
+     */
+    categorizePositions(externalPositions: PublicKey[], commitment: Commitment): Promise<CategorizedPositions>;
+}

package/src/utils/rpc.d.ts

@@ -1,3 +1,33 @@
-import { Connection, PublicKey } from "@solana/web3.js";
-export declare function getProgramAccountsV2(programId: PublicKey, limit?: number, filters?: any[]): Promise<any[]>;
-export declare function getProgramAccountsWithRetry(connection: Connection, programId: PublicKey, filters?: any[]): Promise<import("@solana/web3.js").GetProgramAccountsResponse>;
+import { Connection, Finality, GetProgramAccountsConfig, GetProgramAccountsResponse, PublicKey, SignaturesForAddressOptions, VersionedTransaction, VersionedTransactionResponse } from "@solana/web3.js";
+/**
+ * Fetches program accounts using Helius getProgramAccountsV2 if available.
+ * Otherwise falls back to standard getProgramAccounts with retry logic.
+ */
+export declare function getProgramAccounts(connection: Connection, programId: PublicKey, config: GetProgramAccountsConfig & HeliusGetProgramAccountsV2Config): Promise<GetProgramAccountsResponse>;
+export type HeliusGetProgramAccountsV2Config = {
+    limit?: number;
+    changedSinceSlot?: number;
+};
+/**
+ * Standard getProgramAccounts with retry logic for transient errors.
+ */
+export declare function getProgramAccountsWithRetry(connection: Connection, programId: PublicKey, config: GetProgramAccountsConfig): Promise<GetProgramAccountsResponse>;
+export interface GetTransactionsOptions {
+    commitment?: Finality;
+    sinceSlot?: number;
+    transactionDetails?: "full" | "signatures";
+}
+/**
+ * Fetches transactions for an address using Helius getTransactionsForAddress if available.
+ * Otherwise falls back to getSignaturesForAddress + getTransaction.
+ */
+export declare function getTransactionsForAddress(connection: Connection, address: PublicKey, options?: SignaturesForAddressOptions & GetTransactionsOptions): Promise<VersionedTransactionResponse[]>;
+export type PriorityLevel = "Recommended" | "Min" | "Low" | "Medium" | "High" | "VeryHigh" | "UnsafeMax" | "Default";
+type GetPriorityFeeEstimateOptions = {
+    heliusApiKey?: string;
+    tx?: VersionedTransaction;
+    accountKeys?: string[];
+    priorityLevel?: PriorityLevel;
+};
+export declare function getPriorityFeeEstimate(options: GetPriorityFeeEstimateOptions): Promise<number>;
+export {};

package/target/idl/ext_cctp.json

@@ -471,6 +471,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_drift-staging.json

@@ -2799,6 +2799,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_drift.json

@@ -2799,6 +2799,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_kamino-staging.json

@@ -2218,6 +2218,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_kamino.json

@@ -2218,6 +2218,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_marinade.json

@@ -791,6 +791,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_spl-staging.json

@@ -463,6 +463,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_spl.json

@@ -463,6 +463,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_stake_pool-staging.json

@@ -790,6 +790,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/ext_stake_pool.json

@@ -790,6 +790,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/glam_config.json

@@ -78,10 +78,7 @@
         {
           "name": "admin",
           "writable": true,
-          "signer": true,
-          "relations": [
-            "global_config"
-          ]
+          "signer": true
         },
         {
           "name": "system_program",
@@ -213,10 +210,7 @@
         {
           "name": "admin",
           "writable": true,
-          "signer": true,
-          "relations": [
-            "global_config"
-          ]
+          "signer": true
         },
         {
           "name": "system_program",
@@ -271,10 +265,7 @@
         },
         {
           "name": "fee_authority",
-          "signer": true,
-          "relations": [
-            "global_config"
-          ]
+          "signer": true
         }
       ],
       "args": [
@@ -329,10 +320,7 @@
         },
         {
           "name": "fee_authority",
-          "signer": true,
-          "relations": [
-            "global_config"
-          ]
+          "signer": true
         }
       ],
       "args": [
@@ -384,10 +372,7 @@
         {
           "name": "admin",
           "writable": true,
-          "signer": true,
-          "relations": [
-            "global_config"
-          ]
+          "signer": true
         },
         {
           "name": "system_program",
@@ -434,21 +419,16 @@
     },
     {
       "code": 6002,
-      "name": "AssetMetaAlreadyExists",
-      "msg": "Asset meta already exists"
-    },
-    {
-      "code": 6003,
       "name": "InvalidParameters",
       "msg": "Invalid parameters"
     },
     {
-      "code": 6004,
+      "code": 6003,
       "name": "InvalidOracleSource",
       "msg": "Invalid oracle source"
     },
     {
-      "code": 6005,
+      "code": 6004,
       "name": "InvalidGlobalConfig",
       "msg": "Invalid global config"
     }

package/target/idl/glam_mint-staging.json

@@ -4881,6 +4881,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/glam_mint.json

@@ -4881,6 +4881,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }

package/target/idl/glam_protocol-staging.json

@@ -2,7 +2,7 @@
   "address": "gstgptmbgJVi5f8ZmSRVZjZkDQwqKa3xWuUtD5WmJHz",
   "metadata": {
     "name": "glam_protocol",
-    "version": "1.0.1",
+    "version": "1.0.2",
     "spec": "0.1.0",
     "description": "Glam Protocol"
   },
@@ -435,6 +435,81 @@
         {
           "name": "output_stake_pool",
           "optional": true
+        },
+        {
+          "name": "glam_config",
+          "optional": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108,
+                  45,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                10,
+                11,
+                0,
+                83,
+                72,
+                16,
+                46,
+                144,
+                46,
+                42,
+                79,
+                22,
+                157,
+                123,
+                21,
+                242,
+                192,
+                146,
+                1,
+                78,
+                88,
+                59,
+                102,
+                9,
+                190,
+                226,
+                92,
+                189,
+                187,
+                232,
+                83,
+                220
+              ]
+            }
+          }
+        },
+        {
+          "name": "sol_usd_oracle",
+          "optional": true
+        },
+        {
+          "name": "input_token_oracle",
+          "optional": true
+        },
+        {
+          "name": "output_token_oracle",
+          "optional": true
         }
       ],
       "args": [
@@ -1525,8 +1600,8 @@
     },
     {
       "code": 48010,
-      "name": "UnexpectedProgramOwner",
-      "msg": "Account is owned by an unexpected program"
+      "name": "InvalidAccountOwner",
+      "msg": "Account owner does not match expected program"
     },
     {
       "code": 48011,
@@ -1555,8 +1630,8 @@
     },
     {
       "code": 49004,
-      "name": "InvalidAssetsLen",
-      "msg": "Too many assets: max 100"
+      "name": "InvalidIndex",
+      "msg": "Invalid index"
     },
     {
       "code": 49005,
@@ -1730,8 +1805,13 @@
     },
     {
       "code": 51113,
-      "name": "UnexpectedDiscriminator",
-      "msg": "Invalid account: discriminator mismatch"
+      "name": "InvalidDiscriminator",
+      "msg": "Account discriminator does not match expected value"
+    },
+    {
+      "code": 51114,
+      "name": "InvalidAccountData",
+      "msg": "Invalid account data"
     },
     {
       "code": 52000,
@@ -1994,6 +2074,12 @@
           },
           {
             "name": "OracleConfigs"
+          },
+          {
+            "name": "ReduceOnly"
+          },
+          {
+            "name": "AnyLst"
           }
         ]
       }
@@ -2865,6 +2951,18 @@
               }
             }
           },
+          {
+            "name": "reduce_only",
+            "type": {
+              "option": "bool"
+            }
+          },
+          {
+            "name": "any_lst",
+            "type": {
+              "option": "bool"
+            }
+          },
           {
             "name": "timelock_duration",
             "type": {
@@ -2953,15 +3051,20 @@
       "value": "4"
     },
     {
-      "name": "PROTO_JUPITER_SWAP_PERM_SWAP_ANY",
+      "name": "PROTO_JUPITER_SWAP_PERM_SWAP_FROM_ANY",
       "type": "u64",
-      "value": "1"
+      "value": "8"
     },
     {
       "name": "PROTO_JUPITER_SWAP_PERM_SWAP_LST",
       "type": "u64",
       "value": "2"
     },
+    {
+      "name": "PROTO_JUPITER_SWAP_PERM_SWAP_TO_ANY",
+      "type": "u64",
+      "value": "1"
+    },
     {
       "name": "PROTO_STAKE",
       "type": "u16",
@@ -2982,6 +3085,11 @@
       "type": "u16",
       "value": "1"
     },
+    {
+      "name": "PROTO_SYSTEM_PERM_EMERGENCY_UPDATE",
+      "type": "u64",
+      "value": "4"
+    },
     {
       "name": "PROTO_SYSTEM_PERM_TRANSFER",
       "type": "u64",