@voltr/vault-sdk 1.1.0 → 2.0.0

package/dist/extensions/batchFetchers.d.ts

@@ -0,0 +1,7 @@
+import { type Account, type Address } from "@solana/kit";
+import { type AdaptorAddReceipt, type RequestWithdrawVaultReceipt, type StrategyInitReceipt } from "../generated";
+import type { GetProgramAccountsRpc } from "./rpc";
+export declare function fetchAllStrategyInitReceiptAccountsOfVault(rpc: GetProgramAccountsRpc, vault: Address): Promise<Account<StrategyInitReceipt>[]>;
+export declare function fetchAllRequestWithdrawVaultReceiptsOfVault(rpc: GetProgramAccountsRpc, vault: Address): Promise<Account<RequestWithdrawVaultReceipt>[]>;
+export declare function fetchAllAdaptorAddReceiptAccountsOfVault(rpc: GetProgramAccountsRpc, vault: Address): Promise<Account<AdaptorAddReceipt>[]>;
+//# sourceMappingURL=batchFetchers.d.ts.map

package/dist/extensions/batchFetchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchFetchers.d.ts","sourceRoot":"","sources":["../../src/extensions/batchFetchers.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,OAAO,EAIb,MAAM,aAAa,CAAC;AAErB,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AA6DnD,wBAAsB,0CAA0C,CAC9D,GAAG,EAAE,qBAAqB,EAC1B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAOzC;AAED,wBAAsB,2CAA2C,CAC/D,GAAG,EAAE,qBAAqB,EAC1B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAOjD;AAED,wBAAsB,wCAAwC,CAC5D,GAAG,EAAE,qBAAqB,EAC1B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAOvC"}

package/dist/extensions/batchFetchers.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchAllStrategyInitReceiptAccountsOfVault = fetchAllStrategyInitReceiptAccountsOfVault;
+exports.fetchAllRequestWithdrawVaultReceiptsOfVault = fetchAllRequestWithdrawVaultReceiptsOfVault;
+exports.fetchAllAdaptorAddReceiptAccountsOfVault = fetchAllAdaptorAddReceiptAccountsOfVault;
+const kit_1 = require("@solana/kit");
+const generated_1 = require("../generated");
+const VAULT_FIELD_OFFSET = 8n;
+const DISCRIMINATOR_OFFSET = 0n;
+const base64Decoder = (0, kit_1.getBase64Decoder)();
+const base64Encoder = (0, kit_1.getBase64Encoder)();
+const addressEncoder = (0, kit_1.getAddressEncoder)();
+function bytesToBase64(bytes) {
+    return base64Decoder.decode(bytes);
+}
+function base64ToBytes(base64) {
+    return base64Encoder.encode(base64);
+}
+async function fetchAndDecodeAccountsByVault(rpc, vault, discriminator, decoder) {
+    const results = await rpc
+        .getProgramAccounts(generated_1.VOLTR_VAULT_PROGRAM_ADDRESS, {
+        encoding: "base64",
+        filters: [
+            {
+                memcmp: {
+                    offset: DISCRIMINATOR_OFFSET,
+                    bytes: bytesToBase64(discriminator),
+                    encoding: "base64",
+                },
+            },
+            {
+                memcmp: {
+                    offset: VAULT_FIELD_OFFSET,
+                    bytes: bytesToBase64(addressEncoder.encode(vault)),
+                    encoding: "base64",
+                },
+            },
+        ],
+    })
+        .send();
+    return results.map(({ pubkey, account }) => {
+        const [data] = account.data;
+        const encoded = {
+            address: pubkey,
+            data: base64ToBytes(data),
+            executable: account.executable,
+            lamports: (0, kit_1.lamports)(BigInt(account.lamports)),
+            programAddress: account.owner,
+            space: BigInt(account.space),
+        };
+        return (0, kit_1.decodeAccount)(encoded, decoder);
+    });
+}
+async function fetchAllStrategyInitReceiptAccountsOfVault(rpc, vault) {
+    return fetchAndDecodeAccountsByVault(rpc, vault, generated_1.STRATEGY_INIT_RECEIPT_DISCRIMINATOR, (0, generated_1.getStrategyInitReceiptDecoder)());
+}
+async function fetchAllRequestWithdrawVaultReceiptsOfVault(rpc, vault) {
+    return fetchAndDecodeAccountsByVault(rpc, vault, generated_1.REQUEST_WITHDRAW_VAULT_RECEIPT_DISCRIMINATOR, (0, generated_1.getRequestWithdrawVaultReceiptDecoder)());
+}
+async function fetchAllAdaptorAddReceiptAccountsOfVault(rpc, vault) {
+    return fetchAndDecodeAccountsByVault(rpc, vault, generated_1.ADAPTOR_ADD_RECEIPT_DISCRIMINATOR, (0, generated_1.getAdaptorAddReceiptDecoder)());
+}
+//# sourceMappingURL=batchFetchers.js.map

