@zemyth/raise-sdk 0.1.1 → 0.1.3

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"names":["ProjectState","MilestoneState","VoteChoice","PivotState"],"mappings":";AAaO,IAAK,YAAA,qBAAAA,aAAAA,KAAL;AACL,EAAAA,cAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,cAAA,iBAAA,CAAA,GAAkB,iBAAA;AAClB,EAAAA,cAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,cAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,cAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,cAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AAVF,EAAA,OAAAA,aAAAA;AAAA,CAAA,EAAA,YAAA,IAAA,EAAA;AAaL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AACL,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,gBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,gBAAA,aAAA,CAAA,GAAc,aAAA;AACd,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AAPD,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA;AAUL,IAAK,UAAA,qBAAAC,WAAAA,KAAL;AACL,EAAAA,YAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AAFI,EAAA,OAAAA,WAAAA;AAAA,CAAA,EAAA,UAAA,IAAA,EAAA;AAKL,IAAK,UAAA,qBAAAC,WAAAA,KAAL;AACL,EAAAA,YAAA,0BAAA,CAAA,GAA2B,0BAAA;AAC3B,EAAAA,YAAA,gCAAA,CAAA,GAAiC,gCAAA;AACjC,EAAAA,YAAA,WAAA,CAAA,GAAY,WAAA;AAHF,EAAA,OAAAA,WAAAA;AAAA,CAAA,EAAA,UAAA,IAAA,EAAA","file":"index.js","sourcesContent":["/**\n * Raise Type Definitions\n *\n * Re-exports types from the IDL and provides additional utility types.\n */\n\nimport { PublicKey } from '@solana/web3.js';\nimport { BN } from '@coral-xyz/anchor';\n\n// =============================================================================\n// Project State Enums\n// =============================================================================\n\nexport enum ProjectState {\n  Draft = 'draft',\n  PendingApproval = 'pendingApproval',\n  Open = 'open',\n  Funded = 'funded',\n  InProgress = 'inProgress',\n  Completed = 'completed',\n  Abandoned = 'abandoned',\n  Failed = 'failed',\n  TGEFailed = 'tgeFailed',\n  Cancelled = 'cancelled',\n}\n\nexport enum MilestoneState {\n  Proposed = 'proposed',\n  Approved = 'approved',\n  InProgress = 'inProgress',\n  UnderReview = 'underReview',\n  Passed = 'passed',\n  Failed = 'failed',\n  Unlocked = 'unlocked',\n}\n\nexport enum VoteChoice {\n  Good = 'good',\n  Bad = 'bad',\n}\n\nexport enum PivotState {\n  PendingModeratorApproval = 'pendingModeratorApproval',\n  ApprovedAwaitingInvestorWindow = 'approvedAwaitingInvestorWindow',\n  Finalized = 'finalized',\n}\n\n// =============================================================================\n// Account Types\n// =============================================================================\n\n/**\n * Tier configuration stored on-chain (includes filled_lots)\n */\nexport interface Tier {\n  /** USDC amount per lot */\n  amount: BN;\n  /** Maximum lots available */\n  maxLots: number;\n  /** Currently filled lots */\n  filledLots: number;\n  /** Token allocation per $1 invested */\n  tokenRatio: BN;\n  /** Vote weight multiplier (basis points, 100 = 1.0x) */\n  voteMultiplier: number;\n}\n\n/**\n * Tier configuration input for project initialization\n * Founders pass these when creating a project\n */\nexport interface TierConfig {\n  /** USDC amount per lot (must be >= 10 USDC = 10_000_000 lamports) */\n  amount: BN;\n  /** Maximum lots available (must be >= 1) */\n  maxLots: number;\n  /** Token allocation per $1 invested (must be >= 1) */\n  tokenRatio: BN;\n  /** Vote weight multiplier (basis points, must be >= 100 = 1.0x) */\n  voteMultiplier: number;\n}\n\nexport interface ProjectAccount {\n  founder: PublicKey;\n  projectId: BN;\n  fundingGoal: BN;\n  amountRaised: BN;\n  state: ProjectState;\n  metadataUri: string;\n  escrow: PublicKey;\n  currentMilestone: number;\n  totalMilestones: number;\n  /** Number of active tiers (1-10) */\n  tierCount: number;\n  /** All tier slots (only first tierCount are active) */\n  tiers: Tier[];\n  tokenMint: PublicKey | null;\n  tgeDate: BN | null;\n  tokensDeposited: BN;\n  tokenAllocationBps: number;\n  totalTokenAllocation: BN;\n  consecutiveFailures: number;\n  investorCount: number;\n  bump: number;\n}\n\nexport interface MilestoneAccount {\n  project: PublicKey;\n  milestoneIndex: number;\n  percentage: number;\n  description: string;\n  state: MilestoneState;\n  yesVotes: BN;\n  noVotes: BN;\n  totalWeight: BN;\n  voterCount: number;\n  votingEndsAt: BN | null;\n  bump: number;\n}\n\nexport interface InvestmentAccount {\n  project: PublicKey;\n  investor: PublicKey;\n  nftMint: PublicKey;\n  amount: BN;\n  voteWeight: BN;\n  tokenAllocation: BN;\n  tier: number;\n  investedAt: BN;\n  tokensClaimed: boolean;\n  withdrawnFromPivot: boolean;\n  refundClaimed: boolean;\n  bump: number;\n}\n\nexport interface VoteAccount {\n  milestone: PublicKey;\n  voter: PublicKey;\n  choice: VoteChoice;\n  weight: BN;\n  votedAt: BN;\n  bump: number;\n}\n\nexport interface AdminConfigAccount {\n  admin: PublicKey;\n  pendingAdmin: PublicKey | null;\n  bump: number;\n}\n\nexport interface PivotProposalAccount {\n  project: PublicKey;\n  newMetadataUri: string;\n  newMilestones: Array<{ percentage: number; description: string }>;\n  state: PivotState;\n  proposedAt: BN;\n  approvedAt: BN | null;\n  withdrawalWindowEndsAt: BN | null;\n  withdrawnAmount: BN;\n  withdrawnCount: number;\n  bump: number;\n}\n\nexport interface TgeEscrowAccount {\n  project: PublicKey;\n  holdbackAmount: BN;\n  scamReports: BN;\n  scamWeight: BN;\n  scamConfirmed: boolean;\n  holdbackReleased: boolean;\n  bump: number;\n}\n\n// =============================================================================\n// Instruction Arguments\n// =============================================================================\n\nexport interface InitializeProjectArgs {\n  projectId: BN;\n  fundingGoal: BN;\n  metadataUri: string;\n  /** Founder-configured tiers (1-10 tiers) */\n  tiers: TierConfig[];\n}\n\nexport interface CreateMilestoneArgs {\n  milestoneIndex: number;\n  percentage: number;\n  description: string;\n}\n\nexport interface InvestArgs {\n  amount: BN;\n}\n\nexport interface VoteOnMilestoneArgs {\n  choice: VoteChoice;\n}\n\nexport interface SetTgeDateArgs {\n  tgeDate: BN;\n  tokenMint: PublicKey;\n}\n\nexport interface DepositTokensArgs {\n  amount: BN;\n}\n\nexport interface ProposePivotArgs {\n  newMetadataUri: string;\n  newMilestones: Array<{ percentage: number; description: string }>;\n}\n\n// =============================================================================\n// Event Types\n// =============================================================================\n\nexport interface ProjectCreatedEvent {\n  projectId: BN;\n  founder: PublicKey;\n  fundingGoal: BN;\n  metadataUri: string;\n}\n\nexport interface InvestmentMadeEvent {\n  projectId: BN;\n  investor: PublicKey;\n  amount: BN;\n  nftMint: PublicKey;\n  tier: number;\n  voteWeight: BN;\n}\n\nexport interface MilestoneVoteCastEvent {\n  projectId: BN;\n  milestoneIndex: number;\n  voter: PublicKey;\n  choice: VoteChoice;\n  weight: BN;\n}\n\nexport interface MilestoneVoteFinalizedEvent {\n  projectId: BN;\n  milestoneIndex: number;\n  passed: boolean;\n  yesVotes: BN;\n  noVotes: BN;\n}\n\n// =============================================================================\n// Utility Types\n// =============================================================================\n\nexport interface InvestmentWithKey {\n  publicKey: PublicKey;\n  account: InvestmentAccount;\n}\n\nexport interface MilestoneWithKey {\n  publicKey: PublicKey;\n  account: MilestoneAccount;\n}\n\nexport interface VoteWithKey {\n  publicKey: PublicKey;\n  account: VoteAccount;\n}\n"]}
+{"version":3,"sources":["../../src/types/index.ts"],"names":["ProjectState","MilestoneState","VoteChoice","PivotState","FundingRoundState"],"mappings":";AAaO,IAAK,YAAA,qBAAAA,aAAAA,KAAL;AACL,EAAAA,cAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,cAAA,iBAAA,CAAA,GAAkB,iBAAA;AAClB,EAAAA,cAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,cAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,cAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,cAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,cAAA,WAAA,CAAA,GAAY,WAAA;AAVF,EAAA,OAAAA,aAAAA;AAAA,CAAA,EAAA,YAAA,IAAA,EAAA;AAaL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AACL,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,gBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,gBAAA,aAAA,CAAA,GAAc,aAAA;AACd,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AAPD,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA;AAUL,IAAK,UAAA,qBAAAC,WAAAA,KAAL;AACL,EAAAA,YAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AAFI,EAAA,OAAAA,WAAAA;AAAA,CAAA,EAAA,UAAA,IAAA,EAAA;AAKL,IAAK,UAAA,qBAAAC,WAAAA,KAAL;AACL,EAAAA,YAAA,0BAAA,CAAA,GAA2B,0BAAA;AAC3B,EAAAA,YAAA,gCAAA,CAAA,GAAiC,gCAAA;AACjC,EAAAA,YAAA,WAAA,CAAA,GAAY,WAAA;AAHF,EAAA,OAAAA,WAAAA;AAAA,CAAA,EAAA,UAAA,IAAA,EAAA;AAotBL,IAAK,iBAAA,qBAAAC,kBAAAA,KAAL;AACL,EAAAA,mBAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,mBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,mBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,mBAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,mBAAA,QAAA,CAAA,GAAS,QAAA;AALC,EAAA,OAAAA,kBAAAA;AAAA,CAAA,EAAA,iBAAA,IAAA,EAAA","file":"index.js","sourcesContent":["/**\n * Raise Type Definitions\n *\n * Re-exports types from the IDL and provides additional utility types.\n */\n\nimport { PublicKey } from '@solana/web3.js';\nimport { BN } from '@coral-xyz/anchor';\n\n// =============================================================================\n// Project State Enums\n// =============================================================================\n\nexport enum ProjectState {\n  Draft = 'draft',\n  PendingApproval = 'pendingApproval',\n  Open = 'open',\n  Funded = 'funded',\n  InProgress = 'inProgress',\n  Completed = 'completed',\n  Abandoned = 'abandoned',\n  Failed = 'failed',\n  TGEFailed = 'tgeFailed',\n  Cancelled = 'cancelled',\n}\n\nexport enum MilestoneState {\n  Proposed = 'proposed',\n  Approved = 'approved',\n  InProgress = 'inProgress',\n  UnderReview = 'underReview',\n  Passed = 'passed',\n  Failed = 'failed',\n  Unlocked = 'unlocked',\n}\n\nexport enum VoteChoice {\n  Good = 'good',\n  Bad = 'bad',\n}\n\nexport enum PivotState {\n  PendingModeratorApproval = 'pendingModeratorApproval',\n  ApprovedAwaitingInvestorWindow = 'approvedAwaitingInvestorWindow',\n  Finalized = 'finalized',\n}\n\n// =============================================================================\n// Account Types\n// =============================================================================\n\n/**\n * Tier configuration stored on-chain (includes filled_lots)\n */\nexport interface Tier {\n  /** USDC amount per lot */\n  amount: BN;\n  /** Maximum lots available */\n  maxLots: number;\n  /** Currently filled lots */\n  filledLots: number;\n  /** Token allocation per $1 invested */\n  tokenRatio: BN;\n  /** Vote weight multiplier (basis points, 100 = 1.0x) */\n  voteMultiplier: number;\n}\n\n/**\n * Tier configuration input for project initialization\n * Founders pass these when creating a project\n * Note: voteMultiplier is auto-calculated on-chain using logarithmic formula\n */\nexport interface TierConfig {\n  /** USDC amount per lot (must be >= 10 USDC = 10_000_000 lamports) */\n  amount: BN;\n  /** Maximum lots available (must be >= 1) */\n  maxLots: number;\n  /** Token allocation per $1 invested (must be >= 1) */\n  tokenRatio: BN;\n}\n\nexport interface ProjectAccount {\n  founder: PublicKey;\n  projectId: BN;\n  fundingGoal: BN;\n  amountRaised: BN;\n  state: ProjectState;\n  metadataUri: string;\n  escrow: PublicKey;\n  currentMilestone: number;\n  totalMilestones: number;\n  /** Number of active tiers (1-10) */\n  tierCount: number;\n  /** All tier slots (only first tierCount are active) */\n  tiers: Tier[];\n  tokenMint: PublicKey | null;\n  tgeDate: BN | null;\n  tokensDeposited: BN;\n  tokenAllocationBps: number;\n  totalTokenAllocation: BN;\n  consecutiveFailures: number;\n  investorCount: number;\n  /** Milestone Price Increases: BPS multipliers per milestone (10000 = 1.0x)\n   * NOTE: If priceMultipliers[0] === 0, project uses dynamic mode (ZEMYTH formula)\n   * Otherwise uses static mode (legacy pre-configured multipliers) */\n  priceMultipliers: number[];\n  /** Milestone Price Increases: Number of milestones that have passed */\n  milestonesPassed: number;\n  /** Dynamic Price Multiplier: Current calculated multiplier in BPS (10000 = 1.0x)\n   * Used when priceMultipliers[0] === 0 (dynamic mode) */\n  currentPriceMultiplierBps: number;\n  // === Linear Progressive Pricing Fields (add-linear-progressive-pricing) ===\n  /** Base multiplier at start of current milestone period (BPS) */\n  milestoneBaseMultiplierBps: number;\n  /** Timestamp when current milestone period started (0 = legacy mode) */\n  milestonePeriodStartedAt: BN;\n  /** Expected deadline for current milestone period */\n  expectedMilestoneDeadlineTs: BN;\n  /** Time-based allocation for current period (50% of ZEMYTH increment) */\n  timeAllocationBps: number;\n  /** Milestone-based allocation (50% of ZEMYTH increment) */\n  milestoneAllocationBps: number;\n  bump: number;\n}\n\nexport interface MilestoneAccount {\n  project: PublicKey;\n  milestoneIndex: number;\n  percentage: number;\n  description: string;\n  state: MilestoneState;\n  yesVotes: BN;\n  noVotes: BN;\n  totalWeight: BN;\n  voterCount: number;\n  votingEndsAt: BN | null;\n  bump: number;\n}\n\nexport interface InvestmentAccount {\n  project: PublicKey;\n  investor: PublicKey;\n  nftMint: PublicKey;\n  amount: BN;\n  voteWeight: BN;\n  tokenAllocation: BN;\n  tier: number;\n  investedAt: BN;\n  tokensClaimed: boolean;\n  withdrawnFromPivot: boolean;\n  refundClaimed: boolean;\n  /** Early Token Release: Whether 5% early tokens have been claimed */\n  earlyTokensClaimed: boolean;\n  /** Early Token Release: Amount of early tokens claimed (for burn-for-refund tracking) */\n  earlyTokensAmount: BN;\n  /** Preserve Pivot Vesting Rights: Milestone index at which vesting was frozen (on refund) */\n  vestingFrozenAtMilestone: number | null;\n  bump: number;\n}\n\nexport interface VoteAccount {\n  milestone: PublicKey;\n  voter: PublicKey;\n  choice: VoteChoice;\n  weight: BN;\n  votedAt: BN;\n  bump: number;\n}\n\nexport interface AdminConfigAccount {\n  admin: PublicKey;\n  pendingAdmin: PublicKey | null;\n  /** Zemyth treasury wallet for platform token allocations */\n  zemythTreasury: PublicKey | null;\n  bump: number;\n}\n\nexport interface PivotProposalAccount {\n  project: PublicKey;\n  newMetadataUri: string;\n  newMilestones: Array<{ percentage: number; description: string }>;\n  state: PivotState;\n  proposedAt: BN;\n  approvedAt: BN | null;\n  withdrawalWindowEndsAt: BN | null;\n  withdrawnAmount: BN;\n  withdrawnCount: number;\n  bump: number;\n}\n\nexport interface TgeEscrowAccount {\n  project: PublicKey;\n  holdbackAmount: BN;\n  scamReports: BN;\n  scamWeight: BN;\n  scamConfirmed: boolean;\n  holdbackReleased: boolean;\n  bump: number;\n}\n\n// =============================================================================\n// Instruction Arguments\n// =============================================================================\n\nexport interface InitializeProjectArgs {\n  projectId: BN;\n  fundingGoal: BN;\n  metadataUri: string;\n  /** Founder-configured tiers (1-10 tiers) */\n  tiers: TierConfig[];\n}\n\nexport interface CreateMilestoneArgs {\n  milestoneIndex: number;\n  percentage: number;\n  description: string;\n}\n\nexport interface InvestArgs {\n  amount: BN;\n}\n\nexport interface VoteOnMilestoneArgs {\n  choice: VoteChoice;\n}\n\nexport interface SetTgeDateArgs {\n  tgeDate: BN;\n  tokenMint: PublicKey;\n}\n\nexport interface DepositTokensArgs {\n  amount: BN;\n}\n\nexport interface ProposePivotArgs {\n  newMetadataUri: string;\n  newMilestones: Array<{ percentage: number; description: string }>;\n}\n\n// =============================================================================\n// Event Types\n// =============================================================================\n\nexport interface ProjectCreatedEvent {\n  projectId: BN;\n  founder: PublicKey;\n  fundingGoal: BN;\n  metadataUri: string;\n}\n\nexport interface InvestmentMadeEvent {\n  projectId: BN;\n  investor: PublicKey;\n  amount: BN;\n  nftMint: PublicKey;\n  tier: number;\n  voteWeight: BN;\n  /** Milestone Price Increases: Effective tier price with multiplier applied */\n  effectivePrice: BN;\n  /** Milestone Price Increases: Current price multiplier in BPS (10000 = 1.0x) */\n  multiplierBps: number;\n}\n\nexport interface MilestoneVoteCastEvent {\n  projectId: BN;\n  milestoneIndex: number;\n  voter: PublicKey;\n  choice: VoteChoice;\n  weight: BN;\n}\n\nexport interface MilestoneVoteFinalizedEvent {\n  projectId: BN;\n  milestoneIndex: number;\n  passed: boolean;\n  yesVotes: BN;\n  noVotes: BN;\n}\n\n// =============================================================================\n// Utility Types\n// =============================================================================\n\nexport interface InvestmentWithKey {\n  publicKey: PublicKey;\n  account: InvestmentAccount;\n}\n\nexport interface MilestoneWithKey {\n  publicKey: PublicKey;\n  account: MilestoneAccount;\n}\n\nexport interface VoteWithKey {\n  publicKey: PublicKey;\n  account: VoteAccount;\n}\n\n// =============================================================================\n// Dynamic Tokenomics Types\n// =============================================================================\n\n/**\n * Sub-allocation within a project's founder allocation pool\n * Sub-allocations are founder team tokens (advisors, marketing, etc.)\n */\nexport interface SubAllocation {\n  /** Unique ID within project (0-9, max 10 sub-allocations) */\n  id: number;\n  /** Name of the allocation (UTF-8, e.g., \"advisors\", \"marketing\") */\n  name: string;\n  /** Basis points from founder allocation pool (e.g., 500 = 5% of total supply) */\n  bps: number;\n  /** Token destination wallet */\n  recipient: PublicKey;\n  /** Vesting duration in months (0 = immediate, >0 = linear vesting) */\n  vestingMonths: number;\n  /** Cliff period in months before vesting starts */\n  cliffMonths: number;\n  /** Timestamp when sub-allocation was created */\n  createdAt: BN;\n  /** True if this was added via governance vote (post-Open state) */\n  approvedViaGovernance: boolean;\n}\n\n/**\n * Allocation proposal for governance voting\n */\nexport interface AllocationProposalAccount {\n  /** Parent project */\n  project: PublicKey;\n  /** Proposer (must be founder) */\n  proposer: PublicKey;\n  /** The proposed sub-allocation */\n  subAllocation: SubAllocation;\n  /** Total vote weight in favor */\n  votesFor: BN;\n  /** Total vote weight against */\n  votesAgainst: BN;\n  /** Timestamp when voting ends (7 days from creation) */\n  votingEndsAt: BN;\n  /** Whether the proposal has been executed */\n  executed: boolean;\n  /** Proposal index (for unique PDA derivation) */\n  proposalIndex: number;\n  /** PDA bump seed */\n  bump: number;\n}\n\n/**\n * Vote record for an allocation proposal\n */\nexport interface AllocationVoteAccount {\n  /** The proposal being voted on */\n  proposal: PublicKey;\n  /** The investment NFT used to vote */\n  nftMint: PublicKey;\n  /** Voter's wallet */\n  voter: PublicKey;\n  /** Vote weight */\n  voteWeight: BN;\n  /** True = for, False = against */\n  voteFor: boolean;\n  /** Timestamp of vote */\n  votedAt: BN;\n  /** PDA bump seed */\n  bump: number;\n}\n\n/**\n * Extended Tokenomics account with dynamic allocation fields\n */\nexport interface TokenomicsAccount {\n  /** Parent project */\n  project: PublicKey;\n  /** Token symbol (2-8 chars uppercase) */\n  tokenSymbol: string;\n  /** Token decimals (default: 9) */\n  tokenDecimals: number;\n  /** Total token supply */\n  totalSupply: BN;\n  /** Investor allocation in basis points */\n  investorAllocationBps: number;\n  /** LP token allocation in basis points */\n  lpTokenAllocationBps: number;\n  /** LP USDC allocation in basis points */\n  lpUsdcAllocationBps: number;\n  /** Founder allocation in basis points (includes sub-allocations for team) */\n  founderAllocationBps: number;\n  /** Zemyth platform allocation in basis points (minimum 1%, vests per milestone) */\n  zemythAllocationBps: number;\n  /** Number of active sub-allocations (draw from founder allocation) */\n  subAllocationCount: number;\n  /** Sub-allocations from founder pool (advisors, marketing, etc.) */\n  subAllocations: SubAllocation[];\n  /** Number of allocation proposals created */\n  proposalCount: number;\n  /** Founder wallet for vesting */\n  founderWallet: PublicKey | null;\n  /** Vesting duration in months */\n  vestingDurationMonths: number;\n  /** Cliff period in months */\n  cliffMonths: number;\n  /** Early Token Release: Founder milestone-based vesting BPS (e.g., 4750 = 47.5% of founder allocation) */\n  founderMilestoneVestingBps: number;\n  /** Early Token Release: Founder time-based vesting BPS (e.g., 4750 = 47.5% of founder allocation) */\n  founderTimeVestingBps: number;\n  /** Future round allocation in basis points (0 or >= 1000, reserved for second-round fundraising) */\n  futureRoundAllocationBps: number;\n  /** PDA bump seed */\n  bump: number;\n}\n\n// =============================================================================\n// Dynamic Tokenomics Instruction Arguments\n// =============================================================================\n\nexport interface AddSubAllocationArgs {\n  /** Name of the sub-allocation (e.g., \"advisors\", \"marketing\") */\n  name: string;\n  /** Basis points from founder allocation pool */\n  bps: number;\n  /** Token destination wallet */\n  recipient: PublicKey;\n  /** Vesting duration in months (0 = immediate) */\n  vestingMonths: number;\n  /** Cliff period in months */\n  cliffMonths: number;\n}\n\nexport interface ProposeAllocationChangeArgs {\n  /** Name of the sub-allocation */\n  name: string;\n  /** Basis points from founder allocation pool */\n  bps: number;\n  /** Token destination wallet */\n  recipient: PublicKey;\n  /** Vesting duration in months */\n  vestingMonths: number;\n  /** Cliff period in months */\n  cliffMonths: number;\n}\n\nexport interface VoteAllocationChangeArgs {\n  /** True = vote for, False = vote against */\n  voteFor: boolean;\n}\n\n// =============================================================================\n// Dynamic Tokenomics Events\n// =============================================================================\n\nexport interface SubAllocationAddedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  subAllocationId: number;\n  name: string;\n  bps: number;\n  recipient: PublicKey;\n  vestingMonths: number;\n  cliffMonths: number;\n  timestamp: BN;\n}\n\nexport interface AllocationProposalCreatedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  proposalKey: PublicKey;\n  name: string;\n  bps: number;\n  recipient: PublicKey;\n  votingEndsAt: BN;\n  timestamp: BN;\n}\n\nexport interface AllocationVoteCastEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  proposalKey: PublicKey;\n  voter: PublicKey;\n  nftMint: PublicKey;\n  voteWeight: BN;\n  voteFor: boolean;\n  timestamp: BN;\n}\n\nexport interface AllocationChangeExecutedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  proposalKey: PublicKey;\n  subAllocationId: number;\n  votesFor: BN;\n  votesAgainst: BN;\n  timestamp: BN;\n}\n\n// =============================================================================\n// Dynamic Tokenomics Utility Types\n// =============================================================================\n\nexport interface AllocationProposalWithKey {\n  publicKey: PublicKey;\n  account: AllocationProposalAccount;\n}\n\nexport interface AllocationVoteWithKey {\n  publicKey: PublicKey;\n  account: AllocationVoteAccount;\n}\n\n// =============================================================================\n// Sub-Allocation Vesting Types\n// =============================================================================\n\n/**\n * Sub-allocation vesting account for tracking vesting schedules\n * Similar to FounderVesting but for sub-allocations (treasury, advisors, etc.)\n */\nexport interface SubAllocationVestingAccount {\n  /** Parent project */\n  project: PublicKey;\n  /** Sub-allocation ID (0-9) */\n  subAllocationId: number;\n  /** Recipient wallet (only this wallet can claim) */\n  recipientWallet: PublicKey;\n  /** Total token amount for this sub-allocation */\n  totalAmount: BN;\n  /** Timestamp when vesting starts (MAE completion) */\n  startTimestamp: BN;\n  /** Timestamp when cliff ends */\n  cliffEnd: BN;\n  /** Timestamp when vesting fully ends */\n  vestingEnd: BN;\n  /** Amount already claimed */\n  claimedAmount: BN;\n  /** Pending wallet update (for wallet migration) */\n  pendingWallet: PublicKey | null;\n  /** Timestamp when wallet update was initiated */\n  walletUpdateTimestamp: BN | null;\n  /** PDA bump seed */\n  bump: number;\n}\n\nexport interface SubAllocationVestingWithKey {\n  publicKey: PublicKey;\n  account: SubAllocationVestingAccount;\n}\n\n/**\n * Arguments for claiming sub-allocation tokens\n */\nexport interface ClaimSubAllocationTokensArgs {\n  /** Sub-allocation ID to claim from (0-9) */\n  subAllocationId: number;\n}\n\n// =============================================================================\n// Sub-Allocation Vesting Events\n// =============================================================================\n\nexport interface SubAllocationVestingInitializedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  subAllocationId: number;\n  recipientWallet: PublicKey;\n  totalAmount: BN;\n  cliffMonths: number;\n  vestingMonths: number;\n  startTimestamp: BN;\n  timestamp: BN;\n}\n\nexport interface SubAllocationTokensClaimedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  subAllocationId: number;\n  recipient: PublicKey;\n  amountClaimed: BN;\n  totalClaimed: BN;\n  remaining: BN;\n  vestingProgressPercent: number;\n  timestamp: BN;\n}\n\n// =============================================================================\n// Early Token Release Types\n// =============================================================================\n\n/**\n * Arguments for claim_investor_tokens instruction\n */\nexport interface ClaimInvestorTokensArgs {\n  /** Milestone index to claim tokens from */\n  milestoneIndex: number;\n}\n\n/**\n * Arguments for claim_founder_milestone_tokens instruction\n */\nexport interface ClaimFounderMilestoneTokensArgs {\n  /** Milestone index to claim tokens from */\n  milestoneIndex: number;\n}\n\n// =============================================================================\n// Early Token Release Events\n// =============================================================================\n\nexport interface EarlyTokensClaimedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  investor: PublicKey;\n  nftMint: PublicKey;\n  amount: BN;\n  timestamp: BN;\n}\n\nexport interface FounderEarlyTokensClaimedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  founder: PublicKey;\n  amount: BN;\n  timestamp: BN;\n}\n\nexport interface FounderMilestoneTokensClaimedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  founder: PublicKey;\n  milestoneIndex: number;\n  amount: BN;\n  cumulativeClaimed: BN;\n  timestamp: BN;\n}\n\nexport interface TokensBurnedForRefundEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  investor: PublicKey;\n  nftMint: PublicKey;\n  amountBurned: BN;\n  timestamp: BN;\n}\n\n// =============================================================================\n// Milestone Price Increase Events\n// =============================================================================\n\nexport interface PriceMultiplierActivatedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  milestoneIndex: number;\n  newMultiplierBps: number;\n  timestamp: BN;\n}\n\n// =============================================================================\n// Dynamic Price Multiplier Events (refactor-dynamic-price-multiplier)\n// =============================================================================\n\n/** Emitted when claim_milestone_funds dynamically calculates and updates the price multiplier */\nexport interface PriceMultiplierUpdatedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  /** Index of the milestone just claimed */\n  milestoneIndex: number;\n  /** Number of milestones remaining after this claim */\n  remainingMilestones: number;\n  /** Days until the next milestone deadline */\n  daysToDeadline: BN;\n  /** New price multiplier in BPS (10000 = 1.0x) */\n  newMultiplierBps: number;\n  /** Previous price multiplier in BPS */\n  previousMultiplierBps: number;\n  timestamp: BN;\n}\n\n// =============================================================================\n// Zemyth Platform Allocation Types (refactor-sub-allocation-to-founder)\n// =============================================================================\n\n/**\n * Zemyth vesting account for platform token allocation\n * Created at project approval, tokens vest proportionally per milestone\n */\nexport interface ZemythVestingAccount {\n  /** Parent project */\n  project: PublicKey;\n  /** Total Zemyth token allocation */\n  totalTokens: BN;\n  /** Tokens already claimed by Zemyth treasury */\n  claimedTokens: BN;\n  /** Number of milestones claimed for (0 to milestone_count) */\n  milestonesClaimed: number;\n  /** Destination treasury wallet for claims */\n  treasuryWallet: PublicKey;\n  /** Account creation timestamp */\n  createdAt: BN;\n  /** PDA bump seed */\n  bump: number;\n}\n\nexport interface ZemythVestingWithKey {\n  publicKey: PublicKey;\n  account: ZemythVestingAccount;\n}\n\n// =============================================================================\n// Zemyth Platform Allocation Events (refactor-sub-allocation-to-founder)\n// =============================================================================\n\n/** Emitted when ZemythVesting account is created at project approval */\nexport interface ZemythVestingCreatedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  totalTokens: BN;\n  treasuryWallet: PublicKey;\n  timestamp: BN;\n}\n\n/** Emitted when Zemyth claims tokens for passed milestones */\nexport interface ZemythTokensClaimedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  amountClaimed: BN;\n  totalClaimed: BN;\n  milestonesClaimed: number;\n  treasuryWallet: PublicKey;\n  timestamp: BN;\n}\n\n// =============================================================================\n// Future Round Allocation Types (add-future-round-allocation)\n// =============================================================================\n\n/**\n * FutureRoundVault account for tracking reserved tokens for future fundraising\n * Created at project approval if future_round_allocation_bps > 0\n */\nexport interface FutureRoundVaultAccount {\n  /** Parent project */\n  project: PublicKey;\n  /** Token mint for the project */\n  tokenMint: PublicKey;\n  /** Total tokens reserved for future rounds */\n  totalAmount: BN;\n  /** Tokens already used in subsequent rounds */\n  usedAmount: BN;\n  /** PDA bump seed */\n  bump: number;\n}\n\nexport interface FutureRoundVaultWithKey {\n  publicKey: PublicKey;\n  account: FutureRoundVaultAccount;\n}\n\n// =============================================================================\n// Multi-Round Fundraising Types (add-second-round-fundraising)\n// =============================================================================\n\n/**\n * FundingRound state enum\n */\nexport enum FundingRoundState {\n  Open = 'open',\n  Funded = 'funded',\n  InProgress = 'inProgress',\n  Completed = 'completed',\n  Failed = 'failed',\n}\n\n/**\n * Milestone configuration input for funding rounds\n */\nexport interface RoundMilestoneConfig {\n  /** Percentage of round funds for this milestone */\n  percentage: number;\n  /** Milestone description */\n  description: string;\n  /** Instant release percentage in basis points (e.g., 1000 = 10%) */\n  instantReleaseBps: number;\n  /** Cliff period in months */\n  cliffMonths: number;\n  /** Vesting duration in months */\n  vestingDurationMonths: number;\n}\n\n/**\n * FundingRound account for R2, R3, R4... rounds\n */\nexport interface FundingRoundAccount {\n  /** Parent project */\n  project: PublicKey;\n  /** Round number (2, 3, 4...) */\n  roundNumber: number;\n  /** Funding goal for this round */\n  fundingGoal: BN;\n  /** Amount raised in this round */\n  amountRaised: BN;\n  /** Round state */\n  state: FundingRoundState;\n  /** Number of investors in this round */\n  investorCount: number;\n  /** Allocation from future round pool (basis points) */\n  roundAllocationBps: number;\n  /** Number of tiers */\n  tierCount: number;\n  /** Tier configurations */\n  tiers: Tier[];\n  /** Number of milestones */\n  milestoneCount: number;\n  /** Current milestone index */\n  currentMilestone: number;\n  /** Consecutive milestone failures */\n  consecutiveFailures: number;\n  /** Round creation timestamp */\n  createdAt: BN;\n  /** PDA bump seed */\n  bump: number;\n}\n\nexport interface FundingRoundWithKey {\n  publicKey: PublicKey;\n  account: FundingRoundAccount;\n}\n\n// =============================================================================\n// Multi-Round Fundraising Instruction Arguments\n// =============================================================================\n\n/**\n * Arguments for open_funding_round instruction\n */\nexport interface OpenFundingRoundArgs {\n  /** Allocation from future round pool in basis points */\n  roundAllocationBps: number;\n  /** Funding goal for this round */\n  fundingGoal: BN;\n  /** Tier configurations (token_ratio must be <= R1's best tier) */\n  tiers: TierConfig[];\n  /** Milestone configurations for this round */\n  milestones: RoundMilestoneConfig[];\n}\n\n/**\n * Arguments for invest_in_round instruction\n */\nexport interface InvestInRoundArgs {\n  /** Round number to invest in */\n  roundNumber: number;\n  /** Investment amount in USDC lamports */\n  amount: BN;\n}\n\n/**\n * Arguments for vote_on_round_milestone instruction\n */\nexport interface VoteOnRoundMilestoneArgs {\n  /** Round number */\n  roundNumber: number;\n  /** Milestone index */\n  milestoneIndex: number;\n  /** Vote choice */\n  choice: VoteChoice;\n}\n\n/**\n * Arguments for claim_round_instant_tokens instruction\n */\nexport interface ClaimRoundInstantTokensArgs {\n  /** Milestone index */\n  milestoneIndex: number;\n}\n\n/**\n * Arguments for claim_round_vested_tokens instruction\n */\nexport interface ClaimRoundVestedTokensArgs {\n  /** Milestone index */\n  milestoneIndex: number;\n}\n\n// =============================================================================\n// Multi-Round Fundraising Events\n// =============================================================================\n\nexport interface FundingRoundOpenedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  roundNumber: number;\n  fundingGoal: BN;\n  roundAllocationBps: number;\n  tierCount: number;\n  milestoneCount: number;\n  timestamp: BN;\n}\n\nexport interface RoundInvestmentMadeEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  roundNumber: number;\n  investor: PublicKey;\n  amount: BN;\n  nftMint: PublicKey;\n  tier: number;\n  tokensAllocated: BN;\n  timestamp: BN;\n}\n\nexport interface RoundMilestoneVoteEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  roundNumber: number;\n  milestoneIndex: number;\n  voter: PublicKey;\n  choice: VoteChoice;\n  weight: BN;\n  timestamp: BN;\n}\n\nexport interface RoundMilestoneFinalizedEvent {\n  projectId: BN;\n  projectKey: PublicKey;\n  roundNumber: number;\n  milestoneIndex: number;\n  passed: boolean;\n  yesVotes: BN;\n  noVotes: BN;\n  timestamp: BN;\n}\n\nexport interface RoundEarlyTokensClaimedEvent {\n  projectId: BN;\n  roundNumber: number;\n  investmentKey: PublicKey;\n  nftHolder: PublicKey;\n  amount: BN;\n  timestamp: BN;\n}\n\nexport interface RoundInstantTokensClaimedEvent {\n  projectId: BN;\n  roundNumber: number;\n  milestoneIndex: number;\n  investmentKey: PublicKey;\n  nftHolder: PublicKey;\n  tokensClaimed: BN;\n  timestamp: BN;\n}\n\nexport interface RoundVestedTokensClaimedEvent {\n  projectId: BN;\n  roundNumber: number;\n  milestoneIndex: number;\n  investmentKey: PublicKey;\n  nftHolder: PublicKey;\n  tokensClaimed: BN;\n  cumulativeClaimed: BN;\n  vestingProgressPercent: number;\n  timestamp: BN;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zemyth/raise-sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "TypeScript SDK for the Raise Solana program - decentralized venture funding platform",
   "author": "Raise Team",
   "license": "MIT",
@@ -102,6 +102,7 @@
   },
   "devDependencies": {
     "@coral-xyz/anchor": "^0.32.1",
+    "@solana/spl-token": "^0.4.14",
     "@solana/web3.js": "^1.98.4",
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
@@ -119,11 +120,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/zemyth/raise"
+    "url": "https://github.com/zemyth-app/raise"
   },
   "bugs": {
-    "url": "https://github.com/zemyth/raise/issues"
+    "url": "https://github.com/zemyth-app/raise/issues"
   },
+  "homepage": "https://github.com/zemyth-app/raise#readme",
   "engines": {
     "node": ">=18"
   }

package/src/__tests__/dynamic-tokenomics.test.ts

@@ -0,0 +1,358 @@
+/**
+ * SDK Tests for Dynamic Tokenomics
+ *
+ * Tests per tasks.md Section 8.2:
+ * - 8.2.1: SubAllocation type serialization
+ * - 8.2.2: PDA derivation for proposals and vesting
+ * - 8.2.3: Client methods integration (unit tests)
+ */
+
+import { describe, it, expect } from 'vitest';
+import { PublicKey, Keypair } from '@solana/web3.js';
+import { BN } from '@coral-xyz/anchor';
+import {
+  getAllocationProposalPDA,
+  getAllocationVotePDA,
+  getSubAllocationVestingPDA,
+  getProjectPDA,
+  getTokenomicsPDA,
+} from '../pdas/index.js';
+
+// Mock program ID for testing
+const MOCK_PROGRAM_ID = new PublicKey('Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS');
+
+describe('8.2.1: SubAllocation Type Serialization', () => {
+  it('should correctly represent SubAllocation structure', () => {
+    // SubAllocation fields as defined in types
+    const subAllocation = {
+      id: 0,
+      name: Array(32).fill(0),
+      bps: 500,
+      recipient: Keypair.generate().publicKey,
+      vestingMonths: 12,
+      cliffMonths: 3,
+      createdAt: new BN(Date.now() / 1000),
+      approvedViaGovernance: false,
+    };
+
+    // Verify structure
+    expect(subAllocation.id).toBe(0);
+    expect(subAllocation.name).toHaveLength(32);
+    expect(subAllocation.bps).toBe(500);
+    expect(subAllocation.vestingMonths).toBe(12);
+    expect(subAllocation.cliffMonths).toBe(3);
+    expect(subAllocation.approvedViaGovernance).toBe(false);
+  });
+
+  it('should encode name to 32-byte array correctly', () => {
+    const name = 'Marketing';
+    const nameBytes = new Array(32).fill(0);
+    const nameLen = Math.min(name.length, 32);
+    for (let i = 0; i < nameLen; i++) {
+      nameBytes[i] = name.charCodeAt(i);
+    }
+
+    expect(nameBytes[0]).toBe('M'.charCodeAt(0)); // 77
+    expect(nameBytes[8]).toBe('g'.charCodeAt(0)); // 103
+    expect(nameBytes[9]).toBe(0); // null terminator padding
+  });
+
+  it('should validate bps is within valid range (0-10000)', () => {
+    const validBps = [0, 100, 500, 1000, 5000, 10000];
+    const invalidBps = [-1, 10001, 100000];
+
+    validBps.forEach((bps) => {
+      expect(bps >= 0 && bps <= 10000).toBe(true);
+    });
+
+    invalidBps.forEach((bps) => {
+      expect(bps >= 0 && bps <= 10000).toBe(false);
+    });
+  });
+
+  it('should validate cliff must be less than vesting', () => {
+    // Valid configurations
+    expect(3 < 12).toBe(true); // cliff 3, vesting 12
+    expect(0 < 24).toBe(true); // cliff 0, vesting 24
+
+    // Invalid configuration
+    expect(12 < 6).toBe(false); // cliff 12, vesting 6 - invalid
+
+    // Edge case: vesting_months = 0 means cliff must also be 0
+    expect(0 === 0).toBe(true);
+  });
+});
+
+describe('8.2.2: PDA Derivation for Proposals and Vesting', () => {
+  it('should derive consistent AllocationProposal PDA', () => {
+    const projectPda = Keypair.generate().publicKey;
+    const proposalIndex = 0;
+
+    const pda1 = getAllocationProposalPDA(projectPda, proposalIndex, MOCK_PROGRAM_ID);
+    const pda2 = getAllocationProposalPDA(projectPda, proposalIndex, MOCK_PROGRAM_ID);
+
+    // Same inputs should always produce same PDA
+    expect(pda1.toBase58()).toBe(pda2.toBase58());
+  });
+
+  it('should derive different PDAs for different proposal indices', () => {
+    const projectPda = Keypair.generate().publicKey;
+
+    const pda0 = getAllocationProposalPDA(projectPda, 0, MOCK_PROGRAM_ID);
+    const pda1 = getAllocationProposalPDA(projectPda, 1, MOCK_PROGRAM_ID);
+    const pda2 = getAllocationProposalPDA(projectPda, 2, MOCK_PROGRAM_ID);
+
+    // Different indices should produce different PDAs
+    expect(pda0.toBase58()).not.toBe(pda1.toBase58());
+    expect(pda1.toBase58()).not.toBe(pda2.toBase58());
+    expect(pda0.toBase58()).not.toBe(pda2.toBase58());
+  });
+
+  it('should derive consistent AllocationVote PDA', () => {
+    const proposalPda = Keypair.generate().publicKey;
+    const nftMint = Keypair.generate().publicKey;
+
+    const pda1 = getAllocationVotePDA(proposalPda, nftMint, MOCK_PROGRAM_ID);
+    const pda2 = getAllocationVotePDA(proposalPda, nftMint, MOCK_PROGRAM_ID);
+
+    expect(pda1.toBase58()).toBe(pda2.toBase58());
+  });
+
+  it('should derive different vote PDAs for different NFT mints', () => {
+    const proposalPda = Keypair.generate().publicKey;
+    const nftMint1 = Keypair.generate().publicKey;
+    const nftMint2 = Keypair.generate().publicKey;
+
+    const pda1 = getAllocationVotePDA(proposalPda, nftMint1, MOCK_PROGRAM_ID);
+    const pda2 = getAllocationVotePDA(proposalPda, nftMint2, MOCK_PROGRAM_ID);
+
+    expect(pda1.toBase58()).not.toBe(pda2.toBase58());
+  });
+
+  it('should derive consistent SubAllocationVesting PDA', () => {
+    const projectPda = Keypair.generate().publicKey;
+    const subAllocationId = 0;
+
+    const pda1 = getSubAllocationVestingPDA(projectPda, subAllocationId, MOCK_PROGRAM_ID);
+    const pda2 = getSubAllocationVestingPDA(projectPda, subAllocationId, MOCK_PROGRAM_ID);
+
+    expect(pda1.toBase58()).toBe(pda2.toBase58());
+  });
+
+  it('should derive different vesting PDAs for different sub-allocation IDs', () => {
+    const projectPda = Keypair.generate().publicKey;
+
+    const pda0 = getSubAllocationVestingPDA(projectPda, 0, MOCK_PROGRAM_ID);
+    const pda1 = getSubAllocationVestingPDA(projectPda, 1, MOCK_PROGRAM_ID);
+    const pda5 = getSubAllocationVestingPDA(projectPda, 5, MOCK_PROGRAM_ID);
+
+    expect(pda0.toBase58()).not.toBe(pda1.toBase58());
+    expect(pda1.toBase58()).not.toBe(pda5.toBase58());
+  });
+
+  it('should derive PDAs that are valid PublicKeys', () => {
+    const projectPda = Keypair.generate().publicKey;
+    const proposalPda = Keypair.generate().publicKey;
+    const nftMint = Keypair.generate().publicKey;
+
+    const allocationProposalPda = getAllocationProposalPDA(projectPda, 0, MOCK_PROGRAM_ID);
+    const allocationVotePda = getAllocationVotePDA(proposalPda, nftMint, MOCK_PROGRAM_ID);
+    const subAllocationVestingPda = getSubAllocationVestingPDA(projectPda, 0, MOCK_PROGRAM_ID);
+
+    // All PDAs should be valid PublicKeys (not on the Ed25519 curve)
+    expect(PublicKey.isOnCurve(allocationProposalPda.toBuffer())).toBe(false);
+    expect(PublicKey.isOnCurve(allocationVotePda.toBuffer())).toBe(false);
+    expect(PublicKey.isOnCurve(subAllocationVestingPda.toBuffer())).toBe(false);
+  });
+
+  it('should derive tokenomics PDA correctly', () => {
+    const projectId = new BN(1);
+    const projectPda = getProjectPDA(projectId, MOCK_PROGRAM_ID);
+    const tokenomicsPda = getTokenomicsPDA(projectPda, MOCK_PROGRAM_ID);
+
+    // Should be deterministic
+    const tokenomicsPda2 = getTokenomicsPDA(projectPda, MOCK_PROGRAM_ID);
+    expect(tokenomicsPda.toBase58()).toBe(tokenomicsPda2.toBase58());
+
+    // Should be valid PDA (off curve)
+    expect(PublicKey.isOnCurve(tokenomicsPda.toBuffer())).toBe(false);
+  });
+});
+
+describe('8.2.3: Client Methods Integration', () => {
+  describe('getRemainingFounderPool calculation', () => {
+    it('should calculate remaining founder pool correctly', () => {
+      // Simulate tokenomics state
+      // Sub-allocations (treasury, advisors, marketing) draw from founder's allocation pool
+      const tokenomics = {
+        founderAllocationBps: 2000, // 20%
+        subAllocations: [
+          { bps: 500 }, // 5%
+          { bps: 300 }, // 3%
+        ],
+        subAllocationCount: 2,
+      };
+
+      // Calculate remaining founder pool
+      let allocatedBps = 0;
+      for (let i = 0; i < tokenomics.subAllocationCount; i++) {
+        allocatedBps += tokenomics.subAllocations[i].bps;
+      }
+      const remainingFounderPool = tokenomics.founderAllocationBps - allocatedBps;
+
+      expect(remainingFounderPool).toBe(1200); // 20% - 5% - 3% = 12%
+    });
+
+    it('should return 0 when founder pool is fully allocated', () => {
+      const tokenomics = {
+        founderAllocationBps: 1000, // 10%
+        subAllocations: [
+          { bps: 500 }, // 5%
+          { bps: 500 }, // 5%
+        ],
+        subAllocationCount: 2,
+      };
+
+      let allocatedBps = 0;
+      for (let i = 0; i < tokenomics.subAllocationCount; i++) {
+        allocatedBps += tokenomics.subAllocations[i].bps;
+      }
+      const remainingFounderPool = tokenomics.founderAllocationBps - allocatedBps;
+
+      expect(remainingFounderPool).toBe(0);
+    });
+  });
+
+  describe('proposal status calculation', () => {
+    it('should identify active proposals', () => {
+      const now = Math.floor(Date.now() / 1000);
+      const proposal = {
+        votingEndsAt: new BN(now + 3600), // 1 hour from now
+        executed: false,
+      };
+
+      const isActive = !proposal.executed && proposal.votingEndsAt.toNumber() > now;
+      expect(isActive).toBe(true);
+    });
+
+    it('should identify expired proposals pending execution', () => {
+      const now = Math.floor(Date.now() / 1000);
+      const proposal = {
+        votingEndsAt: new BN(now - 3600), // 1 hour ago
+        executed: false,
+        votesFor: new BN(6000),
+        votesAgainst: new BN(4000),
+      };
+
+      const isExpired = proposal.votingEndsAt.toNumber() <= now;
+      const isPendingExecution = isExpired && !proposal.executed;
+
+      // Check if passed (>51%)
+      const totalVotes = proposal.votesFor.add(proposal.votesAgainst);
+      const hasPassed = totalVotes.gt(new BN(0)) &&
+        proposal.votesFor.mul(new BN(100)).div(totalVotes).gte(new BN(51));
+
+      expect(isPendingExecution).toBe(true);
+      expect(hasPassed).toBe(true);
+    });
+
+    it('should identify executed proposals', () => {
+      const proposal = {
+        executed: true,
+      };
+
+      expect(proposal.executed).toBe(true);
+    });
+  });
+
+  describe('vesting calculation', () => {
+    it('should calculate immediate release correctly (vesting_months=0)', () => {
+      const vestingMonths = 0;
+      const cliffMonths = 0;
+      const totalAmount = new BN(1_000_000);
+
+      // Immediate release = full amount
+      const claimable = vestingMonths === 0 ? totalAmount : new BN(0);
+
+      expect(claimable.eq(totalAmount)).toBe(true);
+    });
+
+    it('should calculate cliff period correctly', () => {
+      const vestingStartTime = 1700000000; // Some past timestamp
+      const cliffMonths = 6;
+      const vestingMonths = 24;
+      const now = vestingStartTime + (4 * 30 * 24 * 60 * 60); // 4 months later
+
+      const cliffEndTime = vestingStartTime + (cliffMonths * 30 * 24 * 60 * 60);
+      const isCliffPassed = now >= cliffEndTime;
+
+      expect(isCliffPassed).toBe(false); // 4 months < 6 months cliff
+    });
+
+    it('should calculate linear vesting correctly', () => {
+      const vestingStartTime = 1700000000;
+      const cliffMonths = 6;
+      const vestingMonths = 24;
+      const totalAmount = new BN(1_000_000);
+
+      // 12 months after vesting start (6 months into linear vesting)
+      const now = vestingStartTime + (12 * 30 * 24 * 60 * 60);
+
+      const cliffEndTime = vestingStartTime + (cliffMonths * 30 * 24 * 60 * 60);
+      const vestingEndTime = vestingStartTime + (vestingMonths * 30 * 24 * 60 * 60);
+      const vestingDuration = vestingEndTime - cliffEndTime;
+
+      // Time since cliff ended
+      const timeSinceCliff = Math.max(0, now - cliffEndTime);
+
+      // Linear unlock percentage (capped at 100%)
+      const unlockPercentage = Math.min(timeSinceCliff / vestingDuration, 1);
+
+      const claimable = totalAmount.muln(Math.floor(unlockPercentage * 10000)).divn(10000);
+
+      // 6 months into 18-month linear vesting = 33.3%
+      expect(unlockPercentage).toBeCloseTo(0.333, 1);
+    });
+  });
+
+  describe('vote weight validation', () => {
+    it('should accumulate vote weights correctly', () => {
+      let votesFor = new BN(0);
+      let votesAgainst = new BN(0);
+
+      // Simulate votes
+      const votes = [
+        { weight: new BN(100), voteFor: true },
+        { weight: new BN(200), voteFor: true },
+        { weight: new BN(150), voteFor: false },
+      ];
+
+      votes.forEach((vote) => {
+        if (vote.voteFor) {
+          votesFor = votesFor.add(vote.weight);
+        } else {
+          votesAgainst = votesAgainst.add(vote.weight);
+        }
+      });
+
+      expect(votesFor.toNumber()).toBe(300);
+      expect(votesAgainst.toNumber()).toBe(150);
+    });
+
+    it('should calculate pass threshold correctly (>51%)', () => {
+      const testCases = [
+        { votesFor: 51, votesAgainst: 49, expected: true },
+        { votesFor: 50, votesAgainst: 50, expected: false },
+        { votesFor: 100, votesAgainst: 0, expected: true },
+        { votesFor: 0, votesAgainst: 100, expected: false },
+        { votesFor: 52, votesAgainst: 48, expected: true },
+      ];
+
+      testCases.forEach(({ votesFor, votesAgainst, expected }) => {
+        const totalVotes = votesFor + votesAgainst;
+        const hasPassed = totalVotes > 0 && (votesFor * 100) / totalVotes > 51;
+        expect(hasPassed).toBe(expected);
+      });
+    });
+  });
+});