# 简介 在浏览器中挖 ZEC。基于 BNB Chain。 ## 协议 zponk 把钱包连接、浏览器搜索引擎和证明验证放在同一个挖矿台。打开挖矿台,连接钱包,授权一轮后再开始搜索。 ## 引擎 WebGPU 在兼容的显卡设备上运行搜索。无法使用 WebGPU 时可切换到 CPU 模式。功率调整工作与暂停的比例,不是设备利用率读数。 ## 网络 网页封装使用 BNB Chain 上的 ZEC,链 ID 为 56。其 SHA-256 挑战与 Zcash 原生区块验证无关。 ## 运行示例 文档中的代码是 JavaScript,在 HTTPS 页面的浏览器控制台中运行。每段代码相互独立。示例只检查浏览器能力、读取钱包连接或计算本地数值,不会开启挖矿轮次,也不会提交证明。 SHA-256 示例使用固定的测试输入,不是实时挑战。钱包示例在注入式钱包提供 window.ethereum 时使用它;其他连接方式请用网站的钱包选择器。 ## 相关阅读 - [挖矿台](/docs/mine) - [钱包连接](/docs/wallet) - [浏览器支持](/docs/browser) - [浏览器中的 SHA-256](/docs/sha256) --- # 挖矿台 连接钱包,选择引擎,观察搜索。 ## 连接 打开 /mine,通过钱包选择器连接。提示时切换到 BNB Chain。开始一轮会请求消息签名,这不是代币授权。若拒绝,搜索不会开始。 ## 选择引擎 选 GPU 使用 WebGPU,选 CPU 使用 CPU 搜索。若 GPU 模式拿不到可用的 WebGPU 引擎,挖矿台可能回退到 CPU 并显示提示。仅有设备名称不能证明 WebGPU 可用。 ## 设置功率 挖矿台提供 40、75、100 三档功率。档位越低,批次之间的间隔越长。该值是负载设置,不是 GPU 负载的测量值。点击“停止”结束当前搜索。 ## 读取会话 算力是实测的每秒尝试次数。候选密钥和哈希预览显示当前搜索。本地匹配仍需服务器验证。 这是挖矿台使用的速率格式化函数,以独立的 JavaScript 展示: ```javascript function rateLabel(rate) { if (rate >= 1000) return `${(rate / 1000).toFixed(1)} kH/s`; return `${Math.round(rate)} H/s`; } console.log(rateLabel(200000)); // 200.0 kH/s console.log(rateLabel(850)); // 850 H/s ``` ## 相关阅读 - [性能](/docs/performance) - [故障排除](/docs/troubleshooting) --- # 密钥 绑定钱包的 SHA-256 工作量证明。 ## 挑战 每一轮属于一个钱包,并带有全新的挑战。浏览器搜索候选 nonce,并对编码后的输入做哈希。输入变了,哈希就变;显示的密钥是搜索值,不是钱包私钥。 ## 显示候选值 客户端把 nonce 表示为补零的十六进制文本。这是客户端的格式化函数,用固定示例值演示。它不会创建轮次,也不会提交候选值。 ```javascript const KEY_LENGTH = 40; function nonceKey(nonce) { return nonce.toString(16).padStart(KEY_LENGTH, '0'); } console.log(nonceKey(42)); // 000000000000000000000000000000000000002a ``` ## 寻找匹配 候选值必须满足当前轮次的目标。相同输入总是得到相同哈希。尝试次数再多,也不能保证在某个时间点必然匹配。 ## 验证 挖矿台会把找到的候选值发送去验证。仅有本地哈希不代表这一轮已完成。请看挖矿台状态,等到它确认后,才算这一轮完成。这些是封装的挑战,不是 Zcash 原生区块。 ## 相关阅读 - [浏览器中的 SHA-256](/docs/sha256) --- # 钱包连接 读取所选账户,了解签名提示。 ## 在网站上连接 在挖矿台点击“连接钱包”,选择你的钱包。钱包会询问是否允许本站查看所选账户。开始一轮前,请确认选中的是目标账户。 ## 读取已连接账户 对注入式钱包,eth_accounts 返回已向页面开放的账户,不会请求签名或交易。返回空数组表示该钱包尚未向此页面开放任何账户。 连接后运行。它只读取第一个账户,并在本地打印缩写形式。 ```javascript const provider = window.ethereum; if (!provider?.request) { console.log('请使用网站的钱包选择器。'); } else { try { const accounts = await provider.request({ method: 'eth_accounts' }); const address = accounts[0]; console.log(address ? `${address.slice(0, 6)}…${address.slice(-4)}` : '未连接账户。'); } catch { console.log('钱包连接不可用。'); } } ``` ## 授权一轮 开始一轮会弹出钱包的消息签名提示。请在钱包中查看。挖矿台需要这个签名才能继续。切勿在网站或这些示例中输入助记词或私钥。 ## 更换账户 更换账户前先停止搜索。在网站页头确认新选的账户,再开始新会话。之前账户的连接不等于对另一个钱包的授权。 ## 相关阅读 - [网络](/docs/network) - [以太坊 Provider 规范](https://eips.ethereum.org/EIPS/eip-1193) --- # 网络 网页封装使用 BNB Chain,链 ID 为 56。 ## 检查钱包网络 钱包 API 以十六进制字符串返回链 ID。56 对应 0x38。此示例只读取当前所选网络,不会切换。 ```javascript const provider = window.ethereum; if (!provider?.request) { console.log('请使用网站的钱包选择器。'); } else { try { const chainId = await provider.request({ method: 'eth_chainId' }); console.log(Number(chainId) === 56 ? '已选择 BNB Chain。' : '请在网站中切换到 BNB Chain。'); } catch { console.log('无法读取钱包网络。'); } } ``` ## 在挖矿台切换 如果网站显示“切换到 BNB Chain”,点击该按钮,并在钱包中批准切换网络。若拒绝,可在同一按钮再试一次。 ## 网络单位 该网络的原生币是 BNB。钱包标题栏中的 BNB 余额与封装使用的 ZEC 资产是两回事。只有代币代码不等于合约地址。 ## Zcash 与封装 浏览器为封装搜索 SHA-256 挑战,不验证 Zcash 原生区块,也不取代 Zcash 共识。检查钱包会话时,以网站显示的链为准。 ## 相关阅读 - [钱包连接](/docs/wallet) - [链 ID 规范](https://eips.ethereum.org/EIPS/eip-695) --- # 浏览器支持 检查此浏览器能否提供 WebGPU 设备。 ## 使用 HTTPS WebGPU 和 Web Crypto 需要安全的浏览器上下文。运行示例前请打开 HTTPS 网站。浏览器、操作系统、驱动和设备是否支持,都会影响适配器能否使用。 ## 请求适配器 检查 navigator.gpu 只是第一步。浏览器可能提供该 API,却不返回适配器。此示例请求设备并立即释放,不会启动挖矿任务。 ```javascript if (!window.isSecureContext || !navigator.gpu) { console.log('WebGPU 不可用,请使用 CPU 模式。'); } else { let device; try { const adapter = await navigator.gpu.requestAdapter(); if (!adapter) { console.log('没有 WebGPU 适配器,请使用 CPU 模式。'); } else { device = await adapter.requestDevice(); console.log('WebGPU 设备可用。'); } } catch { console.log('WebGPU 设备不可用,请使用 CPU 模式。'); } finally { device?.destroy(); } } ``` ## CPU 模式 检查失败时,在挖矿台选择 CPU。检查成功只说明此刻能访问设备,不保证算力,也不保证设备在休眠后仍可用。 ## 保持标签页活跃 浏览器转入后台、设备休眠和省电设置都可能中断工作。设备唤醒后,先看挖矿台状态再重新开始。 ## 相关阅读 - [故障排除](/docs/troubleshooting) - [WebGPU 适配器参考](https://developer.mozilla.org/en-US/docs/Web/API/GPU/requestAdapter) --- # 浏览器中的 SHA-256 用浏览器的 Web Crypto API 计算真实的 SHA-256 摘要。 ## 哈希已知输入 这个完整示例对 UTF-8 文本 abc 做哈希。它只用标准浏览器 API,在本地运行。这只是哈希演示,不是挖矿引擎,也不是正式证明。 ```javascript const bytes = new TextEncoder().encode('abc'); const digest = await crypto.subtle.digest('SHA-256', bytes); const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0') ).join(''); const expected = 'ba7816bf8f01cfea414140de5dae2223' + 'b00361a396177a9cb410ff61f20015ad'; if (hex !== expected) throw new Error('SHA-256 校验失败。'); console.log(hex); ``` ## 文本与字节不同 摘要取决于确切的字节。文本 2a 是两个 UTF-8 字节,而十六进制字节 0x2a 只有一个字节。文本编码和二进制编码不能互换。 ```javascript const textBytes = new TextEncoder().encode('2a'); const binaryBytes = new Uint8Array([0x2a]); console.log(Array.from(textBytes)); // [50, 97] console.log(Array.from(binaryBytes)); // [42] ``` ## 读取输出 SHA-256 输出 32 字节。每个字节写成两个十六进制字符,得到 64 个字符的字符串。补零会保留前导零。相同字节总是得到相同摘要。 ## 挖矿请用挖矿台 实际的挖矿台自行管理当前挑战和搜索引擎。这些示例不向挖矿服务发送请求,也不演示开启或完成一轮。 ## 相关阅读 - [密钥](/docs/mine/key) - [Web Crypto digest 参考](https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/digest) --- # 性能 读懂算力,不把它当成设备利用率。 ## 计算速率 算力等于已完成的尝试次数除以所用时间。此示例用两个示意数值计算速率,不会测试设备,也不读取实时挖矿台。 ```javascript function hashesPerSecond(attempts, elapsedMs) { if (!Number.isFinite(attempts) || attempts < 0 || !Number.isFinite(elapsedMs) || elapsedMs <= 0) { throw new RangeError('尝试次数不能为负,耗时必须为正。'); } return attempts / (elapsedMs / 1000); } console.log(hashesPerSecond(500000, 2500)); // 200000 console.log(hashesPerSecond(0, 1000)); // 0 ``` ## 功率是一项设置 挖矿台会在批次之间插入暂停。提高功率只改变工作与休息的比例,不保证 GPU 利用率按比例上升。想让浏览器给其他任务留更多余地,就调低功率。 ## 同条件对比 对比时要保持引擎、功率档位、浏览器和设备状态一致。等启动完成后再读速率。CPU 与 GPU 的结果对应不同的执行路径。 ## 速率不是倒计时 算力衡量的是工作量,不代表有效候选值多久必然出现。其他程序占用显卡、设备休眠和后台标签页都会改变观测到的速率。 ## 相关阅读 - [挖矿台](/docs/mine) - [浏览器支持](/docs/browser) --- # 故障排除 排查挖矿台上的钱包、浏览器和连接问题。 ## 钱包或签名不可用 解锁钱包,检查是否有待处理的提示。没有注入式钱包时,使用网站的选择器。若拒绝了本轮签名,准备好后再点“开始”。确认所选钱包在 BNB Chain 上。 ## WebGPU 不可用 选择 CPU,或在“浏览器支持”页运行设备检查。界面上显示 GPU 名称,不等于 WebGPU 设备检查通过。休眠或显卡重置后,请停止并重新开始搜索。 ## 连接中断 查看挖矿台上的提示。若某一轮正在等待确认,先等状态更新,再重新开始。若挖矿台提示暂时无法开启新一轮,请稍后重试。 此诊断只打印浏览器能力标志。在线标志只是浏览器的提示,不是服务可达性测试。 ```javascript console.table({ secureContext: window.isSecureContext, webGPU: Boolean(navigator.gpu), webCrypto: Boolean(globalThis.crypto?.subtle), onlineHint: navigator.onLine, visible: document.visibilityState === 'visible', injectedWallet: Boolean(window.ethereum?.request), }); ``` ## 报告问题 请附上界面上的完整错误、浏览器版本、所选引擎和复现步骤。通常一张裁剪后的错误截图就够了。报告中不要包含钱包签名、账户信息和浏览器原始存储数据。 ## 相关阅读 - [浏览器支持](/docs/browser) - [钱包连接](/docs/wallet)