# Developer Platform

Welcome to your team’s developer platform

<figure><img src="/files/deCEO4b866ierv1nmOyO" alt="" width="375"><figcaption></figcaption></figure>

<h2 align="center">Welcome to Blockminer</h2>

<p align="center"><a href="https://play.blockminer.pro/" class="button primary" data-icon="dice-d4">Lets Play</a> </p>

<p align="center"></p>

{% columns %}
{% column width="50%" %}

<figure><img src="/files/DffzyW0CfMj7ZhPwKMiN" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}

### Learn more about Blockminer

Read guides, watch tutorials, and learn more about working with the developer platform and integrating it with your own stack.

<a href="/spaces/noWkI7AEBMu2SSsIv960" class="button secondary" data-icon="book">Documentation</a>
{% endcolumn %}
{% endcolumns %}

<h2 align="center">Join a community of over 3,000 Players</h2>

<p align="center">Join our Discord community or social media For more information</p>


# Welcome

<figure><img src="/files/1oV9is16XZ6Jx6KLlNkn" alt=""><figcaption></figcaption></figure>

Welcome to **Blockminer**, the first **GameFi Mining Tycoon Simulator** built entirely on the **Solana blockchain**. Blockminer is more than just a game – it is an immersive **play-to-earn ecosystem** where you can roleplay as a professional cryptocurrency miner, manage virtual mining rigs, compete with others, and earn real value through the in-game token **$MINER**.

The vision behind Blockminer is to bring the thrill of cryptocurrency mining into a gamified world. Traditional mining in real life requires expensive equipment, constant energy consumption, and deep technical knowledge. Here in Blockminer, we simulate that entire experience in a fun, accessible, and community-driven way. Every decision you make – from upgrading your rigs, investing in better components, to choosing your mining strategy – will influence your performance in the game economy.

Unlike casual simulation games, Blockminer is deeply connected to blockchain technology:

* All assets are stored and verified on the **Solana network**.
* Every purchase, upgrade, or transfer is secured by **smart contracts**.
* $MINER tokens that you earn in-game can be **converted to SOL** and withdrawn to your personal wallet.

The combination of gaming, blockchain, and DeFi mechanics makes Blockminer unique in the **GameFi (Game + DeFi)** space. Here, gaming is not just entertainment – it’s an opportunity to earn, connect, and grow in a decentralized economy.

In this documentation, you will learn everything about the game: how to start, the different menus, strategies, token utilities, and the future roadmap of Blockminer. Whether you are a casual gamer, a Solana enthusiast, or a DeFi investor, Blockminer has a place for you.

###


# Quickstart

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

Starting your journey in Blockminer is simple but requires a few preparations. Since the game is built on **Solana**, you will need a compatible wallet.

#### Step 1: Prepare Your Wallet

You can use one of the following Solana wallets:

* **Phantom Wallet** – the most popular Solana wallet, available as a browser extension and mobile app.
* **Solflare Wallet** – another trusted Solana wallet with web and mobile versions.

👉 Download Phantom: <https://phantom.app/\\>
👉 Download Solflare: <https://solflare.com/>

After installation, create a wallet and securely back up your **seed phrase**. Remember: Blockminer never stores your private keys. Your wallet is your gateway to the game.

#### Step 2: Connect to the Game

