@worldcoin/minikit-js 0.0.21-internal-alpha → 0.0.22-internal-alpha

package/build/index.cjs

@@ -22,6 +22,8 @@ var src_exports = {};
 __export(src_exports, {
   Command: () => Command,
   MiniKit: () => MiniKit,
+  MiniKitInstallErrorCode: () => MiniKitInstallErrorCode,
+  MiniKitInstallErrorMessage: () => MiniKitInstallErrorMessage,
   Network: () => Network,
   PaymentErrorCodes: () => PaymentErrorCodes,
   PaymentErrorMessage: () => PaymentErrorMessage,
@@ -37,6 +39,7 @@ __export(src_exports, {
   generateNonce: () => generateNonce,
   parseSiweMessage: () => parseSiweMessage,
   tokenToDecimals: () => tokenToDecimals,
+  verifyCloudProof: () => import_backend.verifyCloudProof,
   verifySiweMessage: () => verifySiweMessage
 });
 module.exports = __toCommonJS(src_exports);
@@ -258,15 +261,30 @@ var PaymentErrorMessage = /* @__PURE__ */ ((PaymentErrorMessage2) => {
   return PaymentErrorMessage2;
 })(PaymentErrorMessage || {});
 var WalletAuthErrorCodes = /* @__PURE__ */ ((WalletAuthErrorCodes2) => {
-  WalletAuthErrorCodes2["InvalidAddress"] = "invalid_address";
   WalletAuthErrorCodes2["MalformedRequest"] = "malformed_request";
   WalletAuthErrorCodes2["UserRejected"] = "user_rejected";
+  WalletAuthErrorCodes2["GenericError"] = "generic_error";
   return WalletAuthErrorCodes2;
 })(WalletAuthErrorCodes || {});
 var WalletAuthErrorMessage = {
-  ["invalid_address" /* InvalidAddress */]: "The specified address is not valid for the connected wallet.",
   ["malformed_request" /* MalformedRequest */]: "Provided parameters in the request are invalid.",
-  ["user_rejected" /* UserRejected */]: "User rejected the request."
+  ["user_rejected" /* UserRejected */]: "User rejected the request.",
+  ["generic_error" /* GenericError */]: "Something unexpected went wrong."
+};
+var MiniKitInstallErrorCode = /* @__PURE__ */ ((MiniKitInstallErrorCode2) => {
+  MiniKitInstallErrorCode2["Unknown"] = "unknown";
+  MiniKitInstallErrorCode2["AlreadyInstalled"] = "already_installed";
+  MiniKitInstallErrorCode2["OutsideOfWorldApp"] = "outside_of_worldapp";
+  MiniKitInstallErrorCode2["NotOnClient"] = "not_on_client";
+  MiniKitInstallErrorCode2["AppOutOfDate"] = "app_out_of_date";
+  return MiniKitInstallErrorCode2;
+})(MiniKitInstallErrorCode || {});
+var MiniKitInstallErrorMessage = {
+  ["unknown" /* Unknown */]: "Failed to install MiniKit.",
+  ["already_installed" /* AlreadyInstalled */]: "MiniKit is already installed.",
+  ["outside_of_worldapp" /* OutsideOfWorldApp */]: "MiniApp launched outside of WorldApp.",
+  ["not_on_client" /* NotOnClient */]: "Window object is not available.",
+  ["app_out_of_date" /* AppOutOfDate */]: "WorldApp is out of date. Please update the app."
 };
 
 // helpers/send-webview-event.ts
@@ -340,6 +358,12 @@ var sendMiniKitEvent = (payload) => {
   sendWebviewEvent(payload);
 };
 var _MiniKit = class _MiniKit {
+  static sendInit() {
+    sendWebviewEvent({
+      command: "init",
+      payload: { version: this.MINIKIT_VERSION }
+    });
+  }
   static subscribe(event, handler) {
     this.listeners[event] = handler;
   }
@@ -353,14 +377,46 @@ var _MiniKit = class _MiniKit {
     }
     this.listeners[event](payload);
   }
+  static commandsValid(input) {
+    return input.every(
+      (command) => command.supported_versions.includes(this.commandVersion[command.name])
+    );
+  }
   static install() {
-    if (typeof window !== "undefined" && !Boolean(window.MiniKit)) {
-      try {
-        window.MiniKit = _MiniKit;
-      } catch (error) {
-        console.error("Failed to install MiniKit", error);
-        return { success: false, error };
-      }
+    if (typeof window === "undefined" || Boolean(window.MiniKit)) {
+      return {
+        success: false,
+        errorCode: "already_installed" /* AlreadyInstalled */,
+        errorMessage: MiniKitInstallErrorMessage["already_installed" /* AlreadyInstalled */]
+      };
+    }
+    if (!window.WorldApp) {
+      return {
+        success: false,
+        errorCode: "outside_of_worldapp" /* OutsideOfWorldApp */,
+        errorMessage: MiniKitInstallErrorMessage["outside_of_worldapp" /* OutsideOfWorldApp */]
+      };
+    }
+    if (!this.commandsValid(window.WorldApp.supported_commands)) {
+      return {
+        success: false,
+        errorCode: "app_out_of_date" /* AppOutOfDate */,
+        errorMessage: MiniKitInstallErrorMessage["app_out_of_date" /* AppOutOfDate */]
+      };
+    }
+    try {
+      window.MiniKit = _MiniKit;
+      this.sendInit();
+    } catch (error) {
+      console.error(
+        MiniKitInstallErrorMessage["unknown" /* Unknown */],
+        error
+      );
+      return {
+        success: false,
+        errorCode: "unknown" /* Unknown */,
+        errorMessage: MiniKitInstallErrorMessage["unknown" /* Unknown */]
+      };
     }
     return { success: true };
   }
@@ -370,6 +426,12 @@ var _MiniKit = class _MiniKit {
     return true;
   }
 };
+_MiniKit.MINIKIT_VERSION = 1;
+_MiniKit.commandVersion = {
+  ["verify" /* Verify */]: 1,
+  ["pay" /* Pay */]: 1,
+  ["wallet-auth" /* WalletAuth */]: 1
+};
 _MiniKit.listeners = {
   ["miniapp-verify-action" /* MiniAppVerifyAction */]: () => {
   },
@@ -387,7 +449,11 @@ _MiniKit.commands = {
       verification_level: payload.verification_level || import_idkit_core3.VerificationLevel.Orb,
       timestamp
     };
-    sendMiniKitEvent({ command: "verify" /* Verify */, payload: eventPayload });
+    sendMiniKitEvent({
+      command: "verify" /* Verify */,
+      version: _MiniKit.commandVersion["verify" /* Verify */],
+      payload: eventPayload
+    });
     return eventPayload;
   },
   pay: (payload) => {
@@ -408,6 +474,7 @@ _MiniKit.commands = {
     };
     sendMiniKitEvent({
       command: "pay" /* Pay */,
+      version: _MiniKit.commandVersion["pay" /* Pay */],
       payload: eventPayload
     });
     return eventPayload;
@@ -451,6 +518,7 @@ _MiniKit.commands = {
     const walletAuthPayload = { siweMessage };
     sendMiniKitEvent({
       command: "wallet-auth" /* WalletAuth */,
+      version: _MiniKit.commandVersion["wallet-auth" /* WalletAuth */],
       payload: walletAuthPayload
     });
     return walletAuthPayload;
@@ -477,10 +545,13 @@ var tokenToDecimals = (amount, token) => {
 
 // index.ts
 var import_idkit_core4 = require("@worldcoin/idkit-core");
+var import_backend = require("@worldcoin/idkit-core/backend");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Command,
   MiniKit,
+  MiniKitInstallErrorCode,
+  MiniKitInstallErrorMessage,
   Network,
   PaymentErrorCodes,
   PaymentErrorMessage,
@@ -496,5 +567,6 @@ var import_idkit_core4 = require("@worldcoin/idkit-core");
   generateNonce,
   parseSiweMessage,
   tokenToDecimals,
+  verifyCloudProof,
   verifySiweMessage
 });

package/build/index.d.cts

@@ -1,7 +1,8 @@
 import { ethers } from 'ethers';
 import { AppErrorCodes, VerificationLevel } from '@worldcoin/idkit-core';
-export { AppErrorCodes as VerificationErrorCodes, VerificationLevel } from '@worldcoin/idkit-core';
+export { ISuccessResult, AppErrorCodes as VerificationErrorCodes, VerificationLevel } from '@worldcoin/idkit-core';
 import { IDKitConfig, VerificationLevel as VerificationLevel$1 } from '@worldcoin/idkit-core/*';
+export { IVerifyResponse, verifyCloudProof } from '@worldcoin/idkit-core/backend';
 
 type SiweMessage = {
     scheme?: string;
@@ -50,14 +51,28 @@ declare enum PaymentErrorMessage {
     DuplicateReference = "This reference ID already exists please generate a new one and try again."
 }
 declare enum WalletAuthErrorCodes {
-    InvalidAddress = "invalid_address",
     MalformedRequest = "malformed_request",
-    UserRejected = "user_rejected"
+    UserRejected = "user_rejected",
+    GenericError = "generic_error"
 }
 declare const WalletAuthErrorMessage: {
-    invalid_address: string;
     malformed_request: string;
     user_rejected: string;
+    generic_error: string;
+};
+declare enum MiniKitInstallErrorCode {
+    Unknown = "unknown",
+    AlreadyInstalled = "already_installed",
+    OutsideOfWorldApp = "outside_of_worldapp",
+    NotOnClient = "not_on_client",
+    AppOutOfDate = "app_out_of_date"
+}
+declare const MiniKitInstallErrorMessage: {
+    unknown: string;
+    already_installed: string;
+    outside_of_worldapp: string;
+    not_on_client: string;
+    app_out_of_date: string;
 };
 
 declare enum ResponseEvent {
@@ -71,10 +86,12 @@ type MiniAppVerifyActionSuccessPayload = {
     merkle_root: string;
     nullifier_hash: string;
     verification_level: VerificationLevel;
+    version: number;
 };
 type MiniAppVerifyActionErrorPayload = {
     status: "error";
     error_code: AppErrorCodes;
+    version: number;
 };
 type MiniAppVerifyActionPayload = MiniAppVerifyActionSuccessPayload | MiniAppVerifyActionErrorPayload;
 type MiniAppPaymentSuccessEventPayload = {
@@ -85,10 +102,12 @@ type MiniAppPaymentSuccessEventPayload = {
     from: string;
     chain: Network;
     timestamp: string;
+    version: number;
 };
 type MiniAppPaymentErrorPayload = {
     status: "error";
     error_code: PaymentErrorCodes;
+    version: number;
 };
 type MiniAppPaymentPayload = MiniAppPaymentSuccessEventPayload | MiniAppPaymentErrorPayload;
 type MiniAppWalletAuthSuccessPayload = {
@@ -96,11 +115,13 @@ type MiniAppWalletAuthSuccessPayload = {
     message: string;
     signature: string;
     address: string;
+    version: number;
 };
 type MiniAppWalletAuthErrorPayload = {
     status: "error";
     error_code: WalletAuthErrorCodes;
     details: (typeof WalletAuthErrorMessage)[WalletAuthErrorCodes];
+    version: number;
 };
 type EventPayload<T extends ResponseEvent = ResponseEvent> = T extends ResponseEvent.MiniAppVerifyAction ? MiniAppVerifyActionPayload : MiniAppPaymentPayload;
 type EventHandler<E extends ResponseEvent = ResponseEvent> = <T extends EventPayload<E>>(data: T) => void;
@@ -132,11 +153,14 @@ type VerifyCommandInput = {
     signal?: IDKitConfig["signal"];
     verification_level?: VerificationLevel$1;
 };
+type TokensPayload = {
+    symbol: Tokens;
+    token_amount: string;
+};
 type PayCommandInput = {
     reference: string;
     to: string;
-    token_amount: string;
-    token: Tokens;
+    tokens: TokensPayload[];
     network?: Network;
     description: string;
 };
@@ -156,19 +180,24 @@ type PayCommandPayload = PayCommandInput & {
 type WalletAuthPayload = {
     siweMessage: string;
 };
+type MiniKitInstallReturnType = {
+    success: true;
+} | {
+    success: false;
+    errorCode: MiniKitInstallErrorCode;
+    errorMessage: (typeof MiniKitInstallErrorMessage)[MiniKitInstallErrorCode];
+};
 
 declare class MiniKit {
+    private static readonly MINIKIT_VERSION;
+    private static readonly commandVersion;
     private static listeners;
+    private static sendInit;
     static subscribe<E extends ResponseEvent>(event: E, handler: EventHandler<E>): void;
     static unsubscribe(event: ResponseEvent): void;
     static trigger(event: ResponseEvent, payload: EventPayload): void;
-    static install(): {
-        success: boolean;
-        error: unknown;
-    } | {
-        success: boolean;
-        error?: undefined;
-    };
+    private static commandsValid;
+    static install(): MiniKitInstallReturnType;
     static isInstalled(debug?: boolean): boolean;
     static commands: {
         verify: (payload: VerifyCommandInput) => VerifyCommandPayload;
@@ -180,4 +209,4 @@ declare class MiniKit {
 
 declare const tokenToDecimals: (amount: number, token: Tokens) => number;
 
-export { Command, type MiniAppPaymentErrorPayload, type MiniAppPaymentPayload, type MiniAppPaymentSuccessEventPayload, type MiniAppVerifyActionErrorPayload, type MiniAppVerifyActionPayload, type MiniAppVerifyActionSuccessPayload, type MiniAppWalletAuthErrorPayload, type MiniAppWalletAuthSuccessPayload, MiniKit, Network, type PayCommandInput, PaymentErrorCodes, PaymentErrorMessage, ResponseEvent, SAFE_CONTRACT_ABI, type SiweMessage, TokenDecimals, Tokens, VerificationErrorMessage, type VerifyCommandInput, WalletAuthErrorCodes, WalletAuthErrorMessage, generateNonce, parseSiweMessage, tokenToDecimals, verifySiweMessage };
+export { Command, type MiniAppPaymentErrorPayload, type MiniAppPaymentPayload, type MiniAppPaymentSuccessEventPayload, type MiniAppVerifyActionErrorPayload, type MiniAppVerifyActionPayload, type MiniAppVerifyActionSuccessPayload, type MiniAppWalletAuthErrorPayload, type MiniAppWalletAuthSuccessPayload, MiniKit, MiniKitInstallErrorCode, MiniKitInstallErrorMessage, Network, type PayCommandInput, PaymentErrorCodes, PaymentErrorMessage, ResponseEvent, SAFE_CONTRACT_ABI, type SiweMessage, TokenDecimals, Tokens, VerificationErrorMessage, type VerifyCommandInput, WalletAuthErrorCodes, WalletAuthErrorMessage, generateNonce, parseSiweMessage, tokenToDecimals, verifySiweMessage };

package/build/index.d.ts

@@ -1,7 +1,8 @@
 import { ethers } from 'ethers';
 import { AppErrorCodes, VerificationLevel } from '@worldcoin/idkit-core';
-export { AppErrorCodes as VerificationErrorCodes, VerificationLevel } from '@worldcoin/idkit-core';
+export { ISuccessResult, AppErrorCodes as VerificationErrorCodes, VerificationLevel } from '@worldcoin/idkit-core';
 import { IDKitConfig, VerificationLevel as VerificationLevel$1 } from '@worldcoin/idkit-core/*';
+export { IVerifyResponse, verifyCloudProof } from '@worldcoin/idkit-core/backend';
 
 type SiweMessage = {
     scheme?: string;
@@ -50,14 +51,28 @@ declare enum PaymentErrorMessage {
     DuplicateReference = "This reference ID already exists please generate a new one and try again."
 }
 declare enum WalletAuthErrorCodes {
-    InvalidAddress = "invalid_address",
     MalformedRequest = "malformed_request",
-    UserRejected = "user_rejected"
+    UserRejected = "user_rejected",
+    GenericError = "generic_error"
 }
 declare const WalletAuthErrorMessage: {
-    invalid_address: string;
     malformed_request: string;
     user_rejected: string;
+    generic_error: string;
+};
+declare enum MiniKitInstallErrorCode {
+    Unknown = "unknown",
+    AlreadyInstalled = "already_installed",
+    OutsideOfWorldApp = "outside_of_worldapp",
+    NotOnClient = "not_on_client",
+    AppOutOfDate = "app_out_of_date"
+}
+declare const MiniKitInstallErrorMessage: {
+    unknown: string;
+    already_installed: string;
+    outside_of_worldapp: string;
+    not_on_client: string;
+    app_out_of_date: string;
 };
 
 declare enum ResponseEvent {
@@ -71,10 +86,12 @@ type MiniAppVerifyActionSuccessPayload = {
     merkle_root: string;
     nullifier_hash: string;
     verification_level: VerificationLevel;
+    version: number;
 };
 type MiniAppVerifyActionErrorPayload = {
     status: "error";
     error_code: AppErrorCodes;
+    version: number;
 };
 type MiniAppVerifyActionPayload = MiniAppVerifyActionSuccessPayload | MiniAppVerifyActionErrorPayload;
 type MiniAppPaymentSuccessEventPayload = {
@@ -85,10 +102,12 @@ type MiniAppPaymentSuccessEventPayload = {
     from: string;
     chain: Network;
     timestamp: string;
+    version: number;
 };
 type MiniAppPaymentErrorPayload = {
     status: "error";
     error_code: PaymentErrorCodes;
+    version: number;
 };
 type MiniAppPaymentPayload = MiniAppPaymentSuccessEventPayload | MiniAppPaymentErrorPayload;
 type MiniAppWalletAuthSuccessPayload = {
@@ -96,11 +115,13 @@ type MiniAppWalletAuthSuccessPayload = {
     message: string;
     signature: string;
     address: string;
+    version: number;
 };
 type MiniAppWalletAuthErrorPayload = {
     status: "error";
     error_code: WalletAuthErrorCodes;
     details: (typeof WalletAuthErrorMessage)[WalletAuthErrorCodes];
+    version: number;
 };
 type EventPayload<T extends ResponseEvent = ResponseEvent> = T extends ResponseEvent.MiniAppVerifyAction ? MiniAppVerifyActionPayload : MiniAppPaymentPayload;
 type EventHandler<E extends ResponseEvent = ResponseEvent> = <T extends EventPayload<E>>(data: T) => void;
@@ -132,11 +153,14 @@ type VerifyCommandInput = {
     signal?: IDKitConfig["signal"];
     verification_level?: VerificationLevel$1;
 };
+type TokensPayload = {
+    symbol: Tokens;
+    token_amount: string;
+};
 type PayCommandInput = {
     reference: string;
     to: string;
-    token_amount: string;
-    token: Tokens;
+    tokens: TokensPayload[];
     network?: Network;
     description: string;
 };
@@ -156,19 +180,24 @@ type PayCommandPayload = PayCommandInput & {
 type WalletAuthPayload = {
     siweMessage: string;
 };
+type MiniKitInstallReturnType = {
+    success: true;
+} | {
+    success: false;
+    errorCode: MiniKitInstallErrorCode;
+    errorMessage: (typeof MiniKitInstallErrorMessage)[MiniKitInstallErrorCode];
+};
 
 declare class MiniKit {
+    private static readonly MINIKIT_VERSION;
+    private static readonly commandVersion;
     private static listeners;
+    private static sendInit;
     static subscribe<E extends ResponseEvent>(event: E, handler: EventHandler<E>): void;
     static unsubscribe(event: ResponseEvent): void;
     static trigger(event: ResponseEvent, payload: EventPayload): void;
-    static install(): {
-        success: boolean;
-        error: unknown;
-    } | {
-        success: boolean;
-        error?: undefined;
-    };
+    private static commandsValid;
+    static install(): MiniKitInstallReturnType;
     static isInstalled(debug?: boolean): boolean;
     static commands: {
         verify: (payload: VerifyCommandInput) => VerifyCommandPayload;
@@ -180,4 +209,4 @@ declare class MiniKit {
 
 declare const tokenToDecimals: (amount: number, token: Tokens) => number;
 
-export { Command, type MiniAppPaymentErrorPayload, type MiniAppPaymentPayload, type MiniAppPaymentSuccessEventPayload, type MiniAppVerifyActionErrorPayload, type MiniAppVerifyActionPayload, type MiniAppVerifyActionSuccessPayload, type MiniAppWalletAuthErrorPayload, type MiniAppWalletAuthSuccessPayload, MiniKit, Network, type PayCommandInput, PaymentErrorCodes, PaymentErrorMessage, ResponseEvent, SAFE_CONTRACT_ABI, type SiweMessage, TokenDecimals, Tokens, VerificationErrorMessage, type VerifyCommandInput, WalletAuthErrorCodes, WalletAuthErrorMessage, generateNonce, parseSiweMessage, tokenToDecimals, verifySiweMessage };
+export { Command, type MiniAppPaymentErrorPayload, type MiniAppPaymentPayload, type MiniAppPaymentSuccessEventPayload, type MiniAppVerifyActionErrorPayload, type MiniAppVerifyActionPayload, type MiniAppVerifyActionSuccessPayload, type MiniAppWalletAuthErrorPayload, type MiniAppWalletAuthSuccessPayload, MiniKit, MiniKitInstallErrorCode, MiniKitInstallErrorMessage, Network, type PayCommandInput, PaymentErrorCodes, PaymentErrorMessage, ResponseEvent, SAFE_CONTRACT_ABI, type SiweMessage, TokenDecimals, Tokens, VerificationErrorMessage, type VerifyCommandInput, WalletAuthErrorCodes, WalletAuthErrorMessage, generateNonce, parseSiweMessage, tokenToDecimals, verifySiweMessage };

package/build/index.js

@@ -215,15 +215,30 @@ var PaymentErrorMessage = /* @__PURE__ */ ((PaymentErrorMessage2) => {
   return PaymentErrorMessage2;
 })(PaymentErrorMessage || {});
 var WalletAuthErrorCodes = /* @__PURE__ */ ((WalletAuthErrorCodes2) => {
-  WalletAuthErrorCodes2["InvalidAddress"] = "invalid_address";
   WalletAuthErrorCodes2["MalformedRequest"] = "malformed_request";
   WalletAuthErrorCodes2["UserRejected"] = "user_rejected";
+  WalletAuthErrorCodes2["GenericError"] = "generic_error";
   return WalletAuthErrorCodes2;
 })(WalletAuthErrorCodes || {});
 var WalletAuthErrorMessage = {
-  ["invalid_address" /* InvalidAddress */]: "The specified address is not valid for the connected wallet.",
   ["malformed_request" /* MalformedRequest */]: "Provided parameters in the request are invalid.",
-  ["user_rejected" /* UserRejected */]: "User rejected the request."
+  ["user_rejected" /* UserRejected */]: "User rejected the request.",
+  ["generic_error" /* GenericError */]: "Something unexpected went wrong."
+};
+var MiniKitInstallErrorCode = /* @__PURE__ */ ((MiniKitInstallErrorCode2) => {
+  MiniKitInstallErrorCode2["Unknown"] = "unknown";
+  MiniKitInstallErrorCode2["AlreadyInstalled"] = "already_installed";
+  MiniKitInstallErrorCode2["OutsideOfWorldApp"] = "outside_of_worldapp";
+  MiniKitInstallErrorCode2["NotOnClient"] = "not_on_client";
+  MiniKitInstallErrorCode2["AppOutOfDate"] = "app_out_of_date";
+  return MiniKitInstallErrorCode2;
+})(MiniKitInstallErrorCode || {});
+var MiniKitInstallErrorMessage = {
+  ["unknown" /* Unknown */]: "Failed to install MiniKit.",
+  ["already_installed" /* AlreadyInstalled */]: "MiniKit is already installed.",
+  ["outside_of_worldapp" /* OutsideOfWorldApp */]: "MiniApp launched outside of WorldApp.",
+  ["not_on_client" /* NotOnClient */]: "Window object is not available.",
+  ["app_out_of_date" /* AppOutOfDate */]: "WorldApp is out of date. Please update the app."
 };
 
 // helpers/send-webview-event.ts
@@ -297,6 +312,12 @@ var sendMiniKitEvent = (payload) => {
   sendWebviewEvent(payload);
 };
 var _MiniKit = class _MiniKit {
+  static sendInit() {
+    sendWebviewEvent({
+      command: "init",
+      payload: { version: this.MINIKIT_VERSION }
+    });
+  }
   static subscribe(event, handler) {
     this.listeners[event] = handler;
   }
@@ -310,14 +331,46 @@ var _MiniKit = class _MiniKit {
     }
     this.listeners[event](payload);
   }
+  static commandsValid(input) {
+    return input.every(
+      (command) => command.supported_versions.includes(this.commandVersion[command.name])
+    );
+  }
   static install() {
-    if (typeof window !== "undefined" && !Boolean(window.MiniKit)) {
-      try {
-        window.MiniKit = _MiniKit;
-      } catch (error) {
-        console.error("Failed to install MiniKit", error);
-        return { success: false, error };
-      }
+    if (typeof window === "undefined" || Boolean(window.MiniKit)) {
+      return {
+        success: false,
+        errorCode: "already_installed" /* AlreadyInstalled */,
+        errorMessage: MiniKitInstallErrorMessage["already_installed" /* AlreadyInstalled */]
+      };
+    }
+    if (!window.WorldApp) {
+      return {
+        success: false,
+        errorCode: "outside_of_worldapp" /* OutsideOfWorldApp */,
+        errorMessage: MiniKitInstallErrorMessage["outside_of_worldapp" /* OutsideOfWorldApp */]
+      };
+    }
+    if (!this.commandsValid(window.WorldApp.supported_commands)) {
+      return {
+        success: false,
+        errorCode: "app_out_of_date" /* AppOutOfDate */,
+        errorMessage: MiniKitInstallErrorMessage["app_out_of_date" /* AppOutOfDate */]
+      };
+    }
+    try {
+      window.MiniKit = _MiniKit;
+      this.sendInit();
+    } catch (error) {
+      console.error(
+        MiniKitInstallErrorMessage["unknown" /* Unknown */],
+        error
+      );
+      return {
+        success: false,
+        errorCode: "unknown" /* Unknown */,
+        errorMessage: MiniKitInstallErrorMessage["unknown" /* Unknown */]
+      };
     }
     return { success: true };
   }
@@ -327,6 +380,12 @@ var _MiniKit = class _MiniKit {
     return true;
   }
 };
+_MiniKit.MINIKIT_VERSION = 1;
+_MiniKit.commandVersion = {
+  ["verify" /* Verify */]: 1,
+  ["pay" /* Pay */]: 1,
+  ["wallet-auth" /* WalletAuth */]: 1
+};
 _MiniKit.listeners = {
   ["miniapp-verify-action" /* MiniAppVerifyAction */]: () => {
   },
@@ -344,7 +403,11 @@ _MiniKit.commands = {
       verification_level: payload.verification_level || VerificationLevel.Orb,
       timestamp
     };
-    sendMiniKitEvent({ command: "verify" /* Verify */, payload: eventPayload });
+    sendMiniKitEvent({
+      command: "verify" /* Verify */,
+      version: _MiniKit.commandVersion["verify" /* Verify */],
+      payload: eventPayload
+    });
     return eventPayload;
   },
   pay: (payload) => {
@@ -365,6 +428,7 @@ _MiniKit.commands = {
     };
     sendMiniKitEvent({
       command: "pay" /* Pay */,
+      version: _MiniKit.commandVersion["pay" /* Pay */],
       payload: eventPayload
     });
     return eventPayload;
@@ -408,6 +472,7 @@ _MiniKit.commands = {
     const walletAuthPayload = { siweMessage };
     sendMiniKitEvent({
       command: "wallet-auth" /* WalletAuth */,
+      version: _MiniKit.commandVersion["wallet-auth" /* WalletAuth */],
       payload: walletAuthPayload
     });
     return walletAuthPayload;
@@ -434,9 +499,14 @@ var tokenToDecimals = (amount, token) => {
 
 // index.ts
 import { VerificationLevel as VerificationLevel2 } from "@worldcoin/idkit-core";
+import {
+  verifyCloudProof
+} from "@worldcoin/idkit-core/backend";
 export {
   Command,
   MiniKit,
+  MiniKitInstallErrorCode,
+  MiniKitInstallErrorMessage,
   Network,
   PaymentErrorCodes,
   PaymentErrorMessage,
@@ -452,5 +522,6 @@ export {
   generateNonce,
   parseSiweMessage,
   tokenToDecimals,
+  verifyCloudProof,
   verifySiweMessage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worldcoin/minikit-js",
-  "version": "0.0.21-internal-alpha",
+  "version": "0.0.22-internal-alpha",
   "homepage": "https://docs.worldcoin.org/id/minikit",
   "description": "Internal Alpha: Mini-kit JS is a lightweight sdk for building mini-apps compatible with World App",
   "license": "MIT",