@augustdigital/sdk 4.24.9 → 4.25.0-alpha.0

package/lib/modules/vaults/utils/call-data-decoder.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeWithdrawalProcessing = decodeWithdrawalProcessing;
+exports.decodeFromReceiptLogs = decodeFromReceiptLogs;
+exports.isMulticall = isMulticall;
+exports.isWithdrawalProcessingFunction = isWithdrawalProcessingFunction;
+function decodeWithdrawalProcessing(txData, iface) {
+    try {
+        const decoded = iface.parseTransaction({ data: txData });
+        if (!decoded || !decoded.args || decoded.args.length < 3) {
+            return {
+                functionName: 'unknown',
+                year: 0,
+                month: 0,
+                day: 0,
+                error: 'Invalid calldata: insufficient args',
+            };
+        }
+        const year = Number(decoded.args[0]);
+        const month = Number(decoded.args[1]);
+        const day = Number(decoded.args[2]);
+        if (year < 2000 || year > 2100 || month < 1 || month > 12 || day < 1) {
+            return {
+                functionName: 'unknown',
+                year,
+                month,
+                day,
+                error: 'Invalid date parameters',
+            };
+        }
+        const daysInMonth = new Date(Date.UTC(year, month, 0)).getUTCDate();
+        if (day > daysInMonth) {
+            return {
+                functionName: 'unknown',
+                year,
+                month,
+                day,
+                error: `Invalid day for month: ${day} > ${daysInMonth}`,
+            };
+        }
+        if (decoded.name === 'processAllClaimsByDate') {
+            const maxLimit = decoded.args[3] ? Number(decoded.args[3]) : undefined;
+            return {
+                functionName: 'processAllClaimsByDate',
+                year,
+                month,
+                day,
+                maxLimit,
+            };
+        }
+        else if (decoded.name === 'claim') {
+            const receiverAddr = decoded.args[3];
+            if (!receiverAddr) {
+                return {
+                    functionName: 'unknown',
+                    year,
+                    month,
+                    day,
+                    error: 'Missing receiver address in claim()',
+                };
+            }
+            return {
+                functionName: 'claim',
+                year,
+                month,
+                day,
+                receiverAddr: receiverAddr.toString(),
+            };
+        }
+        return {
+            functionName: 'unknown',
+            year,
+            month,
+            day,
+            error: `Unknown withdrawal function: ${decoded.name}`,
+        };
+    }
+    catch (error) {
+        return {
+            functionName: 'unknown',
+            year: 0,
+            month: 0,
+            day: 0,
+            error: error instanceof Error ? error.message : 'Unknown decoding error',
+        };
+    }
+}
+async function decodeFromReceiptLogs(receipt, vaultAddress, iface) {
+    if (!receipt) {
+        return {
+            functionName: 'unknown',
+            year: 0,
+            month: 0,
+            day: 0,
+            error: 'No receipt available',
+        };
+    }
+    for (const log of receipt.logs) {
+        if (log.address.toLowerCase() !== vaultAddress.toLowerCase()) {
+            continue;
+        }
+        try {
+            const parsed = iface.parseLog(log);
+            if (parsed && parsed.name === 'WithdrawalProcessed') {
+                return {
+                    functionName: 'processAllClaimsByDate',
+                    year: 0,
+                    month: 0,
+                    day: 0,
+                    error: 'Event found but date not available in event schema',
+                };
+            }
+        }
+        catch (e) {
+        }
+    }
+    return {
+        functionName: 'unknown',
+        year: 0,
+        month: 0,
+        day: 0,
+        error: 'No WithdrawalProcessed logs found',
+    };
+}
+function isMulticall(functionName) {
+    const multicallNames = [
+        'multicall',
+        'aggregate',
+        'aggregate3',
+        'batchcall',
+        'batch',
+    ];
+    return multicallNames.includes(functionName.toLowerCase());
+}
+function isWithdrawalProcessingFunction(functionName) {
+    return functionName === 'processAllClaimsByDate' || functionName === 'claim';
+}
+//# sourceMappingURL=call-data-decoder.js.map

