Merge branch 'dev' into fix/align-cache-hashes

README.md

@@ -45,7 +45,7 @@ pnpm add -D @synthetixio/synpress@latest
 
 ## 📝 Documentation
 
-For comprehensive guides, API references, and examples, refer to our [official documentation](https://synpress.io/docs/getting-started).
+For comprehensive guides, API references, and examples, refer to our [official documentation](https://docs.synpress.io/docs/introduction).
 
 ## 🧑‍🤝‍🧑 Community
 

docs/api/cypress/classes/MetaMask.md

@@ -101,6 +101,22 @@ True if the token was added successfully
 
 ***
 
+### approveNewEthereumRPC()
+
+```ts
+approveNewEthereumRPC(): Promise<boolean>
+```
+
+Approves adding a new RPC provider for Ethereum Mainnet.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+True if the RPC provider was added successfully
+
+***
+
 ### approveNewNetwork()
 
 ```ts
@@ -558,6 +574,22 @@ True if the key was provided successfully, false otherwise
 
 ***
 
+### rejectNewEthereumRPC()
+
+```ts
+rejectNewEthereumRPC(): Promise<boolean>
+```
+
+Rejects adding a new RPC provider for Ethereum Mainnet.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+True if the new RPC provided was rejected successfully
+
+***
+
 ### rejectNewNetwork()
 
 ```ts

docs/api/playwright/classes/MetaMask.md

@@ -132,6 +132,24 @@ If extensionId is not set.
 
 ***
 
+### approveNewEthereumRPC()
+
+```ts
+approveNewEthereumRPC(): Promise<void>
+```
+
+Approves adding a new RPC provider for Ethereum Mainnet.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Throws
+
+If extensionId is not set.
+
+***
+
 ### approveNewNetwork()
 
 ```ts
@@ -586,6 +604,24 @@ If extensionId is not set.
 
 ***
 
+### rejectNewEthereumRPC()
+
+```ts
+rejectNewEthereumRPC(): Promise<void>
+```
+
+Rejects adding a new RPC provider for Ethereum Mainnet.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Throws
+
+If extensionId is not set.
+
+***
+
 ### rejectNewNetwork()
 
 ```ts

wallets/metamask/src/cypress/MetaMask.ts

@@ -332,6 +332,26 @@ export default class MetaMask {
     return true
   }
 
+  /**
+   * Approves adding a new RPC provider for Ethereum Mainnet.
+   *
+   * @returns True if the RPC provider was approved successfully
+   */
+  async approveNewEthereumRPC(): Promise<boolean> {
+    await this.metamaskPlaywright.approveNewEthereumRPC()
+    return true
+  }
+
+  /**
+   * Rejects adding a new RPC provider for Ethereum Mainnet.
+   *
+   * @returns True if the RPC provider was rejected successfully
+   */
+  async rejectNewEthereumRPC(): Promise<boolean> {
+    await this.metamaskPlaywright.rejectNewEthereumRPC()
+    return true
+  }
+
   /**
    * Locks the MetaMask wallet.
    * @returns True if the wallet was locked successfully

wallets/metamask/src/cypress/configureSynpress.ts

@@ -135,8 +135,10 @@ export default function configureSynpress(
     addNetwork: (network: Network) => metamask?.addNetwork(network),
     approveNewNetwork: () => metamask?.approveNewNetwork(),
     approveSwitchNetwork: () => metamask?.approveSwitchNetwork(),
+    approveNewEthereumRPC: () => metamask?.approveNewEthereumRPC(),
     rejectNewNetwork: () => metamask?.rejectNewNetwork(),
     rejectSwitchNetwork: () => metamask?.rejectSwitchNetwork(),
+    rejectNewEthereumRPC: () => metamask?.rejectNewEthereumRPC(),
 
     // Anvil
     createAnvilNode: (options?: CreateAnvilOptions) => metamask?.createAnvilNode(options),

wallets/metamask/src/cypress/support/synpressCommands.ts

@@ -42,8 +42,10 @@ declare global {
       addNetwork(network: Network): Chainable<void>
       approveNewNetwork(): Chainable<void>
       approveSwitchNetwork(): Chainable<void>
+      approveNewEthereumRPC(): Chainable<void>
       rejectNewNetwork(): Chainable<void>
       rejectSwitchNetwork(): Chainable<void>
+      rejectNewEthereumRPC(): Chainable<void>
 
       deployToken(): Chainable<void>
       addNewToken(): Chainable<void>
@@ -268,6 +270,20 @@ export default function synpressCommandsForMetaMask(): void {
     return cy.task('rejectSwitchNetwork')
   })
 
+  /**
+   * Approves adding a new RPC provider for Ethereum Mainnet
+   */
+  Cypress.Commands.add('approveNewEthereumRPC', () => {
+    return cy.task('approveNewEthereumRPC')
+  })
+
+  /**
+   * Rejects adding a new RPC provider for Ethereum Mainnet
+   */
+  Cypress.Commands.add('rejectNewEthereumRPC', () => {
+    return cy.task('rejectNewEthereumRPC')
+  })
+
   // Token
 
   /**

wallets/metamask/src/playwright/MetaMask.ts

@@ -283,13 +283,41 @@ export class MetaMask extends MetaMaskAbstract {
     await this.notificationPage.rejectSwitchNetwork(this.extensionId)
   }
 
+  /**
+   * Approves adding a new RPC provider for Ethereum Mainnet.
+   *
+   * @throws {Error} If extensionId is not set.
+   */
+  async approveNewEthereumRPC(): Promise<void> {
+    if (!this.extensionId) {
+      throw NO_EXTENSION_ID_ERROR
+    }
+
+    await this.notificationPage.approveNewEthereumRPC(this.extensionId)
+  }
+
+  /**
+   * Rejects adding a new RPC provider for Ethereum Mainnet.
+   *
+   * @throws {Error} If extensionId is not set.
+   */
+  async rejectNewEthereumRPC(): Promise<void> {
+    if (!this.extensionId) {
+      throw NO_EXTENSION_ID_ERROR
+    }
+
+    await this.notificationPage.rejectNewEthereumRPC(this.extensionId)
+  }
+
   /**
    * Confirms a transaction.
    *
    * @param options - Optional gas settings for the transaction.
    * @throws {Error} If extensionId is not set.
    */
-  async confirmTransaction(options?: { gasSetting?: GasSettings }): Promise<void> {
+  async confirmTransaction(options?: {
+    gasSetting?: GasSettings
+  }): Promise<void> {
     if (!this.extensionId) {
       throw NO_EXTENSION_ID_ERROR
     }

wallets/metamask/src/playwright/pages/NotificationPage/actions/ethereumRpc.ts

@@ -0,0 +1,15 @@
+import type { Page } from '@playwright/test'
+import Selectors from '../../../../selectors/pages/NotificationPage'
+
+const approveNewEthereumRPC = async (notificationPage: Page) => {
+  await notificationPage.locator(Selectors.EthereumRpcPage.approveNewRpc).click()
+}
+
+const rejectNewEthereumRPC = async (notificationPage: Page) => {
+  await notificationPage.locator(Selectors.EthereumRpcPage.rejectNewRpc).click()
+}
+
+export const ethereumRpc = {
+  approveNewEthereumRPC,
+  rejectNewEthereumRPC
+}

wallets/metamask/src/playwright/pages/NotificationPage/actions/index.ts

@@ -6,3 +6,4 @@ export * from './transaction'
 export * from './network'
 export * from './token'
 export * from './encryption'
+export * from './ethereumRpc'

wallets/metamask/src/playwright/pages/NotificationPage/page.ts

@@ -6,6 +6,7 @@ import {
   approvePermission,
   connectToDapp,
   decryptMessage,
+  ethereumRpc,
   network,
   providePublicEncryptionKey,
   signSimpleMessage,
@@ -99,6 +100,18 @@ export class NotificationPage {
     await network.rejectSwitchNetwork(notificationPage)
   }
 
+  async approveNewEthereumRPC(extensionId: string) {
+    const notificationPage = await getNotificationPageAndWaitForLoad(this.page.context(), extensionId)
+
+    await ethereumRpc.approveNewEthereumRPC(notificationPage)
+  }
+
+  async rejectNewEthereumRPC(extensionId: string) {
+    const notificationPage = await getNotificationPageAndWaitForLoad(this.page.context(), extensionId)
+
+    await ethereumRpc.rejectNewEthereumRPC(notificationPage)
+  }
+
   async confirmTransaction(extensionId: string, options?: { gasSetting?: GasSettings }) {
     const notificationPage = await getNotificationPageAndWaitForLoad(this.page.context(), extensionId)
 

wallets/metamask/src/selectors/pages/NotificationPage/ethereumRpcPage.ts

@@ -0,0 +1,4 @@
+export default {
+  approveNewRpc: '.confirmation-warning-modal__content .mm-button-primary--type-danger',
+  rejectNewRpc: '.confirmation-warning-modal__content .mm-button-secondary'
+}

wallets/metamask/src/selectors/pages/NotificationPage/index.ts

@@ -1,5 +1,6 @@
 import ActionFooter from './actionFooter'
 import ConnectPage from './connectPage'
+import EthereumRpcPage from './ethereumRpcPage'
 import NetworkPage from './networkPage'
 import PermissionPage from './permissionPage'
 import SignaturePage from './signaturePage'
@@ -8,8 +9,9 @@ import TransactionPage from './transactionPage'
 export default {
   ActionFooter,
   ConnectPage,
-  SignaturePage,
+  EthereumRpcPage,
   NetworkPage,
   PermissionPage,
+  SignaturePage,
   TransactionPage
 }

wallets/metamask/src/type/MetaMaskAbstract.ts

@@ -126,6 +126,16 @@ export abstract class MetaMaskAbstract {
    */
   abstract rejectSwitchNetwork(): void
 
+  /**
+   * Approves a new RPC provider request.
+   */
+  abstract approveNewEthereumRPC(): void
+
+  /**
+   * Rejects a new RPC provider request.
+   */
+  abstract rejectNewEthereumRPC(): void
+
   /**
    * Confirms a transaction request.
    *