# TECHNICAL SPECIFICATION: SPIRIT STONE BARTER ECONOMY & ANTI-HYPERINFLATION ENGINE
# PROJECT FREEEXILE: DARK MARTIAL ASTRAL 2.5D ARPG
*(Copyright FreeExile Project 2026 - Diátaxis Reference Standard)*

> **Responsible Departments**: Content & Economy R&D (`content_economy_researcher`), Lead Systems Designer (`lead_systems_designer`).  
> **Simulation Engine Core**: [`server/world/economic_simulation_engine.py`](file:///c:/Projects/FreeExile/server/world/economic_simulation_engine.py)  
> **Test Coverage**: 100% Green ([`tests/unit/test_economic_simulation.py`](file:///c:/Projects/FreeExile/tests/unit/test_economic_simulation.py)).

---

## 1. DESIGN OBJECTIVES

The economy in `FreeExile` is built for sustained long-term ARPG progression:
1. **Currencies Double as Crafting Reagents**: Every monetary drop (Primal Bloodstone, Ancient Bone Brand, Nether Bone Spike) has direct functional utility (rerolling, augmenting).
2. **Elimination of Hyperinflation**: Player purchasing power remains stable throughout the 3-month league lifecycle.
3. **Zero Worthless Gold Pressure**: No exponential inflation from junk gold currencies.

---

## 2. THE 4 GRAND CURRENCY SINKS

| Currency Sink | Estimated Burn Share | Execution Mechanism |
| :--- | :--- | :--- |
| **Crafting & Modding Sink** | 75% - 80% | Consuming Primal Bloodstones for affix rerolling, Bone Brands for min-max ranges, and Bone Spikes for slamming. All consumed items are destroyed permanently. |
| **Outcast Bazaar Trade Burn** | 10% - 15% | All successful transactions on the Consignment Vault incur a mandatory 5% tax burned into the void. |
| **Astral Map Device Sink** | 5% - 10% | Slotting spirit stones into the 6-portal Map Device to amplify monster pack density and rare item quantity in endgame instances. |
| **Seasonal Wealth Reset** | 100% after 3 Months | At league conclusion, all shared stash tabs migrate to remove-only tabs in the Forsaken Realm. The new challenge league starts on a clean slate. |

---

## 3. MACROECONOMIC AUTONOMOUS ADJUSTMENT FORMULA

The engine calculates the Sink Efficiency Ratio ($\text{SER}$):
$$\text{SER} = \frac{\text{Total Currency Burned}}{\text{Total Currency Dropped}}$$

- $\text{SER} \ge 0.95$: Market operates in dynamic equilibrium.
- $\text{SER} < 0.70$: Triggers automated anti-inflation measures, scaling up map device activation fees and crafting costs until stabilization.