Smart Contracts

🎯 V1.5.0.0 正式合約地址 - 全面升級，正式版本上線

13.1 核心提醒

✅ 最新正式版本：以下為 V1.5.0.0 正式環境的合約地址 (最新部署: 2025-10-08T14:00:00+08:00)。

網路資訊：

• 區塊鏈: Binance Smart Chain (BSC) 主網

• Chain ID: 56

• 區塊瀏覽器: BSCScan

• 起始區塊: 63875238 (V1.5.0.0 正式部署)

• 上線狀態: V1.5.0.0 正式版上線，全系統合約優化完成

13.2 遊戲核心合約

🏰 遊戲核心系統

# 核心治理合約
🏰 遊戲核心 (DungeonCore): 0x1856c492c58d5d8fdb8899a8b134b8668536d043

# 價格與隨機數服務
💎 價格預言機 (PriceOracle): 0xc50d877f3b3aee24f1c96f9626c2f4ce3778dec6
📚 地下城數據 (DungeonStorage): 0xe43fcdc1c9ceb04d830144cbd0abdf1c35d12bc5

🎮 遊戲功能合約

# 地下城探險系統
🏛️ 地下城探險 (DungeonMaster): 0xc9b6e39867f729eda2128c589b96fc797a1328b4

# 英雄升階系統
✨ 英雄升階 (AltarOfAscension): 0x8ee50a6459a01c89095e283d8bac7dcb6c606171

13.3 NFT 資產合約

🦸‍♂️ NFT 資產系統

# 核心遊戲 NFT
⚔️ 英雄 NFT (Hero): 0x9b8ba00e71ebcbb0507a79e1c51073f78c644b1b
🛡️ 神器 NFT (Relic): 0xa4fa309e5fdc8e2cbfd11a9eb762b94ac41b2506

# 組隊系統
👥 隊伍系統 (Party): 0xdf1e4291d671688243752ac52a8ffe7026e131e5

13.4 玩家系統合約

👤 玩家管理系統

# 玩家檔案與 VIP 系統
📊 玩家檔案 (PlayerProfile): 0x0138b3556e620539c35e77a1574f5d0b88d73551
💰 資金庫 (PlayerVault): 0x3029fa9484d75a7d5c9095815adc257bec95f222
🌟 VIP 質押 (VIPStaking): 0x2e6570c9e80f3e9320ac40c9a7c230f9204e729c

# 隨機數服務
🎲 隨機數管理 (VRFManager): 0x137107f995f2ed9061c1acf01dbe9b06179a90f0

13.5 代幣系統合約

🪙 遊戲代幣

# 主要遊戲代幣
💎 SOUL 代幣 (SOUL): 0x7cf14efd392fba909c729ea71c7ee56d48474444

# 穩定幣
💵 USD1 代幣 (USD1): 0x8d0d000ee44948fc98c9b98a4fa4921476f08b0d

代幣說明：

• SOUL: 正式版遊戲代幣，玩家通過探險獲得的主要獎勵

• USD1: 正式版穩定幣，用於價格計算和 VIP 質押

13.6 合約功能對照表

📋 核心功能映射

功能	合約名稱	地址	狀態
英雄鑄造	Hero	0x9b8ba00e71ebcbb0507a79e1c51073f78c644b1b	✅ 主網運行
神器鑄造	Relic	0xa4fa309e5fdc8e2cbfd11a9eb762b94ac41b2506	✅ 主網運行
組隊功能	Party	0xdf1e4291d671688243752ac52a8ffe7026e131e5	✅ 主網運行
地下城探險	DungeonMaster	0xc9b6e39867f729eda2128c589b96fc797a1328b4	✅ 主網運行
英雄升階	AltarOfAscension	0x8ee50a6459a01c89095e283d8bac7dcb6c606171	✅ 主網運行
VIP 質押	VIPStaking	0x2e6570c9e80f3e9320ac40c9a7c230f9204e729c	✅ 主網運行
資金管理	PlayerVault	0x3029fa9484d75a7d5c9095815adc257bec95f222	✅ 主網運行
隨機數服務	VRFManager	0x137107f995f2ed9061c1acf01dbe9b06179a90f0	✅ 主網運行

13.7 安全驗證資訊

🔒 合約安全特性

• 多重簽名: 關鍵操作需要多個管理員確認

• 時間鎖: 重要升級有24-48小時延遲執行

• 緊急暫停: 發現問題時可立即暫停合約功能

• 重入攻擊防護: 所有外部調用使用 ReentrancyGuard

• 權限控制: 使用 OpenZeppelin 的 Ownable 和 AccessControl

🔍 合約驗證狀態

• 源碼驗證: 所有合約源碼已在 BSCScan 上驗證

• 代碼開源: 完整源碼可在 GitHub 上查看

• 審計狀態: V1.3.5 版本正在進行內部測試和安全審查

• 測試階段: 合約功能正在最終測試中，正式上線前將完成優化

13.8 開發者資源

🛠️ 合約交互工具

• BSCScan: 直接在區塊鏈瀏覽器上與合約交互

• MetaMask: 使用錢包直接調用合約函數

• Web3 庫: 使用 ethers.js 或 web3.js 進行程式化交互

• 前端介面: 通過官方遊戲介面進行用戶友好的操作

📚 技術文檔

• ABI 文件: 所有合約的 ABI 文件已同步到前端專案

• 函數說明: 詳細的合約函數說明和參數格式

• 事件定義: 完整的智能合約事件列表

• 整合指南: 第三方開發者整合指南

13.9 網路配置資訊

🌐 BSC 主網配置

// MetaMask 網路配置
Network Name: BSC Mainnet
RPC URL: https://bsc-dataseed1.binance.org/
Chain ID: 56
Currency Symbol: BNB
Block Explorer: https://bscscan.com/

🔗 重要連結

• 官方前端: [SoulboundSaga 遊戲界面]

• BSC 錢包: [MetaMask BSC 配置指南]

• 交易所: [PancakeSwap SOUL/BUSD 交易對]

• 區塊瀏覽器: [BSCScan 合約查看]

13.10 升級計劃

🚀 正式版本路線圖

1. Phase 1: 完成最終測試和安全審計

2. Phase 2: 部署正式版本合約

3. Phase 3: 遷移用戶資料和資產

4. Phase 4: 啟動正式版本遊戲

📊 V1.5.0.0 正式版本亮點

• 合約地址更新: V1.5.0.0 統一切換至正式部署地址（英雄、神器、隊伍、DungeonCore 等全面同步）

• 起始區塊: 63875238（2025-10-08T14:00:00+08:00）全系統一致，子圖與後端已對齊

• 子圖版本: v1.5.0.0（Studio） / v1.5.0.0（Goldsky）搭配三層備援

• 系統重點: VRF V2.5 訂閱模式上線、PlayerProfile ＆ VIP Staking 正式定案、Oracle 價格源改為多節點

⏰ 發展里程碑

• V1.0-v1.5.0.0 測試: 2025 Q3 全部完成

• V1.5.0.0 合約部署: 2025-10-08 ✅ 正式上線 (主網穩定運行)

• 最終審計與效能優化: 2025 Q4 持續進行

• 下一階段內容更新: 預計 2025 Q4 ~ 2026 Q1

---

⚠️ 正式聲明：以上所有合約地址為 V1.5.0.0 正式部署版本，請以官方公告為準並避免與來路不明的合約互動。

技術支援: 如需技術協助或合約交互指導，請參考官方技術文檔或聯絡開發團隊。 安全提醒: 請始終通過官方渠道驗證合約地址的真實性，謹防釣魚攻擊。