@worldcoin/minikit-js 1.11.0 → 2.0.0-dev.1

package/build/index.d.cts

@@ -1,643 +1,123 @@
-import { TypedData, TypedDataDomain, Abi, AbiStateMutability, ExtractAbiFunctionNames, AbiParametersToPrimitiveTypes, ExtractAbiFunction } from 'abitype';
-import { IDKitConfig, VerificationLevel } from '@worldcoin/idkit-core';
-export { ISuccessResult, AppErrorCodes as VerificationErrorCodes, VerificationLevel } from '@worldcoin/idkit-core';
-export { IVerifyResponse, verifyCloudProof } from '@worldcoin/idkit-core/backend';
-import { Client } from 'viem';
-
-type User = {
-    walletAddress?: string;
-    username?: string;
-    profilePictureUrl?: string;
-    permissions?: {
-        notifications: boolean;
-        contacts: boolean;
-    };
-    optedIntoOptionalAnalytics?: boolean;
-    preferredCurrency?: string;
-    /** @deprecated Moved to DeviceProperties */
-    worldAppVersion?: number;
-    /** @deprecated Moved to DeviceProperties */
-    deviceOS?: string;
-};
-type DeviceProperties = {
-    safeAreaInsets?: {
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    };
-    deviceOS?: string;
-    worldAppVersion?: number;
-};
-type UserNameService = {
-    walletAddress: string;
-    username?: string;
-    profilePictureUrl?: string;
-};
-type MiniAppLocation = {
-    countryCode?: string;
-    regionCode?: string;
-};
-declare enum MiniAppLaunchLocation {
-    Chat = "chat",
-    Home = "home",
-    AppStore = "app-store",
-    DeepLink = "deep-link",
-    WalletTab = "wallet-tab"
-}
-declare const mapWorldAppLaunchLocation: (location: string | null | undefined) => MiniAppLaunchLocation | null;
-
-type EventPayload<T extends ResponseEvent = ResponseEvent> = any;
-type EventHandler<E extends ResponseEvent = ResponseEvent> = <T extends EventPayload<E>>(data: T) => void;
-declare class EventManager {
-    private listeners;
-    private verifyActionProcessingOptionsQueue;
-    subscribe<E extends ResponseEvent>(event: E, handler: EventHandler<E>): void;
-    unsubscribe(event: ResponseEvent): void;
-    setVerifyActionProcessingOptions(options?: {
-        skip_proof_compression?: boolean;
-    }): void;
-    trigger(event: ResponseEvent, payload: EventPayload): void;
-    private processVerifyActionPayload;
-    private compressProofSafely;
-}
-
-declare class MiniKitState {
-    appId: string | null;
-    user: User;
-    deviceProperties: DeviceProperties;
-    location: MiniAppLaunchLocation | null;
-    isReady: boolean;
-    initFromWorldApp(worldApp: typeof window.WorldApp): void;
-    updateUserFromWalletAuth(address: string): Promise<void>;
-    getUserByAddress(address?: string): Promise<UserNameService>;
-    getUserByUsername(username: string): Promise<UserNameService>;
-}
-
-declare enum MiniKitInstallErrorCodes {
-    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 Command {
-    Verify = "verify",
-    Pay = "pay",
-    WalletAuth = "wallet-auth",
-    SendTransaction = "send-transaction",
-    SignMessage = "sign-message",
-    SignTypedData = "sign-typed-data",
-    ShareContacts = "share-contacts",
-    RequestPermission = "request-permission",
-    GetPermissions = "get-permissions",
-    SendHapticFeedback = "send-haptic-feedback",
-    Share = "share",
-    Chat = "chat",
-    Attestation = "attestation",
-    CloseMiniApp = "close-miniapp"
-}
-declare enum ResponseEvent {
-    MiniAppVerifyAction = "miniapp-verify-action",
-    MiniAppPayment = "miniapp-payment",
-    MiniAppWalletAuth = "miniapp-wallet-auth",
-    MiniAppSendTransaction = "miniapp-send-transaction",
-    MiniAppSignMessage = "miniapp-sign-message",
-    MiniAppSignTypedData = "miniapp-sign-typed-data",
-    MiniAppShareContacts = "miniapp-share-contacts",
-    MiniAppRequestPermission = "miniapp-request-permission",
-    MiniAppGetPermissions = "miniapp-get-permissions",
-    MiniAppSendHapticFeedback = "miniapp-send-haptic-feedback",
-    MiniAppShare = "miniapp-share",
-    MiniAppMicrophone = "miniapp-microphone",
-    MiniAppChat = "miniapp-chat",
-    MiniAppAttestation = "miniapp-attestation"
-}
-declare const COMMAND_VERSIONS: Record<Command, number>;
-declare function isCommandAvailable(command: Command): boolean;
-declare function setCommandAvailable(command: Command, available: boolean): void;
-declare function validateCommands(worldAppSupportedCommands: NonNullable<typeof window.WorldApp>['supported_commands']): boolean;
-interface CommandContext {
-    events: EventManager;
-    state: MiniKitState;
-}
-type MiniAppBaseSuccessPayload = {
-    status: 'success';
-    version: number;
-};
-type MiniAppBaseErrorPayload<TErrorCode = string> = {
-    status: 'error';
-    error_code: TErrorCode;
-    version: number;
-};
-type AsyncHandlerReturn<CommandPayload, FinalPayload> = Promise<{
-    commandPayload: CommandPayload;
-    finalPayload: FinalPayload;
-}>;
-type WebViewBasePayload = {
-    command: Command;
-    version: number;
-    payload: Record<string, any>;
-};
-
-type MiniKitInstallReturnType = {
-    success: true;
-} | {
-    success: false;
-    errorCode: MiniKitInstallErrorCodes;
-    errorMessage: (typeof MiniKitInstallErrorMessage)[MiniKitInstallErrorCodes];
-};
-declare function sendMiniKitEvent<T extends WebViewBasePayload = WebViewBasePayload>(payload: T): void;
-
-type AttestationInput = {
-    /**
-     * Hex-encoded hash of the request to be attested.
-     * Hash must be generated per hashing spec documented in MiniKit docs.
-     */
-    requestHash: string;
-};
-type AttestationPayload = {
-    request_hash: string;
-};
-declare enum AttestationErrorCodes {
-    Unauthorized = "unauthorized",
-    AttestationFailed = "attestation_failed",
-    IntegrityFailed = "integrity_failed",
-    InvalidInput = "invalid_input",
-    UnsupportedVersion = "unsupported_version"
-}
-declare const AttestationErrorMessage: Record<AttestationErrorCodes, string>;
-type MiniAppAttestationSuccessPayload = MiniAppBaseSuccessPayload & {
-    token: string;
-};
-type MiniAppAttestationErrorPayload = MiniAppBaseErrorPayload<AttestationErrorCodes> & {
-    description: string;
-};
-type MiniAppAttestationPayload = MiniAppAttestationSuccessPayload | MiniAppAttestationErrorPayload;
-declare function createAttestationCommand(_ctx: CommandContext): (input: AttestationInput) => AttestationPayload | null;
-declare function createAttestationAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createAttestationCommand>): (input: AttestationInput) => AsyncHandlerReturn<AttestationPayload | null, MiniAppAttestationPayload>;
-
-type ChatPayload = {
-    to?: string[];
-    message: string;
-};
-declare enum ChatErrorCodes {
-    UserRejected = "user_rejected",
-    SendFailed = "send_failed",
-    GenericError = "generic_error"
-}
-declare const ChatErrorMessage: {
-    user_rejected: string;
-    send_failed: string;
-    generic_error: string;
-};
-type MiniAppChatSuccessPayload = MiniAppBaseSuccessPayload & {
-    count: number;
-    timestamp: string;
-};
-type MiniAppChatErrorPayload = MiniAppBaseErrorPayload<ChatErrorCodes>;
-type MiniAppChatPayload = MiniAppChatSuccessPayload | MiniAppChatErrorPayload;
-declare function createChatCommand(_ctx: CommandContext): (payload: ChatPayload) => ChatPayload | null;
-declare function createChatAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createChatCommand>): (payload: ChatPayload) => AsyncHandlerReturn<ChatPayload | null, MiniAppChatPayload>;
-
-type ShareInput = {
-    files?: File[];
-    title?: string;
-    text?: string;
-    url?: string;
-};
-type SharePayload = {
-    files?: Array<{
-        name: string;
-        type: string;
-        data: string;
-    }>;
-    title?: string;
-    text?: string;
-    url?: string;
-};
-declare enum ShareFilesErrorCodes {
-    UserRejected = "user_rejected",
-    GenericError = "generic_error",
-    InvalidFileName = "invalid_file_name"
-}
-declare const ShareFilesErrorMessage: {
-    user_rejected: string;
-    generic_error: string;
-    invalid_file_name: string;
-};
-type MiniAppShareSuccessPayload = MiniAppBaseSuccessPayload & {
-    shared_files_count: number;
-    timestamp: string;
-};
-type MiniAppShareErrorPayload = MiniAppBaseErrorPayload<ShareFilesErrorCodes>;
-type MiniAppSharePayload = MiniAppShareSuccessPayload | MiniAppShareErrorPayload;
-declare function createShareCommand(ctx: CommandContext): (payload: ShareInput) => ShareInput | null;
-declare function createShareAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createShareCommand>): (payload: ShareInput) => AsyncHandlerReturn<ShareInput | null, MiniAppSharePayload>;
-
-type SendHapticFeedbackInput = {
-    hapticsType: 'notification';
-    style: 'error' | 'success' | 'warning';
-} | {
-    hapticsType: 'selection-changed';
-    style?: never;
-} | {
-    hapticsType: 'impact';
-    style: 'light' | 'medium' | 'heavy';
-};
-type SendHapticFeedbackPayload = SendHapticFeedbackInput;
-declare enum SendHapticFeedbackErrorCodes {
-    GenericError = "generic_error",
-    UserRejected = "user_rejected"
-}
-declare const SendHapticFeedbackErrorMessage: {
-    generic_error: string;
-    user_rejected: string;
-};
-type MiniAppSendHapticFeedbackSuccessPayload = MiniAppBaseSuccessPayload & {
-    timestamp: string;
-};
-type MiniAppSendHapticFeedbackErrorPayload = MiniAppBaseErrorPayload<SendHapticFeedbackErrorCodes>;
-type MiniAppSendHapticFeedbackPayload = MiniAppSendHapticFeedbackSuccessPayload | MiniAppSendHapticFeedbackErrorPayload;
-declare function createSendHapticFeedbackCommand(_ctx: CommandContext): (payload: SendHapticFeedbackInput) => SendHapticFeedbackPayload | null;
-declare function createSendHapticFeedbackAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createSendHapticFeedbackCommand>): (payload: SendHapticFeedbackInput) => AsyncHandlerReturn<SendHapticFeedbackPayload | null, MiniAppSendHapticFeedbackPayload>;
-
-type GetPermissionsInput = {};
-type GetPermissionsPayload = {
-    status?: string;
-};
-declare enum GetPermissionsErrorCodes {
-    GenericError = "generic_error"
-}
-declare const GetPermissionsErrorMessage: {
-    generic_error: string;
-};
-declare enum Permission {
-    Notifications = "notifications",
-    Contacts = "contacts",
-    Microphone = "microphone"
-}
-type PermissionSettings = {
-    [K in Permission]?: any;
-};
-type MiniAppGetPermissionsSuccessPayload = MiniAppBaseSuccessPayload & {
-    permissions: PermissionSettings;
-    timestamp: string;
-};
-type MiniAppGetPermissionsErrorPayload = MiniAppBaseErrorPayload<GetPermissionsErrorCodes> & {
-    details: string;
-};
-type MiniAppGetPermissionsPayload = MiniAppGetPermissionsSuccessPayload | MiniAppGetPermissionsErrorPayload;
-declare function createGetPermissionsCommand(_ctx: CommandContext): () => GetPermissionsPayload | null;
-declare function createGetPermissionsAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createGetPermissionsCommand>): () => AsyncHandlerReturn<GetPermissionsPayload | null, MiniAppGetPermissionsPayload>;
-
-type RequestPermissionInput = {
-    permission: Permission;
-};
-type RequestPermissionPayload = RequestPermissionInput;
-declare enum RequestPermissionErrorCodes {
-    UserRejected = "user_rejected",
-    GenericError = "generic_error",
-    AlreadyRequested = "already_requested",
-    PermissionDisabled = "permission_disabled",
-    AlreadyGranted = "already_granted",
-    UnsupportedPermission = "unsupported_permission"
-}
-declare const RequestPermissionErrorMessage: {
-    user_rejected: string;
-    generic_error: string;
-    already_requested: string;
-    permission_disabled: string;
-    already_granted: string;
-    unsupported_permission: string;
-};
-type MiniAppRequestPermissionSuccessPayload = MiniAppBaseSuccessPayload & {
-    permission: Permission;
-    timestamp: string;
-};
-type MiniAppRequestPermissionErrorPayload = MiniAppBaseErrorPayload<RequestPermissionErrorCodes> & {
-    description: string;
-};
-type MiniAppRequestPermissionPayload = MiniAppRequestPermissionSuccessPayload | MiniAppRequestPermissionErrorPayload;
-declare function createRequestPermissionCommand(_ctx: CommandContext): (payload: RequestPermissionInput) => RequestPermissionPayload | null;
-declare function createRequestPermissionAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createRequestPermissionCommand>): (payload: RequestPermissionInput) => AsyncHandlerReturn<RequestPermissionPayload | null, MiniAppRequestPermissionPayload>;
-
-type ShareContactsInput = {
-    isMultiSelectEnabled: boolean;
-    inviteMessage?: string;
-};
-type ShareContactsPayload = ShareContactsInput;
-declare enum ShareContactsErrorCodes {
-    UserRejected = "user_rejected",
-    GenericError = "generic_error"
-}
-declare const ShareContactsErrorMessage: {
-    user_rejected: string;
-    generic_error: string;
-};
-type Contact = {
-    username: string;
-    walletAddress: string;
-    profilePictureUrl: string | null;
-};
-type MiniAppShareContactsSuccessPayload = MiniAppBaseSuccessPayload & {
-    contacts: Contact[];
-    timestamp: string;
-};
-type MiniAppShareContactsErrorPayload = MiniAppBaseErrorPayload<ShareContactsErrorCodes>;
-type MiniAppShareContactsPayload = MiniAppShareContactsSuccessPayload | MiniAppShareContactsErrorPayload;
-declare function createShareContactsCommand(_ctx: CommandContext): (payload: ShareContactsPayload) => ShareContactsPayload | null;
-declare function createShareContactsAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createShareContactsCommand>): (payload: ShareContactsPayload) => AsyncHandlerReturn<ShareContactsPayload | null, MiniAppShareContactsPayload>;
-
-/** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-type SignTypedDataInput = {
-    types: TypedData;
-    primaryType: string;
-    message: Record<string, unknown>;
-    domain?: TypedDataDomain;
-    chainId?: number;
-};
-/** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-type SignTypedDataPayload = SignTypedDataInput;
-/** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-declare enum SignTypedDataErrorCodes {
-    InvalidOperation = "invalid_operation",
-    UserRejected = "user_rejected",
-    InputError = "input_error",
-    SimulationFailed = "simulation_failed",
-    GenericError = "generic_error",
-    DisallowedOperation = "disallowed_operation",
-    InvalidContract = "invalid_contract",
-    MaliciousOperation = "malicious_operation"
-}
-/** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-declare const SignTypedDataErrorMessage: {
-    invalid_operation: string;
-    user_rejected: string;
-    input_error: string;
-    simulation_failed: string;
-    generic_error: string;
-    disallowed_operation: string;
-    invalid_contract: string;
-    malicious_operation: string;
-};
-/** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-type MiniAppSignTypedDataSuccessPayload = MiniAppBaseSuccessPayload & {
-    signature: string;
-    address: string;
-};
-/** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-type MiniAppSignTypedDataErrorPayload = MiniAppBaseErrorPayload<SignTypedDataErrorCodes> & {
-    details?: Record<string, any>;
-};
-/** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-type MiniAppSignTypedDataPayload = MiniAppSignTypedDataSuccessPayload | MiniAppSignTypedDataErrorPayload;
-declare function createSignTypedDataCommand(_ctx: CommandContext): (payload: SignTypedDataInput) => SignTypedDataPayload | null;
-declare function createSignTypedDataAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createSignTypedDataCommand>): (payload: SignTypedDataInput) => AsyncHandlerReturn<SignTypedDataPayload | null, MiniAppSignTypedDataPayload>;
-
-type SignMessageInput = {
-    message: string;
-};
-type SignMessagePayload = SignMessageInput;
-declare enum SignMessageErrorCodes {
-    InvalidMessage = "invalid_message",
-    UserRejected = "user_rejected",
-    GenericError = "generic_error"
-}
-declare const SignMessageErrorMessage: {
-    invalid_message: string;
-    user_rejected: string;
-    generic_error: string;
-};
-type MiniAppSignMessageSuccessPayload = MiniAppBaseSuccessPayload & {
-    signature: string;
-    address: string;
-};
-type MiniAppSignMessageErrorPayload = MiniAppBaseErrorPayload<SignMessageErrorCodes> & {
-    details?: Record<string, any>;
-};
-type MiniAppSignMessagePayload = MiniAppSignMessageSuccessPayload | MiniAppSignMessageErrorPayload;
-declare function createSignMessageCommand(_ctx: CommandContext): (payload: SignMessageInput) => SignMessagePayload | null;
-declare function createSignMessageAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createSignMessageCommand>): (payload: SignMessageInput) => AsyncHandlerReturn<SignMessagePayload | null, MiniAppSignMessagePayload>;
-
-declare enum Tokens {
-    USDC = "USDCE",
-    WLD = "WLD"
-}
-declare const TokenDecimals: {
-    [key in Tokens]: number;
-};
-declare enum Network {
-    Optimism = "optimism",
-    WorldChain = "worldchain"
-}
-
-type Permit2 = {
-    permitted: {
-        token: string;
-        amount: string | unknown;
-    };
-    spender: string;
-    nonce: string | unknown;
-    deadline: string | unknown;
-};
-type Transaction = {
-    address: string;
-    abi: Abi | readonly unknown[];
-    functionName: ContractFunctionName<Abi | readonly unknown[], 'payable' | 'nonpayable'>;
-    value?: string | undefined;
-    args: ContractFunctionArgs<Abi | readonly unknown[], 'payable' | 'nonpayable', ContractFunctionName<Abi | readonly unknown[], 'payable' | 'nonpayable'>>;
-};
-type ContractFunctionName<abi extends Abi | readonly unknown[] = Abi, mutability extends AbiStateMutability = AbiStateMutability> = ExtractAbiFunctionNames<abi extends Abi ? abi : Abi, mutability> extends infer functionName extends string ? [functionName] extends [never] ? string : functionName : string;
-type ContractFunctionArgs<abi extends Abi | readonly unknown[] = Abi, mutability extends AbiStateMutability = AbiStateMutability, functionName extends ContractFunctionName<abi, mutability> = ContractFunctionName<abi, mutability>> = AbiParametersToPrimitiveTypes<ExtractAbiFunction<abi extends Abi ? abi : Abi, functionName, mutability>['inputs'], 'inputs'> extends infer args ? [args] extends [never] ? readonly unknown[] : args : readonly unknown[];
-
-type SendTransactionInput = {
-    transaction: Transaction[];
-    permit2?: Permit2[];
-    formatPayload?: boolean;
-};
-type SendTransactionPayload = SendTransactionInput;
-declare enum SendTransactionErrorCodes {
-    InvalidOperation = "invalid_operation",
-    UserRejected = "user_rejected",
-    InputError = "input_error",
-    SimulationFailed = "simulation_failed",
-    TransactionFailed = "transaction_failed",
-    GenericError = "generic_error",
-    DisallowedOperation = "disallowed_operation",
-    ValidationError = "validation_error",
-    InvalidContract = "invalid_contract",
-    MaliciousOperation = "malicious_operation",
-    DailyTxLimitReached = "daily_tx_limit_reached",
-    PermittedAmountExceedsSlippage = "permitted_amount_exceeds_slippage",
-    PermittedAmountNotFound = "permitted_amount_not_found"
-}
-declare const SendTransactionErrorMessage: Record<SendTransactionErrorCodes, string>;
-type MiniAppSendTransactionSuccessPayload = MiniAppBaseSuccessPayload & {
-    transaction_status: 'submitted';
-    transaction_id: string;
-    reference: string;
-    from: string;
-    chain: Network;
-    timestamp: string;
-    mini_app_id?: string;
-};
-type MiniAppSendTransactionErrorPayload = MiniAppBaseErrorPayload<SendTransactionErrorCodes> & {
-    details?: Record<string, any>;
-    mini_app_id?: string;
-};
-type MiniAppSendTransactionPayload = MiniAppSendTransactionSuccessPayload | MiniAppSendTransactionErrorPayload;
-declare function createSendTransactionCommand(_ctx: CommandContext): (payload: SendTransactionInput) => SendTransactionPayload | null;
-declare function createSendTransactionAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createSendTransactionCommand>): (payload: SendTransactionInput) => AsyncHandlerReturn<SendTransactionPayload | null, MiniAppSendTransactionPayload>;
-
-type WalletAuthInput = {
-    nonce: string;
-    statement?: string;
-    requestId?: string;
-    expirationTime?: Date;
-    notBefore?: Date;
-};
-type WalletAuthPayload = {
-    siweMessage: string;
-};
-declare enum WalletAuthErrorCodes {
-    MalformedRequest = "malformed_request",
-    UserRejected = "user_rejected",
-    GenericError = "generic_error"
-}
-declare const WalletAuthErrorMessage: {
-    malformed_request: string;
-    user_rejected: string;
-    generic_error: string;
-};
-type MiniAppWalletAuthSuccessPayload$1 = MiniAppBaseSuccessPayload & {
-    message: string;
-    signature: string;
-    address: string;
-};
-type MiniAppWalletAuthErrorPayload = MiniAppBaseErrorPayload<WalletAuthErrorCodes> & {
-    details: (typeof WalletAuthErrorMessage)[WalletAuthErrorCodes];
-};
-type MiniAppWalletAuthPayload = MiniAppWalletAuthSuccessPayload$1 | MiniAppWalletAuthErrorPayload;
-declare function createWalletAuthCommand(ctx: CommandContext): (payload: WalletAuthInput) => WalletAuthPayload | null;
-declare function createWalletAuthAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createWalletAuthCommand>): (payload: WalletAuthInput) => AsyncHandlerReturn<WalletAuthPayload | null, MiniAppWalletAuthPayload>;
-
-type TokensPayload = {
-    symbol: Tokens;
-    token_amount: string;
-};
-type PayCommandInput = {
-    reference: string;
-    to: `0x${string}` | string;
-    tokens: TokensPayload[];
-    network?: Network;
-    description: string;
-};
-type PayCommandPayload = PayCommandInput;
-declare enum PaymentErrorCodes {
-    InputError = "input_error",
-    UserRejected = "user_rejected",
-    PaymentRejected = "payment_rejected",
-    InvalidReceiver = "invalid_receiver",
-    InsufficientBalance = "insufficient_balance",
-    TransactionFailed = "transaction_failed",
-    GenericError = "generic_error",
-    UserBlocked = "user_blocked"
-}
-declare const PaymentErrorMessage: Record<PaymentErrorCodes, string>;
-type MiniAppPaymentSuccessPayload = MiniAppBaseSuccessPayload & {
-    transaction_status: 'submitted';
-    transaction_id: string;
-    reference: string;
-    from: string;
-    chain: Network;
-    timestamp: string;
-};
-type MiniAppPaymentErrorPayload = MiniAppBaseErrorPayload<PaymentErrorCodes>;
-type MiniAppPaymentPayload = MiniAppPaymentSuccessPayload | MiniAppPaymentErrorPayload;
-declare function createPayCommand(_ctx: CommandContext): (payload: PayCommandInput) => PayCommandPayload | null;
-declare function createPayAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createPayCommand>): (payload: PayCommandInput) => AsyncHandlerReturn<PayCommandPayload | null, MiniAppPaymentPayload>;
-
-type VerifyCommandInput = {
-    action: IDKitConfig['action'];
-    signal?: IDKitConfig['signal'];
-    verification_level?: VerificationLevel | [VerificationLevel, ...VerificationLevel[]];
-    skip_proof_compression?: boolean;
-};
-type VerifyCommandPayload = Omit<VerifyCommandInput, 'skip_proof_compression'> & {
-    timestamp: string;
-};
-
-type MiniAppVerifyActionSuccessPayload = MiniAppBaseSuccessPayload & {
-    proof: string;
-    merkle_root: string;
-    nullifier_hash: string;
-    verification_level: VerificationLevel;
-};
-type VerificationResult = Omit<MiniAppVerifyActionSuccessPayload, 'status' | 'version'>;
-type MiniAppVerifyActionMultiSuccessPayload = MiniAppBaseSuccessPayload & {
-    verifications: VerificationResult[];
-};
-type MiniAppVerifyActionErrorPayload = MiniAppBaseErrorPayload<string>;
-type MiniAppVerifyActionPayload = MiniAppVerifyActionSuccessPayload | MiniAppVerifyActionMultiSuccessPayload | MiniAppVerifyActionErrorPayload;
-declare function createVerifyCommand(ctx: CommandContext): (payload: VerifyCommandInput) => VerifyCommandPayload | null;
-declare function createVerifyAsyncCommand(ctx: CommandContext, syncCommand: ReturnType<typeof createVerifyCommand>): (payload: VerifyCommandInput) => AsyncHandlerReturn<VerifyCommandPayload | null, MiniAppVerifyActionPayload>;
-
-declare function createCloseMiniAppCommand(_ctx: CommandContext): () => boolean;
-
-declare function createCommands(ctx: CommandContext): {
-    verify: (payload: VerifyCommandInput) => VerifyCommandPayload | null;
-    pay: (payload: PayCommandInput) => PayCommandPayload | null;
-    walletAuth: (payload: WalletAuthInput) => WalletAuthPayload | null;
-    sendTransaction: (payload: SendTransactionInput) => SendTransactionPayload | null;
-    signMessage: (payload: SignMessageInput) => SignMessagePayload | null;
-    /** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-    signTypedData: (payload: SignTypedDataInput) => SignTypedDataPayload | null;
-    shareContacts: (payload: ShareContactsPayload) => ShareContactsPayload | null;
-    requestPermission: (payload: RequestPermissionInput) => RequestPermissionPayload | null;
-    getPermissions: () => GetPermissionsPayload | null;
-    sendHapticFeedback: (payload: SendHapticFeedbackInput) => SendHapticFeedbackPayload | null;
-    share: (payload: ShareInput) => ShareInput | null;
-    chat: (payload: ChatPayload) => ChatPayload | null;
-    attestation: (input: AttestationInput) => AttestationPayload | null;
-    closeMiniApp: () => boolean;
-};
-type Commands = ReturnType<typeof createCommands>;
-declare function createAsyncCommands(ctx: CommandContext, commands: Commands): {
-    verify: (payload: VerifyCommandInput) => AsyncHandlerReturn<VerifyCommandPayload | null, MiniAppVerifyActionPayload>;
-    pay: (payload: PayCommandInput) => AsyncHandlerReturn<PayCommandPayload | null, MiniAppPaymentPayload>;
-    walletAuth: (payload: WalletAuthInput) => AsyncHandlerReturn<WalletAuthPayload | null, MiniAppWalletAuthPayload>;
-    sendTransaction: (payload: SendTransactionInput) => AsyncHandlerReturn<SendTransactionPayload | null, MiniAppSendTransactionPayload>;
-    signMessage: (payload: SignMessageInput) => AsyncHandlerReturn<SignMessagePayload | null, MiniAppSignMessagePayload>;
-    /** @deprecated EIP-712 typed data signing is deprecated. Use signMessage or sendTransaction instead. */
-    signTypedData: (payload: SignTypedDataInput) => AsyncHandlerReturn<SignTypedDataPayload | null, MiniAppSignTypedDataPayload>;
-    shareContacts: (payload: ShareContactsPayload) => AsyncHandlerReturn<ShareContactsPayload | null, MiniAppShareContactsPayload>;
-    requestPermission: (payload: RequestPermissionInput) => AsyncHandlerReturn<RequestPermissionPayload | null, MiniAppRequestPermissionPayload>;
-    getPermissions: () => AsyncHandlerReturn<GetPermissionsPayload | null, MiniAppGetPermissionsPayload>;
-    sendHapticFeedback: (payload: SendHapticFeedbackInput) => AsyncHandlerReturn<SendHapticFeedbackPayload | null, MiniAppSendHapticFeedbackPayload>;
-    share: (payload: ShareInput) => AsyncHandlerReturn<ShareInput | null, MiniAppSharePayload>;
-    chat: (payload: ChatPayload) => AsyncHandlerReturn<ChatPayload | null, MiniAppChatPayload>;
-    attestation: (input: AttestationInput) => AsyncHandlerReturn<AttestationPayload | null, MiniAppAttestationPayload>;
-};
-type AsyncCommands = ReturnType<typeof createAsyncCommands>;
+import { W as WalletAuthResult, M as MiniKitWalletAuthOptions, C as CommandResultByVia, i as isInWorldApp, U as User, D as DeviceProperties, a as MiniAppLaunchLocation, R as ResponseEvent, b as MiniKitInstallReturnType, c as UserNameService } from './types-CSyzFDPt.cjs';
+import { S as SendTransactionResult, M as MiniKitSendTransactionOptions, P as PayResult, a as MiniKitPayOptions, b as ShareContactsResult, c as MiniKitShareContactsOptions, d as MiniAppSignMessageSuccessPayload, e as MiniKitSignMessageOptions, f as MiniAppSignTypedDataPayload, g as MiniKitSignTypedDataOptions, h as MiniAppSignTypedDataSuccessPayload, i as MiniAppChatPayload, j as MiniKitChatOptions, k as MiniAppChatSuccessPayload, l as MiniAppSharePayload, m as MiniKitShareOptions, n as MiniAppShareSuccessPayload, o as MiniAppGetPermissionsPayload, p as MiniKitGetPermissionsOptions, q as MiniAppGetPermissionsSuccessPayload, r as MiniAppRequestPermissionPayload, s as MiniKitRequestPermissionOptions, t as MiniAppRequestPermissionSuccessPayload, u as MiniAppSendHapticFeedbackPayload, v as MiniKitSendHapticFeedbackOptions, w as MiniAppSendHapticFeedbackSuccessPayload, x as MiniAppAttestationSuccessPayload, y as MiniKitAttestationOptions, C as CloseMiniAppResult, z as MiniKitCloseMiniAppOptions } from './types-_jfLbcJW.cjs';
+export { W as WorldAppProvider, g as getWorldAppProvider } from './provider-DeDUsLbs.cjs';
+import 'abitype';
 
 declare class MiniKit {
     private static eventManager;
-    private static stateManager;
-    private static commandsInstance;
-    private static asyncCommandsInstance;
+    private static _appId;
+    private static _user;
+    private static _deviceProperties;
+    private static _location;
+    private static _isReady;
+    private static getActiveMiniKit;
+    /**
+     * Authenticate user via wallet signature (SIWE)
+     *
+     * Works in World App (native SIWE) and web (Wagmi + SIWE fallback).
+     *
+     * @example
+     * ```typescript
+     * const result = await MiniKit.walletAuth({ nonce: 'randomnonce123' });
+     * console.log(result.data.address);
+     * console.log(result.executedWith); // 'minikit' | 'wagmi' | 'fallback'
+     * ```
+     */
+    static walletAuth<TFallback = WalletAuthResult>(options: MiniKitWalletAuthOptions<TFallback>): Promise<CommandResultByVia<WalletAuthResult, TFallback>>;
+    /**
+     * Send one or more transactions
+     *
+     * World App: batch + permit2 + gas sponsorship
+     * Web: sequential execution via Wagmi
+     *
+     * @example
+     * ```typescript
+     * const result = await MiniKit.sendTransaction({
+     *   chainId: 480,
+     *   transactions: [{
+     *     to: '0x...',
+     *     data: '0x...',
+     *     value: '0x0',
+     *   }],
+     * });
+     * ```
+     */
+    static sendTransaction<TFallback = SendTransactionResult>(options: MiniKitSendTransactionOptions<TFallback>): Promise<CommandResultByVia<SendTransactionResult, TFallback>>;
+    /**
+     * Send a payment (World App only)
+     *
+     * Requires custom fallback on web.
+     *
+     * @example
+     * ```typescript
+     * const result = await MiniKit.pay({
+     *   reference: crypto.randomUUID(),
+     *   to: '0x...',
+     *   tokens: [{ symbol: Tokens.WLD, token_amount: '1.0' }],
+     *   description: 'Payment for coffee',
+     *   fallback: () => showStripeCheckout(),
+     * });
+     * ```
+     */
+    static pay<TFallback = PayResult>(options: MiniKitPayOptions<TFallback>): Promise<CommandResultByVia<PayResult, TFallback, 'minikit'>>;
+    /**
+     * Open the contact picker (World App only)
+     *
+     * Requires custom fallback on web.
+     *
+     * @example
+     * ```typescript
+     * const result = await MiniKit.shareContacts({
+     *   isMultiSelectEnabled: true,
+     *   fallback: () => showManualAddressInput(),
+     * });
+     * ```
+     */
+    static shareContacts<TFallback = ShareContactsResult>(options?: MiniKitShareContactsOptions<TFallback>): Promise<CommandResultByVia<ShareContactsResult, TFallback, 'minikit'>>;
+    /**
+     * Sign a message
+     */
+    static signMessage<TFallback = MiniAppSignMessageSuccessPayload>(options: MiniKitSignMessageOptions<TFallback>): Promise<CommandResultByVia<MiniAppSignMessageSuccessPayload, TFallback>>;
+    /**
+     * Sign typed data (EIP-712)
+     */
+    static signTypedData<TFallback = MiniAppSignTypedDataPayload>(options: MiniKitSignTypedDataOptions<TFallback>): Promise<CommandResultByVia<MiniAppSignTypedDataSuccessPayload, TFallback>>;
+    /**
+     * Send a chat message
+     */
+    static chat<TFallback = MiniAppChatPayload>(options: MiniKitChatOptions<TFallback>): Promise<CommandResultByVia<MiniAppChatSuccessPayload, TFallback, 'minikit'>>;
+    /**
+     * Share files/text/URL
+     */
+    static share<TFallback = MiniAppSharePayload>(options: MiniKitShareOptions<TFallback>): Promise<CommandResultByVia<MiniAppShareSuccessPayload, TFallback, 'minikit'>>;
+    /**
+     * Get current permission settings
+     */
+    static getPermissions<TFallback = MiniAppGetPermissionsPayload>(options?: MiniKitGetPermissionsOptions<TFallback>): Promise<CommandResultByVia<MiniAppGetPermissionsSuccessPayload, TFallback, 'minikit'>>;
+    /**
+     * Request a permission from the user
+     */
+    static requestPermission<TFallback = MiniAppRequestPermissionPayload>(options: MiniKitRequestPermissionOptions<TFallback>): Promise<CommandResultByVia<MiniAppRequestPermissionSuccessPayload, TFallback, 'minikit'>>;
+    /**
+     * Trigger haptic feedback
+     */
+    static sendHapticFeedback<TFallback = MiniAppSendHapticFeedbackPayload>(options: MiniKitSendHapticFeedbackOptions<TFallback>): Promise<CommandResultByVia<MiniAppSendHapticFeedbackSuccessPayload, TFallback, 'minikit'>>;
+    /**
+     * Request app attestation token for a request hash
+     */
+    static attestation<TFallback = MiniAppAttestationSuccessPayload>(options: MiniKitAttestationOptions<TFallback>): Promise<CommandResultByVia<MiniAppAttestationSuccessPayload, TFallback, 'minikit'>>;
+    /**
+     * Close the mini app
+     */
+    static closeMiniApp<TFallback = CloseMiniAppResult>(options?: MiniKitCloseMiniAppOptions<TFallback>): Promise<CommandResultByVia<CloseMiniAppResult, TFallback, 'minikit'>>;
+    /**
+     * Check if running inside World App
+     */
+    static isInWorldApp: typeof isInWorldApp;
     static get appId(): string | null;
     static set appId(value: string | null);
-    static get user(): typeof MiniKit.stateManager.user;
-    static set user(value: typeof MiniKit.stateManager.user);
+    static get user(): User;
+    static set user(value: User);
     static get deviceProperties(): DeviceProperties;
     static get location(): MiniAppLaunchLocation | null;
     static subscribe<E extends ResponseEvent>(event: E, handler: (payload: any) => void): void;
@@ -646,47 +126,39 @@ declare class MiniKit {
     private static sendInit;
     static install(appId?: string): MiniKitInstallReturnType;
     static isInstalled(debug?: boolean): boolean;
+    private static initFromWorldApp;
+    private static updateUserFromWalletAuth;
     private static getContext;
-    static get commands(): Commands;
-    static get commandsAsync(): AsyncCommands;
     static getUserByAddress: (address?: string) => Promise<UserNameService>;
     static getUserByUsername: (username: string) => Promise<UserNameService>;
     static getUserInfo: (address?: string) => Promise<UserNameService>;
     static getMiniAppUrl: (appId: string, path?: string) => string;
     static showProfileCard: (username?: string, walletAddress?: string) => void;
+    /**
+     * @deprecated Use `MiniKit.pay()`, `MiniKit.walletAuth()`, etc. directly.
+     *
+     * Migration guide:
+     * - `MiniKit.commands.pay(payload)` → `await MiniKit.pay(options)`
+     * - `MiniKit.commands.walletAuth(payload)` → `await MiniKit.walletAuth(options)`
+     * - `MiniKit.commands.sendTransaction(payload)` → `await MiniKit.sendTransaction(options)`
+     * - `MiniKit.commands.signMessage(payload)` → `await MiniKit.signMessage(input)`
+     * - `MiniKit.commands.signTypedData(payload)` → `await MiniKit.signTypedData(input)`
+     * - `MiniKit.commands.shareContacts(payload)` → `await MiniKit.shareContacts(options)`
+     * - `MiniKit.commands.chat(payload)` → `await MiniKit.chat(input)`
+     * - `MiniKit.commands.share(payload)` → `await MiniKit.share(input)`
+     * - `MiniKit.commands.getPermissions()` → `await MiniKit.getPermissions()`
+     * - `MiniKit.commands.requestPermission(payload)` → `await MiniKit.requestPermission(input)`
+     * - `MiniKit.commands.sendHapticFeedback(payload)` → `await MiniKit.sendHapticFeedback(input)`
+     * - `MiniKit.commands.attestation(payload)` → `await MiniKit.attestation(options)`
+     * - `MiniKit.commands.closeMiniApp()` → `await MiniKit.closeMiniApp()`
+     */
+    static get commands(): never;
+    /**
+     * @deprecated Use `MiniKit.pay()`, `MiniKit.walletAuth()`, etc. directly. All commands are now async by default.
+     *
+     * See `MiniKit.commands` deprecation notice for the full migration guide.
+     */
+    static get commandsAsync(): never;
 }
 
-type SiweMessage = {
-    scheme?: string;
-    domain: string;
-    address?: string;
-    statement?: string;
-    uri: string;
-    version: string;
-    chain_id: number;
-    nonce: string;
-    issued_at: string;
-    expiration_time?: string;
-    not_before?: string;
-    request_id?: string;
-};
-
-declare const tokenToDecimals: (amount: number, token: Tokens) => number;
-
-type MiniAppWalletAuthSuccessPayload = {
-    status: 'success';
-    message: string;
-    signature: string;
-    address: string;
-    version: number;
-};
-
-declare const parseSiweMessage: (inputString: string) => SiweMessage;
-declare const verifySiweMessage: (payload: MiniAppWalletAuthSuccessPayload, nonce: string, statement?: string, requestId?: string, userProvider?: Client) => Promise<{
-    isValid: boolean;
-    siweMessageData: SiweMessage;
-}>;
-
-declare const getIsUserVerified: (walletAddress: string, rpcUrl?: string) => Promise<boolean>;
-
-export { type AsyncCommands, type AsyncHandlerReturn, AttestationErrorCodes, AttestationErrorMessage, type AttestationInput, type AttestationPayload, COMMAND_VERSIONS, ChatErrorCodes, ChatErrorMessage, type ChatPayload, Command, type CommandContext, type Commands, type Contact, type ContractFunctionArgs, type ContractFunctionName, type DeviceProperties, GetPermissionsErrorCodes, GetPermissionsErrorMessage, type GetPermissionsInput, type GetPermissionsPayload, type MiniAppAttestationErrorPayload, type MiniAppAttestationPayload, type MiniAppAttestationSuccessPayload, type MiniAppBaseErrorPayload, type MiniAppBaseSuccessPayload, type MiniAppChatErrorPayload, type MiniAppChatPayload, type MiniAppChatSuccessPayload, type MiniAppGetPermissionsErrorPayload, type MiniAppGetPermissionsPayload, type MiniAppGetPermissionsSuccessPayload, MiniAppLaunchLocation, type MiniAppLocation, type MiniAppPaymentErrorPayload, type MiniAppPaymentPayload, type MiniAppPaymentSuccessPayload, type MiniAppRequestPermissionErrorPayload, type MiniAppRequestPermissionPayload, type MiniAppRequestPermissionSuccessPayload, type MiniAppSendHapticFeedbackErrorPayload, type MiniAppSendHapticFeedbackPayload, type MiniAppSendHapticFeedbackSuccessPayload, type MiniAppSendTransactionErrorPayload, type MiniAppSendTransactionPayload, type MiniAppSendTransactionSuccessPayload, type MiniAppShareContactsErrorPayload, type MiniAppShareContactsPayload, type MiniAppShareContactsSuccessPayload, type MiniAppShareErrorPayload, type MiniAppSharePayload, type MiniAppShareSuccessPayload, type MiniAppSignMessageErrorPayload, type MiniAppSignMessagePayload, type MiniAppSignMessageSuccessPayload, type MiniAppSignTypedDataErrorPayload, type MiniAppSignTypedDataPayload, type MiniAppSignTypedDataSuccessPayload, type MiniAppVerifyActionErrorPayload, type MiniAppVerifyActionMultiSuccessPayload, type MiniAppVerifyActionPayload, type MiniAppVerifyActionSuccessPayload, type MiniAppWalletAuthErrorPayload, type MiniAppWalletAuthPayload, type MiniAppWalletAuthSuccessPayload$1 as MiniAppWalletAuthSuccessPayload, MiniKit, MiniKitInstallErrorCodes, MiniKitInstallErrorMessage, type MiniKitInstallReturnType, Network, type PayCommandInput, type PayCommandPayload, PaymentErrorCodes, PaymentErrorMessage, Permission, type PermissionSettings, type Permit2, RequestPermissionErrorCodes, RequestPermissionErrorMessage, type RequestPermissionInput, type RequestPermissionPayload, ResponseEvent, SendHapticFeedbackErrorCodes, SendHapticFeedbackErrorMessage, type SendHapticFeedbackInput, type SendHapticFeedbackPayload, SendTransactionErrorCodes, SendTransactionErrorMessage, type SendTransactionInput, type SendTransactionPayload, ShareContactsErrorCodes, ShareContactsErrorMessage, type ShareContactsInput, type ShareContactsPayload, ShareFilesErrorCodes, ShareFilesErrorMessage, type ShareInput, type SharePayload, SignMessageErrorCodes, SignMessageErrorMessage, type SignMessageInput, type SignMessagePayload, SignTypedDataErrorCodes, SignTypedDataErrorMessage, type SignTypedDataInput, type SignTypedDataPayload, type SiweMessage, TokenDecimals, Tokens, type TokensPayload, type Transaction, type User, type UserNameService, type VerificationResult, type VerifyCommandInput, type VerifyCommandPayload, WalletAuthErrorCodes, WalletAuthErrorMessage, type WalletAuthInput, type WalletAuthPayload, type WebViewBasePayload, createAsyncCommands, createAttestationAsyncCommand, createAttestationCommand, createChatAsyncCommand, createChatCommand, createCloseMiniAppCommand, createCommands, createGetPermissionsAsyncCommand, createGetPermissionsCommand, createPayAsyncCommand, createPayCommand, createRequestPermissionAsyncCommand, createRequestPermissionCommand, createSendHapticFeedbackAsyncCommand, createSendHapticFeedbackCommand, createSendTransactionAsyncCommand, createSendTransactionCommand, createShareAsyncCommand, createShareCommand, createShareContactsAsyncCommand, createShareContactsCommand, createSignMessageAsyncCommand, createSignMessageCommand, createSignTypedDataAsyncCommand, createSignTypedDataCommand, createVerifyAsyncCommand, createVerifyCommand, createWalletAuthAsyncCommand, createWalletAuthCommand, getIsUserVerified, isCommandAvailable, mapWorldAppLaunchLocation, parseSiweMessage, sendMiniKitEvent, setCommandAvailable, tokenToDecimals, validateCommands, verifySiweMessage };
+export { MiniKit };