@worldcoin/minikit-js 2.0.1 → 2.0.3

package/build/connector/index.js

@@ -3,15 +3,18 @@ import {
   _getAddress,
   _setAddress,
   getWorldAppProvider
-} from "../chunk-QX4OA3EY.js";
-import {
-  setWagmiConfig
-} from "../chunk-6SCI6OTQ.js";
+} from "../chunk-MXMNPAOF.js";
 import {
   MiniKit
-} from "../chunk-MOORQBWF.js";
-import "../chunk-XHYUUG6Y.js";
-import "../chunk-IYL4VCWR.js";
+} from "../chunk-7RB4UJBW.js";
+import "../chunk-AH3WTRZY.js";
+import "../chunk-YPZEODWL.js";
+import {
+  setWagmiConfig
+} from "../chunk-5B6BPEWR.js";
+import "../chunk-2ADHLH4F.js";
+import "../chunk-6E2XIIO6.js";
+import "../chunk-DZ2YRSIU.js";
 
 // src/connector/connector.ts
 function worldApp(options = {}) {

package/build/index.cjs

@@ -172,6 +172,14 @@ var EventManager = class {
 };
 
 // src/commands/fallback.ts
+var PartialExecutionError = class extends Error {
+  constructor(message, submitted, cause) {
+    super(message);
+    this.name = "PartialExecutionError";
+    this.submitted = submitted;
+    this.cause = cause;
+  }
+};
 async function executeWithFallback(options) {
   const {
     command,
@@ -197,6 +205,9 @@ async function executeWithFallback(options) {
       const data = await wagmiFallback();
       return { data, executedWith: "wagmi" };
     } catch (error) {
+      if (error instanceof PartialExecutionError || error instanceof Error && error.name === "PartialExecutionError") {
+        throw error;
+      }
       console.warn(`Wagmi fallback for ${command} failed:`, error);
     }
   }
@@ -720,7 +731,6 @@ var validateSendTransactionPayload = (payload) => {
 
 // src/commands/send-transaction/index.ts
 var WORLD_CHAIN_ID = 480;
-var WAGMI_MULTI_TX_ERROR_MESSAGE = "Wagmi fallback does not support multi-transaction execution. Pass a single transaction, run inside World App for batching, or provide a custom fallback.";
 function resolveChainId(options) {
   return options.chainId;
 }
@@ -747,12 +757,6 @@ function normalizeSendTransactionOptions(options) {
 async function sendTransaction(options, ctx) {
   const normalizedOptions = normalizeSendTransactionOptions(options);
   const fallbackAdapter = getFallbackAdapter();
-  const isWagmiFallbackPath = !isInWorldApp() && Boolean(fallbackAdapter?.sendTransaction);
-  if (isWagmiFallbackPath && normalizedOptions.transactions.length > 1 && !options.fallback) {
-    throw new SendTransactionError("invalid_operation" /* InvalidOperation */, {
-      reason: WAGMI_MULTI_TX_ERROR_MESSAGE
-    });
-  }
   const result = await executeWithFallback({
     command: "send-transaction" /* SendTransaction */,
     nativeExecutor: () => nativeSendTransaction(normalizedOptions, ctx),
@@ -833,23 +837,16 @@ async function nativeSendTransaction(options, ctx) {
   };
 }
 async function adapterSendTransactionFallback(options) {
-  if (options.transactions.length > 1) {
-    throw new Error(WAGMI_MULTI_TX_ERROR_MESSAGE);
-  }
-  const firstTransaction = options.transactions[0];
-  if (!firstTransaction) {
-    throw new Error("At least one transaction is required");
-  }
   const fallbackAdapter = getFallbackAdapter();
   if (!fallbackAdapter?.sendTransaction) {
     throw new Error("Fallback adapter is not registered.");
   }
   const result = await fallbackAdapter.sendTransaction({
-    transaction: {
-      address: firstTransaction.to,
-      data: firstTransaction.data,
-      value: firstTransaction.value
-    },
+    transactions: options.transactions.map((tx) => ({
+      address: tx.to,
+      data: tx.data,
+      value: tx.value
+    })),
     chainId: options.chainId
   });
   return {
@@ -1396,7 +1393,8 @@ async function nativeWalletAuth(options, ctx) {
   return {
     address: finalPayload.address,
     message: finalPayload.message,
-    signature: finalPayload.signature
+    signature: finalPayload.signature,
+    version: finalPayload.version
   };
 }
 
@@ -1997,6 +1995,18 @@ var MiniKit = _MiniKit;
 
 // src/provider.ts
 var import_viem2 = require("viem");
+
+// src/helpers/hex.ts
+var HEX_ADDRESS_REGEX = /^0x[0-9a-fA-F]{40}$/;
+var HEX_STRING_REGEX = /^0x[0-9a-fA-F]*$/;
+function isHexAddress(value) {
+  return typeof value === "string" && HEX_ADDRESS_REGEX.test(value);
+}
+function isHexString(value) {
+  return typeof value === "string" && HEX_STRING_REGEX.test(value);
+}
+
+// src/provider.ts
 function _getAddress() {
   if (typeof window === "undefined") return void 0;
   return window.__worldapp_eip1193_address__;
@@ -2012,12 +2022,6 @@ function _setAddress(addr) {
 function rpcError(code, message) {
   return Object.assign(new Error(message), { code });
 }
-function isHexString(value) {
-  return /^0x[0-9a-fA-F]*$/.test(value);
-}
-function isAddressString(value) {
-  return /^0x[0-9a-fA-F]{40}$/.test(value);
-}
 function decodeHexToUtf8(hex) {
   const raw = hex.slice(2);
   if (raw.length % 2 !== 0) {
@@ -2049,7 +2053,7 @@ function extractPersonalSignMessage(params) {
     throw new Error("Missing personal_sign params");
   }
   const [first, second] = items;
-  const maybeMessage = typeof first === "string" && isAddressString(first) && typeof second === "string" ? second : first;
+  const maybeMessage = typeof first === "string" && isHexAddress(first) && typeof second === "string" ? second : first;
   if (typeof maybeMessage !== "string") {
     throw new Error("Invalid personal_sign message payload");
   }
@@ -2061,7 +2065,7 @@ function extractEthSignMessage(params) {
     throw new Error("Missing eth_sign params");
   }
   const [first, second] = items;
-  const maybeMessage = typeof second === "string" ? second : typeof first === "string" && !isAddressString(first) ? first : void 0;
+  const maybeMessage = typeof second === "string" ? second : typeof first === "string" && !isHexAddress(first) ? first : void 0;
   if (typeof maybeMessage !== "string") {
     throw new Error("Invalid eth_sign message payload");
   }
@@ -2098,7 +2102,7 @@ function normalizeRpcValue(value) {
 function extractTransactionParams(params) {
   const items = asArrayParams(params);
   const tx = items[0] ?? {};
-  if (typeof tx.to !== "string" || !isAddressString(tx.to)) {
+  if (typeof tx.to !== "string" || !isHexAddress(tx.to)) {
     throw new Error('Invalid transaction "to" address');
   }
   const chainId = typeof tx.chainId === "string" ? Number(tx.chainId) : typeof tx.chainId === "number" ? tx.chainId : void 0;

package/build/index.d.cts

@@ -1,5 +1,5 @@
-import { W as WalletAuthResult, M as MiniKitWalletAuthOptions, C as CommandResultByVia, i as isInWorldApp, U as User, D as DeviceProperties, a as MiniAppLaunchLocation, R as ResponseEvent, b as MiniKitInstallReturnType, c as UserNameService } from './types-UxYgWVfF.cjs';
-import { S as SendTransactionResult, M as MiniKitSendTransactionOptions, P as PayResult, a as MiniKitPayOptions, b as ShareContactsResult, c as MiniKitShareContactsOptions, d as MiniAppSignMessageSuccessPayload, e as MiniKitSignMessageOptions, f as MiniAppSignTypedDataPayload, g as MiniKitSignTypedDataOptions, h as MiniAppSignTypedDataSuccessPayload, i as MiniAppChatPayload, j as MiniKitChatOptions, k as MiniAppChatSuccessPayload, l as MiniAppSharePayload, m as MiniKitShareOptions, n as MiniAppShareSuccessPayload, o as MiniAppGetPermissionsPayload, p as MiniKitGetPermissionsOptions, q as MiniAppGetPermissionsSuccessPayload, r as MiniAppRequestPermissionPayload, s as MiniKitRequestPermissionOptions, t as MiniAppRequestPermissionSuccessPayload, u as MiniAppSendHapticFeedbackPayload, v as MiniKitSendHapticFeedbackOptions, w as MiniAppSendHapticFeedbackSuccessPayload, x as MiniAppAttestationSuccessPayload, y as MiniKitAttestationOptions, C as CloseMiniAppResult, z as MiniKitCloseMiniAppOptions } from './types-CBzfDT31.cjs';
+import { W as WalletAuthResult, M as MiniKitWalletAuthOptions, C as CommandResultByVia, i as isInWorldApp, U as User, D as DeviceProperties, a as MiniAppLaunchLocation, R as ResponseEvent, b as MiniKitInstallReturnType, c as UserNameService } from './types-COxx4rrS.cjs';
+import { S as SendTransactionResult, M as MiniKitSendTransactionOptions, P as PayResult, a as MiniKitPayOptions, b as ShareContactsResult, c as MiniKitShareContactsOptions, d as MiniAppSignMessageSuccessPayload, e as MiniKitSignMessageOptions, f as MiniAppSignTypedDataPayload, g as MiniKitSignTypedDataOptions, h as MiniAppSignTypedDataSuccessPayload, i as MiniAppChatPayload, j as MiniKitChatOptions, k as MiniAppChatSuccessPayload, l as MiniAppSharePayload, m as MiniKitShareOptions, n as MiniAppShareSuccessPayload, o as MiniAppGetPermissionsPayload, p as MiniKitGetPermissionsOptions, q as MiniAppGetPermissionsSuccessPayload, r as MiniAppRequestPermissionPayload, s as MiniKitRequestPermissionOptions, t as MiniAppRequestPermissionSuccessPayload, u as MiniAppSendHapticFeedbackPayload, v as MiniKitSendHapticFeedbackOptions, w as MiniAppSendHapticFeedbackSuccessPayload, x as MiniAppAttestationSuccessPayload, y as MiniKitAttestationOptions, C as CloseMiniAppResult, z as MiniKitCloseMiniAppOptions } from './types-D_X89fCc.cjs';
 export { W as WorldAppProvider, g as getWorldAppProvider } from './provider-DeDUsLbs.cjs';
 import 'abitype';
 

package/build/index.d.ts

@@ -1,5 +1,5 @@
-import { W as WalletAuthResult, M as MiniKitWalletAuthOptions, C as CommandResultByVia, i as isInWorldApp, U as User, D as DeviceProperties, a as MiniAppLaunchLocation, R as ResponseEvent, b as MiniKitInstallReturnType, c as UserNameService } from './types-UxYgWVfF.js';
-import { S as SendTransactionResult, M as MiniKitSendTransactionOptions, P as PayResult, a as MiniKitPayOptions, b as ShareContactsResult, c as MiniKitShareContactsOptions, d as MiniAppSignMessageSuccessPayload, e as MiniKitSignMessageOptions, f as MiniAppSignTypedDataPayload, g as MiniKitSignTypedDataOptions, h as MiniAppSignTypedDataSuccessPayload, i as MiniAppChatPayload, j as MiniKitChatOptions, k as MiniAppChatSuccessPayload, l as MiniAppSharePayload, m as MiniKitShareOptions, n as MiniAppShareSuccessPayload, o as MiniAppGetPermissionsPayload, p as MiniKitGetPermissionsOptions, q as MiniAppGetPermissionsSuccessPayload, r as MiniAppRequestPermissionPayload, s as MiniKitRequestPermissionOptions, t as MiniAppRequestPermissionSuccessPayload, u as MiniAppSendHapticFeedbackPayload, v as MiniKitSendHapticFeedbackOptions, w as MiniAppSendHapticFeedbackSuccessPayload, x as MiniAppAttestationSuccessPayload, y as MiniKitAttestationOptions, C as CloseMiniAppResult, z as MiniKitCloseMiniAppOptions } from './types-BV7utGi5.js';
+import { W as WalletAuthResult, M as MiniKitWalletAuthOptions, C as CommandResultByVia, i as isInWorldApp, U as User, D as DeviceProperties, a as MiniAppLaunchLocation, R as ResponseEvent, b as MiniKitInstallReturnType, c as UserNameService } from './types-COxx4rrS.js';
+import { S as SendTransactionResult, M as MiniKitSendTransactionOptions, P as PayResult, a as MiniKitPayOptions, b as ShareContactsResult, c as MiniKitShareContactsOptions, d as MiniAppSignMessageSuccessPayload, e as MiniKitSignMessageOptions, f as MiniAppSignTypedDataPayload, g as MiniKitSignTypedDataOptions, h as MiniAppSignTypedDataSuccessPayload, i as MiniAppChatPayload, j as MiniKitChatOptions, k as MiniAppChatSuccessPayload, l as MiniAppSharePayload, m as MiniKitShareOptions, n as MiniAppShareSuccessPayload, o as MiniAppGetPermissionsPayload, p as MiniKitGetPermissionsOptions, q as MiniAppGetPermissionsSuccessPayload, r as MiniAppRequestPermissionPayload, s as MiniKitRequestPermissionOptions, t as MiniAppRequestPermissionSuccessPayload, u as MiniAppSendHapticFeedbackPayload, v as MiniKitSendHapticFeedbackOptions, w as MiniAppSendHapticFeedbackSuccessPayload, x as MiniAppAttestationSuccessPayload, y as MiniKitAttestationOptions, C as CloseMiniAppResult, z as MiniKitCloseMiniAppOptions } from './types-B3FhypWE.js';
 export { W as WorldAppProvider, g as getWorldAppProvider } from './provider-DeDUsLbs.js';
 import 'abitype';
 

package/build/index.js

@@ -1,11 +1,13 @@
 import {
   getWorldAppProvider
-} from "./chunk-QX4OA3EY.js";
+} from "./chunk-MXMNPAOF.js";
 import {
   MiniKit
-} from "./chunk-MOORQBWF.js";
-import "./chunk-XHYUUG6Y.js";
-import "./chunk-IYL4VCWR.js";
+} from "./chunk-7RB4UJBW.js";
+import "./chunk-AH3WTRZY.js";
+import "./chunk-YPZEODWL.js";
+import "./chunk-2ADHLH4F.js";
+import "./chunk-DZ2YRSIU.js";
 export {
   MiniKit,
   getWorldAppProvider

package/build/minikit-provider.cjs

@@ -1,10 +1,8 @@
 "use strict";
 "use client";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -18,14 +16,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/minikit-provider.tsx
@@ -37,279 +27,8 @@ __export(minikit_provider_exports, {
 module.exports = __toCommonJS(minikit_provider_exports);
 var import_react = require("react");
 
-// src/commands/fallback-adapter-registry.ts
-var FALLBACK_ADAPTER_KEY = "__minikit_fallback_adapter__";
-function setFallbackAdapter(adapter) {
-  globalThis[FALLBACK_ADAPTER_KEY] = adapter;
-}
-function getFallbackAdapter() {
-  return globalThis[FALLBACK_ADAPTER_KEY];
-}
-
-// src/commands/wagmi-fallback.ts
-var SIWE_NONCE_REGEX = /^[a-zA-Z0-9]{8,}$/;
-var WAGMI_KEY = "__minikit_wagmi_config__";
-function setWagmiConfig(config) {
-  globalThis[WAGMI_KEY] = config;
-  registerWagmiFallbacks();
-}
-function getWagmiConfig() {
-  return globalThis[WAGMI_KEY];
-}
-function hasWagmiConfig() {
-  return globalThis[WAGMI_KEY] !== void 0;
-}
-function registerWagmiFallbacks() {
-  setFallbackAdapter({
-    walletAuth: wagmiWalletAuth,
-    signMessage: wagmiSignMessage,
-    signTypedData: wagmiSignTypedData,
-    sendTransaction: wagmiSendTransaction
-  });
-}
-async function loadWagmiActions() {
-  console.log("[MiniKit WagmiFallback] loadWagmiActions:start", {
-    hasWindow: typeof window !== "undefined",
-    hasWagmiConfig: hasWagmiConfig()
-  });
-  try {
-    const actions = await import(
-      /* webpackIgnore: true */
-      "wagmi/actions"
-    );
-    console.log("[MiniKit WagmiFallback] loadWagmiActions:success");
-    return actions;
-  } catch (error) {
-    console.log("[MiniKit WagmiFallback] loadWagmiActions:error", {
-      message: error instanceof Error ? error.message : String(error)
-    });
-    const wrappedError = new Error(
-      'Wagmi fallback requires the "wagmi" package. Install wagmi or provide a custom fallback.'
-    );
-    wrappedError.cause = error;
-    throw wrappedError;
-  }
-}
-async function loadSiwe() {
-  try {
-    return await import(
-      /* webpackIgnore: true */
-      "siwe"
-    );
-  } catch (error) {
-    const wrappedError = new Error(
-      'Wagmi walletAuth fallback requires the "siwe" package. Install siwe or provide a custom fallback.'
-    );
-    wrappedError.cause = error;
-    throw wrappedError;
-  }
-}
-async function checksumAddress(addr) {
-  try {
-    const { getAddress } = await import(
-      /* webpackIgnore: true */
-      "viem"
-    );
-    return getAddress(addr);
-  } catch {
-    return addr;
-  }
-}
-async function ensureConnected(config) {
-  const { connect, getConnections } = await loadWagmiActions();
-  const isWorldApp = typeof window !== "undefined" && Boolean(window.WorldApp);
-  const existingConnection = getConnections(config).find(
-    (connection) => connection.accounts && connection.accounts.length > 0 && (isWorldApp || connection.connector?.id !== "worldApp")
-  );
-  if (existingConnection && existingConnection.accounts) {
-    return checksumAddress(existingConnection.accounts[0]);
-  }
-  const connectors = config.connectors;
-  if (!connectors || connectors.length === 0) {
-    throw new Error("No Wagmi connectors configured");
-  }
-  const candidateConnectors = isWorldApp ? connectors : connectors.filter(
-    (connector) => connector.id !== "worldApp"
-  );
-  if (!isWorldApp && candidateConnectors.length === 0) {
-    throw new Error(
-      "No web Wagmi connectors configured. Add a web connector (e.g. injected or walletConnect) after worldApp()."
-    );
-  }
-  const selectedConnector = candidateConnectors[0];
-  try {
-    const result = await connect(config, { connector: selectedConnector });
-    if (result.accounts.length > 0) {
-      const account = result.accounts[0];
-      const address = typeof account === "string" ? account : account.address;
-      if (address) {
-        return checksumAddress(address);
-      }
-    }
-  } catch (error) {
-    const connectorId = selectedConnector.id ?? "unknown";
-    const wrappedError = new Error(
-      `Failed to connect with connector "${connectorId}". Reorder connectors to change the default connector.`
-    );
-    wrappedError.cause = error;
-    throw wrappedError;
-  }
-  throw new Error("Failed to connect wallet");
-}
-async function wagmiWalletAuth(params) {
-  console.log("[MiniKit WagmiFallback] walletAuth:start", {
-    hasWagmiConfig: hasWagmiConfig(),
-    nonceLength: params.nonce?.length ?? 0
-  });
-  const config = getWagmiConfig();
-  if (!config) {
-    console.log("[MiniKit WagmiFallback] walletAuth:error:no-config");
-    throw new Error(
-      "Wagmi config not available. Pass wagmiConfig to MiniKitProvider."
-    );
-  }
-  const { signMessage: signMessage2 } = await loadWagmiActions();
-  const { SiweMessage } = await loadSiwe();
-  const address = await ensureConnected(config);
-  if (!SIWE_NONCE_REGEX.test(params.nonce)) {
-    throw new Error(
-      "Invalid nonce: must be alphanumeric and at least 8 characters (EIP-4361)"
-    );
-  }
-  const siweMessage = new SiweMessage({
-    domain: typeof window !== "undefined" ? window.location.host : "localhost",
-    address,
-    statement: params.statement,
-    uri: typeof window !== "undefined" ? window.location.origin : "http://localhost",
-    version: "1",
-    chainId: 480,
-    // World Chain
-    nonce: params.nonce,
-    expirationTime: params.expirationTime?.toISOString()
-  });
-  const message = siweMessage.prepareMessage();
-  const signature = await signMessage2(config, { message });
-  return {
-    address,
-    message,
-    signature
-  };
-}
-async function wagmiSignMessage(params) {
-  console.log("[MiniKit WagmiFallback] signMessage:start", {
-    hasWagmiConfig: hasWagmiConfig()
-  });
-  const config = getWagmiConfig();
-  if (!config) {
-    console.log("[MiniKit WagmiFallback] signMessage:error:no-config");
-    throw new Error(
-      "Wagmi config not available. Pass wagmiConfig to MiniKitProvider."
-    );
-  }
-  const { signMessage: signMessage2 } = await loadWagmiActions();
-  const address = await ensureConnected(config);
-  const signature = await signMessage2(config, {
-    account: address,
-    message: params.message
-  });
-  return {
-    status: "success",
-    version: 1,
-    signature,
-    address
-  };
-}
-async function wagmiSignTypedData(params) {
-  console.log("[MiniKit WagmiFallback] signTypedData:start", {
-    hasWagmiConfig: hasWagmiConfig(),
-    hasChainId: params.chainId !== void 0
-  });
-  const config = getWagmiConfig();
-  if (!config) {
-    console.log("[MiniKit WagmiFallback] signTypedData:error:no-config");
-    throw new Error(
-      "Wagmi config not available. Pass wagmiConfig to MiniKitProvider."
-    );
-  }
-  const { getChainId, signTypedData: signTypedData2, switchChain } = await loadWagmiActions();
-  const address = await ensureConnected(config);
-  if (params.chainId !== void 0) {
-    const currentChainId = await getChainId(config);
-    if (currentChainId !== params.chainId) {
-      await switchChain(config, { chainId: params.chainId });
-    }
-  }
-  const signature = await signTypedData2(config, {
-    account: address,
-    types: params.types,
-    primaryType: params.primaryType,
-    domain: params.domain,
-    message: params.message
-  });
-  return {
-    status: "success",
-    version: 1,
-    signature,
-    address
-  };
-}
-function isChainMismatchError(error) {
-  const message = error instanceof Error ? error.message : String(error);
-  return message.includes("does not match the target chain");
-}
-async function wagmiSendTransaction(params) {
-  console.log("[MiniKit WagmiFallback] sendTransaction:start", {
-    hasWagmiConfig: hasWagmiConfig(),
-    chainId: params.chainId,
-    hasData: Boolean(params.transaction.data)
-  });
-  const config = getWagmiConfig();
-  if (!config) {
-    console.log("[MiniKit WagmiFallback] sendTransaction:error:no-config");
-    throw new Error(
-      "Wagmi config not available. Pass wagmiConfig to MiniKitProvider."
-    );
-  }
-  const { getChainId, getWalletClient, sendTransaction: sendTransaction2, switchChain } = await loadWagmiActions();
-  await ensureConnected(config);
-  const targetChainId = params.chainId ?? config.chains?.[0]?.id;
-  const ensureTargetChain = async () => {
-    if (targetChainId === void 0) return;
-    const currentChainId = await getChainId(config);
-    if (currentChainId !== targetChainId) {
-      await switchChain(config, { chainId: targetChainId });
-    }
-    const walletClient = await getWalletClient(config);
-    const providerChainId = walletClient ? await walletClient.getChainId() : await getChainId(config);
-    if (providerChainId !== targetChainId) {
-      throw new Error(
-        `Wallet network mismatch: expected chain ${targetChainId}, got ${providerChainId}. Please switch networks in your wallet and retry.`
-      );
-    }
-  };
-  await ensureTargetChain();
-  let transactionHash;
-  try {
-    transactionHash = await sendTransaction2(config, {
-      chainId: targetChainId,
-      to: params.transaction.address,
-      data: params.transaction.data,
-      value: params.transaction.value ? BigInt(params.transaction.value) : void 0
-    });
-  } catch (error) {
-    if (targetChainId === void 0 || !isChainMismatchError(error)) {
-      throw error;
-    }
-    await ensureTargetChain();
-    transactionHash = await sendTransaction2(config, {
-      chainId: targetChainId,
-      to: params.transaction.address,
-      data: params.transaction.data,
-      value: params.transaction.value ? BigInt(params.transaction.value) : void 0
-    });
-  }
-  return { transactionHash };
-}
+// src/global-keys.ts
+var WAGMI_INSTALL_HOOK_KEY = "__minikit_install_wagmi_fallback__";
 
 // src/commands/types.ts
 var COMMAND_VERSIONS = {
@@ -458,6 +177,14 @@ var EventManager = class {
 };
 
 // src/commands/fallback.ts
+var PartialExecutionError = class extends Error {
+  constructor(message, submitted, cause) {
+    super(message);
+    this.name = "PartialExecutionError";
+    this.submitted = submitted;
+    this.cause = cause;
+  }
+};
 async function executeWithFallback(options) {
   const {
     command,
@@ -483,6 +210,9 @@ async function executeWithFallback(options) {
       const data = await wagmiFallback();
       return { data, executedWith: "wagmi" };
     } catch (error) {
+      if (error instanceof PartialExecutionError || error instanceof Error && error.name === "PartialExecutionError") {
+        throw error;
+      }
       console.warn(`Wagmi fallback for ${command} failed:`, error);
     }
   }
@@ -930,6 +660,12 @@ async function nativeSendHapticFeedback(options, ctx) {
   return payload;
 }
 
+// src/commands/fallback-adapter-registry.ts
+var FALLBACK_ADAPTER_KEY = "__minikit_fallback_adapter__";
+function getFallbackAdapter() {
+  return globalThis[FALLBACK_ADAPTER_KEY];
+}
+
 // src/commands/send-transaction/types.ts
 var SendTransactionError = class extends Error {
   constructor(code, details) {
@@ -1000,7 +736,6 @@ var validateSendTransactionPayload = (payload) => {
 
 // src/commands/send-transaction/index.ts
 var WORLD_CHAIN_ID = 480;
-var WAGMI_MULTI_TX_ERROR_MESSAGE = "Wagmi fallback does not support multi-transaction execution. Pass a single transaction, run inside World App for batching, or provide a custom fallback.";
 function resolveChainId(options) {
   return options.chainId;
 }
@@ -1027,12 +762,6 @@ function normalizeSendTransactionOptions(options) {
 async function sendTransaction(options, ctx) {
   const normalizedOptions = normalizeSendTransactionOptions(options);
   const fallbackAdapter = getFallbackAdapter();
-  const isWagmiFallbackPath = !isInWorldApp() && Boolean(fallbackAdapter?.sendTransaction);
-  if (isWagmiFallbackPath && normalizedOptions.transactions.length > 1 && !options.fallback) {
-    throw new SendTransactionError("invalid_operation" /* InvalidOperation */, {
-      reason: WAGMI_MULTI_TX_ERROR_MESSAGE
-    });
-  }
   const result = await executeWithFallback({
     command: "send-transaction" /* SendTransaction */,
     nativeExecutor: () => nativeSendTransaction(normalizedOptions, ctx),
@@ -1113,23 +842,16 @@ async function nativeSendTransaction(options, ctx) {
   };
 }
 async function adapterSendTransactionFallback(options) {
-  if (options.transactions.length > 1) {
-    throw new Error(WAGMI_MULTI_TX_ERROR_MESSAGE);
-  }
-  const firstTransaction = options.transactions[0];
-  if (!firstTransaction) {
-    throw new Error("At least one transaction is required");
-  }
   const fallbackAdapter = getFallbackAdapter();
   if (!fallbackAdapter?.sendTransaction) {
     throw new Error("Fallback adapter is not registered.");
   }
   const result = await fallbackAdapter.sendTransaction({
-    transaction: {
-      address: firstTransaction.to,
-      data: firstTransaction.data,
-      value: firstTransaction.value
-    },
+    transactions: options.transactions.map((tx) => ({
+      address: tx.to,
+      data: tx.data,
+      value: tx.value
+    })),
     chainId: options.chainId
   });
   return {
@@ -1550,7 +1272,7 @@ var WalletAuthError = class extends Error {
 };
 
 // src/commands/wallet-auth/validate.ts
-var SIWE_NONCE_REGEX2 = /^[a-zA-Z0-9]+$/;
+var SIWE_NONCE_REGEX = /^[a-zA-Z0-9]+$/;
 var validateWalletAuthCommandInput = (params) => {
   if (!params.nonce) {
     return { valid: false, message: "'nonce' is required" };
@@ -1558,7 +1280,7 @@ var validateWalletAuthCommandInput = (params) => {
   if (params.nonce.length < 8) {
     return { valid: false, message: "'nonce' must be at least 8 characters" };
   }
-  if (!SIWE_NONCE_REGEX2.test(params.nonce)) {
+  if (!SIWE_NONCE_REGEX.test(params.nonce)) {
     return {
       valid: false,
       message: "'nonce' must be alphanumeric (letters and numbers only)"
@@ -1676,7 +1398,8 @@ async function nativeWalletAuth(options, ctx) {
   return {
     address: finalPayload.address,
     message: finalPayload.message,
-    signature: finalPayload.signature
+    signature: finalPayload.signature,
+    version: finalPayload.version
   };
 }
 
@@ -2297,8 +2020,14 @@ var MiniKitProvider = ({
     setIsInstalled(success);
   }, [props?.appId]);
   (0, import_react.useEffect)(() => {
-    if (wagmiConfig) {
-      setWagmiConfig(wagmiConfig);
+    if (!wagmiConfig) return;
+    const install = globalThis[WAGMI_INSTALL_HOOK_KEY];
+    if (typeof install === "function") {
+      install(wagmiConfig);
+    } else {
+      console.warn(
+        'MiniKitProvider received wagmiConfig but the wagmi fallback module is not imported. Add this once in your app: import "@worldcoin/minikit-js/wagmi-fallback"'
+      );
     }
   }, [wagmiConfig]);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MiniKitContext.Provider, { value: { isInstalled }, children });

package/build/minikit-provider.js

@@ -1,12 +1,13 @@
 "use client";
-import {
-  setWagmiConfig
-} from "./chunk-6SCI6OTQ.js";
 import {
   MiniKit
-} from "./chunk-MOORQBWF.js";
-import "./chunk-XHYUUG6Y.js";
-import "./chunk-IYL4VCWR.js";
+} from "./chunk-7RB4UJBW.js";
+import "./chunk-AH3WTRZY.js";
+import "./chunk-YPZEODWL.js";
+import {
+  WAGMI_INSTALL_HOOK_KEY
+} from "./chunk-6E2XIIO6.js";
+import "./chunk-DZ2YRSIU.js";
 
 // src/minikit-provider.tsx
 import {
@@ -36,8 +37,14 @@ var MiniKitProvider = ({
     setIsInstalled(success);
   }, [props?.appId]);
   useEffect(() => {
-    if (wagmiConfig) {
-      setWagmiConfig(wagmiConfig);
+    if (!wagmiConfig) return;
+    const install = globalThis[WAGMI_INSTALL_HOOK_KEY];
+    if (typeof install === "function") {
+      install(wagmiConfig);
+    } else {
+      console.warn(
+        'MiniKitProvider received wagmiConfig but the wagmi fallback module is not imported. Add this once in your app: import "@worldcoin/minikit-js/wagmi-fallback"'
+      );
     }
   }, [wagmiConfig]);
   return /* @__PURE__ */ jsx(MiniKitContext.Provider, { value: { isInstalled }, children });