@txnlab/deflex 1.1.0 → 1.2.0

package/README.md

@@ -1,5 +1,11 @@
 # Deflex SDK
 
+[![npm version](https://img.shields.io/npm/v/@txnlab/deflex.svg)](https://www.npmjs.com/package/@txnlab/deflex)
+[![bundle size](https://deno.bundlejs.com/badge?q=@txnlab/deflex@latest&treeshake=[*])](https://bundlejs.com/?q=%40txnlab%2Fdeflex%40latest&treeshake=%5B*%5D)
+[![CI](https://github.com/TxnLab/deflex-js/actions/workflows/ci.yml/badge.svg)](https://github.com/TxnLab/deflex-js/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
+
 TypeScript/JavaScript SDK for [Deflex Order Router](https://txnlab.gitbook.io/deflex-api) - smart order routing and DEX aggregation on Algorand.
 
 ## Prerequisites
@@ -174,6 +180,7 @@ await swap.execute()
 ```
 
 The signer function supports two return patterns:
+
 - **Pattern 1** (Pera, Defly, algosdk): Returns only the signed transactions as `Uint8Array[]`
 - **Pattern 2** (Lute, ARC-1 compliant): Returns an array matching the transaction group length with `null` for unsigned transactions as `(Uint8Array | null)[]`
 
@@ -181,17 +188,25 @@ Both patterns are automatically handled by the SDK.
 
 ### Advanced Transaction Composition
 
-Build the transaction group by adding custom transactions before or after the swap using the [`SwapComposer`](#swapcomposer) instance:
+Build the transaction group by adding custom transactions and ABI method calls before or after the swap using the [`SwapComposer`](#swapcomposer) instance:
 
 ```typescript
-import { Transaction } from 'algosdk'
+import { ABIMethod, Transaction } from 'algosdk'
 import { useWallet } from '@txnlab/use-wallet-*' // react, vue, solid, or svelte
 
 const { activeAddress, transactionSigner } = useWallet()
 
 // Create your custom transactions
-const customTxn1 = new Transaction({...})
-const customTxn2 = new Transaction({...})
+const customTxn = new Transaction({...})
+
+// Define an ABI method call
+const methodCall = {
+  appID: 123456,
+  method: new ABIMethod({...}),
+  methodArgs: [...],
+  sender: activeAddress,
+  suggestedParams: await algodClient.getTransactionParams().do(),
+}
 
 // Build and execute the transaction group
 const swap = await deflex.newSwap({
@@ -202,9 +217,9 @@ const swap = await deflex.newSwap({
 })
 
 const result = await swap
-  .addTransaction(customTxn1)     // Add transaction before swap
+  .addTransaction(customTxn)      // Add transaction before swap
   .addSwapTransactions()          // Add swap transactions
-  .addTransaction(customTxn2)     // Add transaction after swap
+  .addMethodCall(methodCall)      // Add ABI method call after swap
   .execute()                      // Sign and execute entire group
 ```
 
@@ -310,11 +325,11 @@ Returns a [`SwapComposer`](#swapcomposer) instance for building and executing sw
 async newSwap(config: SwapComposerConfig): Promise<SwapComposer>
 ```
 
-| Parameter  | Description                                       | Type                                                                                                                                    |
-| ---------- | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| `quote`    | Quote result or raw API response                  | `DeflexQuote \| FetchQuoteResponse`                                                                                                     |
-| `address`  | Signer address                                    | `string`                                                                                                                                |
-| `slippage` | Slippage tolerance as percentage (e.g., 1 for 1%) | `number`                                                                                                                                |
+| Parameter  | Description                                       | Type                                                                                                                   |
+| ---------- | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `quote`    | Quote result or raw API response                  | `DeflexQuote \| FetchQuoteResponse`                                                                                    |
+| `address`  | Signer address                                    | `string`                                                                                                               |
+| `slippage` | Slippage tolerance as percentage (e.g., 1 for 1%) | `number`                                                                                                               |
 | `signer`   | Transaction signer function                       | `algosdk.TransactionSigner \| ((txnGroup: Transaction[], indexesToSign: number[]) => Promise<(Uint8Array \| null)[]>)` |
 
 #### DeflexClient.needsAssetOptIn()
@@ -368,15 +383,17 @@ Plain object returned by [`newQuote()`](#deflexclientnewquote). Extends the raw
 
 Builder for constructing and executing atomic swap transaction groups, returned by [`newSwap()`](#deflexclientnewswap).
 
-| Method                        | Description                                                                    | Parameters                         | Returns                               |
-| ----------------------------- | ------------------------------------------------------------------------------ | ---------------------------------- | ------------------------------------- |
-| `addTransaction(transaction)` | Add a transaction to the atomic group                                          | `transaction: algosdk.Transaction` | `SwapComposer`                        |
-| `addSwapTransactions()`       | Add swap transactions to the group (includes required app opt-ins)             | None                               | `Promise<SwapComposer>`               |
-| `sign()`                      | Sign the transaction group                                                     | None                               | `Promise<Uint8Array[]>`               |
-| `submit()`                    | Sign and submit the transaction group                                          | None                               | `Promise<string[]>`                   |
-| `execute(waitRounds?)`        | Sign, submit, and wait for confirmation                                        | `waitRounds?: number` (default: 4) | `Promise<PendingTransactionResponse>` |
-| `getStatus()`                 | Get current status: `BUILDING`, `BUILT`, `SIGNED`, `SUBMITTED`, or `COMMITTED` | None                               | `ComposerStatus`                      |
-| `count()`                     | Get the number of transactions in the group                                    | None                               | `number`                              |
+| Method                                 | Description                                                                    | Parameters                                                     | Returns                                                                            |
+| -------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `addTransaction(transaction, signer?)` | Add a transaction to the atomic group                                          | `transaction: algosdk.Transaction, signer?: TransactionSigner` | `SwapComposer`                                                                     |
+| `addMethodCall(methodCall, signer?)`   | Add an ABI method call to the atomic group                                     | `methodCall: MethodCall, signer?: TransactionSigner`           | `SwapComposer`                                                                     |
+| `addSwapTransactions()`                | Add swap transactions to the group (includes required app opt-ins)             | None                                                           | `Promise<SwapComposer>`                                                            |
+| `buildGroup()`                         | Build the transaction group and assign group IDs                               | None                                                           | `TransactionWithSigner[]`                                                          |
+| `sign()`                               | Sign the transaction group                                                     | None                                                           | `Promise<Uint8Array[]>`                                                            |
+| `submit()`                             | Sign and submit the transaction group                                          | None                                                           | `Promise<string[]>` (transaction IDs)                                              |
+| `execute(waitRounds?)`                 | Sign, submit, and wait for confirmation                                        | `waitRounds?: number` (default: 4)                             | `Promise<{ confirmedRound: bigint, txIds: string[], methodResults: ABIResult[] }>` |
+| `getStatus()`                          | Get current status: `BUILDING`, `BUILT`, `SIGNED`, `SUBMITTED`, or `COMMITTED` | None                                                           | `SwapComposerStatus`                                                               |
+| `count()`                              | Get the number of transactions in the group                                    | None                                                           | `number`                                                                           |
 
 ## Documentation
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import algosdk, { Algodv2, Transaction, TransactionSigner } from "algosdk";
+import { ABIArgument, ABIMethod, ABIResult, Address, Algodv2, BoxReference, OnApplicationComplete, ResourceReference, SuggestedParams, Transaction, TransactionSigner, TransactionWithSigner } from "algosdk";
 
 //#region src/constants.d.ts
 /**
@@ -281,14 +281,66 @@ interface FetchSwapTxnsResponse {
 /**
  * Processed transaction with optional pre-signature
  *
+ * @deprecated This type is no longer used internally. Use algosdk.TransactionWithSigner instead.
  * @internal
  */
 interface SwapTransaction {
   /** The Algorand transaction */
-  readonly txn: algosdk.Transaction;
+  readonly txn: Transaction;
   /** Pre-signature from Deflex (if applicable) */
   readonly deflexSignature?: DeflexSignature;
 }
+/**
+ * Method call to be executed as part of the swap
+ */
+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 */
+  method: ABIMethod;
+  /** The arguments to include in the method call. If omitted, no arguments will be passed to the method. */
+  methodArgs?: ABIArgument[];
+  /** The address of the sender of this application call */
+  sender: string | Address;
+  /** Transactions params to use for this application call */
+  suggestedParams: SuggestedParams;
+  /** The OnComplete action to take for this application call. If omitted, OnApplicationComplete.NoOpOC will be used. */
+  onComplete?: OnApplicationComplete;
+  /** The approval program for this application call. Only set this if this is an application creation call, or if onComplete is OnApplicationComplete.UpdateApplicationOC */
+  approvalProgram?: Uint8Array;
+  /** The clear program for this application call. Only set this if this is an application creation call, or if onComplete is OnApplicationComplete.UpdateApplicationOC */
+  clearProgram?: Uint8Array;
+  /** The global integer schema size. Only set this if this is an application creation call. */
+  numGlobalInts?: number;
+  /** The global byte slice schema size. Only set this if this is an application creation call. */
+  numGlobalByteSlices?: number;
+  /** The local integer schema size. Only set this if this is an application creation call. */
+  numLocalInts?: number;
+  /** The local byte slice schema size. Only set this if this is an application creation call. */
+  numLocalByteSlices?: number;
+  /** The number of extra pages to allocate for the application's programs. Only set this if this is an application creation call. If omitted, defaults to 0. */
+  extraPages?: number;
+  /** Array of Address strings that represent external accounts supplied to this application. If accounts are provided here, the accounts specified in the method args will appear after these. */
+  appAccounts?: Array<string | Address>;
+  /** Array of App ID numbers that represent external apps supplied to this application. If apps are provided here, the apps specified in the method args will appear after these. */
+  appForeignApps?: Array<number | bigint>;
+  /** Array of Asset ID numbers that represent external assets supplied to this application. If assets are provided here, the assets specified in the method args will appear after these. */
+  appForeignAssets?: Array<number | bigint>;
+  /** The box references for this application call */
+  boxes?: BoxReference[];
+  /** The resource references for this application call */
+  access?: ResourceReference[];
+  /** The note value for this application call */
+  note?: Uint8Array;
+  /** The lease value for this application call */
+  lease?: Uint8Array;
+  /** If provided, the address that the sender will be rekeyed to at the conclusion of this application call */
+  rekeyTo?: string | Address;
+  /** The lowest application version for which this transaction should immediately fail. 0 indicates that no version check should be performed. */
+  rejectVersion?: number | bigint;
+  /** A transaction signer that can authorize this application call from sender */
+  signer?: TransactionSigner;
+}
 //#endregion
 //#region src/composer.d.ts
 /**
@@ -340,22 +392,21 @@ interface SwapComposerConfig {
  * @example
  * ```typescript
  * const quote = await deflex.fetchQuote({ ... })
- * const composer = await deflex.newSwap({ quote, address, slippage })
+ * const composer = await deflex.newSwap({ quote, address, slippage, signer })
  *
  * await composer
  *   .addTransaction(customTxn)
  *   .addSwapTransactions()
- *   .execute(signer)
+ *   .execute()
  * ```
  */
 declare class SwapComposer {
+  /** The ATC used to compose the group */
+  private atc;
   /** The maximum size of an atomic transaction group. */
   static MAX_GROUP_SIZE: number;
-  private status;
-  private transactions;
+  /** Whether the swap transactions have been added to the atomic group. */
   private swapTransactionsAdded;
-  private signedTxns;
-  private txIds;
   private readonly requiredAppOptIns;
   private readonly deflexTxns;
   private readonly algodClient;
@@ -403,7 +454,19 @@ declare class SwapComposer {
    * @throws Error if the composer is not in the BUILDING status
    * @throws Error if the maximum group size is exceeded
    */
-  addTransaction(transaction: Transaction): this;
+  addTransaction(transaction: Transaction, signer?: TransactionSigner): this;
+  /**
+   * Add a method call to the atomic group
+   *
+   * The `signer` property in the `methodCall` parameter is optional. If not provided,
+   * the signer will default to the one passed as the second parameter, or the
+   * configured signer from the constructor if no second parameter is provided.
+   *
+   * @param methodCall - The method call to add
+   * @param signer - The signer to use for the method call (defaults to constructor signer)
+   * @returns This composer instance for chaining
+   */
+  addMethodCall(methodCall: MethodCall, signer?: TransactionSigner): this;
   /**
    * Add swap transactions to the atomic group
    *
@@ -416,6 +479,30 @@ declare class SwapComposer {
    * @throws Error if the maximum group size is exceeded
    */
   addSwapTransactions(): Promise<this>;
+  /**
+   * Finalize the transaction group by assigning group IDs
+   *
+   * This method builds the atomic transaction group, assigning group IDs to all transactions
+   * if there is more than one transaction. After calling this method, the composer's status
+   * will be at least BUILT.
+   *
+   * @returns Array of transactions with their associated signers
+   *
+   * @throws Error if the group contains 0 transactions
+   *
+   * @example
+   * ```typescript
+   * const composer = await deflex.newSwap({ quote, address, slippage, signer })
+   * composer.addTransaction(customTxn)
+   *
+   * // Build the group to inspect transactions before signing
+   * const txnsWithSigners = composer.buildGroup()
+   * console.log('Group ID:', txnsWithSigners[0].txn.group)
+   * console.log('Group length:', txnsWithSigners.length)
+   * console.log('Status:', composer.getStatus()) // BUILT
+   * ```
+   */
+  buildGroup(): TransactionWithSigner[];
   /**
    * Sign the transaction group
    *
@@ -467,6 +554,7 @@ declare class SwapComposer {
   execute(waitRounds?: number): Promise<{
     confirmedRound: bigint;
     txIds: string[];
+    methodResults: ABIResult[];
   }>;
   /**
    * Validates an Algorand address
@@ -481,11 +569,13 @@ declare class SwapComposer {
    */
   private processRequiredAppOptIns;
   /**
-   * Finalizes the transaction group by assigning group IDs
-   *
-   * The composer's status will be at least BUILT after executing this method.
+   * The default signer function that uses the configured signer
+   */
+  private defaultSigner;
+  /**
+   * Creates a TransactionSigner function for Deflex pre-signed transactions
    */
-  private buildGroup;
+  private createDeflexSigner;
   /**
    * Re-signs a Deflex transaction using the provided logic signature or secret key
    */
@@ -737,5 +827,5 @@ declare class HTTPError extends Error {
  */
 declare function request<T>(url: string, options?: RequestInit): Promise<T>;
 //#endregion
-export { Asset, DEFAULT_ALGOD_PORT, DEFAULT_ALGOD_TOKEN, DEFAULT_ALGOD_URI, DEFAULT_API_BASE_URL, DEFAULT_AUTO_OPT_IN, DEFAULT_CONFIRMATION_ROUNDS, DEFAULT_FEE_BPS, DEFAULT_MAX_DEPTH, DEFAULT_MAX_GROUP_SIZE, DEPRECATED_PROTOCOLS, DeflexClient, DeflexConfig, DeflexConfigParams, DeflexQuote, DeflexSignature, DeflexTransaction, DexQuote, FetchQuoteParams, FetchQuoteResponse, FetchSwapTxnsBody, FetchSwapTxnsParams, FetchSwapTxnsResponse, HTTPError, MAX_FEE_BPS, PathElement, Profit, Protocol, QuoteType, Route, SignerFunction, SwapComposer, SwapComposerConfig, SwapComposerStatus, SwapTransaction, TxnPayload, request };
+export { Asset, DEFAULT_ALGOD_PORT, DEFAULT_ALGOD_TOKEN, DEFAULT_ALGOD_URI, DEFAULT_API_BASE_URL, DEFAULT_AUTO_OPT_IN, DEFAULT_CONFIRMATION_ROUNDS, DEFAULT_FEE_BPS, DEFAULT_MAX_DEPTH, DEFAULT_MAX_GROUP_SIZE, DEPRECATED_PROTOCOLS, DeflexClient, DeflexConfig, DeflexConfigParams, DeflexQuote, DeflexSignature, DeflexTransaction, DexQuote, FetchQuoteParams, FetchQuoteResponse, FetchSwapTxnsBody, FetchSwapTxnsParams, FetchSwapTxnsResponse, HTTPError, MAX_FEE_BPS, MethodCall, PathElement, Profit, Protocol, QuoteType, Route, SignerFunction, SwapComposer, SwapComposerConfig, SwapComposerStatus, SwapTransaction, TxnPayload, request };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/constants.ts","../src/types.ts","../src/composer.ts","../src/client.ts","../src/utils.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/constants.ts","../src/types.ts","../src/composer.ts","../src/client.ts","../src/utils.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Algodv2, LogicSigAccount, Transaction, assignGroupID, decodeUnsignedTransaction, isValidAddress, makeApplicationOptInTxnFromObject, msgpackRawDecode, signLogicSigTransactionObject, signTransaction, waitForConfirmation } from "algosdk";
+import { Algodv2, AtomicTransactionComposer, LogicSigAccount, Transaction, decodeUnsignedTransaction, isValidAddress, makeApplicationOptInTxnFromObject, msgpackRawDecode, signLogicSigTransactionObject, signTransaction } from "algosdk";
 
 //#region src/constants.ts
 /**
@@ -68,22 +68,21 @@ let SwapComposerStatus = /* @__PURE__ */ function(SwapComposerStatus$1) {
 * @example
 * ```typescript
 * const quote = await deflex.fetchQuote({ ... })
-* const composer = await deflex.newSwap({ quote, address, slippage })
+* const composer = await deflex.newSwap({ quote, address, slippage, signer })
 *
 * await composer
 *   .addTransaction(customTxn)
 *   .addSwapTransactions()
-*   .execute(signer)
+*   .execute()
 * ```
 */
 var SwapComposer = class SwapComposer {
+	/** The ATC used to compose the group */
+	atc = new AtomicTransactionComposer();
 	/** The maximum size of an atomic transaction group. */
-	static MAX_GROUP_SIZE = 16;
-	status = SwapComposerStatus.BUILDING;
-	transactions = [];
+	static MAX_GROUP_SIZE = AtomicTransactionComposer.MAX_GROUP_SIZE;
+	/** Whether the swap transactions have been added to the atomic group. */
 	swapTransactionsAdded = false;
-	signedTxns = [];
-	txIds = [];
 	requiredAppOptIns;
 	deflexTxns;
 	algodClient;
@@ -120,7 +119,7 @@ var SwapComposer = class SwapComposer {
 	* @returns The current status of the transaction group
 	*/
 	getStatus() {
-		return this.status;
+		return this.atc.getStatus();
 	}
 	/**
 	* Get the number of transactions currently in this atomic group
@@ -128,7 +127,7 @@ var SwapComposer = class SwapComposer {
 	* @returns The number of transactions in the group
 	*/
 	count() {
-		return this.transactions.length;
+		return this.atc.count();
 	}
 	/**
 	* Add a transaction to the atomic group
@@ -146,10 +145,29 @@ var SwapComposer = class SwapComposer {
 	* @throws Error if the composer is not in the BUILDING status
 	* @throws Error if the maximum group size is exceeded
 	*/
-	addTransaction(transaction) {
-		if (this.status !== SwapComposerStatus.BUILDING) throw new Error("Cannot add transactions when composer status is not BUILDING");
-		if (this.transactions.length === SwapComposer.MAX_GROUP_SIZE) throw new Error(`Adding an additional transaction exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`);
-		this.transactions.push({ txn: transaction });
+	addTransaction(transaction, signer = this.defaultSigner) {
+		this.atc.addTransaction({
+			txn: transaction,
+			signer
+		});
+		return this;
+	}
+	/**
+	* Add a method call to the atomic group
+	*
+	* The `signer` property in the `methodCall` parameter is optional. If not provided,
+	* the signer will default to the one passed as the second parameter, or the
+	* configured signer from the constructor if no second parameter is provided.
+	*
+	* @param methodCall - The method call to add
+	* @param signer - The signer to use for the method call (defaults to constructor signer)
+	* @returns This composer instance for chaining
+	*/
+	addMethodCall(methodCall, signer = this.defaultSigner) {
+		this.atc.addMethodCall({
+			...methodCall,
+			signer: methodCall.signer ?? signer
+		});
 		return this;
 	}
 	/**
@@ -165,14 +183,40 @@ var SwapComposer = class SwapComposer {
 	*/
 	async addSwapTransactions() {
 		if (this.swapTransactionsAdded) throw new Error("Swap transactions have already been added");
-		if (this.status !== SwapComposerStatus.BUILDING) throw new Error("Cannot add swap transactions when composer status is not BUILDING");
+		if (this.getStatus() !== SwapComposerStatus.BUILDING) throw new Error("Cannot add swap transactions when composer status is not BUILDING");
 		const processedTxns = await this.processSwapTransactions();
-		if (this.transactions.length + processedTxns.length > SwapComposer.MAX_GROUP_SIZE) throw new Error(`Adding swap transactions exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`);
-		this.transactions.push(...processedTxns);
+		if (this.atc.count() + processedTxns.length > SwapComposer.MAX_GROUP_SIZE) throw new Error(`Adding swap transactions exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`);
+		for (const txnWithSigner of processedTxns) this.atc.addTransaction(txnWithSigner);
 		this.swapTransactionsAdded = true;
 		return this;
 	}
 	/**
+	* Finalize the transaction group by assigning group IDs
+	*
+	* This method builds the atomic transaction group, assigning group IDs to all transactions
+	* if there is more than one transaction. After calling this method, the composer's status
+	* will be at least BUILT.
+	*
+	* @returns Array of transactions with their associated signers
+	*
+	* @throws Error if the group contains 0 transactions
+	*
+	* @example
+	* ```typescript
+	* const composer = await deflex.newSwap({ quote, address, slippage, signer })
+	* composer.addTransaction(customTxn)
+	*
+	* // Build the group to inspect transactions before signing
+	* const txnsWithSigners = composer.buildGroup()
+	* console.log('Group ID:', txnsWithSigners[0].txn.group)
+	* console.log('Group length:', txnsWithSigners.length)
+	* console.log('Status:', composer.getStatus()) // BUILT
+	* ```
+	*/
+	buildGroup() {
+		return this.atc.buildGroup();
+	}
+	/**
 	* Sign the transaction group
 	*
 	* Automatically adds swap transactions if not already added, builds the atomic group,
@@ -186,34 +230,9 @@ var SwapComposer = class SwapComposer {
 	* ```
 	*/
 	async sign() {
-		if (this.status >= SwapComposerStatus.SIGNED) return this.signedTxns;
+		if (this.getStatus() >= SwapComposerStatus.SIGNED) return this.atc.gatherSignatures();
 		if (!this.swapTransactionsAdded) await this.addSwapTransactions();
-		const transactions = this.buildGroup();
-		const txnGroup = [];
-		const indexesToSign = [];
-		for (let i = 0; i < transactions.length; i++) {
-			const item = transactions[i];
-			if (!item) continue;
-			txnGroup.push(item.txn);
-			if (!item.deflexSignature) indexesToSign.push(i);
-		}
-		const userSignedTxns = (await this.signer(txnGroup, indexesToSign)).filter((txn) => txn !== null);
-		const finalSignedTxns = [];
-		let userSignedIndex = 0;
-		for (const item of transactions) if (item.deflexSignature) {
-			const signedTxnBlob = this.signDeflexTransaction(item.txn, item.deflexSignature);
-			finalSignedTxns.push(signedTxnBlob);
-		} else {
-			const userSignedTxn = userSignedTxns[userSignedIndex];
-			if (!userSignedTxn) throw new Error(`Missing signature for user transaction at index ${userSignedIndex}`);
-			finalSignedTxns.push(userSignedTxn);
-			userSignedIndex++;
-		}
-		const txIds = this.transactions.map((t) => t.txn.txID());
-		this.signedTxns = finalSignedTxns;
-		this.txIds = txIds;
-		this.status = SwapComposerStatus.SIGNED;
-		return finalSignedTxns;
+		return await this.atc.gatherSignatures();
 	}
 	/**
 	* Submit the signed transactions to the network
@@ -231,11 +250,8 @@ var SwapComposer = class SwapComposer {
 	* ```
 	*/
 	async submit() {
-		if (this.status > SwapComposerStatus.SUBMITTED) throw new Error("Transaction group cannot be resubmitted");
-		const stxns = await this.sign();
-		await this.algodClient.sendRawTransaction(stxns).do();
-		this.status = SwapComposerStatus.SUBMITTED;
-		return this.txIds;
+		if (!this.swapTransactionsAdded) await this.addSwapTransactions();
+		return this.atc.submit(this.algodClient);
 	}
 	/**
 	* Execute the swap
@@ -256,14 +272,11 @@ var SwapComposer = class SwapComposer {
 	* ```
 	*/
 	async execute(waitRounds = DEFAULT_CONFIRMATION_ROUNDS) {
-		if (this.status === SwapComposerStatus.COMMITTED) throw new Error("Transaction group has already been executed successfully");
-		const txIds = await this.submit();
-		const confirmedTxnInfo = await waitForConfirmation(this.algodClient, txIds[0], waitRounds);
-		this.status = SwapComposerStatus.COMMITTED;
-		const confirmedRound = confirmedTxnInfo.confirmedRound;
+		if (!this.swapTransactionsAdded) await this.addSwapTransactions();
+		const { txIDs,...result } = await this.atc.execute(this.algodClient, waitRounds);
 		return {
-			confirmedRound: BigInt(confirmedRound),
-			txIds
+			...result,
+			txIds: txIDs
 		};
 	}
 	/**
@@ -287,9 +300,12 @@ var SwapComposer = class SwapComposer {
 				delete txn.group;
 				if (deflexTxn.signature !== false) swapTxns.push({
 					txn,
-					deflexSignature: deflexTxn.signature
+					signer: this.createDeflexSigner(deflexTxn.signature)
+				});
+				else swapTxns.push({
+					txn,
+					signer: this.defaultSigner
 				});
-				else swapTxns.push({ txn });
 			} catch (error) {
 				throw new Error(`Failed to process swap transaction at index ${i}: ${error instanceof Error ? error.message : String(error)}`);
 			}
@@ -302,32 +318,34 @@ var SwapComposer = class SwapComposer {
 	async processRequiredAppOptIns() {
 		const userApps = (await this.algodClient.accountInformation(this.address).do())?.appsLocalState?.map((app) => Number(app.id)) || [];
 		const appsToOptIn = this.requiredAppOptIns.filter((appId) => !userApps.includes(appId));
-		const appOptInTxns = [];
-		if (appsToOptIn.length > 0) {
-			const suggestedParams = await this.algodClient.getTransactionParams().do();
-			for (const appId of appsToOptIn) {
-				const optInTxn = makeApplicationOptInTxnFromObject({
-					sender: this.address,
-					appIndex: appId,
-					suggestedParams
-				});
-				appOptInTxns.push(optInTxn);
-			}
-		}
-		return appOptInTxns.map((txn) => ({ txn }));
+		if (appsToOptIn.length === 0) return [];
+		const suggestedParams = await this.algodClient.getTransactionParams().do();
+		return appsToOptIn.map((appId) => ({
+			txn: makeApplicationOptInTxnFromObject({
+				sender: this.address,
+				appIndex: appId,
+				suggestedParams
+			}),
+			signer: this.defaultSigner
+		}));
 	}
 	/**
-	* Finalizes the transaction group by assigning group IDs
-	*
-	* The composer's status will be at least BUILT after executing this method.
+	* The default signer function that uses the configured signer
 	*/
-	buildGroup() {
-		if (this.status === SwapComposerStatus.BUILDING) {
-			if (this.transactions.length === 0) throw new Error("Cannot build a group with 0 transactions");
-			if (this.transactions.length > 1) assignGroupID(this.transactions.map((t) => t.txn));
-			this.status = SwapComposerStatus.BUILT;
-		}
-		return this.transactions;
+	defaultSigner = async (txnGroup, indexesToSign) => {
+		return (await this.signer(txnGroup, indexesToSign)).filter((txn) => txn !== null);
+	};
+	/**
+	* Creates a TransactionSigner function for Deflex pre-signed transactions
+	*/
+	createDeflexSigner(signature) {
+		return async (txnGroup, indexesToSign) => {
+			return indexesToSign.map((i) => {
+				const txn = txnGroup[i];
+				if (!txn) throw new Error(`Transaction at index ${i} not found`);
+				return this.signDeflexTransaction(txn, signature);
+			});
+		};
 	}
 	/**
 	* Re-signs a Deflex transaction using the provided logic signature or secret key

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["txnGroup: Transaction[]","indexesToSign: number[]","finalSignedTxns: Uint8Array[]","appOptIns: SwapTransaction[]","swapTxns: SwapTransaction[]","appOptInTxns: Transaction[]","status: number","statusText: string","data: unknown","errorData: unknown","body: FetchSwapTxnsBody"],"sources":["../src/constants.ts","../src/composer.ts","../src/utils.ts","../src/client.ts"],"sourcesContent":["/**\n * Supported DEX protocols for swap routing\n */\nexport enum Protocol {\n  TinymanV2 = 'TinymanV2',\n  Algofi = 'Algofi',\n  Algomint = 'Algomint',\n  Pact = 'Pact',\n  Folks = 'Folks',\n  TAlgo = 'TAlgo',\n}\n\n/**\n * Deprecated protocols that are automatically excluded from routing\n *\n * @internal\n */\nexport const DEPRECATED_PROTOCOLS = ['Humble', 'Tinyman'] as const\n\n/** Default Algod node URI for mainnet */\nexport const DEFAULT_ALGOD_URI = 'https://mainnet-api.4160.nodely.dev/'\n\n/** Default Algod node token (empty for public nodes) */\nexport const DEFAULT_ALGOD_TOKEN = ''\n\n/** Default Algod node port */\nexport const DEFAULT_ALGOD_PORT = 443\n\n/** Default Deflex API base URL */\nexport const DEFAULT_API_BASE_URL = 'https://deflex.txnlab.dev/api'\n\n/** Default fee in basis points (0.15%) */\nexport const DEFAULT_FEE_BPS = 15\n\n/** Maximum allowed fee in basis points (3.00%) */\nexport const MAX_FEE_BPS = 300\n\n/** Default maximum transaction group size */\nexport const DEFAULT_MAX_GROUP_SIZE = 16\n\n/** Default maximum routing depth (number of hops) */\nexport const DEFAULT_MAX_DEPTH = 4\n\n/** Default auto opt-in setting (automatic asset/app opt-in detection) */\nexport const DEFAULT_AUTO_OPT_IN = false\n\n/** Default number of rounds to wait for transaction confirmation */\nexport const DEFAULT_CONFIRMATION_ROUNDS = 4\n","import {\n  assignGroupID,\n  decodeUnsignedTransaction,\n  isValidAddress,\n  signLogicSigTransactionObject,\n  signTransaction,\n  LogicSigAccount,\n  makeApplicationOptInTxnFromObject,\n  msgpackRawDecode,\n  Transaction,\n  waitForConfirmation,\n  type Algodv2,\n  type TransactionSigner,\n} from 'algosdk'\nimport { DEFAULT_CONFIRMATION_ROUNDS } from './constants'\nimport type {\n  FetchQuoteResponse,\n  DeflexTransaction,\n  SwapTransaction,\n  DeflexSignature,\n  DeflexQuote,\n} from './types'\n\n/**\n * A transaction signer function that supports both standard algosdk.TransactionSigner\n * and ARC-1 compliant signers that may return null for unsigned transactions.\n *\n * @param txnGroup - The complete transaction group to sign\n * @param indexesToSign - Array of indexes indicating which transactions need signing\n * @returns Array of signed transactions (may include nulls for ARC-1 compliant wallets)\n */\nexport type SignerFunction = (\n  txnGroup: Transaction[],\n  indexesToSign: number[],\n) => Promise<(Uint8Array | null)[]>\n\n/**\n * Status of the SwapComposer transaction group lifecycle\n */\nexport enum SwapComposerStatus {\n  /** The atomic group is still under construction. */\n  BUILDING,\n\n  /** The atomic group has been finalized, but not yet signed. */\n  BUILT,\n\n  /** The atomic group has been finalized and signed, but not yet submitted to the network. */\n  SIGNED,\n\n  /** The atomic group has been finalized, signed, and submitted to the network. */\n  SUBMITTED,\n\n  /** The atomic group has been finalized, signed, submitted, and successfully committed to a block. */\n  COMMITTED,\n}\n\n/**\n * Configuration for creating a SwapComposer instance\n */\nexport interface SwapComposerConfig {\n  /** The quote response from fetchQuote() or newQuote() */\n  readonly quote: FetchQuoteResponse | DeflexQuote\n  /** The swap transactions from fetchSwapTransactions() */\n  readonly deflexTxns: DeflexTransaction[]\n  /** Algodv2 client instance */\n  readonly algodClient: Algodv2\n  /** The address of the account that will sign transactions */\n  readonly address: string\n  /** Transaction signer function */\n  readonly signer: TransactionSigner | SignerFunction\n}\n\n/**\n * Composer for building and executing atomic swap transaction groups\n *\n * The SwapComposer allows you to build complex transaction groups by adding custom\n * transactions before and after swap transactions. It handles pre-signed transactions,\n * automatic app opt-ins, and provides a fluent API for transaction group construction.\n *\n * @example\n * ```typescript\n * const quote = await deflex.fetchQuote({ ... })\n * const composer = await deflex.newSwap({ quote, address, slippage })\n *\n * await composer\n *   .addTransaction(customTxn)\n *   .addSwapTransactions()\n *   .execute(signer)\n * ```\n */\nexport class SwapComposer {\n  /** The maximum size of an atomic transaction group. */\n  static MAX_GROUP_SIZE: number = 16\n\n  private status: SwapComposerStatus = SwapComposerStatus.BUILDING\n  private transactions: SwapTransaction[] = []\n  private swapTransactionsAdded = false\n  private signedTxns: Uint8Array[] = []\n  private txIds: string[] = []\n\n  private readonly requiredAppOptIns: number[]\n  private readonly deflexTxns: DeflexTransaction[]\n  private readonly algodClient: Algodv2\n  private readonly address: string\n  private readonly signer: TransactionSigner | SignerFunction\n\n  /**\n   * Create a new SwapComposer instance\n   *\n   * Note: Most developers should use DeflexClient.newSwap() instead of constructing\n   * this directly, as the factory method handles fetching swap transactions automatically.\n   *\n   * @param config - Configuration for the composer\n   * @param config.requiredAppOptIns - The quote response from fetchQuote()\n   * @param config.deflexTxns - The swap transactions from fetchSwapTransactions()\n   * @param config.algodClient - Algodv2 client instance\n   * @param config.address - The address of the account that will sign transactions\n   * @param config.signer - Transaction signer function\n   */\n  constructor(config: SwapComposerConfig) {\n    // Validate required parameters\n    if (!config.quote) {\n      throw new Error('Quote is required')\n    }\n    if (!config.deflexTxns) {\n      throw new Error('Swap transactions are required')\n    }\n    if (config.deflexTxns.length === 0) {\n      throw new Error('Swap transactions array cannot be empty')\n    }\n    if (!config.algodClient) {\n      throw new Error('Algodv2 client instance is required')\n    }\n    if (!config.signer) {\n      throw new Error('Signer is required')\n    }\n\n    this.requiredAppOptIns = config.quote.requiredAppOptIns\n    this.deflexTxns = config.deflexTxns\n    this.algodClient = config.algodClient\n    this.address = this.validateAddress(config.address)\n    this.signer = config.signer\n  }\n\n  /**\n   * Get the status of this composer's transaction group\n   *\n   * @returns The current status of the transaction group\n   */\n  getStatus(): SwapComposerStatus {\n    return this.status\n  }\n\n  /**\n   * Get the number of transactions currently in this atomic group\n   *\n   * @returns The number of transactions in the group\n   */\n  count(): number {\n    return this.transactions.length\n  }\n\n  /**\n   * Add a transaction to the atomic group\n   *\n   * Transactions are added in the order methods are called. For example:\n   * ```typescript\n   * composer\n   *   .addTransaction(txn1)      // Added first\n   *   .addSwapTransactions()     // Added second\n   *   .addTransaction(txn2)      // Added third\n   * ```\n   *\n   * @param transaction - The transaction to add\n   * @returns This composer instance for chaining\n   * @throws Error if the composer is not in the BUILDING status\n   * @throws Error if the maximum group size is exceeded\n   */\n  addTransaction(transaction: Transaction): this {\n    if (this.status !== SwapComposerStatus.BUILDING) {\n      throw new Error(\n        'Cannot add transactions when composer status is not BUILDING',\n      )\n    }\n\n    if (this.transactions.length === SwapComposer.MAX_GROUP_SIZE) {\n      throw new Error(\n        `Adding an additional transaction exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`,\n      )\n    }\n\n    this.transactions.push({ txn: transaction })\n    return this\n  }\n\n  /**\n   * Add swap transactions to the atomic group\n   *\n   * This method automatically processes required app opt-ins and adds all swap\n   * transactions from the quote. Can only be called once per composer instance.\n   *\n   * @returns This composer instance for chaining\n   * @throws Error if the swap transactions have already been added\n   * @throws Error if the composer is not in the BUILDING status\n   * @throws Error if the maximum group size is exceeded\n   */\n  async addSwapTransactions(): Promise<this> {\n    if (this.swapTransactionsAdded) {\n      throw new Error('Swap transactions have already been added')\n    }\n\n    if (this.status !== SwapComposerStatus.BUILDING) {\n      throw new Error(\n        'Cannot add swap transactions when composer status is not BUILDING',\n      )\n    }\n\n    const processedTxns = await this.processSwapTransactions()\n    const newLength = this.transactions.length + processedTxns.length\n\n    if (newLength > SwapComposer.MAX_GROUP_SIZE) {\n      throw new Error(\n        `Adding swap transactions exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`,\n      )\n    }\n\n    this.transactions.push(...processedTxns)\n\n    this.swapTransactionsAdded = true\n    return this\n  }\n\n  /**\n   * Sign the transaction group\n   *\n   * Automatically adds swap transactions if not already added, builds the atomic group,\n   * and signs all transactions using the configured signer.\n   *\n   * @returns A promise that resolves to an array of signed transaction blobs\n   *\n   * @example\n   * ```typescript\n   * const signedTxns = await composer.sign()\n   * ```\n   */\n  async sign(): Promise<Uint8Array[]> {\n    if (this.status >= SwapComposerStatus.SIGNED) {\n      return this.signedTxns\n    }\n\n    // Auto-add swap transactions if needed\n    if (!this.swapTransactionsAdded) {\n      await this.addSwapTransactions()\n    }\n\n    // Build the transaction group, ensure status is BUILT\n    const transactions = this.buildGroup()\n\n    // Collect all transactions and identify which ones need user signature\n    const txnGroup: Transaction[] = []\n    const indexesToSign: number[] = []\n\n    for (let i = 0; i < transactions.length; i++) {\n      const item = transactions[i]\n      if (!item) continue\n\n      txnGroup.push(item.txn)\n\n      if (!item.deflexSignature) {\n        // User transaction - needs user signature\n        indexesToSign.push(i)\n      }\n    }\n\n    // Sign all transactions with the complete group\n    const signedTxns = await this.signer(txnGroup, indexesToSign)\n\n    // Normalize signedTxns - handle both wallet patterns:\n    // Pattern 1: Returns only signed txns (length < txnGroup.length)\n    // Pattern 2: Returns array matching group length with nulls for non-signed (ARC-1)\n    const userSignedTxns = signedTxns.filter(\n      (txn): txn is Uint8Array => txn !== null,\n    )\n\n    // Rebuild complete group in correct order\n    const finalSignedTxns: Uint8Array[] = []\n    let userSignedIndex = 0\n\n    for (const item of transactions) {\n      if (item.deflexSignature) {\n        // Pre-signed transaction - re-sign with Deflex signature\n        const signedTxnBlob = this.signDeflexTransaction(\n          item.txn,\n          item.deflexSignature,\n        )\n        finalSignedTxns.push(signedTxnBlob)\n      } else {\n        // User transaction - use signature from signer\n        const userSignedTxn = userSignedTxns[userSignedIndex]\n        if (!userSignedTxn) {\n          throw new Error(\n            `Missing signature for user transaction at index ${userSignedIndex}`,\n          )\n        }\n        finalSignedTxns.push(userSignedTxn)\n        userSignedIndex++\n      }\n    }\n\n    const txIds = this.transactions.map((t) => t.txn.txID())\n\n    this.signedTxns = finalSignedTxns\n    this.txIds = txIds\n    this.status = SwapComposerStatus.SIGNED\n\n    return finalSignedTxns\n  }\n\n  /**\n   * Submit the signed transactions to the network\n   *\n   * This method signs the transaction group (if not already signed) and submits\n   * it to the Algorand network. Does not wait for confirmation.\n   *\n   * @returns The transaction IDs\n   * @throws Error if the transaction group has already been submitted\n   *\n   * @example\n   * ```typescript\n   * const txIds = await composer.submit()\n   * console.log('Submitted transactions:', txIds)\n   * ```\n   */\n  async submit(): Promise<string[]> {\n    if (this.status > SwapComposerStatus.SUBMITTED) {\n      throw new Error('Transaction group cannot be resubmitted')\n    }\n\n    const stxns = await this.sign()\n    await this.algodClient.sendRawTransaction(stxns).do()\n\n    this.status = SwapComposerStatus.SUBMITTED\n    return this.txIds\n  }\n\n  /**\n   * Execute the swap\n   *\n   * Signs the transaction group, submits it to the network, and waits for confirmation.\n   * This is the primary method for executing swaps and combines sign(), submit(), and\n   * waitForConfirmation() into a single call.\n   *\n   * @param waitRounds - The number of rounds to wait for confirmation (default: 4)\n   * @returns Object containing the confirmed round and transaction IDs\n   * @throws Error if the transaction group has already been committed\n   *\n   * @example\n   * ```typescript\n   * const result = await composer.execute()\n   * console.log(`Confirmed in round ${result.confirmedRound}`)\n   * console.log('Transaction IDs:', result.txIds)\n   * ```\n   */\n  async execute(waitRounds: number = DEFAULT_CONFIRMATION_ROUNDS): Promise<{\n    confirmedRound: bigint\n    txIds: string[]\n  }> {\n    if (this.status === SwapComposerStatus.COMMITTED) {\n      throw new Error(\n        'Transaction group has already been executed successfully',\n      )\n    }\n\n    const txIds = await this.submit()\n\n    const confirmedTxnInfo = await waitForConfirmation(\n      this.algodClient,\n      txIds[0]!,\n      waitRounds,\n    )\n\n    this.status = SwapComposerStatus.COMMITTED\n\n    const confirmedRound = confirmedTxnInfo.confirmedRound!\n\n    return {\n      confirmedRound: BigInt(confirmedRound),\n      txIds,\n    }\n  }\n\n  /**\n   * Validates an Algorand address\n   */\n  private validateAddress(address: string): string {\n    if (!isValidAddress(address)) {\n      throw new Error(`Invalid Algorand address: ${address}`)\n    }\n    return address\n  }\n\n  /**\n   * Processes app opt-ins and decodes swap transactions from API response\n   */\n  private async processSwapTransactions(): Promise<SwapTransaction[]> {\n    // Process required app opt-ins\n    const appOptIns: SwapTransaction[] = await this.processRequiredAppOptIns()\n\n    // Decode and process swap transactions from API\n    const swapTxns: SwapTransaction[] = []\n    for (let i = 0; i < this.deflexTxns.length; i++) {\n      const deflexTxn = this.deflexTxns[i]\n      if (!deflexTxn) continue\n\n      try {\n        // Decode transaction from base64 data\n        const txnBytes = Buffer.from(deflexTxn.data, 'base64')\n        const txn = decodeUnsignedTransaction(txnBytes)\n\n        // Remove group ID (will be reassigned later)\n        delete txn.group\n\n        if (deflexTxn.signature !== false) {\n          // Pre-signed transaction - needs re-signing with provided signature\n          swapTxns.push({\n            txn,\n            deflexSignature: deflexTxn.signature,\n          })\n        } else {\n          // User transaction - needs user signature\n          swapTxns.push({\n            txn,\n          })\n        }\n      } catch (error) {\n        throw new Error(\n          `Failed to process swap transaction at index ${i}: ${error instanceof Error ? error.message : String(error)}`,\n        )\n      }\n    }\n\n    return [...appOptIns, ...swapTxns]\n  }\n\n  /**\n   * Creates opt-in transactions for apps the user hasn't opted into yet\n   */\n  private async processRequiredAppOptIns(): Promise<SwapTransaction[]> {\n    // Fetch account information\n    const accountInfo = await this.algodClient\n      .accountInformation(this.address)\n      .do()\n\n    // Check app opt-ins\n    const userApps =\n      accountInfo?.appsLocalState?.map((app) => Number(app.id)) || []\n    const appsToOptIn = this.requiredAppOptIns.filter(\n      (appId) => !userApps.includes(appId),\n    )\n\n    // Create opt-in transactions if needed\n    const appOptInTxns: Transaction[] = []\n    if (appsToOptIn.length > 0) {\n      const suggestedParams = await this.algodClient.getTransactionParams().do()\n\n      for (const appId of appsToOptIn) {\n        const optInTxn = makeApplicationOptInTxnFromObject({\n          sender: this.address,\n          appIndex: appId,\n          suggestedParams,\n        })\n        appOptInTxns.push(optInTxn)\n      }\n    }\n\n    return appOptInTxns.map((txn) => ({ txn }))\n  }\n\n  /**\n   * Finalizes the transaction group by assigning group IDs\n   *\n   * The composer's status will be at least BUILT after executing this method.\n   */\n  private buildGroup(): SwapTransaction[] {\n    if (this.status === SwapComposerStatus.BUILDING) {\n      if (this.transactions.length === 0) {\n        throw new Error('Cannot build a group with 0 transactions')\n      }\n      if (this.transactions.length > 1) {\n        assignGroupID(this.transactions.map((t) => t.txn))\n      }\n      this.status = SwapComposerStatus.BUILT\n    }\n    return this.transactions\n  }\n\n  /**\n   * Re-signs a Deflex transaction using the provided logic signature or secret key\n   */\n  private signDeflexTransaction(\n    transaction: Transaction,\n    signature: DeflexSignature,\n  ): Uint8Array {\n    try {\n      if (signature.type === 'logic_signature') {\n        // Decode the signature value to extract the logic signature\n        const valueArray = signature.value as Record<string, number>\n        const valueBytes = new Uint8Array(Object.values(valueArray))\n        const decoded = msgpackRawDecode(valueBytes) as {\n          lsig?: { l: Uint8Array; arg?: Uint8Array[] }\n        }\n\n        if (!decoded.lsig) {\n          throw new Error('Logic signature structure missing lsig field')\n        }\n\n        const lsig = decoded.lsig\n        const logicSigAccount = new LogicSigAccount(lsig.l, lsig.arg)\n\n        const signedTxn = signLogicSigTransactionObject(\n          transaction,\n          logicSigAccount,\n        )\n        return signedTxn.blob\n      } else if (signature.type === 'secret_key') {\n        // Convert signature.value (Record<string, number>) to Uint8Array\n        const valueArray = signature.value as Record<string, number>\n        const secretKey = new Uint8Array(Object.values(valueArray))\n        const signedTxn = signTransaction(transaction, secretKey)\n        return signedTxn.blob\n      } else {\n        throw new Error(`Unsupported signature type: ${signature.type}`)\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to re-sign transaction: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n}\n","/**\n * HTTP error with status code and response data\n */\nexport class HTTPError extends Error {\n  constructor(\n    public status: number,\n    public statusText: string,\n    public data: unknown,\n  ) {\n    super(`HTTP ${status} ${statusText}`)\n    this.name = 'HTTPError'\n  }\n}\n\n/**\n * Make an HTTP request and parse JSON response\n *\n * Simple wrapper around native fetch for API calls. Throws HTTPError for\n * non-2xx responses.\n *\n * @param url - The URL to request\n * @param options - Fetch options\n * @returns Parsed JSON response\n * @throws HTTPError if the response status is not ok\n */\nexport async function request<T>(\n  url: string,\n  options?: RequestInit,\n): Promise<T> {\n  const response = await fetch(url, options)\n\n  if (!response.ok) {\n    let errorData: unknown\n\n    try {\n      errorData = await response.json()\n    } catch {\n      try {\n        errorData = await response.text()\n      } catch {\n        errorData = 'Failed to parse error response'\n      }\n    }\n\n    throw new HTTPError(\n      response.status,\n      response.statusText,\n      JSON.stringify(errorData),\n    )\n  }\n\n  return response.json() as Promise<T>\n}\n","import { Algodv2, isValidAddress, type TransactionSigner } from 'algosdk'\nimport { SwapComposer, type SignerFunction } from './composer'\nimport {\n  DEFAULT_ALGOD_PORT,\n  DEFAULT_ALGOD_TOKEN,\n  DEFAULT_ALGOD_URI,\n  DEFAULT_API_BASE_URL,\n  DEFAULT_AUTO_OPT_IN,\n  DEFAULT_FEE_BPS,\n  DEFAULT_MAX_DEPTH,\n  DEFAULT_MAX_GROUP_SIZE,\n  DEPRECATED_PROTOCOLS,\n  MAX_FEE_BPS,\n} from './constants'\nimport { request } from './utils'\nimport type {\n  FetchQuoteResponse,\n  FetchSwapTxnsResponse,\n  DeflexConfig,\n  DeflexConfigParams,\n  FetchSwapTxnsParams,\n  FetchSwapTxnsBody,\n  FetchQuoteParams,\n  DeflexQuote,\n} from './types'\n\n/**\n * Client for interacting with the Deflex order router API\n *\n * The DeflexClient provides methods to fetch swap quotes and create transaction composers\n * for executing swaps on the Algorand blockchain. It handles API communication, transaction\n * validation, and automatic asset/app opt-in detection.\n *\n * @example\n * ```typescript\n * const deflex = new DeflexClient({\n *   apiKey: 'your-api-key',\n * })\n * ```\n *\n * @example\n * ```typescript\n * const deflex = new DeflexClient({\n *   apiKey: 'your-api-key',\n *   apiBaseUrl: 'https://deflex.txnlab.dev',\n *   algodUri: 'https://mainnet-api.4160.nodely.dev/',\n *   algodToken: '',\n *   algodPort: 443,\n *   referrerAddress: 'REFERRER_ADDRESS...',\n *   feeBps: 15,\n *   autoOptIn: false,\n * })\n * ```\n */\nexport class DeflexClient {\n  private readonly config: DeflexConfig\n  private readonly algodClient: Algodv2\n\n  /**\n   * Create a new DeflexClient instance\n   *\n   * @param config - Configuration parameters\n   * @param config.apiKey - API key for Deflex API (required)\n   * @param config.apiBaseUrl - Base URL for the Deflex API (default: https://deflex.txnlab.dev)\n   * @param config.algodUri - Algod node URI (default: https://mainnet-api.4160.nodely.dev/)\n   * @param config.algodToken - Algod node token (default: '')\n   * @param config.algodPort - Algod node port (default: 443)\n   * @param config.referrerAddress - Referrer address for fee sharing (receives 25% of swap fees)\n   * @param config.feeBps - Fee in basis points (default: 15 = 0.15%, max: 300 = 3.00%)\n   * @param config.autoOptIn - Automatically detect and add required opt-in transactions (default: false)\n   */\n  constructor(config: DeflexConfigParams) {\n    // Validate and set config\n    this.config = {\n      apiKey: this.validateApiKey(config.apiKey),\n      apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL,\n      algodUri: config.algodUri ?? DEFAULT_ALGOD_URI,\n      algodToken: config.algodToken ?? DEFAULT_ALGOD_TOKEN,\n      algodPort: config.algodPort ?? DEFAULT_ALGOD_PORT,\n      referrerAddress: config.referrerAddress\n        ? this.validateAddress(config.referrerAddress)\n        : undefined,\n      feeBps: this.validateFeeBps(config.feeBps ?? DEFAULT_FEE_BPS),\n      autoOptIn: config.autoOptIn ?? DEFAULT_AUTO_OPT_IN,\n    }\n\n    // Create Algodv2 client\n    this.algodClient = new Algodv2(\n      this.config.algodToken,\n      this.config.algodUri,\n      this.config.algodPort,\n    )\n  }\n\n  /**\n   * Fetch a swap quote from the Deflex API\n   *\n   * Requests optimal swap routing from the Deflex API. The quote includes routing\n   * information, price impact, required opt-ins, and an encrypted transaction payload.\n   *\n   * @param params - Parameters for the quote request\n   * @param params.fromASAID - The ID of the asset to swap from\n   * @param params.toASAID - The ID of the asset to swap to\n   * @param params.amount - The amount of the asset to swap in base units\n   * @param params.type - The type of the quote (default: 'fixed-input')\n   * @param params.disabledProtocols - List of protocols to disable (default: [])\n   * @param params.maxGroupSize - The maximum group size (default: 16)\n   * @param params.maxDepth - The maximum depth (default: 4)\n   * @param params.address - The address of the account that will perform the swap (recommended when using `config.autoOptIn` or `params.optIn`)\n   * @param params.optIn - Whether to include asset opt-in transaction\n   *   - If true: API reduces maxGroupSize by 1 and includes opt-in (always included, even if not needed)\n   *   - If false: No opt-in transaction included\n   *   - If undefined: Falls back to `config.autoOptIn` behavior with account check (if `params.address` is provided)\n   * @returns A FetchQuoteResponse object with routing information\n   *\n   * @example\n   * ```typescript\n   * const quote = await deflex.fetchQuote({\n   *   address: 'ABC...',\n   *   fromASAID: 0,           // ALGO\n   *   toASAID: 31566704,      // USDC\n   *   amount: 1_000_000,      // 1 ALGO\n   * })\n   * ```\n   */\n  async fetchQuote(params: FetchQuoteParams): Promise<FetchQuoteResponse> {\n    const {\n      fromASAID,\n      toASAID,\n      amount,\n      type = 'fixed-input',\n      disabledProtocols = [],\n      maxGroupSize = DEFAULT_MAX_GROUP_SIZE,\n      maxDepth = DEFAULT_MAX_DEPTH,\n      optIn,\n      address,\n    } = params\n\n    // Always include deprecated protocols in disabled list\n    const allDisabledProtocols = [\n      ...new Set([...DEPRECATED_PROTOCOLS, ...disabledProtocols]),\n    ]\n\n    let includeOptIn = optIn\n    if (includeOptIn === undefined && this.config.autoOptIn) {\n      if (address) {\n        includeOptIn = await this.needsAssetOptIn(\n          this.validateAddress(address),\n          toASAID,\n        )\n      } else {\n        console.warn(\n          'autoOptIn is enabled but no address provided to fetchQuote(). Asset opt-in check skipped.',\n        )\n      }\n    }\n\n    const url = new URL(`${this.config.apiBaseUrl}/fetchQuote`)\n\n    url.searchParams.append('apiKey', this.config.apiKey)\n    url.searchParams.append('algodUri', this.config.algodUri)\n    url.searchParams.append('algodToken', this.config.algodToken)\n    url.searchParams.append('algodPort', String(this.config.algodPort))\n    url.searchParams.append('feeBps', this.config.feeBps.toString())\n    url.searchParams.append('fromASAID', BigInt(fromASAID).toString())\n    url.searchParams.append('toASAID', BigInt(toASAID).toString())\n    url.searchParams.append('amount', BigInt(amount).toString())\n    url.searchParams.append('type', type)\n    url.searchParams.append('disabledProtocols', allDisabledProtocols.join(','))\n    url.searchParams.append('maxGroupSize', maxGroupSize.toString())\n    url.searchParams.append('maxDepth', maxDepth.toString())\n\n    if (typeof includeOptIn === 'boolean') {\n      url.searchParams.append('optIn', String(includeOptIn))\n    }\n\n    if (this.config.referrerAddress) {\n      url.searchParams.append('referrerAddress', this.config.referrerAddress)\n    }\n\n    return request<FetchQuoteResponse>(url.toString())\n  }\n\n  /**\n   * Check if asset opt-in is required for the output asset\n   *\n   * Convenience method to determine if an address needs to opt into the output asset\n   * of a swap. This is useful when you want to get a quote without requiring wallet\n   * connection upfront, but need to know whether to set `optIn: true` in fetchQuote()\n   * to ensure proper routing (as opt-ins reduce maxGroupSize by 1).\n   *\n   * Note: If you enable `config.autoOptIn`, this check is handled automatically when\n   * an address is provided to fetchQuote().\n   *\n   * @param address - The address to check\n   * @param assetId - The output asset ID to check\n   * @returns True if asset opt-in is required, false otherwise (always false for ALGO)\n   *\n   * @example\n   * ```typescript\n   * // Check if opt-in needed for output asset before fetching quote\n   * const needsOptIn = await deflex.needsAssetOptIn(userAddress, toAssetId)\n   * const quote = await deflex.fetchQuote({\n   *   fromAssetId,\n   *   toAssetId,\n   *   amount,\n   *   optIn: needsOptIn,\n   * })\n   * ```\n   */\n  async needsAssetOptIn(\n    address: string,\n    assetId: number | bigint,\n  ): Promise<boolean> {\n    // Fetch account information\n    const accountInfo = await this.algodClient.accountInformation(address).do()\n\n    // Check if asset opt-in is required\n    return (\n      BigInt(assetId) !== 0n &&\n      accountInfo?.assets?.find(\n        (asset) => asset.assetId === BigInt(assetId),\n      ) === undefined\n    )\n  }\n\n  /**\n   * Fetch swap transactions from the Deflex API\n   *\n   * Decrypts the quote payload and generates executable swap transactions for the\n   * specified signer address with the given slippage tolerance.\n   *\n   * @param params - Parameters for the swap transaction request\n   * @param params.quote - The quote response from fetchQuote()\n   * @param params.address - The address of the signer\n   * @param params.slippage - The slippage tolerance as a percentage (e.g., 1 for 1%)\n   * @returns A FetchSwapTxnsResponse object with transaction data\n   */\n  async fetchSwapTransactions(\n    params: FetchSwapTxnsParams,\n  ): Promise<FetchSwapTxnsResponse> {\n    const { quote, address, slippage } = params\n\n    // Validate signer address\n    this.validateAddress(address)\n\n    const url = new URL(`${this.config.apiBaseUrl}/fetchExecuteSwapTxns`)\n\n    const body: FetchSwapTxnsBody = {\n      apiKey: this.config.apiKey,\n      address,\n      txnPayloadJSON: quote.txnPayload,\n      slippage,\n    }\n\n    return request<FetchSwapTxnsResponse>(url.toString(), {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n    })\n  }\n\n  /**\n   * Fetch a quote and return an enhanced quote result\n   *\n   * This is the recommended way to fetch quotes. It returns an object that\n   * extends the raw API response with additional metadata and type normalization.\n   *\n   * @param params - Parameters for the quote request\n   * @param params.fromASAID - The ID of the asset to swap from\n   * @param params.toASAID - The ID of the asset to swap to\n   * @param params.amount - The amount of the asset to swap in base units\n   * @param params.type - The type of the quote (default: 'fixed-input')\n   * @param params.disabledProtocols - List of protocols to disable (default: [])\n   * @param params.maxGroupSize - The maximum group size (default: 16)\n   * @param params.maxDepth - The maximum depth (default: 4)\n   * @param params.address - The address of the account that will perform the swap (recommended when using `config.autoOptIn` or `params.optIn`)\n   * @param params.optIn - Whether to include asset opt-in transaction\n   * @returns A DeflexQuote enhanced quote result\n   *\n   * @example\n   * ```typescript\n   * const quote = await deflex.newQuote({\n   *   address: 'ABC...',\n   *   fromASAID: 0,\n   *   toASAID: 31566704,\n   *   amount: 1_000_000,\n   * })\n   *\n   * console.log(quote.quote)     // bigint - quoted amount\n   * console.log(quote.fromASAID) // number - input asset ID\n   * console.log(quote.toASAID)   // number - output asset ID\n   * console.log(quote.amount)    // bigint - original request amount\n   * console.log(quote.createdAt) // number - timestamp\n   * ```\n   */\n  async newQuote(params: FetchQuoteParams): Promise<DeflexQuote> {\n    const response = await this.fetchQuote(params)\n\n    return {\n      ...response,\n      quote: response.quote === '' ? 0n : BigInt(response.quote),\n      amount: BigInt(params.amount),\n      address: params.address ?? undefined,\n      createdAt: Date.now(),\n    }\n  }\n\n  /**\n   * Create a SwapComposer instance\n   *\n   * This factory method creates a composer that allows you to add custom transactions\n   * before and after the swap transactions, with automatic handling of pre-signed transactions\n   * and opt-ins.\n   *\n   * @param config.quote - The quote result from newQuote() or raw API response from fetchQuote()\n   * @param config.address - The address of the signer\n   * @param config.slippage - The slippage tolerance\n   * @param config.signer - Transaction signer function\n   * @returns A SwapComposer instance ready for building transaction groups\n   *\n   * @example\n   * ```typescript\n   * // Basic swap\n   * const quote = await deflex.newQuote({ ... })\n   * await deflex.newSwap({ quote, address, slippage, signer })\n   *   .execute()\n   * ```\n   *\n   * @example\n   * ```typescript\n   * // Advanced swap with custom transactions\n   * const quote = await deflex.newQuote({ ... })\n   * const swap = await deflex.newSwap({\n   *   quote,\n   *   address,\n   *   slippage,\n   *   signer,\n   * })\n   *\n   * console.log(swap.getStatus()) // BUILDING\n   *\n   * const signedTxns = await swap\n   *   .addTransaction(beforeTxn)\n   *   .addSwapTransactions() // Adds swap transactions to the group\n   *   .addTransaction(afterTxn)\n   *   .sign()\n   *\n   * console.log(swap.getStatus()) // SIGNED\n   *\n   * const result = await swap.execute(waitRounds)\n   * console.log(result.confirmedRound, result.txIds)\n   *\n   * console.log(swap.getStatus()) // COMMITTED\n   * ```\n   */\n  async newSwap(config: {\n    quote: DeflexQuote | FetchQuoteResponse\n    address: string\n    slippage: number\n    signer: TransactionSigner | SignerFunction\n  }): Promise<SwapComposer> {\n    const { quote, address, slippage, signer } = config\n\n    const swapResponse = await this.fetchSwapTransactions({\n      quote,\n      address,\n      slippage,\n    })\n\n    // Create the composer\n    const composer = new SwapComposer({\n      quote,\n      deflexTxns: swapResponse.txns,\n      algodClient: this.algodClient,\n      address,\n      signer,\n    })\n\n    return composer\n  }\n\n  /**\n   * Validates the API key\n   */\n  private validateApiKey(apiKey: string): string {\n    if (!apiKey) {\n      throw new Error('API key is required')\n    }\n    return apiKey\n  }\n\n  /**\n   * Validates an Algorand address\n   */\n  private validateAddress(address: string): string {\n    if (!isValidAddress(address)) {\n      throw new Error(`Invalid Algorand address: ${address}`)\n    }\n    return address\n  }\n\n  /**\n   * Validates the fee in basis points (max 300 = 3.00%)\n   */\n  private validateFeeBps(feeBps: number): number {\n    if (feeBps < 0 || feeBps > MAX_FEE_BPS) {\n      throw new Error(\n        `Invalid fee: ${feeBps} basis points (must be between 0 and ${MAX_FEE_BPS})`,\n      )\n    }\n    return feeBps\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["swapTxns: TransactionWithSigner[]","status: number","statusText: string","data: unknown","errorData: unknown","body: FetchSwapTxnsBody"],"sources":["../src/constants.ts","../src/composer.ts","../src/utils.ts","../src/client.ts"],"sourcesContent":["/**\n * Supported DEX protocols for swap routing\n */\nexport enum Protocol {\n  TinymanV2 = 'TinymanV2',\n  Algofi = 'Algofi',\n  Algomint = 'Algomint',\n  Pact = 'Pact',\n  Folks = 'Folks',\n  TAlgo = 'TAlgo',\n}\n\n/**\n * Deprecated protocols that are automatically excluded from routing\n *\n * @internal\n */\nexport const DEPRECATED_PROTOCOLS = ['Humble', 'Tinyman'] as const\n\n/** Default Algod node URI for mainnet */\nexport const DEFAULT_ALGOD_URI = 'https://mainnet-api.4160.nodely.dev/'\n\n/** Default Algod node token (empty for public nodes) */\nexport const DEFAULT_ALGOD_TOKEN = ''\n\n/** Default Algod node port */\nexport const DEFAULT_ALGOD_PORT = 443\n\n/** Default Deflex API base URL */\nexport const DEFAULT_API_BASE_URL = 'https://deflex.txnlab.dev/api'\n\n/** Default fee in basis points (0.15%) */\nexport const DEFAULT_FEE_BPS = 15\n\n/** Maximum allowed fee in basis points (3.00%) */\nexport const MAX_FEE_BPS = 300\n\n/** Default maximum transaction group size */\nexport const DEFAULT_MAX_GROUP_SIZE = 16\n\n/** Default maximum routing depth (number of hops) */\nexport const DEFAULT_MAX_DEPTH = 4\n\n/** Default auto opt-in setting (automatic asset/app opt-in detection) */\nexport const DEFAULT_AUTO_OPT_IN = false\n\n/** Default number of rounds to wait for transaction confirmation */\nexport const DEFAULT_CONFIRMATION_ROUNDS = 4\n","import {\n  AtomicTransactionComposer,\n  decodeUnsignedTransaction,\n  isValidAddress,\n  LogicSigAccount,\n  makeApplicationOptInTxnFromObject,\n  msgpackRawDecode,\n  signLogicSigTransactionObject,\n  signTransaction,\n  Transaction,\n  type ABIResult,\n  type Algodv2,\n  type TransactionSigner,\n  type TransactionWithSigner,\n} from 'algosdk'\nimport { DEFAULT_CONFIRMATION_ROUNDS } from './constants'\nimport type {\n  FetchQuoteResponse,\n  DeflexTransaction,\n  DeflexSignature,\n  DeflexQuote,\n  MethodCall,\n} from './types'\n\n/**\n * A transaction signer function that supports both standard algosdk.TransactionSigner\n * and ARC-1 compliant signers that may return null for unsigned transactions.\n *\n * @param txnGroup - The complete transaction group to sign\n * @param indexesToSign - Array of indexes indicating which transactions need signing\n * @returns Array of signed transactions (may include nulls for ARC-1 compliant wallets)\n */\nexport type SignerFunction = (\n  txnGroup: Transaction[],\n  indexesToSign: number[],\n) => Promise<(Uint8Array | null)[]>\n\n/**\n * Status of the SwapComposer transaction group lifecycle\n */\nexport enum SwapComposerStatus {\n  /** The atomic group is still under construction. */\n  BUILDING,\n\n  /** The atomic group has been finalized, but not yet signed. */\n  BUILT,\n\n  /** The atomic group has been finalized and signed, but not yet submitted to the network. */\n  SIGNED,\n\n  /** The atomic group has been finalized, signed, and submitted to the network. */\n  SUBMITTED,\n\n  /** The atomic group has been finalized, signed, submitted, and successfully committed to a block. */\n  COMMITTED,\n}\n\n/**\n * Configuration for creating a SwapComposer instance\n */\nexport interface SwapComposerConfig {\n  /** The quote response from fetchQuote() or newQuote() */\n  readonly quote: FetchQuoteResponse | DeflexQuote\n  /** The swap transactions from fetchSwapTransactions() */\n  readonly deflexTxns: DeflexTransaction[]\n  /** Algodv2 client instance */\n  readonly algodClient: Algodv2\n  /** The address of the account that will sign transactions */\n  readonly address: string\n  /** Transaction signer function */\n  readonly signer: TransactionSigner | SignerFunction\n}\n\n/**\n * Composer for building and executing atomic swap transaction groups\n *\n * The SwapComposer allows you to build complex transaction groups by adding custom\n * transactions before and after swap transactions. It handles pre-signed transactions,\n * automatic app opt-ins, and provides a fluent API for transaction group construction.\n *\n * @example\n * ```typescript\n * const quote = await deflex.fetchQuote({ ... })\n * const composer = await deflex.newSwap({ quote, address, slippage, signer })\n *\n * await composer\n *   .addTransaction(customTxn)\n *   .addSwapTransactions()\n *   .execute()\n * ```\n */\nexport class SwapComposer {\n  /** The ATC used to compose the group */\n  private atc = new AtomicTransactionComposer()\n\n  /** The maximum size of an atomic transaction group. */\n  static MAX_GROUP_SIZE: number = AtomicTransactionComposer.MAX_GROUP_SIZE\n\n  /** Whether the swap transactions have been added to the atomic group. */\n  private swapTransactionsAdded = false\n\n  private readonly requiredAppOptIns: number[]\n  private readonly deflexTxns: DeflexTransaction[]\n  private readonly algodClient: Algodv2\n  private readonly address: string\n  private readonly signer: TransactionSigner | SignerFunction\n\n  /**\n   * Create a new SwapComposer instance\n   *\n   * Note: Most developers should use DeflexClient.newSwap() instead of constructing\n   * this directly, as the factory method handles fetching swap transactions automatically.\n   *\n   * @param config - Configuration for the composer\n   * @param config.requiredAppOptIns - The quote response from fetchQuote()\n   * @param config.deflexTxns - The swap transactions from fetchSwapTransactions()\n   * @param config.algodClient - Algodv2 client instance\n   * @param config.address - The address of the account that will sign transactions\n   * @param config.signer - Transaction signer function\n   */\n  constructor(config: SwapComposerConfig) {\n    // Validate required parameters\n    if (!config.quote) {\n      throw new Error('Quote is required')\n    }\n    if (!config.deflexTxns) {\n      throw new Error('Swap transactions are required')\n    }\n    if (config.deflexTxns.length === 0) {\n      throw new Error('Swap transactions array cannot be empty')\n    }\n    if (!config.algodClient) {\n      throw new Error('Algodv2 client instance is required')\n    }\n    if (!config.signer) {\n      throw new Error('Signer is required')\n    }\n\n    this.requiredAppOptIns = config.quote.requiredAppOptIns\n    this.deflexTxns = config.deflexTxns\n    this.algodClient = config.algodClient\n    this.address = this.validateAddress(config.address)\n    this.signer = config.signer\n  }\n\n  /**\n   * Get the status of this composer's transaction group\n   *\n   * @returns The current status of the transaction group\n   */\n  getStatus(): SwapComposerStatus {\n    return this.atc.getStatus() as unknown as SwapComposerStatus\n  }\n\n  /**\n   * Get the number of transactions currently in this atomic group\n   *\n   * @returns The number of transactions in the group\n   */\n  count(): number {\n    return this.atc.count()\n  }\n\n  /**\n   * Add a transaction to the atomic group\n   *\n   * Transactions are added in the order methods are called. For example:\n   * ```typescript\n   * composer\n   *   .addTransaction(txn1)      // Added first\n   *   .addSwapTransactions()     // Added second\n   *   .addTransaction(txn2)      // Added third\n   * ```\n   *\n   * @param transaction - The transaction to add\n   * @returns This composer instance for chaining\n   * @throws Error if the composer is not in the BUILDING status\n   * @throws Error if the maximum group size is exceeded\n   */\n  addTransaction(transaction: Transaction, signer = this.defaultSigner): this {\n    this.atc.addTransaction({ txn: transaction, signer })\n    return this\n  }\n\n  /**\n   * Add a method call to the atomic group\n   *\n   * The `signer` property in the `methodCall` parameter is optional. If not provided,\n   * the signer will default to the one passed as the second parameter, or the\n   * configured signer from the constructor if no second parameter is provided.\n   *\n   * @param methodCall - The method call to add\n   * @param signer - The signer to use for the method call (defaults to constructor signer)\n   * @returns This composer instance for chaining\n   */\n  addMethodCall(methodCall: MethodCall, signer = this.defaultSigner): this {\n    this.atc.addMethodCall({\n      ...methodCall,\n      signer: methodCall.signer ?? signer,\n    })\n    return this\n  }\n\n  /**\n   * Add swap transactions to the atomic group\n   *\n   * This method automatically processes required app opt-ins and adds all swap\n   * transactions from the quote. Can only be called once per composer instance.\n   *\n   * @returns This composer instance for chaining\n   * @throws Error if the swap transactions have already been added\n   * @throws Error if the composer is not in the BUILDING status\n   * @throws Error if the maximum group size is exceeded\n   */\n  async addSwapTransactions(): Promise<this> {\n    if (this.swapTransactionsAdded) {\n      throw new Error('Swap transactions have already been added')\n    }\n\n    if (this.getStatus() !== SwapComposerStatus.BUILDING) {\n      throw new Error(\n        'Cannot add swap transactions when composer status is not BUILDING',\n      )\n    }\n\n    const processedTxns = await this.processSwapTransactions()\n    const newLength = this.atc.count() + processedTxns.length\n\n    if (newLength > SwapComposer.MAX_GROUP_SIZE) {\n      throw new Error(\n        `Adding swap transactions exceeds the maximum atomic group size of ${SwapComposer.MAX_GROUP_SIZE}`,\n      )\n    }\n\n    for (const txnWithSigner of processedTxns) {\n      this.atc.addTransaction(txnWithSigner)\n    }\n\n    this.swapTransactionsAdded = true\n    return this\n  }\n\n  /**\n   * Finalize the transaction group by assigning group IDs\n   *\n   * This method builds the atomic transaction group, assigning group IDs to all transactions\n   * if there is more than one transaction. After calling this method, the composer's status\n   * will be at least BUILT.\n   *\n   * @returns Array of transactions with their associated signers\n   *\n   * @throws Error if the group contains 0 transactions\n   *\n   * @example\n   * ```typescript\n   * const composer = await deflex.newSwap({ quote, address, slippage, signer })\n   * composer.addTransaction(customTxn)\n   *\n   * // Build the group to inspect transactions before signing\n   * const txnsWithSigners = composer.buildGroup()\n   * console.log('Group ID:', txnsWithSigners[0].txn.group)\n   * console.log('Group length:', txnsWithSigners.length)\n   * console.log('Status:', composer.getStatus()) // BUILT\n   * ```\n   */\n  buildGroup(): TransactionWithSigner[] {\n    return this.atc.buildGroup()\n  }\n\n  /**\n   * Sign the transaction group\n   *\n   * Automatically adds swap transactions if not already added, builds the atomic group,\n   * and signs all transactions using the configured signer.\n   *\n   * @returns A promise that resolves to an array of signed transaction blobs\n   *\n   * @example\n   * ```typescript\n   * const signedTxns = await composer.sign()\n   * ```\n   */\n  async sign(): Promise<Uint8Array[]> {\n    if (this.getStatus() >= SwapComposerStatus.SIGNED) {\n      return this.atc.gatherSignatures()\n    }\n\n    // Auto-add swap transactions if needed\n    if (!this.swapTransactionsAdded) {\n      await this.addSwapTransactions()\n    }\n\n    return await this.atc.gatherSignatures()\n  }\n\n  /**\n   * Submit the signed transactions to the network\n   *\n   * This method signs the transaction group (if not already signed) and submits\n   * it to the Algorand network. Does not wait for confirmation.\n   *\n   * @returns The transaction IDs\n   * @throws Error if the transaction group has already been submitted\n   *\n   * @example\n   * ```typescript\n   * const txIds = await composer.submit()\n   * console.log('Submitted transactions:', txIds)\n   * ```\n   */\n  async submit(): Promise<string[]> {\n    // Auto-add swap transactions if needed (maintains backward compatibility)\n    if (!this.swapTransactionsAdded) {\n      await this.addSwapTransactions()\n    }\n\n    return this.atc.submit(this.algodClient)\n  }\n\n  /**\n   * Execute the swap\n   *\n   * Signs the transaction group, submits it to the network, and waits for confirmation.\n   * This is the primary method for executing swaps and combines sign(), submit(), and\n   * waitForConfirmation() into a single call.\n   *\n   * @param waitRounds - The number of rounds to wait for confirmation (default: 4)\n   * @returns Object containing the confirmed round and transaction IDs\n   * @throws Error if the transaction group has already been committed\n   *\n   * @example\n   * ```typescript\n   * const result = await composer.execute()\n   * console.log(`Confirmed in round ${result.confirmedRound}`)\n   * console.log('Transaction IDs:', result.txIds)\n   * ```\n   */\n  async execute(waitRounds: number = DEFAULT_CONFIRMATION_ROUNDS): Promise<{\n    confirmedRound: bigint\n    txIds: string[]\n    methodResults: ABIResult[]\n  }> {\n    // Auto-add swap transactions if needed (maintains backward compatibility)\n    if (!this.swapTransactionsAdded) {\n      await this.addSwapTransactions()\n    }\n\n    const { txIDs, ...result } = await this.atc.execute(\n      this.algodClient,\n      waitRounds,\n    )\n\n    return {\n      ...result,\n      txIds: txIDs,\n    }\n  }\n\n  /**\n   * Validates an Algorand address\n   */\n  private validateAddress(address: string): string {\n    if (!isValidAddress(address)) {\n      throw new Error(`Invalid Algorand address: ${address}`)\n    }\n    return address\n  }\n\n  /**\n   * Processes app opt-ins and decodes swap transactions from API response\n   */\n  private async processSwapTransactions(): Promise<TransactionWithSigner[]> {\n    const appOptIns = await this.processRequiredAppOptIns()\n\n    const swapTxns: TransactionWithSigner[] = []\n    for (let i = 0; i < this.deflexTxns.length; i++) {\n      const deflexTxn = this.deflexTxns[i]\n      if (!deflexTxn) continue\n\n      try {\n        const txnBytes = Buffer.from(deflexTxn.data, 'base64')\n        const txn = decodeUnsignedTransaction(txnBytes)\n        delete txn.group\n\n        if (deflexTxn.signature !== false) {\n          // Pre-signed transaction - use custom Deflex signer\n          swapTxns.push({\n            txn,\n            signer: this.createDeflexSigner(deflexTxn.signature),\n          })\n        } else {\n          // User transaction - use configured signer\n          swapTxns.push({\n            txn,\n            signer: this.defaultSigner,\n          })\n        }\n      } catch (error) {\n        throw new Error(\n          `Failed to process swap transaction at index ${i}: ${error instanceof Error ? error.message : String(error)}`,\n        )\n      }\n    }\n\n    return [...appOptIns, ...swapTxns]\n  }\n\n  /**\n   * Creates opt-in transactions for apps the user hasn't opted into yet\n   */\n  private async processRequiredAppOptIns(): Promise<TransactionWithSigner[]> {\n    // Fetch account information\n    const accountInfo = await this.algodClient\n      .accountInformation(this.address)\n      .do()\n\n    // Check app opt-ins\n    const userApps =\n      accountInfo?.appsLocalState?.map((app) => Number(app.id)) || []\n    const appsToOptIn = this.requiredAppOptIns.filter(\n      (appId) => !userApps.includes(appId),\n    )\n\n    if (appsToOptIn.length === 0) return []\n\n    const suggestedParams = await this.algodClient.getTransactionParams().do()\n\n    return appsToOptIn.map((appId) => ({\n      txn: makeApplicationOptInTxnFromObject({\n        sender: this.address,\n        appIndex: appId,\n        suggestedParams,\n      }),\n      signer: this.defaultSigner,\n    }))\n  }\n\n  /**\n   * The default signer function that uses the configured signer\n   */\n  private defaultSigner: TransactionSigner = async (\n    txnGroup: Transaction[],\n    indexesToSign: number[],\n  ) => {\n    const result = await this.signer(txnGroup, indexesToSign)\n    return result.filter((txn): txn is Uint8Array => txn !== null)\n  }\n\n  /**\n   * Creates a TransactionSigner function for Deflex pre-signed transactions\n   */\n  private createDeflexSigner(signature: DeflexSignature): TransactionSigner {\n    return async (\n      txnGroup: Transaction[],\n      indexesToSign: number[],\n    ): Promise<Uint8Array[]> => {\n      return indexesToSign.map((i) => {\n        const txn = txnGroup[i]\n        if (!txn) throw new Error(`Transaction at index ${i} not found`)\n        return this.signDeflexTransaction(txn, signature)\n      })\n    }\n  }\n\n  /**\n   * Re-signs a Deflex transaction using the provided logic signature or secret key\n   */\n  private signDeflexTransaction(\n    transaction: Transaction,\n    signature: DeflexSignature,\n  ): Uint8Array {\n    try {\n      if (signature.type === 'logic_signature') {\n        // Decode the signature value to extract the logic signature\n        const valueArray = signature.value as Record<string, number>\n        const valueBytes = new Uint8Array(Object.values(valueArray))\n        const decoded = msgpackRawDecode(valueBytes) as {\n          lsig?: { l: Uint8Array; arg?: Uint8Array[] }\n        }\n\n        if (!decoded.lsig) {\n          throw new Error('Logic signature structure missing lsig field')\n        }\n\n        const lsig = decoded.lsig\n        const logicSigAccount = new LogicSigAccount(lsig.l, lsig.arg)\n\n        const signedTxn = signLogicSigTransactionObject(\n          transaction,\n          logicSigAccount,\n        )\n        return signedTxn.blob\n      } else if (signature.type === 'secret_key') {\n        // Convert signature.value (Record<string, number>) to Uint8Array\n        const valueArray = signature.value as Record<string, number>\n        const secretKey = new Uint8Array(Object.values(valueArray))\n        const signedTxn = signTransaction(transaction, secretKey)\n        return signedTxn.blob\n      } else {\n        throw new Error(`Unsupported signature type: ${signature.type}`)\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to re-sign transaction: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n}\n","/**\n * HTTP error with status code and response data\n */\nexport class HTTPError extends Error {\n  constructor(\n    public status: number,\n    public statusText: string,\n    public data: unknown,\n  ) {\n    super(`HTTP ${status} ${statusText}`)\n    this.name = 'HTTPError'\n  }\n}\n\n/**\n * Make an HTTP request and parse JSON response\n *\n * Simple wrapper around native fetch for API calls. Throws HTTPError for\n * non-2xx responses.\n *\n * @param url - The URL to request\n * @param options - Fetch options\n * @returns Parsed JSON response\n * @throws HTTPError if the response status is not ok\n */\nexport async function request<T>(\n  url: string,\n  options?: RequestInit,\n): Promise<T> {\n  const response = await fetch(url, options)\n\n  if (!response.ok) {\n    let errorData: unknown\n\n    try {\n      errorData = await response.json()\n    } catch {\n      try {\n        errorData = await response.text()\n      } catch {\n        errorData = 'Failed to parse error response'\n      }\n    }\n\n    throw new HTTPError(\n      response.status,\n      response.statusText,\n      JSON.stringify(errorData),\n    )\n  }\n\n  return response.json() as Promise<T>\n}\n","import { Algodv2, isValidAddress, type TransactionSigner } from 'algosdk'\nimport { SwapComposer, type SignerFunction } from './composer'\nimport {\n  DEFAULT_ALGOD_PORT,\n  DEFAULT_ALGOD_TOKEN,\n  DEFAULT_ALGOD_URI,\n  DEFAULT_API_BASE_URL,\n  DEFAULT_AUTO_OPT_IN,\n  DEFAULT_FEE_BPS,\n  DEFAULT_MAX_DEPTH,\n  DEFAULT_MAX_GROUP_SIZE,\n  DEPRECATED_PROTOCOLS,\n  MAX_FEE_BPS,\n} from './constants'\nimport { request } from './utils'\nimport type {\n  FetchQuoteResponse,\n  FetchSwapTxnsResponse,\n  DeflexConfig,\n  DeflexConfigParams,\n  FetchSwapTxnsParams,\n  FetchSwapTxnsBody,\n  FetchQuoteParams,\n  DeflexQuote,\n} from './types'\n\n/**\n * Client for interacting with the Deflex order router API\n *\n * The DeflexClient provides methods to fetch swap quotes and create transaction composers\n * for executing swaps on the Algorand blockchain. It handles API communication, transaction\n * validation, and automatic asset/app opt-in detection.\n *\n * @example\n * ```typescript\n * const deflex = new DeflexClient({\n *   apiKey: 'your-api-key',\n * })\n * ```\n *\n * @example\n * ```typescript\n * const deflex = new DeflexClient({\n *   apiKey: 'your-api-key',\n *   apiBaseUrl: 'https://deflex.txnlab.dev',\n *   algodUri: 'https://mainnet-api.4160.nodely.dev/',\n *   algodToken: '',\n *   algodPort: 443,\n *   referrerAddress: 'REFERRER_ADDRESS...',\n *   feeBps: 15,\n *   autoOptIn: false,\n * })\n * ```\n */\nexport class DeflexClient {\n  private readonly config: DeflexConfig\n  private readonly algodClient: Algodv2\n\n  /**\n   * Create a new DeflexClient instance\n   *\n   * @param config - Configuration parameters\n   * @param config.apiKey - API key for Deflex API (required)\n   * @param config.apiBaseUrl - Base URL for the Deflex API (default: https://deflex.txnlab.dev)\n   * @param config.algodUri - Algod node URI (default: https://mainnet-api.4160.nodely.dev/)\n   * @param config.algodToken - Algod node token (default: '')\n   * @param config.algodPort - Algod node port (default: 443)\n   * @param config.referrerAddress - Referrer address for fee sharing (receives 25% of swap fees)\n   * @param config.feeBps - Fee in basis points (default: 15 = 0.15%, max: 300 = 3.00%)\n   * @param config.autoOptIn - Automatically detect and add required opt-in transactions (default: false)\n   */\n  constructor(config: DeflexConfigParams) {\n    // Validate and set config\n    this.config = {\n      apiKey: this.validateApiKey(config.apiKey),\n      apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL,\n      algodUri: config.algodUri ?? DEFAULT_ALGOD_URI,\n      algodToken: config.algodToken ?? DEFAULT_ALGOD_TOKEN,\n      algodPort: config.algodPort ?? DEFAULT_ALGOD_PORT,\n      referrerAddress: config.referrerAddress\n        ? this.validateAddress(config.referrerAddress)\n        : undefined,\n      feeBps: this.validateFeeBps(config.feeBps ?? DEFAULT_FEE_BPS),\n      autoOptIn: config.autoOptIn ?? DEFAULT_AUTO_OPT_IN,\n    }\n\n    // Create Algodv2 client\n    this.algodClient = new Algodv2(\n      this.config.algodToken,\n      this.config.algodUri,\n      this.config.algodPort,\n    )\n  }\n\n  /**\n   * Fetch a swap quote from the Deflex API\n   *\n   * Requests optimal swap routing from the Deflex API. The quote includes routing\n   * information, price impact, required opt-ins, and an encrypted transaction payload.\n   *\n   * @param params - Parameters for the quote request\n   * @param params.fromASAID - The ID of the asset to swap from\n   * @param params.toASAID - The ID of the asset to swap to\n   * @param params.amount - The amount of the asset to swap in base units\n   * @param params.type - The type of the quote (default: 'fixed-input')\n   * @param params.disabledProtocols - List of protocols to disable (default: [])\n   * @param params.maxGroupSize - The maximum group size (default: 16)\n   * @param params.maxDepth - The maximum depth (default: 4)\n   * @param params.address - The address of the account that will perform the swap (recommended when using `config.autoOptIn` or `params.optIn`)\n   * @param params.optIn - Whether to include asset opt-in transaction\n   *   - If true: API reduces maxGroupSize by 1 and includes opt-in (always included, even if not needed)\n   *   - If false: No opt-in transaction included\n   *   - If undefined: Falls back to `config.autoOptIn` behavior with account check (if `params.address` is provided)\n   * @returns A FetchQuoteResponse object with routing information\n   *\n   * @example\n   * ```typescript\n   * const quote = await deflex.fetchQuote({\n   *   address: 'ABC...',\n   *   fromASAID: 0,           // ALGO\n   *   toASAID: 31566704,      // USDC\n   *   amount: 1_000_000,      // 1 ALGO\n   * })\n   * ```\n   */\n  async fetchQuote(params: FetchQuoteParams): Promise<FetchQuoteResponse> {\n    const {\n      fromASAID,\n      toASAID,\n      amount,\n      type = 'fixed-input',\n      disabledProtocols = [],\n      maxGroupSize = DEFAULT_MAX_GROUP_SIZE,\n      maxDepth = DEFAULT_MAX_DEPTH,\n      optIn,\n      address,\n    } = params\n\n    // Always include deprecated protocols in disabled list\n    const allDisabledProtocols = [\n      ...new Set([...DEPRECATED_PROTOCOLS, ...disabledProtocols]),\n    ]\n\n    let includeOptIn = optIn\n    if (includeOptIn === undefined && this.config.autoOptIn) {\n      if (address) {\n        includeOptIn = await this.needsAssetOptIn(\n          this.validateAddress(address),\n          toASAID,\n        )\n      } else {\n        console.warn(\n          'autoOptIn is enabled but no address provided to fetchQuote(). Asset opt-in check skipped.',\n        )\n      }\n    }\n\n    const url = new URL(`${this.config.apiBaseUrl}/fetchQuote`)\n\n    url.searchParams.append('apiKey', this.config.apiKey)\n    url.searchParams.append('algodUri', this.config.algodUri)\n    url.searchParams.append('algodToken', this.config.algodToken)\n    url.searchParams.append('algodPort', String(this.config.algodPort))\n    url.searchParams.append('feeBps', this.config.feeBps.toString())\n    url.searchParams.append('fromASAID', BigInt(fromASAID).toString())\n    url.searchParams.append('toASAID', BigInt(toASAID).toString())\n    url.searchParams.append('amount', BigInt(amount).toString())\n    url.searchParams.append('type', type)\n    url.searchParams.append('disabledProtocols', allDisabledProtocols.join(','))\n    url.searchParams.append('maxGroupSize', maxGroupSize.toString())\n    url.searchParams.append('maxDepth', maxDepth.toString())\n\n    if (typeof includeOptIn === 'boolean') {\n      url.searchParams.append('optIn', String(includeOptIn))\n    }\n\n    if (this.config.referrerAddress) {\n      url.searchParams.append('referrerAddress', this.config.referrerAddress)\n    }\n\n    return request<FetchQuoteResponse>(url.toString())\n  }\n\n  /**\n   * Check if asset opt-in is required for the output asset\n   *\n   * Convenience method to determine if an address needs to opt into the output asset\n   * of a swap. This is useful when you want to get a quote without requiring wallet\n   * connection upfront, but need to know whether to set `optIn: true` in fetchQuote()\n   * to ensure proper routing (as opt-ins reduce maxGroupSize by 1).\n   *\n   * Note: If you enable `config.autoOptIn`, this check is handled automatically when\n   * an address is provided to fetchQuote().\n   *\n   * @param address - The address to check\n   * @param assetId - The output asset ID to check\n   * @returns True if asset opt-in is required, false otherwise (always false for ALGO)\n   *\n   * @example\n   * ```typescript\n   * // Check if opt-in needed for output asset before fetching quote\n   * const needsOptIn = await deflex.needsAssetOptIn(userAddress, toAssetId)\n   * const quote = await deflex.fetchQuote({\n   *   fromAssetId,\n   *   toAssetId,\n   *   amount,\n   *   optIn: needsOptIn,\n   * })\n   * ```\n   */\n  async needsAssetOptIn(\n    address: string,\n    assetId: number | bigint,\n  ): Promise<boolean> {\n    // Fetch account information\n    const accountInfo = await this.algodClient.accountInformation(address).do()\n\n    // Check if asset opt-in is required\n    return (\n      BigInt(assetId) !== 0n &&\n      accountInfo?.assets?.find(\n        (asset) => asset.assetId === BigInt(assetId),\n      ) === undefined\n    )\n  }\n\n  /**\n   * Fetch swap transactions from the Deflex API\n   *\n   * Decrypts the quote payload and generates executable swap transactions for the\n   * specified signer address with the given slippage tolerance.\n   *\n   * @param params - Parameters for the swap transaction request\n   * @param params.quote - The quote response from fetchQuote()\n   * @param params.address - The address of the signer\n   * @param params.slippage - The slippage tolerance as a percentage (e.g., 1 for 1%)\n   * @returns A FetchSwapTxnsResponse object with transaction data\n   */\n  async fetchSwapTransactions(\n    params: FetchSwapTxnsParams,\n  ): Promise<FetchSwapTxnsResponse> {\n    const { quote, address, slippage } = params\n\n    // Validate signer address\n    this.validateAddress(address)\n\n    const url = new URL(`${this.config.apiBaseUrl}/fetchExecuteSwapTxns`)\n\n    const body: FetchSwapTxnsBody = {\n      apiKey: this.config.apiKey,\n      address,\n      txnPayloadJSON: quote.txnPayload,\n      slippage,\n    }\n\n    return request<FetchSwapTxnsResponse>(url.toString(), {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n    })\n  }\n\n  /**\n   * Fetch a quote and return an enhanced quote result\n   *\n   * This is the recommended way to fetch quotes. It returns an object that\n   * extends the raw API response with additional metadata and type normalization.\n   *\n   * @param params - Parameters for the quote request\n   * @param params.fromASAID - The ID of the asset to swap from\n   * @param params.toASAID - The ID of the asset to swap to\n   * @param params.amount - The amount of the asset to swap in base units\n   * @param params.type - The type of the quote (default: 'fixed-input')\n   * @param params.disabledProtocols - List of protocols to disable (default: [])\n   * @param params.maxGroupSize - The maximum group size (default: 16)\n   * @param params.maxDepth - The maximum depth (default: 4)\n   * @param params.address - The address of the account that will perform the swap (recommended when using `config.autoOptIn` or `params.optIn`)\n   * @param params.optIn - Whether to include asset opt-in transaction\n   * @returns A DeflexQuote enhanced quote result\n   *\n   * @example\n   * ```typescript\n   * const quote = await deflex.newQuote({\n   *   address: 'ABC...',\n   *   fromASAID: 0,\n   *   toASAID: 31566704,\n   *   amount: 1_000_000,\n   * })\n   *\n   * console.log(quote.quote)     // bigint - quoted amount\n   * console.log(quote.fromASAID) // number - input asset ID\n   * console.log(quote.toASAID)   // number - output asset ID\n   * console.log(quote.amount)    // bigint - original request amount\n   * console.log(quote.createdAt) // number - timestamp\n   * ```\n   */\n  async newQuote(params: FetchQuoteParams): Promise<DeflexQuote> {\n    const response = await this.fetchQuote(params)\n\n    return {\n      ...response,\n      quote: response.quote === '' ? 0n : BigInt(response.quote),\n      amount: BigInt(params.amount),\n      address: params.address ?? undefined,\n      createdAt: Date.now(),\n    }\n  }\n\n  /**\n   * Create a SwapComposer instance\n   *\n   * This factory method creates a composer that allows you to add custom transactions\n   * before and after the swap transactions, with automatic handling of pre-signed transactions\n   * and opt-ins.\n   *\n   * @param config.quote - The quote result from newQuote() or raw API response from fetchQuote()\n   * @param config.address - The address of the signer\n   * @param config.slippage - The slippage tolerance\n   * @param config.signer - Transaction signer function\n   * @returns A SwapComposer instance ready for building transaction groups\n   *\n   * @example\n   * ```typescript\n   * // Basic swap\n   * const quote = await deflex.newQuote({ ... })\n   * await deflex.newSwap({ quote, address, slippage, signer })\n   *   .execute()\n   * ```\n   *\n   * @example\n   * ```typescript\n   * // Advanced swap with custom transactions\n   * const quote = await deflex.newQuote({ ... })\n   * const swap = await deflex.newSwap({\n   *   quote,\n   *   address,\n   *   slippage,\n   *   signer,\n   * })\n   *\n   * console.log(swap.getStatus()) // BUILDING\n   *\n   * const signedTxns = await swap\n   *   .addTransaction(beforeTxn)\n   *   .addSwapTransactions() // Adds swap transactions to the group\n   *   .addTransaction(afterTxn)\n   *   .sign()\n   *\n   * console.log(swap.getStatus()) // SIGNED\n   *\n   * const result = await swap.execute(waitRounds)\n   * console.log(result.confirmedRound, result.txIds)\n   *\n   * console.log(swap.getStatus()) // COMMITTED\n   * ```\n   */\n  async newSwap(config: {\n    quote: DeflexQuote | FetchQuoteResponse\n    address: string\n    slippage: number\n    signer: TransactionSigner | SignerFunction\n  }): Promise<SwapComposer> {\n    const { quote, address, slippage, signer } = config\n\n    const swapResponse = await this.fetchSwapTransactions({\n      quote,\n      address,\n      slippage,\n    })\n\n    // Create the composer\n    const composer = new SwapComposer({\n      quote,\n      deflexTxns: swapResponse.txns,\n      algodClient: this.algodClient,\n      address,\n      signer,\n    })\n\n    return composer\n  }\n\n  /**\n   * Validates the API key\n   */\n  private validateApiKey(apiKey: string): string {\n    if (!apiKey) {\n      throw new Error('API key is required')\n    }\n    return apiKey\n  }\n\n  /**\n   * Validates an Algorand address\n   */\n  private validateAddress(address: string): string {\n    if (!isValidAddress(address)) {\n      throw new Error(`Invalid Algorand address: ${address}`)\n    }\n    return address\n  }\n\n  /**\n   * Validates the fee in basis points (max 300 = 3.00%)\n   */\n  private validateFeeBps(feeBps: number): number {\n    if (feeBps < 0 || feeBps > MAX_FEE_BPS) {\n      throw new Error(\n        `Invalid fee: ${feeBps} basis points (must be between 0 and ${MAX_FEE_BPS})`,\n      )\n    }\n    return feeBps\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@txnlab/deflex",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "TypeScript/JavaScript SDK for Deflex Order Router - smart order routing and DEX aggregation on Algorand",
   "keywords": [
     "algorand",
@@ -53,13 +53,13 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@types/node": "24.9.1",
-    "@vitest/coverage-v8": "4.0.5",
+    "@types/node": "22.19.0",
+    "@vitest/coverage-v8": "4.0.6",
     "algosdk": "3.5.2",
     "publint": "0.3.15",
     "tsdown": "0.15.12",
     "typescript": "5.9.3",
-    "vitest": "4.0.5"
+    "vitest": "4.0.6"
   },
   "peerDependencies": {
     "algosdk": "^3.0.0"