﻿zminer-gpu 0.1.3 Windows 64 位元版 - SCDO Classic Shard1 GPU 礦池挖礦程式
==========================================================================

這是什麼
--------
zminer-gpu 使用 NVIDIA 顯示卡挖 SCDO（zpow 演算法），並將份額（share）提交到
SCDO Classic Shard1 礦池。SCDO 網路自 2021 年上線運行至今。
30x30 行列式運算在 GPU 上執行；每個份額送出前都會再由 CPU 驗算一次，
確保礦池收到的都是經過驗證的份額。

  礦池（Shard1）：stratum+tcp://82.223.19.88:3341
                  （zminer-gpu 的寫法是  -pool 82.223.19.88:3341）
  分配方式：      PPLNS
  付款：          約每 10 分鐘一次，最低付款金額 1 SCDO
  礦池手續費：    依算力分級 - 低於 5 kH/s 為 5%，
                  5 kH/s 以上為 3%，50 kH/s 以上為 1%

歡迎 CPU 礦工一同加入同一個礦池；同一台電腦也可以同時進行 CPU 與 GPU 挖礦。

資料夾內的檔案：
  zminer-gpu.exe      挖礦程式（版本 0.1.3）
  zpowdet.dll         挖礦程式使用的 CUDA 運算函式庫
  cudart64_12.dll     NVIDIA CUDA 執行階段 12.8（見下方「授權說明」）
  start-shard1.bat    啟動檔 - 只需修改一行，然後按兩下執行
  README.txt / README-zh-TW.txt

系統需求
--------
- Windows 10 或 11（64 位元）
- NVIDIA 顯示卡，並安裝支援 CUDA 12.8 的較新驅動程式（版本 570 或更新）。
  支援 RTX 50 系列（Blackwell）。
- 每個挖礦視窗約需 700 MiB 可用顯示記憶體
- 一個用於收款的 SCDO Classic Shard1 錢包地址（由 SCDO 桌面錢包取得）。
  Shard1 地址以 1S01 開頭，長度為 42 個字元。

實測 RTX 5060 Ti：持續礦池運行約 175-210 kH/s（batch 8192），每個執行個體約使用 700 MiB 顯示記憶體。
實際效能依顯示卡、驅動程式與系統而異。

快速開始（3 個步驟）
--------------------
1. 將整個 ZIP 解壓縮到一個資料夾（例如 C:\zminer-gpu）。
   請勿直接在 ZIP 內執行，所有檔案需放在同一個資料夾。
2. 在 start-shard1.bat 上按右鍵 >「編輯」（或用記事本開啟），把這一行：
       set "ADDRESS=<YOUR_SHARD1_ADDRESS>"
   改成您自己的 Shard1 地址（保留雙引號），然後存檔。
3. 按兩下 start-shard1.bat 開始挖礦。

啟動檔實際執行的指令：
  zminer-gpu.exe -pool 82.223.19.88:3341 -user <YOUR_SHARD1_ADDRESS> -worker %COMPUTERNAME% -device 0

如何確認正常運作
----------------
啟動時應該會看到：
  zminer-gpu 0.1.3 - SCDO Classic zpow GPU pool miner
  zpow self-test OK (real shard1 block verified)
  GPU device 0: NVIDIA GeForce ...
  GPU/CPU cross-check OK (4 nonces x 2 heights, bit-exact vs zp.Det)
  ... logged in to 82.223.19.88:3341 as <地址>.<礦機名稱>
  ... new job ... height=... share_diff=...
之後每 15 秒會顯示一行摘要，例如：
  ... hashrate 248000 H/s | batch 8192 | NVIDIA GeForce ... | accepted 12 rejected 0 dropped 0 blocks 1 | up 3m0s
「accepted」（已接受份額）應持續增加。看到「BLOCK accepted by pool!」表示您的
GPU 為礦池找到了一個區塊。區塊切換時出現少量 rejected（過時份額）屬正常現象。
以 {"type":"status" ...} 開頭的行是給程式讀取的狀態資訊，可以忽略。

