> For the complete documentation index, see [llms.txt](https://docs.hotkeyswap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hotkeyswap.com/miscellaneous/connect-wallet-troubleshoot-guide/connecting-metamask-wallet-on-ios-a-step-by-step-guide.md).

# Connecting MetaMask Wallet on iOS: A Step-by-Step Guide

For iOS users navigating the innovative landscape of Telegram's mini-apps, connecting your MetaMask wallet can present unique challenges. This page, complemented by an instructional video tutorial, is designed to guide you through the process smoothly.

**Step-by-Step Connection Process:**

1. **Open the Telegram DEX:**
   * Start by opening the HotKeySwap [telegram DEX](http://t.me/HotKeySwapBot/swap) and tap on the "Connect" option.
2. **Navigate to WalletConnect:**
   * You'll be directed to WalletConnect. Here, select the MetaMask icon to proceed.
3. **Use the Alternative Link:**
   * After selecting MetaMask, click on "Use Alternative Link." This action will redirect you to the MetaMask app.
4. **Sign the Agreement:**
   * In MetaMask, you'll be prompted to sign an agreement allowing the app to access information from your MetaMask wallet. Confirm this to proceed.
5. **Finalize the Connection:**
   * Once you've granted permission, return to the Telegram app. You should now find your wallet connected to the HotKeySwap DEX.

**Troubleshooting Tips:**

If you encounter issues where WalletConnect won't initiate or MetaMask fails to load:

1. **Access MetaMask Settings:**
   * Open the MetaMask app and navigate to the settings menu.
2. **Enable Experimental Features:**
   * Within settings, locate the "Experimental" section and select it.
3. **End WalletConnect Sessions:**
   * Find the option to "End All WalletConnect Sessions" and select it. This will clear any existing sessions that might be causing conflicts.
4. **Retry Connection:**
   * Return to the HotKeySwap bot and attempt to connect your wallet again. The issue should now be resolved.

**Video Tutorial:**

For a more visual guide, refer to the video tutorial below, which walks you through each step of the process, ensuring a hassle-free connection experience.

{% embed url="<https://youtu.be/ba7xC14YFeQ>" %}
Connecting MetaMask Wallet on iOS: A Step-by-Step Guide
{% endembed %}

{% embed url="<https://youtube.com/shorts/ba7xC14YFeQ>" %}
Connecting MetaMask Wallet on iOS: A Step-by-Step Guide
{% endembed %}

**Need Further Assistance?**

If you continue to face difficulties or have any questions, please don't hesitate to reach out to our support team. We're here to help you navigate these steps and ensure you can connect your MetaMask wallet on iOS without any issues.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hotkeyswap.com/miscellaneous/connect-wallet-troubleshoot-guide/connecting-metamask-wallet-on-ios-a-step-by-step-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.