@voltr/vault-sdk 1.1.0 → 2.1.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/events.d.ts

@@ -0,0 +1,33 @@
+import { type AcceptProtocolAdminEvent, type AcceptVaultAdminEvent, type AddAdaptorEvent, type CalibrateHighWaterMarkEvent, type CalibrateHighWaterMarkUnsafeEvent, type CancelRequestWithdrawVaultEvent, type CloseStrategyEvent, type DepositStrategyEvent, type DepositVaultEvent, type DirectWithdrawStrategyEvent, type HarvestFeeEvent, type InitializeDirectWithdrawStrategyEvent, type InitializeStrategyEvent, type InitializeVaultEvent, type InitProtocolEvent, type InstantWithdrawStrategyEvent, type InstantWithdrawVaultEvent, type RemoveAdaptorEvent, type RequestWithdrawVaultEvent, type UpdateProtocolEvent, type UpdateVaultConfigEvent, type UpdateVaultEvent, type UpdateVaultProtocolFeeEvent, type WithdrawStrategyEvent, type WithdrawVaultEvent } from "../generated/types";
+/**
+ * Discriminated union of every Voltr Vault event Codama can decode. The first
+ * 8 bytes of each Anchor `emit!` payload identify the variant via
+ * `sha256("event:<EventName>")[..8]`; the remainder is the borsh-encoded
+ * payload for the named struct.
+ */
+export type ParsedVoltrEvent = ParsedEventOf<"AcceptProtocolAdminEvent", AcceptProtocolAdminEvent> | ParsedEventOf<"AcceptVaultAdminEvent", AcceptVaultAdminEvent> | ParsedEventOf<"AddAdaptorEvent", AddAdaptorEvent> | ParsedEventOf<"CalibrateHighWaterMarkEvent", CalibrateHighWaterMarkEvent> | ParsedEventOf<"CalibrateHighWaterMarkUnsafeEvent", CalibrateHighWaterMarkUnsafeEvent> | ParsedEventOf<"CancelRequestWithdrawVaultEvent", CancelRequestWithdrawVaultEvent> | ParsedEventOf<"CloseStrategyEvent", CloseStrategyEvent> | ParsedEventOf<"DepositStrategyEvent", DepositStrategyEvent> | ParsedEventOf<"DepositVaultEvent", DepositVaultEvent> | ParsedEventOf<"DirectWithdrawStrategyEvent", DirectWithdrawStrategyEvent> | ParsedEventOf<"HarvestFeeEvent", HarvestFeeEvent> | ParsedEventOf<"InitProtocolEvent", InitProtocolEvent> | ParsedEventOf<"InitializeDirectWithdrawStrategyEvent", InitializeDirectWithdrawStrategyEvent> | ParsedEventOf<"InitializeStrategyEvent", InitializeStrategyEvent> | ParsedEventOf<"InitializeVaultEvent", InitializeVaultEvent> | ParsedEventOf<"InstantWithdrawStrategyEvent", InstantWithdrawStrategyEvent> | ParsedEventOf<"InstantWithdrawVaultEvent", InstantWithdrawVaultEvent> | ParsedEventOf<"RemoveAdaptorEvent", RemoveAdaptorEvent> | ParsedEventOf<"RequestWithdrawVaultEvent", RequestWithdrawVaultEvent> | ParsedEventOf<"UpdateProtocolEvent", UpdateProtocolEvent> | ParsedEventOf<"UpdateVaultConfigEvent", UpdateVaultConfigEvent> | ParsedEventOf<"UpdateVaultEvent", UpdateVaultEvent> | ParsedEventOf<"UpdateVaultProtocolFeeEvent", UpdateVaultProtocolFeeEvent> | ParsedEventOf<"WithdrawStrategyEvent", WithdrawStrategyEvent> | ParsedEventOf<"WithdrawVaultEvent", WithdrawVaultEvent>;
+type ParsedEventOf<Name extends string, Payload> = {
+    name: Name;
+    payload: Payload;
+    /** Top-level instruction index this event was emitted under. */
+    ixIndex: number;
+    /** Sequential index of this event within the transaction (0-based). */
+    eventIndex: number;
+};
+/**
+ * Minimal structural shape of a transaction `meta` object — narrow enough
+ * that callers can pass `meta` from any RPC client (web3.js legacy,
+ * @solana/kit, or a hand-rolled fixture) without conversion.
+ */
+export type TransactionMetaForEvents = {
+    logMessages?: readonly string[] | null;
+};
+/**
+ * Walk a transaction's `meta.logMessages`, decode every Voltr event emitted
+ * via Anchor's `emit!`, and return them in emission order. Lines whose
+ * discriminator doesn't belong to a Voltr event are skipped, so logs from
+ * other programs in the same tx are safe to pass through.
+ */
+export declare function parseTransactionEvents(meta: TransactionMetaForEvents | null | undefined): ParsedVoltrEvent[];
+export {};
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/extensions/events.ts"],"names":[],"mappings":"AAEA,OAAO,EA0BL,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EACtC,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,qCAAqC,EAC1C,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,aAAa,CAAC,0BAA0B,EAAE,wBAAwB,CAAC,GACnE,aAAa,CAAC,uBAAuB,EAAE,qBAAqB,CAAC,GAC7D,aAAa,CAAC,iBAAiB,EAAE,eAAe,CAAC,GACjD,aAAa,CAAC,6BAA6B,EAAE,2BAA2B,CAAC,GACzE,aAAa,CACX,mCAAmC,EACnC,iCAAiC,CAClC,GACD,aAAa,CACX,iCAAiC,EACjC,+BAA+B,CAChC,GACD,aAAa,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,GACvD,aAAa,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,GAC3D,aAAa,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,GACrD,aAAa,CAAC,6BAA6B,EAAE,2BAA2B,CAAC,GACzE,aAAa,CAAC,iBAAiB,EAAE,eAAe,CAAC,GACjD,aAAa,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,GACrD,aAAa,CACX,uCAAuC,EACvC,qCAAqC,CACtC,GACD,aAAa,CAAC,yBAAyB,EAAE,uBAAuB,CAAC,GACjE,aAAa,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,GAC3D,aAAa,CAAC,8BAA8B,EAAE,4BAA4B,CAAC,GAC3E,aAAa,CAAC,2BAA2B,EAAE,yBAAyB,CAAC,GACrE,aAAa,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,GACvD,aAAa,CAAC,2BAA2B,EAAE,yBAAyB,CAAC,GACrE,aAAa,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,GACzD,aAAa,CAAC,wBAAwB,EAAE,sBAAsB,CAAC,GAC/D,aAAa,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,GACnD,aAAa,CAAC,6BAA6B,EAAE,2BAA2B,CAAC,GACzE,aAAa,CAAC,uBAAuB,EAAE,qBAAqB,CAAC,GAC7D,aAAa,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;AAE5D,KAAK,aAAa,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,IAAI;IACjD,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACxC,CAAC;AAwJF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,GAChD,gBAAgB,EAAE,CA6CpB"}

