@worldcoin/minikit-js 0.0.2 → 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);
@@ -182,13 +185,19 @@ var verifySiweMessage = async (payload, nonce, statement, requestId, userProvide
     }
   }
   if (nonce && siweMessageData.nonce !== nonce) {
-    throw new Error("Nonce mismatch");
+    throw new Error(
+      `Nonce mismatch. Got: ${siweMessageData.nonce}, Expected: ${nonce}`
+    );
   }
   if (statement && siweMessageData.statement !== statement) {
-    throw new Error("Statement mismatch");
+    throw new Error(
+      `Statement mismatch. Got: ${siweMessageData.statement}, Expected: ${statement}`
+    );
   }
   if (requestId && siweMessageData.request_id !== requestId) {
-    throw new Error("Request ID mismatch");
+    throw new Error(
+      `Request ID mismatch. Got: ${siweMessageData.request_id}, Expected: ${requestId}`
+    );
   }
   let provider = userProvider || import_ethers.ethers.getDefaultProvider("https://mainnet.optimism.io");
   const signedMessage = `${ERC_191_PREFIX}${message.length}${message}`;
@@ -199,7 +208,7 @@ var verifySiweMessage = async (payload, nonce, statement, requestId, userProvide
     await contract.checkSignatures(
       hashedMessage,
       `0x${messageBytes}`,
-      signature
+      `0x${signature}`
     );
   } catch (error) {
     throw new Error("Signature verification failed");
@@ -231,15 +240,12 @@ var VerificationErrorMessage = {
   [import_idkit_core.AppErrorCodes.ConnectionFailed]: "Connection to your wallet failed. Please try again."
 };
 var PaymentErrorCodes = /* @__PURE__ */ ((PaymentErrorCodes2) => {
-  PaymentErrorCodes2["MalformedRequest"] = "malformed_request";
+  PaymentErrorCodes2["InputError"] = "input_error";
   PaymentErrorCodes2["PaymentRejected"] = "payment_rejected";
   PaymentErrorCodes2["InvalidReceiver"] = "invalid_receiver";
   PaymentErrorCodes2["InsufficientBalance"] = "insufficient_balance";
   PaymentErrorCodes2["TransactionFailed"] = "transaction_failed";
-  PaymentErrorCodes2["InvalidTokenAddress"] = "invalid_token_address";
-  PaymentErrorCodes2["InvalidAppId"] = "invalid_app_id";
   PaymentErrorCodes2["GenericError"] = "generic_error";
-  PaymentErrorCodes2["DuplicateReference"] = "duplicate_reference";
   return PaymentErrorCodes2;
 })(PaymentErrorCodes || {});
 var PaymentErrorMessage = /* @__PURE__ */ ((PaymentErrorMessage2) => {
@@ -255,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
@@ -293,12 +314,12 @@ var ResponseEvent = /* @__PURE__ */ ((ResponseEvent2) => {
 
 // types/payment.ts
 var Tokens = /* @__PURE__ */ ((Tokens2) => {
-  Tokens2["USDC"] = "USDC";
+  Tokens2["USDCE"] = "USDCE";
   Tokens2["WLD"] = "WLD";
   return Tokens2;
 })(Tokens || {});
 var TokenDecimals = {
-  ["USDC" /* USDC */]: 6,
+  ["USDCE" /* USDCE */]: 6,
   ["WLD" /* WLD */]: 18
 };
 var Network = /* @__PURE__ */ ((Network2) => {
@@ -337,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;
   }
@@ -350,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 };
   }
@@ -367,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 */]: () => {
   },
@@ -384,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) => {
@@ -405,6 +474,7 @@ _MiniKit.commands = {
     };
     sendMiniKitEvent({
       command: "pay" /* Pay */,
+      version: _MiniKit.commandVersion["pay" /* Pay */],
       payload: eventPayload
     });
     return eventPayload;
@@ -448,6 +518,7 @@ _MiniKit.commands = {
     const walletAuthPayload = { siweMessage };
     sendMiniKitEvent({
       command: "wallet-auth" /* WalletAuth */,
+      version: _MiniKit.commandVersion["wallet-auth" /* WalletAuth */],
       payload: walletAuthPayload
     });
     return walletAuthPayload;
@@ -474,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,
@@ -493,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;
@@ -19,7 +20,7 @@ type SiweMessage = {
 };
 
 declare enum Tokens {
-    USDC = "USDC",
+    USDCE = "USDCE",
     WLD = "WLD"
 }
 declare const TokenDecimals: {
@@ -31,15 +32,12 @@ declare enum Network {
 
 declare const VerificationErrorMessage: Record<AppErrorCodes, string>;
 declare enum PaymentErrorCodes {
-    MalformedRequest = "malformed_request",
+    InputError = "input_error",
     PaymentRejected = "payment_rejected",
     InvalidReceiver = "invalid_receiver",
     InsufficientBalance = "insufficient_balance",
     TransactionFailed = "transaction_failed",
-    InvalidTokenAddress = "invalid_token_address",
-    InvalidAppId = "invalid_app_id",
-    GenericError = "generic_error",
-    DuplicateReference = "duplicate_reference"
+    GenericError = "generic_error"
 }
 declare enum PaymentErrorMessage {
     MalformedRequest = "There was a problem with this request. Please try again or contact the app owner.",
@@ -53,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 {
@@ -74,23 +86,28 @@ 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 = {
     status: "success";
     transaction_status: "submitted";
+    transaction_id: string;
     reference: string;
     from: string;
     chain: Network;
     timestamp: string;
+    version: number;
 };
 type MiniAppPaymentErrorPayload = {
     status: "error";
     error_code: PaymentErrorCodes;
+    version: number;
 };
 type MiniAppPaymentPayload = MiniAppPaymentSuccessEventPayload | MiniAppPaymentErrorPayload;
 type MiniAppWalletAuthSuccessPayload = {
@@ -98,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;
@@ -134,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: number;
-    token: Tokens;
+    tokens: TokensPayload[];
     network?: Network;
     description: string;
 };
@@ -158,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;
@@ -182,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;
@@ -19,7 +20,7 @@ type SiweMessage = {
 };
 
 declare enum Tokens {
-    USDC = "USDC",
+    USDCE = "USDCE",
     WLD = "WLD"
 }
 declare const TokenDecimals: {
@@ -31,15 +32,12 @@ declare enum Network {
 
 declare const VerificationErrorMessage: Record<AppErrorCodes, string>;
 declare enum PaymentErrorCodes {
-    MalformedRequest = "malformed_request",
+    InputError = "input_error",
     PaymentRejected = "payment_rejected",
     InvalidReceiver = "invalid_receiver",
     InsufficientBalance = "insufficient_balance",
     TransactionFailed = "transaction_failed",
-    InvalidTokenAddress = "invalid_token_address",
-    InvalidAppId = "invalid_app_id",
-    GenericError = "generic_error",
-    DuplicateReference = "duplicate_reference"
+    GenericError = "generic_error"
 }
 declare enum PaymentErrorMessage {
     MalformedRequest = "There was a problem with this request. Please try again or contact the app owner.",
@@ -53,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 {
@@ -74,23 +86,28 @@ 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 = {
     status: "success";
     transaction_status: "submitted";
+    transaction_id: string;
     reference: string;
     from: string;
     chain: Network;
     timestamp: string;
+    version: number;
 };
 type MiniAppPaymentErrorPayload = {
     status: "error";
     error_code: PaymentErrorCodes;
+    version: number;
 };
 type MiniAppPaymentPayload = MiniAppPaymentSuccessEventPayload | MiniAppPaymentErrorPayload;
 type MiniAppWalletAuthSuccessPayload = {
@@ -98,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;
@@ -134,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: number;
-    token: Tokens;
+    tokens: TokensPayload[];
     network?: Network;
     description: string;
 };
@@ -158,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;
@@ -182,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

@@ -139,13 +139,19 @@ var verifySiweMessage = async (payload, nonce, statement, requestId, userProvide
     }
   }
   if (nonce && siweMessageData.nonce !== nonce) {
-    throw new Error("Nonce mismatch");
+    throw new Error(
+      `Nonce mismatch. Got: ${siweMessageData.nonce}, Expected: ${nonce}`
+    );
   }
   if (statement && siweMessageData.statement !== statement) {
-    throw new Error("Statement mismatch");
+    throw new Error(
+      `Statement mismatch. Got: ${siweMessageData.statement}, Expected: ${statement}`
+    );
   }
   if (requestId && siweMessageData.request_id !== requestId) {
-    throw new Error("Request ID mismatch");
+    throw new Error(
+      `Request ID mismatch. Got: ${siweMessageData.request_id}, Expected: ${requestId}`
+    );
   }
   let provider = userProvider || ethers.getDefaultProvider("https://mainnet.optimism.io");
   const signedMessage = `${ERC_191_PREFIX}${message.length}${message}`;
@@ -156,7 +162,7 @@ var verifySiweMessage = async (payload, nonce, statement, requestId, userProvide
     await contract.checkSignatures(
       hashedMessage,
       `0x${messageBytes}`,
-      signature
+      `0x${signature}`
     );
   } catch (error) {
     throw new Error("Signature verification failed");
@@ -188,15 +194,12 @@ var VerificationErrorMessage = {
   [AppErrorCodes.ConnectionFailed]: "Connection to your wallet failed. Please try again."
 };
 var PaymentErrorCodes = /* @__PURE__ */ ((PaymentErrorCodes2) => {
-  PaymentErrorCodes2["MalformedRequest"] = "malformed_request";
+  PaymentErrorCodes2["InputError"] = "input_error";
   PaymentErrorCodes2["PaymentRejected"] = "payment_rejected";
   PaymentErrorCodes2["InvalidReceiver"] = "invalid_receiver";
   PaymentErrorCodes2["InsufficientBalance"] = "insufficient_balance";
   PaymentErrorCodes2["TransactionFailed"] = "transaction_failed";
-  PaymentErrorCodes2["InvalidTokenAddress"] = "invalid_token_address";
-  PaymentErrorCodes2["InvalidAppId"] = "invalid_app_id";
   PaymentErrorCodes2["GenericError"] = "generic_error";
-  PaymentErrorCodes2["DuplicateReference"] = "duplicate_reference";
   return PaymentErrorCodes2;
 })(PaymentErrorCodes || {});
 var PaymentErrorMessage = /* @__PURE__ */ ((PaymentErrorMessage2) => {
@@ -212,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
@@ -250,12 +268,12 @@ var ResponseEvent = /* @__PURE__ */ ((ResponseEvent2) => {
 
 // types/payment.ts
 var Tokens = /* @__PURE__ */ ((Tokens2) => {
-  Tokens2["USDC"] = "USDC";
+  Tokens2["USDCE"] = "USDCE";
   Tokens2["WLD"] = "WLD";
   return Tokens2;
 })(Tokens || {});
 var TokenDecimals = {
-  ["USDC" /* USDC */]: 6,
+  ["USDCE" /* USDCE */]: 6,
   ["WLD" /* WLD */]: 18
 };
 var Network = /* @__PURE__ */ ((Network2) => {
@@ -294,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;
   }
@@ -307,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 };
   }
@@ -324,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 */]: () => {
   },
@@ -341,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) => {
@@ -362,6 +428,7 @@ _MiniKit.commands = {
     };
     sendMiniKitEvent({
       command: "pay" /* Pay */,
+      version: _MiniKit.commandVersion["pay" /* Pay */],
       payload: eventPayload
     });
     return eventPayload;
@@ -405,6 +472,7 @@ _MiniKit.commands = {
     const walletAuthPayload = { siweMessage };
     sendMiniKitEvent({
       command: "wallet-auth" /* WalletAuth */,
+      version: _MiniKit.commandVersion["wallet-auth" /* WalletAuth */],
       payload: walletAuthPayload
     });
     return walletAuthPayload;
@@ -431,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,
@@ -449,5 +522,6 @@ export {
   generateNonce,
   parseSiweMessage,
   tokenToDecimals,
+  verifyCloudProof,
   verifySiweMessage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worldcoin/minikit-js",
-  "version": "0.0.2",
+  "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",
@@ -25,8 +25,7 @@
     "miniapps"
   ],
   "dependencies": {
-    "@worldcoin/idkit-core": "^1.2.0",
-    "apg-js": "^4.4.0"
+    "@worldcoin/idkit-core": "^1.2.0"
   },
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "^7.7.0",