@send-fun/sdk 1.1.0 → 2.0.0

package/src/launchpad/generated/instructions/migrate.ts

@@ -45,6 +45,7 @@ import {
 import {
 	EVENT_AUTHORITY_PDA_ADDRESS,
 	findBondingCurvePda,
+	findCreatorFeeConfigPda,
 	MIGRATION_AUTHORITY_PDA_ADDRESS,
 } from '../pdas/index.js';
 import { SEND_LAUNCHPAD_PROGRAM_ADDRESS } from '../programs/index.js';
@@ -90,6 +91,7 @@ export type MigrateInstruction<
 		'FJVebqCthxH6JM8vvkJb7yRYA7Emsib1C1vu4ZePSP3T',
 	TAccountProgram extends string | AccountMeta<string> =
 		'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP',
+	TAccountDexCreatorFeeConfig extends string | AccountMeta<string> = string,
 	TRemainingAccounts extends readonly AccountMeta<string>[] = [],
 > = Instruction<TProgram> &
 	InstructionWithData<ReadonlyUint8Array> &
@@ -142,7 +144,7 @@ export type MigrateInstruction<
 				? ReadonlyAccount<TAccountNexusProgram>
 				: TAccountNexusProgram,
 			TAccountCreatorFeeConfig extends string
-				? ReadonlyAccount<TAccountCreatorFeeConfig>
+				? WritableAccount<TAccountCreatorFeeConfig>
 				: TAccountCreatorFeeConfig,
 			TAccountBaseTokenProgram extends string
 				? ReadonlyAccount<TAccountBaseTokenProgram>
@@ -162,6 +164,9 @@ export type MigrateInstruction<
 			TAccountProgram extends string
 				? ReadonlyAccount<TAccountProgram>
 				: TAccountProgram,
+			TAccountDexCreatorFeeConfig extends string
+				? WritableAccount<TAccountDexCreatorFeeConfig>
+				: TAccountDexCreatorFeeConfig,
 			...TRemainingAccounts,
 		]
 	>;
@@ -209,6 +214,7 @@ export type MigrateAsyncInput<
 	TAccountPoolLpAccount extends string = string,
 	TAccountCreatorFeeConfig extends string = string,
 	TAccountQuoteTokenProgram extends string = string,
+	TAccountDexCreatorFeeConfig extends string = string,
 > = {
 	caller: TransactionSigner<TAccountCaller>;
 	bondingCurve?: Address<TAccountBondingCurve>;
@@ -221,8 +227,9 @@ export type MigrateAsyncInput<
 	poolBaseVault: Address<TAccountPoolBaseVault>;
 	poolQuoteVault: Address<TAccountPoolQuoteVault>;
 	poolLpAccount: Address<TAccountPoolLpAccount>;
-	creatorFeeConfig: Address<TAccountCreatorFeeConfig>;
+	creatorFeeConfig?: Address<TAccountCreatorFeeConfig>;
 	quoteTokenProgram: Address<TAccountQuoteTokenProgram>;
+	dexCreatorFeeConfig?: Address<TAccountDexCreatorFeeConfig>;
 };
 
 export async function getMigrateInstructionAsync<
@@ -239,6 +246,7 @@ export async function getMigrateInstructionAsync<
 	TAccountPoolLpAccount extends string,
 	TAccountCreatorFeeConfig extends string,
 	TAccountQuoteTokenProgram extends string,
+	TAccountDexCreatorFeeConfig extends string,
 >(
 	input: MigrateAsyncInput<
 		TAccountCaller,
@@ -253,7 +261,8 @@ export async function getMigrateInstructionAsync<
 		TAccountPoolQuoteVault,
 		TAccountPoolLpAccount,
 		TAccountCreatorFeeConfig,
-		TAccountQuoteTokenProgram
+		TAccountQuoteTokenProgram,
+		TAccountDexCreatorFeeConfig
 	>,
 ): Promise<
 	MigrateInstruction<
@@ -279,7 +288,8 @@ export async function getMigrateInstructionAsync<
 		'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL',
 		'11111111111111111111111111111111',
 		'FJVebqCthxH6JM8vvkJb7yRYA7Emsib1C1vu4ZePSP3T',
