From 9ffca296ec675db20ed16a2164e23466081fbb0c Mon Sep 17 00:00:00 2001
From: Joaquim Verges <joaquim.verges@gmail.com>
Date: Tue, 16 Sep 2025 08:54:07 +1200
Subject: [PATCH] [SDK] Simplify wallet connection code and add Abstract wallet
 support

---
 .../typescript/v5/connecting-wallets/page.mdx |  12 +-
 .../external-wallets/[walletId]/page.tsx      |  75 ++-----
 .../wallets/external-wallets/xyz.abs/page.tsx | 204 ++++++++++++++++++
 3 files changed, 218 insertions(+), 73 deletions(-)
 create mode 100644 apps/portal/src/app/wallets/external-wallets/xyz.abs/page.tsx

diff --git a/apps/portal/src/app/typescript/v5/connecting-wallets/page.mdx b/apps/portal/src/app/typescript/v5/connecting-wallets/page.mdx
index fe688b168a9..00838e0271a 100644
--- a/apps/portal/src/app/typescript/v5/connecting-wallets/page.mdx
+++ b/apps/portal/src/app/typescript/v5/connecting-wallets/page.mdx
@@ -41,14 +41,6 @@ import { createWallet, injectedProvider } from "thirdweb/wallets";
 const client = createThirdwebClient({ clientId });
 
 const metamask = createWallet("io.metamask"); // pass the wallet id
-
-// if user has metamask installed, connect to it
-if (injectedProvider("io.metamask")) {
-	await metamask.connect({ client });
-}
-
-// open wallet connect modal so user can scan the QR code and connect
-else {
-	await metamask.connect({ client, walletConnect: { showQrModal: true } });
-}
+// if user has metamask installed, connect to it, otherwise opens a WalletConnect modal
+await metamask.connect({ client });
 ```
diff --git a/apps/portal/src/app/wallets/external-wallets/[walletId]/page.tsx b/apps/portal/src/app/wallets/external-wallets/[walletId]/page.tsx
index 8a09c3497e9..4ecc80f5863 100644
--- a/apps/portal/src/app/wallets/external-wallets/[walletId]/page.tsx
+++ b/apps/portal/src/app/wallets/external-wallets/[walletId]/page.tsx
@@ -188,16 +188,7 @@ import { createWallet, injectedProvider } from "thirdweb/wallets";
 const client = createThirdwebClient({ clientId });
 
 const wallet = createWallet("${id}"); // pass the wallet id
-
-// if the wallet extension is installed, connect to it
-if (injectedProvider("${id}")) {
-  await wallet.connect({ client });
-}
-
-// show error message to user that wallet is not installed
-else {
-  alert('wallet is not installed');
-}
+await wallet.connect({ client });
 `;
 }
 
@@ -209,12 +200,7 @@ import { createWallet } from "thirdweb/wallets";
 const client = createThirdwebClient({ clientId });
 
 const wallet = createWallet("${id}"); // pass the wallet id
-
-// open WalletConnect modal so user can scan the QR code and connect
-await wallet.connect({
-  client,
-  walletConnect: { showQrModal: true },
-});
+await wallet.connect({ client });
 `;
 }
 
@@ -226,19 +212,8 @@ import { createWallet, injectedProvider } from "thirdweb/wallets";
 const client = createThirdwebClient({ clientId });
 
 const wallet = createWallet("${id}"); // pass the wallet id
-
-// if user has wallet installed, connect to it
-if (injectedProvider("${id}")) {
-  await wallet.connect({ client });
-}
-
-// open WalletConnect modal so user can scan the QR code and connect
-else {
-  await wallet.connect({
-    client,
-    walletConnect: { showQrModal: true },
-  });
-}
+// if user has wallet installed, connects to it, otherwise opens a WalletConnect modal
+await wallet.connect({ client });
 `;
 }
 
