@ledgerhq/zcash-utils 2.5.1 → 2.6.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @ledgerhq/zcash-utils
 
+## 2.6.0
+
+### Minor Changes
+
+- 841b576: Transactions now target the next block (tip + 1) instead of anchor + 40, keep the builder's expiry, and cap it below the next network upgrade known to the bundled consensus parameters (none is pending on mainnet or testnet with this release; NU7 is covered once its heights ship). A craft whose capped expiry would leave fewer than 8 blocks (zcashd's 3-block expiring-soon rule plus 5 blocks for signing on the device) is refused with an error containing `expiry too close to activation`. An explicit `anchorHeight` above the chain tip is rejected, and the chain tip is now queried even when `anchorHeight` is given.
+
+### Patch Changes
+
+- 378e859: Widen the shard-0 scan-width safety limit so that two years of chain growth still pass at NU7's 25-second block spacing, while a scan started from genesis is still refused.
+
 ## 2.5.1
 
 ### Patch Changes

package/index.d.ts

@@ -261,6 +261,11 @@ export interface BuildTransactionParams {
   /** Transparent (P2PKH) UTXOs to spend. Empty for Private→* flows. */
   transparentInputs: Array<TransparentInputJs>
   outputs: Array<OutputRequestJs>
+  /**
+   * Explicit anchor height; omitted → `tip − 10`. An explicit height above the
+   * tip is rejected. The transaction always targets the next block, `tip + 1`,
+   * so the chain tip is queried in either case.
+   */
   anchorHeight?: number
 }
 export interface BuildTransactionResult {
@@ -272,7 +277,7 @@ export interface BuildTransactionResult {
   pcztHex: string
   /** Decimal fee in zatoshis. */
   feeZat: string
-  /** Block height the Merkle paths were computed against. */
+  /** Block height the Merkle paths were computed against (the resolved anchor). */
   anchorHeight: number
   /** Orchard action count after dummy padding. */
   nActionsOrchard: number
@@ -349,6 +354,11 @@ export interface BuildIronwoodTransactionParams {
   /** Transparent (P2PKH) UTXOs to spend. Empty for Ironwood→* flows. */
   transparentInputs: Array<TransparentInputJs>
   outputs: Array<IronwoodOutputRequestJs>
+  /**
+   * Explicit anchor height; omitted → `tip − 10`. An explicit height above the
+   * tip is rejected. The transaction always targets the next block, `tip + 1`,
+   * so the chain tip is queried in either case.
+   */
   anchorHeight?: number
 }
 export interface BuildIronwoodTransactionResult {
@@ -361,7 +371,7 @@ export interface BuildIronwoodTransactionResult {
   pcztHex: string
   /** Decimal fee in zatoshis. */
   feeZat: string
-  /** Block height the Merkle paths were computed against. */
+  /** Block height the Merkle paths were computed against (the resolved anchor). */
   anchorHeight: number
   /** Ironwood action count after dummy padding. */
   nActionsIronwood: number

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ledgerhq/zcash-utils",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "description": "Native Zcash key derivation and shielded sync — Node.js (NAPI)",
   "main": "index.js",
   "types": "index.d.ts",