Merge branch 'main' into dtk-fixes

alexandratran · alexandratran · commit 84e18434b2da · 2025-08-12T14:43:46.000-07:00
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -19,7 +19,7 @@ jobs:
     name: Build
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Build
         uses: ConsenSys/github-actions/docs-build@main
 
@@ -30,7 +30,7 @@ jobs:
       matrix:
         folder: ['docs']
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Case check action
         uses: ConsenSys/github-actions/docs-case-check@main
         with:
@@ -41,7 +41,7 @@ jobs:
     name: Lint Code Base
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Lint
         uses: ConsenSys/github-actions/docs-lint-all@main
 
@@ -52,7 +52,7 @@ jobs:
       matrix:
         file-extensions: ['.md', '.mdx']
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Vale
         uses: Consensys/github-actions/docs-spelling-check@main
         with:
@@ -65,7 +65,7 @@ jobs:
       matrix:
         file-extensions: ['.md', '.mdx']
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: LinkCheck
         uses: ConsenSys/github-actions/docs-link-check@main
         with:
diff --git a/.github/workflows/crowdin.yml b/.github/workflows/crowdin.yml
@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Synchronize with Crowdin
         uses: crowdin/github-action@v1
diff --git a/.github/workflows/dependency_review.yml b/.github/workflows/dependency_review.yml
@@ -16,7 +16,7 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Dependency review
         uses: ConsenSys/github-actions/js-dependency-review@main
diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml
@@ -17,7 +17,7 @@
       permissions:
         contents: read
       steps:
-        - uses: actions/checkout@v4
+        - uses: actions/checkout@v5
         - name: LinkCheck mdx files
           uses: ConsenSys/github-actions/docs-link-check@main
           with:
@@ -32,9 +32,9 @@
       permissions:
         contents: read
       steps:
-        - uses: actions/checkout@v4
+        - uses: actions/checkout@v5
         - name: LinkCheck md files
           uses: ConsenSys/github-actions/docs-link-check@main
           with:
               FILE_EXTENSION: md
-              MODIFIED_FILES_ONLY: no
+              MODIFIED_FILES_ONLY: no
diff --git a/.github/workflows/security-code-scanner.yml b/.github/workflows/security-code-scanner.yml
@@ -17,7 +17,7 @@ jobs:
       contents: read
       security-events: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: MetaMask Security Code Scanner
         uses: ConsenSys/github-actions/mm-security-scanner@main
         with:
diff --git a/.github/workflows/trivy-cache.yml b/.github/workflows/trivy-cache.yml
@@ -14,6 +14,6 @@ jobs:
     name: Run trivy scanner
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Trivy Cache
         uses: ConsenSys/github-actions/trivy-update-cache@main
diff --git a/.github/workflows/trivy.yml b/.github/workflows/trivy.yml
@@ -11,8 +11,8 @@ jobs:
     name: Run trivy scanner
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Trivy
         uses: ConsenSys/github-actions/trivy@main
         with:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.gitignore b/.gitignore
@@ -16,6 +16,7 @@
 .env.development.local
 .env.test.local
 .env.production.local
+.prettierignore
 
 npm-debug.log*
 .vercel
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -85,7 +85,7 @@
     "@types/react-modal": "^3.16.3",
     "@typescript-eslint/parser": "^8.38.0",
     "eslint": "^9.20.0",
-    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react": "^7.37.5",
     "stylelint": "^15.0.0 ",
     "stylelint-config-standard": "^34.0.0",
     "tsc-files": "^1.1.4",
diff --git a/sdk/connect/javascript.md b/sdk/connect/javascript.md
@@ -11,23 +11,24 @@ import TabItem from "@theme/TabItem";
 
 Get started with MetaMask SDK in your JavaScript dapp.
 