package/lib/modules/vaults/utils/call-data-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-data-decoder.js","sourceRoot":"","sources":["../../../../src.ts/modules/vaults/utils/call-data-decoder.ts"],"names":[],"mappings":";;AA6BA,gEA4FC;AAiBD,sDA8CC;AAYD,kCASC;AAQD,wEAEC;AA1LD,SAAgB,0BAA0B,CACxC,MAAc,EACd,KAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAGzD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,OAAO;gBACL,YAAY,EAAE,SAAS;gBACvB,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,CAAC;gBACR,GAAG,EAAE,CAAC;gBACN,KAAK,EAAE,qCAAqC;aAC7C,CAAC;QACJ,CAAC;QAGD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAGpC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACrE,OAAO;gBACL,YAAY,EAAE,SAAS;gBACvB,IAAI;gBACJ,KAAK;gBACL,GAAG;gBACH,KAAK,EAAE,yBAAyB;aACjC,CAAC;QACJ,CAAC;QAGD,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QACpE,IAAI,GAAG,GAAG,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,YAAY,EAAE,SAAS;gBACvB,IAAI;gBACJ,KAAK;gBACL,GAAG;gBACH,KAAK,EAAE,0BAA0B,GAAG,MAAM,WAAW,EAAE;aACxD,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACvE,OAAO;gBACL,YAAY,EAAE,wBAAiC;gBAC/C,IAAI;gBACJ,KAAK;gBACL,GAAG;gBACH,QAAQ;aACT,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACpC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO;oBACL,YAAY,EAAE,SAAS;oBACvB,IAAI;oBACJ,KAAK;oBACL,GAAG;oBACH,KAAK,EAAE,qCAAqC;iBAC7C,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,YAAY,EAAE,OAAgB;gBAC9B,IAAI;gBACJ,KAAK;gBACL,GAAG;gBACH,YAAY,EAAE,YAAY,CAAC,QAAQ,EAAE;aACtC,CAAC;QACJ,CAAC;QAGD,OAAO;YACL,YAAY,EAAE,SAAkB;YAChC,IAAI;YACJ,KAAK;YACL,GAAG;YACH,KAAK,EAAE,gCAAgC,OAAO,CAAC,IAAI,EAAE;SACtD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;SACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAiBM,KAAK,UAAU,qBAAqB,CACzC,OAA0C,EAC1C,YAAoB,EACpB,KAAgB;IAEhB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,sBAAsB;SAC9B,CAAC;IACJ,CAAC;IAGD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAGpD,OAAO;oBACL,YAAY,EAAE,wBAAwB;oBACtC,IAAI,EAAE,CAAC;oBACP,KAAK,EAAE,CAAC;oBACR,GAAG,EAAE,CAAC;oBACN,KAAK,EAAE,oDAAoD;iBAC5D,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;QAEb,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,GAAG,EAAE,CAAC;QACN,KAAK,EAAE,mCAAmC;KAC3C,CAAC;AACJ,CAAC;AAYD,SAAgB,WAAW,CAAC,YAAoB;IAC9C,MAAM,cAAc,GAAG;QACrB,WAAW;QACX,WAAW;QACX,YAAY;QACZ,WAAW;QACX,OAAO;KACR,CAAC;IACF,OAAO,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC;AAQD,SAAgB,8BAA8B,CAAC,YAAoB;IACjE,OAAO,YAAY,KAAK,wBAAwB,IAAI,YAAY,KAAK,OAAO,CAAC;AAC/E,CAAC"}

package/lib/modules/vaults/utils/callDataDecoder.d.ts

@@ -0,0 +1,14 @@
+import { ContractTransactionReceipt, Interface } from 'ethers';
+export interface ProcessingCallData {
+    functionName: 'processAllClaimsByDate' | 'claim' | 'unknown';
+    year: number;
+    month: number;
+    day: number;
+    maxLimit?: number;
+    receiverAddr?: string;
+    error?: string;
+}
+export declare function decodeWithdrawalProcessing(txData: string, iface: Interface): ProcessingCallData;
+export declare function decodeFromReceiptLogs(receipt: ContractTransactionReceipt | null, vaultAddress: string, iface: Interface): Promise<ProcessingCallData>;
+export declare function isMulticall(functionName: string): boolean;
+export declare function isWithdrawalProcessingFunction(functionName: string): boolean;

