# @anywalletkit/wallet-zcash 中文文档

规范地址：https://npmcn.com/package/%40anywalletkit/wallet-zcash/

版本：0\.5\.1
npm 元数据更新时间：2026-11-02T20:19:15.020Z
中文译文更新时间：2026-11-06T23:09:48.042Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40anywalletkit/wallet-zcash
原文对照：https://npmcn.com/package/%40anywalletkit/wallet-zcash/?lang=original
项目主页：https://docs.anywallet.tech/
源码仓库：https://github.com/ultratestbro/anywalletkit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：566 kB，19 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-10-24T18:43:33.493Z
- 最新版本发布：2026-11-02T20:19:14.630Z
- 近 30 天下载量：2188（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

任何钱包的Zcash钱包:透明t-地址(BIP-44硬币133),v5交易与ZIP-244签名散列,ZIP-317收费,Blockchair / Blockbook运输. 盾牌池已出范围.

## 安装

```sh
npm install @anywalletkit/wallet-zcash
```

也可以使用：`pnpm add @anywalletkit/wallet-zcash`、`yarn add @anywalletkit/wallet-zcash`、`bun add @anywalletkit/wallet-zcash`

## README

# @anywalletkit/wallet-zcash (英语)

[![npm](https://img.shields.io/npm/v/@anywalletkit/wallet-zcash?label=npm)](https://www.npmjs.com/package/@anywalletkit/wallet-zcash)

兹克什 **透明** 任何钱包的账户——BIP-44 `m/44'/133'/0'/0/i`, (中文(简体) ), `t1…` 地址(透明的接收器Zashi、YWallet、Ledger和Trezor得出) 从同一种子出. 纯 `Uint8Array`, (中文(简体) ), `@noble` 编号 : `@scure` 只在赫尔墨斯跑步.

## 安装

```sh
npm install @anywalletkit/wallet-zcash
# or: pnpm add @anywalletkit/wallet-zcash  ·  yarn add @anywalletkit/wallet-zcash
```

时间: [@anywalletkit/wallet-zcash (英语)](https://www.npmjs.com/package/@anywalletkit/wallet-zcash)发表于 [发布工作流程](https://github.com/ultratestbro/anywalletkit/blob/main/RELEASING.md) 与出处.

```ts
import WalletManagerZcash from '@anywalletkit/wallet-zcash'

const wallet = new WalletManagerZcash(seedPhrase, {
  client: [
    { type: 'blockchair' },                                                   // public, no key
    { type: 'blockbook-http', clientConfig: { url: 'https://zec-blockbook.nownodes.io', headers: { 'api-key': KEY } } },
  ],
  maxFee: 100_000n,                                                           // zatoshi ceiling (default 1 000 000 = 0.01 ZEC)
})
const account = await wallet.getAccount(0)

const preview = await account.describeTransaction({ to: 't1…', value: 5_000_000n })
//   { kind: 'zcash-transfer', version: 5, consensusBranchId, inputs, outputs: [{ role: 'recipient' | 'change' }],
//     fee, conventionalFee, size, lockTime, expiryHeight, txid, warnings }

await account.transfer({ recipient: 't1…', amount: 5_000_000n })             // zatoshis
await account.sendTransaction({ to: 't1…', value: 5_000_000n, fee: 20_000n }) // explicit fee (still ≤ maxFee)
const hex = await account.signTransaction({ to: 't1…', value: 5_000_000n })   // sign only
const max = await account.getMaxSpendable()                                   // sweep amount after fee
wallet.dispose()
```

## 花多少钱

A 类 **v5 交易** (ZIP-225),有透明的投入和产出,为空 树苗/果园捆. 编号和签名散列随同 **ZIP-244号卫星**: 布莱克2b-256 以协商一致分支 id 进行个性化消化,所以签名只在 是用来升级的 树枝 id 是尖端+ 1 时有效的树枝 , 块 交易在(`branchIdForHeight`:NU5 → NU6 → NU6.1 → NU6.3 "Ironwood","Ironwood", (一) 自第3 428 143项起有效),或 `consensusBranchId` 从配置中选择新 升级在软件包学习其 ID 之前激活。 在测试网和测试中 升级在其他高度激活, `consensusBranchId` 需要时间。 期满 提示+ 1 + `expiryDelta`; 没有提示, 无任何签名( 到期交易 0) 永不过期).

收费是 **ZIP-317号卫星**数字 : `5000 zatoshis × max(2, logical actions)`,逻辑动作= `max(⌈Σ input bytes / 150⌉, ⌈Σ output bytes / 34⌉)` 1入2出支出支付 1万扎托什,没有收费市场. 在输入前, 硬币选择是第一 封面金额+收费;546-zatoshi粉尘底下的变化被折叠为收费. `nLockTime` 是尖顶高(反收费狙击)和 `nExpiryHeight` 提示 + 40 (ZIP-203),所以一笔无人记账的交易在一小时内到期,而不是停留.

ZIP-244的实施工作以测试中埋有地雷的主网交易为主: 分析 – 串行对每个链条的往返、txid平等和ECDSA核查 此软件包在摘要上签名 .

## 安全检查

签字前 **财务报告和审定财务报表** 在广播前(也用于呼叫者提供的生六分法): 收费 `maxFee`,产出 输入,一个产出就是要求的接受者 金额和所有其他产出都是我们自己的地址。 警告(不是区块):费用低于 常规收费(节点不得中继),收费额的10%以上,粉尘输出, 没有变化,没有过期.

盾牌目的地被拒绝名称:统一 `u1…`树苗 `zs1…`发芽 `zc…`发送 **改为** 一个有屏蔽的地址和一个需要的有屏蔽的钱包 (注-承诺树同步+验证)——在本包中超出范围.

## 信件签名

`sign(message)` 现金 `signmessage`数字 : `sha256d("\x16Zcash Signed Message:\n" ‖ len ‖ message)`, (中文(简体) ), 标题 `31 + recovery` (压缩键), base64. `verify` 恢复密钥并比较 p2PKH的地址.

## 运输

| `type` | 后端 | 页:1 |
| --- | --- | --- |
| `blockchair` | `https://api.blockchair.com/zcash` | 公开的、CORS的、UTXOs的,包括Mempool、生tx, `push/transaction`; 可选 `key`; 仅主网 |
| `blockbook-http` | 任何 Zcash 块簿(NOWNodes) `zec-blockbook.nownodes.io`(自主办) | `/api/v2/{address,utxo,tx,sendtx}`· ; `headers` aPI 密钥; 测试网也 |

列表按顺序失败; 节点 _拒绝_ 广播为最后(未在 除非它之前的终点没有回答。 广播没有 确定答案( 无响应、 超时、 5xx、 HTML 502) 抛出 `BroadcastUnknownError` (单位:千美元)`maybeSent`, (中文(简体) ), `hash` = 发送前计算 txid : do 别再花硬币了 "已入"中"/"区块链"回"txid".

## 活动历史

`createZcashHistory()` (从) `@anywalletkit/wallet-zcash/history`是一个 `HistorySource` a. 块椅上方:一项交易=所有者方向的一次本土转让; 被屏蔽的腿只作为进入或离开的透明值出现.

## 常见问题

### @anywalletkit/wallet-zcash 是什么？

任何钱包的Zcash钱包:透明t-地址\(BIP-44硬币133\),v5交易与ZIP-244签名散列,ZIP-317收费,Blockchair / Blockbook运输\. 盾牌池已出范围\.

### 如何安装 @anywalletkit/wallet-zcash？

在项目目录运行 npm install @anywalletkit/wallet-zcash，或使用 pnpm add / yarn add / bun add。

### @anywalletkit/wallet-zcash 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @anywalletkit/wallet-zcash 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @anywalletkit/wallet-zcash 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @anywalletkit/wallet-zcash 可以商用吗？

@anywalletkit/wallet-zcash 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @anywalletkit/wallet-zcash 的下载量有多少？

根据 npm 官方下载统计，@anywalletkit/wallet-zcash 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,188 次，日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @anywalletkit/wallet-zcash 还在维护吗？

最新版本 0\.5\.1 发布于 2026/11/03（5 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/10/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。