# Mining Guide

{% hint style="warning" %}
Miners operating multiple machines with the same API key should avoid sending multiple requests simultaneously, as this may lead to rate-limiting.
{% endhint %}

Welcome to the Market Compass Subnet 17 Mining Guide! In this guide, you'll learn how to set up and deploy a mining node on Subnet 17 to contribute to the data gathering process for Market Compass. Let's get started:

## **Prerequisites**

Before diving into the mining process, ensure you have the necessary environment variables set up:

1. **MC\_BEARER\_TOKEN:** Bearer token for Twitter Pro API. Export this variable with your X (Twitter) API token.

   ```markup
   export MC_BEARER_TOKEN=AAA...
   ```
2. **MC\_SUBNET\_API\_X\_API\_KEY:** Market Compass API key for validators. Contact us via Discord-ticket on the Subnet 17 Discord Server to obtain a new API key.

   ```markup
   export MC_SUBNET_API_X_API_KEY=<your-api-key>
   ```
3. **MC\_SUBNET\_API\_URL:** URL to the current version of the used API. Set this variable to the appropriate API URL.

   ```markup
   export MC_SUBNET_API_URL=https://api3.subnet.marketcompass.ai
   ```

## **Dependencies**

Ensure you have the necessary dependencies installed. The key dependency is the CommuneX library. You can find the full dependency list in the [requirements.txt](https://github.com/MarketCompassDev/marketcompass-subnet/blob/main/requirements.txt) file. Here are the main dependencies:

* communex
* typer
* uvicorn
* keylimiter
* pydantic-settings

## **Miner Setup**

Follow these steps to set up and register your miner on Subnet 17:

1. **Run Miner:** From the root of your project, run the following command to start the miner:

   ```markup
   comx module serve subnet.miner.model.Miner <name-of-your-com-key> --subnets-whitelist 17 --ip 0.0.0.0 --port 8000
   ```
2. **Register Miner:** Register your miner using the following command:

   ```markup
   comx module register <name-of-your-miner> <name-of-your-com-key> --ip <your-ip-of-the-server> --port 8000 --netuid 17
   ```

## Miner Code

{% embed url="<https://github.com/MarketCompassDev/marketcompass-subnet/blob/main/src/subnet/miner/model.py>" %}
Miner code
{% endembed %}

```python
import os
import requests

from communex.module import Module, endpoint
from communex.key import generate_keypair
from keylimiter import TokenBucketLimiter


class Miner(Module):
    def __init__(self):
        super().__init__()
        self.bearer_token = os.getenv('MC_BEARER_TOKEN')

    @endpoint
    def generate(self, prompt: str, start_time: str = '2024-04-01T5:00:00Z', max_results: int = 50):
        # TODO: pass start_time, max_results from validator
        url = "https://api.twitter.com/2/tweets/search/all"

        def bearer_oauth(r):
            r.headers["Authorization"] = f"Bearer {self.bearer_token}"
            r.headers["User-Agent"] = "v2FullArchiveSearchPython"
            return r

        response = requests.request("GET", url, auth=bearer_oauth, params={
            'query': prompt,
            "max_results": max_results,
            "start_time": start_time,
            "user.fields": "id,username,name",
            "tweet.fields": "created_at,author_id"
        })

        if response.ok:
            tweets = response.json()
            return tweets['data']
        raise Exception(f"Cant get tweets for prompt '{prompt}'")


if __name__ == "__main__":
    from communex.module.server import ModuleServer
    import uvicorn

    key = generate_keypair()
    miner = Miner()
    refill_rate = 1 / 400
    bucket = TokenBucketLimiter(2, refill_rate)
    server = ModuleServer(miner, key, ip_limiter=bucket, subnets_whitelist=[17])
    app = server.get_fastapi_app()

    # Only allow local connections
    uvicorn.run(app, host="0.0.0.0", port=8000)
```

## **Validator Setup**

To validate and register your miner, follow these steps:

1. **Run Validator:** Execute the validator script to initiate validation:

   ```markup
   python3 -m market-compass-subnet.subnet.cli <name-of-your-com-key>
   ```
2. **Register Validator:** Register your validator using the following command:

   ```markup
   comx module register market-compass::<your-vali-name> <name-of-your-com-key> --netuid 17
   ```

## **Further Reading**

For more information and documentation on the Commune AI ecosystem and subnet details, please visit the [Official Commune Page](https://commune.ai/) and its developer documentation.

Congratulations! You've successfully set up and deployed your mining node on Subnet 17. Your contributions will play a crucial role in gathering valuable data for Market Compass, empowering users with actionable insights and intelligence in the cryptocurrency market.


---

# 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.marketcompass.ai/subnet/mining-guide.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.