@velora-dex/widget 0.6.0 → 0.6.1-dev.1

package/dist/hooks/permit/hooks/permit2/usePermit2TransferFromNonce.js

@@ -1,97 +1,145 @@
-import { getLogger as e, useLogger as t } from "../../../../core/logger.js";
-import { PERMIT2_ABI as n } from "../../utils/abi.js";
-import { PERMIT2_ADDRESS as r } from "../../utils/construct.js";
-import { useQuery as i, useQueryClient as a } from "@tanstack/react-query";
-import { assert as o } from "ts-essentials";
-import { maxUint256 as s } from "viem";
-import { useConfig as c } from "wagmi";
-import { readContract as l } from "@wagmi/core";
-//#region src/hooks/permit/hooks/permit2/usePermit2TransferFromNonce.ts
-var u = "permit2-nonce";
-function d({ owner: e, chainId: n, initWord: r = 0n, enabled: s = !0 }) {
-	let l = a(), d = c(), m = t("PERMIT2::TransferFromNonce"), h = [
-		u,
-		e,
-		n
-	], { data: g, isLoading: _, isError: v, isSuccess: y, error: b, refetch: x } = i({
-		enabled: s && !!(e && n),
-		queryKey: h,
-		queryFn: async () => {
-			o(e, "owner is required"), o(n, "chainId is required");
-			let t = await f({
-				owner: e,
-				config: d,
-				startWord: l.getQueryData(h)?.word ?? r
-			});
-			if (!t) return m.warn("No available nonce found"), null;
-			let { word: i, bitmap: a } = t, s = p(a);
-			if (s === -1) return m.warn("No available nonce found"), null;
-			let c = {
-				word: i,
-				bitmap: a,
-				nonce: i * 256n + BigInt(s)
-			};
-			return m.log("nonceState", c), c;
-		},
-		refetchOnWindowFocus: !1,
-		notifyOnChangeProps: ["data", "isLoading"]
-	});
-	return {
-		nonceState: g,
-		nonceToUse: g === null ? null : g?.nonce,
-		isLoading: _,
-		isError: v,
-		isSuccess: y,
-		error: b,
-		refetch: x
-	};
+import { useQueryClient, useQuery } from '@tanstack/react-query';
+import { maxUint256 } from 'viem';
+import { useConfig } from 'wagmi';
+import { readContract } from '@wagmi/core';
+import { assert } from 'ts-essentials';
+import { PERMIT2_ABI } from '../../utils/abi.js';
+import { PERMIT2_ADDRESS } from '../../utils/construct.js';
+import { useLogger, getLogger } from '../../../../core/logger.js';
+
+const PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY = "permit2-nonce";
+function usePermit2TransferFromNonce({
+  owner,
+  chainId,
+  initWord = 0n,
+  enabled = true
+}) {
+  const queryClient = useQueryClient();
+  const config = useConfig();
+  const logger = useLogger("PERMIT2::TransferFromNonce");
+  const queryKey = [PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY, owner, chainId];
+  const {
+    data: nonceState_0,
+    isLoading,
+    isError,
+    isSuccess,
+    error,
+    refetch
+  } = useQuery({
+    enabled: enabled && !!(owner && chainId),
+    queryKey,
+    queryFn: async () => {
+      assert(owner, "owner is required");
+      assert(chainId, "chainId is required");
+      const last = queryClient.getQueryData(queryKey);
+      const nextOpenWord = await getNextOpenWord({
+        owner,
+        config,
+        startWord: last?.word ?? initWord
+      });
+      if (!nextOpenWord) {
+        logger.warn("No available nonce found");
+        return null;
+      }
+      const {
+        word,
+        bitmap
+      } = nextOpenWord;
+      const bitPos = getFirstUnsetBit(bitmap);
+      if (bitPos === -1) {
+        logger.warn("No available nonce found");
+        return null;
+      }
+      const nonceState = {
+        word,
+        bitmap,
+        nonce: word * 256n + BigInt(bitPos)
+      };
+      logger.log("nonceState", nonceState);
+      return nonceState;
+    },
+    // Useful defaults
+    refetchOnWindowFocus: false,
+    notifyOnChangeProps: ["data", "isLoading"]
+  });
+  return {
+    nonceState: nonceState_0,
+    nonceToUse: nonceState_0 === null ? null : nonceState_0?.nonce,
+    isLoading,
+    isError,
+    isSuccess,
+    error,
+    refetch
+  };
 }
-async function f({ owner: t, config: i, startWord: a }) {
-	let o = a, c = s;
-	for (;;) {
-		let s = await l(i, {
-			address: r,
-			abi: n,
-			functionName: "nonceBitmap",
-			args: [t, o]
-		});
-		if (s !== c) return {
-			word: o,
-			bitmap: s
-		};
-		if (o += 1n, o - a > 1024n) return e("PERMIT2::getNextOpenWord").warn("Exceeded nonce search limit"), null;
-	}
+async function getNextOpenWord({
+  owner,
+  config,
+  startWord
+}) {
+  let word = startWord;
+  const MAX = maxUint256;
+  while (true) {
+    const bitmap = await readContract(config, {
+      address: PERMIT2_ADDRESS,
+      abi: PERMIT2_ABI,
+      functionName: "nonceBitmap",
+      args: [owner, word]
+    });
+    if (bitmap !== MAX) {
+      return {
+        word,
+        bitmap
+      };
+    }
+    word += 1n;
+    if (word - startWord > 1024n) {
+      getLogger("PERMIT2::getNextOpenWord").warn("Exceeded nonce search limit");
+      return null;
+    }
+  }
 }
-function p(e) {
-	let t = ~e & e + 1n;
-	return t === 0n ? -1 : t.toString(2).length - 1;
+function getFirstUnsetBit(bitmap) {
+  const mask = ~bitmap & bitmap + 1n;
+  if (mask === 0n) return -1;
+  return mask.toString(2).length - 1;
 }
-function m() {
-	let e = a();
-	return { markNonceAsUsed: ({ owner: t, chainId: n, usedNonce: r }) => {
-		let i = [
-			u,
-			t.toLowerCase(),
-			n
-		];
-		e.setQueryData(i, (e) => {
-			if (!e || e.nonce > r) return e;
-			let t = e.nonce + 1n, { word: n, bitPos: i } = h(t);
-			return {
-				word: n,
-				bitmap: 1n << i,
-				nonce: t
-			};
-		});
-	} };
+function useMarkNonceAsUsed() {
+  const queryClient = useQueryClient();
+  const markNonceAsUsed = ({
+    owner,
+    chainId,
+    usedNonce
+  }) => {
+    const queryKey = [PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY, owner.toLowerCase(), chainId];
+    queryClient.setQueryData(queryKey, (oldNonceState) => {
+      if (!oldNonceState) return oldNonceState;
+      if (oldNonceState.nonce > usedNonce) return oldNonceState;
+      const newNonce = oldNonceState.nonce + 1n;
+      const {
+        word,
+        bitPos
+      } = splitNonce(newNonce);
+      return {
+        word,
+        bitmap: 1n << bitPos,
+        // ✅ convert bit index to actual 256-bit bitmap
+        nonce: newNonce
+      };
+    });
+  };
+  return {
+    markNonceAsUsed
+  };
 }
-function h(e) {
-	return {
-		word: e / 256n,
-		bitPos: e % 256n
-	};
+function splitNonce(nonce) {
+  const word = nonce / 256n;
+  const bitPos = nonce % 256n;
+  return {
+    word,
+    bitPos
+  };
 }
-//#endregion
-export { m as useMarkNonceAsUsed, d as usePermit2TransferFromNonce };
 
-//# sourceMappingURL=usePermit2TransferFromNonce.js.map
+export { useMarkNonceAsUsed, usePermit2TransferFromNonce };
+//# sourceMappingURL=usePermit2TransferFromNonce.js.map

package/dist/hooks/permit/hooks/permit2/usePermit2TransferFromNonce.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePermit2TransferFromNonce.js","names":["useQuery","useQueryClient","QueryObserverResult","RefetchOptions","Address","maxUint256","useConfig","Config","readContract","assert","PERMIT2_ABI","PERMIT2_ADDRESS","getLogger","useLogger","NonceState","word","bitmap","nonce","PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY","Permit2TransferFromQueryKey","owner","chainId","UsePermit2TransferFromNonceOptions","initWord","enabled","UsePermit2TransferFromNonceResult","nonceToUse","nonceState","isLoading","isError","isSuccess","error","Error","refetch","options","Promise","usePermit2TransferFromNonce","queryClient","config","logger","queryKey","data","queryFn","last","getQueryData","nextOpenWord","getNextOpenWord","startWord","warn","bitPos","getFirstUnsetBit","BigInt","log","refetchOnWindowFocus","notifyOnChangeProps","GetNextOpenWordInput","MAX","address","abi","functionName","args","mask","toString","length","SetNonceInput","usedNonce","UseMarkNonceAsUsedResult","markNonceAsUsed","input","useMarkNonceAsUsed","toLowerCase","setQueryData","oldNonceState","newNonce","splitNonce"],"sources":["../../../../../src/hooks/permit/hooks/permit2/usePermit2TransferFromNonce.ts"],"sourcesContent":["import {\n  useQuery,\n  useQueryClient,\n  type QueryObserverResult,\n  type RefetchOptions,\n} from \"@tanstack/react-query\";\nimport { type Address, maxUint256 } from \"viem\";\nimport { useConfig, type Config } from \"wagmi\";\nimport { readContract } from \"@wagmi/core\";\nimport { assert } from \"ts-essentials\";\nimport { PERMIT2_ABI } from \"../../utils/abi\";\nimport { PERMIT2_ADDRESS } from \"../../utils/construct\";\nimport { getLogger, useLogger } from \"@/core/logger\";\n\n/**\n * Permit2 stores nonces using a nested bitmap structure:\n *\n * mapping(address => mapping(uint256 => uint256)) public nonceBitmap;\n *\n * - The outer key (`address`) is the permit signer (the `owner`)\n * - The inner key (`uint256 word`) is the index of a 256-bit \"page\"\n * - The value (`uint256`) is the bitmap for that page — each bit (0 to 255) represents a nonce\n *     - If bit `i` is `0`, then nonce `word * 256 + i` is **unused**\n *     - If bit `i` is `1`, then that nonce has **already been used**\n *\n * This is what enables Permit2 to support unordered nonces while saving gas.\n */\n\n// Result of finding an available nonce\ntype NonceState = {\n  word: bigint; // which 256-bit \"page\" of the bitmap we used\n  bitmap: bigint; // the bitmap for that word\n  nonce: bigint; // full 256-based offset: word * 256 + bit index\n};\n\nconst PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY = \"permit2-nonce\";\n\ntype Permit2TransferFromQueryKey = [\n  typeof PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY,\n  owner?: Address,\n  chainId?: number,\n];\n\ninterface UsePermit2TransferFromNonceOptions {\n  owner?: Address;\n  chainId?: number;\n  initWord?: bigint; // word offset to begin scanning from\n  enabled?: boolean;\n}\n\nexport type UsePermit2TransferFromNonceResult = {\n  // null when no can't calculate Permit2 nonce\n  nonceToUse?: bigint | null;\n  nonceState?: NonceState | null;\n  isLoading: boolean;\n  isError: boolean;\n  isSuccess: boolean;\n  error: Error | null;\n  refetch: (\n    options?: RefetchOptions\n  ) => Promise<QueryObserverResult<NonceState | null, Error>>;\n};\n\n/**\n * React hook to find the next unused Permit2 nonce for `permitTransferFrom`.\n *\n * Permit2 stores nonces as a bitmap:\n * - Each address has a mapping from uint256 => uint256\n * - Each value is a 256-bit bitmap (called a \"word\")\n * - If a bit is 1, the nonce (word * 256 + bit index) is used\n * - If it's 0, it's free and can be used\n */\nexport function usePermit2TransferFromNonce({\n  owner,\n  chainId,\n  initWord = 0n,\n  enabled = true,\n}: UsePermit2TransferFromNonceOptions) {\n  const queryClient = useQueryClient();\n  const config = useConfig();\n  const logger = useLogger(\"PERMIT2::TransferFromNonce\");\n\n  const queryKey: Permit2TransferFromQueryKey = [\n    PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY,\n    owner,\n    chainId,\n  ];\n\n  const {\n    data: nonceState,\n    isLoading,\n    isError,\n    isSuccess,\n    error,\n    refetch,\n  } = useQuery<\n    NonceState | null,\n    Error,\n    NonceState | null,\n    Permit2TransferFromQueryKey\n  >({\n    enabled: enabled && !!(owner && chainId),\n\n    queryKey,\n\n    queryFn: async () => {\n      // Safety checks\n      assert(owner, \"owner is required\");\n      assert(chainId, \"chainId is required\");\n\n      // Try to resume scanning from last known state if available\n      const last = queryClient.getQueryData<NonceState>(queryKey);\n\n      // Find a bitmap word that has at least one unused bit (i.e. a usable nonce)\n      const nextOpenWord = await getNextOpenWord({\n        owner,\n        config,\n        startWord: last?.word ?? initWord,\n      });\n\n      if (!nextOpenWord) {\n        logger.warn(\"No available nonce found\");\n        return null;\n      }\n\n      const { word, bitmap } = nextOpenWord;\n      // Identify the first 0-bit in the bitmap — that’s our next nonce\n      const bitPos = getFirstUnsetBit(bitmap);\n      if (bitPos === -1) {\n        logger.warn(\"No available nonce found\");\n        return null;\n      }\n\n      const nonceState = {\n        word,\n        bitmap,\n        nonce: word * 256n + BigInt(bitPos),\n      };\n\n      logger.log(\"nonceState\", nonceState);\n\n      // The final usable nonce is: word * 256 + bit index\n      return nonceState;\n    },\n\n    // Useful defaults\n    refetchOnWindowFocus: false,\n    notifyOnChangeProps: [\"data\", \"isLoading\"],\n  });\n\n  return {\n    nonceState,\n    nonceToUse: nonceState === null ? null : nonceState?.nonce,\n    isLoading,\n    isError,\n    isSuccess,\n    error,\n    refetch,\n  };\n}\n\ninterface GetNextOpenWordInput {\n  owner: Address;\n  config: Config;\n  startWord: bigint;\n}\n\n/**\n * Scans bitmap word-by-word starting at `startWord` until it finds\n * one with at least one unused bit (i.e., not all bits are set to 1).\n */\nasync function getNextOpenWord({\n  owner,\n  config,\n  startWord,\n}: GetNextOpenWordInput): Promise<{ word: bigint; bitmap: bigint } | null> {\n  let word = startWord;\n  const MAX = maxUint256; // full 256-bit word (0xffff...ffff)\n\n  while (true) {\n    // Read the bitmap word for the given owner and word index\n    const bitmap = await readContract(config, {\n      address: PERMIT2_ADDRESS,\n      abi: PERMIT2_ABI,\n      functionName: \"nonceBitmap\",\n      args: [owner, word],\n    });\n\n    // If the bitmap is not fully used (i.e., not all bits are 1)\n    if (bitmap !== MAX) {\n      return { word, bitmap };\n    }\n\n    word += 1n;\n\n    // Fail-safe: don't scan more than 1024 words (262,144 nonces)\n    if (word - startWord > 1024n) {\n      getLogger(\"PERMIT2::getNextOpenWord\").warn(\"Exceeded nonce search limit\");\n      return null;\n    }\n  }\n}\n\n/**\n * Returns the index (0–255) of the first unset (zero) bit in a 256-bit bitmap.\n *\n * Uses a classic bit-hack: (~bitmap) & (bitmap + 1)\n *\n * This produces a bitmask with only the lowest 0-bit set to 1.\n * Example:\n *   bitmap = 0b1110       → unset bit at index 0\n *   ~bitmap = 0b...0001\n *   bitmap + 1 = 0b1111\n *   result = 0b0001 → bitmask for index 0\n *\n * We then convert the bitmask to binary and count how many bits it takes\n * to shift that 1 into place = its position.\n */\nfunction getFirstUnsetBit(bitmap: bigint): number {\n  // Create a bitmask with a 1 only at the first 0-bit (LSB side)\n  const mask = ~bitmap & (bitmap + 1n);\n\n  // If all bits are set (mask is zero), there are no available nonces\n  if (mask === 0n) return -1;\n\n  // Convert mask to binary and count digits – the length is the index + 1\n  // e.g. mask = 0b1000 → \"1000\" → length = 4 → index = 3\n  return mask.toString(2).length - 1;\n}\n\n/////// MARK NONCE AS USED ///////\n\ntype SetNonceInput = {\n  owner: Address;\n  chainId: number;\n  usedNonce: bigint;\n};\n\ntype UseMarkNonceAsUsedResult = {\n  /**\n   * Mark a nonce as \"used\" in the local cache after submitting a transaction or order\n   * This prevents reuse of the same nonce while it's still pending on-chain.\n   */\n  markNonceAsUsed: (input: SetNonceInput) => void;\n};\n\n/**\n * Hook to manually bump the locally cached Permit2 nonce to avoid reuse\n *\n * Permit2 allows unordered nonces, but while a tx is pending, it's safer to use\n * a strictly increasing nonce to avoid accidental replays or reuse.\n *\n * clearing an unsued nonce is not necessary because nonces are unordered\n */\nexport function useMarkNonceAsUsed(): UseMarkNonceAsUsedResult {\n  const queryClient = useQueryClient();\n\n  const markNonceAsUsed: UseMarkNonceAsUsedResult[\"markNonceAsUsed\"] = ({\n    owner,\n    chainId,\n    usedNonce,\n  }) => {\n    const queryKey: Permit2TransferFromQueryKey = [\n      PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY,\n      owner.toLowerCase() as Address,\n      chainId,\n    ];\n\n    // Update cached nonce state if the used nonce was >= current one\n    queryClient.setQueryData<NonceState>(queryKey, (oldNonceState) => {\n      if (!oldNonceState) return oldNonceState; // should not happen unless cache was cleared\n\n      // If we're already past this nonce, nothing to do\n      if (oldNonceState.nonce > usedNonce) return oldNonceState;\n\n      const newNonce = oldNonceState.nonce + 1n;\n      const { word, bitPos } = splitNonce(newNonce);\n\n      return {\n        word,\n        bitmap: 1n << bitPos, // ✅ convert bit index to actual 256-bit bitmap\n        nonce: newNonce,\n      };\n    });\n  };\n\n  return {\n    markNonceAsUsed,\n  };\n}\n\n/**\n * Splits a Permit2 nonce into:\n * - `word`: which 256-bit bitmap page (nonce / 256)\n * - `bitPos`: position within that word (nonce % 256)\n */\nfunction splitNonce(nonce: bigint): { word: bigint; bitPos: bigint } {\n  const word = nonce / 256n;\n  const bitPos = nonce % 256n;\n  return { word, bitPos };\n}\n"],"mappings":";;;;;;;;;AAmCA,IAAMkB,IAAwC;AAqC9C,SAAgBkB,EAA4B,EAC1ChB,UACAC,YACAE,cAAW,IACXC,aAAU,MAC2B;CACrC,IAAMa,IAAcpC,GAAgB,EAC9BqC,IAAShC,GAAW,EACpBiC,IAAS1B,EAAU,6BAA6B,EAEhD2B,IAAwC;EAC5CtB;EACAE;EACAC;EACD,EAEK,EACJoB,MAAMd,GACNC,cACAC,YACAC,cACAC,UACAE,eACEjC,EAKF;EACAwB,SAASA,KAAW,CAAC,EAAEJ,KAASC;EAEhCmB;EAEAE,SAAS,YAAY;AAGnBjC,GADAA,EAAOW,GAAO,oBAAoB,EAClCX,EAAOY,GAAS,sBAAsB;GAMtC,IAAMwB,IAAe,MAAMC,EAAgB;IACzC1B;IACAkB;IACAS,WANWV,EAAYO,aAAyBJ,EAAS,EAMxCzB,QAAQQ;IAC1B,CAAC;AAEF,OAAI,CAACsB,EAEH,QADAN,EAAOS,KAAK,2BAA2B,EAChC;GAGT,IAAM,EAAEjC,SAAMC,cAAW6B,GAEnBI,IAASC,EAAiBlC,EAAO;AACvC,OAAIiC,MAAW,GAEb,QADAV,EAAOS,KAAK,2BAA2B,EAChC;GAGT,IAAMrB,IAAa;IACjBZ;IACAC;IACAC,OAAOF,IAAO,OAAOoC,OAAOF,EAAM;IACnC;AAKD,UAHAV,EAAOa,IAAI,cAAczB,EAAW,EAG7BA;;EAIT0B,sBAAsB;EACtBC,qBAAqB,CAAC,QAAQ,YAAW;EAC1C,CAAC;AAEF,QAAO;EACL3B,YAAAA;EACAD,YAAYC,MAAe,OAAO,OAAOA,GAAYV;EACrDW;EACAC;EACAC;EACAC;EACAE;EACD;;AAaH,eAAea,EAAgB,EAC7B1B,UACAkB,WACAS,gBACyE;CACzE,IAAIhC,IAAOgC,GACLS,IAAMnD;AAEZ,UAAa;EAEX,IAAMW,IAAS,MAAMR,EAAa8B,GAAQ;GACxCmB,SAAS9C;GACT+C,KAAKhD;GACLiD,cAAc;GACdC,MAAM,CAACxC,GAAOL,EAAI;GACnB,CAAC;AAGF,MAAIC,MAAWwC,EACb,QAAO;GAAEzC;GAAMC;GAAQ;AAMzB,MAHAD,KAAQ,IAGJA,IAAOgC,IAAY,MAErB,QADAnC,EAAU,2BAA2B,CAACoC,KAAK,8BAA8B,EAClE;;;AAoBb,SAASE,EAAiBlC,GAAwB;CAEhD,IAAM6C,IAAO,CAAC7C,IAAUA,IAAS;AAOjC,QAJI6C,MAAS,KAAW,KAIjBA,EAAKC,SAAS,EAAE,CAACC,SAAS;;AA2BnC,SAAgBM,IAA+C;CAC7D,IAAMhC,IAAcpC,GAAgB;AA+BpC,QAAO,EACLkE,kBA9BoE,EACpE/C,UACAC,YACA4C,mBACI;EACJ,IAAMzB,IAAwC;GAC5CtB;GACAE,EAAMkD,aAAa;GACnBjD;GACD;AAGDgB,IAAYkC,aAAyB/B,IAAWgC,MAAkB;AAIhE,OAHI,CAACA,KAGDA,EAAcvD,QAAQgD,EAAW,QAAOO;GAE5C,IAAMC,IAAWD,EAAcvD,QAAQ,IACjC,EAAEF,SAAMkC,cAAWyB,EAAWD,EAAS;AAE7C,UAAO;IACL1D;IACAC,QAAQ,MAAMiC;IACdhC,OAAOwD;IACR;IACD;IAKH;;AAQH,SAASC,EAAWzD,GAAiD;AAGnE,QAAO;EAAEF,MAFIE,IAAQ;EAENgC,QADAhC,IAAQ;EACA"}
+{"version":3,"file":"usePermit2TransferFromNonce.js","sources":["../../../../../src/hooks/permit/hooks/permit2/usePermit2TransferFromNonce.ts"],"sourcesContent":["import {\n  useQuery,\n  useQueryClient,\n  type QueryObserverResult,\n  type RefetchOptions,\n} from \"@tanstack/react-query\";\nimport { type Address, maxUint256 } from \"viem\";\nimport { useConfig, type Config } from \"wagmi\";\nimport { readContract } from \"@wagmi/core\";\nimport { assert } from \"ts-essentials\";\nimport { PERMIT2_ABI } from \"../../utils/abi\";\nimport { PERMIT2_ADDRESS } from \"../../utils/construct\";\nimport { getLogger, useLogger } from \"@/core/logger\";\n\n/**\n * Permit2 stores nonces using a nested bitmap structure:\n *\n * mapping(address => mapping(uint256 => uint256)) public nonceBitmap;\n *\n * - The outer key (`address`) is the permit signer (the `owner`)\n * - The inner key (`uint256 word`) is the index of a 256-bit \"page\"\n * - The value (`uint256`) is the bitmap for that page — each bit (0 to 255) represents a nonce\n *     - If bit `i` is `0`, then nonce `word * 256 + i` is **unused**\n *     - If bit `i` is `1`, then that nonce has **already been used**\n *\n * This is what enables Permit2 to support unordered nonces while saving gas.\n */\n\n// Result of finding an available nonce\ntype NonceState = {\n  word: bigint; // which 256-bit \"page\" of the bitmap we used\n  bitmap: bigint; // the bitmap for that word\n  nonce: bigint; // full 256-based offset: word * 256 + bit index\n};\n\nconst PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY = \"permit2-nonce\";\n\ntype Permit2TransferFromQueryKey = [\n  typeof PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY,\n  owner?: Address,\n  chainId?: number,\n];\n\ninterface UsePermit2TransferFromNonceOptions {\n  owner?: Address;\n  chainId?: number;\n  initWord?: bigint; // word offset to begin scanning from\n  enabled?: boolean;\n}\n\nexport type UsePermit2TransferFromNonceResult = {\n  // null when no can't calculate Permit2 nonce\n  nonceToUse?: bigint | null;\n  nonceState?: NonceState | null;\n  isLoading: boolean;\n  isError: boolean;\n  isSuccess: boolean;\n  error: Error | null;\n  refetch: (\n    options?: RefetchOptions\n  ) => Promise<QueryObserverResult<NonceState | null, Error>>;\n};\n\n/**\n * React hook to find the next unused Permit2 nonce for `permitTransferFrom`.\n *\n * Permit2 stores nonces as a bitmap:\n * - Each address has a mapping from uint256 => uint256\n * - Each value is a 256-bit bitmap (called a \"word\")\n * - If a bit is 1, the nonce (word * 256 + bit index) is used\n * - If it's 0, it's free and can be used\n */\nexport function usePermit2TransferFromNonce({\n  owner,\n  chainId,\n  initWord = 0n,\n  enabled = true,\n}: UsePermit2TransferFromNonceOptions) {\n  const queryClient = useQueryClient();\n  const config = useConfig();\n  const logger = useLogger(\"PERMIT2::TransferFromNonce\");\n\n  const queryKey: Permit2TransferFromQueryKey = [\n    PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY,\n    owner,\n    chainId,\n  ];\n\n  const {\n    data: nonceState,\n    isLoading,\n    isError,\n    isSuccess,\n    error,\n    refetch,\n  } = useQuery<\n    NonceState | null,\n    Error,\n    NonceState | null,\n    Permit2TransferFromQueryKey\n  >({\n    enabled: enabled && !!(owner && chainId),\n\n    queryKey,\n\n    queryFn: async () => {\n      // Safety checks\n      assert(owner, \"owner is required\");\n      assert(chainId, \"chainId is required\");\n\n      // Try to resume scanning from last known state if available\n      const last = queryClient.getQueryData<NonceState>(queryKey);\n\n      // Find a bitmap word that has at least one unused bit (i.e. a usable nonce)\n      const nextOpenWord = await getNextOpenWord({\n        owner,\n        config,\n        startWord: last?.word ?? initWord,\n      });\n\n      if (!nextOpenWord) {\n        logger.warn(\"No available nonce found\");\n        return null;\n      }\n\n      const { word, bitmap } = nextOpenWord;\n      // Identify the first 0-bit in the bitmap — that’s our next nonce\n      const bitPos = getFirstUnsetBit(bitmap);\n      if (bitPos === -1) {\n        logger.warn(\"No available nonce found\");\n        return null;\n      }\n\n      const nonceState = {\n        word,\n        bitmap,\n        nonce: word * 256n + BigInt(bitPos),\n      };\n\n      logger.log(\"nonceState\", nonceState);\n\n      // The final usable nonce is: word * 256 + bit index\n      return nonceState;\n    },\n\n    // Useful defaults\n    refetchOnWindowFocus: false,\n    notifyOnChangeProps: [\"data\", \"isLoading\"],\n  });\n\n  return {\n    nonceState,\n    nonceToUse: nonceState === null ? null : nonceState?.nonce,\n    isLoading,\n    isError,\n    isSuccess,\n    error,\n    refetch,\n  };\n}\n\ninterface GetNextOpenWordInput {\n  owner: Address;\n  config: Config;\n  startWord: bigint;\n}\n\n/**\n * Scans bitmap word-by-word starting at `startWord` until it finds\n * one with at least one unused bit (i.e., not all bits are set to 1).\n */\nasync function getNextOpenWord({\n  owner,\n  config,\n  startWord,\n}: GetNextOpenWordInput): Promise<{ word: bigint; bitmap: bigint } | null> {\n  let word = startWord;\n  const MAX = maxUint256; // full 256-bit word (0xffff...ffff)\n\n  while (true) {\n    // Read the bitmap word for the given owner and word index\n    const bitmap = await readContract(config, {\n      address: PERMIT2_ADDRESS,\n      abi: PERMIT2_ABI,\n      functionName: \"nonceBitmap\",\n      args: [owner, word],\n    });\n\n    // If the bitmap is not fully used (i.e., not all bits are 1)\n    if (bitmap !== MAX) {\n      return { word, bitmap };\n    }\n\n    word += 1n;\n\n    // Fail-safe: don't scan more than 1024 words (262,144 nonces)\n    if (word - startWord > 1024n) {\n      getLogger(\"PERMIT2::getNextOpenWord\").warn(\"Exceeded nonce search limit\");\n      return null;\n    }\n  }\n}\n\n/**\n * Returns the index (0–255) of the first unset (zero) bit in a 256-bit bitmap.\n *\n * Uses a classic bit-hack: (~bitmap) & (bitmap + 1)\n *\n * This produces a bitmask with only the lowest 0-bit set to 1.\n * Example:\n *   bitmap = 0b1110       → unset bit at index 0\n *   ~bitmap = 0b...0001\n *   bitmap + 1 = 0b1111\n *   result = 0b0001 → bitmask for index 0\n *\n * We then convert the bitmask to binary and count how many bits it takes\n * to shift that 1 into place = its position.\n */\nfunction getFirstUnsetBit(bitmap: bigint): number {\n  // Create a bitmask with a 1 only at the first 0-bit (LSB side)\n  const mask = ~bitmap & (bitmap + 1n);\n\n  // If all bits are set (mask is zero), there are no available nonces\n  if (mask === 0n) return -1;\n\n  // Convert mask to binary and count digits – the length is the index + 1\n  // e.g. mask = 0b1000 → \"1000\" → length = 4 → index = 3\n  return mask.toString(2).length - 1;\n}\n\n/////// MARK NONCE AS USED ///////\n\ntype SetNonceInput = {\n  owner: Address;\n  chainId: number;\n  usedNonce: bigint;\n};\n\ntype UseMarkNonceAsUsedResult = {\n  /**\n   * Mark a nonce as \"used\" in the local cache after submitting a transaction or order\n   * This prevents reuse of the same nonce while it's still pending on-chain.\n   */\n  markNonceAsUsed: (input: SetNonceInput) => void;\n};\n\n/**\n * Hook to manually bump the locally cached Permit2 nonce to avoid reuse\n *\n * Permit2 allows unordered nonces, but while a tx is pending, it's safer to use\n * a strictly increasing nonce to avoid accidental replays or reuse.\n *\n * clearing an unsued nonce is not necessary because nonces are unordered\n */\nexport function useMarkNonceAsUsed(): UseMarkNonceAsUsedResult {\n  const queryClient = useQueryClient();\n\n  const markNonceAsUsed: UseMarkNonceAsUsedResult[\"markNonceAsUsed\"] = ({\n    owner,\n    chainId,\n    usedNonce,\n  }) => {\n    const queryKey: Permit2TransferFromQueryKey = [\n      PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY,\n      owner.toLowerCase() as Address,\n      chainId,\n    ];\n\n    // Update cached nonce state if the used nonce was >= current one\n    queryClient.setQueryData<NonceState>(queryKey, (oldNonceState) => {\n      if (!oldNonceState) return oldNonceState; // should not happen unless cache was cleared\n\n      // If we're already past this nonce, nothing to do\n      if (oldNonceState.nonce > usedNonce) return oldNonceState;\n\n      const newNonce = oldNonceState.nonce + 1n;\n      const { word, bitPos } = splitNonce(newNonce);\n\n      return {\n        word,\n        bitmap: 1n << bitPos, // ✅ convert bit index to actual 256-bit bitmap\n        nonce: newNonce,\n      };\n    });\n  };\n\n  return {\n    markNonceAsUsed,\n  };\n}\n\n/**\n * Splits a Permit2 nonce into:\n * - `word`: which 256-bit bitmap page (nonce / 256)\n * - `bitPos`: position within that word (nonce % 256)\n */\nfunction splitNonce(nonce: bigint): { word: bigint; bitPos: bigint } {\n  const word = nonce / 256n;\n  const bitPos = nonce % 256n;\n  return { word, bitPos };\n}\n"],"names":["PERMIT2_TRANSFER_FROM_NONCE_QUERY_KEY","usePermit2TransferFromNonce","owner","chainId","initWord","enabled","queryClient","useQueryClient","config","useConfig","logger","useLogger","queryKey","data","nonceState","isLoading","isError","isSuccess","error","refetch","useQuery","queryFn","assert","last","getQueryData","nextOpenWord","getNextOpenWord","startWord","word","warn","bitmap","bitPos","getFirstUnsetBit","nonce","BigInt","log","refetchOnWindowFocus","notifyOnChangeProps","nonceToUse","MAX","maxUint256","readContract","address","PERMIT2_ADDRESS","abi","PERMIT2_ABI","functionName","args","getLogger","mask","toString","length","useMarkNonceAsUsed","markNonceAsUsed","usedNonce","toLowerCase","setQueryData","oldNonceState","newNonce","splitNonce"],"mappings":"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"}