@zemyth/raise-sdk 0.1.1 → 0.1.3

package/src/utils/index.ts

@@ -275,3 +275,93 @@ export function shortenPublicKey(pubkey: PublicKey | string, chars: number = 4):
   if (str.length <= chars * 2 + 3) return str;
   return `${str.slice(0, chars)}...${str.slice(-chars)}`;
 }
+
+// =============================================================================
+// Preserve Pivot Vesting Rights Utilities
+// =============================================================================
+
+/**
+ * Check if an investor can claim vesting for a specific milestone
+ * Investors who refunded have their vesting frozen at a specific milestone index.
+ * They can only claim vesting from milestones at or before that index.
+ *
+ * @param vestingFrozenAtMilestone - The milestone index at which vesting was frozen (null if not frozen)
+ * @param milestoneIndex - The milestone index to check
+ * @returns True if investor can claim vesting for this milestone
+ */
+export function canClaimVestingForMilestone(
+  vestingFrozenAtMilestone: number | null,
+  milestoneIndex: number
+): boolean {
+  // If vesting is not frozen, investor can claim from any milestone
+  if (vestingFrozenAtMilestone === null) {
+    return true;
+  }
+  // If vesting is frozen, investor can only claim from milestones at or before the freeze point
+  return milestoneIndex <= vestingFrozenAtMilestone;
+}
+
+/**
+ * Check if an investment is refunded (any type of refund)
+ *
+ * @param investment - Investment account
+ * @returns True if investment is refunded
+ */
+export function isInvestmentRefunded(investment: {
+  withdrawnFromPivot?: boolean;
+  refundClaimed?: boolean;
+  refundedFromAbandon?: boolean;
+  refundedFromExitWindow?: boolean;
+  refundedFromShutdown?: boolean;
+  vestingFrozenAtMilestone?: number | null;
+}): boolean {
+  return (
+    investment.withdrawnFromPivot ||
+    investment.refundClaimed ||
+    investment.refundedFromAbandon ||
+    investment.refundedFromExitWindow ||
+    investment.refundedFromShutdown ||
+    investment.vestingFrozenAtMilestone !== null
+  );
+}
+
+/**
+ * Check if a project has available investment slots due to refunds
+ * Slots become available when investors refund, allowing succession.
+ *
+ * @param tiers - Array of tier objects with filledLots and maxLots
+ * @param tierCount - Number of active tiers
+ * @returns True if any tier has available slots
+ */
+export function hasAvailableSlots(
+  tiers: Array<{ filledLots: number; maxLots: number }>,
+  tierCount: number
+): boolean {
+  const activeTiers = tiers.slice(0, tierCount);
+  return activeTiers.some((tier) => tier.filledLots < tier.maxLots);
+}
+
+/**
+ * Get available slots count for a specific tier
+ *
+ * @param tier - Tier object with filledLots and maxLots
+ * @returns Number of available slots
+ */
+export function getAvailableSlotsForTier(tier: { filledLots: number; maxLots: number }): number {
+  return Math.max(0, tier.maxLots - tier.filledLots);
+}
+
+/**
+ * Get total available slots across all tiers
+ *
+ * @param tiers - Array of tier objects with filledLots and maxLots
+ * @param tierCount - Number of active tiers
+ * @returns Total number of available slots
+ */
+export function getTotalAvailableSlots(
+  tiers: Array<{ filledLots: number; maxLots: number }>,
+  tierCount: number
+): number {
+  const activeTiers = tiers.slice(0, tierCount);
+  return activeTiers.reduce((total, tier) => total + getAvailableSlotsForTier(tier), 0);
+}