Sign Message

Sign an EIP-191 message using the unified MiniKit API.

Use MiniKit.signMessage() to request a personal signature from the user’s wallet.

Availability

• Works natively in World App
• Can execute outside World App through Wagmi or a custom fallback when configured

Basic Usage

import { MiniKit } from "@worldcoin/minikit-js";
import type {
  CommandResultByVia,
  MiniAppSignMessageSuccessPayload,
  MiniKitSignMessageOptions,
} from "@worldcoin/minikit-js/commands";

export async function signMessage() {
  const input = {
    message: "Hello world",
  } satisfies MiniKitSignMessageOptions;

  const result: CommandResultByVia<MiniAppSignMessageSuccessPayload> =
    await MiniKit.signMessage(input);

  console.log(result.data.signature);
}

Result

Type

type SignMessageResponse =
  | {
      executedWith: "minikit" | "wagmi";
      data: {
        status: "success";
        version: number;
        signature: string;
        address: string;
      };
    }
  | {
      executedWith: "fallback";
      data: unknown;
    };

Fallback Behavior

• executedWith: "wagmi" means the web signer handled the request
• executedWith: "fallback" means your custom fallback handled the request

Notes

Verify signatures in a trusted environment before using them for sensitive application logic.

Error Codes

Code	Meaning
invalid_message	The message payload is invalid
user_rejected	The user rejected the request
generic_error	Unexpected failure