@txnlab/haystack-router 2.0.4 → 3.0.0

package/dist/index.mjs

@@ -1,18 +1,17 @@
-import { t as Logger } from "./logger-DUVOA2Oo.mjs";
-import { Algodv2, AtomicTransactionComposer, LogicSigAccount, Transaction, decodeUnsignedTransaction, isValidAddress, makeApplicationOptInTxnFromObject, makeAssetTransferTxnWithSuggestedParamsFromObject, msgpackRawDecode, signLogicSigTransactionObject, signTransaction } from "algosdk";
-
+import { t as Logger } from "./logger-BelK6H0R.mjs";
+import { Algodv2, AtomicTransactionComposer, LogicSigAccount, TransactionType, decodeUint64, decodeUnsignedTransaction, getApplicationAddress, isValidAddress, makeApplicationOptInTxnFromObject, makeAssetTransferTxnWithSuggestedParamsFromObject, msgpackRawDecode, signLogicSigTransactionObject, signTransaction } from "algosdk";
 //#region src/constants.ts
 /**
 * Supported DEX protocols for swap routing
 */
-let Protocol = /* @__PURE__ */ function(Protocol$1) {
-	Protocol$1["TinymanV2"] = "TinymanV2";
-	Protocol$1["Algofi"] = "Algofi";
-	Protocol$1["Algomint"] = "Algomint";
-	Protocol$1["Pact"] = "Pact";
-	Protocol$1["Folks"] = "Folks";
-	Protocol$1["TAlgo"] = "TAlgo";
-	return Protocol$1;
+let Protocol = /* @__PURE__ */ function(Protocol) {
+	Protocol["TinymanV2"] = "TinymanV2";
+	Protocol["Algofi"] = "Algofi";
+	Protocol["Algomint"] = "Algomint";
+	Protocol["Pact"] = "Pact";
+	Protocol["Folks"] = "Folks";
+	Protocol["TAlgo"] = "TAlgo";
+	return Protocol;
 }({});
 /**
 * Deprecated protocols that are automatically excluded from routing
@@ -42,24 +41,65 @@ const DEFAULT_AUTO_OPT_IN = false;
 const DEFAULT_DEBUG_LEVEL = "none";
 /** Default number of rounds to wait for transaction confirmation */
 const DEFAULT_CONFIRMATION_ROUNDS = 10;
-
+//#endregion
+//#region src/launch.ts
+/**
+* Normalize a quote's raw launch object, coercing amounts to bigint and
+* defaulting the fields the API omits when they don't apply
+*/
+function toSwapLaunchQuote(launch) {
+	return {
+		side: launch.side,
+		tokenNum: launch.tokenNum,
+		bondingTokenId: launch.bondingTokenId,
+		bondingSurplus: BigInt(launch.bondingSurplus),
+		refund: BigInt(launch.refund ?? 0),
+		graduates: launch.graduates ?? false
+	};
+}
 //#endregion
 //#region src/composer.ts
+/** ABI selectors of the HayLaunch bonding-curve buy methods (buyWithLimit, buyWithAlgoWithLimit) */
+const LAUNCH_BUY_SELECTORS = /* @__PURE__ */ new Set(["9068a8d9", "b0e30517"]);
+/** ABI selector of the HayLaunch bonding-curve sell method (sellWithLimit) */
+const LAUNCH_SELL_SELECTOR = "028a0647";
+/** Prefix of the log that carries an ARC-4 method's return value */
+const ARC4_RETURN_PREFIX = "151f7c75";
+/**
+* Returns which side of a HayLaunch bonding-curve trade an app call is, or
+* undefined if it isn't a curve buy or sell call
+*/
+function launchCurveSide(txn) {
+	const selector = txn.applicationCall?.appArgs[0];
+	if (txn.type !== TransactionType.appl || !selector) return void 0;
+	const hex = Buffer.from(selector).toString("hex");
+	if (LAUNCH_BUY_SELECTORS.has(hex)) return "buy";
+	if (hex === LAUNCH_SELL_SELECTOR) return "sell";
+}
+/**
+* Reads a uint64 ARC-4 return value from an app call's logs (the last log,
+* prefixed with 151f7c75)
+*/
+function readUint64Return(logs) {
+	const log = logs?.[logs.length - 1];
+	if (!log || log.length !== 12 || Buffer.from(log.subarray(0, 4)).toString("hex") !== ARC4_RETURN_PREFIX) return;
+	return decodeUint64(log.subarray(4), "bigint");
+}
 /**
 * Status of the SwapComposer transaction group lifecycle
 */
-let SwapComposerStatus = /* @__PURE__ */ function(SwapComposerStatus$1) {
+let SwapComposerStatus = /* @__PURE__ */ function(SwapComposerStatus) {
 	/** The atomic group is still under construction. */
-	SwapComposerStatus$1[SwapComposerStatus$1["BUILDING"] = 0] = "BUILDING";
+	SwapComposerStatus[SwapComposerStatus["BUILDING"] = 0] = "BUILDING";
 	/** The atomic group has been finalized, but not yet signed. */
-	SwapComposerStatus$1[SwapComposerStatus$1["BUILT"] = 1] = "BUILT";
+	SwapComposerStatus[SwapComposerStatus["BUILT"] = 1] = "BUILT";
 	/** The atomic group has been finalized and signed, but not yet submitted to the network. */
-	SwapComposerStatus$1[SwapComposerStatus$1["SIGNED"] = 2] = "SIGNED";
+	SwapComposerStatus[SwapComposerStatus["SIGNED"] = 2] = "SIGNED";
 	/** The atomic group has been finalized, signed, and submitted to the network. */
-	SwapComposerStatus$1[SwapComposerStatus$1["SUBMITTED"] = 3] = "SUBMITTED";
+	SwapComposerStatus[SwapComposerStatus["SUBMITTED"] = 3] = "SUBMITTED";
 	/** The atomic group has been finalized, signed, submitted, and successfully committed to a block. */
-	SwapComposerStatus$1[SwapComposerStatus$1["COMMITTED"] = 4] = "COMMITTED";
-	return SwapComposerStatus$1;
+	SwapComposerStatus[SwapComposerStatus["COMMITTED"] = 4] = "COMMITTED";
+	return SwapComposerStatus;
 }({});
 /**
 * Composer for building and executing atomic swap transaction groups
@@ -96,6 +136,7 @@ var SwapComposer = class SwapComposer {
 	note;
 	inputTransactionIndex;
 	outputTransactionIndex;
+	curveTransactionIndex;
 	/** Summary data built incrementally during swap composition */
 	summaryData;
 	/**
@@ -207,15 +248,16 @@ var SwapComposer = class SwapComposer {
 	*/
 	async addSwapTransactions() {
 		if (this.swapTransactionsAdded) throw new Error("Swap transactions have already been added");
-		if (this.getStatus() !== SwapComposerStatus.BUILDING) throw new Error("Cannot add swap transactions when composer status is not BUILDING");
+		if (this.getStatus() !== 0) throw new Error("Cannot add swap transactions when composer status is not BUILDING");
 		const beforeTxns = await this.executeMiddlewareHooks("beforeSwap");
 		if (this.atc.count() + beforeTxns.length > SwapComposer.MAX_GROUP_SIZE) throw new Error(`Adding beforeSwap transactions exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`);
 		for (const txnWithSigner of beforeTxns) this.atc.addTransaction(txnWithSigner);
-		const { txns: processedTxns, inputTxnRelativeIndex, outputTxnRelativeIndex } = await this.processSwapTransactions();
+		const { txns: processedTxns, inputTxnRelativeIndex, outputTxnRelativeIndex, curveTxnRelativeIndex } = await this.processSwapTransactions();
 		const afterTxns = await this.executeMiddlewareHooks("afterSwap");
 		if (this.atc.count() + processedTxns.length + afterTxns.length > SwapComposer.MAX_GROUP_SIZE) throw new Error(`Adding swap transactions exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`);
 		if (inputTxnRelativeIndex !== void 0) this.inputTransactionIndex = this.atc.count() + inputTxnRelativeIndex;
 		if (outputTxnRelativeIndex !== void 0) this.outputTransactionIndex = this.atc.count() + outputTxnRelativeIndex;
+		if (curveTxnRelativeIndex !== void 0) this.curveTransactionIndex = this.atc.count() + curveTxnRelativeIndex;
 		for (const txnWithSigner of processedTxns) this.atc.addTransaction(txnWithSigner);
 		for (const txnWithSigner of afterTxns) this.atc.addTransaction(txnWithSigner);
 		this.swapTransactionsAdded = true;
@@ -261,7 +303,7 @@ var SwapComposer = class SwapComposer {
 	* ```
 	*/
 	async sign() {
-		if (this.getStatus() >= SwapComposerStatus.SIGNED) return this.atc.gatherSignatures();
+		if (this.getStatus() >= 2) return this.atc.gatherSignatures();
 		if (!this.swapTransactionsAdded) await this.addSwapTransactions();
 		return await this.atc.gatherSignatures();
 	}
@@ -302,13 +344,14 @@ var SwapComposer = class SwapComposer {
 	* console.log('Transaction IDs:', result.txIds)
 	* ```
 	*/
-	async execute(waitRounds = DEFAULT_CONFIRMATION_ROUNDS) {
+	async execute(waitRounds = 10) {
 		try {
 			if (!this.swapTransactionsAdded) await this.addSwapTransactions();
 			const { txIDs, ...result } = await this.atc.execute(this.algodClient, waitRounds);
 			if (this.summaryData) {
 				if (this.inputTransactionIndex !== void 0) this.summaryData.inputTxnId = txIDs[this.inputTransactionIndex];
 				if (this.outputTransactionIndex !== void 0) this.summaryData.outputTxnId = txIDs[this.outputTransactionIndex];
+				if (this.summaryData.launch && this.curveTransactionIndex !== void 0) this.summaryData.launch.curveTxnId = txIDs[this.curveTransactionIndex];
 			}
 			await this.extractActualOutputAmount();
 			return {
@@ -316,7 +359,7 @@ var SwapComposer = class SwapComposer {
 				txIds: txIDs
 			};
 		} catch (error) {
-			const { logSwapExecutionFailure } = await import("./debug-8aRsrfhx.mjs");
+			const { logSwapExecutionFailure } = await import("./debug-CU-Ps4nm.mjs");
 			logSwapExecutionFailure({
 				quote: this.quote,
 				address: this.address,
@@ -357,7 +400,7 @@ var SwapComposer = class SwapComposer {
 	* ```
 	*/
 	getInputTransactionId() {
-		if (this.getStatus() < SwapComposerStatus.BUILT) return;
+		if (this.getStatus() < 1) return;
 		if (this.inputTransactionIndex === void 0) return;
 		return (this.atc.buildGroup()[this.inputTransactionIndex]?.txn)?.txID();
 	}
@@ -388,6 +431,8 @@ var SwapComposer = class SwapComposer {
 		if (!this.summaryData || this.summaryData.outputAmount === void 0 || this.summaryData.inputTxnId === void 0 || this.summaryData.outputTxnId === void 0 || this.summaryData.outputSender === void 0) return;
 		const txns = this.atc.buildGroup();
 		const totalFees = txns.reduce((sum, tws) => sum + tws.txn.fee, 0n);
+		const launch = this.summaryData.launch;
+		const curveTxnId = launch?.curveTxnId;
 		return {
 			inputAssetId: this.summaryData.inputAssetId,
 			outputAssetId: this.summaryData.outputAssetId,
@@ -396,10 +441,17 @@ var SwapComposer = class SwapComposer {
 			type: this.quote.type,
 			totalFees,
 			transactionCount: txns.length,
-			inputTxnId: this.summaryData.inputTxnId,
+			inputTxnId: launch?.side === "sell" && curveTxnId ? curveTxnId : this.summaryData.inputTxnId,
 			outputTxnId: this.summaryData.outputTxnId,
 			inputSender: this.summaryData.inputSender,
-			outputSender: this.summaryData.outputSender
+			outputSender: this.summaryData.outputSender,
+			...launch && curveTxnId && { launch: {
+				side: launch.side,
+				tokenNum: launch.tokenNum,
+				curveTxnId,
+				bondingAmount: launch.bondingAmount,
+				refund: launch.refund
+			} }
 		};
 	}
 	/**
@@ -416,32 +468,25 @@ var SwapComposer = class SwapComposer {
 	*/
 	async processSwapTransactions() {
 		const appOptIns = await this.processRequiredAppOptIns();
-		const swapTxns = [];
-		let inputTxnRelativeIndex;
-		let inputTxn;
-		for (let i = 0; i < this.swapTxns.length; i++) {
-			const swapTxn = this.swapTxns[i];
-			if (!swapTxn) continue;
+		const decoded = this.swapTxns.map((swapTxn, i) => {
 			try {
 				const txn = decodeUnsignedTransaction(Buffer.from(swapTxn.data, "base64"));
 				delete txn.group;
-				if (swapTxn.signature !== false) swapTxns.push({
+				return {
 					txn,
-					signer: this.createSwapSigner(swapTxn.signature)
-				});
-				else {
-					if (this.note !== void 0) txn.note = this.note;
-					inputTxnRelativeIndex = appOptIns.length + swapTxns.length;
-					inputTxn = txn;
-					swapTxns.push({
-						txn,
-						signer: this.defaultSigner
-					});
-				}
+					signature: swapTxn.signature
+				};
 			} catch (error) {
-				throw new Error(`Failed to process swap transaction at index ${i}: ${error instanceof Error ? error.message : String(error)}`);
+				throw new Error(`Failed to process swap transaction at index ${i}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 			}
-		}
+		});
+		const inputIndex = this.findInputTransactionIndex(decoded);
+		const inputTxn = inputIndex !== void 0 ? decoded[inputIndex]?.txn : void 0;
+		if (inputTxn && this.note !== void 0) inputTxn.note = this.note;
+		const swapTxns = decoded.map(({ txn, signature }) => ({
+			txn,
+			signer: signature === false ? this.defaultSigner : this.createSwapSigner(signature)
+		}));
 		if (inputTxn) {
 			const paymentAmount = inputTxn.payment?.amount;
 			const assetTransferAmount = inputTxn.assetTransfer?.amount;
@@ -453,12 +498,63 @@ var SwapComposer = class SwapComposer {
 				inputSender: this.address
 			};
 		}
-		const outputTxnRelativeIndex = swapTxns.length > 0 ? appOptIns.length + swapTxns.length - 1 : void 0;
+		const curveIndex = this.initLaunchSummary(decoded);
+		const outputIndex = this.summaryData?.launch?.side === "buy" && curveIndex !== void 0 ? curveIndex : swapTxns.length - 1;
+		const outputTxnRelativeIndex = outputIndex >= 0 ? appOptIns.length + outputIndex : void 0;
 		return {
 			txns: [...appOptIns, ...swapTxns],
-			inputTxnRelativeIndex,
-			outputTxnRelativeIndex
+			inputTxnRelativeIndex: inputIndex !== void 0 ? appOptIns.length + inputIndex : void 0,
+			outputTxnRelativeIndex,
+			curveTxnRelativeIndex: curveIndex !== void 0 ? appOptIns.length + curveIndex : void 0
+		};
+	}
+	/**
+	* Finds the swap's input transaction: the user's payment or asset transfer
+	* to the router app, whose address comes from the router's pre-signed app
+	* calls. Falls back to the last user-signed transaction for groups without
+	* a router app call.
+	*/
+	findInputTransactionIndex(txns) {
+		const routerAppId = txns.find(({ txn, signature }) => signature !== false && txn.type === TransactionType.appl)?.txn.applicationCall?.appIndex;
+		if (routerAppId !== void 0) {
+			const routerAddress = getApplicationAddress(routerAppId).toString();
+			const index = txns.findIndex(({ txn, signature }) => signature === false && (txn.payment?.receiver ?? txn.assetTransfer?.receiver)?.toString() === routerAddress);
+			if (index !== -1) return index;
+		}
+		for (let i = txns.length - 1; i >= 0; i--) if (txns[i]?.signature === false) return i;
+	}
+	/**
+	* For a launch quote, finds the user-signed curve buy or sell call and
+	* records the curve leg in summaryData. On a sell, the input amount becomes
+	* the launch tokens sold.
+	*
+	* @returns The curve call's index within the swap transactions, if found
+	*/
+	initLaunchSummary(txns) {
+		const side = this.quote.launch?.side;
+		if (!side || !this.summaryData) return void 0;
+		const curveIndex = txns.findIndex(({ txn, signature }) => signature === false && launchCurveSide(txn) === side);
+		const curveCall = txns[curveIndex]?.txn.applicationCall;
+		const tokenNumArg = curveCall?.appArgs[1];
+		if (!curveCall || !tokenNumArg) return void 0;
+		const appAddress = getApplicationAddress(curveCall.appIndex).toString();
+		let bondingAmount;
+		if (side === "buy") {
+			const payment = txns[curveIndex - 1]?.txn;
+			if ((payment?.payment?.receiver ?? payment?.assetTransfer?.receiver)?.toString() === appAddress) bondingAmount = payment?.payment?.amount ?? payment?.assetTransfer?.amount;
+		} else {
+			const tokensToSell = curveCall.appArgs[2];
+			if (tokensToSell) this.summaryData.inputAmount = decodeUint64(tokensToSell, "bigint");
+		}
+		this.summaryData.launch = {
+			side,
+			tokenNum: decodeUint64(tokenNumArg, "bigint"),
+			bondingTokenId: BigInt(this.quote.launch?.bondingTokenId ?? 0),
+			appAddress,
+			bondingAmount,
+			refund: 0n
 		};
+		return curveIndex;
 	}
 	/**
 	* Creates opt-in transactions for apps the user hasn't opted into yet
@@ -502,16 +598,19 @@ var SwapComposer = class SwapComposer {
 		try {
 			if (signature.type === "logic_signature") {
 				const valueArray = signature.value;
-				const decoded = msgpackRawDecode(new Uint8Array(Object.values(valueArray)));
+				const valueBytes = new Uint8Array(Object.values(valueArray));
+				const decoded = msgpackRawDecode(valueBytes);
 				if (!decoded.lsig) throw new Error("Logic signature structure missing lsig field");
 				const lsig = decoded.lsig;
-				return signLogicSigTransactionObject(transaction, new LogicSigAccount(lsig.l, lsig.arg)).blob;
+				const logicSigAccount = new LogicSigAccount(lsig.l, lsig.arg);
+				return signLogicSigTransactionObject(transaction, logicSigAccount).blob;
 			} else if (signature.type === "secret_key") {
 				const valueArray = signature.value;
-				return signTransaction(transaction, new Uint8Array(Object.values(valueArray))).blob;
+				const secretKey = new Uint8Array(Object.values(valueArray));
+				return signTransaction(transaction, secretKey).blob;
 			} else throw new Error(`Unsupported signature type: ${signature.type}`);
 		} catch (error) {
-			throw new Error(`Failed to re-sign transaction: ${error instanceof Error ? error.message : String(error)}`);
+			throw new Error(`Failed to re-sign transaction: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 		}
 	}
 	/**
@@ -523,6 +622,7 @@ var SwapComposer = class SwapComposer {
 			...this.quote,
 			quote: this.quote.quote === "" ? 0n : BigInt(this.quote.quote),
 			amount: 0n,
+			launch: this.quote.launch && toSwapLaunchQuote(this.quote.launch),
 			createdAt: Date.now()
 		};
 		const quoteContext = {
@@ -554,16 +654,32 @@ var SwapComposer = class SwapComposer {
 	* Extract the actual output amount from the confirmed output transaction's inner transactions
 	*
 	* Analyzes only the output transaction (last app call in the swap) to find the
-	* inner transaction that transfers the output asset to the user.
+	* inner transaction that transfers the output asset to the user. On a launch
+	* buy the output is a balance on the HayLaunch app, so it is read from the
+	* curve buy call's return value instead.
 	*/
 	async extractActualOutputAmount() {
 		if (!this.summaryData?.outputTxnId) return;
 		const outputAssetId = this.summaryData.outputAssetId;
 		const userAddress = this.address;
+		const launch = this.summaryData.launch;
 		try {
-			const innerTxns = (await this.algodClient.pendingTransactionInformation(this.summaryData.outputTxnId).do()).innerTxns;
-			if (!innerTxns) return;
-			for (const innerTxn of innerTxns) {
+			const pendingInfo = await this.algodClient.pendingTransactionInformation(this.summaryData.outputTxnId).do();
+			if (launch?.side === "buy") {
+				const tokensCredited = readUint64Return(pendingInfo.logs);
+				if (tokensCredited !== void 0) {
+					this.summaryData.outputAmount = tokensCredited;
+					this.summaryData.outputSender = launch.appAddress;
+				}
+				for (const innerTxn of pendingInfo.innerTxns ?? []) {
+					const txn = innerTxn.txn.txn;
+					if (launch.bondingTokenId === 0n) {
+						if (txn.payment?.receiver.toString() === userAddress) launch.refund += txn.payment.amount;
+					} else if (txn.assetTransfer?.receiver.toString() === userAddress && txn.assetTransfer.assetIndex === launch.bondingTokenId) launch.refund += txn.assetTransfer.amount;
+				}
+				return;
+			}
+			for (const innerTxn of pendingInfo.innerTxns ?? []) {
 				const txn = innerTxn.txn.txn;
 				const payment = txn.payment;
 				const assetTransfer = txn.assetTransfer;
@@ -582,15 +698,20 @@ var SwapComposer = class SwapComposer {
 				}
 			}
 		} catch {}
+		if (launch?.side === "sell" && launch.curveTxnId) try {
+			launch.bondingAmount = readUint64Return((await this.algodClient.pendingTransactionInformation(launch.curveTxnId).do()).logs);
+		} catch {}
 	}
 };
-
 //#endregion
 //#region src/utils.ts
 /**
 * HTTP error with status code and response data
 */
 var HTTPError = class extends Error {
+	status;
+	statusText;
+	data;
 	constructor(status, statusText, data) {
 		super(`HTTP ${status} ${statusText}`);
 		this.status = status;
@@ -627,7 +748,6 @@ async function request(url, options) {
 	}
 	return response.json();
 }
-
 //#endregion
 //#region src/client.ts
 /**
@@ -640,14 +760,14 @@ async function request(url, options) {
 * @example
 * ```typescript
 * const router = new RouterClient({
-*   apiKey: 'your-api-key',
+*   apiKey: '1b72df7e-1131-4449-8ce1-29b79dd3f51e', // Free tier (60 requests/min)
 * })
 * ```
 *
 * @example
 * ```typescript
 * const router = new RouterClient({
-*   apiKey: 'your-api-key',
+*   apiKey: '1b72df7e-1131-4449-8ce1-29b79dd3f51e', // Free tier (60 requests/min)
 *   apiBaseUrl: 'https://hayrouter.txnlab.dev',
 *   algodUri: 'https://mainnet-api.4160.nodely.dev/',
 *   algodToken: '',
@@ -678,17 +798,17 @@ var RouterClient = class {
 	* @param config.middleware - Array of middleware to apply to swaps (default: [])
 	*/
 	constructor(config) {
-		const debugLevel = config.debugLevel ?? DEFAULT_DEBUG_LEVEL;
+		const debugLevel = config.debugLevel ?? "none";
 		Logger.setLevel(debugLevel);
 		this.config = {
 			apiKey: this.validateApiKey(config.apiKey),
-			apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL,
-			algodUri: config.algodUri ?? DEFAULT_ALGOD_URI,
-			algodToken: config.algodToken ?? DEFAULT_ALGOD_TOKEN,
-			algodPort: config.algodPort ?? DEFAULT_ALGOD_PORT,
+			apiBaseUrl: config.apiBaseUrl ?? "https://hayrouter.txnlab.dev/api",
+			algodUri: config.algodUri ?? "https://mainnet-api.4160.nodely.dev/",
+			algodToken: config.algodToken ?? "",
+			algodPort: config.algodPort ?? 443,
 			referrerAddress: config.referrerAddress ? this.validateAddress(config.referrerAddress) : void 0,
-			feeBps: this.validateFeeBps(config.feeBps ?? DEFAULT_FEE_BPS),
-			autoOptIn: config.autoOptIn ?? DEFAULT_AUTO_OPT_IN,
+			feeBps: this.validateFeeBps(config.feeBps ?? 10),
+			autoOptIn: config.autoOptIn ?? false,
 			debugLevel
 		};
 		this.algodClient = new Algodv2(this.config.algodToken, this.config.algodUri, this.config.algodPort);
@@ -713,6 +833,7 @@ var RouterClient = class {
 	*   - If true: API reduces maxGroupSize by 1 and includes opt-in (always included, even if not needed)
 	*   - If false: No opt-in transaction included
 	*   - If undefined: Falls back to `config.autoOptIn` behavior with account check (if `params.address` is provided)
+	* @param params.slippage - Slippage tolerance as a percentage, in [0, 100). Pass the value you will execute with; required for accurate pre-bonding launch token quotes
 	* @returns A FetchQuoteResponse object with routing information
 	*
 	* @example
@@ -726,12 +847,15 @@ var RouterClient = class {
 	* ```
 	*/
 	async fetchQuote(params) {
-		const { fromASAID, toASAID, amount, type = "fixed-input", disabledProtocols = [], maxGroupSize = DEFAULT_MAX_GROUP_SIZE, maxDepth = DEFAULT_MAX_DEPTH, optIn, address, _allowNonComposableSwaps = false } = params;
+		const { fromASAID, toASAID, amount, type = "fixed-input", disabledProtocols = [], maxGroupSize = 16, maxDepth = 4, optIn, address, slippage, _allowNonComposableSwaps = false } = params;
+		if (slippage !== void 0) this.validateSlippage(slippage);
 		if (_allowNonComposableSwaps && (optIn === true || this.config.autoOptIn)) throw new Error("Cannot use _allowNonComposableSwaps with optIn or autoOptIn. When allowing non-composable swaps (Tinyman v1), you must handle asset opt-ins and opt-outs in separate transaction groups.");
-		const allDisabledProtocols = _allowNonComposableSwaps ? [...new Set(["Humble", ...disabledProtocols])] : [...new Set([...DEPRECATED_PROTOCOLS, ...disabledProtocols])];
+		const allDisabledProtocols = _allowNonComposableSwaps ? [.../* @__PURE__ */ new Set(["Humble", ...disabledProtocols])] : [.../* @__PURE__ */ new Set([...DEPRECATED_PROTOCOLS, ...disabledProtocols])];
 		let includeOptIn = optIn;
-		if (includeOptIn === void 0 && this.config.autoOptIn) if (address) includeOptIn = await this.needsAssetOptIn(this.validateAddress(address), toASAID);
-		else console.warn("autoOptIn is enabled but no address provided to fetchQuote(). Asset opt-in check skipped.");
+		if (includeOptIn === void 0 && this.config.autoOptIn) {
+			if (address) includeOptIn = await this.needsAssetOptIn(this.validateAddress(address), toASAID);
+			else console.warn("autoOptIn is enabled but no address provided to fetchQuote(). Asset opt-in check skipped.");
+		}
 		const url = new URL(`${this.config.apiBaseUrl}/fetchQuote`);
 		url.searchParams.append("apiKey", this.config.apiKey);
 		url.searchParams.append("algodUri", this.config.algodUri);
@@ -746,6 +870,7 @@ var RouterClient = class {
 		url.searchParams.append("maxGroupSize", maxGroupSize.toString());
 		url.searchParams.append("maxDepth", maxDepth.toString());
 		if (typeof includeOptIn === "boolean") url.searchParams.append("optIn", String(includeOptIn));
+		if (slippage !== void 0) url.searchParams.append("slippage", String(slippage));
 		if (this.config.referrerAddress) url.searchParams.append("referrerAddress", this.config.referrerAddress);
 		return request(url.toString());
 	}
@@ -824,6 +949,7 @@ var RouterClient = class {
 	* @param params.maxDepth - The maximum depth (default: 4)
 	* @param params.address - The address of the account that will perform the swap (recommended when using `config.autoOptIn` or `params.optIn`)
 	* @param params.optIn - Whether to include asset opt-in transaction
+	* @param params.slippage - Slippage tolerance as a percentage, in [0, 100). Pass the value you will execute with; required for accurate pre-bonding launch token quotes
 	* @returns A SwapQuote enhanced quote result
 	*
 	* @example
@@ -855,11 +981,14 @@ var RouterClient = class {
 		};
 		for (const mw of this.middleware) if (await mw.shouldApply(quoteContext) && mw.adjustQuoteParams) adjustedParams = await mw.adjustQuoteParams(adjustedParams);
 		const response = await this.fetchQuote(adjustedParams);
+		const { launch, ...rest } = response;
 		return {
-			...response,
+			...rest,
 			quote: response.quote === "" ? 0n : BigInt(response.quote),
 			amount: BigInt(params.amount),
 			address: params.address ?? void 0,
+			slippage: adjustedParams.slippage,
+			launch: launch && toSwapLaunchQuote(launch),
 			createdAt: Date.now()
 		};
 	}
@@ -913,6 +1042,7 @@ var RouterClient = class {
 	*/
 	async newSwap(config) {
 		const { quote, address, slippage, signer, note } = config;
+		if (quote.launch && "createdAt" in quote && quote.slippage !== slippage) console.warn(quote.slippage === void 0 ? `Launch token quote was fetched without slippage but the swap uses ${slippage}%. Pass the same slippage to newQuote() for an accurate quoted output.` : `Launch token quote was fetched with ${quote.slippage}% slippage but the swap uses ${slippage}%. The quoted output may not match what is delivered.`);
 		return new SwapComposer({
 			quote,
 			swapTxns: (await this.fetchSwapTransactions({
@@ -943,14 +1073,20 @@ var RouterClient = class {
 		return address;
 	}
 	/**
+	* Validates a slippage percentage (0 <= slippage < 100)
+	*/
+	validateSlippage(slippage) {
+		if (!Number.isFinite(slippage) || slippage < 0 || slippage >= 100) throw new Error(`Invalid slippage: ${slippage} (must be >= 0 and < 100)`);
+		return slippage;
+	}
+	/**
 	* Validates the fee in basis points (max 300 = 3.00%)
 	*/
 	validateFeeBps(feeBps) {
-		if (feeBps < 0 || feeBps > MAX_FEE_BPS) throw new Error(`Invalid fee: ${feeBps} basis points (must be between 0 and ${MAX_FEE_BPS})`);
+		if (feeBps < 0 || feeBps > 300) throw new Error(`Invalid fee: ${feeBps} basis points (must be between 0 and 300)`);
 		return feeBps;
 	}
 };
-
 //#endregion
 //#region src/middleware.ts
 /**
@@ -966,7 +1102,7 @@ var RouterClient = class {
 * })
 *
 * const router = new RouterClient({
-*   apiKey: 'your-api-key',
+*   apiKey: '1b72df7e-1131-4449-8ce1-29b79dd3f51e', // Free tier (60 requests/min)
 *   middleware: [autoOptOut],
 * })
 *
@@ -1022,7 +1158,7 @@ var AutoOptOutMiddleware = class {
 		}];
 	}
 };
-
 //#endregion
 export { AutoOptOutMiddleware, DEFAULT_ALGOD_PORT, DEFAULT_ALGOD_TOKEN, DEFAULT_ALGOD_URI, DEFAULT_API_BASE_URL, DEFAULT_AUTO_OPT_IN, DEFAULT_CONFIRMATION_ROUNDS, DEFAULT_DEBUG_LEVEL, DEFAULT_FEE_BPS, DEFAULT_MAX_DEPTH, DEFAULT_MAX_GROUP_SIZE, DEPRECATED_PROTOCOLS, HTTPError, MAX_FEE_BPS, Protocol, RouterClient, SwapComposer, SwapComposerStatus, request };
+
 //# sourceMappingURL=index.mjs.map