package/lib/modules/vaults/utils/callDataDecoder.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeWithdrawalProcessing = decodeWithdrawalProcessing;
+exports.decodeFromReceiptLogs = decodeFromReceiptLogs;
+exports.isMulticall = isMulticall;
+exports.isWithdrawalProcessingFunction = isWithdrawalProcessingFunction;
+function decodeWithdrawalProcessing(txData, iface) {
+    try {
+        const decoded = iface.parseTransaction({ data: txData });
+        if (!decoded || !decoded.args || decoded.args.length < 3) {
+            return {
+                functionName: 'unknown',
+                year: 0,
+                month: 0,
+                day: 0,
+                error: 'Invalid calldata: insufficient args',
+            };
+        }
+        const year = Number(decoded.args[0]);
+        const month = Number(decoded.args[1]);
+        const day = Number(decoded.args[2]);
+        if (year < 2000 || year > 2100 || month < 1 || month > 12 || day < 1) {
+            return {
+                functionName: 'unknown',
+                year,
+                month,
+                day,
+                error: 'Invalid date parameters',
+            };
+        }
+        const daysInMonth = new Date(year, month, 0).getDate();
+        if (day > daysInMonth) {
+            return {
+                functionName: 'unknown',
+                year,
+                month,
+                day,
+                error: `Invalid day for month: ${day} > ${daysInMonth}`,
+            };
+        }
+        if (decoded.name === 'processAllClaimsByDate') {
+            const maxLimit = decoded.args[3] ? Number(decoded.args[3]) : undefined;
+            return {
+                functionName: 'processAllClaimsByDate',
+                year,
+                month,
+                day,
+                maxLimit,
+            };
+        }
+        else if (decoded.name === 'claim') {
+            const receiverAddr = decoded.args[3];
+            if (!receiverAddr) {
+                return {
+                    functionName: 'unknown',
+                    year,
+                    month,
+                    day,
+                    error: 'Missing receiver address in claim()',
+                };
+            }
+            return {
+                functionName: 'claim',
+                year,
+                month,
+                day,
+                receiverAddr: receiverAddr.toString(),
+            };
+        }
+        return {
+            functionName: 'unknown',
+            year,
+            month,
+            day,
+            error: `Unknown withdrawal function: ${decoded.name}`,
+        };
+    }
+    catch (error) {
+        return {
+            functionName: 'unknown',
+            year: 0,
+            month: 0,
+            day: 0,
+            error: error instanceof Error ? error.message : 'Unknown decoding error',
+        };
+    }
+}
+async function decodeFromReceiptLogs(receipt, vaultAddress, iface) {
+    if (!receipt) {
+        return {
+            functionName: 'unknown',
+            year: 0,
+            month: 0,
+            day: 0,
+            error: 'No receipt available',
+        };
+    }
+    for (const log of receipt.logs) {
+        if (log.address.toLowerCase() !== vaultAddress.toLowerCase()) {
+            continue;
+        }
+        try {
+            const parsed = iface.parseLog(log);
+            if (parsed && parsed.name === 'WithdrawalProcessed') {
+                return {
+                    functionName: 'processAllClaimsByDate',
+                    year: 0,
+                    month: 0,
+                    day: 0,
+                    error: 'Cannot extract date from logs (use Option 2 subgraph indexing)',
+                };
+            }
+        }
+        catch (e) {
+        }
+    }
+    return {
+        functionName: 'unknown',
+        year: 0,
+        month: 0,
+        day: 0,
+        error: 'No WithdrawalProcessed logs found',
+    };
+}
+function isMulticall(functionName) {
+    const multicallNames = [
+        'multicall',
+        'aggregate',
+        'aggregate3',
+        'batchcall',
+        'batch',
+    ];
+    return multicallNames.includes(functionName.toLowerCase());
+}
+function isWithdrawalProcessingFunction(functionName) {
+    return functionName === 'processAllClaimsByDate' || functionName === 'claim';
+}
+//# sourceMappingURL=callDataDecoder.js.map

package/lib/modules/vaults/utils/callDataDecoder.js.map

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

package/lib/modules/vaults/utils/date-utils.d.ts

@@ -0,0 +1,11 @@
+export interface ClaimableDate {
+    year: number;
+    month: number;
+    day: number;
+    epoch: number;
+}
+export declare function computeClaimableDate(requestTimestamp: number, lagDuration: number): ClaimableDate;
+export declare function isClaimableNow(claimableEpoch: number, currentEpoch: number): boolean;
+export declare function formatDateKey(year: number, month: number, day: number): string;
+export declare function isValidClaimableDate(date: ClaimableDate): boolean;
+export declare function getDaysInMonth(year: number, month: number): number;

