> For the complete documentation index, see [llms.txt](https://docs.ni-ka.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ni-ka.fun/monetary/economy.md).

# Economy

NI-KA bridges local arcade progression with on-chain Solana integrations. The primary progression currency is **Galaxy Coins**, which can be earned in-game or bridged via Solana token burns.

***

## 🛒 Shop & Upgrades

Spend your Galaxy Coins in the Shop to increase your ship's stats and buy temporary boosters:

{% stepper %}
{% step %}

### Permanent Lives

Start every run with more buffer lives.

* *Upgrade Limit:* 6 upgrades.
* *Effect:* Brings your starting base lives from **1 to 7**.
* *Cost (per tier):* `[1,000 | 1,500 | 2,000 | 2,500 | 3,000 | 3,500]` Galaxy Coins.
  {% endstep %}

{% step %}

### Permanent Speed

Boosts engine speed.

* *Upgrade Limit:* 10 upgrades.
* *Cost Formula:* {Cost} = ({Current Purchases} + 1) times 2,000$ Galaxy Coins.
  {% endstep %}
  {% endstepper %}

### Run Boosters

Disposable booster charges that activate on starting a run:

{% stepper %}
{% step %}

### Life Booster (+1 Life per run)

* *3 Runs:* 500 Galaxy Coins
* *5 Runs:* 750 Galaxy Coins
* *10 Runs:* 1,200 Galaxy Coins
  {% endstep %}

{% step %}

### Speed Boosters (Lasts for 3 runs)

* *+10% Speed:* 300 Galaxy Coins
* *+35% Speed:* 600 Galaxy Coins
* *+50% Speed:* 1,000 Galaxy Coins
* *+75% Speed:* 1,500 Galaxy Coins
  {% endstep %}
  {% endstepper %}

***

## 🚀 Ship Skins & Passive Stats

Skins grant powerful passive lives and speed bonuses. Regular skins are permanent unlocks, while premium skins are rented for **7 days** (1 week).

| Skin Name       | Cost (Galaxy Coins) | Type       | Extra Lives | Speed Bonus |
| --------------- | ------------------- | ---------- | ----------- | ----------- |
| **Default**     | *Free*              | Starter    | +0          | +0          |
| **Interceptor** | *Sign-in*           | Permanent  | +0          | +1          |
| **Guardian**    | 2,500               | Permanent  | +1          | +0          |
| **Triad**       | 2,500               | Permanent  | +1          | +0          |
| **Crawler**     | 10,000              | Permanent  | +1          | +2          |
| **SMB**         | 2,500               | 7-Day Rent | +2          | +3          |
| **FFF**         | 3,000               | 7-Day Rent | +3          | +3          |
| **DKS**         | 3,500               | 7-Day Rent | +3          | +4          |
| **NI-KA**       | 5,000               | 7-Day Rent | +4          | +5          |

*\*Note: Google authenticated players get the Interceptor skin auto-unlocked for free.*

***

## 🔗 Solana Web3 Token Integration ($NI-KA)

NI-KA features native integration on the Solana Mainnet.

* **$NI-KA Token Mint:** `Hp4BLfhrJdqwPKqNpKa5SZg2xLoZQAyZ7v68VMKwVory`
* **Deterministic Deposit Wallets:** Every registered user is assigned a unique, secure public address derived server-side.

### Token Burn Engine (Premium Multiplier)

Bridge $NI-KA tokens directly into in-game Galaxy Coins through a secure, server-authoritative burn:

* **The Conversion Formula:**

  $$
  \text{Galaxy Coins} = \text{Token Amount} \times \frac{\text{Token Price}}{\text{SOL Price}} \times \text{BASE\_G\_RATE} \times \text{TOKEN\_G\_MULTIPLIER}
  $$
* **Parameters:**
  * **BASE\_G\_RATE:** 20,000 Galaxy Coins per SOL.
  * **TOKEN\_G\_MULTIPLIER (1.5x Bonus):** Converting native $NI-KA tokens grants a **50% bonus** in Galaxy Coins compared to direct SOL donations, rewarding ecosystem participants.
  * **Minimum Burn:** Value must equal at least `0.01 SOL` equivalent.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSDXUiZioifa5JED9jVru%2Fuploads%2FuC26sylYMHTGafUKrnhn%2FBurnTokens.mp4?alt=media&token=941426d4-a9cd-4d93-9736-424f5cf096c2>" %}

***

## 📺 Ad-Supported Sponsor Revives

To support players who prefer not to use Web3 mechanics, the game provides an in-game advertising model:

* **Sponsor Ads:** Dynamic video and end-card integrations from sponsors (e.g. ODINBOT, more to come).
* **The Reward:** Watch a sponsor ad overlay during a run to revive your ship and recover your lives.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ni-ka.fun/monetary/economy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