package/dist/extensions/events.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTransactionEvents = parseTransactionEvents;
+const kit_1 = require("@solana/kit");
+const types_1 = require("../generated/types");
+// Discriminators are sha256("event:<EventName>")[..8] — stable, fixed by the
+// Anchor IDL. Hardcoded so this module has no runtime hashing dependency.
+const EVENT_TABLE = [
+    [
+        "AcceptProtocolAdminEvent",
+        [0xc4, 0x5d, 0xad, 0xfd, 0xaf, 0x8c, 0x79, 0x20],
+        (0, types_1.getAcceptProtocolAdminEventDecoder)(),
+    ],
+    [
+        "AcceptVaultAdminEvent",
+        [0x8c, 0xff, 0x1d, 0x44, 0x10, 0xc2, 0xfb, 0x23],
+        (0, types_1.getAcceptVaultAdminEventDecoder)(),
+    ],
+    [
+        "AddAdaptorEvent",
+        [0x18, 0xb5, 0xc9, 0x94, 0xf0, 0xb7, 0xeb, 0x0c],
+        (0, types_1.getAddAdaptorEventDecoder)(),
+    ],
+    [
+        "CalibrateHighWaterMarkEvent",
+        [0x8c, 0x4c, 0xc3, 0x90, 0xb4, 0xb2, 0x00, 0x9b],
+        (0, types_1.getCalibrateHighWaterMarkEventDecoder)(),
+    ],
+    [
+        "CalibrateHighWaterMarkUnsafeEvent",
+        [0xcd, 0x4c, 0xa9, 0xff, 0x25, 0xe4, 0x41, 0x82],
+        (0, types_1.getCalibrateHighWaterMarkUnsafeEventDecoder)(),
+    ],
+    [
+        "CancelRequestWithdrawVaultEvent",
+        [0x2e, 0xa5, 0x18, 0x72, 0x01, 0x50, 0xcd, 0x88],
+        (0, types_1.getCancelRequestWithdrawVaultEventDecoder)(),
+    ],
+    [
+        "CloseStrategyEvent",
+        [0xd5, 0x5f, 0xdb, 0xa1, 0x11, 0xd0, 0x5d, 0xff],
+        (0, types_1.getCloseStrategyEventDecoder)(),
+    ],
+    [
+        "DepositStrategyEvent",
+        [0xca, 0xc9, 0x76, 0x31, 0x1d, 0xb4, 0x74, 0xaa],
+        (0, types_1.getDepositStrategyEventDecoder)(),
+    ],
+    [
+        "DepositVaultEvent",
+        [0x0b, 0x0f, 0x07, 0x5c, 0x96, 0x64, 0xa5, 0xe8],
+        (0, types_1.getDepositVaultEventDecoder)(),
+    ],
+    [
+        "DirectWithdrawStrategyEvent",
+        [0x71, 0xca, 0x97, 0x7c, 0x89, 0xff, 0x99, 0x65],
+        (0, types_1.getDirectWithdrawStrategyEventDecoder)(),
+    ],
+    [
+        "HarvestFeeEvent",
+        [0x45, 0x30, 0xc0, 0x17, 0xe8, 0x16, 0x17, 0x1e],
+        (0, types_1.getHarvestFeeEventDecoder)(),
+    ],
+    [
+        "InitProtocolEvent",
+        [0x0d, 0x51, 0xb7, 0x84, 0x58, 0x2b, 0xca, 0xd5],
+        (0, types_1.getInitProtocolEventDecoder)(),
+    ],
+    [
+        "InitializeDirectWithdrawStrategyEvent",
+        [0xa9, 0x16, 0x39, 0x08, 0x0f, 0x49, 0xff, 0x73],
+        (0, types_1.getInitializeDirectWithdrawStrategyEventDecoder)(),
+    ],
+    [
+        "InitializeStrategyEvent",
+        [0x1e, 0xe9, 0xd3, 0xf9, 0x53, 0xbc, 0xea, 0x98],
+        (0, types_1.getInitializeStrategyEventDecoder)(),
+    ],
+    [
+        "InitializeVaultEvent",
+        [0xb3, 0x4b, 0x32, 0xa1, 0xbf, 0x1c, 0xf5, 0x6b],
+        (0, types_1.getInitializeVaultEventDecoder)(),
+    ],
+    [
+        "InstantWithdrawStrategyEvent",
+        [0xdd, 0x17, 0x0c, 0xd7, 0x64, 0x2a, 0x61, 0x95],
+        (0, types_1.getInstantWithdrawStrategyEventDecoder)(),
+    ],
+    [
+        "InstantWithdrawVaultEvent",
+        [0x2e, 0x39, 0x3c, 0x14, 0x06, 0xa0, 0xa4, 0xf7],
+        (0, types_1.getInstantWithdrawVaultEventDecoder)(),
+    ],
+    [
+        "RemoveAdaptorEvent",
+        [0x9b, 0xb2, 0x02, 0x1d, 0xf5, 0x56, 0xf6, 0x99],
+        (0, types_1.getRemoveAdaptorEventDecoder)(),
+    ],
+    [
+        "RequestWithdrawVaultEvent",
+        [0x3b, 0x5e, 0x1a, 0x26, 0x2f, 0x83, 0x9e, 0xa2],
+        (0, types_1.getRequestWithdrawVaultEventDecoder)(),
+    ],
+    [
+        "UpdateProtocolEvent",
+        [0x0e, 0xe3, 0xcc, 0xd9, 0x3e, 0x2e, 0xf1, 0xed],
+        (0, types_1.getUpdateProtocolEventDecoder)(),
+    ],
+    [
+        "UpdateVaultConfigEvent",
+        [0x3d, 0x5c, 0xce, 0x97, 0xa2, 0x28, 0xed, 0x67],
+        (0, types_1.getUpdateVaultConfigEventDecoder)(),
+    ],
+    [
+        "UpdateVaultEvent",
+        [0x7b, 0x1f, 0x1b, 0xbd, 0x66, 0x01, 0x79, 0x39],
+        (0, types_1.getUpdateVaultEventDecoder)(),
+    ],
+    [
+        "UpdateVaultProtocolFeeEvent",
+        [0xac, 0x01, 0xad, 0xe6, 0xe4, 0x3d, 0x4d, 0xf4],
+        (0, types_1.getUpdateVaultProtocolFeeEventDecoder)(),
+    ],
+    [
+        "WithdrawStrategyEvent",
+        [0x70, 0x2d, 0x10, 0xac, 0xaa, 0x21, 0x16, 0xd4],
+        (0, types_1.getWithdrawStrategyEventDecoder)(),
+    ],
+    [
+        "WithdrawVaultEvent",
+        [0xc4, 0x7b, 0x4f, 0xd7, 0x04, 0xd6, 0x14, 0xc5],
+        (0, types_1.getWithdrawVaultEventDecoder)(),
+    ],
+];
+const DISPATCH = new Map(EVENT_TABLE.map(([name, disc, decoder]) => [
+    discriminatorKey(disc),
+    { name, decoder },
+]));
+const PROGRAM_DATA_PREFIX = "Program data: ";
+// Top-level instructions log "Program <id> invoke [1]" — depth >1 is a CPI.
+const TOP_LEVEL_INVOKE_RE = /^Program \S+ invoke \[1\]$/;
+const base64Encoder = (0, kit_1.getBase64Encoder)();
+/**
+ * Walk a transaction's `meta.logMessages`, decode every Voltr event emitted
+ * via Anchor's `emit!`, and return them in emission order. Lines whose
+ * discriminator doesn't belong to a Voltr event are skipped, so logs from
+ * other programs in the same tx are safe to pass through.
+ */
+function parseTransactionEvents(meta) {
+    const logs = meta?.logMessages;
+    if (!logs || logs.length === 0)
+        return [];
+    const out = [];
+    let ixIndex = -1;
+    let eventIndex = 0;
+    for (const line of logs) {
+        if (TOP_LEVEL_INVOKE_RE.test(line)) {
+            ixIndex++;
+            continue;
+        }
+        if (!line.startsWith(PROGRAM_DATA_PREFIX))
+            continue;
+        const b64 = line.slice(PROGRAM_DATA_PREFIX.length);
+        let bytes;
+        try {
+            bytes = base64Encoder.encode(b64);
+        }
+        catch {
+            continue;
+        }
+        if (bytes.length < 8)
+            continue;
+        const entry = DISPATCH.get(discriminatorKey(bytes.subarray(0, 8)));
+        if (!entry)
+            continue;
+        // The discriminator is 8 bytes of sha256, so spurious matches from other
+        // programs are unlikely but possible — and corrupt fixtures happen too.
+        // Skip the line rather than aborting the whole parse if borsh decode fails.
+        let payload;
+        try {
+            payload = entry.decoder.decode(bytes, 8);
+        }
+        catch {
+            continue;
+        }
+        out.push({
+            name: entry.name,
+            payload,
+            ixIndex: ixIndex < 0 ? 0 : ixIndex,
+            eventIndex: eventIndex++,
+        });
+    }
+    return out;
+}
+function discriminatorKey(disc) {
+    let s = "";
+    for (let i = 0; i < disc.length; i++) {
+        const b = disc[i] & 0xff;
+        s += (b < 16 ? "0" : "") + b.toString(16);
+    }
+    return s;
+}
+//# sourceMappingURL=events.js.map