package/dist/extensions/batchFetchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchFetchers.js","sourceRoot":"","sources":["../../src/extensions/batchFetchers.ts"],"names":[],"mappings":";;AAsFA,gGAUC;AAED,kGAUC;AAED,4FAUC;AAxHD,qCAWqB;AAErB,4CAWsB;AAGtB,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,MAAM,aAAa,GAAG,IAAA,sBAAgB,GAAE,CAAC;AACzC,MAAM,aAAa,GAAG,IAAA,sBAAgB,GAAE,CAAC;AACzC,MAAM,cAAc,GAAG,IAAA,uBAAiB,GAAE,CAAC;AAE3C,SAAS,aAAa,CAAC,KAAiB;IACtC,OAAO,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO,aAAa,CAAC,MAAM,CAAC,MAAM,CAAe,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,GAA0B,EAC1B,KAAc,EACd,aAAyB,EACzB,OAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,GAAG;SACtB,kBAAkB,CAAC,uCAA2B,EAAE;QAC/C,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE;YACP;gBACE,MAAM,EAAE;oBACN,MAAM,EAAE,oBAAoB;oBAC5B,KAAK,EAAE,aAAa,CAAC,aAAa,CAAuB;oBACzD,QAAQ,EAAE,QAAQ;iBACnB;aACF;YACD;gBACE,MAAM,EAAE;oBACN,MAAM,EAAE,kBAAkB;oBAC1B,KAAK,EAAE,aAAa,CAClB,cAAc,CAAC,MAAM,CAAC,KAAK,CAAe,CACrB;oBACvB,QAAQ,EAAE,QAAQ;iBACnB;aACF;SACF;KACF,CAAC;SACD,IAAI,EAAE,CAAC;IAEV,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;QAC5B,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,IAAA,cAAU,EAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9C,cAAc,EAAE,OAAO,CAAC,KAAK;YAC7B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAC7B,CAAC;QACF,OAAO,IAAA,mBAAa,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,0CAA0C,CAC9D,GAA0B,EAC1B,KAAc;IAEd,OAAO,6BAA6B,CAClC,GAAG,EACH,KAAK,EACL,+CAAmC,EACnC,IAAA,yCAA6B,GAAE,CAChC,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,2CAA2C,CAC/D,GAA0B,EAC1B,KAAc;IAEd,OAAO,6BAA6B,CAClC,GAAG,EACH,KAAK,EACL,wDAA4C,EAC5C,IAAA,iDAAqC,GAAE,CACxC,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,wCAAwC,CAC5D,GAA0B,EAC1B,KAAc;IAEd,OAAO,6BAA6B,CAClC,GAAG,EACH,KAAK,EACL,6CAAiC,EACjC,IAAA,uCAA2B,GAAE,CAC9B,CAAC;AACJ,CAAC"}

package/dist/extensions/decimal.d.ts

@@ -0,0 +1,11 @@
+/**
+ * High water mark and other on-chain decimal values use the Rust `U80F48`
+ * fixed-point representation: a 128-bit unsigned integer whose lower 48 bits
+ * encode the fractional part. Convert to a JS `number` by splitting integer
+ * and fractional halves before crossing the float boundary, so the integer
+ * portion keeps its precision until it actually overflows `Number`.
+ */
+export declare const DECIMAL_FRACTIONAL_BITS = 48n;
+export declare const DECIMAL_FRACTIONAL_DIVISOR: bigint;
+export declare function convertDecimalBitsToNumber(value: bigint): number;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/extensions/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/extensions/decimal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,0BAA0B,QAAgC,CAAC;AAExE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE"}

