reown-com · vrajdesai78 · Mar 26, 2025 · Mar 26, 2025 · Mar 26, 2025 · Mar 26, 2025
diff --git a/.cspell.json b/.cspell.json
@@ -27,39 +27,8 @@
       }
     ],
     "words": [
-      "npm",
-      "webpack",
-      "prettier",
-      "markdownlint",
-      "mdx",
-      "appkit",
-      "reown",
-      "solana",
-      "wagmi",
-      "siwe",
-      "viem",
-      "Farcaster",
-      "Nethereum",
-      "walletconnect",
-      "CAIP",
-      "deeplink",
-      "RDNS",
-      "siws",
-      "siwx",
-      "walletkit",
-      "Cocoapods",
-      "Podfile",
-      "Multichain",
-      "devnet",
-      "testflight",
-      "nuxt",
-      "jitpack",
-      "Linea",
-      "polkadot",
-      "anza",
-      "kadena",
-      "keccak",
-      "XRPL",
+      "npm","webpack","prettier","markdownlint","mdx","appkit","reown","solana","wagmi","siwe","viem","Farcaster","Nethereum","walletconnect","CAIP","deeplink",
+      "RDNS","siws","siwx","walletkit","Cocoapods","Podfile","Multichain","devnet","testflight","nuxt","jitpack","Linea","polkadot","anza","kadena","keccak","XRPL",
       "keypair","tezos","Starknet", "utxos", "litecoin", "hedera", "satoshi", "kusama", "westend", "statemint", "passwordless",
       "Blockhash", "UTXO", "PSBT", "keypair", "keypairs", "deeplinking", "chainlist", "pubspec","artefacts","artefact","artefactId", "WCURI",
       "qrcode", "ECDH", "ciphertext", "HMAC", "mutez", "rebranded", "clickjacking", "openupm", "walletids", "walletid", "Keyserver", "CAPI",
@@ -68,7 +37,8 @@
       "johnsmith", "secp", "reimagined", "tgvideo", "solflare", "WBIPs", "xverse", "mycustomwallet", "seedphrases", "Pimlico", "signup", "onramps", "rainbowkit", "connectkit", "stablecoins", "fulfilment",
       "tictactoe", "dollar", "supabase", "Frontmatter", "LLMSTXT", "tokenpocket", "imtoken", "kraken", "ronin", "exodus", "argent", "zerion", "oneinch", "crypto-com", "imtoken", "kraken", "ronin", "robinhood", "exodus", "argent", "tokenpocket",
       "nosocial", "bitget", "leather", "binance", "uniswap", "safepal", "bybit", "phantom", "ledger", "timeless-x", "safe", "zerion", "oneinch", "crypto-com", "imtoken", "kraken", "ronin", "robinhood", "exodus", "argent", "tokenpocket", "Contractaddress", 
-      "executionreverted", "FATF", "VASP", "LLMSTXT", "Frontmatter", "CASP", "DKMS"
+      "executionreverted", "FATF", "VASP", "LLMSTXT", "Frontmatter", "CASP", "DKMS", "hydradx", "phala", "astar", "mangata", "polkadotjs", "Dogecoin", "Blockbook", "vuejs", "xsmall", "rgba", "mintlify", "filteredwallets",
+      "tnum","minmax","toolkits", "autoplay", "Litoshi", "Litoshis", "encryptor's", "Everscale", "Bitcore", "satoshis", "Parachain", "Bitcore", "walletlist", "Userflow", "retryable", "USDS", "Arbirtrum"
     ]
   }
 
diff --git a/README.md b/README.md
@@ -31,6 +31,17 @@ We welcome contributions to improve our documentation! Here's how you can help:
 
 To run the documentation locally, you'll need to have Node.js installed on your machine. Then follow these steps:
 
