# Sample App

The Proof of Concept (PoC) app is a simple clicker game, similar to Hamster Combat, designed to showcase the capabilities of t:connect in a fun and interactive way. It demonstrates how blockchain interactions can be seamlessly integrated into a Telegram Mini App.

{% hint style="info" %}
You can play the game in telegram via [@TheT2Earn](https://t.me/TheT2Earnbot)
{% endhint %}

## Game Features

### Main Button Clicking

* Action: Clicking on the main button.
* Effect: Increases the player's balance by a base amount.
* Description: Each click represents a basic action in the game, incrementing your balance.

<div align="center"><figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2FxlCKNcZbGp5OpE8wukT5%2Fhomescreen.PNG?alt=media&#x26;token=c1950e83-73fd-4374-a328-9b7fdab76f22" alt="" width="188"><figcaption><p>home screen</p></figcaption></figure></div>

### Mining Objects

* Action: Clicking on a mining object within the game.
* Effect: Increases the balance automatically every hour.
* Description: Mining objects act as passive income generators, adding to your balance over time without additional clicks.

<div align="center"><figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2Fkj2k7AsYzoAlzIk4A7Rq%2Fmining.PNG?alt=media&#x26;token=acc5beae-e5d7-439f-94f5-00629428fb93" alt="" width="188"><figcaption><p>mining screen</p></figcaption></figure></div>

### Combos

* Action: Achieving certain click sequences or milestones.
* Effect: Provides a one-time significant increase to the balance.
* Description: Combos reward players for active engagement and skillful clicking patterns.

### Referral Links

* Action: Generating and sending a referral link to other Telegram users.
* Effect: The referrer gets rewarded after he has invited 3 friends.
* Description: Encourages users to invite friends, expanding the game's user base organically.
* How to Use:
  * Click on the Referral button.
  * Send the link via Telegram to your contacts.

<figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2FSLtxzwG8GX9rzdCqQ0ib%2Freferral.PNG?alt=media&#x26;token=a0159dc0-2f15-4d2c-8784-0801be27a796" alt="" width="188"><figcaption><p>referral screen</p></figcaption></figure>

### Earn Section

* Action: Clicking on items within the Earn section.
* Effect: Opens a link (e.g., an advertisement or partner site) and increases the balance once per item.
* Description: Provides opportunities to earn extra coins by engaging with sponsored content.

<figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2F9HKQV5bNF25gykA5pdwi%2FEarn.PNG?alt=media&#x26;token=bdca6798-1f56-48a5-9c1c-7ce76a83e4f1" alt="" width="188"><figcaption></figcaption></figure>

### Boost Menue

* Action: Spending balance to purchase boosts.
* Effect:
  * Temporary Boost: Multiplies the effect of the main button clicks by x2 up to 5x for 3600s down to 60s.
  * Permanent Multiplier: Doubles (2x) the effect of main button clicks for the lifetime of the game.
* Description: Allows players to strategically enhance their earning potential through boosts.

<figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2FEZymtEU5FGbscMu0qKiO%2FActiveBoosts.PNG?alt=media&#x26;token=6acf46fe-dd23-4079-8eda-8ad3bae7f246" alt="" width="188"><figcaption><p>boost section</p></figcaption></figure>

### Wallet

* Action: Connect to the wallet
* Description: The @tconnect.io/modal opens and the user can connect to his favorite wallet

<figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2FjxcqRlVjH4m9Jllzwgwb%2FScreenshot%202024-11-05%20at%2009.24.27.png?alt=media&#x26;token=03f455b0-64be-48df-9b01-4489d527c01d" alt="" width="188"><figcaption></figcaption></figure>

## Game Flow

### Starting the Game

{% stepper %}
{% step %}

### Starting the Game

* Open the Mini App within Telegram via [@TheT2Earn](https://t.me/TheT2Earnbot)
* Click Open Game
  {% endstep %}

{% step %}

### Increasing Balance

* Click the main button repeatedly to increase your balance
* Utilize mining objects for passive income
  {% endstep %}

{% step %}

### Enhancing Earnings

* Purchase boosts from the the boosts-menu to multiply your earnings
* Engage in combos for instant balance increases
  {% endstep %}

{% step %}

### Expanding the Game

* Invite friends with referral link
* Explore the Earn section for additional
  {% endstep %}

{% step %}

### Spending Balance

* Use accumulated balance to buy more boosts
* Unlock new mining objects or game features
  {% endstep %}
  {% endstepper %}

## Modals

In the game, modals are used to inform users about important events. For example, when a boost-item is purchased, a modal appears at the top of the screen confirming the action. Similarly, when a task in the "Earn" section is completed successfully, a larger modal provides detailed information about the current status of the action.

<div><figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2FLFgNRX09n5XALcYk7kbv%2Ftask%20completed%20modal.PNG?alt=media&#x26;token=0a3c9acd-2856-4104-bc38-b3d950a3455f" alt="" width="188"><figcaption><p>task completed modal in earn</p></figcaption></figure> <figure><img src="https://15351420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLatHR9KnDhL4wzEAmzFt%2Fuploads%2FAgu3Qr1BXo9LjMlurZX4%2FBoost%20activated%20modal.PNG?alt=media&#x26;token=cb906ab1-55df-47b5-b6e4-df71d257fcea" alt="" width="188"><figcaption><p>boost-item purchased</p></figcaption></figure></div>


---

# 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://t-connect.gitbook.io/t-connect/getting-started/proof-of-concept/sample-app.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.