@dzapio/sdk 2.0.39 → 2.0.41

package/dist/index.d.mts

@@ -719,7 +719,6 @@ type TradeBuildTxnRequestData = {
     slippage: number;
     additionalInfo?: AdditionalInfo;
     permitData?: string;
-    permit?: TokenPermitData;
 };
 type ParamQuotes = {
     additionalInfo?: Record<string, unknown>;
@@ -754,7 +753,19 @@ type BtclnTxData = {
     paymentRequest: string;
     paymentExpiry: number;
 };
-type TxData = EvmTxData | SvmTxData | BtcTxData | BtclnTxData;
+type HyperLiquidSignTypedData<M extends Record<string, unknown> = Record<string, unknown>> = {
+    domain: TypedDataDomain;
+    types: Record<string, {
+        name: string;
+        type: string;
+    }[]>;
+    primaryType: string;
+    message: M;
+};
+type HyperLiquidTxData = {
+    signTypedData: HyperLiquidSignTypedData[];
+};
+type TxData = EvmTxData | SvmTxData | BtcTxData | BtclnTxData | HyperLiquidTxData;
 type TxRequestData<T> = {
     status: typeof STATUS.success;
     txId: string;
@@ -900,7 +911,7 @@ type SignatureParamsBase = {
 type GasSignatureParams = SignatureParamsBase & {
     gasless: false;
 };
-type SignPermitResponse = {
+type PermitSingleResponse = {
     status: TxnStatus.success;
     code: StatusCodes;
     tokens: {
@@ -909,17 +920,27 @@ 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 BroadcastTxData = string;
+type SignPermitResponse<T extends PermitMode = PermitMode> = T extends typeof PermitTypes.AutoPermit ? PermitSingleResponse | PermitBatchResponse | PermitErrorResponse : T extends typeof PermitTypes.PermitBatchWitnessTransferFrom ? PermitBatchResponse | PermitErrorResponse : PermitSingleResponse | PermitErrorResponse;
+type HyperLiquidBroadcastTxData = {
+    message: Record<string, unknown>;
+    primaryType: string;
+    signatureChainId: number;
+    signature: HexString;
+    account: HexString;
+};
+type BroadcastTxData = string | HyperLiquidBroadcastTxData[];
 type BroadcastTxParams = {
     txId: string;
     chainId: number;
@@ -1924,12 +1945,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;
@@ -2249,7 +2270,7 @@ declare const hyperliquid: {
         };
     };
     ensTlds?: readonly string[] | undefined;
-    id: 998;
+    id: 1337;
     name: "Hyperliquid";
     nativeCurrency: {
         readonly name: "HYPE";
@@ -2421,4 +2442,4 @@ declare const citrea: {
 declare const customViemChains: viemChains.Chain[];
 declare const viemChainsById: Record<number, viemChains.Chain>;
 
-export { type AllowanceType, AllowanceTypes, type ApiRpcResponse, type ApprovalMode, ApprovalModes, type BatchPermitCallbackParams, type BtcTxData, type BtclnTxData, type Chain, type ChainData, type ContractErrorResponse, DZapClient, DZapPermitMode, type DZapTransactionResponse, type EvmTxData, type Fee, type FeeDetails, type GaslessTradeBuildTxnResponse, type HexString, OtherAbis, type ParamQuotes, type PermitMode, PermitTypes, type ProviderDetails, type PsbtInput, type PsbtOutput, type QuoteFilter, QuoteFilters, STATUS, type SVMTxnDetails, Services, type SignPermitResponse, type SignatureCallbackParams, SignatureExpiryInSecs, type SinglePermitCallbackParams, StatusCodes, type StepAction, type SvmTxData, type SwapInfo, SwapInputDataDecoder, type Token, type TokenInfo, type TokenPermitData, type TokenResponse, type TradeBuildTxnRequest, type TradeBuildTxnRequestData, type TradeBuildTxnResponse, type TradeGasBuildTxnResponse, type TradePath, type TradeQuotesRequest, type TradeQuotesRequestData, type TradeQuotesResponse, type TradeStatusResponse, type TradeStep, TxnStatus, type ZapBuildTxnRequest, type ZapBuildTxnResponse, type ZapBundleAction, type ZapBundleRequest, type ZapBundleSrcToken, type ZapBvmTxnDetails, type ZapChains, type ZapEvmTxnDetails, type ZapFee, type ZapIntegratorConfig, type ZapPath, type ZapPathAction, type ZapPathAsset, type ZapPool, type ZapPoolDetails, type ZapPoolDetailsRequest, type ZapPoolsRequest, type ZapPoolsResponse, type ZapPosition, type ZapPositionsRequest, type ZapPositionsResponse, type ZapProviders, type ZapQuoteRequest, type ZapQuoteResponse, type ZapRouteRequestPoolDetails, type ZapRouteRequestPositionDetails, type ZapStatus, type ZapStatusAsset, type ZapStatusRequest, type ZapStatusResponse, type ZapStatusStep, type ZapStep, type ZapTransactionStep, type ZapTxnDetails, type ZapUnderlyingToken, type ZapUnderlyingTokenWithAmount, arthera, astralisTestnet, checkEIP2612PermitSupport, citrea, classifyAddress, contractErrorActions, customViemChains, erc20Functions, extendViemChain, fiveIre, formatToken, getTokensPairKey, hemi, hyperEvm, hyperliquid, pushTestnet, stableChain, tempo, viemChainsById, zapPathAction, zapStepAction };
+export { type AllowanceType, AllowanceTypes, type ApiRpcResponse, type ApprovalMode, ApprovalModes, type BatchPermitCallbackParams, type BtcTxData, type BtclnTxData, type Chain, type ChainData, type ContractErrorResponse, DZapClient, DZapPermitMode, type DZapTransactionResponse, type EvmTxData, type Fee, type FeeDetails, type GaslessTradeBuildTxnResponse, type HexString, type HyperLiquidTxData, OtherAbis, type ParamQuotes, type PermitMode, PermitTypes, type ProviderDetails, type PsbtInput, type PsbtOutput, type QuoteFilter, QuoteFilters, STATUS, type SVMTxnDetails, Services, type SignPermitResponse, type SignatureCallbackParams, SignatureExpiryInSecs, type SinglePermitCallbackParams, StatusCodes, type StepAction, type SvmTxData, type SwapInfo, SwapInputDataDecoder, type Token, type TokenInfo, type TokenPermitData, type TokenResponse, type TradeBuildTxnRequest, type TradeBuildTxnRequestData, type TradeBuildTxnResponse, type TradeGasBuildTxnResponse, type TradePath, type TradeQuotesRequest, type TradeQuotesRequestData, type TradeQuotesResponse, type TradeStatusResponse, type TradeStep, TxnStatus, type ZapBuildTxnRequest, type ZapBuildTxnResponse, type ZapBundleAction, type ZapBundleRequest, type ZapBundleSrcToken, type ZapBvmTxnDetails, type ZapChains, type ZapEvmTxnDetails, type ZapFee, type ZapIntegratorConfig, type ZapPath, type ZapPathAction, type ZapPathAsset, type ZapPool, type ZapPoolDetails, type ZapPoolDetailsRequest, type ZapPoolsRequest, type ZapPoolsResponse, type ZapPosition, type ZapPositionsRequest, type ZapPositionsResponse, type ZapProviders, type ZapQuoteRequest, type ZapQuoteResponse, type ZapRouteRequestPoolDetails, type ZapRouteRequestPositionDetails, type ZapStatus, type ZapStatusAsset, type ZapStatusRequest, type ZapStatusResponse, type ZapStatusStep, type ZapStep, type ZapTransactionStep, type ZapTxnDetails, type ZapUnderlyingToken, type ZapUnderlyingTokenWithAmount, arthera, astralisTestnet, checkEIP2612PermitSupport, citrea, classifyAddress, contractErrorActions, customViemChains, erc20Functions, extendViemChain, fiveIre, formatToken, getTokensPairKey, hemi, hyperEvm, hyperliquid, pushTestnet, stableChain, tempo, viemChainsById, zapPathAction, zapStepAction };

package/dist/index.d.ts

@@ -719,7 +719,6 @@ type TradeBuildTxnRequestData = {
     slippage: number;
     additionalInfo?: AdditionalInfo;
     permitData?: string;
-    permit?: TokenPermitData;
 };
 type ParamQuotes = {
     additionalInfo?: Record<string, unknown>;
@@ -754,7 +753,19 @@ type BtclnTxData = {
     paymentRequest: string;
     paymentExpiry: number;
 };
-type TxData = EvmTxData | SvmTxData | BtcTxData | BtclnTxData;
+type HyperLiquidSignTypedData<M extends Record<string, unknown> = Record<string, unknown>> = {
+    domain: TypedDataDomain;
+    types: Record<string, {
+        name: string;
+        type: string;
+    }[]>;
+    primaryType: string;
+    message: M;
+};
+type HyperLiquidTxData = {
+    signTypedData: HyperLiquidSignTypedData[];
+};
+type TxData = EvmTxData | SvmTxData | BtcTxData | BtclnTxData | HyperLiquidTxData;
 type TxRequestData<T> = {
     status: typeof STATUS.success;
     txId: string;
@@ -900,7 +911,7 @@ type SignatureParamsBase = {
 type GasSignatureParams = SignatureParamsBase & {
     gasless: false;
 };
-type SignPermitResponse = {
+type PermitSingleResponse = {
     status: TxnStatus.success;
     code: StatusCodes;
     tokens: {
@@ -909,17 +920,27 @@ 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 BroadcastTxData = string;
+type SignPermitResponse<T extends PermitMode = PermitMode> = T extends typeof PermitTypes.AutoPermit ? PermitSingleResponse | PermitBatchResponse | PermitErrorResponse : T extends typeof PermitTypes.PermitBatchWitnessTransferFrom ? PermitBatchResponse | PermitErrorResponse : PermitSingleResponse | PermitErrorResponse;
+type HyperLiquidBroadcastTxData = {
+    message: Record<string, unknown>;
+    primaryType: string;
+    signatureChainId: number;
+    signature: HexString;
+    account: HexString;
+};
+type BroadcastTxData = string | HyperLiquidBroadcastTxData[];
 type BroadcastTxParams = {
     txId: string;
     chainId: number;
@@ -1924,12 +1945,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;
@@ -2249,7 +2270,7 @@ declare const hyperliquid: {
         };
     };
     ensTlds?: readonly string[] | undefined;
-    id: 998;
+    id: 1337;
     name: "Hyperliquid";
     nativeCurrency: {
         readonly name: "HYPE";
@@ -2421,4 +2442,4 @@ declare const citrea: {
 declare const customViemChains: viemChains.Chain[];
 declare const viemChainsById: Record<number, viemChains.Chain>;
 
-export { type AllowanceType, AllowanceTypes, type ApiRpcResponse, type ApprovalMode, ApprovalModes, type BatchPermitCallbackParams, type BtcTxData, type BtclnTxData, type Chain, type ChainData, type ContractErrorResponse, DZapClient, DZapPermitMode, type DZapTransactionResponse, type EvmTxData, type Fee, type FeeDetails, type GaslessTradeBuildTxnResponse, type HexString, OtherAbis, type ParamQuotes, type PermitMode, PermitTypes, type ProviderDetails, type PsbtInput, type PsbtOutput, type QuoteFilter, QuoteFilters, STATUS, type SVMTxnDetails, Services, type SignPermitResponse, type SignatureCallbackParams, SignatureExpiryInSecs, type SinglePermitCallbackParams, StatusCodes, type StepAction, type SvmTxData, type SwapInfo, SwapInputDataDecoder, type Token, type TokenInfo, type TokenPermitData, type TokenResponse, type TradeBuildTxnRequest, type TradeBuildTxnRequestData, type TradeBuildTxnResponse, type TradeGasBuildTxnResponse, type TradePath, type TradeQuotesRequest, type TradeQuotesRequestData, type TradeQuotesResponse, type TradeStatusResponse, type TradeStep, TxnStatus, type ZapBuildTxnRequest, type ZapBuildTxnResponse, type ZapBundleAction, type ZapBundleRequest, type ZapBundleSrcToken, type ZapBvmTxnDetails, type ZapChains, type ZapEvmTxnDetails, type ZapFee, type ZapIntegratorConfig, type ZapPath, type ZapPathAction, type ZapPathAsset, type ZapPool, type ZapPoolDetails, type ZapPoolDetailsRequest, type ZapPoolsRequest, type ZapPoolsResponse, type ZapPosition, type ZapPositionsRequest, type ZapPositionsResponse, type ZapProviders, type ZapQuoteRequest, type ZapQuoteResponse, type ZapRouteRequestPoolDetails, type ZapRouteRequestPositionDetails, type ZapStatus, type ZapStatusAsset, type ZapStatusRequest, type ZapStatusResponse, type ZapStatusStep, type ZapStep, type ZapTransactionStep, type ZapTxnDetails, type ZapUnderlyingToken, type ZapUnderlyingTokenWithAmount, arthera, astralisTestnet, checkEIP2612PermitSupport, citrea, classifyAddress, contractErrorActions, customViemChains, erc20Functions, extendViemChain, fiveIre, formatToken, getTokensPairKey, hemi, hyperEvm, hyperliquid, pushTestnet, stableChain, tempo, viemChainsById, zapPathAction, zapStepAction };
+export { type AllowanceType, AllowanceTypes, type ApiRpcResponse, type ApprovalMode, ApprovalModes, type BatchPermitCallbackParams, type BtcTxData, type BtclnTxData, type Chain, type ChainData, type ContractErrorResponse, DZapClient, DZapPermitMode, type DZapTransactionResponse, type EvmTxData, type Fee, type FeeDetails, type GaslessTradeBuildTxnResponse, type HexString, type HyperLiquidTxData, OtherAbis, type ParamQuotes, type PermitMode, PermitTypes, type ProviderDetails, type PsbtInput, type PsbtOutput, type QuoteFilter, QuoteFilters, STATUS, type SVMTxnDetails, Services, type SignPermitResponse, type SignatureCallbackParams, SignatureExpiryInSecs, type SinglePermitCallbackParams, StatusCodes, type StepAction, type SvmTxData, type SwapInfo, SwapInputDataDecoder, type Token, type TokenInfo, type TokenPermitData, type TokenResponse, type TradeBuildTxnRequest, type TradeBuildTxnRequestData, type TradeBuildTxnResponse, type TradeGasBuildTxnResponse, type TradePath, type TradeQuotesRequest, type TradeQuotesRequestData, type TradeQuotesResponse, type TradeStatusResponse, type TradeStep, TxnStatus, type ZapBuildTxnRequest, type ZapBuildTxnResponse, type ZapBundleAction, type ZapBundleRequest, type ZapBundleSrcToken, type ZapBvmTxnDetails, type ZapChains, type ZapEvmTxnDetails, type ZapFee, type ZapIntegratorConfig, type ZapPath, type ZapPathAction, type ZapPathAsset, type ZapPool, type ZapPoolDetails, type ZapPoolDetailsRequest, type ZapPoolsRequest, type ZapPoolsResponse, type ZapPosition, type ZapPositionsRequest, type ZapPositionsResponse, type ZapProviders, type ZapQuoteRequest, type ZapQuoteResponse, type ZapRouteRequestPoolDetails, type ZapRouteRequestPositionDetails, type ZapStatus, type ZapStatusAsset, type ZapStatusRequest, type ZapStatusResponse, type ZapStatusStep, type ZapStep, type ZapTransactionStep, type ZapTxnDetails, type ZapUnderlyingToken, type ZapUnderlyingTokenWithAmount, arthera, astralisTestnet, checkEIP2612PermitSupport, citrea, classifyAddress, contractErrorActions, customViemChains, erc20Functions, extendViemChain, fiveIre, formatToken, getTokensPairKey, hemi, hyperEvm, hyperliquid, pushTestnet, stableChain, tempo, viemChainsById, zapPathAction, zapStepAction };

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);
@@ -10723,7 +10725,7 @@ var hyperEvm = /* @__PURE__ */ viem.defineChain({
   }
 });
 var hyperliquid = /* @__PURE__ */ viem.defineChain({
-  id: 998,
+  id: 1337,
   name: "Hyperliquid",
   nativeCurrency: { name: "HYPE", symbol: "HYPE", decimals: 18 },
   contracts: {
@@ -12884,7 +12886,7 @@ var exclusiveChainIds = {
   abstract: 2741,
   lens: 232,
   citreaTestnet: 5115,
-  hyperLiquid: 998,
+  hyperLiquid: 1337,
   citrea: 4114,
   pushTestnet: 42101,
   astralisTestnet: 71261,
@@ -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 }) {
@@ -14753,6 +14769,61 @@ var signCustomTypedData = async (params) => {
   }
 };
 
+// src/transactionHandlers/hyperliquid.ts
+var HyperLiquidTxHandler = class {
+};
+HyperLiquidTxHandler.sendTransaction = async (signer, account, txnData, chainId, additionalInfo, updatedQuotes) => {
+  var _a;
+  const signTypedData2 = "signTypedData" in txnData.transaction ? txnData.transaction.signTypedData : null;
+  if (!signTypedData2) {
+    return {
+      status: "error" /* error */,
+      errorMsg: "Missing typed data for HyperLiquid transaction",
+      code: 500 /* Error */
+    };
+  }
+  const txData = [];
+  for (let i = 0; i < signTypedData2.length; i++) {
+    const typedData = signTypedData2[i];
+    const [resp, signatureChainId] = await Promise.all([
+      signCustomTypedData({
+        signer,
+        account,
+        domain: typedData.domain,
+        types: typedData.types,
+        message: typedData.message,
+        primaryType: typedData.primaryType
+      }),
+      signer.getChainId()
+    ]);
+    if (resp.status !== "success" /* success */ || !((_a = resp.data) == null ? void 0 : _a.signature)) {
+      throw new Error("Failed to sign transaction");
+    }
+    txData.push({
+      primaryType: typedData.primaryType,
+      message: typedData.message,
+      signature: resp.data.signature,
+      account,
+      signatureChainId
+    });
+  }
+  const txResp = await broadcastTradeTx({
+    chainId,
+    txData,
+    txId: txnData.txId
+  });
+  if (txResp.status !== "success" /* success */) {
+    throw new Error("Failed to broadcast or save transaction");
+  }
+  return {
+    status: "success" /* success */,
+    code: 200 /* Success */,
+    txnHash: txResp.txnHash,
+    additionalInfo,
+    updatedQuotes
+  };
+};
+
 // src/transactionHandlers/trade.ts
 var _TradeTxnHandler = class _TradeTxnHandler {
 };
@@ -14826,54 +14897,6 @@ _TradeTxnHandler.sendTxnWithBatch = async (request, signer, txnParams, chainId,
     updatedQuotes
   };
 };
-_TradeTxnHandler.sendHyperLiquidTransaction = async (signer, txnParams, txnData, chainId, additionalInfo, updatedQuotes) => {
-  var _a;
-  let txnDetails;
-  if (chainId === exclusiveChainIds.hyperLiquid) {
-    const providerData = additionalInfo ? Object.values(additionalInfo)[0] : null;
-    const typedData = providerData && "typedData" in providerData ? providerData.typedData : null;
-    if (!additionalInfo || !typedData) {
-      return {
-        status: "error" /* error */,
-        errorMsg: "Missing additional info for HyperLiquid transaction",
-        code: 500 /* Error */
-      };
-    }
-    const resp = await signCustomTypedData({
-      signer,
-      account: txnParams.from,
-      domain: typedData.domain,
-      types: typedData.types,
-      message: typedData.message,
-      primaryType: typedData.primaryType
-    });
-    if (resp.status !== "success" /* success */) {
-      throw new Error("Failed to sign transaction");
-    }
-    txnDetails = (_a = resp.data) == null ? void 0 : _a.signature;
-  } else {
-    const resp = await _TradeTxnHandler.sendTransaction(signer, txnParams, chainId, additionalInfo, updatedQuotes);
-    if (resp.status !== "success" /* success */) {
-      throw new Error("Failed to sign transaction");
-    }
-    txnDetails = resp.txnHash;
-  }
-  const txResp = await broadcastTradeTx({
-    chainId,
-    txData: txnDetails,
-    txId: txnData.txId
-  });
-  if (txResp.status !== "success" /* success */) {
-    throw new Error("Failed to broadcast or save transaction");
-  }
-  return {
-    status: "success" /* success */,
-    code: 200 /* Success */,
-    txnHash: txResp.txnHash,
-    additionalInfo,
-    updatedQuotes
-  };
-};
 _TradeTxnHandler.buildAndSendTransaction = async ({
   request,
   signer,
@@ -14893,8 +14916,15 @@ _TradeTxnHandler.buildAndSendTransaction = async ({
     }
     const { data, from, to, value, gasLimit, additionalInfo, updatedQuotes } = buildTxnResponseData;
     const txnParams = { from, to, data, value, gasLimit };
-    if ([chainId, ...request.data.map((e) => e.toChain)].some((chain) => chain === exclusiveChainIds.hyperLiquid)) {
-      return _TradeTxnHandler.sendHyperLiquidTransaction(signer, txnParams, buildTxnResponseData, chainId, additionalInfo, updatedQuotes);
+    if (chainId === exclusiveChainIds.hyperLiquid) {
+      return HyperLiquidTxHandler.sendTransaction(
+        signer,
+        txnParams.from,
+        buildTxnResponseData,
+        chainId,
+        additionalInfo,
+        updatedQuotes
+      );
     }
     if (batchTransaction && !isTypeSigner(signer)) {
       return _TradeTxnHandler.sendTxnWithBatch(request, signer, txnParams, chainId, additionalInfo, updatedQuotes, multicallAddress, rpcUrls);
@@ -16004,11 +16034,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 +16054,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);
@@ -10697,7 +10699,7 @@ var hyperEvm = /* @__PURE__ */ defineChain({
   }
 });
 var hyperliquid = /* @__PURE__ */ defineChain({
-  id: 998,
+  id: 1337,
   name: "Hyperliquid",
   nativeCurrency: { name: "HYPE", symbol: "HYPE", decimals: 18 },
   contracts: {
@@ -12858,7 +12860,7 @@ var exclusiveChainIds = {
   abstract: 2741,
   lens: 232,
   citreaTestnet: 5115,
-  hyperLiquid: 998,
+  hyperLiquid: 1337,
   citrea: 4114,
   pushTestnet: 42101,
   astralisTestnet: 71261,
@@ -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 }) {
@@ -14727,6 +14743,61 @@ var signCustomTypedData = async (params) => {
   }
 };
 
+// src/transactionHandlers/hyperliquid.ts
+var HyperLiquidTxHandler = class {
+};
+HyperLiquidTxHandler.sendTransaction = async (signer, account, txnData, chainId, additionalInfo, updatedQuotes) => {
+  var _a;
+  const signTypedData2 = "signTypedData" in txnData.transaction ? txnData.transaction.signTypedData : null;
+  if (!signTypedData2) {
+    return {
+      status: "error" /* error */,
+      errorMsg: "Missing typed data for HyperLiquid transaction",
+      code: 500 /* Error */
+    };
+  }
+  const txData = [];
+  for (let i = 0; i < signTypedData2.length; i++) {
+    const typedData = signTypedData2[i];
+    const [resp, signatureChainId] = await Promise.all([
+      signCustomTypedData({
+        signer,
+        account,
+        domain: typedData.domain,
+        types: typedData.types,
+        message: typedData.message,
+        primaryType: typedData.primaryType
+      }),
+      signer.getChainId()
+    ]);
+    if (resp.status !== "success" /* success */ || !((_a = resp.data) == null ? void 0 : _a.signature)) {
+      throw new Error("Failed to sign transaction");
+    }
+    txData.push({
+      primaryType: typedData.primaryType,
+      message: typedData.message,
+      signature: resp.data.signature,
+      account,
+      signatureChainId
+    });
+  }
+  const txResp = await broadcastTradeTx({
+    chainId,
+    txData,
+    txId: txnData.txId
+  });
+  if (txResp.status !== "success" /* success */) {
+    throw new Error("Failed to broadcast or save transaction");
+  }
+  return {
+    status: "success" /* success */,
+    code: 200 /* Success */,
+    txnHash: txResp.txnHash,
+    additionalInfo,
+    updatedQuotes
+  };
+};
+
 // src/transactionHandlers/trade.ts
 var _TradeTxnHandler = class _TradeTxnHandler {
 };
@@ -14800,54 +14871,6 @@ _TradeTxnHandler.sendTxnWithBatch = async (request, signer, txnParams, chainId,
     updatedQuotes
   };
 };
-_TradeTxnHandler.sendHyperLiquidTransaction = async (signer, txnParams, txnData, chainId, additionalInfo, updatedQuotes) => {
-  var _a;
-  let txnDetails;
-  if (chainId === exclusiveChainIds.hyperLiquid) {
-    const providerData = additionalInfo ? Object.values(additionalInfo)[0] : null;
-    const typedData = providerData && "typedData" in providerData ? providerData.typedData : null;
-    if (!additionalInfo || !typedData) {
-      return {
-        status: "error" /* error */,
-        errorMsg: "Missing additional info for HyperLiquid transaction",
-        code: 500 /* Error */
-      };
-    }
-    const resp = await signCustomTypedData({
-      signer,
-      account: txnParams.from,
-      domain: typedData.domain,
-      types: typedData.types,
-      message: typedData.message,
-      primaryType: typedData.primaryType
-    });
-    if (resp.status !== "success" /* success */) {
-      throw new Error("Failed to sign transaction");
-    }
-    txnDetails = (_a = resp.data) == null ? void 0 : _a.signature;
-  } else {
-    const resp = await _TradeTxnHandler.sendTransaction(signer, txnParams, chainId, additionalInfo, updatedQuotes);
-    if (resp.status !== "success" /* success */) {
-      throw new Error("Failed to sign transaction");
-    }
-    txnDetails = resp.txnHash;
-  }
-  const txResp = await broadcastTradeTx({
-    chainId,
-    txData: txnDetails,
-    txId: txnData.txId
-  });
-  if (txResp.status !== "success" /* success */) {
-    throw new Error("Failed to broadcast or save transaction");
-  }
-  return {
-    status: "success" /* success */,
-    code: 200 /* Success */,
-    txnHash: txResp.txnHash,
-    additionalInfo,
-    updatedQuotes
-  };
-};
 _TradeTxnHandler.buildAndSendTransaction = async ({
   request,
   signer,
@@ -14867,8 +14890,15 @@ _TradeTxnHandler.buildAndSendTransaction = async ({
     }
     const { data, from, to, value, gasLimit, additionalInfo, updatedQuotes } = buildTxnResponseData;
     const txnParams = { from, to, data, value, gasLimit };
-    if ([chainId, ...request.data.map((e) => e.toChain)].some((chain) => chain === exclusiveChainIds.hyperLiquid)) {
-      return _TradeTxnHandler.sendHyperLiquidTransaction(signer, txnParams, buildTxnResponseData, chainId, additionalInfo, updatedQuotes);
+    if (chainId === exclusiveChainIds.hyperLiquid) {
+      return HyperLiquidTxHandler.sendTransaction(
+        signer,
+        txnParams.from,
+        buildTxnResponseData,
+        chainId,
+        additionalInfo,
+        updatedQuotes
+      );
     }
     if (batchTransaction && !isTypeSigner(signer)) {
       return _TradeTxnHandler.sendTxnWithBatch(request, signer, txnParams, chainId, additionalInfo, updatedQuotes, multicallAddress, rpcUrls);
@@ -15978,11 +16008,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 +16028,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.41",
   "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",