package/dist/extensions/decimal.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DECIMAL_FRACTIONAL_DIVISOR = exports.DECIMAL_FRACTIONAL_BITS = void 0;
+exports.convertDecimalBitsToNumber = convertDecimalBitsToNumber;
+/**
+ * High water mark and other on-chain decimal values use the Rust `U80F48`
+ * fixed-point representation: a 128-bit unsigned integer whose lower 48 bits
+ * encode the fractional part. Convert to a JS `number` by splitting integer
+ * and fractional halves before crossing the float boundary, so the integer
+ * portion keeps its precision until it actually overflows `Number`.
+ */
+exports.DECIMAL_FRACTIONAL_BITS = 48n;
+exports.DECIMAL_FRACTIONAL_DIVISOR = 1n << exports.DECIMAL_FRACTIONAL_BITS;
+function convertDecimalBitsToNumber(value) {
+    const integer = value >> exports.DECIMAL_FRACTIONAL_BITS;
+    const frac = value & (exports.DECIMAL_FRACTIONAL_DIVISOR - 1n);
+    return Number(integer) + Number(frac) / Number(exports.DECIMAL_FRACTIONAL_DIVISOR);
+}
+//# sourceMappingURL=decimal.js.map

package/dist/extensions/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../../src/extensions/decimal.ts"],"names":[],"mappings":";;;AAUA,gEAIC;AAdD;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAC9B,QAAA,0BAA0B,GAAG,EAAE,IAAI,+BAAuB,CAAC;AAExE,SAAgB,0BAA0B,CAAC,KAAa;IACtD,MAAM,OAAO,GAAG,KAAK,IAAI,+BAAuB,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,kCAA0B,GAAG,EAAE,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,kCAA0B,CAAC,CAAC;AAC7E,CAAC"}

package/dist/extensions/fees.d.ts

@@ -0,0 +1,6 @@
+import type { Address } from "@solana/kit";
+import type { GetAccountInfoRpc } from "./rpc";
+export declare function getAccumulatedAdminFeesForVault(rpc: GetAccountInfoRpc, vault: Address): Promise<bigint>;
+export declare function getAccumulatedManagerFeesForVault(rpc: GetAccountInfoRpc, vault: Address): Promise<bigint>;
+export declare function getAccumulatedProtocolFeesForVault(rpc: GetAccountInfoRpc, vault: Address): Promise<bigint>;
+//# sourceMappingURL=fees.d.ts.map

package/dist/extensions/fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../src/extensions/fees.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAU/C,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,kCAAkC,CACtD,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/extensions/fees.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAccumulatedAdminFeesForVault = getAccumulatedAdminFeesForVault;
+exports.getAccumulatedManagerFeesForVault = getAccumulatedManagerFeesForVault;
+exports.getAccumulatedProtocolFeesForVault = getAccumulatedProtocolFeesForVault;
+const generated_1 = require("../generated");
+async function loadVault(rpc, vault) {
+    const account = await (0, generated_1.fetchVault)(rpc, vault);
+    return account.data;
+}
+async function getAccumulatedAdminFeesForVault(rpc, vault) {
+    const data = await loadVault(rpc, vault);
+    return data.feeState.accumulatedLpAdminFees;
+}
+async function getAccumulatedManagerFeesForVault(rpc, vault) {
+    const data = await loadVault(rpc, vault);
+    return data.feeState.accumulatedLpManagerFees;
+}
+async function getAccumulatedProtocolFeesForVault(rpc, vault) {
+    const data = await loadVault(rpc, vault);
+    return data.feeState.accumulatedLpProtocolFees;
+}
+//# sourceMappingURL=fees.js.map

package/dist/extensions/fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../src/extensions/fees.ts"],"names":[],"mappings":";;AAaA,0EAMC;AAED,8EAMC;AAED,gFAMC;AAjCD,4CAAsD;AAGtD,KAAK,UAAU,SAAS,CACtB,GAAsB,EACtB,KAAc;IAEd,MAAM,OAAO,GAAG,MAAM,IAAA,sBAAU,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AAEM,KAAK,UAAU,+BAA+B,CACnD,GAAsB,EACtB,KAAc;IAEd,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;AAC9C,CAAC;AAEM,KAAK,UAAU,iCAAiC,CACrD,GAAsB,EACtB,KAAc;IAEd,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC;AAChD,CAAC;AAEM,KAAK,UAAU,kCAAkC,CACtD,GAAsB,EACtB,KAAc;IAEd,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC;AACjD,CAAC"}