+## Prerequisites
+
+- [Node.js](https://nodejs.org/) version 19 or later installed.
+- A package manager installed, such as [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm), [Yarn](https://yarnpkg.com/), [pnpm](https://pnpm.io/installation), or [bun](https://bun.sh/).
+- [MetaMask](https://metamask.io/) installed in your browser or on mobile.
+
+
 ## Steps
 
 ### 1. Install the SDK
 
-Install the SDK in an existing JavaScript project using npm or Yarn:
+Install the SDK in an existing JavaScript project:
 
-```bash
+```bash npm2yarn
 npm install @metamask/sdk
 ```
 
-or
-
-```
-yarn add @metamask/sdk
-```
-
-### 2.  Use the SDK
+### 2. Initialize the SDK
 
 The following are examples of using the SDK in various JavaScript environments:
 
@@ -39,22 +40,12 @@ import { MetaMaskSDK } from "@metamask/sdk"
 
 const MMSDK = new MetaMaskSDK({
   dappMetadata: {
-    name: "Example JavaScript Dapp",
+    name: "Example JavaScript dapp",
     url: window.location.href,
+    // iconUrl: "https://mydapp.com/icon.png" // Optional
   },
   infuraAPIKey: process.env.INFURA_API_KEY,
 })
-
-const ethereum = MMSDK.getProvider()
-
-// Connect to MetaMask
-const accounts = await MMSDK.connect()
-
-// Make requests
-const result = await ethereum.request({ 
-  method: "eth_accounts", 
-  params: [] 
-})
 ```
 
 </TabItem>
@@ -66,63 +57,77 @@ const result = await ethereum.request({
   <script>
     const MMSDK = new MetaMaskSDK.MetaMaskSDK({
       dappMetadata: {
-        name: "Example Pure JS Dapp",
+        name: "Example JavaScript dapp",
+        url: window.location.href,
+        // iconUrl: "https://mydapp.com/icon.png" // Optional
       },
       infuraAPIKey: process.env.INFURA_API_KEY,
-    });
-    
-    MMSDK.connect()
+    })
   </script>
 </head>
 ```
 
 </TabItem>
 </Tabs>
 
-### 3. Configure the SDK
+These examples configure the SDK with the following options:
 
-The SDK accepts several [configuration options](../reference/sdk-options.md) when initializing.
-For example:
+- [`dappMetadata`](../reference/sdk-options.md#dappmetadata) - Ensures trust by showing your dapp's `name`, `url`, and `iconUrl` during connection.
+
+- [`infuraAPIKey`](../reference/sdk-options.md#infuraapikey) - Enables read-only RPC and load‑balancing.
+
+### 3. Connect and use provider
+
+Connect to MetaMask and get the provider for RPC requests:
 
 ```javascript
-const MMSDK = new MetaMaskSDK({
-  // Required - Your dapp's info
-  dappMetadata: {
-    name: "Your Dapp Name",
-    url: window.location.href,
-  },
-  
-  // Optional - Infura API key for read-only RPC calls
-  infuraAPIKey: process.env.INFURA_API_KEY,
-  
-  // Optional - Customize modal display
-  headless: false,
+const provider = MMSDK.getProvider()
+
+const accounts = await MMSDK.connect()
+console.log("Connected account:", accounts[0])
+
+const result = await provider.request({
+  method: "eth_accounts",
+  params: [],
 })
+console.log("eth_accounts result:", result)
 ```
 
-### 4. Call common methods
+`MMSDK.connect()` handles cross-platform connection (desktop and mobile), including deeplinking.
+
+Use `provider.request()` for arbitrary [JSON-RPC requests](/wallet/reference/json-rpc-methods) like `eth_chainId` or `eth_getBalance`, or for [batching requests](../guides/batch-requests.md) via `metamask_batch`.
+
+## Common SDK methods at a glance
+
+| Method                                 | Description                                  |
+| -------------------------------------- | -------------------------------------------- |
+| [`connect()`](../reference/sdk-methods.md#connect)                            | Triggers wallet connection flow              |
+| [`connectAndSign({ msg: '...' })`](../reference/sdk-methods.md#connectandsign)       | Connects and prompts user to sign a message  |
+| [`getProvider()`](../reference/sdk-methods.md#getprovider)                        | Returns the provider object for RPC requests |
+| [`provider.request({ method, params })`](/wallet/reference/provider-api/#request) | Calls any Ethereum JSON‑RPC method                   |
+| [Batched RPC](../guides/batch-requests.md)                            | Use `metamask_batch` to group multiple JSON-RPC requests |
 
-The following are common methods you can call with the SDK:
+## Usage example
 
 ```javascript
-// Connect and get accounts
+// 1. Connect and get accounts
 const accounts = await MMSDK.connect()
 
-// Get provider for RPC requests
+// 2. Connect and sign in one step
+const signResult = await MMSDK.connectAndSign({
+  msg: "Sign in to Dapp",
+})
+
+// 3. Get provider for RPC requests
 const provider = MMSDK.getProvider()
 
-// Make an RPC request
-const result = await provider.request({ 
+// 4. Make an RPC request
+const result = await provider.request({
   method: "eth_accounts",
-  params: [] 
-})
-
-// Connect and sign in one step
-const signResult = await MMSDK.connectAndSign({ 
-  msg: "Sign in to Dapp" 
+  params: [],
 })
 
-// Batch multiple RPC requests
+// 5. Batch multiple RPC requests
 const batchResults = await provider.request({
   method: "metamask_batch",
   params: [
diff --git a/services/reference/sei/json-rpc-methods/index.md b/services/reference/sei/json-rpc-methods/index.md
diff --git a/services/reference/solana/json-rpc-methods/index.md b/services/reference/solana/json-rpc-methods/index.md
diff --git a/src/scss/theme/_doc-search.scss b/src/scss/theme/_doc-search.scss