+1. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+2. Run the development server:
+   ```bash
+   pnpm run dev
+   ```
+
+or 
+
 1. Install the Mintlify CLI globally:
    ```bash
    npm install -g mintlify
@@ -71,6 +82,19 @@ The development server will automatically reload when you make changes to the do
 - Include code examples where appropriate
 - Test all code snippets to ensure they work as expected
 
+### Building a project with AI?
+
+If you're using Cursor IDE (or another AI-based IDE) to build a project with Reown AppKit, we provide a `.mdc` file that enhances your development experience. The `reown-appkit.mdc` file in this repository contains Cursor-specific rules and type hints for Reown AppKit.
+
+To use it in your project:
+
+1. Copy the `reown-appkit.mdc` file from this repository
+2. Create a `.cursor/rules` folder in your project's root directory (if it doesn't exist)
+3. Place the `.mdc` file in your project's `.cursor/rules` folder
+
+For more info, refer to [Cursor's documentation](https://docs.cursor.com/context/rules#project-rules).
+
+
 ### Need Help?
 
 If you have any questions or need help with your contribution, please:

diff --git a/advanced/multichain/polkadot/wallet-integration-guide.mdx b/advanced/multichain/polkadot/wallet-integration-guide.mdx
@@ -171,7 +171,7 @@ walletKit.on("session_request", async (requestEvent) => {
 
 # Sessions Persistence/Management
 
-- sessions can be saved/stored so users dont have to pair repeatedly
+- sessions can be saved/stored so users don't have to pair repeatedly
 - sessions can be disconnected from using `await walletKit.disconnectSession({ topic: topic });` passing the session topic.
 - sessions can be extended using `await walletKit.extendSession({ topic: topic });` passing the session topic.
 - Default session lifetime is 7 days for WalletConnect v2.0.

diff --git a/advanced/multichain/rpc-reference/everscale-rpc.mdx b/advanced/multichain/rpc-reference/everscale-rpc.mdx
@@ -111,7 +111,7 @@ Message that can then be sent to the blockchain.
 ##### Returns:
 
     1. signedExtMessage - signed external message;
-    2. expireAt - мessage expiration timestamp
+    2. expireAt - message expiration timestamp
 
 ##### Example:
 
@@ -208,7 +208,7 @@ Sends an internal message from the user account without waiting for the transact
 
     1. hash: string - external message hash;
     2. account: string - destination account address (equals to source_address);
-    3. expireAt: number - мessage expiration timestamp
+    3. expireAt: number - message expiration timestamp
 
 ##### Example:
 
@@ -259,7 +259,7 @@ Sends an external message to the contract without waiting for the transaction.
 
     1. hash: string - external message hash;
     2. account: string - destination account address (equals to source_address);
-    3. expireAt: number - мessage expiration timestamp
+    3. expireAt: number - message expiration timestamp
 
 ##### Example:
 

diff --git a/appkit/android/core/one-click-auth.mdx b/appkit/android/core/one-click-auth.mdx
@@ -70,6 +70,15 @@ If the wallet connecting to your dapp does not support One-Click Auth, the SDK w
 
 The latest release of AppKit supports link mode, a low latency mechanism for transporting One-Click Auth requests and session requests over universal links, reducing the need for a WebSocket connection with the Relay. This significantly enhances the user experience when connecting native dApps to native wallets by reducing the latency associated with networking connections, especially when the user has an unstable internet connection.
 
+<Frame>
+<video
+  controls
+  autoPlay
+  src="/images/link-mode.mp4"
+  height="400" width="300"
+></video>
+</Frame>
+
 To support link mode, configure your AppMetaData `appLink` with a valid universal link and set the `linkMode` property to `true`:
 
 ```kotlin
