# Tokenomics

> **基於智能合約的實際代幣系統** - 與合約實現保持完全一致

## 3.1 代幣資訊

### 💎 主要遊戲代幣

* **代幣名稱**: SOUL (靈魂碎片)
* **代幣符號**: $SOUL
* **總供應量**: 1,000,000,000 SOUL (10億枚)
* **所在區塊鏈**: Binance Smart Chain (BSC)
* **合約地址**: `0x1a98769b8034d400745cc658dc204cd079de36fa` ✅ **已部署**

⚠️ **環境說明**:

* 正式主網使用 `$SOUL` 合約（地址如上），所有金庫與兌換皆以該地址為準。
* 測試/開發環境使用 `TSOUL`，會在 `.env` 及 `contracts/.env` 中以 `TSOUL_ADDRESS` 命名。
* 建議於部署前對照 [`DungeonDelversContracts/README.md`](https://github.com/zhouyongyou/dungeon-delvers-whitepaper/blob/main/DungeonDelversContracts/README.md) 的合約表確保地址一致。

### 💵 輔助測試代幣

* **TUSD1 (測試美元)**: `0x916a2a1eb605e88561139c56af0698de241169f2`
* **功能**: 模擬 USD 穩定幣，用於測試階段的價值錨定

## 3.2 遊戲經濟循環

### 💰 獲得 $SOUL 的方式

#### 🏛️ 地下城探險獎勵

通過成功完成地下城探險獲得固定 USD 價值的 $SOUL 獎勵：

**入門級獎勵**:

* 🪨 新手礦洞: **$6 USD** 等值 $SOUL
* 👹 哥布林洞穴: **$12 USD** 等值 $SOUL
* 🗿 食人魔山谷: **$20 USD** 等值 $SOUL

**進階級獎勵**:

* 🕷️ 蜘蛛巢穴: **$33 USD** 等值 $SOUL
* 🦎 石化蜥蜴沼澤: **$52 USD** 等值 $SOUL
* 💀 巫妖墓穴: **$78 USD** 等值 $SOUL

**專家級獎勵**:

* 🐲 奇美拉之巢: **$113 USD** 等值 $SOUL
* 👹 惡魔前哨站: **$156 USD** 等值 $SOUL
* 🐉 巨龍之巔: **$209 USD** 等值 $SOUL

**大師級獎勵**:

* ⚫ 混沌深淵: **$225 USD** 等值 $SOUL
* 🌀 冥界之門: **$320 USD** 等值 $SOUL
* 🕳️ 虛空裂隙: **$450 USD** 等值 $SOUL

### 💎 $SOUL 的用途

#### 🌟 VIP 質押系統

* **質押 $SOUL** 成為 VIP 玩家
* **VIP 等級** 根據質押數量決定
* **專屬權益** 享有稅率減免和額外獎勵
* **靈活質押** 可隨時增加或減少質押數量

#### ✨ 英雄升階材料

* 升階祭壇需要消耗 BNB 作為手續費
* 消耗低等級 NFT 升級為高等級 NFT
* 升階成功率由智能合約預設
* 失敗時可能返還部分材料

## 3.3 智能金庫系統 (Smart Vault)

### 💰 資金池結構

遊戲資金池由以下部分組成：

1. **玩家鑄造費用**: 英雄和神器鑄造的 BNB 收入
2. **探險手續費**: 地下城探險的 BNB 手續費
3. **升階手續費**: 英雄升階的 BNB 手續費
4. **初始流動性**: 團隊投入的啟動資金

### 🏦 提領機制

* **智能金庫地址**: `0x81dad3af7edcf1026fe18977172fb6e24f3cf7d0`
* **提領稅率**: 根據 VIP 等級和玩家等級動態調整
* **冷卻時間**: 24 小時冷卻期確保遊戲平衡
* **自動轉換**: 系統自動將 USD 價值轉換為等值 $SOUL

### 📊 稅率結構

| VIP 等級 | 玩家等級加成 | 基礎稅率 | 最終稅率範圍 |
| ------ | ------ | ---- | ------ |
| 普通玩家   | 0-5%   | 15%  | 10-15% |
| VIP 1  | 0-5%   | 12%  | 7-12%  |
| VIP 2  | 0-5%   | 10%  | 5-10%  |
| VIP 3+ | 0-5%   | 8%   | 3-8%   |

## 3.4 價格穩定機制

### 📈 動態價格調整

* **價格預言機**: `0xc50d877f3b3aee24f1c96f9626c2f4ce3778dec6`
* **實時餵價**: 獲取 $SOUL/USD 即時價格
* **獎勵錨定**: 所有探險獎勵以 USD 價值計算
* **防通膨設計**: 固定 USD 獎勵確保收益穩定

### 💹 流動性管理

* **交易對**: $SOUL/TUSD1 (測試) → $SOUL/BUSD (正式)
* **流動性提供**: 團隊提供初始流動性
* **價格發現**: 通過 PancakeSwap DEX 進行價格發現
* **滑點控制**: 維持合理的交易深度

## 3.5 經濟永續性設計

### 🔄 代幣循環機制

```
玩家鑄造 NFT (BNB) → 資金池增加
↓
探險獲得 $SOUL 獎勵 ← 智能金庫分發
↓
質押 $SOUL 成為 VIP → 享受更多獎勵
↓
升階消耗低級 NFT → 通縮機制
```

### 📉 通縮設計

* **NFT 銷毀**: 升階失敗時銷毀材料 NFT
* **手續費消耗**: 所有操作收取 BNB 手續費
* **質押鎖定**: VIP 質押減少流通供應
* **稅收機制**: 提領稅收進入財庫

### 🎯 長期可持續性

* **收入多元化**: 鑄造、探險、升階多重收入來源
* **需求驅動**: 遊戲玩法驅動真實的代幣需求
* **價值錨定**: USD 價值錨定確保獎勵穩定性
* **社區治理**: 未來可通過 DAO 調整經濟參數

## 3.6 測試階段經濟

### ⚠️ 當前測試狀態

* **所有合約地址均為測試版本**
* **TSOUL 代幣僅用於測試目的**
* **正式上線前將部署新的正式合約**
* **測試數據不會轉移到正式環境**

### 🚀 正式上線計劃

1. **Phase 1**: 正式合約部署
2. **Phase 2**: 流動性池建立
3. **Phase 3**: 遊戲功能全面上線
4. **Phase 4**: 社區治理系統啟動

***

> **💡 經濟設計核心**：DungeonDelvers 採用「遊戲驅動需求」的經濟模式，所有代幣獲得都需要通過真實的遊戲行為，確保經濟系統的健康和可持續性。

**智能合約**: 所有經濟機制都通過智能合約實現，確保透明和不可篡改。\
**價格穩定**: USD 價值錨定 + 動態調整機制確保玩家收益穩定。
