> For the complete documentation index, see [llms.txt](https://casefun.gitbook.io/casefun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://casefun.gitbook.io/casefun/mechanics-token-asset-upgrader.md).

# Mechanics: Token Asset Upgrader

## ⬆️ Token Asset Upgrader

The **Token Asset Upgrader** is an interactive retention module on CaseFun that enables users to trade lower-value token balances or recent case drops for a chance to upgrade them into significantly higher-value token rewards or larger token quantities based on customizable risk multipliers.

By turning small or leftover token holdings into high-stakes upgrade attempts, the Upgrader serves as a powerful deflationary token sink and liquidity recycling mechanism.

***

### ⚙️ How the Upgrader Works

<figure><img src="https://3846067308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXVg3TFaAQ9m2NpLh5tl%2Fuploads%2FXZWODBkgTiizgjEVpg7M%2F%D0%90%D0%BF%D0%B3%D1%80%D0%B5%D0%B9%D0%B4.png?alt=media&amp;token=4318546c-90c8-4f93-a9bd-f535c031aa31" alt=""><figcaption></figcaption></figure>

1. **Select Input Tokens:** The user chooses a specific token quantity from their wallet or case drop inventory.
2. **Set Target Multiplier:** The user selects a desired multiplier or specifies a custom target token amount.
3. **Dynamic Chance Calculation:** The mathematical model automatically calculates the exact mathematical probability of success based on the selected target multiplier and platform fee parameters.
4. **Roll & Resolution:** The user executes the upgrade attempt governed by CaseFun's **Provably Fair** randomness engine:
   * **Success Outcome:** The user receives the upgraded target token amount directly in their inventory/wallet.
   * **Fail Outcome:** The input tokens are forfeited, feeding into the platform's deflationary ecosystem.

***

### 📐 Probability & Mathematical Model

The win probability is computed dynamically in real time to ensure total statistical fairness:

**Win Chance (%) = (Input Value / Target Value) \* 100%**

#### Multiplier & Win Rate Matrix Example:

| Target Multiplier | Theoretical Win Rate | Adjusted Win Rate | Risk Profile          |
| ----------------- | -------------------- | ----------------- | --------------------- |
| **1.2x**          | 83.33%               | **\~83.3%**       | Low Risk              |
| **2.0x**          | 50.00%               | **\~50.0%**       | Balanced / Even Money |
| **5.0x**          | 20.00%               | **\~20.0%**       | Medium-High Risk      |
| **10.0x**         | 10.00%               | **\~10.0%**       | High Risk             |
| **50.0x**         | 2.00%                | **\~2.00%**       | Moonshot Tier         |

***

### 🎯 Strategic Benefits for Ecosystems & Creators

* **Eliminates "Dust" Balances:** Users can aggregate small, low-value token balances and upgrade them into meaningful holdings rather than letting them sit idle.
* **Protocol Sustainability & Treasury Retention:** Unsuccessful upgrade attempts route forfeited assets into protocol treasury and liquidity reserves, supporting ongoing operations and system efficiency.
* **Flexible Player Strategies:** Accommodates both conservative players seeking small steady gains (1.2x–1.5x) and high-risk traders aiming for massive multipliers (10x–100x+).


---

# 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://casefun.gitbook.io/casefun/mechanics-token-asset-upgrader.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.