@@ -112,6 +121,17 @@ Ensure that your App Link is properly configured in your app's Manifest file wit
 </intent-filter>
 ```
 
+#### How does it look without Link Mode?
+
+<Frame>
+<video
+  controls
+  autoPlay
+  src="/images/without-link-mode.mp4"
+  height="400" width="300"
+></video>
+</Frame>
+
 For more information on how to configure app links for your app, refer to the [Android Documentation](https://developer.android.com/training/app-links/verify-android-applinks).
 
 For enabling links to app content check [this](https://developer.android.com/training/app-links/deep-linking) documentation page.

diff --git a/appkit/features/siwx/default.mdx → appkit/authentication/siwx/default.mdx b/appkit/features/siwx/default.mdx → appkit/authentication/siwx/default.mdx
@@ -1,16 +1,26 @@
 ---
-title: Authentication (SIWX)
-sidebarTitle: Sign in with X (SIWX)
+title: Multichain Authentication (SIWX)
+sidebarTitle: Multichain Authentication (SIWX)
 ---
 
-## Introduction
+The **Sign In With X** feature enables decentralized applications (Dapps) to authenticate users seamlessly across multiple blockchain networks, such as Ethereum, Solana, and Bitcoin, since this feature is **chain agnostic**.
 
-The **Sign In With X** feature enables decentralized applications (Dapps) to authenticate users seamlessly across multiple blockchain networks, such as Ethereum, Polygon or Solana. This feature allows developers using our SDK to implement authentication by having users sign a unique string message with their blockchain wallets. The **Sign In With X** feature is designed in accordance with the [CAIP-122](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-122.md) standard, which establishes a chain-agnostic framework for blockchain-based authentication and authorization on off-chain services.
-<Frame>
-<img src="/images/assets/siwe-connect.gif" />
+This feature allows developers using our SDK to implement authentication by having users sign a unique string message with their blockchain wallets. The **Sign In With X** feature is designed in accordance with the [CAIP-122](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-122.md) standard, which establishes a chain-agnostic framework for blockchain-based authentication and authorization on off-chain services.
+
+<Frame caption="SIWX Demo">
+  <video
+    controls
+    autoPlay
+    loop
+    src="/images/siwx.mp4"
+  ></video>
 </Frame>
 
-<Card title="Try Demo" href="https://appkit-lab.reown.com/library/siwx-default/" horizontal />
+## Demo
+
+<CardGroup cols={2}>
+    <Card icon="flask" title="Try Demo" href="https://appkit-lab.reown.com/library/siwx-default/" />
+</CardGroup>
 
 
 ## Getting Started
@@ -33,6 +43,10 @@ Read more about the [Default Implementation](./siwx-default).
 
 The Cloud Auth SIWX is a predefined implementation of the SIWX configuration plugin that uses the Cloud service to create and manage SIWX messages and sessions. With Cloud Auth SIWX, you will be able to see and control the sessions of your users using the [User Management Dashboard](/cloud/user-management).
 
+<Note>
+Cloud Auth SIWX is only available for `eip155` compatible networks.
+</Note>
+
 Read more about the [Cloud Auth Implementation](./siwx-cloud-auth).
 
 ### Custom Implementation

diff --git a/appkit/features/siwx/siwx-cloud-auth.mdx → ...t/authentication/siwx/siwx-cloud-auth.mdx b/appkit/features/siwx/siwx-cloud-auth.mdx → ...t/authentication/siwx/siwx-cloud-auth.mdx
diff --git a/appkit/features/siwx/siwx-custom.mdx → appkit/authentication/siwx/siwx-custom.mdx b/appkit/features/siwx/siwx-custom.mdx → appkit/authentication/siwx/siwx-custom.mdx
diff --git a/appkit/features/siwx/siwx-default.mdx → appkit/authentication/siwx/siwx-default.mdx b/appkit/features/siwx/siwx-default.mdx → appkit/authentication/siwx/siwx-default.mdx
diff --git a/appkit/authentication/socials.mdx b/appkit/authentication/socials.mdx
@@ -5,7 +5,20 @@ sidebarTitle: Email & Social Login
 
 Bring your app to a world of new users in minutes with default Email and Social login, giving both new and existing users the ability to seamlessly connect to your app using just an email address or social account. With minimal code changes, you can customize these options to suit your needs and use Smart Account functionality in minutes.
 
-<Card title="Try Demo" href="https://appkit-lab.reown.com/library/wagmi/" />
+<Frame>
+<video
+  controls
+  autoPlay
+  className="w-full aspect-video"
+  src="/images/socials-demo.mp4"
+></video>
+</Frame>
+
+## Demo
+
+Want to see social login in action? Try out the live demo to experience the seamless social login flow firsthand.
+
+<Card icon="flask" title="Try Demo" href="https://demo.reown.com/?utm_source=navbar&utm_medium=docs&utm_campaign=backlinks" external />
 
 ## Supported Providers 
 

diff --git a/appkit/features/chain-abstraction.mdx b/appkit/features/chain-abstraction.mdx
@@ -0,0 +1,78 @@
+---
+title: Chain Abstraction
+---
+
+Chain Abstraction is a feature in Reown AppKit that enables dApps to facilitate seamless cross-chain transactions for users. It allows users to spend crypto tokens, such as stablecoins, across different blockchain networks without needing to manually bridge tokens, worry about network-specific tokens, or manage multiple wallets.
+
+<Note>
+Chain Abstraction is currently an early access feature.
+</Note>
+
+<Frame caption="Chain Abstraction Demo">
+<video
+  controls
+  autoPlay
+  className="w-full aspect-video"
+  src="/images/chain-abstraction-demo.mp4"
+></video>
+</Frame>
+
+## Demo
+
+Want to see Chain Abstraction in action? Try out the live demo to experience Reown AppKit's Chain Abstraction flow firsthand. 
+
+<CardGroup cols={2}>
+    <Card icon="flask" title="Try Demo" href="https://ca-demo.reown.com/?utm_source=navbar&utm_medium=docs&utm_campaign=backlinks" external />
+</CardGroup>
+
+## When can you leverage Chain Abstraction?
+
+1. **Seamless Cross-Chain Transactions**: Users can transact on a target blockchain network even if their assets reside on a different source network. For example, a user can make a payment on the Base network using USDC held on Arbitrum. 
+
+2. **Enhanced User Experience**: By abstracting the complexities of cross-chain interactions, dApps can offer a more intuitive and frictionless experience, reducing the need for users to understand or manage the underlying blockchain infrastructure.
+
+3.  **Developer-Friendly Integration**: Reown AppKit provides a set of tools and methods, such as prepare and execute, that allow developers to integrate chain abstraction functionality into their dApps with minimal effort. 
+
+## How It Works
+
+- **Transaction Preparation**: When a user initiates a transaction, the dApp uses the prepare method to determine if the user has sufficient funds on the target network. If not, it identifies the necessary bridging transactions required to move assets from the source to the target network.
+
+- **Transaction Execution**: Once the necessary transactions are prepared and signed, the execute method broadcasts them, handling the bridging process and completing the original transaction on the target network.
+
+- **Gas Estimation Handling**: To ensure accurate gas estimation, dApps should pass gas: null when sending transactions, allowing the wallet to handle gas calculations appropriately. 
+
+## Networks and Assets Supported
+
+Currently, Chain Abstraction on AppKit supports the following assets on the following networks:
+
+| Network   | Assets          |
+|-----------|-----------------|
+| Optimism  | USDC, USDT, ETH |
+| Arbitrum  | USDC, USDT, ETH |
+| Base      | USDC, USDS, ETH |
+| Solana    | USDC            |
+
+
+## Example Use Case
+
+Consider a scenario where a user wants to **purchase an NFT on the Base network but holds USDC only on the Arbitrum network**. With Chain Abstraction:
+
+- The dApp detects the asset location and prepares the necessary bridging transactions.
+
+- The user signs the transactions, and the assets are bridged from Arbitrum to Base.
+
+- The purchase is completed on the Base network without the user manually bridging assets or switching networks.
+
+You can try out this use case in the [demo above](#demo).
+
+## Get Started
+
+<CardGroup cols={2}>
+    <Card title="React" icon="react" href="/appkit/react/early-access/chain-abstraction">
+        Get started with AppKit in React.
+    </Card>
+
+    <Card title="Next.js" icon="square-n" href="/appkit/next/early-access/chain-abstraction">
+        Get started with AppKit in Next.js.
+    </Card>
+</CardGroup>
diff --git a/appkit/features/onramp.mdx b/appkit/features/onramp.mdx
@@ -4,11 +4,13 @@ title: On-Ramp
 
 On-Ramp securely provides users access to over 100 cryptocurrencies from right within your app. In just a few clicks, users can purchase tokens to support in-app activity and transactions across multiple chains. Set up in minutes with just one line of code.
 
-<Card
-  title="Try Demo"
-  href="https://appkit-lab.reown.com/library/wagmi/"
-  horizontal
-/>
+<iframe width="720" height="400" src="https://www.youtube.com/embed/B05eA3ufp-Y?si=hcRl_ZLf5qZ2l5pC" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+## Demo
+
+<CardGroup cols={2}>
+    <Card icon="flask" title="Try Demo" href="https://appkit-lab.reown.com/library/wagmi/" />
+</CardGroup>
 
 ## Get Started
 
@@ -59,15 +61,15 @@ Once connected, select "Buy Crypto" from the wallet modal.
 
 ### Choose your provider
 
-Select "Coinbase" as your provider.
+Select "Coinbase" or "Meld" as your provider.
 
 <Frame>
-  <img src="/images/w3m/onramp/3.png" />
+  <img src="/images/new-onramp.png" />
 </Frame>
 
 ### Complete your purchase
 
-Complete your purchase using Coinbase Pay. You will be prompted to sign in to your Coinbase account.
+Complete your purchase using your selected provider. You will be prompted to sign in to your Coinbase or Meld account.
 If the payment page does not appear, you can copy link from the wallet modal and paste it in your browser.
 
 <Frame>
@@ -76,7 +78,7 @@ If the payment page does not appear, you can copy link from the wallet modal and
 
 ### Select assets and amount
 
-Choose the asset and amount you would like to purchase from Coinbase.
+Choose the asset and amount you would like to purchase from your selected provider.
 
 <Frame>
   <img src="/images/w3m/onramp/5.png" />