@star-factory/sdk-launchpad 0.1.0

package/dist/instructions/index.js

@@ -0,0 +1,57 @@
+"use strict";
+// ============================================================================
+// Instructions Module
+//
+// Transaction builders for all launchpad program instructions.
+//
+// Architecture:
+//   pdas.ts              — PDA derivation for external programs (DAMM, Squads, etc.)
+//   constants.ts         — External program IDs (Squads, Metaplex, Token-2022)
+//   initialize-launch.ts — Build initialize_launch TX
+//   configure-launch.ts  — Build configure_launch TX
+//   create-launch-token.ts — Build create_launch_token TX
+//   execute-launch.ts    — Build execute_launch TX + resolve ~35 accounts
+//   cancel-launch.ts     — Build cancel_launch TX
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_2022_PROGRAM_ID = exports.SQUADS_PROGRAM_ID = exports.METAPLEX_PROGRAM_ID = exports.deriveVaultPda = exports.deriveTgeConfigPda = exports.deriveSquadsVault = exports.deriveSquadsProgramConfig = exports.deriveSquadsMultisig = exports.derivePositionNftMintPda = exports.deriveModeratorPda = exports.deriveMintCreateKeyPda = exports.deriveMetadataPda = exports.deriveDaoPda = exports.deriveDammTokenVault = exports.deriveDammPositionNftAccount = exports.deriveDammPosition = exports.deriveDammPoolAuthority = exports.deriveDammEventAuthority = exports.buildInitializeLaunchTx = exports.buildExecuteLaunchTx = exports.buildCreateLaunchTokenTx = exports.buildConfigureLaunchTx = exports.buildCancelLaunchTx = void 0;
+// Transaction builders
+var cancel_launch_1 = require("./cancel-launch");
+Object.defineProperty(exports, "buildCancelLaunchTx", { enumerable: true, get: function () { return cancel_launch_1.buildCancelLaunchTx; } });
+var configure_launch_1 = require("./configure-launch");
+Object.defineProperty(exports, "buildConfigureLaunchTx", { enumerable: true, get: function () { return configure_launch_1.buildConfigureLaunchTx; } });
+var create_launch_token_1 = require("./create-launch-token");
+Object.defineProperty(exports, "buildCreateLaunchTokenTx", { enumerable: true, get: function () { return create_launch_token_1.buildCreateLaunchTokenTx; } });
+var execute_launch_1 = require("./execute-launch");
+Object.defineProperty(exports, "buildExecuteLaunchTx", { enumerable: true, get: function () { return execute_launch_1.buildExecuteLaunchTx; } });
+var initialize_launch_1 = require("./initialize-launch");
+Object.defineProperty(exports, "buildInitializeLaunchTx", { enumerable: true, get: function () { return initialize_launch_1.buildInitializeLaunchTx; } });
+// PDA derivation (external programs)
+var pdas_1 = require("./pdas");
+Object.defineProperty(exports, "deriveDammEventAuthority", { enumerable: true, get: function () { return pdas_1.deriveDammEventAuthority; } });
+// DAMM
+Object.defineProperty(exports, "deriveDammPoolAuthority", { enumerable: true, get: function () { return pdas_1.deriveDammPoolAuthority; } });
+Object.defineProperty(exports, "deriveDammPosition", { enumerable: true, get: function () { return pdas_1.deriveDammPosition; } });
+Object.defineProperty(exports, "deriveDammPositionNftAccount", { enumerable: true, get: function () { return pdas_1.deriveDammPositionNftAccount; } });
+Object.defineProperty(exports, "deriveDammTokenVault", { enumerable: true, get: function () { return pdas_1.deriveDammTokenVault; } });
+// Futarchy
+Object.defineProperty(exports, "deriveDaoPda", { enumerable: true, get: function () { return pdas_1.deriveDaoPda; } });
+// Metaplex
+Object.defineProperty(exports, "deriveMetadataPda", { enumerable: true, get: function () { return pdas_1.deriveMetadataPda; } });
+Object.defineProperty(exports, "deriveMintCreateKeyPda", { enumerable: true, get: function () { return pdas_1.deriveMintCreateKeyPda; } });
+Object.defineProperty(exports, "deriveModeratorPda", { enumerable: true, get: function () { return pdas_1.deriveModeratorPda; } });
+// Launchpad
+Object.defineProperty(exports, "derivePositionNftMintPda", { enumerable: true, get: function () { return pdas_1.derivePositionNftMintPda; } });
+// Squads
+Object.defineProperty(exports, "deriveSquadsMultisig", { enumerable: true, get: function () { return pdas_1.deriveSquadsMultisig; } });
+Object.defineProperty(exports, "deriveSquadsProgramConfig", { enumerable: true, get: function () { return pdas_1.deriveSquadsProgramConfig; } });
+Object.defineProperty(exports, "deriveSquadsVault", { enumerable: true, get: function () { return pdas_1.deriveSquadsVault; } });
+Object.defineProperty(exports, "deriveTgeConfigPda", { enumerable: true, get: function () { return pdas_1.deriveTgeConfigPda; } });
+// Vault
+Object.defineProperty(exports, "deriveVaultPda", { enumerable: true, get: function () { return pdas_1.deriveVaultPda; } });
+// Constants
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "METAPLEX_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.METAPLEX_PROGRAM_ID; } });
+Object.defineProperty(exports, "SQUADS_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.SQUADS_PROGRAM_ID; } });
+Object.defineProperty(exports, "TOKEN_2022_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.TOKEN_2022_PROGRAM_ID; } });
+//# sourceMappingURL=index.js.map

package/dist/instructions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instructions/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,sBAAsB;AACtB,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,gBAAgB;AAChB,qFAAqF;AACrF,+EAA+E;AAC/E,sDAAsD;AACtD,qDAAqD;AACrD,0DAA0D;AAC1D,0EAA0E;AAC1E,kDAAkD;AAClD,+EAA+E;;;AAE/E,uBAAuB;AACvB,iDAAsD;AAA7C,oHAAA,mBAAmB,OAAA;AAC5B,uDAA4D;AAAnD,0HAAA,sBAAsB,OAAA;AAC/B,6DAAiE;AAAxD,+HAAA,wBAAwB,OAAA;AACjC,mDAA4F;AAAnF,sHAAA,oBAAoB,OAAA;AAC7B,yDAA8D;AAArD,4HAAA,uBAAuB,OAAA;AAEhC,qCAAqC;AACrC,+BAegB;AAdZ,gHAAA,wBAAwB,OAAA;AACxB,OAAO;AACP,+GAAA,uBAAuB,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AAC3C,oHAAA,4BAA4B,OAAA;AAAE,4GAAA,oBAAoB,OAAA;AAClD,WAAW;AACX,oGAAA,YAAY,OAAA;AACZ,WAAW;AACX,yGAAA,iBAAiB,OAAA;AAAE,8GAAA,sBAAsB,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AAC7D,YAAY;AACZ,gHAAA,wBAAwB,OAAA;AACxB,SAAS;AACT,4GAAA,oBAAoB,OAAA;AAAE,iHAAA,yBAAyB,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AACtF,QAAQ;AACR,sGAAA,cAAc,OAAA;AAGlB,YAAY;AACZ,yCAEqB;AADjB,gHAAA,mBAAmB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,kHAAA,qBAAqB,OAAA"}

package/dist/instructions/initialize-launch.d.ts

@@ -0,0 +1,15 @@
+import type { Idl, Program } from '@coral-xyz/anchor';
+import { Connection, Transaction } from '@solana/web3.js';
+import type { InitializeLaunchOptions } from '../types';
+/**
+ * Build an unsigned `initialize_launch` transaction.
+ *
+ * Creates a LaunchConfig PDA and the underlying fundraise vault via CPI to vault::make.
+ * The creator signs as both the launch initiator and the vault maker.
+ *
+ * @param connection       - Solana RPC connection (for blockhash)
+ * @param launchpadProgram - Anchor program instance for the launchpad
+ * @param opts             - Initialize launch options
+ */
+export declare function buildInitializeLaunchTx(connection: Connection, launchpadProgram: Program<Idl>, opts: InitializeLaunchOptions): Promise<Transaction>;
+//# sourceMappingURL=initialize-launch.d.ts.map

package/dist/instructions/initialize-launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-launch.d.ts","sourceRoot":"","sources":["../../src/instructions/initialize-launch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMtD,OAAO,EAEH,UAAU,EAGV,WAAW,EAEd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAaxD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,EAC9B,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,WAAW,CAAC,CA2EtB"}

package/dist/instructions/initialize-launch.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInitializeLaunchTx = buildInitializeLaunchTx;
+const spl_token_1 = require("@solana/spl-token");
+const web3_js_1 = require("@solana/web3.js");
+const pdas_1 = require("../claims/pdas");
+const pdas_2 = require("./pdas");
+// ============================================================================
+// initialize_launch Transaction Builder
+// ============================================================================
+/**
+ * Build an unsigned `initialize_launch` transaction.
+ *
+ * Creates a LaunchConfig PDA and the underlying fundraise vault via CPI to vault::make.
+ * The creator signs as both the launch initiator and the vault maker.
+ *
+ * @param connection       - Solana RPC connection (for blockhash)
+ * @param launchpadProgram - Anchor program instance for the launchpad
+ * @param opts             - Initialize launch options
+ */
+async function buildInitializeLaunchTx(connection, launchpadProgram, opts) {
+    const { creator, seed, vaultSeed, totalSupply, tokensToParticipants, quoteMint, minRaise, targetRaise, startTime, endTime, vaultProgramId, feePayer, computeUnits, priorityFee, } = opts;
+    const launchpadProgramId = launchpadProgram.programId;
+    // Derive all accounts deterministically
+    const [launchConfig] = (0, pdas_1.deriveLaunchConfigPda)(creator, BigInt(seed.toString()), launchpadProgramId);
+    const [launchpadSigner] = (0, pdas_1.deriveLaunchpadSignerPda)(launchConfig, launchpadProgramId);
+    const [vault] = (0, pdas_2.deriveVaultPda)(creator, BigInt(vaultSeed.toString()), vaultProgramId);
+    const [tgeConfig] = (0, pdas_2.deriveTgeConfigPda)(vault, vaultProgramId);
+    const vaultAta = (0, spl_token_1.getAssociatedTokenAddressSync)(quoteMint, vault, true);
+    const methods = launchpadProgram.methods;
+    const ix = await methods.initializeLaunch({
+        seed,
+        vaultSeed,
+        totalSupply,
+        tokensToParticipants,
+        fundraiseParams: {
+            minRaise,
+            targetRaise,
+            startTime,
+            endTime,
+        },
+    })
+        .accounts({
+        creator,
+        launchConfig,
+        launchpadSigner,
+        quoteMint,
+        vault,
+        vaultAta,
+        tgeConfig,
+        vaultProgram: vaultProgramId,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    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(ix);
+    tx.feePayer = feePayer ?? creator;
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
+    tx.recentBlockhash = blockhash;
+    tx.lastValidBlockHeight = lastValidBlockHeight;
+    return tx;
+}
+//# sourceMappingURL=initialize-launch.js.map

package/dist/instructions/initialize-launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-launch.js","sourceRoot":"","sources":["../../src/instructions/initialize-launch.ts"],"names":[],"mappings":";;AAuCA,0DA+EC;AArHD,iDAI2B;AAC3B,6CAOyB;AAEzB,yCAAiF;AAEjF,iCAA4D;AAQ5D,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E;;;;;;;;;GASG;AACI,KAAK,UAAU,uBAAuB,CAC3C,UAAsB,EACtB,gBAA8B,EAC9B,IAA6B;IAE7B,MAAM,EACJ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,SAAS,EACT,OAAO,EACP,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAW,GACZ,GAAG,IAAI,CAAC;IAET,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,SAAsB,CAAC;IAEnE,wCAAwC;IACxC,MAAM,CAAC,YAAY,CAAC,GAAG,IAAA,4BAAqB,EAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACnG,MAAM,CAAC,eAAe,CAAC,GAAG,IAAA,+BAAwB,EAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACrF,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,qBAAc,EAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;IACtF,MAAM,CAAC,SAAS,CAAC,GAAG,IAAA,yBAAkB,EAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAA,yCAA6B,EAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAEhC,CAAC;IAEF,MAAM,EAAE,GAA2B,MAAM,OAAO,CAAC,gBAAgB,CAAC;QAC9D,IAAI;QACJ,SAAS;QACT,WAAW;QACX,oBAAoB;QACpB,eAAe,EAAE;YACf,QAAQ;YACR,WAAW;YACX,SAAS;YACT,OAAO;SACR;KACF,CAAC;SACD,QAAQ,CAAC;QACR,OAAO;QACP,YAAY;QACZ,eAAe;QACf,SAAS;QACT,KAAK;QACL,QAAQ;QACR,SAAS;QACT,YAAY,EAAE,cAAc;QAC5B,sBAAsB,EAAE,uCAA2B;QACnD,YAAY,EAAE,4BAAgB;QAC9B,aAAa,EAAE,uBAAa,CAAC,SAAS;KACvC,CAAC;SACD,WAAW,EAAE,CAAC;IAEjB,MAAM,EAAE,GAAG,IAAI,qBAAW,EAAE,CAAC;IAE7B,IAAI,YAAY,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,EAAE,CAAC,GAAG,CAAC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACX,EAAE,CAAC,QAAQ,GAAG,QAAQ,IAAI,OAAO,CAAC;IAElC,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC7F,EAAE,CAAC,eAAe,GAAG,SAAS,CAAC;IAC/B,EAAE,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;IAE/C,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/instructions/pdas.d.ts

@@ -0,0 +1,95 @@
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Derive the StarVault PDA from the vault program.
+ *
+ * Seeds: `["vault", maker, seed_le_bytes]`
+ */
+export declare function deriveVaultPda(maker: PublicKey, seed: bigint | number, vaultProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the TGE config PDA from the vault program.
+ *
+ * Seeds: `["tge_config", vault]`
+ */
+export declare function deriveTgeConfigPda(vault: PublicKey, vaultProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the position NFT mint PDA.
+ *
+ * Seeds: `["position_nft_mint", launch_config]`
+ *
+ * Created by the DAMM program during execute_launch.
+ * The launchpad program uses this PDA as a signer for the DAMM CPI.
+ */
+export declare function derivePositionNftMintPda(launchConfig: PublicKey, launchpadProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the DAMM pool authority PDA.
+ *
+ * Seeds: `["pool_authority"]`
+ */
+export declare function deriveDammPoolAuthority(dammProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive a DAMM token vault PDA.
+ *
+ * Seeds: `["token_vault", token_mint, pool]`
+ */
+export declare function deriveDammTokenVault(tokenMint: PublicKey, pool: PublicKey, dammProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive a DAMM position PDA.
+ *
+ * Seeds: `["position", position_nft_mint]`
+ */
+export declare function deriveDammPosition(positionNftMint: PublicKey, dammProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive a DAMM position NFT account PDA.
+ *
+ * Seeds: `["position_nft_account", position_nft_mint]`
+ */
+export declare function deriveDammPositionNftAccount(positionNftMint: PublicKey, dammProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the DAMM event authority PDA.
+ *
+ * Seeds: `["__event_authority"]`
+ */
+export declare function deriveDammEventAuthority(dammProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive a Squads multisig PDA.
+ *
+ * Seeds: `["multisig", "multisig", create_key]`
+ */
+export declare function deriveSquadsMultisig(createKey: PublicKey, squadsProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive a Squads vault PDA.
+ *
+ * Seeds: `["multisig", multisig, "vault", vault_index_byte]`
+ */
+export declare function deriveSquadsVault(multisig: PublicKey, vaultIndex: number, squadsProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the Squads program config PDA.
+ *
+ * Seeds: `["multisig", "program_config"]`
+ */
+export declare function deriveSquadsProgramConfig(squadsProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the DAO PDA.
+ *
+ * Seeds: `["dao", name]`
+ */
+export declare function deriveDaoPda(name: string, futarchyProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the moderator PDA.
+ *
+ * Seeds: `["moderator", name]`
+ */
+export declare function deriveModeratorPda(name: string, futarchyProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the mint create key PDA.
+ *
+ * Seeds: `[dao, "mint_key", name]`
+ */
+export declare function deriveMintCreateKeyPda(dao: PublicKey, name: string, futarchyProgramId: PublicKey): [PublicKey, number];
+/**
+ * Derive the Metaplex metadata PDA for a mint.
+ *
+ * Seeds: `["metadata", metaplex_program_id, mint]`
+ */
+export declare function deriveMetadataPda(mint: PublicKey, metaplexProgramId: PublicKey): [PublicKey, number];
+//# sourceMappingURL=pdas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pdas.d.ts","sourceRoot":"","sources":["../../src/instructions/pdas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,cAAc,EAAE,SAAS,GACxB,CAAC,SAAS,EAAE,MAAM,CAAC,CAQrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,cAAc,EAAE,SAAS,GACxB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAQD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,SAAS,EACvB,kBAAkB,EAAE,SAAS,GAC5B,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,SAAS,GACvB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,EACf,aAAa,EAAE,SAAS,GACvB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,SAAS,EAC1B,aAAa,EAAE,SAAS,GACvB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,SAAS,EAC1B,aAAa,EAAE,SAAS,GACvB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,SAAS,GACvB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAQD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,SAAS,GACzB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,SAAS,GACzB,CAAC,SAAS,EAAE,MAAM,CAAC,CAQrB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,SAAS,GACzB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,SAAS,GAC3B,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,SAAS,GAC3B,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,SAAS,GAC3B,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,iBAAiB,EAAE,SAAS,GAC3B,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB"}

package/dist/instructions/pdas.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveVaultPda = deriveVaultPda;
+exports.deriveTgeConfigPda = deriveTgeConfigPda;
+exports.derivePositionNftMintPda = derivePositionNftMintPda;
+exports.deriveDammPoolAuthority = deriveDammPoolAuthority;
+exports.deriveDammTokenVault = deriveDammTokenVault;
+exports.deriveDammPosition = deriveDammPosition;
+exports.deriveDammPositionNftAccount = deriveDammPositionNftAccount;
+exports.deriveDammEventAuthority = deriveDammEventAuthority;
+exports.deriveSquadsMultisig = deriveSquadsMultisig;
+exports.deriveSquadsVault = deriveSquadsVault;
+exports.deriveSquadsProgramConfig = deriveSquadsProgramConfig;
+exports.deriveDaoPda = deriveDaoPda;
+exports.deriveModeratorPda = deriveModeratorPda;
+exports.deriveMintCreateKeyPda = deriveMintCreateKeyPda;
+exports.deriveMetadataPda = deriveMetadataPda;
+const web3_js_1 = require("@solana/web3.js");
+// ============================================================================
+// Vault Program PDA Helpers
+// ============================================================================
+const VAULT_SEED = Buffer.from('vault');
+const TGE_CONFIG_SEED = Buffer.from('tge_config');
+/**
+ * Derive the StarVault PDA from the vault program.
+ *
+ * Seeds: `["vault", maker, seed_le_bytes]`
+ */
+function deriveVaultPda(maker, seed, vaultProgramId) {
+    const seedBuf = Buffer.alloc(8);
+    seedBuf.writeBigUInt64LE(BigInt(seed));
+    return web3_js_1.PublicKey.findProgramAddressSync([VAULT_SEED, maker.toBuffer(), seedBuf], vaultProgramId);
+}
+/**
+ * Derive the TGE config PDA from the vault program.
+ *
+ * Seeds: `["tge_config", vault]`
+ */
+function deriveTgeConfigPda(vault, vaultProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([TGE_CONFIG_SEED, vault.toBuffer()], vaultProgramId);
+}
+// ============================================================================
+// Launchpad Program PDA Helpers (supplementary — core PDAs in claims/pdas.ts)
+// ============================================================================
+const POSITION_NFT_MINT_SEED = Buffer.from('position_nft_mint');
+/**
+ * Derive the position NFT mint PDA.
+ *
+ * Seeds: `["position_nft_mint", launch_config]`
+ *
+ * Created by the DAMM program during execute_launch.
+ * The launchpad program uses this PDA as a signer for the DAMM CPI.
+ */
+function derivePositionNftMintPda(launchConfig, launchpadProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([POSITION_NFT_MINT_SEED, launchConfig.toBuffer()], launchpadProgramId);
+}
+// ============================================================================
+// DAMM Program PDA Helpers
+// ============================================================================
+/**
+ * Derive the DAMM pool authority PDA.
+ *
+ * Seeds: `["pool_authority"]`
+ */
+function deriveDammPoolAuthority(dammProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('pool_authority')], dammProgramId);
+}
+/**
+ * Derive a DAMM token vault PDA.
+ *
+ * Seeds: `["token_vault", token_mint, pool]`
+ */
+function deriveDammTokenVault(tokenMint, pool, dammProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('token_vault'), tokenMint.toBuffer(), pool.toBuffer()], dammProgramId);
+}
+/**
+ * Derive a DAMM position PDA.
+ *
+ * Seeds: `["position", position_nft_mint]`
+ */
+function deriveDammPosition(positionNftMint, dammProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('position'), positionNftMint.toBuffer()], dammProgramId);
+}
+/**
+ * Derive a DAMM position NFT account PDA.
+ *
+ * Seeds: `["position_nft_account", position_nft_mint]`
+ */
+function deriveDammPositionNftAccount(positionNftMint, dammProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('position_nft_account'), positionNftMint.toBuffer()], dammProgramId);
+}
+/**
+ * Derive the DAMM event authority PDA.
+ *
+ * Seeds: `["__event_authority"]`
+ */
+function deriveDammEventAuthority(dammProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('__event_authority')], dammProgramId);
+}
+// ============================================================================
+// Squads Multisig Program PDA Helpers
+// ============================================================================
+const SQUADS_PREFIX = Buffer.from('multisig');
+/**
+ * Derive a Squads multisig PDA.
+ *
+ * Seeds: `["multisig", "multisig", create_key]`
+ */
+function deriveSquadsMultisig(createKey, squadsProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([SQUADS_PREFIX, Buffer.from('multisig'), createKey.toBuffer()], squadsProgramId);
+}
+/**
+ * Derive a Squads vault PDA.
+ *
+ * Seeds: `["multisig", multisig, "vault", vault_index_byte]`
+ */
+function deriveSquadsVault(multisig, vaultIndex, squadsProgramId) {
+    const indexBuf = Buffer.alloc(1);
+    indexBuf.writeUInt8(vaultIndex);
+    return web3_js_1.PublicKey.findProgramAddressSync([SQUADS_PREFIX, multisig.toBuffer(), Buffer.from('vault'), indexBuf], squadsProgramId);
+}
+/**
+ * Derive the Squads program config PDA.
+ *
+ * Seeds: `["multisig", "program_config"]`
+ */
+function deriveSquadsProgramConfig(squadsProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([SQUADS_PREFIX, Buffer.from('program_config')], squadsProgramId);
+}
+// ============================================================================
+// Futarchy Program PDA Helpers
+// ============================================================================
+/**
+ * Derive the DAO PDA.
+ *
+ * Seeds: `["dao", name]`
+ */
+function deriveDaoPda(name, futarchyProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('dao'), Buffer.from(name)], futarchyProgramId);
+}
+/**
+ * Derive the moderator PDA.
+ *
+ * Seeds: `["moderator", name]`
+ */
+function deriveModeratorPda(name, futarchyProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('moderator'), Buffer.from(name)], futarchyProgramId);
+}
+/**
+ * Derive the mint create key PDA.
+ *
+ * Seeds: `[dao, "mint_key", name]`
+ */
+function deriveMintCreateKeyPda(dao, name, futarchyProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([dao.toBuffer(), Buffer.from('mint_key'), Buffer.from(name)], futarchyProgramId);
+}
+// ============================================================================
+// Metaplex Token Metadata PDA Helpers
+// ============================================================================
+/**
+ * Derive the Metaplex metadata PDA for a mint.
+ *
+ * Seeds: `["metadata", metaplex_program_id, mint]`
+ */
+function deriveMetadataPda(mint, metaplexProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('metadata'), metaplexProgramId.toBuffer(), mint.toBuffer()], metaplexProgramId);
+}
+//# sourceMappingURL=pdas.js.map

package/dist/instructions/pdas.js.map

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

package/dist/pdas.d.ts

@@ -0,0 +1,19 @@
+import { PublicKey } from '@solana/web3.js';
+import { DerivePoolAddressInput } from './types';
+/**
+ * Derive the DAMM pool PDA for a token pair.
+ *
+ * Pool PDA = PDA(["pool", config, tokenA, tokenB], DAMM_PROGRAM)
+ *
+ * Where tokenA and tokenB are sorted (min first, max second).
+ *
+ * IMPORTANT: The pool doesn't exist yet at reservation time!
+ * This computes the PREDICTED address.
+ */
+export declare function derivePoolAddress(input: DerivePoolAddressInput, dammProgramId: PublicKey): PublicKey;
+/**
+ * Sort two mints for consistent PDA derivation.
+ * DAMM pools always have tokenA < tokenB lexicographically.
+ */
+export declare function sortMints(mintA: PublicKey, mintB: PublicKey): [PublicKey, PublicKey];
+//# sourceMappingURL=pdas.d.ts.map

package/dist/pdas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdas.d.ts","sourceRoot":"","sources":["../src/pdas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,EAC7B,aAAa,EAAE,SAAS,GACvB,SAAS,CAiBX;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,GACf,CAAC,SAAS,EAAE,SAAS,CAAC,CAQxB"}

package/dist/pdas.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivePoolAddress = derivePoolAddress;
+exports.sortMints = sortMints;
+const web3_js_1 = require("@solana/web3.js");
+/**
+ * Derive the DAMM pool PDA for a token pair.
+ *
+ * Pool PDA = PDA(["pool", config, tokenA, tokenB], DAMM_PROGRAM)
+ *
+ * Where tokenA and tokenB are sorted (min first, max second).
+ *
+ * IMPORTANT: The pool doesn't exist yet at reservation time!
+ * This computes the PREDICTED address.
+ */
+function derivePoolAddress(input, dammProgramId) {
+    const { baseMint, quoteMint, config } = input;
+    // Sort token mints (DAMM requires consistent ordering)
+    const [tokenA, tokenB] = sortMints(baseMint, quoteMint);
+    const [poolPda] = web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from('pool'),
+        config.toBuffer(),
+        tokenA.toBuffer(),
+        tokenB.toBuffer(),
+    ], dammProgramId);
+    return poolPda;
+}
+/**
+ * Sort two mints for consistent PDA derivation.
+ * DAMM pools always have tokenA < tokenB lexicographically.
+ */
+function sortMints(mintA, mintB) {
+    const a = mintA.toBuffer();
+    const b = mintB.toBuffer();
+    if (Buffer.compare(a, b) < 0) {
+        return [mintA, mintB];
+    }
+    return [mintB, mintA];
+}
+//# sourceMappingURL=pdas.js.map

package/dist/pdas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdas.js","sourceRoot":"","sources":["../src/pdas.ts"],"names":[],"mappings":";;AAaA,8CAoBC;AAMD,8BAWC;AAlDD,6CAA4C;AAG5C;;;;;;;;;GASG;AACH,SAAgB,iBAAiB,CAC/B,KAA6B,EAC7B,aAAwB;IAExB,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9C,uDAAuD;IACvD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAExD,MAAM,CAAC,OAAO,CAAC,GAAG,mBAAS,CAAC,sBAAsB,CAChD;QACE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,QAAQ,EAAE;QACjB,MAAM,CAAC,QAAQ,EAAE;QACjB,MAAM,CAAC,QAAQ,EAAE;KAClB,EACD,aAAa,CACd,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CACvB,KAAgB,EAChB,KAAgB;IAEhB,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC"}