package/lib/modules/vaults/utils/date-utils.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeClaimableDate = computeClaimableDate;
+exports.isClaimableNow = isClaimableNow;
+exports.formatDateKey = formatDateKey;
+exports.isValidClaimableDate = isValidClaimableDate;
+exports.getDaysInMonth = getDaysInMonth;
+function computeClaimableDate(requestTimestamp, lagDuration) {
+    const TIMESTAMP_MANIPULATION_WINDOW = 300;
+    const claimableEpoch = requestTimestamp + TIMESTAMP_MANIPULATION_WINDOW + lagDuration;
+    const date = new Date(claimableEpoch * 1000);
+    const year = date.getUTCFullYear();
+    const month = date.getUTCMonth() + 1;
+    const day = date.getUTCDate();
+    return { year, month, day, epoch: claimableEpoch };
+}
+function isClaimableNow(claimableEpoch, currentEpoch) {
+    const TIMESTAMP_MANIPULATION_WINDOW = 300;
+    return currentEpoch >= claimableEpoch - TIMESTAMP_MANIPULATION_WINDOW;
+}
+function formatDateKey(year, month, day) {
+    return `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`;
+}
+function isValidClaimableDate(date) {
+    if (date.year < 2000 ||
+        date.year > 2100 ||
+        date.month < 1 ||
+        date.month > 12 ||
+        date.day < 1 ||
+        date.epoch <= 0) {
+        return false;
+    }
+    const daysInMonth = new Date(Date.UTC(date.year, date.month, 0)).getUTCDate();
+    return date.day <= daysInMonth;
+}
+function getDaysInMonth(year, month) {
+    return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+//# sourceMappingURL=date-utils.js.map

package/lib/modules/vaults/utils/date-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.js","sourceRoot":"","sources":["../../../../src.ts/modules/vaults/utils/date-utils.ts"],"names":[],"mappings":";;AAyBA,oDAoBC;AAUD,wCAQC;AAMD,sCAMC;AAMD,oDAeC;AAQD,wCAEC;AAjFD,SAAgB,oBAAoB,CAClC,gBAAwB,EACxB,WAAmB;IAEnB,MAAM,6BAA6B,GAAG,GAAG,CAAC;IAI1C,MAAM,cAAc,GAClB,gBAAgB,GAAG,6BAA6B,GAAG,WAAW,CAAC;IAIjE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAE9B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACrD,CAAC;AAUD,SAAgB,cAAc,CAC5B,cAAsB,EACtB,YAAoB;IAEpB,MAAM,6BAA6B,GAAG,GAAG,CAAC;IAG1C,OAAO,YAAY,IAAI,cAAc,GAAG,6BAA6B,CAAC;AACxE,CAAC;AAMD,SAAgB,aAAa,CAC3B,IAAY,EACZ,KAAa,EACb,GAAW;IAEX,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACrF,CAAC;AAMD,SAAgB,oBAAoB,CAAC,IAAmB;IACtD,IACE,IAAI,CAAC,IAAI,GAAG,IAAI;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI;QAChB,IAAI,CAAC,KAAK,GAAG,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,EAAE;QACf,IAAI,CAAC,GAAG,GAAG,CAAC;QACZ,IAAI,CAAC,KAAK,IAAI,CAAC,EACf,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAGD,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAC9E,OAAO,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC;AACjC,CAAC;AAQD,SAAgB,cAAc,CAAC,IAAY,EAAE,KAAa;IACxD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;AACzD,CAAC"}

package/lib/modules/vaults/utils/dateUtils.d.ts

@@ -0,0 +1,11 @@
+export interface ClaimableDate {
+    year: number;
+    month: number;
+    day: number;
+    epoch: number;
+}
+export declare function computeClaimableDate(requestTimestamp: number, lagDuration: number): ClaimableDate;
+export declare function isClaimableNow(claimableEpoch: number, currentEpoch: number): boolean;
+export declare function formatDateKey(year: number, month: number, day: number): string;
+export declare function isValidClaimableDate(date: ClaimableDate): boolean;
+export declare function getDaysInMonth(year: number, month: number): number;

package/lib/modules/vaults/utils/dateUtils.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeClaimableDate = computeClaimableDate;
+exports.isClaimableNow = isClaimableNow;
+exports.formatDateKey = formatDateKey;
+exports.isValidClaimableDate = isValidClaimableDate;
+exports.getDaysInMonth = getDaysInMonth;
+function computeClaimableDate(requestTimestamp, lagDuration) {
+    const TIMESTAMP_MANIPULATION_WINDOW = 300;
+    const claimableEpoch = requestTimestamp + TIMESTAMP_MANIPULATION_WINDOW + lagDuration;
+    const date = new Date(claimableEpoch * 1000);
+    const year = date.getUTCFullYear();
+    const month = date.getUTCMonth() + 1;
+    const day = date.getUTCDate();
+    return { year, month, day, epoch: claimableEpoch };
+}
+function isClaimableNow(claimableEpoch, currentEpoch) {
+    const TIMESTAMP_MANIPULATION_WINDOW = 300;
+    return currentEpoch >= claimableEpoch - TIMESTAMP_MANIPULATION_WINDOW;
+}
+function formatDateKey(year, month, day) {
+    return `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`;
+}
+function isValidClaimableDate(date) {
+    if (date.year < 2000 ||
+        date.year > 2100 ||
+        date.month < 1 ||
+        date.month > 12 ||
+        date.day < 1 ||
+        date.epoch <= 0) {
+        return false;
+    }
+    const daysInMonth = new Date(date.year, date.month, 0).getUTCDate();
+    return date.day <= daysInMonth;
+}
+function getDaysInMonth(year, month) {
+    return new Date(year, month, 0).getUTCDate();
+}
+//# sourceMappingURL=dateUtils.js.map

package/lib/modules/vaults/utils/dateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.js","sourceRoot":"","sources":["../../../../src.ts/modules/vaults/utils/dateUtils.ts"],"names":[],"mappings":";;AAyBA,oDAmBC;AAUD,wCAQC;AAMD,sCAMC;AAMD,oDAeC;AAQD,wCAEC;AAhFD,SAAgB,oBAAoB,CAClC,gBAAwB,EACxB,WAAmB;IAEnB,MAAM,6BAA6B,GAAG,GAAG,CAAC;IAI1C,MAAM,cAAc,GAAG,gBAAgB,GAAG,6BAA6B,GAAG,WAAW,CAAC;IAItF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAE9B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACrD,CAAC;AAUD,SAAgB,cAAc,CAC5B,cAAsB,EACtB,YAAoB;IAEpB,MAAM,6BAA6B,GAAG,GAAG,CAAC;IAG1C,OAAO,YAAY,IAAI,cAAc,GAAG,6BAA6B,CAAC;AACxE,CAAC;AAMD,SAAgB,aAAa,CAC3B,IAAY,EACZ,KAAa,EACb,GAAW;IAEX,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACrF,CAAC;AAMD,SAAgB,oBAAoB,CAAC,IAAmB;IACtD,IACE,IAAI,CAAC,IAAI,GAAG,IAAI;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI;QAChB,IAAI,CAAC,KAAK,GAAG,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,EAAE;QACf,IAAI,CAAC,GAAG,GAAG,CAAC;QACZ,IAAI,CAAC,KAAK,IAAI,CAAC,EACf,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAGD,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IACpE,OAAO,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC;AACjC,CAAC;AAQD,SAAgB,cAAc,CAAC,IAAY,EAAE,KAAa;IACxD,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;AAC/C,CAAC"}

package/lib/modules/vaults/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './dateUtils';
+export * from './callDataDecoder';

package/lib/modules/vaults/utils/index.js

@@ -0,0 +1,19 @@
+"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("./dateUtils"), exports);
+__exportStar(require("./callDataDecoder"), exports);
+//# sourceMappingURL=index.js.map

package/lib/modules/vaults/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src.ts/modules/vaults/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,oDAAkC"}

package/lib/types/vaults.d.ts

@@ -207,6 +207,7 @@ export type IVaultRedemptionHistoryItem = {
     processed: Date;
     requested: Date;
     vault: IAddress;
+    transactionHash?: string;
 };
 export interface IVaultPosition {
     vault: IAddress;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augustdigital/sdk",
-  "version": "4.24.9",
+  "version": "4.25.0-alpha.0",
   "main": "lib/index.js",
   "keywords": [
     "augustdigital",
@@ -12,6 +12,16 @@
   "author": "August Digital",
   "license": "MIT",
   "description": "JS SDK powering the August Digital ecosystem.",
+  "scripts": {
+    "build": "tsc",
+    "test": "pnpm build && cross-env node dist/test",
+    "test:jest": "jest",
+    "test:jest:watch": "jest --watch",
+    "test:jest:coverage": "jest --coverage",
+    "clean": "rm -rf ./lib",
+    "format": "eslint . --fix",
+    "lint-sdk": "lint-staged"
+  },
   "lint-staged": {
     "*.{ts,tsx,js,jsx,json}": [
       "eslint --fix"
@@ -53,15 +63,5 @@
     "viem": {
       "optional": true
     }
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "pnpm build && cross-env node dist/test",
-    "test:jest": "jest",
-    "test:jest:watch": "jest --watch",
-    "test:jest:coverage": "jest --coverage",
-    "clean": "rm -rf ./lib",
-    "format": "eslint . --fix",
-    "lint-sdk": "lint-staged"
   }
-}
+}