@zemyth/raise-sdk 0.1.6 → 0.2.0

package/src/constants/index.ts

@@ -15,6 +15,7 @@ export const SEEDS = {
   INVESTMENT: 'investment',
   VOTE: 'vote',
   ESCROW: 'escrow',
+  ESCROW_TOKEN: 'escrow_token',
   PIVOT: 'pivot',
   PIVOT_PROPOSAL: 'pivot_proposal',
   TGE_ESCROW: 'tge_escrow',
@@ -58,10 +59,11 @@ export const VALIDATION = {
 // Timing Constants (in seconds)
 // =============================================================================
 
-export const TIMING = {
-  /** Production voting period (14 days) */
+/** Production timing constants (mainnet) */
+export const TIMING_PRODUCTION = {
+  /** Voting period (14 days) */
   VOTING_PERIOD_SECONDS: 1_209_600,
-  /** Production hold period (7 days) */
+  /** Hold period (7 days) */
   HOLD_PERIOD_SECONDS: 604_800,
   /** Inactivity timeout (90 days) */
   INACTIVITY_TIMEOUT_SECONDS: 7_776_000,
@@ -71,14 +73,59 @@ export const TIMING = {
   REFUND_WINDOW_SECONDS: 1_209_600,
   /** Pivot withdrawal window (7 days) */
   PIVOT_WITHDRAWAL_WINDOW_SECONDS: 604_800,
-  /** Minimum TGE date (15 days from now) */
-  TGE_MIN_DAYS: 1_296_000,
-  /** Maximum TGE date (90 days from now) */
-  TGE_MAX_DAYS: 7_776_000,
-  /** Post-TGE holdback period (30 days) */
-  POST_TGE_HOLDBACK_DAYS: 2_592_000,
+  /** Early token cooling period (24 hours) */
+  EARLY_TOKEN_COOLING_PERIOD: 86_400,
+  /** Exit window period (7 days) */
+  EXIT_WINDOW_PERIOD: 604_800,
+  /** Wallet update timelock (7 days) */
+  WALLET_UPDATE_TIMELOCK: 604_800,
+  /** Minimum deadline duration (7 days) */
+  MIN_DEADLINE_DURATION_SECONDS: 604_800,
+  /** Maximum deadline duration (90 days) */
+  MAX_DEADLINE_DURATION_SECONDS: 90 * 24 * 60 * 60,
+  /** Deadline grace period (90 days) */
+  DEADLINE_GRACE_PERIOD_SECONDS: 7_776_000,
 } as const;
 
+/** Dev timing constants (localnet/devnet) - matches Solana program dev mode */
+export const TIMING_DEV = {
+  /** Voting period (60 seconds) */
+  VOTING_PERIOD_SECONDS: 60,
+  /** Hold period (1 second) */
+  HOLD_PERIOD_SECONDS: 1,
+  /** Inactivity timeout (10 seconds) */
+  INACTIVITY_TIMEOUT_SECONDS: 10,
+  /** Abandonment timeout (60 seconds) */
+  ABANDONMENT_TIMEOUT_SECONDS: 60,
+  /** Refund window (2 minutes) */
+  REFUND_WINDOW_SECONDS: 120,
+  /** Pivot withdrawal window (10 seconds) */
+  PIVOT_WITHDRAWAL_WINDOW_SECONDS: 10,
+  /** Early token cooling period (10 seconds) */
+  EARLY_TOKEN_COOLING_PERIOD: 10,
+  /** Exit window period (20 seconds) */
+  EXIT_WINDOW_PERIOD: 20,
+  /** Wallet update timelock (60 seconds) */
+  WALLET_UPDATE_TIMELOCK: 60,
+  /** Minimum deadline duration (60 seconds) */
+  MIN_DEADLINE_DURATION_SECONDS: 60,
+  /** Maximum deadline duration (90 days) */
+  MAX_DEADLINE_DURATION_SECONDS: 90 * 24 * 60 * 60,
+  /** Deadline grace period (5 seconds) */
+  DEADLINE_GRACE_PERIOD_SECONDS: 5,
+} as const;
+
+/**
+ * Get timing constants based on environment
+ * @param isDev - Whether to use dev mode constants (localnet/devnet)
+ */
+export function getTimingConstants(isDev: boolean = false) {
+  return isDev ? TIMING_DEV : TIMING_PRODUCTION;
+}
+
+/** @deprecated Use TIMING_PRODUCTION or TIMING_DEV instead */
+export const TIMING = TIMING_PRODUCTION;
+
 // =============================================================================
 // Tier Configuration Constraints
 // =============================================================================

package/src/index.ts

@@ -22,6 +22,9 @@ export {
   SEEDS,
   VALIDATION,
   TIMING,
+  TIMING_PRODUCTION,
+  TIMING_DEV,
+  getTimingConstants,
   TIER_CONSTRAINTS,
   InvestmentTier,
   TIER_MINIMUMS,
@@ -44,6 +47,7 @@ export {
 export {
   getProjectPDA,
   getEscrowPDA,
+  getEscrowTokenAccountPDA,
   getMilestonePDA,
   getInvestmentPDA,
   getVotePDA,

package/src/instructions/index.ts

@@ -10,6 +10,7 @@ import { PublicKey, Keypair, SYSVAR_INSTRUCTIONS_PUBKEY, SYSVAR_RENT_PUBKEY, SYS
 import {
   getProjectPDA,
   getEscrowPDA,
+  getEscrowTokenAccountPDA,
   getMilestonePDA,
   getInvestmentPDA,
   getVotePDA,
@@ -364,8 +365,9 @@ export async function approveProject(
     /** USDC mint address (for creating lp_usdc_vault) */
     usdcMint: PublicKey;
   },
-  adminKeypair: Keypair
+  admin: PublicKey | Keypair
 ): Promise<string> {
+  const adminPubkey = admin instanceof Keypair ? admin.publicKey : admin;
   const projectPda = getProjectPDA(args.projectId, program.programId);
   const tokenomicsPda = getTokenomicsPDA(projectPda, program.programId);
   const tokenVaultPda = getTokenVaultPDA(projectPda, program.programId);
@@ -378,13 +380,15 @@ export async function approveProject(
   const lpUsdcVaultPda = getLpUsdcVaultPDA(projectPda, program.programId);
   const futureRoundTokenVaultPda = getFutureRoundTokenVaultPDA(projectPda, program.programId);
   const futureRoundVaultPda = getFutureRoundVaultPDA(projectPda, program.programId);
+  const escrowPda = getEscrowPDA(args.projectId, program.programId);
+  const escrowTokenAccountPda = getEscrowTokenAccountPDA(projectPda, program.programId);
 
-  // Request 400k CUs - this instruction creates 10 accounts + 7 CPIs + 5 events
+  // Request 400k CUs - this instruction creates 11 accounts + 7 CPIs + 5 events
   const computeBudgetIx = ComputeBudgetProgram.setComputeUnitLimit({
     units: 400_000,
   });
 
-  return getMethods(program)
+  let builder = getMethods(program)
     .approveProject()
     .accountsPartial({
       project: projectPda,
@@ -400,12 +404,18 @@ export async function approveProject(
       futureRoundTokenVault: futureRoundTokenVaultPda,
       futureRoundVault: futureRoundVaultPda,
       usdcMint: args.usdcMint,
-      authority: adminKeypair.publicKey,
-      payer: adminKeypair.publicKey,
+      escrowPda,
+      escrowTokenAccount: escrowTokenAccountPda,
+      authority: adminPubkey,
+      payer: adminPubkey,
     })
-    .preInstructions([computeBudgetIx])
-    .signers([adminKeypair])
-    .rpc();
+    .preInstructions([computeBudgetIx]);
+
+  if (admin instanceof Keypair) {
+    builder = builder.signers([admin]);
+  }
+
+  return builder.rpc();
 }
 
 // =============================================================================
@@ -579,11 +589,14 @@ export async function claimMilestoneFunds(
   const lpUsdcVaultPda = getLpUsdcVaultPDA(projectPda, program.programId);
 
   // For non-final milestones, derive next milestone PDA if not provided
+  const isFinal = args.nextMilestoneDeadline.eq(new BN(0));
   const nextMilestonePda = args.nextMilestonePda ??
-    (args.nextMilestoneDeadline.gt(new BN(0))
+    (!isFinal
       ? getMilestonePDA(projectPda, args.milestoneIndex + 1, program.programId)
       : null);
 
+  // Pass null for optional next_milestone on final milestone —
+  // Anchor's resolveOptionals converts null → programId sentinel for Option<Account> = None
   return getMethods(program)
     .claimMilestoneFunds({ nextMilestoneDeadline: args.nextMilestoneDeadline })
     .accountsPartial({
@@ -596,7 +609,7 @@ export async function claimMilestoneFunds(
       tokenVault: tokenVaultPda,
       tokenomics: tokenomicsPda,
       lpUsdcVault: lpUsdcVaultPda,
-      nextMilestone: nextMilestonePda,
+      nextMilestone: nextMilestonePda,  // null for final → Anchor uses programId sentinel
       systemProgram: SystemProgram.programId,
       tokenProgram: TOKEN_PROGRAM_ID,
     })

package/src/pdas/index.ts

@@ -57,6 +57,24 @@ export function getEscrowPDA(projectId: BN | number | string, programId: PublicK
   return pda;
 }
 
+/**
+ * Derive Escrow Token Account PDA from project PDA
+ *
+ * This is the USDC token account owned by the escrow PDA,
+ * created during approveProject.
+ *
+ * @param projectPda - Project account PDA
+ * @param programId - Raise program ID
+ * @returns Escrow token account PDA
+ */
+export function getEscrowTokenAccountPDA(projectPda: PublicKey, programId: PublicKey): PublicKey {
+  const [pda] = PublicKey.findProgramAddressSync(
+    [Buffer.from(SEEDS.ESCROW_TOKEN), projectPda.toBuffer()],
+    programId
+  );
+  return pda;
+}
+
 /**
  * Derive Milestone PDA from project PDA and milestone index
  *