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

package/build/index.cjs

@@ -22,9 +22,12 @@ var src_exports = {};
 __export(src_exports, {
   Command: () => Command,
   MiniKit: () => MiniKit,
+  MiniKitInstallErrorCode: () => MiniKitInstallErrorCode,
+  MiniKitInstallErrorMessage: () => MiniKitInstallErrorMessage,
   Network: () => Network,
   PaymentErrorCodes: () => PaymentErrorCodes,
   PaymentErrorMessage: () => PaymentErrorMessage,
+  PaymentValidationErrors: () => PaymentValidationErrors,
   ResponseEvent: () => ResponseEvent,
   SAFE_CONTRACT_ABI: () => SAFE_CONTRACT_ABI,
   TokenDecimals: () => TokenDecimals,
@@ -37,6 +40,7 @@ __export(src_exports, {
   generateNonce: () => generateNonce,
   parseSiweMessage: () => parseSiweMessage,
   tokenToDecimals: () => tokenToDecimals,
+  verifyCloudProof: () => import_backend.verifyCloudProof,
   verifySiweMessage: () => verifySiweMessage
 });
 module.exports = __toCommonJS(src_exports);
@@ -243,30 +247,50 @@ var PaymentErrorCodes = /* @__PURE__ */ ((PaymentErrorCodes2) => {
   PaymentErrorCodes2["InsufficientBalance"] = "insufficient_balance";
   PaymentErrorCodes2["TransactionFailed"] = "transaction_failed";
   PaymentErrorCodes2["GenericError"] = "generic_error";
+  PaymentErrorCodes2["UserBlocked"] = "user_blocked";
   return PaymentErrorCodes2;
 })(PaymentErrorCodes || {});
-var PaymentErrorMessage = /* @__PURE__ */ ((PaymentErrorMessage2) => {
-  PaymentErrorMessage2["MalformedRequest"] = "There was a problem with this request. Please try again or contact the app owner.";
-  PaymentErrorMessage2["PaymentRejected"] = "You\u2019ve cancelled the payment in World App.";
-  PaymentErrorMessage2["InvalidReceiver"] = "The receiver address is invalid. Please contact the app owner.";
-  PaymentErrorMessage2["InsufficientBalance"] = "You do not have enough balance to complete this transaction.";
-  PaymentErrorMessage2["TransactionFailed"] = "The transaction failed. Please try again.";
-  PaymentErrorMessage2["InvalidTokenAddress"] = "The token address is invalid. Please contact the app owner.";
-  PaymentErrorMessage2["InvalidAppId"] = "The app ID is invalid. Please contact the app owner.";
-  PaymentErrorMessage2["GenericError"] = "Something unexpected went wrong. Please try again.";
-  PaymentErrorMessage2["DuplicateReference"] = "This reference ID already exists please generate a new one and try again.";
-  return PaymentErrorMessage2;
-})(PaymentErrorMessage || {});
+var PaymentErrorMessage = {
+  ["input_error" /* InputError */]: "There was a problem with this request. Please try again or contact the app owner.",
+  ["payment_rejected" /* PaymentRejected */]: "You\u2019ve cancelled the payment in World App.",
+  ["invalid_receiver" /* InvalidReceiver */]: "The receiver address is invalid. Please contact the app owner.",
+  ["insufficient_balance" /* InsufficientBalance */]: "You do not have enough balance to complete this transaction.",
+  ["transaction_failed" /* TransactionFailed */]: "The transaction failed. Please try again.",
+  ["generic_error" /* GenericError */]: "Something unexpected went wrong. Please try again.",
+  ["user_blocked" /* UserBlocked */]: "User's region is blocked from making payments."
+};
+var PaymentValidationErrors = /* @__PURE__ */ ((PaymentValidationErrors2) => {
+  PaymentValidationErrors2["MalformedRequest"] = "There was a problem with this request. Please try again or contact the app owner.";
+  PaymentValidationErrors2["InvalidTokenAddress"] = "The token address is invalid. Please contact the app owner.";
+  PaymentValidationErrors2["InvalidAppId"] = "The app ID is invalid. Please contact the app owner.";
+  PaymentValidationErrors2["DuplicateReference"] = "This reference ID already exists please generate a new one and try again.";
+  return PaymentValidationErrors2;
+})(PaymentValidationErrors || {});
 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
@@ -335,11 +359,44 @@ var validateWalletAuthCommandInput = (params) => {
   return { valid: true };
 };
 
+// helpers/payment/client.ts
+var tokenToDecimals = (amount, token) => {
+  const decimals = TokenDecimals[token];
+  if (decimals === void 0) {
+    throw new Error(`Invalid token: ${token}`);
+  }
+  const factor = 10 ** decimals;
+  const result = amount * factor;
+  if (!Number.isInteger(result)) {
+    throw new Error(`The resulting amount is not a whole number: ${result}`);
+  }
+  return result;
+};
+var validatePaymentPayload = (payload) => {
+  if (payload.tokens.some(
+    (token) => token.symbol == "USDCE" && parseFloat(token.token_amount) < 0.1
+  )) {
+    console.error("USDCE amount should be greater than $0.1");
+    return false;
+  }
+  if (payload.reference.length > 36) {
+    console.error("Reference must not exceed 36 characters");
+    return false;
+  }
+  return true;
+};
+
 // minikit.ts
 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 +410,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 +459,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 +482,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) => {
@@ -397,8 +496,7 @@ _MiniKit.commands = {
       );
       return null;
     }
-    if (payload.reference.length > 36) {
-      console.error("Reference must not exceed 36 characters");
+    if (!validatePaymentPayload(payload)) {
       return null;
     }
     const network = "optimism" /* Optimism */;
@@ -408,6 +506,7 @@ _MiniKit.commands = {
     };
     sendMiniKitEvent({
       command: "pay" /* Pay */,
+      version: _MiniKit.commandVersion["pay" /* Pay */],
       payload: eventPayload
     });
     return eventPayload;
@@ -451,6 +550,7 @@ _MiniKit.commands = {
     const walletAuthPayload = { siweMessage };
     sendMiniKitEvent({
       command: "wallet-auth" /* WalletAuth */,
+      version: _MiniKit.commandVersion["wallet-auth" /* WalletAuth */],
       payload: walletAuthPayload
     });
     return walletAuthPayload;
@@ -461,29 +561,19 @@ _MiniKit.commands = {
 };
 var MiniKit = _MiniKit;
 
-// helpers/payment/client.ts
-var tokenToDecimals = (amount, token) => {
-  const decimals = TokenDecimals[token];
-  if (decimals === void 0) {
-    throw new Error(`Invalid token: ${token}`);
-  }
-  const factor = 10 ** decimals;
-  const result = amount * factor;
-  if (!Number.isInteger(result)) {
-    throw new Error(`The resulting amount is not a whole number: ${result}`);
-  }
-  return result;
-};
-
 // 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,
+  PaymentValidationErrors,
   ResponseEvent,
   SAFE_CONTRACT_ABI,
   TokenDecimals,
@@ -496,5 +586,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;
@@ -36,28 +37,39 @@ declare enum PaymentErrorCodes {
     InvalidReceiver = "invalid_receiver",
     InsufficientBalance = "insufficient_balance",
     TransactionFailed = "transaction_failed",
-    GenericError = "generic_error"
+    GenericError = "generic_error",
+    UserBlocked = "user_blocked"
 }
-declare enum PaymentErrorMessage {
+declare const PaymentErrorMessage: Record<PaymentErrorCodes, string>;
+declare enum PaymentValidationErrors {
     MalformedRequest = "There was a problem with this request. Please try again or contact the app owner.",
-    PaymentRejected = "You\u2019ve cancelled the payment in World App.",
-    InvalidReceiver = "The receiver address is invalid. Please contact the app owner.",
-    InsufficientBalance = "You do not have enough balance to complete this transaction.",
-    TransactionFailed = "The transaction failed. Please try again.",
     InvalidTokenAddress = "The token address is invalid. Please contact the app owner.",
     InvalidAppId = "The app ID is invalid. Please contact the app owner.",
-    GenericError = "Something unexpected went wrong. Please try again.",
     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 +83,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 +99,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 +112,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 +150,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 +177,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 +206,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, PaymentValidationErrors, 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;
@@ -36,28 +37,39 @@ declare enum PaymentErrorCodes {
     InvalidReceiver = "invalid_receiver",
     InsufficientBalance = "insufficient_balance",
     TransactionFailed = "transaction_failed",
-    GenericError = "generic_error"
+    GenericError = "generic_error",
+    UserBlocked = "user_blocked"
 }
-declare enum PaymentErrorMessage {
+declare const PaymentErrorMessage: Record<PaymentErrorCodes, string>;
+declare enum PaymentValidationErrors {
     MalformedRequest = "There was a problem with this request. Please try again or contact the app owner.",
-    PaymentRejected = "You\u2019ve cancelled the payment in World App.",
-    InvalidReceiver = "The receiver address is invalid. Please contact the app owner.",
-    InsufficientBalance = "You do not have enough balance to complete this transaction.",
-    TransactionFailed = "The transaction failed. Please try again.",
     InvalidTokenAddress = "The token address is invalid. Please contact the app owner.",
     InvalidAppId = "The app ID is invalid. Please contact the app owner.",
-    GenericError = "Something unexpected went wrong. Please try again.",
     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 +83,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 +99,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 +112,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 +150,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 +177,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 +206,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, PaymentValidationErrors, ResponseEvent, SAFE_CONTRACT_ABI, type SiweMessage, TokenDecimals, Tokens, VerificationErrorMessage, type VerifyCommandInput, WalletAuthErrorCodes, WalletAuthErrorMessage, generateNonce, parseSiweMessage, tokenToDecimals, verifySiweMessage };

package/build/index.js

@@ -200,30 +200,50 @@ var PaymentErrorCodes = /* @__PURE__ */ ((PaymentErrorCodes2) => {
   PaymentErrorCodes2["InsufficientBalance"] = "insufficient_balance";
   PaymentErrorCodes2["TransactionFailed"] = "transaction_failed";
   PaymentErrorCodes2["GenericError"] = "generic_error";
+  PaymentErrorCodes2["UserBlocked"] = "user_blocked";
   return PaymentErrorCodes2;
 })(PaymentErrorCodes || {});
-var PaymentErrorMessage = /* @__PURE__ */ ((PaymentErrorMessage2) => {
-  PaymentErrorMessage2["MalformedRequest"] = "There was a problem with this request. Please try again or contact the app owner.";
-  PaymentErrorMessage2["PaymentRejected"] = "You\u2019ve cancelled the payment in World App.";
-  PaymentErrorMessage2["InvalidReceiver"] = "The receiver address is invalid. Please contact the app owner.";
-  PaymentErrorMessage2["InsufficientBalance"] = "You do not have enough balance to complete this transaction.";
-  PaymentErrorMessage2["TransactionFailed"] = "The transaction failed. Please try again.";
-  PaymentErrorMessage2["InvalidTokenAddress"] = "The token address is invalid. Please contact the app owner.";
-  PaymentErrorMessage2["InvalidAppId"] = "The app ID is invalid. Please contact the app owner.";
-  PaymentErrorMessage2["GenericError"] = "Something unexpected went wrong. Please try again.";
-  PaymentErrorMessage2["DuplicateReference"] = "This reference ID already exists please generate a new one and try again.";
-  return PaymentErrorMessage2;
-})(PaymentErrorMessage || {});
+var PaymentErrorMessage = {
+  ["input_error" /* InputError */]: "There was a problem with this request. Please try again or contact the app owner.",
+  ["payment_rejected" /* PaymentRejected */]: "You\u2019ve cancelled the payment in World App.",
+  ["invalid_receiver" /* InvalidReceiver */]: "The receiver address is invalid. Please contact the app owner.",
+  ["insufficient_balance" /* InsufficientBalance */]: "You do not have enough balance to complete this transaction.",
+  ["transaction_failed" /* TransactionFailed */]: "The transaction failed. Please try again.",
+  ["generic_error" /* GenericError */]: "Something unexpected went wrong. Please try again.",
+  ["user_blocked" /* UserBlocked */]: "User's region is blocked from making payments."
+};
+var PaymentValidationErrors = /* @__PURE__ */ ((PaymentValidationErrors2) => {
+  PaymentValidationErrors2["MalformedRequest"] = "There was a problem with this request. Please try again or contact the app owner.";
+  PaymentValidationErrors2["InvalidTokenAddress"] = "The token address is invalid. Please contact the app owner.";
+  PaymentValidationErrors2["InvalidAppId"] = "The app ID is invalid. Please contact the app owner.";
+  PaymentValidationErrors2["DuplicateReference"] = "This reference ID already exists please generate a new one and try again.";
+  return PaymentValidationErrors2;
+})(PaymentValidationErrors || {});
 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
@@ -292,11 +312,44 @@ var validateWalletAuthCommandInput = (params) => {
   return { valid: true };
 };
 
+// helpers/payment/client.ts
+var tokenToDecimals = (amount, token) => {
+  const decimals = TokenDecimals[token];
+  if (decimals === void 0) {
+    throw new Error(`Invalid token: ${token}`);
+  }
+  const factor = 10 ** decimals;
+  const result = amount * factor;
+  if (!Number.isInteger(result)) {
+    throw new Error(`The resulting amount is not a whole number: ${result}`);
+  }
+  return result;
+};
+var validatePaymentPayload = (payload) => {
+  if (payload.tokens.some(
+    (token) => token.symbol == "USDCE" && parseFloat(token.token_amount) < 0.1
+  )) {
+    console.error("USDCE amount should be greater than $0.1");
+    return false;
+  }
+  if (payload.reference.length > 36) {
+    console.error("Reference must not exceed 36 characters");
+    return false;
+  }
+  return true;
+};
+
 // minikit.ts
 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 +363,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 +412,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 +435,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) => {
@@ -354,8 +449,7 @@ _MiniKit.commands = {
       );
       return null;
     }
-    if (payload.reference.length > 36) {
-      console.error("Reference must not exceed 36 characters");
+    if (!validatePaymentPayload(payload)) {
       return null;
     }
     const network = "optimism" /* Optimism */;
@@ -365,6 +459,7 @@ _MiniKit.commands = {
     };
     sendMiniKitEvent({
       command: "pay" /* Pay */,
+      version: _MiniKit.commandVersion["pay" /* Pay */],
       payload: eventPayload
     });
     return eventPayload;
@@ -408,6 +503,7 @@ _MiniKit.commands = {
     const walletAuthPayload = { siweMessage };
     sendMiniKitEvent({
       command: "wallet-auth" /* WalletAuth */,
+      version: _MiniKit.commandVersion["wallet-auth" /* WalletAuth */],
       payload: walletAuthPayload
     });
     return walletAuthPayload;
@@ -418,28 +514,20 @@ _MiniKit.commands = {
 };
 var MiniKit = _MiniKit;
 
-// helpers/payment/client.ts
-var tokenToDecimals = (amount, token) => {
-  const decimals = TokenDecimals[token];
-  if (decimals === void 0) {
-    throw new Error(`Invalid token: ${token}`);
-  }
-  const factor = 10 ** decimals;
-  const result = amount * factor;
-  if (!Number.isInteger(result)) {
-    throw new Error(`The resulting amount is not a whole number: ${result}`);
-  }
-  return result;
-};
-
 // 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,
+  PaymentValidationErrors,
   ResponseEvent,
   SAFE_CONTRACT_ABI,
   TokenDecimals,
@@ -452,5 +540,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.23-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",
@@ -24,6 +24,13 @@
     "minikit",
     "miniapps"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint ./ --ext .ts",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
     "@worldcoin/idkit-core": "^1.2.0"
   },
@@ -37,12 +44,6 @@
     "typescript": "^5.4.5"
   },
   "peerDependencies": {
-    "ethers": "^5.6.8 || ^6.0.8"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint ./ --ext .ts",
-    "typecheck": "tsc --noEmit"
+    "ethers": "^6.0.8"
   }
-}
+}