@dzapio/sdk 2.0.39 → 2.0.40

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as viem from 'viem';
-import { WalletCallReceipt as WalletCallReceipt$1, TypedDataDomain, Prettify, WalletClient, TransactionReceipt, ChainFormatters, Chain as Chain$1, Assign } from 'viem';
+import { WalletCallReceipt as WalletCallReceipt$1, Prettify, TypedDataDomain, WalletClient, TransactionReceipt, ChainFormatters, Chain as Chain$1, Assign } from 'viem';
 import { Signer } from 'ethers';
 import * as viemChains from 'viem/chains';
 import { Chain as Chain$2 } from 'viem/chains';
@@ -719,7 +719,6 @@ type TradeBuildTxnRequestData = {
     slippage: number;
     additionalInfo?: AdditionalInfo;
     permitData?: string;
-    permit?: TokenPermitData;
 };
 type ParamQuotes = {
     additionalInfo?: Record<string, unknown>;
@@ -900,7 +899,7 @@ type SignatureParamsBase = {
 type GasSignatureParams = SignatureParamsBase & {
     gasless: false;
 };
-type SignPermitResponse = {
+type PermitSingleResponse = {
     status: TxnStatus.success;
     code: StatusCodes;
     tokens: {
@@ -909,16 +908,19 @@ type SignPermitResponse = {
         amount: string;
     }[];
     permitType: PermitMode;
-} | {
+};
+type PermitBatchResponse = {
     status: TxnStatus.success;
     code: StatusCodes;
     batchPermitData: HexString;
     permitType: typeof PermitTypes.PermitBatchWitnessTransferFrom;
-} | {
+};
+type PermitErrorResponse = {
     status: Exclude<TxnStatus, typeof TxnStatus.success>;
     code: StatusCodes;
     permitType: PermitMode;
 };
+type SignPermitResponse<T extends PermitMode = PermitMode> = T extends typeof PermitTypes.AutoPermit ? PermitSingleResponse | PermitBatchResponse | PermitErrorResponse : T extends typeof PermitTypes.PermitBatchWitnessTransferFrom ? PermitBatchResponse | PermitErrorResponse : PermitSingleResponse | PermitErrorResponse;
 type BroadcastTxData = string;
 type BroadcastTxParams = {
     txId: string;
@@ -1924,12 +1926,12 @@ declare class DZapClient {
         status: TxnStatus;
         code: StatusCodes;
     }>;
-    sign(params: Prettify<Omit<GasSignatureParams, 'spender' | 'permitType' | 'rpcUrls' | 'gasless' | 'contractVersion'> & {
+    sign<T extends PermitMode = PermitMode>(params: Prettify<Omit<GasSignatureParams, 'spender' | 'permitType' | 'rpcUrls' | 'gasless' | 'contractVersion'> & {
         spender?: HexString;
-        permitType?: PermitMode;
+        permitType?: T;
         rpcUrls?: string[];
         service: AvailableDZapServices;
-    }>): Promise<SignPermitResponse>;
+    }>): Promise<SignPermitResponse<T>>;
     zap({ request, steps, signer, }: {
         request: ZapBuildTxnRequest | ZapBundleRequest;
         signer: WalletClient | Signer;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as viem from 'viem';
-import { WalletCallReceipt as WalletCallReceipt$1, TypedDataDomain, Prettify, WalletClient, TransactionReceipt, ChainFormatters, Chain as Chain$1, Assign } from 'viem';
+import { WalletCallReceipt as WalletCallReceipt$1, Prettify, TypedDataDomain, WalletClient, TransactionReceipt, ChainFormatters, Chain as Chain$1, Assign } from 'viem';
 import { Signer } from 'ethers';
 import * as viemChains from 'viem/chains';
 import { Chain as Chain$2 } from 'viem/chains';
@@ -719,7 +719,6 @@ type TradeBuildTxnRequestData = {
     slippage: number;
     additionalInfo?: AdditionalInfo;
     permitData?: string;
-    permit?: TokenPermitData;
 };
 type ParamQuotes = {
     additionalInfo?: Record<string, unknown>;
@@ -900,7 +899,7 @@ type SignatureParamsBase = {
 type GasSignatureParams = SignatureParamsBase & {
     gasless: false;
 };
-type SignPermitResponse = {
+type PermitSingleResponse = {
     status: TxnStatus.success;
     code: StatusCodes;
     tokens: {
@@ -909,16 +908,19 @@ type SignPermitResponse = {
         amount: string;
     }[];
     permitType: PermitMode;
-} | {
+};
+type PermitBatchResponse = {
     status: TxnStatus.success;
     code: StatusCodes;
     batchPermitData: HexString;
     permitType: typeof PermitTypes.PermitBatchWitnessTransferFrom;
-} | {
+};
+type PermitErrorResponse = {
     status: Exclude<TxnStatus, typeof TxnStatus.success>;
     code: StatusCodes;
     permitType: PermitMode;
 };
+type SignPermitResponse<T extends PermitMode = PermitMode> = T extends typeof PermitTypes.AutoPermit ? PermitSingleResponse | PermitBatchResponse | PermitErrorResponse : T extends typeof PermitTypes.PermitBatchWitnessTransferFrom ? PermitBatchResponse | PermitErrorResponse : PermitSingleResponse | PermitErrorResponse;
 type BroadcastTxData = string;
 type BroadcastTxParams = {
     txId: string;
@@ -1924,12 +1926,12 @@ declare class DZapClient {
         status: TxnStatus;
         code: StatusCodes;
     }>;
-    sign(params: Prettify<Omit<GasSignatureParams, 'spender' | 'permitType' | 'rpcUrls' | 'gasless' | 'contractVersion'> & {
+    sign<T extends PermitMode = PermitMode>(params: Prettify<Omit<GasSignatureParams, 'spender' | 'permitType' | 'rpcUrls' | 'gasless' | 'contractVersion'> & {
         spender?: HexString;
-        permitType?: PermitMode;
+        permitType?: T;
         rpcUrls?: string[];
         service: AvailableDZapServices;
-    }>): Promise<SignPermitResponse>;
+    }>): Promise<SignPermitResponse<T>>;
     zap({ request, steps, signer, }: {
         request: ZapBuildTxnRequest | ZapBundleRequest;
         signer: WalletClient | Signer;

package/dist/index.js

@@ -765,7 +765,9 @@ var DZapPriceProvider = class {
     this.requiresChainConfig = false;
     this.fetchPrices = async (chainId, tokenAddresses) => {
       try {
-        const tokenPrices = await fetchTokenPrice(tokenAddresses, chainId);
+        if (tokenAddresses.length === 0) return {};
+        const tokens = tokenAddresses.join(",");
+        const tokenPrices = await fetchTokenPrice(tokens, chainId);
         return tokenPrices;
       } catch (e) {
         console.error("Failed to fetch token price", e);
@@ -14278,6 +14280,97 @@ var getPermit2Signature = async (params) => {
 
 // src/transactionHandlers/permit.ts
 var _PermitTxnHandler = class _PermitTxnHandler {
+  static async signPermit(signPermitReq) {
+    const { tokens } = signPermitReq;
+    if (tokens.length === 0) {
+      if (signPermitReq.permitType === PermitTypes.PermitBatchWitnessTransferFrom) {
+        return {
+          status: "success" /* success */,
+          code: 200 /* Success */,
+          batchPermitData: DEFAULT_PERMIT2_DATA,
+          permitType: PermitTypes.PermitBatchWitnessTransferFrom
+        };
+      }
+      return { status: "success" /* success */, code: 200 /* Success */, tokens, permitType: signPermitReq.permitType };
+    }
+    const oneToMany = tokens.length > 1 && isOneToMany(tokens[0].address, tokens[1].address);
+    const shouldUseBatchPermit = _PermitTxnHandler.shouldUseBatchPermit({
+      permitType: signPermitReq.permitType,
+      isBatchPermitAllowed: signPermitReq.isBatchPermitAllowed,
+      tokens,
+      oneToMany,
+      contractVersion: signPermitReq.contractVersion,
+      service: signPermitReq.service
+    });
+    if (shouldUseBatchPermit) {
+      const resp = await _PermitTxnHandler.generateBatchPermitDataForTokens({
+        ...signPermitReq,
+        tokens: tokens.map((token, index) => ({ ...token, index })),
+        account: signPermitReq.sender,
+        permitType: PermitTypes.PermitBatchWitnessTransferFrom
+        //override because only PermitBatchWitnessTransferFrom supports batch
+      });
+      if (resp.status !== "success" /* success */) {
+        return { status: resp.status, code: resp.code, permitType: PermitTypes.PermitBatchWitnessTransferFrom };
+      }
+      if (signPermitReq.signatureCallback) {
+        await signPermitReq.signatureCallback({
+          batchPermitData: resp.permitData,
+          tokens,
+          permitType: resp.permitType
+        });
+      }
+      return {
+        status: "success" /* success */,
+        code: 200 /* Success */,
+        batchPermitData: resp.permitData,
+        permitType: resp.permitType
+      };
+    } else {
+      if (signPermitReq.permitType === PermitTypes.PermitBatchWitnessTransferFrom) {
+        return { status: "error" /* error */, code: 500 /* Error */, permitType: PermitTypes.PermitBatchWitnessTransferFrom };
+      }
+      const totalSrcAmount = calcTotalSrcTokenAmount(tokens);
+      let firstTokenNonce = null;
+      let permitType = _PermitTxnHandler.v1PermitSupport({
+        contractVersion: signPermitReq.contractVersion,
+        service: signPermitReq.service
+      }) ? PermitTypes.PermitSingle : signPermitReq.permitType;
+      for (let dataIdx = 0; dataIdx < tokens.length; dataIdx++) {
+        const isFirstToken = dataIdx === 0;
+        const res = await _PermitTxnHandler.generatePermitDataForToken({
+          ...signPermitReq,
+          token: {
+            ...tokens[dataIdx],
+            index: dataIdx
+          },
+          firstTokenNonce: firstTokenNonce ?? void 0,
+          oneToMany,
+          totalSrcAmount,
+          account: signPermitReq.sender,
+          permitType
+        });
+        permitType = res.permitType;
+        if (res.status !== "success" /* success */) {
+          return { status: res.status, code: res.code, permitType: res.permitType };
+        }
+        tokens[dataIdx].permitData = res.permitData;
+        if (isFirstToken && !isDZapNativeToken(tokens[dataIdx].address)) {
+          firstTokenNonce = res.nonce ?? null;
+        }
+        if (signPermitReq.signatureCallback && !isDZapNativeToken(tokens[dataIdx].address)) {
+          const amount = oneToMany && isFirstToken ? totalSrcAmount : BigInt(tokens[dataIdx].amount);
+          await signPermitReq.signatureCallback({
+            permitData: res.permitData,
+            srcToken: tokens[dataIdx].address,
+            amount: amount.toString(),
+            permitType: res.permitType
+          });
+        }
+      }
+      return { status: "success" /* success */, tokens, code: 200 /* Success */, permitType };
+    }
+  }
 };
 _PermitTxnHandler.generateBatchPermitDataForTokens = async (params) => {
   const resp = await getPermit2Signature(params);
@@ -14414,83 +14507,6 @@ _PermitTxnHandler.shouldUseBatchPermit = ({
   const isContractSupport = !_PermitTxnHandler.v1PermitSupport({ contractVersion, service });
   return isBatchPermitAllowed && (isBatchPermitRequested || shouldAutoBatch) && isContractSupport;
 };
-_PermitTxnHandler.signPermit = async (signPermitReq) => {
-  const { tokens } = signPermitReq;
-  if (tokens.length === 0) {
-    return { status: "success" /* success */, code: 200 /* Success */, tokens, permitType: signPermitReq.permitType };
-  }
-  const oneToMany = tokens.length > 1 && isOneToMany(tokens[0].address, tokens[1].address);
-  const shouldUseBatchPermit = _PermitTxnHandler.shouldUseBatchPermit({
-    permitType: signPermitReq.permitType,
-    isBatchPermitAllowed: signPermitReq.isBatchPermitAllowed,
-    tokens,
-    oneToMany,
-    contractVersion: signPermitReq.contractVersion,
-    service: signPermitReq.service
-  });
-  if (shouldUseBatchPermit) {
-    const resp = await _PermitTxnHandler.generateBatchPermitDataForTokens({
-      ...signPermitReq,
-      tokens: tokens.map((token, index) => ({ ...token, index })),
-      account: signPermitReq.sender,
-      permitType: PermitTypes.PermitBatchWitnessTransferFrom
-      //override because only PermitBatchWitnessTransferFrom supports batch
-    });
-    if (resp.status !== "success" /* success */) {
-      return { status: resp.status, code: resp.code, permitType: PermitTypes.PermitBatchWitnessTransferFrom };
-    }
-    if (signPermitReq.signatureCallback) {
-      await signPermitReq.signatureCallback({
-        batchPermitData: resp.permitData,
-        tokens,
-        permitType: resp.permitType
-      });
-    }
-    return {
-      status: "success" /* success */,
-      code: 200 /* Success */,
-      batchPermitData: resp.permitData,
-      permitType: resp.permitType
-    };
-  } else {
-    const totalSrcAmount = calcTotalSrcTokenAmount(tokens);
-    let firstTokenNonce = null;
-    let permitType = _PermitTxnHandler.v1PermitSupport({ contractVersion: signPermitReq.contractVersion, service: signPermitReq.service }) ? PermitTypes.PermitSingle : signPermitReq.permitType;
-    for (let dataIdx = 0; dataIdx < tokens.length; dataIdx++) {
-      const isFirstToken = dataIdx === 0;
-      const res = await _PermitTxnHandler.generatePermitDataForToken({
-        ...signPermitReq,
-        token: {
-          ...tokens[dataIdx],
-          index: dataIdx
-        },
-        firstTokenNonce: firstTokenNonce ?? void 0,
-        oneToMany,
-        totalSrcAmount,
-        account: signPermitReq.sender,
-        permitType
-      });
-      permitType = res.permitType;
-      if (res.status !== "success" /* success */) {
-        return { status: res.status, code: res.code, permitType: res.permitType };
-      }
-      tokens[dataIdx].permitData = res.permitData;
-      if (isFirstToken && !isDZapNativeToken(tokens[dataIdx].address)) {
-        firstTokenNonce = res.nonce ?? null;
-      }
-      if (signPermitReq.signatureCallback && !isDZapNativeToken(tokens[dataIdx].address)) {
-        const amount = oneToMany && isFirstToken ? totalSrcAmount : BigInt(tokens[dataIdx].amount);
-        await signPermitReq.signatureCallback({
-          permitData: res.permitData,
-          srcToken: tokens[dataIdx].address,
-          amount: amount.toString(),
-          permitType: res.permitType
-        });
-      }
-    }
-    return { status: "success" /* success */, tokens, code: 200 /* Success */, permitType };
-  }
-};
 var PermitTxnHandler = _PermitTxnHandler;
 var permit_default = PermitTxnHandler;
 function encodeApproveCallData({ spender, amount }) {
@@ -16004,11 +16020,19 @@ var _DZapClient = class _DZapClient {
    * @param params.permitType - Optional permit type (defaults to AutoPermit for optimal compatibility)
    * @param params.signatureCallback - Optional callback function for each completed signature
    * @param params.spender - Optional custom spender address (if not using default DZap contract)
-   * @returns Promise resolving to permit signatures and related data
+   * @returns Promise resolving to a {@link SignPermitResponse}, narrowed by the requested `permitType`:
+   *   - `AutoPermit` (default): `PermitSingleResponse | PermitBatchResponse | PermitErrorResponse` — the
+   *     effective mode is chosen at runtime, so narrow with `'batchPermitData' in result`.
+   *   - `PermitBatchWitnessTransferFrom`: `PermitBatchResponse | PermitErrorResponse`. If batch cannot be
+   *     fulfilled (e.g. a v1 contract or batch permits disabled) the result is an error rather than a
+   *     silent single-permit downgrade, so `batchPermitData` is guaranteed present on success.
+   *   - Any other (single) mode: `PermitSingleResponse | PermitErrorResponse`.
+   *   Always check `status === TxnStatus.success` before reading mode-specific fields.
    *
    * @example
    * ```typescript
-   * const permitResult = await client.sign({
+   * // Explicit batch request -> result is typed PermitBatchResponse | PermitErrorResponse
+   * const result = await client.sign({
    *   chainId: 1,
    *   sender: '0x...',
    *   tokens: [
@@ -16016,11 +16040,14 @@ var _DZapClient = class _DZapClient {
    *   ],
    *   service: 'swap',
    *   signer: walletClient,
-   *   permitType: PermitTypes.Permit2,
-   *   signatureCallback: async ({ permitData, srcToken }) => {
-   *     console.log(`Signed permit for ${srcToken}:`, permitData);
-   *   }
+   *   permitType: PermitTypes.PermitBatchWitnessTransferFrom,
    * });
+   *
+   * if (result.status === TxnStatus.success) {
+   *   console.log('batch permit:', result.batchPermitData);
+   * } else {
+   *   console.log('batch permit could not be produced:', result.code);
+   * }
    * ```
    */
   async sign(params) {

package/dist/index.mjs

@@ -739,7 +739,9 @@ var DZapPriceProvider = class {
     this.requiresChainConfig = false;
     this.fetchPrices = async (chainId, tokenAddresses) => {
       try {
-        const tokenPrices = await fetchTokenPrice(tokenAddresses, chainId);
+        if (tokenAddresses.length === 0) return {};
+        const tokens = tokenAddresses.join(",");
+        const tokenPrices = await fetchTokenPrice(tokens, chainId);
         return tokenPrices;
       } catch (e) {
         console.error("Failed to fetch token price", e);
@@ -14252,6 +14254,97 @@ var getPermit2Signature = async (params) => {
 
 // src/transactionHandlers/permit.ts
 var _PermitTxnHandler = class _PermitTxnHandler {
+  static async signPermit(signPermitReq) {
+    const { tokens } = signPermitReq;
+    if (tokens.length === 0) {
+      if (signPermitReq.permitType === PermitTypes.PermitBatchWitnessTransferFrom) {
+        return {
+          status: "success" /* success */,
+          code: 200 /* Success */,
+          batchPermitData: DEFAULT_PERMIT2_DATA,
+          permitType: PermitTypes.PermitBatchWitnessTransferFrom
+        };
+      }
+      return { status: "success" /* success */, code: 200 /* Success */, tokens, permitType: signPermitReq.permitType };
+    }
+    const oneToMany = tokens.length > 1 && isOneToMany(tokens[0].address, tokens[1].address);
+    const shouldUseBatchPermit = _PermitTxnHandler.shouldUseBatchPermit({
+      permitType: signPermitReq.permitType,
+      isBatchPermitAllowed: signPermitReq.isBatchPermitAllowed,
+      tokens,
+      oneToMany,
+      contractVersion: signPermitReq.contractVersion,
+      service: signPermitReq.service
+    });
+    if (shouldUseBatchPermit) {
+      const resp = await _PermitTxnHandler.generateBatchPermitDataForTokens({
+        ...signPermitReq,
+        tokens: tokens.map((token, index) => ({ ...token, index })),
+        account: signPermitReq.sender,
+        permitType: PermitTypes.PermitBatchWitnessTransferFrom
+        //override because only PermitBatchWitnessTransferFrom supports batch
+      });
+      if (resp.status !== "success" /* success */) {
+        return { status: resp.status, code: resp.code, permitType: PermitTypes.PermitBatchWitnessTransferFrom };
+      }
+      if (signPermitReq.signatureCallback) {
+        await signPermitReq.signatureCallback({
+          batchPermitData: resp.permitData,
+          tokens,
+          permitType: resp.permitType
+        });
+      }
+      return {
+        status: "success" /* success */,
+        code: 200 /* Success */,
+        batchPermitData: resp.permitData,
+        permitType: resp.permitType
+      };
+    } else {
+      if (signPermitReq.permitType === PermitTypes.PermitBatchWitnessTransferFrom) {
+        return { status: "error" /* error */, code: 500 /* Error */, permitType: PermitTypes.PermitBatchWitnessTransferFrom };
+      }
+      const totalSrcAmount = calcTotalSrcTokenAmount(tokens);
+      let firstTokenNonce = null;
+      let permitType = _PermitTxnHandler.v1PermitSupport({
+        contractVersion: signPermitReq.contractVersion,
+        service: signPermitReq.service
+      }) ? PermitTypes.PermitSingle : signPermitReq.permitType;
+      for (let dataIdx = 0; dataIdx < tokens.length; dataIdx++) {
+        const isFirstToken = dataIdx === 0;
+        const res = await _PermitTxnHandler.generatePermitDataForToken({
+          ...signPermitReq,
+          token: {
+            ...tokens[dataIdx],
+            index: dataIdx
+          },
+          firstTokenNonce: firstTokenNonce ?? void 0,
+          oneToMany,
+          totalSrcAmount,
+          account: signPermitReq.sender,
+          permitType
+        });
+        permitType = res.permitType;
+        if (res.status !== "success" /* success */) {
+          return { status: res.status, code: res.code, permitType: res.permitType };
+        }
+        tokens[dataIdx].permitData = res.permitData;
+        if (isFirstToken && !isDZapNativeToken(tokens[dataIdx].address)) {
+          firstTokenNonce = res.nonce ?? null;
+        }
+        if (signPermitReq.signatureCallback && !isDZapNativeToken(tokens[dataIdx].address)) {
+          const amount = oneToMany && isFirstToken ? totalSrcAmount : BigInt(tokens[dataIdx].amount);
+          await signPermitReq.signatureCallback({
+            permitData: res.permitData,
+            srcToken: tokens[dataIdx].address,
+            amount: amount.toString(),
+            permitType: res.permitType
+          });
+        }
+      }
+      return { status: "success" /* success */, tokens, code: 200 /* Success */, permitType };
+    }
+  }
 };
 _PermitTxnHandler.generateBatchPermitDataForTokens = async (params) => {
   const resp = await getPermit2Signature(params);
@@ -14388,83 +14481,6 @@ _PermitTxnHandler.shouldUseBatchPermit = ({
   const isContractSupport = !_PermitTxnHandler.v1PermitSupport({ contractVersion, service });
   return isBatchPermitAllowed && (isBatchPermitRequested || shouldAutoBatch) && isContractSupport;
 };
-_PermitTxnHandler.signPermit = async (signPermitReq) => {
-  const { tokens } = signPermitReq;
-  if (tokens.length === 0) {
-    return { status: "success" /* success */, code: 200 /* Success */, tokens, permitType: signPermitReq.permitType };
-  }
-  const oneToMany = tokens.length > 1 && isOneToMany(tokens[0].address, tokens[1].address);
-  const shouldUseBatchPermit = _PermitTxnHandler.shouldUseBatchPermit({
-    permitType: signPermitReq.permitType,
-    isBatchPermitAllowed: signPermitReq.isBatchPermitAllowed,
-    tokens,
-    oneToMany,
-    contractVersion: signPermitReq.contractVersion,
-    service: signPermitReq.service
-  });
-  if (shouldUseBatchPermit) {
-    const resp = await _PermitTxnHandler.generateBatchPermitDataForTokens({
-      ...signPermitReq,
-      tokens: tokens.map((token, index) => ({ ...token, index })),
-      account: signPermitReq.sender,
-      permitType: PermitTypes.PermitBatchWitnessTransferFrom
-      //override because only PermitBatchWitnessTransferFrom supports batch
-    });
-    if (resp.status !== "success" /* success */) {
-      return { status: resp.status, code: resp.code, permitType: PermitTypes.PermitBatchWitnessTransferFrom };
-    }
-    if (signPermitReq.signatureCallback) {
-      await signPermitReq.signatureCallback({
-        batchPermitData: resp.permitData,
-        tokens,
-        permitType: resp.permitType
-      });
-    }
-    return {
-      status: "success" /* success */,
-      code: 200 /* Success */,
-      batchPermitData: resp.permitData,
-      permitType: resp.permitType
-    };
-  } else {
-    const totalSrcAmount = calcTotalSrcTokenAmount(tokens);
-    let firstTokenNonce = null;
-    let permitType = _PermitTxnHandler.v1PermitSupport({ contractVersion: signPermitReq.contractVersion, service: signPermitReq.service }) ? PermitTypes.PermitSingle : signPermitReq.permitType;
-    for (let dataIdx = 0; dataIdx < tokens.length; dataIdx++) {
-      const isFirstToken = dataIdx === 0;
-      const res = await _PermitTxnHandler.generatePermitDataForToken({
-        ...signPermitReq,
-        token: {
-          ...tokens[dataIdx],
-          index: dataIdx
-        },
-        firstTokenNonce: firstTokenNonce ?? void 0,
-        oneToMany,
-        totalSrcAmount,
-        account: signPermitReq.sender,
-        permitType
-      });
-      permitType = res.permitType;
-      if (res.status !== "success" /* success */) {
-        return { status: res.status, code: res.code, permitType: res.permitType };
-      }
-      tokens[dataIdx].permitData = res.permitData;
-      if (isFirstToken && !isDZapNativeToken(tokens[dataIdx].address)) {
-        firstTokenNonce = res.nonce ?? null;
-      }
-      if (signPermitReq.signatureCallback && !isDZapNativeToken(tokens[dataIdx].address)) {
-        const amount = oneToMany && isFirstToken ? totalSrcAmount : BigInt(tokens[dataIdx].amount);
-        await signPermitReq.signatureCallback({
-          permitData: res.permitData,
-          srcToken: tokens[dataIdx].address,
-          amount: amount.toString(),
-          permitType: res.permitType
-        });
-      }
-    }
-    return { status: "success" /* success */, tokens, code: 200 /* Success */, permitType };
-  }
-};
 var PermitTxnHandler = _PermitTxnHandler;
 var permit_default = PermitTxnHandler;
 function encodeApproveCallData({ spender, amount }) {
@@ -15978,11 +15994,19 @@ var _DZapClient = class _DZapClient {
    * @param params.permitType - Optional permit type (defaults to AutoPermit for optimal compatibility)
    * @param params.signatureCallback - Optional callback function for each completed signature
    * @param params.spender - Optional custom spender address (if not using default DZap contract)
-   * @returns Promise resolving to permit signatures and related data
+   * @returns Promise resolving to a {@link SignPermitResponse}, narrowed by the requested `permitType`:
+   *   - `AutoPermit` (default): `PermitSingleResponse | PermitBatchResponse | PermitErrorResponse` — the
+   *     effective mode is chosen at runtime, so narrow with `'batchPermitData' in result`.
+   *   - `PermitBatchWitnessTransferFrom`: `PermitBatchResponse | PermitErrorResponse`. If batch cannot be
+   *     fulfilled (e.g. a v1 contract or batch permits disabled) the result is an error rather than a
+   *     silent single-permit downgrade, so `batchPermitData` is guaranteed present on success.
+   *   - Any other (single) mode: `PermitSingleResponse | PermitErrorResponse`.
+   *   Always check `status === TxnStatus.success` before reading mode-specific fields.
    *
    * @example
    * ```typescript
-   * const permitResult = await client.sign({
+   * // Explicit batch request -> result is typed PermitBatchResponse | PermitErrorResponse
+   * const result = await client.sign({
    *   chainId: 1,
    *   sender: '0x...',
    *   tokens: [
@@ -15990,11 +16014,14 @@ var _DZapClient = class _DZapClient {
    *   ],
    *   service: 'swap',
    *   signer: walletClient,
-   *   permitType: PermitTypes.Permit2,
-   *   signatureCallback: async ({ permitData, srcToken }) => {
-   *     console.log(`Signed permit for ${srcToken}:`, permitData);
-   *   }
+   *   permitType: PermitTypes.PermitBatchWitnessTransferFrom,
    * });
+   *
+   * if (result.status === TxnStatus.success) {
+   *   console.log('batch permit:', result.batchPermitData);
+   * } else {
+   *   console.log('batch permit could not be produced:', result.code);
+   * }
    * ```
    */
   async sign(params) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzapio/sdk",
-  "version": "2.0.39",
+  "version": "2.0.40",
   "description": "A TypeScript/JavaScript SDK for interacting with the DZap protocol, providing utilities for DeFi operations including Swaps, Bridges, and Zaps.",
   "main": "dist/index.js",
   "source": "src/index.ts",