@@ -257,20 +232,7 @@ function Example() {
       onClick={() =>
         connect(async () => {
           const wallet = createWallet("${id}"); // pass the wallet id
-
-          // if user has wallet installed, connect to it
-          if (injectedProvider("${id}")) {
-            await wallet.connect({ client });
-          }
-
-          // open WalletConnect modal so user can scan the QR code and connect
-          else {
-            await wallet.connect({
-              client,
-              walletConnect: { showQrModal: true },
-            });
-          }
-
+          await wallet.connect({ client });
           // return the wallet to set it as active wallet
           return wallet;
         })
@@ -298,13 +260,7 @@ function Example() {
       onClick={() =>
         connect(async () => {
           const wallet = createWallet("${id}"); // pass the wallet id
-
-          // open WalletConnect modal so user can scan the QR code and connect
-          await wallet.connect({
-            client,
-            walletConnect: { showQrModal: true },
-          });
-
+          await wallet.connect({ client });
           // return the wallet to set it as active wallet
           return wallet;
         })
@@ -330,19 +286,12 @@ function Example() {
   return (
     <button
       onClick={() => {
-        // if the wallet extension is installed, connect to it
-        if (injectedProvider("${id}")) {
-          connect(async () => {
-            const wallet = createWallet("${id}");
-            await wallet.connect({ client });
-            return wallet;
-          });
-        }
-
-        // show error message to user that wallet is not installed
-        else {
-          alert("wallet is not installed");
-        }
+        // if the wallet extension is installed, connect to it, otherwise opens a WalletConnect modal
+        connect(async () => {
+          const wallet = createWallet("${id}");
+          await wallet.connect({ client });
+          return wallet;
+        });
       }}
     >
       {isConnecting ? "Connecting..." : "Connect"}
diff --git a/apps/portal/src/app/wallets/external-wallets/xyz.abs/page.tsx b/apps/portal/src/app/wallets/external-wallets/xyz.abs/page.tsx
new file mode 100644
index 00000000000..ed3bb717fb6
--- /dev/null
+++ b/apps/portal/src/app/wallets/external-wallets/xyz.abs/page.tsx
@@ -0,0 +1,204 @@
+/* eslint-disable @next/next/no-img-element */
+
+import { GlobeIcon } from "lucide-react";
+import Image from "next/image";
+import { getWalletInfo } from "thirdweb/wallets";
+import {
+  Breadcrumb,
+  CodeBlock,
+  createMetadata,
+  DocLink,
+  Heading,
+  Paragraph,
+} from "@/components/Document";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
+
+const walletId = "xyz.abs";
+
+export async function generateMetadata() {
+  const walletMetadata = await getWalletInfo(walletId);
+
+  return createMetadata({
+    description: `Connect ${walletMetadata.name} with thirdweb TypeScript SDK`,
+    image: {
+      icon: "wallets",
+      title: walletMetadata.name,
+    },
+    title: walletMetadata.name,
+  });
+}
+
+export default async function Page() {
+  const [walletMetadata, walletImage] = await Promise.all([
+    getWalletInfo(walletId),
+    getWalletInfo(walletId, true),
+  ]);
+
+  return (
+    <div>
+      <Breadcrumb
+        crumbs={[
+          {
+            href: "/wallets/external-wallets",
+            name: "External Wallets",
+          },
+          {
+            href: `/wallets/external-wallets/${walletId}`,
+            name: walletMetadata.name,
+          },
+        ]}
+      />
+
+      <div className="mb-10 flex items-center gap-3 [&_h1]:m-0">
+        <Image
+          alt=""
+          className="rounded-lg"
+          height={36}
+          src={walletImage}
+          width={36}
+        />
+        <Heading anchorId="title" level={1}>
+          {walletMetadata.name}
+        </Heading>
+      </div>
+
+      <DocLink
+        className="flex items-center gap-2"
+        href={walletMetadata.homepage}
+      >
+        <GlobeIcon className="size-5" />
+        {walletMetadata.homepage}
+      </DocLink>
+
+      <Heading anchorId="wallet-id" level={2}>
+        Wallet ID
+      </Heading>
+
+      <CodeBlock code={`"${walletId}"`} lang="ts" />
+
+      <Heading anchorId="connect-wallet" level={2}>
+        Installation
+      </Heading>
+
+      <CodeBlock
+        code={`npm i thirdweb @abstract-foundation/agw-react`}
+        lang="bash"
+      />
+
+      <Heading anchorId="connect-wallet" level={2}>
+        Connect Wallet
+      </Heading>
+
+      <Tabs defaultValue="tab-1">
+        <TabsList>
+          <TabsTrigger value="tab-1"> TypeScript </TabsTrigger>
+          <TabsTrigger value="tab-2"> React (Custom UI) </TabsTrigger>
+          <TabsTrigger value="tab-3"> React (Component) </TabsTrigger>
+        </TabsList>
+        <TabsContent value="tab-1">
+          <CodeBlock code={injectedSupportedTS()} lang="ts" />
+        </TabsContent>
+        <TabsContent value="tab-2">
+          <CodeBlock code={injectedSupportedCodeReact()} lang="ts" />
+        </TabsContent>
+        <TabsContent value="tab-3">
+          <Paragraph>
+            You can add this wallet in the{" "}
+            <DocLink href="/react/v5/ConnectButton" target="_blank">
+              ConnectButton
+            </DocLink>{" "}
+            or{" "}
+            <DocLink href="/react/v5/ConnectEmbed" target="_blank">
+              ConnectEmbed
+            </DocLink>{" "}
+            component to get a pre-built UI for connecting the wallet.{" "}
+            <Heading anchorId="connect-component" level={3}>
+              Example
+            </Heading>{" "}
+            <CodeBlock code={componentCode()} lang="tsx" />
+          </Paragraph>
+        </TabsContent>
+      </Tabs>
+
+      <Heading anchorId="reference" level={2}>
+        Reference
+      </Heading>
+
+      <DocLink href="/references/typescript/v5/AbsWalletCreationOptions">
+        View All Creation Options
+      </DocLink>
+    </div>
+  );
+}
+
+function injectedSupportedTS() {
+  return `\
+import { createThirdwebClient } from "thirdweb";
+import { createWallet } from "thirdweb/wallets";
+import { abstractWallet } from "@abstract-foundation/agw-react/thirdweb";
+
+const client = createThirdwebClient({ clientId });
+
+const wallet = ${createWallet()};
+
+await wallet.connect({ client });
+`;
+}
+
+function injectedSupportedCodeReact() {
+  return `\
+import { createThirdwebClient } from "thirdweb";
+import { useConnect } from "thirdweb/react";
+import { createWallet } from "thirdweb/wallets";
+import { abstractWallet } from "@abstract-foundation/agw-react/thirdweb";
+
+const client = createThirdwebClient({ clientId });
+const wallet = ${createWallet()};
+
+function Example() {
+  const { connect, isConnecting, error } = useConnect();
+  return (
+    <button
+      onClick={() => {
+        // if the wallet extension is installed, connect to it
+        connect(async () => {
+            await wallet.connect({ client });
+            return wallet;
+        });
+      }}
+    >
+      {isConnecting ? "Connecting..." : "Connect"}
+    </button>
+  );
+}
+`;
+}
+
+function componentCode() {
+  return `\
+import { ConnectButton } from "thirdweb/react";
+import { createWallet } from "thirdweb/wallets";
+import { abstractWallet } from "@abstract-foundation/agw-react/thirdweb";
+
+const wallets = [
+ // Add your wallet in wallet list
+  ${createWallet()},
+  // add other wallets...
+];
+
+function Example() {
+  return (
+    <div>
+      {/* Use ConnectButton */}
+      <ConnectButton client={client} wallets={wallets} />
+
+      {/* Or Use ConnectEmbed */}
+      <ConnectEmbed client={client} wallets={wallets} />
+    </div>
+  );
+}`;
+}
+
+function createWallet() {
+  return `abstractWallet()`;
+}