Merge branch 'winston/tool-2884-backend-server-wallets' of https://github.com/thirdweb-dev/js into winston/tool-2884-backend-server-wallets

Author: ElasticBottle

.changeset/popular-ravens-reflect.md

@@ -4,7 +4,7 @@
 
 Add support for backend wallets.
 
-This is useful is you have a backend that is connected to an agent or what not that you want to have programmatic access to a wallet without managing private keys.
+This is useful is you have a backend that is connected to an that you want to have programmatic access to a wallet without managing private keys.
 
 Here's how you'd do it:
 
@@ -20,4 +20,4 @@ const account = await wallet.connect({
 console.log("account.address", account.address);
 ```
 
-Note that `walletSecret` would simply be something that you generate and store to uniquely identify the given wallet created under the particular `client`.
+Note that `walletSecret` should be generated by you and securely stored to uniquely authenticate to the given wallet.

apps/dashboard/package.json

@@ -85,7 +85,7 @@
     "react-dom": "19.0.0",
     "react-dropzone": "^14.3.5",
     "react-error-boundary": "^4.1.2",
-    "react-hook-form": "7.53.2",
+    "react-hook-form": "7.54.2",
     "react-markdown": "^9.0.1",
     "react-table": "^7.8.0",
     "recharts": "2.14.1",

apps/wallet-ui/package.json

@@ -25,7 +25,7 @@
     "next-themes": "^0.4.4",
     "react": "19.0.0",
     "react-dom": "19.0.0",
-    "react-hook-form": "7.53.2",
+    "react-hook-form": "7.54.2",
     "server-only": "^0.0.1",
     "sonner": "^1.7.1",
     "tailwind-merge": "^2.6.0",

packages/thirdweb/src/wallets/in-app/core/authentication/backend.ts

@@ -6,7 +6,7 @@ import { getLoginUrl } from "./getLoginPath.js";
 import type { AuthStoredTokenWithCookieReturnType } from "./types.js";
 
 /**
- * Does no real authentication, just issues a temporary token for the user.
+ * Authenticates via the wallet secret
  * @internal
  */
 export async function backendAuthenticate(args: {

packages/thirdweb/src/wallets/in-app/native/auth/index.ts

@@ -133,6 +133,17 @@ export async function preAuthenticate(args: PreAuthArgsType) {
  *  verificationCode: "123456",
  * });
  * ```
+ *
+ * Authenticate to a backend account (only do this on your backend):
+ * ```ts
+ * import { authenticate } from "thirdweb/wallets/in-app";
+ *
+ * const result = await authenticate({
+ *  client,
+ *  strategy: "backend",
+ *  walletSecret: "...", // Provided by your app
+ * });
+ * ```
  * @wallet
  */
 export async function authenticate(args: AuthArgsType) {

packages/thirdweb/src/wallets/in-app/web/in-app.ts

@@ -139,6 +139,20 @@ import { createInAppWallet } from "../core/wallet/in-app-core.js";
  * });
  * ```
  *
+ * ### Connect to a backend account
+ *
+ * ```ts
+ * import { inAppWallet } from "thirdweb/wallets";
+ *
+ * const wallet = inAppWallet();
+ *
+ * const account = await wallet.connect({
+ *   client,
+ *   strategy: "backend",
+ *   walletSecret: "...", // Provided by your app
+ * });
+ * ```
+ *
  * ### Connect with custom JWT (any OIDC provider)
  *
  * You can use any OIDC provider to authenticate your users. Make sure to configure it in your dashboard under in-app wallet settings.

packages/thirdweb/src/wallets/in-app/web/lib/auth/index.ts

@@ -140,6 +140,17 @@ export async function preAuthenticate(args: PreAuthArgsType) {
  *  verificationCode: "123456",
  * });
  * ```
+ *
+ * Authenticate to a backend account (only do this on your backend):
+ * ```ts
+ * import { authenticate } from "thirdweb/wallets/in-app";
+ *
+ * const result = await authenticate({
+ *  client,
+ *  strategy: "backend",
+ *  walletSecret: "...", // Provided by your app
+ * });
+ * ```
  * @wallet
  */
 export async function authenticate(args: AuthArgsType) {