1. Visit the official website: [**https://blockminer.pro**](https://blockminer.pro)
2. Click **Connect Wallet**.
3. Select Phantom or Solflare.
4. Approve the connection in your wallet popup.
5. You will now enter your **personal mining dashboard**.

#### Step 3: Understanding the Game Flow

* Start with a basic mining setup provided in the game.
* Mine **$MINER tokens** automatically through your rig.
* Visit the **Shop** to upgrade your components using either **$MINER** or **SOL**.
* Improve your hashrate and power to earn faster.
* Interact with the community via **Global Chat**.
* Compete with others on the **Leaderboard**.

#### Step 4: Token Conversion

* You can convert your in-game tokens into real value.
* Exchange $MINER ↔ SOL at a fixed rate:\
  **1 SOL = 1,000,000 $MINER**.
* Withdraw SOL to your personal wallet anytime.

Blockminer is designed to be easy to start but strategic to master. Over time, you will learn how to balance mining upgrades, trading decisions, and interaction with other players.


# Miner (Your Mining Stats)

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

The **Miner page** is your dashboard for monitoring the performance of your mining rig. Here you can see:

* **Power (Hashrate)** – the speed at which your rig mines tokens.
* **Efficiency** – how well your rig performs compared to its cost.
* **Output Rate** – how much $MINER you generate per time cycle.

<figure><img src="/files/6gdg8OXT5ZnAGw6phIZ2" alt=""><figcaption></figcaption></figure>

This page gives you a sense of progress. As you invest in new components from the Shop, your stats improve, and you see immediate results in your mining speed.


# Shop (Upgrade Center)

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

The **Shop** is the heart of progression in Blockminer. Here you can purchase and upgrade essential mining components:

* **GPU (Graphics Processing Unit):** Boosts your mining performance moderately. Perfect for early-game strategies.
* **Motherboard:** Expands the number of GPUs or ASICs you can attach.
* **ASIC Miner:** High-power specialized mining machine for maximum performance.
* **Mining Rig Frame:** Allows bigger, more complex mining setups.
* **PSU (Power Supply Unit):** Provides the stability needed for larger rigs.

Every component has different power, speed, and efficiency values. Players can experiment with different setups to find the **best balance** for their strategy. Purchases can be made with **SOL** (real crypto) or **$MINER** (earned in-game).


# Deposit

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

The **Deposit** system allows you to add SOL into your in-game balance. This SOL can then be used to buy items in the Shop or exchanged for $MINER tokens. Deposits are secured by Solana’s fast and low-cost blockchain transactions.


# Transfer Coin

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

With **Transfer**, players can send $MINER to each other. Since Blockminer runs on Solana, transfers happen directly between wallets, meaning you actually own your tokens. This opens possibilities for:

* Trading between players.
* Sending gifts.
* Forming alliances or groups.


# Convert

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

This is one of the most powerful features of Blockminer. The **Convert** page allows you to:

* Convert **$MINER → SOL** to realize your earnings.
* Convert **SOL → $MINER** to top up your in-game balance.

The conversion rate is fixed: **1 SOL = 1,000,000 $MINER**.\
You can also **withdraw SOL** to your personal wallet, making Blockminer not just a game, but a true play-to-


# Board (Leaderboard)

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

Competition is key in Blockminer. The **Leaderboard** shows global rankings of all miners based on:

* Total $MINER earned.
* Mining power and efficiency.
* Speed of progression.

This creates a strong incentive for players to optimize their rigs and strategies.


# Global Chat

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

Mining doesn’t have to be lonely. The **Global Chat** connects all players, allowing you to:

* Discuss strategies.
* Share updates.
* Trade and socialize.

This turns Blockminer into a true **community-driven game**.


# Token Utility ($MINER)

The **$MINER token** is the backbone of the Blockminer ecosystem. It serves multiple purposes:

1. **In-game currency** – buy mining components and upgrades in the Shop.
2. **Play-to-Earn reward** – mine $MINER from your rigs and earn passively.
3. **Peer-to-Peer transfers** – send or receive $MINER from other players.
4. **Conversion to SOL** – turn your in-game rewards into real Solana tokens.
5. **Future governance** – upcoming updates may allow $MINER holders to vote on game features.

This makes $MINER not just a game token, but a true utility coin within the Blockminer economy.

***

### Economy & Strategy

Blockminer is a simulation of **real-world mining economics**. Just like in real life, strategy matters:

* **Early Game Strategy:** Start with affordable GPUs and upgrade gradually.
* **Mid Game Strategy:** Invest in motherboards and rigs to expand capacity.
* **Late Game Strategy:** Switch to ASIC miners for high-speed dominance.

Players must also decide whether to **hold $MINER for future upgrades** or **convert to SOL for profit**. The global leaderboard pushes competition, while the open transfer system allows players to create **alliances or markets**.


# Roadmap

The Blockminer team is committed to continuous innovation. Planned features include:

* **NFT Miner Cards** – collectible mining rigs with rarity traits.
* **Guild System** – team up with friends to mine together.
* **Seasonal Tournaments** – compete in limited-time events for rewards.
* **Marketplace (P2P)** – trade mining components directly with others.
* **Mobile App** – full access on iOS & Android.


# FAQ

**Q: Is Blockminer free to play?**\
A: Yes, everyone starts with a basic rig. However, depositing SOL allows faster progression.

**Q: Can I withdraw my SOL earnings?**\
A: Absolutely. Convert your $MINER into SOL and withdraw to your wallet.

**Q: Is $MINER just for in-game use?**\
A: No, it can be exchanged into SOL, making it valuable beyond the game.

**Q: Is Blockminer safe?**\
A: Yes, all transactions are secured on the Solana blockchain. However, keep your wallet private keys safe.


# Community & Support

Stay connected with the Blockminer community:

* 🌐 Website: [https://play.blockminer.pro](https://play.blockminer.pro/)
* 🐦 Twitter/X: [@Blockminer\_pro](https://x.com/blockminer_pro)
* 💬 Telegram: [Blockminer Community](https://t.me/blockminer_pro)
* 🎮 Discord: Coming Soon


# Developer Platform API

Learn more about documenting APIs in GitBook.

Coming Soon


# Changelog

New updates and improvements

## 📜 Changelog

This page documents all updates, improvements, and fixes released for **Blockminer** starting from **May 2025**. The changelog serves as a transparent record for players and developers to track how the game evolves over time. Updates include new features, economic adjustments, bug fixes, community feedback responses, and roadmap progress.

Blockminer is a **living GameFi ecosystem**, and as such, constant iteration is part of its DNA. By documenting each update, we make sure players stay informed, investors see our progress, and the community knows exactly where the project is heading.

***

### 🔹 May 2025 – Initial Public Release

**Date:** May 12, 2025\
**Version:** v1.0.0

The **first public launch** of Blockminer went live on [**https://blockminer.pro**](https://blockminer.pro). This was the foundation of the project, establishing the core gameplay loop and blockchain integration.

#### ✅ New Features

* **Wallet Login System:** Players can now connect using **Phantom** and **Solflare** wallets.
* **Mining Rig Simulation:** A starter rig is automatically provided to every new player.
* **$MINER Token Rewards:** Mining simulation generates **$MINER tokens** as rewards.
* **Shop v1:** Players can purchase basic items (GPU, motherboard, rig frame, PSU) using **$MINER** or **SOL**.
* **Deposit & Conversion:** SOL deposits enabled for in-game usage, with a fixed rate of **1 SOL = 1,000,000 $MINER**.
* **Transfer System:** Peer-to-peer transfer between wallets integrated.
* **Leaderboard v1:** Displays top 100 miners globally, ranked by hashrate and tokens earned.
* **Global Chat v1:** Real-time chat feature introduced for community discussions.

#### 🐛 Fixes & Stability

* Resolved initial wallet connection errors on Phantom.
* Improved transaction speed via Solana RPC optimization.
* Fixed UI scaling on smaller screens.

#### 🌍 Community Impact

The launch introduced Blockminer to the wider GameFi community. Players were able to roleplay as miners and immediately engage with the economy. The **dual-token system ($MINER and SOL)** proved attractive to both casual players and crypto enthusiasts.

***

### 🔹 June 2025 – Feature Expansion

**Date:** June 20, 2025\
**Version:** v1.1.0

This was the **first major update** after launch, focusing on expanding gameplay depth and improving user experience.

#### ✅ New Features

* **ASIC Miner Component:** A new high-performance mining unit available in the Shop. Designed for mid-to-late game progression.
* **Mining Stats Dashboard:** Players can now see detailed rig performance (power, efficiency, mining rate).
* **Convert Enhancements:** Added **two-way conversion** between $MINER and SOL, with withdrawal to real wallets.
* **Board v2:** Leaderboard expanded to display top 1,000 players with live refresh every 10 minutes.

#### 🐛 Fixes & Improvements

* Optimized Solana transactions to reduce failed deposits.
* Fixed leaderboard display bugs where ties were not properly shown.
* Enhanced Global Chat stability with anti-spam protection.

#### 🌍 Community Impact

This update deepened the competitive aspect of Blockminer. The **ASIC Miner introduction** gave power players new goals to chase, while improved transparency in mining stats helped casual players optimize strategies.

***

### 🔹 July 2025 – Social & Economy Update

**Date:** July 18, 2025\
**Version:** v1.2.0

July focused on **social interaction and refining the in-game economy**.

#### ✅ New Features

* **Friend Transfer Tagging:** Players can now label frequent wallet addresses for easier transfers.
* **Economy Balancing:** Adjusted rewards from GPUs vs. ASICs to maintain fair progression.
* **Global Chat Upgrade:** Emoji reactions, player tagging (@username), and language filter added.
* **Deposit Bonus:** First-time deposits receive a 5% bonus $MINER incentive.

#### 🐛 Fixes & Improvements

* Fixed bug where SOL balance was not updating instantly after conversion.
* Improved Shop UX by adding item stats comparison before purchase.
* Patched minor exploit where multiple conversions could bypass cooldown.

#### 🌍 Community Impact

This update highlighted **community-first improvements**. The introduction of transfer tagging made it easier for guild-like structures to form. The bonus deposit campaign successfully attracted new players and encouraged existing ones to invest more SOL.

***

### 🔹 August 2025 – Competitive Expansion

**Date:** August 25, 2025\
**Version:** v1.3.0

August brought a major **competitive update**, enhancing the leaderboard system and preparing the foundation for tournaments.

#### ✅ New Features

* **Leaderboard Rewards:** Top 50 players now receive weekly $MINER bonuses.
* **Player Profile Pages:** Clicking a name in the leaderboard or chat shows stats and recent activity.
* **Shop Expansion:** Added cooling fans and advanced PSU units.
* **Performance Optimization:** Faster mining calculations and smoother UI.

#### 🐛 Fixes & Improvements

* Fixed issue where transfers occasionally failed during high traffic hours.
* Optimized resource loading, reducing page load time by 40%.
* Patched leaderboard refresh bug.

#### 🌍 Community Impact

The **competitive push** gave high-ranking players recognition and rewards. This encouraged players to optimize rigs further and added prestige to the mining journey. Community excitement around upcoming tournaments started to grow.

***

### 🔹 September 2025 – Roadmap Milestone

**Date:** September 30, 2025\
**Version:** v1.4.0

This update marked the beginning of **long-term roadmap execution**.

#### ✅ New Features

* **NFT Preview (Closed Beta):** Early testing for NFT Miner Cards. Unique rig components with rarity traits.
* **Convert v2:** Now displays a full transaction history for transparency.
* **Community Feedback Hub:** Players can submit ideas directly from the game menu.

#### 🐛 Fixes & Improvements

* Fixed SOL withdrawal bug affecting Phantom wallet users.
* Improved global chat performance.
* Reduced network errors during peak hours.

#### 🌍 Community Impact

By teasing **NFT Miner Cards**, the Blockminer team signaled the transition from basic GameFi mechanics into collectible economies. Transparency and feedback tools improved player trust and satisfaction.

***

### 🔹 October 2025 – Tournament Era

**Date:** October 22, 2025\
**Version:** v1.5.0

October introduced the **first seasonal tournament system**, making Blockminer even more engaging.

#### ✅ New Features

* **Tournament v1:** A 2-week mining competition with rewards in SOL and $MINER.
* **Guild Creation:** Players can now create and join guilds for collective mining power.
* **Enhanced Global Chat:** Dedicated guild chat channels added.
* **Mobile Compatibility Update:** Optimized UI for mobile browsers.

#### 🐛 Fixes & Improvements

* Fixed bug with ranking system in tournaments.
* Reduced conversion transaction fees by 15%.
* Improved shop item descriptions.

#### 🌍 Community Impact

The introduction of tournaments and guilds pushed **Blockminer from solo play into cooperative/competitive gameplay**. This was the most community-celebrated update yet, driving a surge in new users.

***

### 🔹 November 2025 – Future-Ready Patch

**Date:** November 29, 2025\
**Version:** v1.6.0

This update focused on **stability, economy refinement, and preparing for 2026 expansions**.

#### ✅ New Features

* **P2P Marketplace (Beta):** Players can list $MINER or items for trade.
* **Board v3:** Seasonal leaderboards introduced, resetting every 3 months.
* **Enhanced Security:** Added two-step wallet verification for withdrawals.

#### 🐛 Fixes & Improvements

* Fixed minor exploit in conversion cooldown.
* Improved marketplace UI.
* Patched lag issues in global chat.

#### 🌍 Community Impact

The **marketplace beta** laid the foundation for a **true player-driven economy**. Combined with seasonal leaderboards, the game entered a new phase of long-term engagement.

***

### 🔮 Looking Ahead (2026 and Beyond)

The Blockminer team is preparing for the next wave of updates:

* Full **NFT Miner Card** launch.
* Advanced **mobile app** release.
* Expansion of **guild tournaments**.
* Cross-game partnerships with other **Solana GameFi ecosystems**.


# Help Center

<h2 align="center">What can we help you find?</h2>

<p align="center">Browse the topics below or use the GitBook assistant to ask anything you need help with.</p>

<p align="center"><a href="https://gitbook.com/" class="button primary">Contact support</a></p>