package/dist/extensions/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./batchFetchers";
+export * from "./decimal";
+export * from "./fees";
+export * from "./lpEconomics";
+export * from "./math";
+export * from "./metadataPda";
+export * from "./position";
+export * from "./rpc";
+export * from "./withdrawals";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC"}

package/dist/extensions/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./batchFetchers"), exports);
+__exportStar(require("./decimal"), exports);
+__exportStar(require("./fees"), exports);
+__exportStar(require("./lpEconomics"), exports);
+__exportStar(require("./math"), exports);
+__exportStar(require("./metadataPda"), exports);
+__exportStar(require("./position"), exports);
+__exportStar(require("./rpc"), exports);
+__exportStar(require("./withdrawals"), exports);
+//# sourceMappingURL=index.js.map

package/dist/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,4CAA0B;AAC1B,yCAAuB;AACvB,gDAA8B;AAC9B,yCAAuB;AACvB,gDAA8B;AAC9B,6CAA2B;AAC3B,wCAAsB;AACtB,gDAA8B"}

package/dist/extensions/lpEconomics.d.ts

@@ -0,0 +1,27 @@
+import type { Address } from "@solana/kit";
+import { type FeeConfiguration } from "../generated";
+import type { ExtensionsRpc } from "./rpc";
+/**
+ * Total management fee in BPS — sum of manager + admin + protocol, matching
+ * the program's `Vault::get_total_fee_configuration_management_fee`.
+ */
+export declare function getTotalManagementFeeBps(feeConfiguration: FeeConfiguration): number;
+/**
+ * Returns the on-chain "asset per LP" ratio used by mint/burn math: total
+ * asset value divided by `total_lp_supply_incl_fees + unrealised management
+ * fee LP`. Mirrors what the deposit/withdraw handlers see after they call
+ * `handle_management_fee`. Returns 0 when there is no LP at all.
+ */
+export declare function getCurrentAssetPerLpForVault(rpc: ExtensionsRpc, vault: Address): Promise<number>;
+export type VaultLpSupplyBreakdown = {
+    circulating: bigint;
+    unharvestedFees: bigint;
+    deadWeight: bigint;
+    unrealisedFees: bigint;
+    total: bigint;
+};
+export declare function getVaultLpSupplyBreakdown(rpc: ExtensionsRpc, vault: Address): Promise<VaultLpSupplyBreakdown>;
+export declare function calculateAssetsForWithdraw(rpc: ExtensionsRpc, vault: Address, lpAmount: bigint): Promise<bigint>;
+export declare function calculateLpForWithdraw(rpc: ExtensionsRpc, vault: Address, assetAmount: bigint): Promise<bigint>;
+export declare function calculateLpForDeposit(rpc: ExtensionsRpc, vault: Address, assetAmount: bigint): Promise<bigint>;
+//# sourceMappingURL=lpEconomics.d.ts.map

package/dist/extensions/lpEconomics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lpEconomics.d.ts","sourceRoot":"","sources":["../../src/extensions/lpEconomics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,cAAc,CAAC;AAQtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,gBAAgB,GACjC,MAAM,CAMR;AA4BD;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,sBAAsB,CAAC,CAyBjC;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAuCjB"}

