WIP: Starknet Snap docs

wallet-sidebar.js

@@ -36,6 +36,12 @@ const sidebar = {
           type: "doc",
           id: "reference/sdk-unity-api",
         },
+        {
+          type: "category",
+          label: "Non-EVM APIs",
+          link: { type: "generated-index", slug: "/reference/non-evm-apis" },
+          items: [{ type: "autogenerated", dirName: "reference/non-evm-apis" }],
+        },
         {
           type: "doc",
           id: "reference/provider-api",

wallet/how-to/connect/access-accounts.md

@@ -24,6 +24,10 @@ When accessing a user's accounts:
 - **Always** disable the connect button while the connection request is pending.
 - **Never** initiate a connection request on page load.
 
+:::note
+You can also access users' accounts on some [non-EVM networks](/wallet/how-to/use-non-evm-networks).
+:::
+
 ## Create a connect button
 
 :::caution Important

wallet/how-to/manage-networks/add-network.md

@@ -30,10 +30,10 @@ The confirmations look like the following:
     </div>
 </div>
 
-:::note
-
-To add a local development network such as [Hardhat](https://hardhat.org) to MetaMask, see [Run a development network](../run-devnet.md).
-
+:::info Development and non-EVM networks
+- To add a local development network such as [Hardhat](https://hardhat.org) to MetaMask, see [Run a development network](../run-devnet.md).
+- To add a non-EVM network such as [Starknet](../use-non-evm-networks/starknet/index.md) to MetaMask,
+  see [Use non-EVM networks](/wallet/how-to/use-non-evm-networks).
 :::
 
 ## Example

wallet/how-to/run-devnet.md

@@ -1,6 +1,6 @@
 ---
 description: Configure and connect to a Ganache development network.
-sidebar_position: 9
+sidebar_position: 10
 ---
 
 # Run a development network

wallet/how-to/use-non-evm-networks/index.md

@@ -0,0 +1,32 @@
+---
+description: Interact with users' accounts on non-EVM networks.
+sidebar_position: 9
+---
+
+import CardList from "@site/src/components/CardList"
+
+# Use non-EVM networks
+
+You can interact with users' accounts on non-EVM networks by connecting to existing
+[MetaMask Snaps](https://metamask.io/snaps/).
+
+Non-EVM networks are blockchain networks that are not compatible with the Ethereum Virtual Machine (EVM).
+Non-EVM dapps and MetaMask can't directly interact with each other.
+By connecting to dedicated non-EVM Snaps, you can extend the functionality of MetaMask and integrate non-EVM networks into your existing MetaMask workflow.
+
+MetaMask provides Snaps for the following networks:
+
+<CardList
+  items={[
+    {
+      href: "starknet",
+      title: "Starknet",
+      description:
+        "Layer 2 network for Ethereum using ZK rollups.",
+    },
+  ]}
+/>
+
+:::info
+See the [full list of available non-EVM Snaps](https://snaps.metamask.io/interoperability).
+:::

wallet/how-to/use-non-evm-networks/starknet/about-get-starknet.md

@@ -0,0 +1,87 @@
+---
+description: Learn about how `get-starknet` interacts with MetaMask.
+sidebar_position: 8
+---
+
+# About `get-starknet`
+
+[`get-starknet`](https://github.com/starknet-io/get-starknet) is a library that simplifies Starknet
+network interactions.
+It works with the [Starknet Snap](https://snaps.metamask.io/snap/npm/consensys/starknet-snap/) to
+enable dapps to interact with users' Starknet accounts in MetaMask.
+
+When you integrate `get-starknet` into your dapp, it creates a [Starknet
+Windows Object (SWO)](https://github.com/starknet-io/get-starknet/blob/get-starknet-core%403.3.0/packages/core/src/StarknetWindowObject.ts), which acts as
+the connection between the dapp and MetaMask, and manages Starknet interactions.
+This allows users to send Starknet transactions, sign Starknet messages, and manage Starknet
+accounts within MetaMask, and this functionality can be extended to multiple wallets in the Starknet
+ecosystem.
+
+## How `get-starknet` and MetaMask interact
+
+A dapp with `get-starknet` installed interacts with MetaMask as follows:
+
+1. The dapp uses `get-starknet` to request the user connect to MetaMask.
+   MetaMask automatically requests the user to add the Starknet Snap, if it's not already present.
+
+1. After the dapp is connected to MetaMask and the Starknet Snap, `get-starknet` receives a Starknet
+   Windows Object (SWO), which represents the MetaMask wallet with Starknet functionality.
+
+1. You can retrieve an [Account Object](https://starknetjs.com/docs/API/#account) from the Starknet Windows Object (SWO) when you access `swo.account`.
+   This Account Object enables you to manage Starknet interactions.
+   This instance manages the Starknet account within MetaMask.
+
+```mermaid
+sequenceDiagram
+    participant user as End User
+    participant dapp as Dapp
+    participant get as get-starknet
+    participant mm as MetaMask
+    participant Snap as Starknet Snap
+    participant network as Starknet network
+
+    dapp->>get: Initialize connection
+    get->>mm: Request connection
+    mm->>Snap: Activate
+    Snap-->>mm: Activated
+    get->>Snap: Request Starknet account address
+    Snap-->>mm: Recover account and return Starknet account address
+    mm-->>get: Return Starknet account address
+    get-->>dapp: Connection established with SWO return
+
+    dapp->>get: Read blockchain data
+    get->>network: Query data
+    network-->>get: Return data
+    get-->>dapp: Processed data
+
+    dapp->>get: Write transaction
+    get->>mm: Request write transaction 
+    mm->>Snap: write transaction
+    Snap-->>mm: Request confirmation to write transaction
+    mm-->>user: Request confirmation
+    user-->>mm: Confirm transaction
+    mm-->>Snap: Confirm transaction
+
+    alt If the Account has deployed
+      Snap-->>network: deploying account transaction
+    end
+    Snap-->>network: Submit transaction
+    network-->>Snap: Transaction result
+    Snap-->>mm: Return Transaction result
+    mm-->>get: Return Transaction result
+    get-->>dapp: Return Transaction result
+```
+
+The `get-starknet` library offers several features that improve how dapps interact with the Starknet
+network through MetaMask:
+
+- The `AccountInterface` uses a specified provider to access data from the Starknet network.
+- For transactions, `get-starknet` prepares the data and sends it to MetaMask for signing through
+  the Starknet Snap.
+- `get-starknet` enables the dapp to create contract instances connected to the `AccountInterface`,
+  allowing smart contract functions to be invoked, with MetaMask handling the signatures.
+- `get-starknet` sets up listeners for account and network changes in MetaMask, so the dapp can
+  subscribe and update its state accordingly.
+- `get-starknet` can request network changes through MetaMask, allowing users to switch between
+  Starknet networks, such as Mainnet and Sepolia testnet.
+- `get-starknet` can also request MetaMask to display specific tokens, improving the user experience.