Share Contacts

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

export async function pickContacts() {
  const input = {
    isMultiSelectEnabled: true,
    inviteMessage: "Join me in this mini app",
  } satisfies MiniKitShareContactsOptions;

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

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

type MiniKitShareContactsOptions = {
  isMultiSelectEnabled?: boolean;
  inviteMessage?: string;
  fallback?: () => unknown;
};

type ShareContactsResponse =
  | {
      executedWith: "minikit";
      data: {
        contacts: Array<{
          username: string;
          walletAddress: string;
          profilePictureUrl: string | null;
        }>;
        timestamp: string;
      };
    }
  | {
      executedWith: "fallback";
      data: unknown;
    };

{
  "executedWith": "minikit",
  "data": {
    "contacts": [
      {
        "username": "alex",
        "walletAddress": "0x1234567890123456789012345678901234567890",
        "profilePictureUrl": "https://cdn.example.com/profile/alex.png"
      }
    ],
    "timestamp": "2026-03-28T18:24:00.000Z"
  }
}