-		'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP'
+		'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP',
+		TAccountDexCreatorFeeConfig
 	>
 > {
 	// Program address.
@@ -307,7 +317,7 @@ export async function getMigrateInstructionAsync<
 		nexusProgram: { value: null, isWritable: false },
 		creatorFeeConfig: {
 			value: input.creatorFeeConfig ?? null,
-			isWritable: false,
+			isWritable: true,
 		},
 		baseTokenProgram: { value: null, isWritable: false },
 		quoteTokenProgram: {
@@ -318,6 +328,10 @@ export async function getMigrateInstructionAsync<
 		systemProgram: { value: null, isWritable: false },
 		eventAuthority: { value: null, isWritable: false },
 		program: { value: null, isWritable: false },
+		dexCreatorFeeConfig: {
+			value: input.dexCreatorFeeConfig ?? null,
+			isWritable: true,
+		},
 	};
 	const accounts = originalAccounts as Record<
 		keyof typeof originalAccounts,
@@ -445,6 +459,18 @@ export async function getMigrateInstructionAsync<
 		accounts.nexusProgram.value =
 			'7rrCurqdWFesbzwtYPo95fM8waTtVXgXwCom45x1sfNX' as Address<'7rrCurqdWFesbzwtYPo95fM8waTtVXgXwCom45x1sfNX'>;
 	}
+	if (!accounts.creatorFeeConfig.value) {
+		accounts.creatorFeeConfig.value = await findCreatorFeeConfigPda({
+			baseMint: getAddressFromResolvedInstructionAccount(
+				'baseMint',
+				accounts.baseMint.value,
+			),
+			quoteMint: getAddressFromResolvedInstructionAccount(
+				'quoteMint',
+				accounts.quoteMint.value,
+			),
+		});
+	}
 	if (!accounts.baseTokenProgram.value) {
 		accounts.baseTokenProgram.value =
 			'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb' as Address<'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb'>;
@@ -464,6 +490,32 @@ export async function getMigrateInstructionAsync<
 		accounts.program.value =
 			'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP' as Address<'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP'>;
 	}
+	if (!accounts.dexCreatorFeeConfig.value) {
+		accounts.dexCreatorFeeConfig.value = await getProgramDerivedAddress({
+			programAddress:
+				'84qj5FPZZdXkQy8mfowyg6RBZ3XKuTds6XS4ZYT1sfDX' as Address<'84qj5FPZZdXkQy8mfowyg6RBZ3XKuTds6XS4ZYT1sfDX'>,
+			seeds: [
+				getBytesEncoder().encode(
+					new Uint8Array([
+						99, 114, 101, 97, 116, 111, 114, 95, 102, 101, 101, 95,
+						99, 111, 110, 102, 105, 103,
+					]),
+				),
+				getAddressEncoder().encode(
+					getAddressFromResolvedInstructionAccount(
+						'baseMint',
+						accounts.baseMint.value,
+					),
+				),
+				getAddressEncoder().encode(
+					getAddressFromResolvedInstructionAccount(
+						'quoteMint',
+						accounts.quoteMint.value,
+					),
+				),
+			],
+		});
+	}
 
 	const getAccountMeta = getAccountMetaFactory(programAddress, 'programId');
 	return Object.freeze({
@@ -493,6 +545,7 @@ export async function getMigrateInstructionAsync<
 			getAccountMeta('systemProgram', accounts.systemProgram),
 			getAccountMeta('eventAuthority', accounts.eventAuthority),
 			getAccountMeta('program', accounts.program),
+			getAccountMeta('dexCreatorFeeConfig', accounts.dexCreatorFeeConfig),
 		],
 		data: getMigrateInstructionDataEncoder().encode({}),
 		programAddress,
@@ -519,7 +572,8 @@ export async function getMigrateInstructionAsync<
 		'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL',
 		'11111111111111111111111111111111',
 		'FJVebqCthxH6JM8vvkJb7yRYA7Emsib1C1vu4ZePSP3T',
-		'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP'
+		'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP',
+		TAccountDexCreatorFeeConfig
 	>);
 }
 
@@ -537,6 +591,7 @@ export type MigrateInput<
 	TAccountPoolLpAccount extends string = string,
 	TAccountCreatorFeeConfig extends string = string,
 	TAccountQuoteTokenProgram extends string = string,
