> For the complete documentation index, see [llms.txt](https://docs.4everland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.4everland.org/get-started/quick-start-guide/account/linking-your-evm-wallet-to-4everland-account.md).

# Linking Your EVM Wallet to 4EVERLAND Account

## Why Link Your Wallet?

For users who authenticate with 4EVERLAND via Telegram or GitHub, wallet linking is essential to:

* **Securely Receive Rewards**: Directly credit aggregator mining rewards, airdrops, and other incentives to your EVM-compatible wallet.
* **Enable On-Chain Actions**: Facilitate token transfers, contract interactions, and other Web3 operations without manual address input.
* **Enhance Account Security**: Leverage wallet's private key encryption for transaction signing, reducing the risk of unauthorized access.

## Step-by-Step Linking Guide

### Step 1: Access the 4EVERLAND Dashboard

1. **Navigate to the Dashboard**:
   * Open [4EVERLAND Dashboard](https://dashboard.4everland.org/) in your browser.
2. **Login via Telegram or GitHub**:
   * Click **Connect via Telegram** or **Connect via GitHub** button.
   * *Note*: Ensure your Telegram/GitHub account is already registered with 4EVERLAND.

<figure><img src="/files/f2zTrOlsiSkBiEODEPnm" alt=""><figcaption><p><strong>Login via Telegram or GitHub</strong></p></figcaption></figure>

### Step 2: Authorize Your Account

1. **Complete Authorization**:
   * After clicking the login button, an authorization page will appear.
   * For Telegram:
     * Select **Login as \[Your Telegram Username]** → click **Allow** to grant access permissions.
   * For GitHub:
     * Review requested permissions → click **Authorize 4EVERLAND** to proceed.

<figure><img src="/files/QKpwS13upjyW8em18rPo" alt=""><figcaption></figcaption></figure>

### Step 3: Initiate Wallet Verification

1. **Access Account Settings**:
   * Once logged in, click on **Account** (bottom-left dropdown) → select **Configurations**.
2. **Locate Wallet Verification**:
   * Under the **Wallets** section, find the **Verify EVM Wallet** option.
3. **Select Your Wallet**:
   * Choose from supported wallets:
     * **MetaMask**: Browser extension (Chrome/Firefox)
     * **Binance Wallet**: Mobile/desktop app
     * **OKX Wallet**: Mobile/desktop app
     * **Others**: e.g., Bitget Wallet, Token Pocket&#x20;
   * Click **Verify** to start the linking process.

<figure><img src="/files/nYUGliTBf3VAm3KLjyTp" alt=""><figcaption></figcaption></figure>

### Step 4: Complete Wallet Linking

**MetaMask Example:**

1. **Sign the Message**:
   * A MetaMask popup will appear, requesting you to sign a verification message.
   * Review the message details (including your wallet address and a unique nonce).
   * Click **Sign** to authenticate your wallet ownership.

**Error Handling**:

* **"Wallet already in use"**: If the selected wallet is already linked to another 4EVERLAND account, you must:
  1. Unlink it from the associated account (if accessible).
  2. Or, use a new wallet address to complete the process.

<figure><img src="/files/OEWp2MTPTX4fnlS2xODg" alt=""><figcaption></figcaption></figure>

### **Step 5: You're All Set!**

1. Once verified, your EVM wallet is successfully linked to your Telegram account.
2. All rewards from aggregator mining will be sent directly to this wallet by mining projects.

<figure><img src="/files/tTr2Wktfu484rPzAhFbf" alt=""><figcaption></figcaption></figure>

## Troubleshooting

| Issue                         | Solution                                                                                     |
| ----------------------------- | -------------------------------------------------------------------------------------------- |
| MetaMask popup doesn't appear | <p>1. Ensure MetaMask extension is enabled and unlocked<br>2. Refresh the 4EVERLAND page</p> |
| "Signature failed" error      | Clear MetaMask cache → Re-sign the verification message                                      |
| Wallet not recognized         | Confirm your wallet is EVM-compatible (supports Ethereum Virtual Machine)                    |
| Rewards not received          | Check wallet transaction history → Contact [4EVERLAND Support](mailto:contact@4everland.org) |

{% hint style="info" %}

### 📞 Support Resources

* **Live Chat**: Join [Discord server](https://discord.com/invite/Cun2VpsdjF) → #Open a ticket
* **Email**: <contact@4everland.org> (include your 4EVERLAND username and wallet address in the subject)
  {% endhint %}