+
+
+
+
+
+## Interacting with your App
+
+Once a user signed in and their wallet is generated, you can use the **[Wallet Connection functions](/typescript/v5/functions#wallets)** to get information about the connected wallet like getting the address, account, and more.
+
diff --git a/apps/portal/src/app/connect/wallet/sign-in-methods/external-wallets/page.mdx b/apps/portal/src/app/connect/wallet/sign-in-methods/external-wallets/page.mdx
new file mode 100644
index 00000000000..45c8c5cd60e
--- /dev/null
+++ b/apps/portal/src/app/connect/wallet/sign-in-methods/external-wallets/page.mdx
@@ -0,0 +1,159 @@
+import { createMetadata, ArticleIconCard, Callout } from "@doc";
+import {
+ WalletsAuthIcon,
+ WalletsConnectIcon,
+ ReactIcon,
+ TypeScriptIcon,
+ UnityIcon,
+ DotNetIcon,
+ ExternalLinkIcon,
+ UnrealEngineIcon
+} from "@/icons"
+
+export const metadata = createMetadata({
+ image: {
+ title: "External Wallets",
+ icon: "wallets",
+ },
+ title: "External Wallets | thirdweb",
+ description:
+ "Learn how to connect and authenticate with external wallets using thirdweb.",
+});
+
+
+# External wallets
+
+thirdweb natively supports 350+ first-party wallets and all wallets that implement EIP-6963 (Multi-injected Provider Discovery). For the full list, please consult [this list](/typescript/v5/supported-wallets).
+
+You can use an external wallet in many ways. We've outlined these different use cases below:
+
+| USAGE | BEST FOR |
+|----------|---------- |
+| Connect to site | Applications simply needing web3 wallet connectivity |
+| Authenticate into your site | Applications requiring authentication with existing web3 users |
+| Authenticate into a thirdweb wallet (either in-app or ecosystem) | Applications looking to provide a seamless web3 application with minimal disruptions and prompts |
+
+The good news is that thirdweb cover each and every one of this use case!
+
+Read on to find out how it's done:
+
+## Connecting External Wallets
+
+External wallets are perfect for applications that want to integrate with existing web3 users. These users typically already have wallets like MetaMask, Coinbase Wallet, or Rainbow installed and are familiar with web3 concepts.
+
+
+
+
+#### Ecosystem Wallet
+
+
+
\ No newline at end of file
diff --git a/apps/portal/src/app/connect/wallet/sign-in-methods/guest/page.mdx b/apps/portal/src/app/connect/wallet/sign-in-methods/guest/page.mdx
new file mode 100644
index 00000000000..bff5167f805
--- /dev/null
+++ b/apps/portal/src/app/connect/wallet/sign-in-methods/guest/page.mdx
@@ -0,0 +1,186 @@
+import { createMetadata, ArticleIconCard, Callout } from "@doc";
+import {
+ ReactIcon,
+ TypeScriptIcon,
+ UnityIcon,
+ DotNetIcon,
+ ExternalLinkIcon,
+ UnrealEngineIcon
+} from "@/icons"
+
+export const metadata = createMetadata({
+ image: {
+ title: "Guest Mode",
+ icon: "wallets",
+ },
+ title: "Guest Mode",
+ description:
+ "Learn how to get users started in thirdweb wallets without requiring sign-in.",
+});
+
+# Guest Mode
+
+Sometimes users want to get started using your app without signing in. You can now give users an in-memory "guest account" that can then be converted into a standard account by linking another auth method.
+
+## Logging in with Guest Mode
+
+In general, logging in with guest mode is the same as configuring any other login method in the platform of your choice. See the [login methods overview](/connect/wallet/sign-in-methods/overview) for more information on configuring your login options.
+
+### In App Wallet
+
+
+
+### Ecosystem Wallet
+
+
+
+## Making the Guest Wallet Permanent
+
+When your user is ready, link any other auth method so they can access their account in the future.
+
+### In App Wallet
+
+Below are the guides for linking a new identity for in-app wallet on the various platforms:
+
+
+
+
+### Ecosystem Wallet
+
+Below are the guides for linking a new identity for ecosystem wallet on the various platforms:
+
+
+
+
+## Wrapping Up
+
+Your user can now access this same wallet with their Google account.
+
+While it is not linked to any other identity, the lifetime of the guest wallet for any given user will last until they clear their browser storage.
+
+You can try out Guest Mode [on our playground.](https://playground.thirdweb.com/connect/sign-in/button)
diff --git a/apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/confirm-reveal.png b/apps/portal/src/app/connect/wallet/user-management/export-private-key/confirm-reveal.png
similarity index 100%
rename from apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/confirm-reveal.png
rename to apps/portal/src/app/connect/wallet/user-management/export-private-key/confirm-reveal.png
diff --git a/apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/export-key.png b/apps/portal/src/app/connect/wallet/user-management/export-private-key/export-key.png
similarity index 100%
rename from apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/export-key.png
rename to apps/portal/src/app/connect/wallet/user-management/export-private-key/export-key.png
diff --git a/apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/exported-key.png b/apps/portal/src/app/connect/wallet/user-management/export-private-key/exported-key.png
similarity index 100%
rename from apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/exported-key.png
rename to apps/portal/src/app/connect/wallet/user-management/export-private-key/exported-key.png
diff --git a/apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/manage-wallet.png b/apps/portal/src/app/connect/wallet/user-management/export-private-key/manage-wallet.png
similarity index 100%
rename from apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/manage-wallet.png
rename to apps/portal/src/app/connect/wallet/user-management/export-private-key/manage-wallet.png
diff --git a/apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/page.mdx b/apps/portal/src/app/connect/wallet/user-management/export-private-key/page.mdx
similarity index 64%
rename from apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/page.mdx
rename to apps/portal/src/app/connect/wallet/user-management/export-private-key/page.mdx
index f2f4af73f3f..1cfa600bd47 100644
--- a/apps/portal/src/app/connect/in-app-wallet/guides/export-private-key/page.mdx
+++ b/apps/portal/src/app/connect/wallet/user-management/export-private-key/page.mdx
@@ -6,22 +6,26 @@ import ExportedKey from './exported-key.png'
export const metadata = createMetadata({
image: {
- title: "Export private key of In-App Wallet",
+ title: "Export private key of thirdweb Wallet",
icon: "wallets",
},
- title: "Export private key | thirdweb In-App Wallet",
+ title: "Export private key | thirdweb",
description:
- "Learn how to export private keys for thirdweb in-app wallets",
+ "Learn how to export private keys for thirdweb wallets",
});
# Export Private Key
-Learn how to export the private key for a thirdweb in-app wallet using the Connect modal.
+Learn how to export the private key for a thirdweb wallet using the Connect modal.
+
+
+
+
+### Ecosystem Wallet
+
+
+
+
+
+## Backend
+
+
+From the backend, you are able to get the details of any user within your in app or ecosystem wallet.
+
+To get the user details, you can make a `GET` request to the following endpoint:
+
+```
+https://in-app-wallet.thirdweb.com/api/2023-11-30/embedded-wallet/user-details
+```
+
+### Query Parameters
+
+You can specify the query parameter `queryBy` to query by different user identifiers:
+
+- `queryBy`: The parameter to query by. Can be one of `walletAddress`, `email`, `phone`, `externalWalletAddress`, or `id`.
+
+You can then specify the value to query by, matching the queryBy parameter:
+
+- `walletAddress`: The user's wallet address that thirdweb has generated for them
+- `email`: The user's email address
+- `phone`: The user's phone number
+- `externalWalletAddress`: The user's wallet address that used to login via SIWE
+- `id`: The user's ID (for custom auth)
+
+### Authentication
+
+You need to include your ThirdWeb Client Secret in the Authorization header.
+
+If you are an ecosystem owner, you have to include the `x-ecosystem-id` header and optionally the `x-ecosystem-partner-id` header if the ecosystem is set to partners only.
+
+### Example curl Command
+
+Here's an example curl command to fetch user details by email:
+
+```bash
+curl -X GET 'https://in-app-wallet.thirdweb.com/api/2023-11-30/embedded-wallet/user-details?queryBy=email&email=user@example.com' \
+ -H 'x-secret-key: YOUR_THIRD_WEB_CLIENT_SECRET'
+```
+
+Here's an example curl command to fetch user details by address:
+
+```bash
+curl -X GET 'https://in-app-wallet.thirdweb.com/api/2023-11-30/embedded-wallet/user-details?queryBy=walletAddress&walletAddress=0x123456789abcdef' \
+ -H 'x-secret-key: YOUR_THIRD_WEB_CLIENT_SECRET'
+```
+
+Here's an example curl command to fetch the user details for an ecosystem owner:
+
+```bash
+curl -X GET 'https://in-app-wallet.thirdweb.com/api/2023-11-30/embedded-wallet/user-details?queryBy=walletAddress&walletAddress=0x123456789abcdef' \
+ -H 'x-secret-key: YOUR_THIRD_WEB_CLIENT_SECRET' \
+ -H 'x-ecosystem-id: ecosystem.YOUR_ECOSYSTEM_ID' \
+ -H 'x-ecosystem-partner-id: YOUR_PARTNER_ID'
+```
+
+In both examples, replace `YOUR_THIRD_WEB_CLIENT_SECRET` with your actual ThirdWeb Client Secret.
+
+Replace `YOUR_ECOSYSTEM_ID` and `YOUR_PARTNER_ID` with your actual ecosystem ID and partner ID respectively. The partner ID can be one you set up for yourself as the ecosystem owner.
+
+### Response Format
+
+The API returns a JSON array with the following structure for each user:
+
+```json
+[
+ {
+ "userId": "string",
+ "walletAddress": "string",
+ "email": "string (optional)",
+ "phone": "string (optional)",
+ "createdAt": "string",
+ "linkedAccounts": [
+ {
+ "type": "string",
+ "details": {
+ "phone": "string",
+ // or
+ "email": "string",
+ // or
+ "address": "string",
+ // or
+ "id": "string",
+ // Additional key-value pairs may be present
+ }
+ }
+ ]
+ }
+]
+```
+
+Note: The `details` object in `linkedAccounts` will contain different fields based on the account type. See the [list of Strategies](#list-of-strategies) above for more information.
+
+Remember to handle the response appropriately in your chosen programming language, including error cases and parsing the JSON response.
+
+### Convenience Methods
+
+If you are using the thirdweb SDK, you can use the `getUser` method to retrieve user details.
+
+
+
+
+### Ecosystem Wallet
+
+
+
+
+
+## Retrieve Linked Profiles
+
+Once linked, you can retrieve the user profiles via either identity.
+
+For more information, see [Getting User Profiles](/connect/wallet/user-management/get-user-profiles).
diff --git a/apps/portal/src/app/page.tsx b/apps/portal/src/app/page.tsx
index 35881551c31..711f17a4d39 100644
--- a/apps/portal/src/app/page.tsx
+++ b/apps/portal/src/app/page.tsx
@@ -12,7 +12,6 @@ import {
ContractModularContractIcon,
ContractPublishIcon,
DotNetIcon,
- EcosystemWalletsIcon,
InfraEngineIcon,
InfraInsightIcon,
PayIcon,
@@ -20,7 +19,6 @@ import {
TypeScriptIcon,
UnityIcon,
WalletsAuthIcon,
- WalletsConnectIcon,
WalletsInAppIcon,
WalletsSmartIcon,
} from "@/icons";
@@ -227,27 +225,7 @@ function WalletsSection() {
+
+ );
+}
diff --git a/apps/portal/src/components/Document/index.ts b/apps/portal/src/components/Document/index.ts
index 240e927eda0..be36d17a854 100644
--- a/apps/portal/src/components/Document/index.ts
+++ b/apps/portal/src/components/Document/index.ts
@@ -26,3 +26,4 @@ export { createMetadata } from "./metadata";
export { ConnectCard } from "./Cards/ConnectCard";
export { FeatureCard } from "./FeatureCard";
export { AAChainList } from "./AAChainList";
+export { AuthList } from "./AuthList";
diff --git a/packages/thirdweb/src/wallets/in-app/web/ecosystem.ts b/packages/thirdweb/src/wallets/in-app/web/ecosystem.ts
index 12cb4e7552f..e33932d5c08 100644
--- a/packages/thirdweb/src/wallets/in-app/web/ecosystem.ts
+++ b/packages/thirdweb/src/wallets/in-app/web/ecosystem.ts
@@ -7,30 +7,21 @@ import type {
import { createInAppWallet } from "../core/wallet/in-app-core.js";
/**
- * Creates an [Ecosystem Wallet](https://portal.thirdweb.com/connect/ecosystems/overview) based on various authentication methods.
- *
- * Available authentication methods:
- * - Email
- * - Phone
- * - Passkey
- * - Google
- * - Apple
- * - Facebook
- * - Discord
- * - LINE
- * - X
- * - Farcaster
+ * Creates an [Ecosystem Wallet](https://portal.thirdweb.com/connect/ecosystems/overview) based on various authentication methods. Full list of available authentication methods [here](/connect/wallet/sign-in-methods/overview).
*
* Can also be configured to use Account Abstraction to directly connect to a ERC4337 smart account based on those authentication methods.
*
- * Refer to [inAppWallet](https://portal.thirdweb.com/references/typescript/v5/inAppWallet) for detailed usage examples.
+ * Refer to [inAppWallet](/typescript/v5/inAppWallet) for detailed usage examples.
*
* @param createOptions - configuration options
* Refer to [EcosystemWalletCreationOptions](https://portal.thirdweb.com/references/typescript/v5/EcosystemWalletCreationOptions) for more details.
* @returns The created ecosystem wallet.
+ *
+ *
* @example
+ * ### Logging into an ecosystem wallet
*
- * ### Connect to an ecosystem wallet
+ * Below is the general code snippet needed to connect via a given auth strategy to an ecosystem wallet. For more variants on the various auth strategies, refer to [inAppWallet](/typescript/v5/inAppWallet).
*
* ```ts
* import { ecosystemWallet } from "thirdweb/wallets";
@@ -44,7 +35,7 @@ import { createInAppWallet } from "../core/wallet/in-app-core.js";
* });
* ```
*
- * [View all connection options](https://portal.thirdweb.com/references/typescript/v5/EcosystemWalletConnectionOptions)
+ * [View all connection options](https://portal.thirdweb.com/references/typescript/v5/EcosystemWalletConnectionOptions).
*
* ### Connect to a restricted ecosystem wallet with your designated partner ID
*
@@ -57,7 +48,6 @@ import { createInAppWallet } from "../core/wallet/in-app-core.js";
* });
* ```
*
- * Refer to [inAppWallet](https://portal.thirdweb.com/references/typescript/v5/inAppWallet) for more usage examples.
*
* @wallet
*/
diff --git a/packages/thirdweb/src/wallets/in-app/web/in-app.ts b/packages/thirdweb/src/wallets/in-app/web/in-app.ts
index d0507ff5cd7..21b3814a23d 100644
--- a/packages/thirdweb/src/wallets/in-app/web/in-app.ts
+++ b/packages/thirdweb/src/wallets/in-app/web/in-app.ts
@@ -4,22 +4,7 @@ import type { CreateWalletArgs } from "../../wallet-types.js";
import { createInAppWallet } from "../core/wallet/in-app-core.js";
/**
- * Creates an app scoped wallet for users based on various authentication methods.
- *
- * Available authentication methods:
- * - Email
- * - Phone
- * - Passkey
- * - Guest
- * - Google
- * - Apple
- * - Facebook
- * - Discord
- * - Coinbase
- * - Telegram
- * - LINE
- * - X
- * - Farcaster
+ * Creates an app scoped wallet for users based on various authentication methods. Full list of available authentication methods [here](https://portal.thirdweb.com/connect/wallet/sign-in-methods/overview).
*
* Can also be configured to use Account Abstraction to directly connect to a ERC4337 smart account based on those authentication methods.
*
@@ -42,7 +27,7 @@ import { createInAppWallet } from "../core/wallet/in-app-core.js";
* });
* ```
*
- * [View all available social auth methods](https://portal.thirdweb.com/references/typescript/v5/InAppWalletSocialAuth)
+ * [View all available social auth methods](https://portal.thirdweb.com/connect/wallet/sign-in-methods/overview)
*
* ### Login with email
*
diff --git a/packages/thirdweb/src/wallets/in-app/web/lib/auth/index.ts b/packages/thirdweb/src/wallets/in-app/web/lib/auth/index.ts
index d451a80fed2..84886844cbf 100644
--- a/packages/thirdweb/src/wallets/in-app/web/lib/auth/index.ts
+++ b/packages/thirdweb/src/wallets/in-app/web/lib/auth/index.ts
@@ -194,6 +194,7 @@ export async function authenticateWithRedirect(
* ```ts
* import { linkProfile } from "thirdweb/wallets";
*
+ * // optionally specify the ecosystem if you're linking an ecosystem wallet
* await linkProfile({ client, strategy: "discord" });
* ```
* @wallet
-
+ {authOptions?.map((auth) => (
+
-
+ ++
+ {auth.charAt(0).toUpperCase() + auth.slice(1)} +
+ ))}
+