@ledgerhq/zcash-utils 0.1.4 → 0.2.0

package/index.d.ts

@@ -80,6 +80,14 @@ export interface SyncStats {
 export declare function startSync(params: SyncParams): Promise<TransactionStream>
 /** Returns the current chain tip height from the gRPC endpoint. */
 export declare function getChainTip(grpcUrl: string): Promise<number>
+/**
+ * Find the block height closest to the given Unix timestamp via interpolation search.
+ *
+ * Returns the height of the latest block whose timestamp is ≤ the target.
+ * If the timestamp is before genesis, returns the genesis height.
+ * If the timestamp is after the chain tip, returns the tip height.
+ */
+export declare function findBlockHeight(grpcUrl: string, timestamp: number): Promise<number>
 /**
  * Async iterator over matched shielded transactions.
  *

package/index.js

@@ -310,8 +310,9 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { TransactionStream, startSync, getChainTip } = nativeBinding
+const { TransactionStream, startSync, getChainTip, findBlockHeight } = nativeBinding
 
 module.exports.TransactionStream = TransactionStream
 module.exports.startSync = startSync
 module.exports.getChainTip = getChainTip
+module.exports.findBlockHeight = findBlockHeight

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ledgerhq/zcash-utils",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Native Zcash key derivation and shielded sync — Node.js (NAPI)",
   "main": "index.js",
   "types": "index.d.ts",
@@ -47,6 +47,7 @@
     "cli": "cargo run -q -p zcash-cli",
     "cli:derive": "cargo run -q -p zcash-cli -- derive --help",
     "cli:tip": "cargo run -q -p zcash-cli -- tip --help",
+    "cli:height-at": "cargo run -q -p zcash-cli -- height-at --help",
     "cli:sync": "cargo run -q -p zcash-cli -- sync --help",
     "// ── Node.js validation & benchmarks ───────────────────────────────": "",
     "sync-tx": "tsx examples/sync-tx.node.ts --start-height 1130000 --end-height 1180000",