package/dist/extensions/lpEconomics.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTotalManagementFeeBps = getTotalManagementFeeBps;
+exports.getCurrentAssetPerLpForVault = getCurrentAssetPerLpForVault;
+exports.getVaultLpSupplyBreakdown = getVaultLpSupplyBreakdown;
+exports.calculateAssetsForWithdraw = calculateAssetsForWithdraw;
+exports.calculateLpForWithdraw = calculateLpForWithdraw;
+exports.calculateLpForDeposit = calculateLpForDeposit;
+const generated_1 = require("../generated");
+const math_1 = require("./math");
+/**
+ * Total management fee in BPS — sum of manager + admin + protocol, matching
+ * the program's `Vault::get_total_fee_configuration_management_fee`.
+ */
+function getTotalManagementFeeBps(feeConfiguration) {
+    return (feeConfiguration.managerManagementFee +
+        feeConfiguration.adminManagementFee +
+        feeConfiguration.protocolManagementFee);
+}
+async function vaultLpMintAddress(vault) {
+    const [address] = await (0, generated_1.findVaultLpMintPda)({ vault }, { programAddress: generated_1.VOLTR_VAULT_PROGRAM_ADDRESS });
+    return address;
+}
+async function fetchTokenSupply(rpc, mint) {
+    const { value } = await rpc.getTokenSupply(mint).send();
+    return { amount: BigInt(value.amount), decimals: value.decimals };
+}
+async function loadVaultAndLpSupply(rpc, vault) {
+    const account = await (0, generated_1.fetchVault)(rpc, vault);
+    const lpMint = await vaultLpMintAddress(vault);
+    const { amount, decimals } = await fetchTokenSupply(rpc, lpMint);
+    return { data: account.data, lpSupply: amount, lpDecimals: decimals };
+}
+/**
+ * Returns the on-chain "asset per LP" ratio used by mint/burn math: total
+ * asset value divided by `total_lp_supply_incl_fees + unrealised management
+ * fee LP`. Mirrors what the deposit/withdraw handlers see after they call
+ * `handle_management_fee`. Returns 0 when there is no LP at all.
+ */
+async function getCurrentAssetPerLpForVault(rpc, vault) {
+    const { data, lpSupply } = await loadVaultAndLpSupply(rpc, vault);
+    const totalLpSupplyInclFees = (0, math_1.getTotalLpSupplyInclFees)({
+        lpSupply,
+        vaultAccumulatedLpAdminFees: data.feeState.accumulatedLpAdminFees,
+        vaultAccumulatedLpManagerFees: data.feeState.accumulatedLpManagerFees,
+        vaultAccumulatedLpProtocolFees: data.feeState.accumulatedLpProtocolFees,
+        vaultDeadWeight: data.deadWeight,
+    });
+    const unrealisedLpFees = (0, math_1.calculateUnrealisedLpFees)(totalLpSupplyInclFees, data.asset.totalValue, data.feeUpdate.lastManagementFeeUpdateTs, BigInt(getTotalManagementFeeBps(data.feeConfiguration)));
+    const totalLpSupply = totalLpSupplyInclFees + unrealisedLpFees;
+    if (totalLpSupply === 0n)
+        return 0;
+    return Number(data.asset.totalValue) / Number(totalLpSupply);
+}
+async function getVaultLpSupplyBreakdown(rpc, vault) {
+    const { data, lpSupply } = await loadVaultAndLpSupply(rpc, vault);
+    const unharvestedFees = data.feeState.accumulatedLpAdminFees +
+        data.feeState.accumulatedLpManagerFees +
+        data.feeState.accumulatedLpProtocolFees;
+    const deadWeight = data.deadWeight;
+    const currentTotalLp = lpSupply + unharvestedFees + deadWeight;
+    const unrealisedFees = (0, math_1.calculateUnrealisedLpFees)(currentTotalLp, data.asset.totalValue, data.feeUpdate.lastManagementFeeUpdateTs, BigInt(getTotalManagementFeeBps(data.feeConfiguration)));
+    return {
+        circulating: lpSupply,
+        unharvestedFees,
+        deadWeight,
+        unrealisedFees,
+        total: currentTotalLp + unrealisedFees,
+    };
+}
+async function calculateAssetsForWithdraw(rpc, vault, lpAmount) {
+    const { data, lpSupply } = await loadVaultAndLpSupply(rpc, vault);
+    return (0, math_1.calculateAssetsForWithdrawAmount)({
+        vaultTotalValue: data.asset.totalValue,
+        vaultLastUpdatedLockedProfit: data.lockedProfitState.lastUpdatedLockedProfit,
+        vaultLastReport: data.lockedProfitState.lastReport,
+        vaultLockedProfitDegradationDuration: data.vaultConfiguration.lockedProfitDegradationDuration,
+        vaultAccumulatedLpAdminFees: data.feeState.accumulatedLpAdminFees,
+        vaultAccumulatedLpManagerFees: data.feeState.accumulatedLpManagerFees,
+        vaultAccumulatedLpProtocolFees: data.feeState.accumulatedLpProtocolFees,
+        vaultDeadWeight: data.deadWeight,
+        vaultRedemptionFeeBps: data.feeConfiguration.redemptionFee,
+        vaultManagementFeeBps: getTotalManagementFeeBps(data.feeConfiguration),
+        vaultLastManagementFeeUpdateTs: data.feeUpdate.lastManagementFeeUpdateTs,
+        lpSupply,
+        lpAmount,
+    });
+}
+async function calculateLpForWithdraw(rpc, vault, assetAmount) {
+    const { data, lpSupply } = await loadVaultAndLpSupply(rpc, vault);
+    return (0, math_1.calculateLpForWithdrawAmount)({
+        vaultTotalValue: data.asset.totalValue,
+        vaultLastUpdatedLockedProfit: data.lockedProfitState.lastUpdatedLockedProfit,
+        vaultLastReport: data.lockedProfitState.lastReport,
+        vaultLockedProfitDegradationDuration: data.vaultConfiguration.lockedProfitDegradationDuration,
+        vaultAccumulatedLpAdminFees: data.feeState.accumulatedLpAdminFees,
+        vaultAccumulatedLpManagerFees: data.feeState.accumulatedLpManagerFees,
+        vaultAccumulatedLpProtocolFees: data.feeState.accumulatedLpProtocolFees,
+        vaultDeadWeight: data.deadWeight,
+        vaultRedemptionFeeBps: data.feeConfiguration.redemptionFee,
+        vaultManagementFeeBps: getTotalManagementFeeBps(data.feeConfiguration),
+        vaultLastManagementFeeUpdateTs: data.feeUpdate.lastManagementFeeUpdateTs,
+        lpSupply,
+        assetAmount,
+    });
+}
+async function calculateLpForDeposit(rpc, vault, assetAmount) {
+    const { data, lpSupply, lpDecimals } = await loadVaultAndLpSupply(rpc, vault);
+    // Asset decimals are only required when the LP pool is empty (1:1 mint).
+    // Avoid an extra RPC round-trip in the common case.
+    let assetDecimals = 0;
+    const lpSupplyInclAccumulatedFees = (0, math_1.getTotalLpSupplyInclFees)({
+        lpSupply,
+        vaultAccumulatedLpAdminFees: data.feeState.accumulatedLpAdminFees,
+        vaultAccumulatedLpManagerFees: data.feeState.accumulatedLpManagerFees,
+        vaultAccumulatedLpProtocolFees: data.feeState.accumulatedLpProtocolFees,
+        vaultDeadWeight: data.deadWeight,
+    });
+    const unrealisedLpFees = (0, math_1.calculateUnrealisedLpFees)(lpSupplyInclAccumulatedFees, data.asset.totalValue, data.feeUpdate.lastManagementFeeUpdateTs, BigInt(getTotalManagementFeeBps(data.feeConfiguration)));
+    const lpSupplyInclFees = lpSupplyInclAccumulatedFees + unrealisedLpFees;
+    if (lpSupplyInclFees === 0n) {
+        const { decimals } = await fetchTokenSupply(rpc, data.asset.mint);
+        assetDecimals = decimals;
+    }
+    return (0, math_1.calculateLpForDepositAmount)({
+        vaultTotalValue: data.asset.totalValue,
+        vaultAccumulatedLpAdminFees: data.feeState.accumulatedLpAdminFees,
+        vaultAccumulatedLpManagerFees: data.feeState.accumulatedLpManagerFees,
+        vaultAccumulatedLpProtocolFees: data.feeState.accumulatedLpProtocolFees,
+        vaultDeadWeight: data.deadWeight,
+        vaultIssuanceFeeBps: data.feeConfiguration.issuanceFee,
+        vaultManagementFeeBps: getTotalManagementFeeBps(data.feeConfiguration),
+        vaultLastManagementFeeUpdateTs: data.feeUpdate.lastManagementFeeUpdateTs,
+        lpSupply,
+        assetAmount,
+        assetDecimals,
+        lpDecimals,
+    });
+}
+//# sourceMappingURL=lpEconomics.js.map

