# 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 %}


---

# Agent Instructions: 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:

```
GET https://docs.4everland.org/get-started/quick-start-guide/account/linking-your-evm-wallet-to-4everland-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