+	TAccountDexCreatorFeeConfig extends string = string,
 > = {
 	caller: TransactionSigner<TAccountCaller>;
 	bondingCurve: Address<TAccountBondingCurve>;
@@ -551,6 +606,7 @@ export type MigrateInput<
 	poolLpAccount: Address<TAccountPoolLpAccount>;
 	creatorFeeConfig: Address<TAccountCreatorFeeConfig>;
 	quoteTokenProgram: Address<TAccountQuoteTokenProgram>;
+	dexCreatorFeeConfig: Address<TAccountDexCreatorFeeConfig>;
 };
 
 export function getMigrateInstruction<
@@ -567,6 +623,7 @@ export function getMigrateInstruction<
 	TAccountPoolLpAccount extends string,
 	TAccountCreatorFeeConfig extends string,
 	TAccountQuoteTokenProgram extends string,
+	TAccountDexCreatorFeeConfig extends string,
 >(
 	input: MigrateInput<
 		TAccountCaller,
@@ -581,7 +638,8 @@ export function getMigrateInstruction<
 		TAccountPoolQuoteVault,
 		TAccountPoolLpAccount,
 		TAccountCreatorFeeConfig,
-		TAccountQuoteTokenProgram
+		TAccountQuoteTokenProgram,
+		TAccountDexCreatorFeeConfig
 	>,
 ): MigrateInstruction<
 	typeof SEND_LAUNCHPAD_PROGRAM_ADDRESS,
@@ -606,7 +664,8 @@ export function getMigrateInstruction<
 	'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL',
 	'11111111111111111111111111111111',
 	'FJVebqCthxH6JM8vvkJb7yRYA7Emsib1C1vu4ZePSP3T',
-	'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP'
+	'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP',
+	TAccountDexCreatorFeeConfig
 > {
 	// Program address.
 	const programAddress = SEND_LAUNCHPAD_PROGRAM_ADDRESS;
@@ -633,7 +692,7 @@ export function getMigrateInstruction<
 		nexusProgram: { value: null, isWritable: false },
 		creatorFeeConfig: {
 			value: input.creatorFeeConfig ?? null,
-			isWritable: false,
+			isWritable: true,
 		},
 		baseTokenProgram: { value: null, isWritable: false },
 		quoteTokenProgram: {
@@ -644,6 +703,10 @@ export function getMigrateInstruction<
 		systemProgram: { value: null, isWritable: false },
 		eventAuthority: { value: null, isWritable: false },
 		program: { value: null, isWritable: false },
+		dexCreatorFeeConfig: {
+			value: input.dexCreatorFeeConfig ?? null,
+			isWritable: true,
+		},
 	};
 	const accounts = originalAccounts as Record<
 		keyof typeof originalAccounts,
@@ -714,6 +777,7 @@ export function getMigrateInstruction<
 			getAccountMeta('systemProgram', accounts.systemProgram),
 			getAccountMeta('eventAuthority', accounts.eventAuthority),
 			getAccountMeta('program', accounts.program),
+			getAccountMeta('dexCreatorFeeConfig', accounts.dexCreatorFeeConfig),
 		],
 		data: getMigrateInstructionDataEncoder().encode({}),
 		programAddress,
@@ -740,7 +804,8 @@ export function getMigrateInstruction<
 		'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL',
 		'11111111111111111111111111111111',
 		'FJVebqCthxH6JM8vvkJb7yRYA7Emsib1C1vu4ZePSP3T',
-		'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP'
+		'5R1uFyEE4oxqkm7hJDqHq6gXaLVF9dxeF3LF4yz1sfLP',
+		TAccountDexCreatorFeeConfig
 	>);
 }
 
@@ -772,6 +837,7 @@ export type ParsedMigrateInstruction<
 		systemProgram: TAccountMetas[19];
 		eventAuthority: TAccountMetas[20];
 		program: TAccountMetas[21];
+		dexCreatorFeeConfig: TAccountMetas[22];
 	};
 	data: MigrateInstructionData;
 };
@@ -792,12 +858,12 @@ export function parseMigrateInstruction<
 		error.name = 'InstructionDiscriminatorMismatchError';
 		throw error;
 	}
-	if (instruction.accounts.length < 22) {
+	if (instruction.accounts.length < 23) {
 		throw new SolanaError(
 			SOLANA_ERROR__PROGRAM_CLIENTS__INSUFFICIENT_ACCOUNT_METAS,
 			{
 				actualAccountMetas: instruction.accounts.length,
-				expectedAccountMetas: 22,
+				expectedAccountMetas: 23,
 			},
 		);
 	}
@@ -834,6 +900,7 @@ export function parseMigrateInstruction<
 			systemProgram: getNextAccount(),
 			eventAuthority: getNextAccount(),
 			program: getNextAccount(),
+			dexCreatorFeeConfig: getNextAccount(),
 		},
 		data: getMigrateInstructionDataDecoder().decode(instruction.data),
 	};

