docs: update pregeneration docs

Author: ElasticBottle

apps/portal/src/app/connect/sidebar.tsx

@@ -170,7 +170,7 @@ export const sidebar: SideBar = {
             },
             {
               name: "Pregenerate Wallets",
-              href: `${ecosystemSlug}/pregenerate-wallets`,
+              href: `${walletSlug}/pregenerate-wallets`,
             },
             {
               name: "User Management",
@@ -201,10 +201,10 @@ export const sidebar: SideBar = {
                   name: "Prebuilt UI",
                   href: `${connectSlug}/customization`,
                 },
-                {
-                  name: "Emails and SMS",
-                  href: `${connectSlug}/customization#compact-modal`,
-                },
+                // {
+                //   name: "Emails and SMS",
+                //   href: `${connectSlug}/customization#compact-modal`,
+                // },
               ],
             },
             {
@@ -238,27 +238,6 @@ export const sidebar: SideBar = {
           name: "Sign-In",
           icon: <WalletsConnectIcon />,
           links: [
-            {
-              name: "Sign-In Methods",
-              links: [
-                {
-                  name: "Email & Phone",
-                  href: `${connectSlug}/methods/email-and-phone`,
-                },
-                {
-                  name: "Social Login",
-                  href: `${connectSlug}/methods/social-logins`,
-                },
-                {
-                  name: "External Wallets",
-                  href: `${connectSlug}/methods/external-wallets`,
-                },
-                {
-                  name: "Guest Mode",
-                  href: `${connectSlug}/methods/guest-mode`,
-                },
-              ],
-            },
             {
               name: "Customization",
               links: [
@@ -354,10 +333,6 @@ export const sidebar: SideBar = {
               name: "Integrating with Partners",
               href: `${ecosystemSlug}/integrating-partners`,
             },
-            {
-              name: "Pregenerate Wallets",
-              href: `${ecosystemSlug}/pregenerate-wallets`,
-            },
             {
               name: "Ecosystem Wallet Explorer Page",
               href: `${ecosystemSlug}/wallet-explorer`,

apps/portal/src/app/connect/wallet/pregenerate-wallets/page.mdx

@@ -0,0 +1,86 @@
+import { Callout} from "@doc";
+
+# Pregenerate User Wallets
+
+To pregenerate an in-app or ecosystem wallet wallet, you can make a `POST` request to the following endpoint:
+
+```
+https://in-app-wallet.thirdweb.com/api/v1/pregenerate
+```
+
+This allows you to safely create wallet addresses for your users before they login to your app.
+
+## Request Body
+
+The request body should be a JSON object with the following parameters:
+
+- `strategy`: The strategy for wallet generation
+- `email` or `phone` or `userId`: The user identifier associated with the wallet to be generated
+
+### Email based wallets
+
+```
+{ strategy: "email", email: "[email protected]" }
+```
+
+When the user logs in with any method associated with that email (including google, facebook, discord auth), they will get access to the same pregenerated wallet.
+
+### Phone based wallets
+
+```
+{ strategy: "phone", phone: "+1321123321" }
+```
+
+### Custom user id based wallets
+
+```
+{ strategy: "custom_auth_endpoint", userId: "some_user_id" }
+```
+
+{/* TODO: update link when custom auth documentation has been updated */}
+Use this when [bringing your own authentication method](/connect/in-app-wallet/custom-auth/configuration). When the user logs in, if the user ids you provide from the auth endpoint match, they will get access to the same pregenerated wallet.
+
+## Headers
+
+You need to include the following headers:
+
+- `Content-Type`: Must be set to `application/json`
+- `x-secret-key`: Your secret key for authentication
+- `x-ecosystem-id` (optional): Your ecosystem ID
+- `x-ecosystem-partner-id` (optional): Your ecosystem partner ID
+
+## Example curl Command
+
+Here's an example curl command to pregenerate a thirdweb wallet for the user `[email protected]`:
+
+```bash
+curl -X POST 'https://embedded-wallet.thirdweb.com/api/v1/pregenerate' \
+  -H 'x-ecosystem-id: ecosystem.example-eco-123' \
+  -H 'x-ecosystem-partner-id: 1415d24e-c7b0-4fce-846e-740841ef2c32' \
+  -H 'x-secret-key: 9f8e7d6c5b4a3f2e1d0c9b8a7ffge434b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "strategy": "email",
+    "email": "[email protected]"
+  }'
+```
+
+Replace the header values with your actual client ID, ecosystem ID, and secret key.
+
+<Callout variant='info' title='Pregeneration for ecosystems'>
+For ecosystem wallets, the secret key have to be from the same account as the ecosystem owner. If this is an issue, please reach out to us.
+</Callout>
+
+
+## Response Format
+
+A successful API call returns a JSON object in the following format:
+
+```json
+{
+  "wallet": {
+      "address": "string",
+      "createdAt": "string",
+  }
+}
+```