> For the complete documentation index, see [llms.txt](https://health-ai-1.gitbook.io/health-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://health-ai-1.gitbook.io/health-ai/the-healthai-ecosystem/from-movement-to-market-place/how-it-works.md).

# How It Works

HealthAi is designed to reward genuine physical movement while maintaining a secure, cheat-proof ecosystem. Unlike passive trackers, HealthAi uses a Live Session Model to verify user activity in real-time.

####  Secure Wallet Connection

The journey begins by linking a decentralized <mark style="color:purple;">solana</mark> wallet to the HealthAi platform. This creates a secure link between your physical effort and your digital rewards.

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

#### &#x20;Initiating a Live Session

To start earning, users must manually trigger an activity window.

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

* The "Ready for a Session?" Prompt: From the main dashboard, users engage the large action button to enter the Live Record interface.
* Biometric Engagement: The system prepares to sync with on-device sensors specifically for the duration of that session.

#### &#x20;Real-Time "Active-App" Recording

This is the core of HealthAi's integrity protocol. To ensure users are genuinely walking, jogging, or running, the following rules apply:

* Live Record Interface: Once a session starts, a dedicated page tracks "Steps Taken" and "Est. HP" in real-time.
* The Active-Stay Protocol: The HealthAi app must remain open and active throughout the movement.
* Anti-Cheat Logic: If the app is closed or moved to the background, recording pauses. This prevents system manipulation and ensures that data reflects real-time physical commitment.
* On-Device Processing: Step data is processed locally on the device to maintain privacy while ensuring high-fidelity tracking.

#### Stop & Save Settlement

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

Upon completion, the user manually ends the session to secure their earnings.

* Instant Calculation: The total verified steps are converted into HP (Health Points).
* Blockchain Sync: Finalized session data is saved, and earned points are attributed to the user's Interface.

### Summary

* Users register using their Solana address.
* ⁠A unique username is automatically generated from their address.
* ⁠Users click the Play ▶️ button and start walking or exercising while their steps are counted in real time.
* ⁠Steps are converted into HP (100 steps = 1 HP).
* ⁠A daily progress bar and activity feed display their performance.
* ⁠Users can refer friends using their referral links and earn 10 HP per referral.
* ⁠Users can complete social tasks to earn additional points, which the points will be added to their main points for airdrop rewards.

*<mark style="color:$warning;">HealthAi prioritizes your security. By requiring the app to be open, we protect the community from bot-driven activity and ensure that every Health Token in circulation represents real human energy expended</mark>*