package/src/launchpad/generated/pdas/creatorFeeConfig.ts

@@ -0,0 +1,39 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+	getAddressEncoder,
+	getBytesEncoder,
+	getProgramDerivedAddress,
+	type Address,
+	type ProgramDerivedAddress,
+} from '@solana/kit';
+import { SEND_LAUNCHPAD_PROGRAM_ADDRESS } from '../programs/index.js';
+
+export type CreatorFeeConfigSeeds = {
+	baseMint: Address;
+	quoteMint: Address;
+};
+
+export async function findCreatorFeeConfigPda(
+	seeds: CreatorFeeConfigSeeds,
+): Promise<ProgramDerivedAddress> {
+	return await getProgramDerivedAddress({
+		programAddress: SEND_LAUNCHPAD_PROGRAM_ADDRESS,
+		seeds: [
+			getBytesEncoder().encode(
+				new Uint8Array([
+					99, 114, 101, 97, 116, 111, 114, 95, 102, 101, 101, 95, 99,
+					111, 110, 102, 105, 103,
+				]),
+			),
+			getAddressEncoder().encode(seeds.baseMint),
+			getAddressEncoder().encode(seeds.quoteMint),
+		],
+	});
+}

package/src/launchpad/generated/pdas/index.ts

@@ -7,6 +7,7 @@
  */
 
 export * from './bondingCurve.js';
+export * from './creatorFeeConfig.js';
 export * from './eventAuthority.js';
 export * from './globalConfig.js';
 export * from './migrationAuthority.js';

package/src/launchpad/generated/plugins/sendLaunchpad.ts

