# 冷錢包模擬器（Cold Wallet Simulator / CWS） - Canonical: https://ysk.hk/products/cws-cold-wallet-simulator
- English: https://ysk.hk/en/products/cws-cold-wallet-simulator
- Markdown: https://ysk.hk/products/cws-cold-wallet-simulator.md
- Source: https://github.com/yanshekki/ysk-cold-wallet-simulator/
- Play: https://play.google.com/store/apps/details?id=hk.ysk.cws
- App Store: https://apps.apple.com/us/app/cws-cold-wallet-simulator/id6826850492
- APK: https://ysk.hk/downloads/CWS-1.1.7-13.apk
- Package: hk.ysk.cws
- Licence: MIT. Copyright (c) 2026 YSK Limited. https://github.com/yanshekki/ysk-cold-wallet-simulator/blob/main/LICENSE
- Version: 1.1.7 (build 13), from apps/mobile/app.json. GitHub Release v1.1.7 is notes only; no installer attached.
- Publisher: YSK Limited（香港註冊公司）
- macOS Proxy from source: https://github.com/yanshekki/ysk-cold-wallet-simulator/blob/main/docs/proxy-macos.md 冷錢包模擬器是 YSK Limited 出版的手機藍牙模擬器，供開發者及錢包團隊測試與指定 Ledger、Trezor、OneKey 型號的互通。它並非真正的硬件冷錢包，並非安全元件，請視作熱錢包的對等裝置。請勿保管真實資產。Ledger、Trezor 與 OneKey 均未認可本軟件。 ## 功能 1. 當您套用密語時，系統認證之前與之後均會顯示「正在準備錢包…」覆蓋層，以免畫面留白
2. TON SIGN_TX 的 cell 雜湊、SIGN_DATA 明文與 TON Connect 證明已對齊 Ledger 韌體（主機線路一致）
3. 模擬 Ledger／Trezor／OneKey 指定型號（藍牙；Service UUID 對齊官方型號；OneKey 每部裝置使用獨立 GAP 序號）
4. 助記詞永不寫入剪貼簿（已移除無效的複製控制）
5. CWS Proxy：選擇裝置並鎖定藍牙連線，可把手機呈現為 USB HID
6. 二維碼氣隙匯出帳戶／描述符（種子匯出須確認）
7. 文件為專業英文與香港書面語
8. 種子並非絕對安全——詳見保安說明 ## 下載 - Android：請優先使用 Google Play（hk.ysk.cws）。亦可下載 APK：https://ysk.hk/downloads/CWS-1.1.7-13.apk（versionName 1.1.7，versionCode 13）。旁載可能需要允許未知來源。公開版本 1.1.7（組建編號 13）
- iOS：已於 App Store 上架（免費；需 iOS 16.4 或更新；以 iPhone 為主）：https://apps.apple.com/us/app/cws-cold-wallet-simulator/id6826850492。版本 1.1.7。此頁不提供 IPA。
- CWS Proxy macOS（Mac App Store）：即將推出（沒有商店網址）。正等待 Apple 審批才能上架。從原始碼組建見 docs/proxy-macos.md
- CWS Proxy Ubuntu：沒有現成安裝檔。套件 hk.ysk.cws.proxy（amd64 與 arm64，glibc 2.34 或更新：Ubuntu 22.04 與 24.04）須在 Ubuntu 從版本庫組建。此頁與 GitHub Releases 均不附上.deb。組建步驟見 https://ysk.hk/products/cws-cold-wallet-simulator#cws-proxy
- CWS Proxy 其他 Linux：沒有.deb。yarn workspace @cws/native-proxy build 一次後 yarn proxy，並把 apps/proxy/udev/99-cws-uhid.rules 複製到 /etc/udev/rules.d/
- CWS Proxy Windows：沒有現成安裝檔，只可從原始碼組建。Windows 尚未實現虛擬 HID。此頁不提供 AAB、IPA、dmg 或 exe。 ## 型號 - Ledger：Nano X、Flex、Stax、Nano Gen5（藍牙 APDU）
- Trezor：Safe 7（藍牙 THP）
- OneKey：Classic、Classic 1s、Pure、Touch、Pro（V1）；Pro 2、Neo（V2）（藍牙 protobuf）
- OneKey Mini 沒有藍牙，本軟件不予模擬。 ## 鏈表 比特幣（傳統、巢狀 SegWit、原生 SegWit、Taproot）、以太坊及 EVM 路徑、Avalanche、Solana（Ledger 與 Phantom 路徑）、Cosmos、Tron、XRP、Cardano、Polkadot、TON、Aptos、Sui、NEAR、萊特幣、狗狗幣、Stellar、Tezos、BNB Beacon。全文見 README。 ## 界限 種子並非絕對安全。請視作熱錢包的對等裝置。請勿保管真實資產。代理程式不會篩選 APDU。Trezor 相容橋接聽本機連接埠 21325。公開版本以 app.json 的 1.1.7（組建編號 13）為準。1.1.6 的基線仍然適用。CWS Proxy 執行期轉接器沒有改動。 ## FAQ Q: 冷錢包模擬器是甚麼？
A: 冷錢包模擬器（Cold Wallet Simulator，CWS）是 YSK Limited 出版的手機藍牙模擬器，供開發者及錢包團隊測試與指定 Ledger、Trezor 及 OneKey 型號的互通。它並非安全元件，亦並非真正的硬件冷錢包。 Q: 如何下載冷錢包模擬器？
A: Android 現於 Google Play 提供（hk.ysk.cws），公開版本 1.1.7（組建編號 13）。請優先使用 Google Play。亦可下載 APK：https://ysk.hk/downloads/CWS-1.1.7-13.apk（versionName 1.1.7，versionCode 13）；旁載可能需要允許未知來源。iOS 已於 App Store 上架（免費；需 iOS 16.4 或更新；以 iPhone 為主）：https://apps.apple.com/us/app/cws-cold-wallet-simulator/id6826850492。版本 1.1.7。CWS Proxy 的 Mac App Store 即將推出，沒有商店網址，正等待 Apple 審批才能上架；macOS 可按 docs/proxy-macos.md 從原始碼組建。Ubuntu 沒有現成安裝檔。套件 hk.ysk.cws.proxy 須在 Ubuntu 從版本庫組建：corepack enable && corepack prepare yarn@1.22.22 --activate；yarn；yarn workspace @cws/native-proxy build；bash apps/proxy/linux/build-deb.sh；然後安裝該.deb，把帳戶加入 plugdev 後重新登入，執行 cws-proxy（http://127.0.0.1:8788）。其他 Linux 先組建 @cws/native-proxy，再 yarn proxy。步驟見 https://ysk.hk/products/cws-cold-wallet-simulator#cws-proxy。Windows 的 Proxy 沒有現成安裝檔，只可從原始碼組建。此頁不提供 AAB、IPA、dmg 或 exe。 Q: 有沒有 iOS 或 CWS Proxy？
A: 有。iOS 已於 App Store 上架（免費；需 iOS 16.4 或更新；以 iPhone 為主）：https://apps.apple.com/us/app/cws-cold-wallet-simulator/id6826850492。版本 1.1.7。此頁不提供 IPA。CWS Proxy 的 macOS 版（Mac App Store）即將推出，沒有商店網址，正等待 Apple 審批才能上架，可從原始碼組建。Ubuntu／Linux 沒有現成安裝檔，組建步驟見 https://ysk.hk/products/cws-cold-wallet-simulator#cws-proxy（Ubuntu 用 bash apps/proxy/linux/build-deb.sh 組建 hk.ysk.cws.proxy；其他 Linux 用 yarn proxy）。Windows 沒有現成安裝檔，只可從原始碼組建。Windows 尚未實現虛擬 HID。 Q: 冷錢包模擬器是否 MIT？
A: 是。授權為 MIT，版權所有（c）2026 YSK Limited。MIT 並不使本軟件成為安全元件，亦不表示 Ledger、Trezor 或 OneKey 認可本軟件。 Q: 冷錢包模擬器是真正的冷錢包嗎？可否保管真實資金？
A: 並非。它是模擬器，應視作熱錢包的對等裝置，並非安全元件。請勿以它保管真實資產。Ledger、Trezor 與 OneKey 均未認可本軟件。 Q: 種子是否絕對安全？
A: 並非。BIP39 或 SLIP-39 秘密存放於系統安全儲存，但種子並非絕對安全。助記詞刻意永不寫入剪貼簿。 Q: 模擬哪些硬件型號？
A: 以藍牙模擬指定的 Ledger、Trezor 與 OneKey 型號。Service UUID 對齊官方型號；OneKey 每部裝置使用獨立的 GAP 序號。OneKey Mini 沒有藍牙，本軟件不予模擬。 Contact: WhatsApp +852 6160 4242 / email@ysk.hk
