@xchainjs/xchain-utxo-providers 2.0.14 → 2.0.16

package/lib/index.esm.js

@@ -1243,6 +1243,31 @@ const getBalance = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey,
         : baseAmount(balanceResponse.balance).plus(balanceResponse.unconfirmedBalance, assetDecimals);
     return balance;
 });
+/**
+ * Get the consensus branch ID for the next block from the Blockbook backend status.
+ *
+ * Returned by Blockbook at its API root as `backend.consensus.nextblock`, a hex string
+ * (e.g. "5437f330"). Used to sign Zcash v5 transactions against the currently active
+ * network upgrade so they remain valid after consensus upgrades.
+ *
+ * @param {string} baseUrl The nownodes blockbook URL (already includes /api/v2).
+ * @returns {number | undefined} The consensus branch ID, or undefined if unavailable.
+ */
+const getConsensusBranchId = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, }) {
+    var _b, _c;
+    const response = yield axios.get(baseUrl, {
+        headers: {
+            'api-key': apiKey,
+        },
+        timeout: 10000, // fail fast so the caller can fall back to the default branch ID
+    });
+    const nextblock = (_c = (_b = response.data.backend) === null || _b === void 0 ? void 0 : _b.consensus) === null || _c === void 0 ? void 0 : _c.nextblock;
+    // A consensus branch ID is a 32-bit value, always exactly 8 hex digits. Reject anything
+    // else rather than risk signing with a malformed branch ID parsed from a partial match.
+    if (!nextblock || !/^[0-9a-fA-F]{8}$/.test(nextblock))
+        return undefined;
+    return parseInt(nextblock, 16);
+});
 const broadcastTx = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, txHex, }) {
     const url = `${baseUrl}/sendtx/${txHex}`;
     const response = yield axios.get(url, {
@@ -1344,6 +1369,19 @@ class NownodesProvider {
             throw Error('Zcash has flat fees. Fee rates not apply');
         });
     }
+    /**
+     * Get the consensus branch ID for the next block from the backend status.
+     * Used to sign Zcash transactions against the active network upgrade.
+     * @returns {number | undefined} The consensus branch ID, or undefined if unavailable.
+     */
+    getConsensusBranchId() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield getConsensusBranchId({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+            });
+        });
+    }
     mapTransactionToTx(rawTx) {
         return {
             asset: this.asset,

package/lib/index.js

@@ -1250,6 +1250,31 @@ const getBalance = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey,
         : xchainUtil.baseAmount(balanceResponse.balance).plus(balanceResponse.unconfirmedBalance, assetDecimals);
     return balance;
 });
+/**
+ * Get the consensus branch ID for the next block from the Blockbook backend status.
+ *
+ * Returned by Blockbook at its API root as `backend.consensus.nextblock`, a hex string
+ * (e.g. "5437f330"). Used to sign Zcash v5 transactions against the currently active
+ * network upgrade so they remain valid after consensus upgrades.
+ *
+ * @param {string} baseUrl The nownodes blockbook URL (already includes /api/v2).
+ * @returns {number | undefined} The consensus branch ID, or undefined if unavailable.
+ */
+const getConsensusBranchId = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, }) {
+    var _b, _c;
+    const response = yield axios__default.default.get(baseUrl, {
+        headers: {
+            'api-key': apiKey,
+        },
+        timeout: 10000, // fail fast so the caller can fall back to the default branch ID
+    });
+    const nextblock = (_c = (_b = response.data.backend) === null || _b === void 0 ? void 0 : _b.consensus) === null || _c === void 0 ? void 0 : _c.nextblock;
+    // A consensus branch ID is a 32-bit value, always exactly 8 hex digits. Reject anything
+    // else rather than risk signing with a malformed branch ID parsed from a partial match.
+    if (!nextblock || !/^[0-9a-fA-F]{8}$/.test(nextblock))
+        return undefined;
+    return parseInt(nextblock, 16);
+});
 const broadcastTx = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, txHex, }) {
     const url = `${baseUrl}/sendtx/${txHex}`;
     const response = yield axios__default.default.get(url, {
@@ -1351,6 +1376,19 @@ class NownodesProvider {
             throw Error('Zcash has flat fees. Fee rates not apply');
         });
     }
+    /**
+     * Get the consensus branch ID for the next block from the backend status.
+     * Used to sign Zcash transactions against the active network upgrade.
+     * @returns {number | undefined} The consensus branch ID, or undefined if unavailable.
+     */
+    getConsensusBranchId() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield getConsensusBranchId({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+            });
+        });
+    }
     mapTransactionToTx(rawTx) {
         return {
             asset: this.asset,

package/lib/providers/nownodes/nownodes-api-types.d.ts

@@ -68,3 +68,11 @@ export type GetAddressInfo = {
 export type BroadcastDTO = {
     result: string;
 };
+export type StatusDTO = {
+    backend: {
+        consensus?: {
+            chaintip: string;
+            nextblock: string;
+        };
+    };
+};

package/lib/providers/nownodes/nownodes-api.d.ts

@@ -47,6 +47,20 @@ export declare const getUTXOs: ({ apiKey, address, baseUrl, isConfirmed, }: {
  * @returns {number}
  */
 export declare const getBalance: ({ apiKey, baseUrl, address, confirmedOnly, assetDecimals, }: BalanceParams) => Promise<BaseAmount>;
+/**
+ * Get the consensus branch ID for the next block from the Blockbook backend status.
+ *
+ * Returned by Blockbook at its API root as `backend.consensus.nextblock`, a hex string
+ * (e.g. "5437f330"). Used to sign Zcash v5 transactions against the currently active
+ * network upgrade so they remain valid after consensus upgrades.
+ *
+ * @param {string} baseUrl The nownodes blockbook URL (already includes /api/v2).
+ * @returns {number | undefined} The consensus branch ID, or undefined if unavailable.
+ */
+export declare const getConsensusBranchId: ({ apiKey, baseUrl, }: {
+    apiKey: string;
+    baseUrl: string;
+}) => Promise<number | undefined>;
 export declare const broadcastTx: ({ apiKey, baseUrl, txHex, }: {
     apiKey: string;
     baseUrl: string;

package/lib/providers/nownodes/nownodes-data-provider.d.ts

@@ -16,6 +16,12 @@ export declare class NownodesProvider implements UtxoOnlineDataProvider {
     getTransactions(params?: TxHistoryParams): Promise<TxsPage>;
     getTransactionData(txId: string): Promise<Tx>;
     getFeeRates(): Promise<FeeRates>;
+    /**
+     * Get the consensus branch ID for the next block from the backend status.
+     * Used to sign Zcash transactions against the active network upgrade.
+     * @returns {number | undefined} The consensus branch ID, or undefined if unavailable.
+     */
+    getConsensusBranchId(): Promise<number | undefined>;
     private mapTransactionToTx;
     private mapUTXOs;
     private getRawTransactions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xchainjs/xchain-utxo-providers",
-  "version": "2.0.14",
+  "version": "2.0.16",
   "license": "MIT",
   "main": "lib/index.js",
   "module": "lib/index.esm.js",
@@ -29,9 +29,9 @@
   },
   "dependencies": {
     "@supercharge/promise-pool": "2.4.0",
-    "@xchainjs/xchain-client": "2.0.13",
+    "@xchainjs/xchain-client": "2.0.14",
     "@xchainjs/xchain-util": "2.0.7",
-    "axios": "1.15.2"
+    "axios": "1.16.1"
   },
   "devDependencies": {
     "axios-mock-adapter": "^2.1.0"