@@ -76,6 +76,7 @@ import {
 } from '../instructions/index.js';
 import {
 	findBondingCurvePda,
+	findCreatorFeeConfigPda,
 	findEventAuthorityPda,
 	findGlobalConfigPda,
 	findMigrationAuthorityPda,
@@ -150,6 +151,7 @@ export type SendLaunchpadPluginInstructions = {
 export type SendLaunchpadPluginPdas = {
 	bondingCurve: typeof findBondingCurvePda;
 	eventAuthority: typeof findEventAuthorityPda;
+	creatorFeeConfig: typeof findCreatorFeeConfigPda;
 	rewardAccrual: typeof findRewardAccrualPda;
 	globalConfig: typeof findGlobalConfigPda;
 	wsolRewardAccrual: typeof findWsolRewardAccrualPda;
@@ -299,6 +301,7 @@ export function sendLaunchpadProgram() {
 				pdas: {
 					bondingCurve: findBondingCurvePda,
 					eventAuthority: findEventAuthorityPda,
+					creatorFeeConfig: findCreatorFeeConfigPda,
 					rewardAccrual: findRewardAccrualPda,
 					globalConfig: findGlobalConfigPda,
 					wsolRewardAccrual: findWsolRewardAccrualPda,

package/src/launchpad/generated/shared/index.ts

@@ -0,0 +1,52 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import type { Address, EncodedAccount, MaybeEncodedAccount } from '@solana/kit';
+
+/** The System Program, which owns every address nobody has created an account at yet. */
+const SYSTEM_PROGRAM_ADDRESS =
+	'11111111111111111111111111111111' as Address<'11111111111111111111111111111111'>;
+
+/**
+ * Whether an encoded account was created on-chain, rather than merely sent lamports.
+ *
+ * Anyone can send lamports to an address before its account is created, which leaves it on-chain,
+ * owned by the System Program, with no data. This returns `false` for that shape, as it does for an
+ * account that does not exist. Any other existing account counts as created, whoever owns it; the
+ * `decode*` functions still check the owner.
+ *
+ * The generated `fetchMaybe*` and `fetchAllMaybe*` helpers apply this rule themselves. Apply it to
+ * accounts you fetch or receive another way (subscriptions, batch loaders, caches) before passing
+ * them to a `decode*` function, which throws for a lamports-only account: an account passed to it as
+ * existing must never come back as the non-existing variant typed as an `Account`.
+ *
+ * Only a `true` result narrows the type. A lamports-only account is still `exists: true` at runtime,
+ * so a `false` result leaves the type unchanged instead of narrowing it to the non-existing variant.
+ * The `uncreated` property in the narrowed type is never present; it exists only to prevent that.
+ *
+ * @example
+ * ```ts
+ * const maybeAccount = decodeMyAccount(
+ *   accountIsCreated(encodedAccount) ? encodedAccount : { address: encodedAccount.address, exists: false },
+ * );
+ * ```
+ */
+export function accountIsCreated<
+	TAccount extends EncodedAccount | MaybeEncodedAccount,
+>(
+	account: TAccount,
+): account is Exclude<TAccount, { readonly exists: false }> & {
+	readonly uncreated?: never;
+} {
+	const maybeAccount: EncodedAccount | MaybeEncodedAccount = account;
+	if ('exists' in maybeAccount && !maybeAccount.exists) return false;
+	return !(
+		maybeAccount.programAddress === SYSTEM_PROGRAM_ADDRESS &&
+		maybeAccount.data.length === 0
+	);
+}

package/src/launchpad/migrate.ts

@@ -1,6 +1,7 @@
 import type { Address, Instruction, TransactionSigner } from '@solana/kit';
 import { TOKEN_2022_PROGRAM_ADDRESS } from '../constants.js';
 import { findAssociatedTokenPda } from '../utils/pda.js';
+import { findCreatorFeeConfigPda as findDexCreatorFeeConfigPda } from '../dex/generated/pdas/creatorFeeConfig.js';
 import { findPoolPda } from '../dex/generated/pdas/pool.js';
 import { findLpMintPda } from '../dex/generated/pdas/lpMint.js';
 import { getMigrateInstructionAsync } from './generated/instructions/migrate.js';
@@ -9,8 +10,6 @@ export interface MigrateParams {
 	caller: TransactionSigner;
 	baseMint: Address;
 	quoteMint: Address;
-	/** `bondingCurve.creatorFeeConfig`; `migrate` rejects any other address. */
-	creatorFeeConfig: Address;
 	quoteTokenProgram: Address;
 }
 
@@ -19,7 +18,7 @@ export async function buildMigrateInstruction(
 ): Promise<Instruction> {
 	const { quoteTokenProgram } = params;
 
-	const [[pool], [lpMint]] = await Promise.all([
+	const [[pool], [lpMint], [dexCreatorFeeConfig]] = await Promise.all([
 		findPoolPda({
 			baseMint: params.baseMint,
 			quoteMint: params.quoteMint,
@@ -28,6 +27,10 @@ export async function buildMigrateInstruction(
 			baseMint: params.baseMint,
 			quoteMint: params.quoteMint,
 		}),
+		findDexCreatorFeeConfigPda({
+			baseMint: params.baseMint,
+			quoteMint: params.quoteMint,
+		}),
 	]);
 
 	const [[poolBaseVault], [poolQuoteVault], [poolLpAccount]] =
@@ -45,7 +48,7 @@ export async function buildMigrateInstruction(
 		caller: params.caller,
 		baseMint: params.baseMint,
 		quoteMint: params.quoteMint,
-		creatorFeeConfig: params.creatorFeeConfig,
+		dexCreatorFeeConfig,
 		poolBaseVault,
 		poolQuoteVault,
 		poolLpAccount,

package/src/launchpad/trade.ts

@@ -19,7 +19,7 @@ export interface LaunchpadTradeParams {
 	partner: PartnerInput;
 	platformConfig: Address;
 	quoteTokenProgram: Address;
-	/** Token-2022 schedule for the epoch the trade lands in; stale or missing skews the slippage bounds. */
+	/** The quote mint's transfer fee for the epoch the trade lands in. A missing or old fee gives wrong slippage bounds. */
 	quoteFee?: MintFee;
 	baseFee?: MintFee;
 	/** {@inheritDoc LaunchpadInstructionParams.userQuoteAccount} */
@@ -40,16 +40,16 @@ export interface LaunchpadInstructionParams {
 	partner: PartnerInput;
 	platformConfig: Address;
 	quoteTokenProgram: Address;
-	/** Any user-owned quote-mint account. Defaults to the ATA, created mid-trade
-	 *  if missing (payer funds rent), which only rescues a sell. For WSOL,
-	 *  a throwaway `createAccountWithSeed` account is cheaper. */
+	/** Any quote-mint token account that `user` owns. Defaults to the user's ATA.
+	 *  The program creates a missing ATA, and `payer` pays the rent. */
 	userQuoteAccount?: Address;
-	/** Any user-owned base-mint account. Defaults to the ATA, created mid-trade
-	 *  if missing (payer funds rent), which only rescues a buy. */
+	/** Any base-mint token account that `user` owns. Defaults to the user's ATA.
+	 *  The program creates a missing ATA, and `payer` pays the rent. */
 	userBaseAccount?: Address;
 }
 
-/** `baseAmountOut` is net to the buyer: the program reads `amount` as `base_to_user`. */
+/** `baseAmountOut` is the base the buyer receives, after the base mint's transfer fee.
+ *  The buy is capped at the curve's supply left. Read the result from `quote.baseToUser`. */
 export async function buyExactOut(
 	params: LaunchpadBuyParams & { baseAmountOut: bigint },
 ): Promise<{ instruction: Instruction; quote: BuyQuote }> {
@@ -62,7 +62,7 @@ export async function buyExactOut(
 		baseFee: params.baseFee,
 		baseReserveCap: params.realBaseReserves,
 	});
-	// The cap is measured on the gross the buyer sends, quote transfer fee included.
+	// The program checks `maxAmountIn` against the gross the buyer sends, quote transfer fee included.
 	const maxQuoteIn = amm.calculateSlippageUp(
 		quote.quoteFromUser,
 		params.slippageBps,
@@ -70,7 +70,7 @@ export async function buyExactOut(
 	return {
 		instruction: await buildBuyExactOutInstruction({
 			...params,
-			// Capped at the supply left. The program reverts a short fill.
+			// Capped at the supply left. The program rejects a larger amount.
 			amountOut: quote.baseToUser,
 			maxAmountIn: maxQuoteIn,
 		}),
@@ -90,7 +90,7 @@ export async function buyExactIn(
 		baseFee: params.baseFee,
 		baseReserveCap: params.realBaseReserves,
 	});
-	// The floor is measured on the buyer's credit, not the vault's debit.
+	// The program checks `minAmountOut` against what the buyer receives, not the vault's debit.
 	const minBaseOut = amm.calculateSlippageDown(
 		quote.baseToUser,
 		params.slippageBps,
@@ -116,7 +116,7 @@ export async function sellExactIn(
 		quoteFee: params.quoteFee,
 		baseFee: params.baseFee,
 	});
-	// The floor is measured on the seller's credit, not what leaves the vault.
+	// The program checks `minAmountOut` against what the seller receives, not the vault's debit.
 	const minQuoteOut = amm.calculateSlippageDown(
 		quote.quoteToUser,
 		params.slippageBps,
@@ -131,7 +131,7 @@ export async function sellExactIn(
 	};
 }
 
-/** `quoteAmountOut` is net to the seller: the program reads `amount` as `quote_to_user`. */
+/** `quoteAmountOut` is the quote the seller receives, after the quote mint's transfer fee. */
 export async function sellExactOut(
 	params: LaunchpadTradeParams & { quoteAmountOut: bigint },
 ): Promise<{ instruction: Instruction; quote: SellQuote }> {
@@ -143,7 +143,7 @@ export async function sellExactOut(
 		quoteFee: params.quoteFee,
 		baseFee: params.baseFee,
 	});
-	// The cap is measured on the gross the seller sends, base transfer fee included.
+	// The program checks `maxAmountIn` against the gross the seller sends, base transfer fee included.
 	const maxBaseIn = amm.calculateSlippageUp(
 		quote.baseFromUser,
 		params.slippageBps,
@@ -214,7 +214,7 @@ export async function buildSellExactOutInstruction(
 	});
 }
 
-/** Percent of the curve's real base sold (0-100); 100 is the migration threshold. */
+/** Returns the percent of the curve's real base sold, from 0 to 100. At 100 the curve can migrate. */
 export function calculateBondingCurveProgress(params: {
 	realBaseReserves: bigint;
 	initialRealBase: bigint;
@@ -237,7 +237,7 @@ function resolveSharedAccounts(params: LaunchpadInstructionParams) {
 		partner: params.partner,
 		platformConfig: params.platformConfig,
 		quoteTokenProgram: params.quoteTokenProgram,
-		// Left undefined so the generated client derives the ATA itself.
+		// When omitted, the generated client derives the ATA.
 		...(params.userQuoteAccount !== undefined && {
 			userQuoteAccount: params.userQuoteAccount,
 		}),