付款方式
--------
礦池採用 PPLNS：每個區塊獎勵依最近的份額比例分配。
區塊確認後（12 個確認）扣除礦池手續費計入您的餘額；餘額達到 1 SCDO 後，
礦池約每 10 分鐘自動付款到您的 Shard1 地址。可在 SCDO 桌面錢包查看餘額。

停止挖礦
--------
點選挖礦視窗，輸入  stop  後按 Enter（正常停止），或按 Ctrl+C，
或直接關閉視窗。

多張顯示卡
----------
每張顯示卡執行一個視窗。複製 start-shard1.bat（例如另存為
start-shard1-gpu1.bat），並把  set "DEVICE=0"  改為 1、2 依此類推。

疑難排解
--------
- Windows SmartScreen／防毒軟體警告：zminer-gpu.exe 沒有程式碼簽章，
  Windows 可能顯示「Windows 已保護您的電腦」，防毒軟體也可能將其標記或隔離
  （挖礦軟體常被誤判）。請先核對 SHA256（見下方）；確認一致後，點選
  「其他資訊」>「仍要執行」，或在防毒軟體中將此資料夾加入例外。
- 出現「CUDA driver version is insufficient for CUDA runtime version」或
  「no CUDA device」：驅動程式太舊或未安裝。請到 nvidia.com 安裝最新的
  NVIDIA Game Ready／Studio 驅動程式（570 或更新），然後重新開機。
- 出現「zpow GPU library not found」或「LoadLibrary ... zpowdet.dll」：
  請解壓縮整個 ZIP，並將 zminer-gpu.exe、zpowdet.dll、cudart64_12.dll
  放在同一個資料夾。
- 出現「out of memory」或 GPU batch 錯誤（顯示記憶體不足）：關閉遊戲與其他
  使用 GPU 的程式、減少同一張卡上的挖礦視窗數量，或在 start-shard1.bat 的
  zminer-gpu.exe 那一行最後加上  -batch 4096 。
- 出現「CUDA device 1 out of range」：DEVICE 設定過大，第一張顯示卡是 0。
- 出現「login failed」：地址錯誤。請使用 SCDO 桌面錢包中的 Shard1 地址
  （1S01 開頭，42 個字元）。
- 出現「pool connection lost ... reconnecting」：程式會自動重新連線。
  請檢查網路連線或防火牆（需允許對外 TCP 3341 連接埠）。
- 發生錯誤時視窗會停住並等待按鍵，方便您閱讀錯誤訊息。
- 不挖礦的自我檢查：  zminer-gpu.exe -check 32
  離線效能測試：      zminer-gpu.exe -bench 30

驗證下載檔（SHA256）
--------------------
請與下載頁面上 SHA256SUMS.txt 的數值比對。在 PowerShell 中執行：
  Get-FileHash .\zminer-gpu-0.1.3-win64.zip -Algorithm SHA256
或在命令提示字元中執行：
  certutil -hashfile zminer-gpu-0.1.3-win64.zip SHA256

授權說明
--------
cudart64_12.dll 為 NVIDIA CUDA 執行階段（版本 12.8），版權屬 NVIDIA
Corporation 所有。本套件依 NVIDIA CUDA Toolkit 終端使用者授權合約
（https://docs.nvidia.com/cuda/eula/）中的可再散布元件條款，原封不動地附上
此檔案。此檔案不受 SCDO 條款約束，NVIDIA 與本軟體無關聯。
zminer-gpu 原始碼：https://github.com/SCDOLAB/scdowallet
（miner-zpow/zpool，版本 0.1.3）。

本軟體依「現狀」提供，不附帶任何保證。挖礦耗電量大且會使顯示卡升溫，
請注意溫度並自行承擔使用風險。

SCDO Laboratory