package/dist/extensions/lpEconomics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lpEconomics.js","sourceRoot":"","sources":["../../src/extensions/lpEconomics.ts"],"names":[],"mappings":"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"}

package/dist/extensions/math.d.ts

@@ -0,0 +1,90 @@
+export declare const MAX_FEE_BPS = 10000n;
+export declare const SECONDS_PER_YEAR: bigint;
+/**
+ * Matches `DEAD_WEIGHT` in the program. The first deposit ever made into a
+ * vault donates this many LP units permanently to the vault to prevent
+ * inflation/donation attacks; subsequent deposits are unaffected.
+ */
+export declare const DEAD_WEIGHT_LP = 1000n;
+export declare function maxBigInt(a: bigint, b: bigint): bigint;
+export declare function minBigInt(a: bigint, b: bigint): bigint;
+/** Ceiling division for positive bigints. */
+export declare function ceilDivBigInt(a: bigint, b: bigint): bigint;
+export declare function nowSeconds(): bigint;
+/**
+ * Mirrors the program-side locked-profit decay: the locked profit drops
+ * linearly over `lockedProfitDegradationDuration` and is zero once that
+ * window has elapsed. Note: the legacy JS SDK measured elapsed time from
+ * `lastUpdatedLockedProfit` (an amount, not a timestamp), which produced
+ * incorrect values; this port follows the program, which uses `lastReport`.
+ */
+export declare function calculateLockedProfit(lastUpdatedLockedProfit: bigint, lockedProfitDegradationDuration: bigint, currentTimeSec: bigint, lastReport: bigint): bigint;
+/**
+ * Estimates the LP that would be minted to cover management fees accrued
+ * since `lastManagementFeeUpdateTs`. Returns 0n when the inputs make the
+ * fee calculation undefined (no time elapsed, no assets, etc.).
+ *
+ * Both rounding steps are ceiling divisions, matching the program's
+ * `calc_management_fee_amount_in_asset` and `calc_fee_lp_to_mint` — flooring
+ * the asset fee first would understate the LP that should be minted whenever
+ * the accrued fee isn't an exact multiple of the denominator.
+ */
+export declare function calculateUnrealisedLpFees(currentTotalLp: bigint, assetTotalValue: bigint, lastManagementFeeUpdateTs: bigint, managementFeeBps: bigint, currentTimeSec?: bigint): bigint;
+/**
+ * Total LP supply the program treats as outstanding for accounting:
+ * circulating LP + accumulated (but unharvested) fee LP + dead weight LP.
+ * Matches `Vault::get_total_lp_supply_incl_fees` in the program.
+ */
+export declare function getTotalLpSupplyInclFees(args: {
+    lpSupply: bigint;
+    vaultAccumulatedLpAdminFees: bigint;
+    vaultAccumulatedLpManagerFees: bigint;
+    vaultAccumulatedLpProtocolFees: bigint;
+    vaultDeadWeight: bigint;
+}): bigint;
+export type AssetsForWithdrawInputs = {
+    vaultTotalValue: bigint;
+    vaultLastUpdatedLockedProfit: bigint;
+    vaultLastReport: bigint;
+    vaultLockedProfitDegradationDuration: bigint;
+    vaultAccumulatedLpAdminFees: bigint;
+    vaultAccumulatedLpManagerFees: bigint;
+    vaultAccumulatedLpProtocolFees: bigint;
+    vaultDeadWeight: bigint;
+    vaultRedemptionFeeBps: number;
+    vaultManagementFeeBps: number;
+    vaultLastManagementFeeUpdateTs: bigint;
+    lpSupply: bigint;
+    lpAmount: bigint;
+    currentTimeSec?: bigint;
+};
+export declare function calculateAssetsForWithdrawAmount(inputs: AssetsForWithdrawInputs): bigint;
+export type LpForWithdrawInputs = Omit<AssetsForWithdrawInputs, "lpAmount"> & {
+    assetAmount: bigint;
+};
+/**
+ * Computes the LP that must be burned to redeem at least `assetAmount`,
+ * matching `calc_withdraw_lp_to_burn` in the program (which rounds up so
+ * the burn always covers the requested asset amount). Flooring here would
+ * underquote the burn and either revert or short-redeem.
+ */
+export declare function calculateLpForWithdrawAmount(inputs: LpForWithdrawInputs): bigint;
+export type LpForDepositInputs = {
+    vaultTotalValue: bigint;
+    vaultAccumulatedLpAdminFees: bigint;
+    vaultAccumulatedLpManagerFees: bigint;
+    vaultAccumulatedLpProtocolFees: bigint;
+    vaultDeadWeight: bigint;
+    vaultIssuanceFeeBps: number;
+    vaultManagementFeeBps: number;
+    vaultLastManagementFeeUpdateTs: bigint;
+    lpSupply: bigint;
+    assetAmount: bigint;
+    /** Required when the pool is empty so the 1:1 mint can scale precision correctly. */
+    assetDecimals: number;
+    /** Required when the pool is empty so the 1:1 mint can scale precision correctly. */
+    lpDecimals: number;
+    currentTimeSec?: bigint;
+};
+export declare function calculateLpForDepositAmount(inputs: LpForDepositInputs): bigint;
+//# sourceMappingURL=math.d.ts.map

package/dist/extensions/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/extensions/math.ts"],"names":[],"mappings":"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"}