Migration guide

docs/pnp/migration-guides/modal-v5-to-v6.mdx

@@ -2,6 +2,7 @@
 title: PnP Modal SDK - v5 to v6
 displayed_sidebar: docs
 description: "PnP Modal SDK - v5 to v6 | Documentation - Web3Auth"
+sidebar_label: v5 to v6
 ---
 
 ## General
@@ -23,7 +24,7 @@ if (web3auth.connected) {
 
 ### `provider` is now always available
 
-In V5, we used to add a check for setting the `provider` only if the `web3auth.provider` was present. But now with V6 we always have provider
+In V5, we used to add a check for setting the `provider` only if the `web3auth.provider` was present. But now with V6 we always have a provider
 available even if the user is not logged in.
 
 ```tsx

docs/pnp/migration-guides/modal-v6-to-v7.mdx

@@ -0,0 +1,97 @@
+---
+title: PnP Modal SDK - v6 to v7
+displayed_sidebar: docs
+description: "PnP Modal SDK - v6 to v7 | Documentation - Web3Auth"
+sidebar_label: v6 to v7
+---
+
+## General
+
+### `web3auth.connect()` now returns a provider of type `IProvider`
+
+#### The new provider object now works with the latest version of `web3.js`.
+
+With V7, the type for the provider has been changed to `IProvider` which is compatible with the latest version of `web3.js` instead of the old type
+`SafeEventEmitterProvider`. The type `Iprovider` can be imported from the `@web3auth/base` package.
+
+```tsx
+// With V7
+// highlight-start
+connect(): Promise<IProvider | null>;
+// highlight-end
+```
+
+###
+
+## OpenLoginAdapter
+
+### Change in the naming of some whitelabel parameters for `OpenLoginAdapter`
+
+#### `name` and `url` are now `appName` and `appUrl`, respectively.
+
+In `adapterSettings`, the `whitelabel` object now accepts `appName` and `appUrl` instead of `name` and `url`, respectively. This is done to bring
+consistency to the naming convention.
+
+#### Light and dark mode is now toggled by the `mode` parameter instead of `dark`.
+
+`mode` accepts a string from the following options: `auto`, `light` or `dark`. This replaces the `dark` boolean parameter from previous versions.
+
+```tsx
+const openloginAdapter = new OpenloginAdapter({
+  adapterSettings: {
+    whiteLabel: {
+      // highlight-start
+      appName: "W3A Heroes",
+      appUrl: "https://web3auth.io",
+      // highlight-end
+      logoLight: "https://web3auth.io/images/w3a-L-Favicon-1.svg",
+      logoDark: "https://web3auth.io/images/w3a-D-Favicon-1.svg",
+      defaultLanguage: "en", // en, de, ja, ko, zh, es, fr, pt, nl
+      // highlight-next-line
+      mode: "auto", // whether to enable dark mode. defaultValue: false
+      theme: {
+        primary: "#768729",
+      },
+      useLogoLoader: true,
+    },
+  },
+  privateKeyProvider,
+});
+```
+
+## Other changes
+
+### Extra parameters for `solana-provider` and `xrpl-provider`
+
+#### For Solana
+
+For Solana, SolanaWallet in package "@web3auth/solana-provider", the request typings require both input and output now use `string[]` when input
+placeholder is needed
+
+```tsx
+// With V7
+const connectionConfig = await solanaWallet.request<string[], CustomChainConfig>({
+  method: "solana_provider_config",
+  params: [],
+});
+const conn = new Connection(connectionConfig.rpcTarget);
+```
+
+#### For XRPL
+
+For XRPL, after the change of "@web3auth/xrpl-provider" version to v7, the request typings require both input and output now so use `never` when input
+or output placeholder is needed
+
+```tsx
+// With V7
+const txSign = await this.provider.request<{ signature: string }, never>({
+  method: "xrpl_signMessage",
+  params: {
+    signature: hexMsg,
+  },
+});
+
+const accounts = await this.provider.request<never, string[]>({
+  method: "xrpl_getAccounts",
+});
+```

docs/pnp/migration-guides/no-modal-v5-to-v6.mdx

@@ -2,6 +2,7 @@
 title: PnP No Modal SDK - v5 to v6
 displayed_sidebar: docs
 description: "PnP No Modal SDK - v5 to v6 | Documentation - Web3Auth"
+sidebar_label: v5 to v6
 ---
 
 ## General
@@ -23,8 +24,8 @@ if (web3auth.connected) {
 
 ### `provider` is now always available
 
-In V5, we used to add a check for setting the `provider` only if the `web3auth.provider` was present. But now with V6 we always have provider
-available even if the user is not logged-in.
+In V5, we used to add a check for setting the `provider` only if the `web3auth.provider` was present. But now with V6 we always have a provider
+available even if the user is not logged in.
 
 ```tsx
 // With V5

docs/pnp/migration-guides/no-modal-v6-to-v7.mdx

@@ -0,0 +1,95 @@
+---
+title: PnP No Modal SDK - v6 to v7
+displayed_sidebar: docs
+description: "PnP No Modal SDK - v6 to v7 | Documentation - Web3Auth"
+sidebar_label: v6 to v7
+---
+
+## General
+
+### `web3auth.connectTo()` now returns a provider of type `IProvider`
+
+#### The new provider object now works with the latest version of `web3.js`.
+
+With V7, the type for the provider has been changed to `IProvider` which is compatible with the latest version of `web3.js` instead of the old type
+`SafeEventEmitterProvider`. The type `Iprovider` can be imported from the `@web3auth/base` package.
+
+```tsx
+// With V7
+// highlight-start
+connectTo<T>(walletName: WALLET_ADAPTER_TYPE, loginParams?: T): Promise<IProvider | null>;
+// highlight-end
+```
+
+## OpenLoginAdapter
+
+### Change in the naming of some whitelabel parameters for `OpenLoginAdapter`
+
+#### `name` and `url` are now `appName` and `appUrl`, respectively.
+
+In `adapterSettings`, the `whitelabel` object now accepts `appName` and `appUrl` instead of `name` and `url`, respectively. This is done to bring
+consistency to the naming convention.
+
+#### Light and dark mode is now toggled by the `mode` parameter instead of `dark`.
+
+`mode` accepts a string from the following options: `auto`, `light` or `dark`. This replaces the `dark` boolean parameter from previous versions.
+
+```tsx
+const openloginAdapter = new OpenloginAdapter({
+  adapterSettings: {
+    whiteLabel: {
+      // highlight-start
+      appName: "W3A Heroes",
+      appUrl: "https://web3auth.io",
+      // highlight-end
+      logoLight: "https://web3auth.io/images/w3a-L-Favicon-1.svg",
+      logoDark: "https://web3auth.io/images/w3a-D-Favicon-1.svg",
+      defaultLanguage: "en", // en, de, ja, ko, zh, es, fr, pt, nl
+      // highlight-next-line
+      mode: "auto", // whether to enable dark mode. defaultValue: false
+      theme: {
+        primary: "#768729",
+      },
+      useLogoLoader: true,
+    },
+  },
+  privateKeyProvider,
+});
+```
+
+## Other changes
+
+### Extra parameters for `solana-provider` and `xrpl-provider`
+
+#### For Solana
+
+For Solana, SolanaWallet in package "@web3auth/solana-provider", the request typings require both input and output now use `string[]` when input
+placeholder is needed
+
+```tsx
+// With V7
+const connectionConfig = await solanaWallet.request<string[], CustomChainConfig>({
+  method: "solana_provider_config",
+  params: [],
+});
+const conn = new Connection(connectionConfig.rpcTarget);
+```
+
+#### For XRPL
+
+For XRPL, after the change of "@web3auth/xrpl-provider" version to v7, the request typings require both input and output now so use `never` when input
+or output placeholder is needed
+
+```tsx
+// With V7
+const txSign = await this.provider.request<{ signature: string }, never>({
+  method: "xrpl_signMessage",
+  params: {
+    signature: hexMsg,
+  },
+});
+
+const accounts = await this.provider.request<never, string[]>({
+  method: "xrpl_getAccounts",
+});
+```