Walletconnect mobile support

Author: amircheikh

packages/core/src/__types__/external-wallets.ts

@@ -152,6 +152,40 @@ export interface WalletConnectInterface extends BaseWalletInterface {
   }) => Promise<void>;
 }
 
+/**
+ * Type for a WalletConnect app retrieved from the WalletConnect `wallets` endpoint.
+ */
+export interface WalletConnectApp {
+  id: string;
+  name: string;
+  slug: string;
+  description?: string;
+  homepage?: string;
+  chains: string[];
+  versions: string[];
+  sdks: string[];
+  app_type: "wallet" | string;
+  category?: string;
+  image_url?: {
+    sm?: string;
+    md?: string;
+    lg?: string;
+  };
+  mobile?: {
+    native?: string;
+    universal?: string;
+  };
+  desktop?: {
+    native?: string;
+    universal?: string | null;
+  };
+  injected?: Array<{
+    namespace: string;
+    injected_id: string;
+  }>;
+  rdns?: string;
+}
+
 /**
  * Union of supported wallet behavior interfaces.
  * @internal

packages/core/src/index.ts

@@ -37,6 +37,7 @@ export {
   decodeVerificationToken,
   getClientSignatureMessageForLogin,
   getClientSignatureMessageForSignup,
+  fetchWalletConnectApps,
   addressFormatConfig,
 } from "./utils";
 

packages/core/src/utils.ts

@@ -27,6 +27,7 @@ import {
 import {
   type CreateSubOrgParams,
   type WalletProvider,
+  type WalletConnectApp,
   Chain,
   GrpcStatus,
   TurnkeyRequestError,
@@ -1433,3 +1434,37 @@ export function getClientSignatureMessageForSignup({
     );
   }
 }
+
+export async function fetchWalletConnectApps(
+  projectId: string,
+): Promise<WalletConnectApp[]> {
+  const url =
+    `https://explorer-api.walletconnect.com/v3/wallets` +
+    `?projectId=${projectId}`;
+
+  const res = await fetch(url, {
+    headers: {
+      Accept: "application/json",
+    },
+  });
+
+  if (!res.ok) {
+    throw new Error(
+      `Failed to fetch WalletConnect apps: ${res.status} ${res.statusText}`,
+    );
+  }
+
+  const json = await res.json();
+
+  /**
+   * API shape:
+   * {
+   *   listings: {
+   *     [id: string]: WalletConnectApp
+   *   }
+   * }
+   */
+  const listings = json.listings ?? {};
+
+  return Object.values(listings) as WalletConnectApp[];
+}