@star-factory/sdk-launchpad 0.1.0

package/dist/claims/eligibility.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIER_VESTING_WEEKS = exports.TIER_VESTING_SECONDS = exports.MAX_TIER = exports.NUM_TIERS = void 0;
+exports.computeUserTokens = computeUserTokens;
+exports.computeVestedAmount = computeVestedAmount;
+exports.computeAllocatedAmount = computeAllocatedAmount;
+exports.computeClaimEligibility = computeClaimEligibility;
+const tslib_1 = require("tslib");
+const bn_js_1 = tslib_1.__importDefault(require("bn.js"));
+// ============================================================================
+// Vesting Constants (mirrors programs/launchpad/src/constants.rs)
+// ============================================================================
+/** Number of vesting tiers (0–6 inclusive). */
+exports.NUM_TIERS = 7;
+/** Maximum valid tier index. */
+exports.MAX_TIER = 6;
+/**
+ * Tier vesting durations in seconds.
+ *
+ * - Tier 0: immediate at activation
+ * - Tier 1: 2 weeks  =  1,209,600s
+ * - Tier 2: 4 weeks  =  2,419,200s
+ * - Tier 3: 6 weeks  =  3,628,800s
+ * - Tier 4: 8 weeks  =  4,838,400s
+ * - Tier 5: 10 weeks =  6,048,000s
+ * - Tier 6: 12 weeks =  7,257,600s
+ */
+exports.TIER_VESTING_SECONDS = [
+    0,
+    2 * 7 * 24 * 60 * 60,
+    4 * 7 * 24 * 60 * 60,
+    6 * 7 * 24 * 60 * 60,
+    8 * 7 * 24 * 60 * 60,
+    10 * 7 * 24 * 60 * 60,
+    12 * 7 * 24 * 60 * 60,
+];
+/** Tier vesting durations in weeks (for display). */
+exports.TIER_VESTING_WEEKS = [0, 2, 4, 6, 8, 10, 12];
+// ============================================================================
+// Pure Math (mirrors programs/launchpad/src/math/mod.rs)
+// ============================================================================
+/**
+ * Compute the user's total token entitlement from their vault allocation.
+ *
+ * Formula: `tokens_to_participants × user_allocated / total_allocated`
+ *
+ * Uses BN for precision. Returns `null` if `total_allocated == 0`.
+ */
+function computeUserTokens(tokensToParticipants, userAllocated, totalAllocated) {
+    if (totalAllocated.isZero()) {
+        return null;
+    }
+    return tokensToParticipants.mul(userAllocated).div(totalAllocated);
+}
+/**
+ * Compute the total vested amount at a given time.
+ *
+ * - Tier 0: 100% immediately at pool activation time
+ * - Tier 1–6: Linear vesting from pool_activation_time over tier duration
+ *
+ * Returns the total vested (caller subtracts `already_claimed`).
+ */
+function computeVestedAmount(totalTokens, tier, poolActivationTime, currentTime) {
+    // Tier 0: immediate full unlock
+    if (tier === 0) {
+        return new bn_js_1.default(totalTokens.toString());
+    }
+    if (tier < 0 || tier >= exports.NUM_TIERS) {
+        return new bn_js_1.default(0);
+    }
+    const vestingDuration = exports.TIER_VESTING_SECONDS[tier];
+    const elapsed = currentTime - poolActivationTime;
+    if (elapsed <= 0) {
+        return new bn_js_1.default(0);
+    }
+    // Fully vested
+    if (elapsed >= vestingDuration) {
+        return new bn_js_1.default(totalTokens.toString());
+    }
+    // Linear vesting: total_tokens * elapsed / duration
+    return totalTokens.muln(elapsed).divn(vestingDuration);
+}
+/**
+ * Compute the user's allocated amount from their depositor record and vault data.
+ *
+ * Mirrors `DepositorRecord::allocated_amount(&self, vault)` on-chain:
+ *   - If allocations not yet calculated → return raw `amount`
+ *   - If tier_totals_at_allocation[tier] == 0 → return 0
+ *   - Otherwise → `amount × tier_allocated[tier] / tier_totals_at_allocation[tier]`
+ *
+ * IMPORTANT: This uses vault tier-level allocation data for accuracy.
+ * The `finalAmount` field on `DepositorRecord` only reflects the correct
+ * allocation AFTER the user claims their excess refund. Before that,
+ * `finalAmount == amount` (the full deposit), which over-estimates
+ * allocation in oversubscribed tiers.
+ */
+function computeAllocatedAmount(depositor, vaultData) {
+    if (!vaultData.allocationsCalculated) {
+        return depositor.amount;
+    }
+    const tierIdx = depositor.tier;
+    if (tierIdx < 0 || tierIdx >= exports.NUM_TIERS) {
+        return new bn_js_1.default(0);
+    }
+    const tierTotal = vaultData.tierTotalsAtAllocation[tierIdx];
+    const tierAllocated = vaultData.tierAllocated[tierIdx];
+    if (!tierTotal || tierTotal.isZero()) {
+        return new bn_js_1.default(0);
+    }
+    // user_allocated = amount × tier_allocated / tier_total
+    return depositor.amount.mul(tierAllocated).div(tierTotal);
+}
+// ============================================================================
+// Eligibility Check
+// ============================================================================
+/**
+ * Compute full claim eligibility for a user.
+ *
+ * This is a **pure function** — no RPC calls. It takes pre-fetched account
+ * data and returns a comprehensive eligibility result. Works identically
+ * on client and server.
+ *
+ * @param launchConfigData  - Decoded LaunchConfig account
+ * @param depositorRecord   - Decoded DepositorRecord (from vault program), or `null` if not found
+ * @param claimRecord       - Decoded ClaimRecord, or `null` if user hasn't claimed yet
+ * @param currentTime       - Current unix timestamp in seconds (from `Date.now() / 1000` or RPC clock)
+ * @param vaultData         - Vault allocation data (tier arrays + total_allocated + flag)
+ */
+function computeClaimEligibility(launchConfigData, depositorRecord, claimRecord, currentTime, vaultData) {
+    // --- State gate ---
+    const stateKey = Object.keys(launchConfigData.state)[0];
+    if (stateKey !== 'launched') {
+        return {
+            canClaim: false,
+            reason: 'launch_not_executed',
+            claimableNow: new bn_js_1.default(0),
+            totalTokens: new bn_js_1.default(0),
+            totalClaimed: new bn_js_1.default(0),
+            totalVested: new bn_js_1.default(0),
+            tier: null,
+            vestingSchedule: null,
+        };
+    }
+    // --- Allocations gate ---
+    if (!vaultData.allocationsCalculated) {
+        return {
+            canClaim: false,
+            reason: 'allocations_not_calculated',
+            claimableNow: new bn_js_1.default(0),
+            totalTokens: new bn_js_1.default(0),
+            totalClaimed: new bn_js_1.default(0),
+            totalVested: new bn_js_1.default(0),
+            tier: null,
+            vestingSchedule: null,
+        };
+    }
+    // --- Pool activation time gate ---
+    const poolActivationTime = launchConfigData.poolActivationTime;
+    if (poolActivationTime === null || poolActivationTime === undefined) {
+        return {
+            canClaim: false,
+            reason: 'pool_activation_time_not_set',
+            claimableNow: new bn_js_1.default(0),
+            totalTokens: new bn_js_1.default(0),
+            totalClaimed: new bn_js_1.default(0),
+            totalVested: new bn_js_1.default(0),
+            tier: null,
+            vestingSchedule: null,
+        };
+    }
+    const activationTimestamp = typeof poolActivationTime === 'number'
+        ? poolActivationTime
+        : poolActivationTime.toNumber();
+    // --- Depositor record gate ---
+    if (!depositorRecord) {
+        return {
+            canClaim: false,
+            reason: 'no_depositor_record',
+            claimableNow: new bn_js_1.default(0),
+            totalTokens: new bn_js_1.default(0),
+            totalClaimed: new bn_js_1.default(0),
+            totalVested: new bn_js_1.default(0),
+            tier: null,
+            vestingSchedule: null,
+        };
+    }
+    // Use vault tier data for accurate allocation (mirrors on-chain allocated_amount())
+    const userAllocated = computeAllocatedAmount(depositorRecord, vaultData);
+    if (userAllocated.isZero()) {
+        return {
+            canClaim: false,
+            reason: 'no_allocation',
+            claimableNow: new bn_js_1.default(0),
+            totalTokens: new bn_js_1.default(0),
+            totalClaimed: new bn_js_1.default(0),
+            totalVested: new bn_js_1.default(0),
+            tier: depositorRecord.tier,
+            vestingSchedule: null,
+        };
+    }
+    // --- Timing gate ---
+    if (currentTime < activationTimestamp) {
+        // Pre-compute what they'll get so the UI can show it
+        const totalTokens = claimRecord?.totalTokens && !claimRecord.totalTokens.isZero()
+            ? claimRecord.totalTokens
+            : computeUserTokens(launchConfigData.tokensToParticipants, userAllocated, vaultData.totalAllocated) ?? new bn_js_1.default(0);
+        const tier = depositorRecord.tier;
+        const vestingDurationSecs = exports.TIER_VESTING_SECONDS[tier] ?? 0;
+        return {
+            canClaim: false,
+            reason: 'claims_not_yet_active',
+            claimableNow: new bn_js_1.default(0),
+            totalTokens,
+            totalClaimed: claimRecord?.totalClaimed ?? new bn_js_1.default(0),
+            totalVested: new bn_js_1.default(0),
+            tier,
+            vestingSchedule: {
+                tier,
+                vestingDurationSeconds: vestingDurationSecs,
+                vestingStartTimestamp: activationTimestamp,
+                vestingEndTimestamp: activationTimestamp + vestingDurationSecs,
+                percentVested: 0,
+                fullyVested: tier === 0,
+            },
+        };
+    }
+    // --- Compute entitlements ---
+    const tier = depositorRecord.tier;
+    const vestingDurationSecs = exports.TIER_VESTING_SECONDS[tier] ?? 0;
+    // Use cached total_tokens if claim record exists, otherwise compute
+    const totalTokens = claimRecord?.totalTokens && !claimRecord.totalTokens.isZero()
+        ? claimRecord.totalTokens
+        : computeUserTokens(launchConfigData.tokensToParticipants, userAllocated, vaultData.totalAllocated) ?? new bn_js_1.default(0);
+    if (totalTokens.isZero()) {
+        return {
+            canClaim: false,
+            reason: 'no_allocation',
+            claimableNow: new bn_js_1.default(0),
+            totalTokens: new bn_js_1.default(0),
+            totalClaimed: claimRecord?.totalClaimed ?? new bn_js_1.default(0),
+            totalVested: new bn_js_1.default(0),
+            tier,
+            vestingSchedule: null,
+        };
+    }
+    const totalClaimed = claimRecord?.totalClaimed ?? new bn_js_1.default(0);
+    const totalVested = computeVestedAmount(totalTokens, tier, activationTimestamp, currentTime);
+    const claimableNow = bn_js_1.default.max(totalVested.sub(totalClaimed), new bn_js_1.default(0));
+    const vestingEndTimestamp = activationTimestamp + vestingDurationSecs;
+    const fullyVested = tier === 0 || currentTime >= vestingEndTimestamp;
+    const percentVested = fullyVested
+        ? 100
+        : vestingDurationSecs > 0
+            ? Math.min(100, Math.floor(((currentTime - activationTimestamp) / vestingDurationSecs) * 100))
+            : 100;
+    const vestingSchedule = {
+        tier,
+        vestingDurationSeconds: vestingDurationSecs,
+        vestingStartTimestamp: activationTimestamp,
+        vestingEndTimestamp,
+        percentVested,
+        fullyVested,
+    };
+    return {
+        canClaim: claimableNow.gtn(0),
+        reason: claimableNow.gtn(0) ? null : (fullyVested ? 'fully_claimed' : 'nothing_new_vested'),
+        claimableNow,
+        totalTokens,
+        totalClaimed,
+        totalVested,
+        tier,
+        vestingSchedule,
+    };
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/claims/eligibility.js.map

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

package/dist/claims/index.d.ts

@@ -0,0 +1,5 @@
+export { deriveClaimRecordPda, deriveLaunchConfigPda, deriveLaunchpadSignerPda } from './pdas';
+export { deriveDepositorRecordPda, fetchClaimRecord, fetchDepositorRecord, fetchLaunchConfig, resolveClaimAccounts } from './accounts';
+export { computeAllocatedAmount, computeClaimEligibility, computeUserTokens, computeVestedAmount, MAX_TIER, NUM_TIERS, TIER_VESTING_SECONDS, TIER_VESTING_WEEKS } from './eligibility';
+export { buildBatchClaimTransactions, buildClaimTransaction } from './tx';
+//# sourceMappingURL=index.d.ts.map

package/dist/claims/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/claims/index.ts"],"names":[],"mappings":"AAaA,OAAO,EACH,oBAAoB,EAAE,qBAAqB,EAC3C,wBAAwB,EAC3B,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACH,wBAAwB,EAAE,gBAAgB,EAC1C,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EAChE,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,sBAAsB,EAAE,uBAAuB,EAAE,iBAAiB,EAClE,mBAAmB,EAAE,QAAQ,EAAE,SAAS,EAAE,oBAAoB,EAC9D,kBAAkB,EACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACH,2BAA2B,EAAE,qBAAqB,EACrD,MAAM,MAAM,CAAC"}

package/dist/claims/index.js

@@ -0,0 +1,41 @@
+"use strict";
+// ============================================================================
+// Claims Module
+//
+// Client-facing token claim functionality for the Star Launchpad.
+//
+// Architecture:
+//   pdas.ts        — Deterministic PDA derivation (pure, no RPC)
+//   accounts.ts    — Account fetching + resolution
+//   eligibility.ts — Claim eligibility computation (pure, no RPC)
+//   tx.ts          — Transaction builder (returns unsigned TX)
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildClaimTransaction = exports.buildBatchClaimTransactions = exports.TIER_VESTING_WEEKS = exports.TIER_VESTING_SECONDS = exports.NUM_TIERS = exports.MAX_TIER = exports.computeVestedAmount = exports.computeUserTokens = exports.computeClaimEligibility = exports.computeAllocatedAmount = exports.resolveClaimAccounts = exports.fetchLaunchConfig = exports.fetchDepositorRecord = exports.fetchClaimRecord = exports.deriveDepositorRecordPda = exports.deriveLaunchpadSignerPda = exports.deriveLaunchConfigPda = exports.deriveClaimRecordPda = void 0;
+// PDAs
+var pdas_1 = require("./pdas");
+Object.defineProperty(exports, "deriveClaimRecordPda", { enumerable: true, get: function () { return pdas_1.deriveClaimRecordPda; } });
+Object.defineProperty(exports, "deriveLaunchConfigPda", { enumerable: true, get: function () { return pdas_1.deriveLaunchConfigPda; } });
+Object.defineProperty(exports, "deriveLaunchpadSignerPda", { enumerable: true, get: function () { return pdas_1.deriveLaunchpadSignerPda; } });
+// Account helpers
+var accounts_1 = require("./accounts");
+Object.defineProperty(exports, "deriveDepositorRecordPda", { enumerable: true, get: function () { return accounts_1.deriveDepositorRecordPda; } });
+Object.defineProperty(exports, "fetchClaimRecord", { enumerable: true, get: function () { return accounts_1.fetchClaimRecord; } });
+Object.defineProperty(exports, "fetchDepositorRecord", { enumerable: true, get: function () { return accounts_1.fetchDepositorRecord; } });
+Object.defineProperty(exports, "fetchLaunchConfig", { enumerable: true, get: function () { return accounts_1.fetchLaunchConfig; } });
+Object.defineProperty(exports, "resolveClaimAccounts", { enumerable: true, get: function () { return accounts_1.resolveClaimAccounts; } });
+// Eligibility (pure computation)
+var eligibility_1 = require("./eligibility");
+Object.defineProperty(exports, "computeAllocatedAmount", { enumerable: true, get: function () { return eligibility_1.computeAllocatedAmount; } });
+Object.defineProperty(exports, "computeClaimEligibility", { enumerable: true, get: function () { return eligibility_1.computeClaimEligibility; } });
+Object.defineProperty(exports, "computeUserTokens", { enumerable: true, get: function () { return eligibility_1.computeUserTokens; } });
+Object.defineProperty(exports, "computeVestedAmount", { enumerable: true, get: function () { return eligibility_1.computeVestedAmount; } });
+Object.defineProperty(exports, "MAX_TIER", { enumerable: true, get: function () { return eligibility_1.MAX_TIER; } });
+Object.defineProperty(exports, "NUM_TIERS", { enumerable: true, get: function () { return eligibility_1.NUM_TIERS; } });
+Object.defineProperty(exports, "TIER_VESTING_SECONDS", { enumerable: true, get: function () { return eligibility_1.TIER_VESTING_SECONDS; } });
+Object.defineProperty(exports, "TIER_VESTING_WEEKS", { enumerable: true, get: function () { return eligibility_1.TIER_VESTING_WEEKS; } });
+// Transaction builders
+var tx_1 = require("./tx");
+Object.defineProperty(exports, "buildBatchClaimTransactions", { enumerable: true, get: function () { return tx_1.buildBatchClaimTransactions; } });
+Object.defineProperty(exports, "buildClaimTransaction", { enumerable: true, get: function () { return tx_1.buildClaimTransaction; } });
+//# sourceMappingURL=index.js.map

package/dist/claims/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/claims/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,gBAAgB;AAChB,EAAE;AACF,kEAAkE;AAClE,EAAE;AACF,gBAAgB;AAChB,iEAAiE;AACjE,mDAAmD;AACnD,kEAAkE;AAClE,+DAA+D;AAC/D,+EAA+E;;;AAE/E,OAAO;AACP,+BAGgB;AAFZ,4GAAA,oBAAoB,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAC3C,gHAAA,wBAAwB,OAAA;AAG5B,kBAAkB;AAClB,uCAGoB;AAFhB,oHAAA,wBAAwB,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAC1C,gHAAA,oBAAoB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAGjE,iCAAiC;AACjC,6CAIuB;AAHnB,qHAAA,sBAAsB,OAAA;AAAE,sHAAA,uBAAuB,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAClE,kHAAA,mBAAmB,OAAA;AAAE,uGAAA,QAAQ,OAAA;AAAE,wGAAA,SAAS,OAAA;AAAE,mHAAA,oBAAoB,OAAA;AAC9D,iHAAA,kBAAkB,OAAA;AAGtB,uBAAuB;AACvB,2BAEc;AADV,iHAAA,2BAA2B,OAAA;AAAE,2GAAA,qBAAqB,OAAA"}

package/dist/claims/pdas.d.ts

@@ -0,0 +1,24 @@
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Derive the launch config PDA.
+ *
+ * Seeds: `["launch", creator, seed_le_bytes]`
+ */
+export declare function deriveLaunchConfigPda(creator: PublicKey, seed: bigint | number, programId: PublicKey): [PublicKey, number];
+/**
+ * Derive the launchpad signer PDA.
+ *
+ * Seeds: `["signer", launch_config]`
+ *
+ * This PDA has authority over the token vault and signs transfers to users.
+ */
+export declare function deriveLaunchpadSignerPda(launchConfig: PublicKey, programId: PublicKey): [PublicKey, number];
+/**
+ * Derive the per-user claim record PDA.
+ *
+ * Seeds: `["claim", launch_config, user]`
+ *
+ * Created on first claim (init_if_needed). Tracks vesting progress.
+ */
+export declare function deriveClaimRecordPda(launchConfig: PublicKey, user: PublicKey, programId: PublicKey): [PublicKey, number];
+//# sourceMappingURL=pdas.d.ts.map

package/dist/claims/pdas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdas.d.ts","sourceRoot":"","sources":["../../src/claims/pdas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,SAAS,GACnB,CAAC,SAAS,EAAE,MAAM,CAAC,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,SAAS,EACvB,SAAS,EAAE,SAAS,GACnB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,SAAS,EACvB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,SAAS,GACnB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB"}

package/dist/claims/pdas.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveLaunchConfigPda = deriveLaunchConfigPda;
+exports.deriveLaunchpadSignerPda = deriveLaunchpadSignerPda;
+exports.deriveClaimRecordPda = deriveClaimRecordPda;
+const web3_js_1 = require("@solana/web3.js");
+// ============================================================================
+// Launchpad PDA Seeds (must match programs/launchpad/src/constants.rs)
+// ============================================================================
+const LAUNCH_SEED = Buffer.from('launch');
+const SIGNER_SEED = Buffer.from('signer');
+const CLAIM_SEED = Buffer.from('claim');
+/**
+ * Derive the launch config PDA.
+ *
+ * Seeds: `["launch", creator, seed_le_bytes]`
+ */
+function deriveLaunchConfigPda(creator, seed, programId) {
+    const seedBuf = Buffer.alloc(8);
+    seedBuf.writeBigUInt64LE(BigInt(seed));
+    return web3_js_1.PublicKey.findProgramAddressSync([LAUNCH_SEED, creator.toBuffer(), seedBuf], programId);
+}
+/**
+ * Derive the launchpad signer PDA.
+ *
+ * Seeds: `["signer", launch_config]`
+ *
+ * This PDA has authority over the token vault and signs transfers to users.
+ */
+function deriveLaunchpadSignerPda(launchConfig, programId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([SIGNER_SEED, launchConfig.toBuffer()], programId);
+}
+/**
+ * Derive the per-user claim record PDA.
+ *
+ * Seeds: `["claim", launch_config, user]`
+ *
+ * Created on first claim (init_if_needed). Tracks vesting progress.
+ */
+function deriveClaimRecordPda(launchConfig, user, programId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([CLAIM_SEED, launchConfig.toBuffer(), user.toBuffer()], programId);
+}
+//# sourceMappingURL=pdas.js.map

package/dist/claims/pdas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdas.js","sourceRoot":"","sources":["../../src/claims/pdas.ts"],"names":[],"mappings":";;AAeA,sDAYC;AASD,4DAQC;AASD,oDASC;AA9DD,6CAA4C;AAE5C,+EAA+E;AAC/E,uEAAuE;AACvE,+EAA+E;AAE/E,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAExC;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,OAAkB,EAClB,IAAqB,EACrB,SAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAEvC,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,EAC1C,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,YAAuB,EACvB,SAAoB;IAEpB,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,WAAW,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,EACtC,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,YAAuB,EACvB,IAAe,EACf,SAAoB;IAEpB,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,UAAU,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EACtD,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/claims/tx.d.ts

@@ -0,0 +1,47 @@
+import type { Idl, Program } from '@coral-xyz/anchor';
+import { Connection, PublicKey, Transaction } from '@solana/web3.js';
+import type { ClaimTransactionOptions, LaunchConfigAccount } from '../types';
+/**
+ * Build an unsigned `claim_tokens` transaction.
+ *
+ * Returns a `Transaction` with the correct fee payer and recent blockhash.
+ * The caller is responsible for signing (wallet adapter, keypair, or relay).
+ *
+ * **Client-side usage:**
+ * ```ts
+ * const tx = await buildClaimTransaction(connection, program, { ... });
+ * const sig = await wallet.sendTransaction(tx, connection);
+ * ```
+ *
+ * **Server-side / relay usage:**
+ * ```ts
+ * const tx = await buildClaimTransaction(connection, program, {
+ *   ...params,
+ *   feePayer: relayPubkey,   // sponsor pays fees
+ * });
+ * // Serialize → send to user for signing → relay adds sponsor sig → submit
+ * ```
+ *
+ * @param connection       - Solana RPC connection (for blockhash)
+ * @param launchpadProgram - Anchor program instance for the launchpad
+ * @param opts             - Claim transaction options
+ */
+export declare function buildClaimTransaction(connection: Connection, launchpadProgram: Program<Idl>, opts: ClaimTransactionOptions): Promise<Transaction>;
+/**
+ * Build claim transactions for multiple users in batch.
+ *
+ * Useful for server-side batch processing (e.g. airdrop-style claim on behalf)
+ * or building multiple TXs for a UI that processes them sequentially.
+ *
+ * Each transaction is independent and can be signed/submitted individually.
+ */
+export declare function buildBatchClaimTransactions(connection: Connection, launchpadProgram: Program<Idl>, opts: {
+    users: PublicKey[];
+    launchConfig: PublicKey;
+    launchConfigData: LaunchConfigAccount;
+    vaultProgramId: PublicKey;
+    tokenProgramId?: PublicKey;
+    computeUnits?: number;
+    priorityFee?: number;
+}): Promise<Map<string, Transaction>>;
+//# sourceMappingURL=tx.d.ts.map

package/dist/claims/tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../src/claims/tx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAEL,UAAU,EACV,SAAS,EAET,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAOzB,OAAO,KAAK,EAEV,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAYlB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,EAC9B,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAqEtB;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,EAC9B,IAAI,EAAE;IACJ,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,YAAY,EAAE,SAAS,CAAC;IACxB,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,cAAc,EAAE,SAAS,CAAC;IAC1B,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAyDnC"}

package/dist/claims/tx.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildClaimTransaction = buildClaimTransaction;
+exports.buildBatchClaimTransactions = buildBatchClaimTransactions;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const accounts_1 = require("./accounts");
+// ============================================================================
+// Transaction Builder
+// ============================================================================
+/**
+ * Build an unsigned `claim_tokens` transaction.
+ *
+ * Returns a `Transaction` with the correct fee payer and recent blockhash.
+ * The caller is responsible for signing (wallet adapter, keypair, or relay).
+ *
+ * **Client-side usage:**
+ * ```ts
+ * const tx = await buildClaimTransaction(connection, program, { ... });
+ * const sig = await wallet.sendTransaction(tx, connection);
+ * ```
+ *
+ * **Server-side / relay usage:**
+ * ```ts
+ * const tx = await buildClaimTransaction(connection, program, {
+ *   ...params,
+ *   feePayer: relayPubkey,   // sponsor pays fees
+ * });
+ * // Serialize → send to user for signing → relay adds sponsor sig → submit
+ * ```
+ *
+ * @param connection       - Solana RPC connection (for blockhash)
+ * @param launchpadProgram - Anchor program instance for the launchpad
+ * @param opts             - Claim transaction options
+ */
+async function buildClaimTransaction(connection, launchpadProgram, opts) {
+    const { user, launchConfig, launchConfigData, vaultProgramId, feePayer, tokenProgramId, computeUnits, priorityFee, } = opts;
+    const launchpadProgramId = launchpadProgram.programId;
+    // Resolve all accounts deterministically
+    const accounts = (0, accounts_1.resolveClaimAccounts)(launchConfig, launchConfigData, user, vaultProgramId, launchpadProgramId);
+    const tokenProgram = tokenProgramId ?? spl_token_1.TOKEN_PROGRAM_ID;
+    // Build the claim_tokens instruction via Anchor
+    const methods = launchpadProgram.methods;
+    const claimIx = await methods
+        .claimTokens()
+        .accountsPartial({
+        user: accounts.user,
+        launchConfig: accounts.launchConfig,
+        fundraiseState: accounts.fundraiseState,
+        userRecord: accounts.userRecord,
+        claimRecord: accounts.claimRecord,
+        baseMint: accounts.baseMint,
+        tokenVault: accounts.tokenVault,
+        userTokenAta: accounts.userTokenAta,
+        launchpadSigner: accounts.launchpadSigner,
+        tokenProgram,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    // Assemble transaction with optional compute budget
+    const tx = new web3_js_1.Transaction();
+    if (computeUnits) {
+        tx.add(web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: computeUnits }));
+    }
+    if (priorityFee) {
+        tx.add(web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: priorityFee }));
+    }
+    tx.add(claimIx);
+    // Set fee payer (user by default, or sponsor for relay flow)
+    tx.feePayer = feePayer ?? user;
+    // Fetch recent blockhash
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
+    tx.recentBlockhash = blockhash;
+    tx.lastValidBlockHeight = lastValidBlockHeight;
+    return tx;
+}
+/**
+ * Build claim transactions for multiple users in batch.
+ *
+ * Useful for server-side batch processing (e.g. airdrop-style claim on behalf)
+ * or building multiple TXs for a UI that processes them sequentially.
+ *
+ * Each transaction is independent and can be signed/submitted individually.
+ */
+async function buildBatchClaimTransactions(connection, launchpadProgram, opts) {
+    const results = new Map();
+    // Pre-fetch blockhash once for the batch
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
+    for (const user of opts.users) {
+        const accounts = (0, accounts_1.resolveClaimAccounts)(opts.launchConfig, opts.launchConfigData, user, opts.vaultProgramId, launchpadProgram.programId);
+        const tokenProgram = opts.tokenProgramId ?? spl_token_1.TOKEN_PROGRAM_ID;
+        const methods = launchpadProgram.methods;
+        const claimIx = await methods
+            .claimTokens()
+            .accountsPartial({
+            user: accounts.user,
+            launchConfig: accounts.launchConfig,
+            fundraiseState: accounts.fundraiseState,
+            userRecord: accounts.userRecord,
+            claimRecord: accounts.claimRecord,
+            baseMint: accounts.baseMint,
+            tokenVault: accounts.tokenVault,
+            userTokenAta: accounts.userTokenAta,
+            launchpadSigner: accounts.launchpadSigner,
+            tokenProgram,
+            associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .instruction();
+        const tx = new web3_js_1.Transaction();
+        if (opts.computeUnits) {
+            tx.add(web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: opts.computeUnits }));
+        }
+        if (opts.priorityFee) {
+            tx.add(web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: opts.priorityFee }));
+        }
+        tx.add(claimIx);
+        tx.feePayer = user;
+        tx.recentBlockhash = blockhash;
+        tx.lastValidBlockHeight = lastValidBlockHeight;
+        results.set(user.toBase58(), tx);
+    }
+    return results;
+}
+//# sourceMappingURL=tx.js.map

package/dist/claims/tx.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Star Launchpad SDK
+ *
+ * Full lifecycle SDK for the Star Launchpad program:
+ *
+ * Admin / launch flow:
+ * 1. Initialize launch (creates vault via CPI)
+ * 2. Configure launch (set vanity mint + metadata)
+ * 3. Create launch token (mint total supply)
+ * 4. Reserve admin (off-chain ZC API call)
+ * 5. Execute launch (pool + DAO + authority transfer)
+ * 6. Cancel launch (pre-Launched states only)
+ *
+ * Client / claim flow:
+ * 7. Check claim eligibility
+ * 8. Build claim transactions
+ *
+ * @see https://docs.combinator.trade/llms.txt
+ * @see programs/launchpad/spec/09-zc-dao-creation.md
+ */
+export { LaunchpadSDK } from './sdk';
+export * from './types';
+export { derivePoolAddress, sortMints } from './pdas';
+export * from './instructions';
+export * from './claims';
+export * from './zc';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGtD,cAAc,gBAAgB,CAAC;AAG/B,cAAc,UAAU,CAAC;AAGzB,cAAc,MAAM,CAAC"}