@voltr/vault-sdk 1.0.5 → 1.0.7

package/README.md

@@ -265,6 +265,7 @@ pendingWithdrawals.forEach((withdrawal, index) => {
 - `fetchVaultAccount(vault)`
 - `fetchStrategyInitReceiptAccount(strategyInitReceipt)`
 - `fetchAdaptorAddReceiptAccount(adaptorAddReceipt)`
+- `fetchRequestWithdrawVaultReceiptAccount(requestWithdrawVaultReceipt)`
 - `fetchAllStrategyInitReceiptAccounts()`
 - `fetchAllStrategyInitReceiptAccountsOfVault(vault)`
 - `fetchAllAdaptorAddReceiptAccountsOfVault(vault)`
@@ -272,7 +273,10 @@ pendingWithdrawals.forEach((withdrawal, index) => {
 - `getPositionAndTotalValuesForVault(vault)`
 - `getAccumulatedAdminFeesForVault(vault)`
 - `getAccumulatedManagerFeesForVault(vault)`
+- `getPendingWithdrawalForUser(vault, user)`
 - `getAllPendingWithdrawalsForVault(vault)`
+- `getCurrentAssetPerLpForVault(vault)`
+- `getHighWaterMarkForVault(vault)`
 
 #### PDA Finding
 

package/dist/client.d.ts

@@ -645,6 +645,32 @@ export declare class VoltrClient extends AccountUtils {
         protocolAdmin: PublicKey;
         vault: PublicKey;
     }): Promise<TransactionInstruction>;
+    /**
+     * Creates an instruction to close a strategy
+     * @param {Object} params - Parameters for closing strategy
+     * @param {PublicKey} params.payer - Public key of the payer
+     * @param {PublicKey} params.manager - Public key of the manager
+     * @param {PublicKey} params.vault - Public key of the vault
+     * @param {PublicKey} params.strategy - Public key of the strategy
+     * @returns {Promise<TransactionInstruction>} Transaction instruction for closing strategy
+     * @throws {Error} If instruction creation fails
+     *
+     * @example
+     * ```typescript
+     * const ix = await client.createCloseStrategyIx({
+     *   payer: payerPubkey,
+     *   manager: managerPubkey,
+     *   vault: vaultPubkey,
+     *   strategy: strategyPubkey,
+     * });
+     * ```
+     */
+    createCloseStrategyIx({ payer, manager, vault, strategy, }: {
+        payer: PublicKey;
+        manager: PublicKey;
+        vault: PublicKey;
+        strategy: PublicKey;
+    }): Promise<TransactionInstruction>;
     /**
      * Fetches all strategy init receipt accounts
      * @returns Promise resolving to an array of strategy init receipt accounts
@@ -726,13 +752,6 @@ export declare class VoltrClient extends AccountUtils {
         lastUpdatedEpoch: BN;
         reserved: number[];
     }>[]>;
-    getPositionAndTotalValuesForVault(vault: PublicKey): Promise<{
-        totalValue: number;
-        strategies: {
-            strategyId: string;
-            amount: number;
-        }[];
-    }>;
     /**
      * Fetches a vault account's data
      * @param vault - Public key of the vault
@@ -852,6 +871,23 @@ export declare class VoltrClient extends AccountUtils {
         bump: number;
         version: number;
     }>;
+    /**
+     * Fetches the position and total values for a vault
+     * @param vault - Public key of the vault
+     * @returns Promise resolving to the position and total values
+     *
+     * @example
+     * ```typescript
+     * const positionAndTotalValues = await client.getPositionAndTotalValuesForVault(vaultPubkey);
+     * ```
+     */
+    getPositionAndTotalValuesForVault(vault: PublicKey): Promise<{
+        totalValue: number;
+        strategies: {
+            strategyId: string;
+            amount: number;
+        }[];
+    }>;
     /**
      * Fetches the accumulated admin fees for a vault
      * @param vault - Public key of the vault
@@ -874,6 +910,31 @@ export declare class VoltrClient extends AccountUtils {
      * ```
      */
     getAccumulatedManagerFeesForVault(vault: PublicKey): Promise<BN>;
+    /**
+     * Fetches the current asset per LP for a vault
+     * @param vault - Public key of the vault
+     * @returns Promise resolving to the current asset per LP
+     *
+     * @example
+     * ```typescript
+     * const currentAssetPerLp = await client.getCurrentAssetPerLpForVault(vaultPubkey);
+     * ```
+     */
+    getCurrentAssetPerLpForVault(vault: PublicKey): Promise<number>;
+    /**
+     * Fetches the high water mark for a vault
+     * @param vault - Public key of the vault
+     * @returns Promise resolving to the high water mark
+     *
+     * @example
+     * ```typescript
+     * const highWaterMark = await client.getHighWaterMarkForVault(vaultPubkey);
+     * ```
+     */
+    getHighWaterMarkForVault(vault: PublicKey): Promise<{
+        highestAssetPerLp: number;
+        lastUpdatedTs: number;
+    }>;
     /**
      * Processes a withdrawal receipt into a standardized withdrawal info object
      * @private

package/dist/client.js

@@ -831,6 +831,37 @@ class VoltrClient extends AccountUtils {
         })
             .instruction();
     }
+    /**
+     * Creates an instruction to close a strategy
+     * @param {Object} params - Parameters for closing strategy
+     * @param {PublicKey} params.payer - Public key of the payer
+     * @param {PublicKey} params.manager - Public key of the manager
+     * @param {PublicKey} params.vault - Public key of the vault
+     * @param {PublicKey} params.strategy - Public key of the strategy
+     * @returns {Promise<TransactionInstruction>} Transaction instruction for closing strategy
+     * @throws {Error} If instruction creation fails
+     *
+     * @example
+     * ```typescript
+     * const ix = await client.createCloseStrategyIx({
+     *   payer: payerPubkey,
+     *   manager: managerPubkey,
+     *   vault: vaultPubkey,
+     *   strategy: strategyPubkey,
+     * });
+     * ```
+     */
+    async createCloseStrategyIx({ payer, manager, vault, strategy, }) {
+        return await this.vaultProgram.methods
+            .closeStrategy()
+            .accounts({
+            payer,
+            manager,
+            vault,
+            strategy,
+        })
+            .instruction();
+    }
     // --------------------------------------- Account Fetching All
     /**
      * Fetches all strategy init receipt accounts
@@ -904,19 +935,6 @@ class VoltrClient extends AccountUtils {
             },
         ]);
     }
-    async getPositionAndTotalValuesForVault(vault) {
-        const vaultAccount = await this.fetchVaultAccount(vault);
-        const totalAssetValue = vaultAccount.asset.totalValue;
-        const strategyInitReceiptAccounts = await this.fetchAllStrategyInitReceiptAccountsOfVault(vault);
-        const strategyInfo = strategyInitReceiptAccounts.map((vaultStrategyAccount) => ({
-            strategyId: vaultStrategyAccount.account.strategy.toBase58(),
-            amount: vaultStrategyAccount.account.positionValue.toNumber(),
-        }));
-        return {
-            totalValue: totalAssetValue.toNumber(),
-            strategies: strategyInfo,
-        };
-    }
     // --------------------------------------- Account Fetching
     /**
      * Fetches a vault account's data
@@ -966,6 +984,29 @@ class VoltrClient extends AccountUtils {
         return await this.vaultProgram.account.requestWithdrawVaultReceipt.fetch(requestWithdrawVaultReceipt, "confirmed");
     }
     // --------------------------------------- Helpers
+    /**
+     * Fetches the position and total values for a vault
+     * @param vault - Public key of the vault
+     * @returns Promise resolving to the position and total values
+     *
+     * @example
+     * ```typescript
+     * const positionAndTotalValues = await client.getPositionAndTotalValuesForVault(vaultPubkey);
+     * ```
+     */
+    async getPositionAndTotalValuesForVault(vault) {
+        const vaultAccount = await this.fetchVaultAccount(vault);
+        const totalAssetValue = vaultAccount.asset.totalValue;
+        const strategyInitReceiptAccounts = await this.fetchAllStrategyInitReceiptAccountsOfVault(vault);
+        const strategyInfo = strategyInitReceiptAccounts.map((vaultStrategyAccount) => ({
+            strategyId: vaultStrategyAccount.account.strategy.toBase58(),
+            amount: vaultStrategyAccount.account.positionValue.toNumber(),
+        }));
+        return {
+            totalValue: totalAssetValue.toNumber(),
+            strategies: strategyInfo,
+        };
+    }
     /**
      * Fetches the accumulated admin fees for a vault
      * @param vault - Public key of the vault
@@ -994,6 +1035,45 @@ class VoltrClient extends AccountUtils {
         const vaultAccount = await this.fetchVaultAccount(vault);
         return vaultAccount.feeState.accumulatedLpManagerFees;
     }
+    /**
+     * Fetches the current asset per LP for a vault
+     * @param vault - Public key of the vault
+     * @returns Promise resolving to the current asset per LP
+     *
+     * @example
+     * ```typescript
+     * const currentAssetPerLp = await client.getCurrentAssetPerLpForVault(vaultPubkey);
+     * ```
+     */
+    async getCurrentAssetPerLpForVault(vault) {
+        const vaultLpMint = this.findVaultLpMint(vault);
+        const vaultAccount = await this.fetchVaultAccount(vault);
+        const lpSupply = await (0, spl_token_1.getMint)(this.conn, vaultLpMint).then((lp) => new bn_js_1.default(lp.supply.toString()));
+        const unharvestedFeesLp = vaultAccount.feeState.accumulatedLpAdminFees
+            .add(vaultAccount.feeState.accumulatedLpManagerFees)
+            .add(vaultAccount.feeState.accumulatedLpProtocolFees);
+        const totalLpSupply = unharvestedFeesLp.add(lpSupply);
+        const currentAssetPerLp = vaultAccount.asset.totalValue.toNumber() / totalLpSupply.toNumber();
+        return currentAssetPerLp;
+    }
+    /**
+     * Fetches the high water mark for a vault
+     * @param vault - Public key of the vault
+     * @returns Promise resolving to the high water mark
+     *
+     * @example
+     * ```typescript
+     * const highWaterMark = await client.getHighWaterMarkForVault(vaultPubkey);
+     * ```
+     */
+    async getHighWaterMarkForVault(vault) {
+        const vaultAccount = await this.fetchVaultAccount(vault);
+        const highWaterMarkValue = (0, decimals_1.convertDecimalBitsToDecimal)(vaultAccount.highWaterMark.highestAssetPerLpDecimalBits);
+        return {
+            highestAssetPerLp: highWaterMarkValue.toNumber(),
+            lastUpdatedTs: vaultAccount.highWaterMark.lastUpdatedTs.toNumber(),
+        };
+    }
     /**
      * Processes a withdrawal receipt into a standardized withdrawal info object
      * @private