@txnlab/haystack-router 2.0.5 → 3.1.0

package/README.md

@@ -26,7 +26,7 @@ TypeScript/JavaScript SDK for [Haystack Order Router](https://txnlab.gitbook.io/
 npm install @txnlab/haystack-router algosdk
 ```
 
-> **Note**: `algosdk` is a peer dependency and must be installed alongside `@txnlab/haystack-router`.
+> **Note**: Requires Node.js 22 or later. `algosdk` is a peer dependency and must be installed alongside `@txnlab/haystack-router`.
 
 ## Quick Start
 
@@ -149,6 +149,41 @@ console.log('Input transaction ID:', inputTxId)
 
 The `note` is applied only to the user-signed payment or asset transfer transaction (not pre-signed or middleware transactions). The transaction ID is available after calling `buildGroup()`, `sign()`, or `execute()`.
 
+### Launch Tokens (Pre-Bonding)
+
+API keys with launch-token access can swap any asset into or out of a HayLaunch token that is still on its bonding curve. Quote it like any other asset, as a `fixed-input` swap, and pass the same `slippage` you will execute with:
+
+```typescript
+const quote = await router.newQuote({
+  fromASAID: 31566704, // USDC
+  toASAID: launchTokenAssetId, // pre-bonding launch token
+  amount: 10_000_000,
+  slippage: 1, // same value as newSwap() below
+  address: activeAddress,
+})
+
+if (quote.launch) {
+  // quote.quote: launch tokens out (buy) or output asset (sell)
+  // quote.launch.bondingSurplus: bonding asset left in the wallet
+  // quote.launch.refund: bonding asset refunded when a buy completes bonding
+}
+
+const swap = await router.newSwap({
+  quote,
+  address: activeAddress,
+  signer: transactionSigner,
+  slippage: 1,
+})
+await swap.execute()
+
+const summary = swap.getSummary()
+// summary.outputAmount: launch tokens credited (buy)
+// summary.inputAmount: launch tokens sold (sell)
+// summary.launch: the curve call's ID, bonding amount and refund
+```
+
+Without `slippage`, a launch quote overstates the output by about the slippage; `newSwap()` logs a warning when the two don't match. Fixed-output launch buys and launch-token-to-launch-token swaps aren't supported yet and return a 400.
+
 ### Transaction Signing
 
 The SDK supports both standard `algosdk.TransactionSigner` and ARC-1 compliant signer functions.
@@ -409,6 +444,7 @@ async newQuote(params: FetchQuoteParams): Promise<SwapQuote>
 | `maxGroupSize`      | Maximum transactions in atomic group       | `number`                          | `16`            |
 | `maxDepth`          | Maximum swap hops                          | `number`                          | `4`             |
 | `optIn`             | Override auto opt-in behavior              | `boolean`                         | `undefined`     |
+| `slippage`          | Slippage % you will execute with, in [0, 100); required for accurate launch token quotes | `number` | `undefined` |
 
 #### RouterClient.newSwap()
 
@@ -450,6 +486,8 @@ Plain object returned by [`newQuote()`](#routerclientnewquote). Extends the raw
 | `quote`     | Quoted amount (coerced to `bigint`) | `bigint`              |
 | `amount`    | Original request amount             | `bigint`              |
 | `address`   | User address (if provided)          | `string \| undefined` |
+| `slippage`  | Slippage sent with the quote request (if provided) | `number \| undefined` |
+| `launch`    | Bonding-curve details for a pre-bonding launch token (amounts as `bigint`) | `SwapLaunchQuote \| undefined` |
 | `createdAt` | Timestamp when quote was created    | `number`              |
 
 **All properties from API response:**

package/dist/{debug-HbNpLAoU.mjs → debug-CIH6Nv9G.mjs}

@@ -1,6 +1,5 @@
-import { t as Logger } from "./logger-DUVOA2Oo.mjs";
-
-//#region src/debug.ts
+import { t as Logger } from "./logger-BtesQ-um.mjs";
+// src/debug.ts
 /**
 * Debug utilities for swap execution failures
 * @internal
@@ -33,7 +32,6 @@ function logSwapExecutionFailure(context, error) {
 		}
 	});
 }
-
-//#endregion
 export { logSwapExecutionFailure };
-//# sourceMappingURL=debug-HbNpLAoU.mjs.map
+
+//# sourceMappingURL=debug-CIH6Nv9G.mjs.map

package/dist/{debug-HbNpLAoU.mjs.map → debug-CIH6Nv9G.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"debug-HbNpLAoU.mjs","names":[],"sources":["../src/debug.ts"],"sourcesContent":["/**\n * Debug utilities for swap execution failures\n * @internal\n */\n\nimport { Logger } from './logger'\nimport type { SwapQuote, FetchQuoteResponse } from './types'\n\n/**\n * Context for swap execution debugging\n */\nexport interface SwapExecutionContext {\n  quote: SwapQuote | FetchQuoteResponse\n  address: string\n  slippage: number\n  transactionCount: number\n  middlewareCount: number\n  groupSize: number\n}\n\n/**\n * Log detailed context when a swap execution fails\n * Only logs when debug level is enabled\n */\nexport function logSwapExecutionFailure(\n  context: SwapExecutionContext,\n  error: unknown,\n): void {\n  Logger.debug('Swap execution failed', {\n    error: error instanceof Error ? error.message : String(error),\n    quote: {\n      fromASAID: context.quote.fromASAID,\n      toASAID: context.quote.toASAID,\n      type: context.quote.type,\n      amount:\n        'amount' in context.quote ? context.quote.amount.toString() : undefined,\n      quote: context.quote.quote.toString(),\n      requiredAppOptIns: context.quote.requiredAppOptIns,\n      route: context.quote.route?.map((r) => ({\n        percentage: r.percentage,\n        path: r.path.map((p) => p.name).join(' → '),\n      })),\n    },\n    swap: {\n      address: context.address,\n      slippage: context.slippage,\n      transactionCount: context.transactionCount,\n      middlewareCount: context.middlewareCount,\n      groupSize: context.groupSize,\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,wBACd,SACA,OACM;AACN,QAAO,MAAM,yBAAyB;EACpC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;EAC7D,OAAO;GACL,WAAW,QAAQ,MAAM;GACzB,SAAS,QAAQ,MAAM;GACvB,MAAM,QAAQ,MAAM;GACpB,QACE,YAAY,QAAQ,QAAQ,QAAQ,MAAM,OAAO,UAAU,GAAG;GAChE,OAAO,QAAQ,MAAM,MAAM,UAAU;GACrC,mBAAmB,QAAQ,MAAM;GACjC,OAAO,QAAQ,MAAM,OAAO,KAAK,OAAO;IACtC,YAAY,EAAE;IACd,MAAM,EAAE,KAAK,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,MAAM;IAC5C,EAAE;GACJ;EACD,MAAM;GACJ,SAAS,QAAQ;GACjB,UAAU,QAAQ;GAClB,kBAAkB,QAAQ;GAC1B,iBAAiB,QAAQ;GACzB,WAAW,QAAQ;GACpB;EACF,CAAC"}
+{"version":3,"file":"debug-CIH6Nv9G.mjs","names":[],"sources":["../src/debug.ts"],"sourcesContent":["/**\n * Debug utilities for swap execution failures\n * @internal\n */\n\nimport { Logger } from './logger'\nimport type { SwapQuote, FetchQuoteResponse } from './types'\n\n/**\n * Context for swap execution debugging\n */\nexport interface SwapExecutionContext {\n  quote: SwapQuote | FetchQuoteResponse\n  address: string\n  slippage: number\n  transactionCount: number\n  middlewareCount: number\n  groupSize: number\n}\n\n/**\n * Log detailed context when a swap execution fails\n * Only logs when debug level is enabled\n */\nexport function logSwapExecutionFailure(\n  context: SwapExecutionContext,\n  error: unknown,\n): void {\n  Logger.debug('Swap execution failed', {\n    error: error instanceof Error ? error.message : String(error),\n    quote: {\n      fromASAID: context.quote.fromASAID,\n      toASAID: context.quote.toASAID,\n      type: context.quote.type,\n      amount:\n        'amount' in context.quote ? context.quote.amount.toString() : undefined,\n      quote: context.quote.quote.toString(),\n      requiredAppOptIns: context.quote.requiredAppOptIns,\n      route: context.quote.route?.map((r) => ({\n        percentage: r.percentage,\n        path: r.path.map((p) => p.name).join(' → '),\n      })),\n    },\n    swap: {\n      address: context.address,\n      slippage: context.slippage,\n      transactionCount: context.transactionCount,\n      middlewareCount: context.middlewareCount,\n      groupSize: context.groupSize,\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,wBACd,SACA,OACM;CACN,OAAO,MAAM,yBAAyB;EACpC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAC5D,OAAO;GACL,WAAW,QAAQ,MAAM;GACzB,SAAS,QAAQ,MAAM;GACvB,MAAM,QAAQ,MAAM;GACpB,QACE,YAAY,QAAQ,QAAQ,QAAQ,MAAM,OAAO,SAAS,IAAI,KAAA;GAChE,OAAO,QAAQ,MAAM,MAAM,SAAS;GACpC,mBAAmB,QAAQ,MAAM;GACjC,OAAO,QAAQ,MAAM,OAAO,KAAK,OAAO;IACtC,YAAY,EAAE;IACd,MAAM,EAAE,KAAK,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK;GAC5C,EAAE;EACJ;EACA,MAAM;GACJ,SAAS,QAAQ;GACjB,UAAU,QAAQ;GAClB,kBAAkB,QAAQ;GAC1B,iBAAiB,QAAQ;GACzB,WAAW,QAAQ;EACrB;CACF,CAAC;AACH"}

package/dist/index.d.mts

@@ -1,51 +1,48 @@
 import { ABIArgument, ABIMethod, ABIResult, Address, Algodv2, BoxReference, OnApplicationComplete, ResourceReference, SuggestedParams, Transaction, TransactionSigner, TransactionWithSigner } from "algosdk";
-
-//#region src/constants.d.ts
 /**
  * Supported DEX protocols for swap routing
  */
-declare enum Protocol {
+export declare enum Protocol {
   TinymanV2 = "TinymanV2",
+  Humble = "Humble",
   Algofi = "Algofi",
   Algomint = "Algomint",
   Pact = "Pact",
   Folks = "Folks",
-  TAlgo = "TAlgo",
+  TAlgo = "TAlgo"
 }
 /**
  * Deprecated protocols that are automatically excluded from routing
  *
  * @internal
  */
-declare const DEPRECATED_PROTOCOLS: readonly ["Humble", "Tinyman"];
+export declare const DEPRECATED_PROTOCOLS: readonly ["Tinyman"];
 /** Default Algod node URI for mainnet */
-declare const DEFAULT_ALGOD_URI = "https://mainnet-api.4160.nodely.dev/";
+export declare const DEFAULT_ALGOD_URI = "https://mainnet-api.4160.nodely.dev/";
 /** Default Algod node token (empty for public nodes) */
-declare const DEFAULT_ALGOD_TOKEN = "";
+export declare const DEFAULT_ALGOD_TOKEN = "";
 /** Default Algod node port */
-declare const DEFAULT_ALGOD_PORT = 443;
+export declare const DEFAULT_ALGOD_PORT = 443;
 /** Default Haystack Router API base URL */
-declare const DEFAULT_API_BASE_URL = "https://hayrouter.txnlab.dev/api";
+export declare const DEFAULT_API_BASE_URL = "https://hayrouter.txnlab.dev/api";
 /** Default fee in basis points (0.10%) */
-declare const DEFAULT_FEE_BPS = 10;
+export declare const DEFAULT_FEE_BPS = 10;
 /** Maximum allowed fee in basis points (3.00%) */
-declare const MAX_FEE_BPS = 300;
+export declare const MAX_FEE_BPS = 300;
 /** Default maximum transaction group size */
-declare const DEFAULT_MAX_GROUP_SIZE = 16;
+export declare const DEFAULT_MAX_GROUP_SIZE = 16;
 /** Default maximum routing depth (number of hops) */
-declare const DEFAULT_MAX_DEPTH = 4;
+export declare const DEFAULT_MAX_DEPTH = 4;
 /** Default auto opt-in setting (automatic asset/app opt-in detection) */
-declare const DEFAULT_AUTO_OPT_IN = false;
+export declare const DEFAULT_AUTO_OPT_IN = false;
 /** Default debug level (no debug logging) */
-declare const DEFAULT_DEBUG_LEVEL: "none";
+export declare const DEFAULT_DEBUG_LEVEL: "none";
 /** Default number of rounds to wait for transaction confirmation */
-declare const DEFAULT_CONFIRMATION_ROUNDS = 10;
-//#endregion
-//#region src/types.d.ts
+export declare const DEFAULT_CONFIRMATION_ROUNDS = 10;
 /**
  * Configuration parameters for initializing RouterClient
  */
-interface ConfigParams {
+export interface ConfigParams {
   /** API key for Haystack Router API (required) */
   readonly apiKey: string;
   /** Base URL for the Haystack Router API (default: https://hayrouter.txnlab.dev) */
@@ -77,18 +74,18 @@ interface ConfigParams {
  *
  * @internal
  */
-type Config = Omit<Required<ConfigParams>, 'referrerAddress' | 'debugLevel'> & {
+export type Config = Omit<Required<ConfigParams>, 'referrerAddress' | 'debugLevel'> & {
   readonly referrerAddress: string | undefined;
   readonly debugLevel: 'none' | 'info' | 'debug' | 'trace';
 };
 /**
  * Swap quote type determining which amount is fixed
  */
-type QuoteType = 'fixed-input' | 'fixed-output';
+export type QuoteType = 'fixed-input' | 'fixed-output';
 /**
  * Parameters for requesting a swap quote from the Haystack Router API (raw API method)
  */
-interface FetchQuoteParams {
+export interface FetchQuoteParams {
   /** Input asset ID */
   readonly fromASAID: bigint | number;
   /** Output asset ID */
@@ -107,6 +104,15 @@ interface FetchQuoteParams {
   readonly optIn?: boolean;
   /** Address of the account that will perform the swap (required if autoOptIn is enabled) */
   readonly address?: string | null;
+  /**
+   * Slippage tolerance as a percentage (e.g., 1 for 1%), in [0, 100)
+   *
+   * Pass the same value you will pass to `newSwap()`. Quotes for pre-bonding
+   * HayLaunch tokens use it to price the bonding curve on the amount the route
+   * actually pays it; without it, those quotes overstate the output by about
+   * the slippage. Other quotes ignore it.
+   */
+  readonly slippage?: number;
   /**
    * ⚠️ **ADVANCED USE ONLY - NON-COMPOSABLE SWAPS** ⚠️
    *
@@ -138,7 +144,7 @@ interface FetchQuoteParams {
 /**
  * Asset information from the Haystack Router API
  */
-interface Asset {
+export interface Asset {
   /** Asset ID */
   readonly id: number;
   /** Number of decimal places */
@@ -155,7 +161,7 @@ interface Asset {
 /**
  * Profit information for a swap
  */
-interface Profit {
+export interface Profit {
   /** Profit amount in base units */
   readonly amount: number;
   /** The asset in which profit is denominated */
@@ -164,7 +170,7 @@ interface Profit {
 /**
  * A single step in a swap route path
  */
-interface PathElement {
+export interface PathElement {
   /** Protocol name and fee tier */
   readonly name: string;
   /** Protocol class identifier */
@@ -177,7 +183,7 @@ interface PathElement {
 /**
  * A route with its percentage of the total swap amount
  */
-interface Route {
+export interface Route {
   /** Percentage of total swap amount routed through this path */
   readonly percentage: number;
   /** The sequence of swaps in this route */
@@ -186,7 +192,7 @@ interface Route {
 /**
  * Quote from a specific DEX protocol
  */
-interface DexQuote {
+export interface DexQuote {
   /** Protocol name and fee tier */
   readonly name: string;
   /** Protocol class */
@@ -197,16 +203,46 @@ interface DexQuote {
 /**
  * Encrypted transaction payload from the quote
  */
-interface TxnPayload {
+export interface TxnPayload {
   /** Initialization vector for decryption */
   readonly iv: string;
   /** Encrypted transaction data */
   readonly data: string;
 }
+/**
+ * Bonding-curve details for a quote that buys or sells a pre-bonding HayLaunch token
+ *
+ * Amounts are in base units of the bonding asset.
+ */
+export interface LaunchQuote {
+  /** `'buy'` when the launch token is the output, `'sell'` when it is the input */
+  readonly side: 'buy' | 'sell';
+  /** HayLaunch token number */
+  readonly tokenNum: number;
+  /** Asset the token is bonded in (0 for ALGO) */
+  readonly bondingTokenId: number;
+  /** Bonding asset expected to be left in the wallet after the trade */
+  readonly bondingSurplus: number;
+  /** Bonding asset refunded when a buy completes bonding (omitted otherwise) */
+  readonly refund?: number;
+  /** Whether a buy completes bonding (omitted otherwise) */
+  readonly graduates?: boolean;
+}
+/**
+ * Normalized bonding-curve details on a SwapQuote, with amounts coerced to bigint
+ */
+export type SwapLaunchQuote = Omit<LaunchQuote, 'bondingSurplus' | 'refund' | 'graduates'> & {
+  /** Bonding asset expected to be left in the wallet after the trade */
+  readonly bondingSurplus: bigint;
+  /** Bonding asset refunded when a buy completes bonding (0n otherwise) */
+  readonly refund: bigint;
+  /** Whether a buy completes bonding */
+  readonly graduates: boolean;
+};
 /**
  * Quote response from the Haystack Router API
  */
-interface FetchQuoteResponse {
+export interface FetchQuoteResponse {
   /** The quoted output amount or input amount (depending on quote type) */
   readonly quote: string | number;
   /** Profit information for the swap */
@@ -241,13 +277,18 @@ interface FetchQuoteResponse {
   readonly type: string;
   /** Performance timing data */
   readonly timing?: unknown;
+  /**
+   * Bonding-curve details, present only when one side is a pre-bonding HayLaunch token.
+   * For a buy, `quote` is launch tokens out; for a sell, it is the output asset.
+   */
+  readonly launch?: LaunchQuote;
 }
 /**
  * Enhanced quote result returned by RouterClient.newQuote()
  *
  * Extends the raw API response with additional metadata and type normalization.
  */
-type SwapQuote = Omit<FetchQuoteResponse, 'quote'> & {
+export type SwapQuote = Omit<FetchQuoteResponse, 'quote' | 'launch'> & {
   /**
    * The quoted output amount or input amount (coerced to bigint)
    *
@@ -259,13 +300,17 @@ type SwapQuote = Omit<FetchQuoteResponse, 'quote'> & {
   readonly amount: bigint;
   /** The address parameter from the quote request (if provided) */
   readonly address?: string;
+  /** The slippage sent with the quote request (if provided) */
+  readonly slippage?: number;
+  /** Bonding-curve details, present only when one side is a pre-bonding HayLaunch token */
+  readonly launch?: SwapLaunchQuote;
   /** Timestamp when the quote was created (in milliseconds) */
   readonly createdAt: number;
 };
 /**
  * Transaction signature from the Haystack Router API
  */
-interface Signature {
+export interface Signature {
   /** Signature type */
   readonly type: 'logic_signature' | 'secret_key';
   /** Signature data */
@@ -274,7 +319,7 @@ interface Signature {
 /**
  * Transaction data from the Haystack Router API
  */
-interface SwapTransaction {
+export interface SwapTransaction {
   /** Base64-encoded transaction data */
   readonly data: string;
   /** Group ID for the transaction */
@@ -287,7 +332,7 @@ interface SwapTransaction {
 /**
  * Parameters for fetching executable swap transactions
  */
-interface FetchSwapTxnsParams {
+export interface FetchSwapTxnsParams {
   /** Quote response from fetchQuote() or newQuote() */
   readonly quote: FetchQuoteResponse | SwapQuote;
   /** Algorand address that will sign the transactions */
@@ -300,7 +345,7 @@ interface FetchSwapTxnsParams {
  *
  * @internal
  */
-interface FetchSwapTxnsBody {
+export interface FetchSwapTxnsBody {
   /** API key for authentication */
   readonly apiKey: string;
   /** Address of the account that will sign the transactions */
@@ -313,24 +358,49 @@ interface FetchSwapTxnsBody {
 /**
  * Response from fetching swap transactions
  */
-interface FetchSwapTxnsResponse {
+export interface FetchSwapTxnsResponse {
   /** Array of transaction data */
   readonly txns: SwapTransaction[];
 }
+/**
+ * Bonding-curve leg of an executed pre-bonding HayLaunch swap
+ */
+export interface LaunchSummary {
+  /** `'buy'` when the launch token was the output, `'sell'` when it was the input */
+  side: 'buy' | 'sell';
+  /** HayLaunch token number */
+  tokenNum: bigint;
+  /** Transaction ID of the curve buy or sell call */
+  curveTxnId: string;
+  /**
+   * Bonding asset that went through the curve, in base units: the payment into
+   * the curve on a buy, or the curve's payout on a sell. Undefined if it
+   * couldn't be determined.
+   */
+  bondingAmount?: bigint;
+  /** Bonding asset refunded by a buy that completed bonding (0n otherwise) */
+  refund: bigint;
+}
 /**
  * Summary of a swap transaction group after execution
  *
  * Contains the exact input/output amounts and total transaction fees.
  * Only available after calling execute() on a SwapComposer instance.
  */
-interface SwapSummary {
+export interface SwapSummary {
   /** Input asset ID (0 for ALGO) */
   inputAssetId: bigint;
   /** Output asset ID (0 for ALGO) */
   outputAssetId: bigint;
-  /** Exact input amount in base units, from the user-signed transaction */
+  /**
+   * Exact input amount in base units, from the user-signed transaction.
+   * For a launch sell, the launch tokens sold.
+   */
   inputAmount: bigint;
-  /** Exact output amount received in base units, from the inner transaction */
+  /**
+   * Exact output amount received in base units, from the inner transaction.
+   * For a launch buy, the launch tokens credited by the curve.
+   */
   outputAmount: bigint;
   /** Quote type */
   type: QuoteType;
@@ -338,19 +408,27 @@ interface SwapSummary {
   totalFees: bigint;
   /** Number of transactions in the group */
   transactionCount: number;
-  /** Transaction ID of the user-signed input transaction (payment/asset transfer) */
+  /**
+   * Transaction ID of the user-signed input transaction (payment/asset transfer).
+   * For a launch sell, the curve sell call.
+   */
   inputTxnId: string;
-  /** Transaction ID of the app call containing the output transfer as an inner transaction */
+  /**
+   * Transaction ID of the app call containing the output transfer as an inner transaction.
+   * For a launch buy, the curve buy call.
+   */
   outputTxnId: string;
   /** Address that sent the input asset (the user) */
   inputSender: string;
-  /** Address that sent the output asset to the user */
+  /** Address that sent the output asset to the user (the HayLaunch app on a launch buy) */
   outputSender: string;
+  /** Bonding-curve details, present only for a pre-bonding HayLaunch swap */
+  launch?: LaunchSummary;
 }
 /**
  * Method call to be executed as part of the swap
  */
-interface MethodCall {
+export interface MethodCall {
   /** The ID of the smart contract to call. Set this to 0 to indicate an application creation call. */
   appID: number | bigint;
   /** The method to call on the smart contract */
@@ -398,12 +476,10 @@ interface MethodCall {
   /** A transaction signer that can authorize this application call from sender */
   signer?: TransactionSigner;
 }
-//#endregion
-//#region src/middleware.d.ts
 /**
  * Context provided to middleware shouldApply hook
  */
-interface QuoteContext {
+export interface QuoteContext {
   /** Input asset ID (always bigint for precision and future-proofing) */
   readonly fromASAID: bigint;
   /** Output asset ID (always bigint for precision and future-proofing) */
@@ -420,7 +496,7 @@ interface QuoteContext {
 /**
  * Context provided to middleware hooks during swap composition
  */
-interface SwapContext {
+export interface SwapContext {
   /** The quote result from newQuote() */
   readonly quote: SwapQuote;
   /** The address of the account performing the swap */
@@ -470,7 +546,7 @@ interface SwapContext {
  * }
  * ```
  */
-interface SwapMiddleware {
+export interface SwapMiddleware {
   /** Unique identifier for the middleware */
   readonly name: string;
   /** Semantic version of the middleware */
@@ -619,7 +695,7 @@ interface SwapMiddleware {
 /**
  * Configuration options for AutoOptOutMiddleware
  */
-interface AutoOptOutConfig {
+export interface AutoOptOutConfig {
   /**
    * Array of asset IDs that should be excluded from automatic opt-out behavior
    * @default []
@@ -653,7 +729,7 @@ interface AutoOptOutConfig {
  * })
  * ```
  */
-declare class AutoOptOutMiddleware implements SwapMiddleware {
+export declare class AutoOptOutMiddleware implements SwapMiddleware {
   readonly name = "AutoOptOut";
   readonly version = "1.0.0";
   private readonly excludedAssets;
@@ -662,8 +738,6 @@ declare class AutoOptOutMiddleware implements SwapMiddleware {
   adjustQuoteParams(params: FetchQuoteParams): Promise<FetchQuoteParams>;
   afterSwap(context: SwapContext): Promise<TransactionWithSigner[]>;
 }
-//#endregion
-//#region src/composer.d.ts
 /**
  * A transaction signer function that supports both standard algosdk.TransactionSigner
  * and ARC-1 compliant signers that may return null for unsigned transactions.
@@ -672,11 +746,11 @@ declare class AutoOptOutMiddleware implements SwapMiddleware {
  * @param indexesToSign - Array of indexes indicating which transactions need signing
  * @returns Array of signed transactions (may include nulls for ARC-1 compliant wallets)
  */
-type SignerFunction = (txnGroup: Transaction[], indexesToSign: number[]) => Promise<(Uint8Array | null)[]>;
+export type SignerFunction = (txnGroup: Transaction[], indexesToSign: number[]) => Promise<(Uint8Array | null)[]>;
 /**
  * Status of the SwapComposer transaction group lifecycle
  */
-declare enum SwapComposerStatus {
+export declare enum SwapComposerStatus {
   /** The atomic group is still under construction. */
   BUILDING = 0,
   /** The atomic group has been finalized, but not yet signed. */
@@ -686,12 +760,12 @@ declare enum SwapComposerStatus {
   /** The atomic group has been finalized, signed, and submitted to the network. */
   SUBMITTED = 3,
   /** The atomic group has been finalized, signed, submitted, and successfully committed to a block. */
-  COMMITTED = 4,
+  COMMITTED = 4
 }
 /**
  * Configuration for creating a SwapComposer instance
  */
-interface SwapComposerConfig {
+export interface SwapComposerConfig {
   /** The quote response from fetchQuote() or newQuote() */
   readonly quote: FetchQuoteResponse | SwapQuote;
   /** The swap transactions from fetchSwapTransactions() */
@@ -727,7 +801,7 @@ interface SwapComposerConfig {
  *   .execute()
  * ```
  */
-declare class SwapComposer {
+export declare class SwapComposer {
   /** The ATC used to compose the group */
   private atc;
   /** The maximum size of an atomic transaction group. */
@@ -744,6 +818,7 @@ declare class SwapComposer {
   private readonly note?;
   private inputTransactionIndex?;
   private outputTransactionIndex?;
+  private curveTransactionIndex?;
   /** Summary data built incrementally during swap composition */
   private summaryData?;
   /**
@@ -961,6 +1036,21 @@ declare class SwapComposer {
    * Also initializes summaryData with input transaction details and output transaction ID
    */
   private processSwapTransactions;
+  /**
+   * 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.
+   */
+  private findInputTransactionIndex;
+  /**
+   * 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
+   */
+  private initLaunchSummary;
   /**
    * Creates opt-in transactions for apps the user hasn't opted into yet
    */
@@ -985,12 +1075,12 @@ declare 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.
    */
   private extractActualOutputAmount;
 }
-//#endregion
-//#region src/client.d.ts
 /**
  * Client for interacting with the Haystack order router API
  *
@@ -1019,7 +1109,7 @@ declare class SwapComposer {
  * })
  * ```
  */
-declare class RouterClient {
+export declare class RouterClient {
   private readonly config;
   private readonly algodClient;
   private readonly middleware;
@@ -1060,6 +1150,7 @@ declare class RouterClient {
    *   - 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
@@ -1130,6 +1221,7 @@ declare class RouterClient {
    * @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
@@ -1213,17 +1305,19 @@ declare class RouterClient {
    * Validates an Algorand address
    */
   private validateAddress;
+  /**
+   * Validates a slippage percentage (0 <= slippage < 100)
+   */
+  private validateSlippage;
   /**
    * Validates the fee in basis points (max 300 = 3.00%)
    */
   private validateFeeBps;
 }
-//#endregion
-//#region src/utils.d.ts
 /**
  * HTTP error with status code and response data
  */
-declare class HTTPError extends Error {
+export declare class HTTPError extends Error {
   status: number;
   statusText: string;
   data: unknown;
@@ -1240,7 +1334,5 @@ declare class HTTPError extends Error {
  * @returns Parsed JSON response
  * @throws HTTPError if the response status is not ok
  */
-declare function request<T>(url: string, options?: RequestInit): Promise<T>;
-//#endregion
-export { Asset, AutoOptOutConfig, AutoOptOutMiddleware, Config, ConfigParams, 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, DexQuote, FetchQuoteParams, FetchQuoteResponse, FetchSwapTxnsBody, FetchSwapTxnsParams, FetchSwapTxnsResponse, HTTPError, MAX_FEE_BPS, MethodCall, PathElement, Profit, Protocol, QuoteContext, QuoteType, Route, RouterClient, Signature, SignerFunction, SwapComposer, SwapComposerConfig, SwapComposerStatus, SwapContext, SwapMiddleware, SwapQuote, SwapSummary, SwapTransaction, TxnPayload, request };
+export declare function request<T>(url: string, options?: RequestInit): Promise<T>;
 //# sourceMappingURL=index.d.mts.map