package/dist/extensions/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/extensions/events.ts"],"names":[],"mappings":";;AA+QA,wDA+CC;AA9TD,qCAA6D;AAE7D,8CAmD4B;AAmE5B,6EAA6E;AAC7E,0EAA0E;AAC1E,MAAM,WAAW,GAEb;IACF;QACE,0BAA0B;QAC1B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,0CAAkC,GAAE;KACrC;IACD;QACE,uBAAuB;QACvB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,uCAA+B,GAAE;KAClC;IACD;QACE,iBAAiB;QACjB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,iCAAyB,GAAE;KAC5B;IACD;QACE,6BAA6B;QAC7B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,6CAAqC,GAAE;KACxC;IACD;QACE,mCAAmC;QACnC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,mDAA2C,GAAE;KAC9C;IACD;QACE,iCAAiC;QACjC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,iDAAyC,GAAE;KAC5C;IACD;QACE,oBAAoB;QACpB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,oCAA4B,GAAE;KAC/B;IACD;QACE,sBAAsB;QACtB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,sCAA8B,GAAE;KACjC;IACD;QACE,mBAAmB;QACnB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,mCAA2B,GAAE;KAC9B;IACD;QACE,6BAA6B;QAC7B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,6CAAqC,GAAE;KACxC;IACD;QACE,iBAAiB;QACjB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,iCAAyB,GAAE;KAC5B;IACD;QACE,mBAAmB;QACnB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,mCAA2B,GAAE;KAC9B;IACD;QACE,uCAAuC;QACvC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,uDAA+C,GAAE;KAClD;IACD;QACE,yBAAyB;QACzB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,yCAAiC,GAAE;KACpC;IACD;QACE,sBAAsB;QACtB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,sCAA8B,GAAE;KACjC;IACD;QACE,8BAA8B;QAC9B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,8CAAsC,GAAE;KACzC;IACD;QACE,2BAA2B;QAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,2CAAmC,GAAE;KACtC;IACD;QACE,oBAAoB;QACpB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,oCAA4B,GAAE;KAC/B;IACD;QACE,2BAA2B;QAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,2CAAmC,GAAE;KACtC;IACD;QACE,qBAAqB;QACrB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,qCAA6B,GAAE;KAChC;IACD;QACE,wBAAwB;QACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,wCAAgC,GAAE;KACnC;IACD;QACE,kBAAkB;QAClB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,kCAA0B,GAAE;KAC7B;IACD;QACE,6BAA6B;QAC7B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,6CAAqC,GAAE;KACxC;IACD;QACE,uBAAuB;QACvB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,uCAA+B,GAAE;KAClC;IACD;QACE,oBAAoB;QACpB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAChD,IAAA,oCAA4B,GAAE;KAC/B;CACF,CAAC;AAEF,MAAM,QAAQ,GAAuC,IAAI,GAAG,CAC1D,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;IACzC,gBAAgB,CAAC,IAAI,CAAC;IACtB,EAAE,IAAI,EAAE,OAAO,EAAE;CAClB,CAAC,CACH,CAAC;AAEF,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAC7C,4EAA4E;AAC5E,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAEzD,MAAM,aAAa,GAAG,IAAA,sBAAgB,GAAE,CAAC;AAEzC;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,IAAiD;IAEjD,MAAM,IAAI,GAAG,IAAI,EAAE,WAAW,CAAC;IAC/B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1C,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC;YAAE,SAAS;QAEpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,KAAiB,CAAC;QACtB,IAAI,CAAC;YACH,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAe,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE/B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,yEAAyE;QACzE,wEAAwE;QACxE,4EAA4E;QAC5E,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO;YACP,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;YAClC,UAAU,EAAE,UAAU,EAAE;SACL,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAuB;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACzB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,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,11 @@
+export * from "./batchFetchers";
+export * from "./decimal";
+export * from "./events";
+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,UAAU,CAAC;AACzB,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,27 @@
+"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("./events"), 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,2CAAyB;AACzB,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