Attestation

Request an attestation token using the unified MiniKit API.

Use MiniKit.attestation() to request an app attestation token for a request hash.

Availability

• Works natively in World App
• Supports a custom fallback outside World App

Basic Usage

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

export async function requestAttestation() {
  const input = {
    requestHash: "0x1234",
  } satisfies MiniKitAttestationOptions;

  const result: CommandResultByVia<
    MiniAppAttestationSuccessPayload,
    MiniAppAttestationSuccessPayload,
    "minikit"
  > = await MiniKit.attestation(input);

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

Result

Type

type AttestationResponse =
  | {
      executedWith: "minikit";
      data: {
        status: "success";
        version: number;
        token: string;
      };
    }
  | {
      executedWith: "fallback";
      data: unknown;
    };

Fallback Behavior

Use a custom fallback if you want equivalent behavior outside World App.

Error Codes

Code	Meaning
unauthorized	The request is not authorized
attestation_failed	Attestation generation failed
integrity_failed	Integrity checks failed
invalid_input	The request hash is invalid
unsupported_version	The command version is not supported