@wopr-network/platform-core 1.32.0 → 1.34.0

package/dist/billing/crypto/btc/address-gen.d.ts

@@ -1,8 +1,19 @@
+/** Supported UTXO chains for bech32 address derivation. */
+export type UtxoChain = "bitcoin" | "litecoin";
+/** Supported network types. */
+export type UtxoNetwork = "mainnet" | "testnet" | "regtest";
 /**
- * Derive a native segwit (bech32, bc1q...) BTC address from an xpub at a given index.
+ * Derive a native segwit (bech32) deposit address from an xpub at a given index.
+ * Works for BTC (bc1q...) and LTC (ltc1q...) — same HASH160 + bech32 encoding.
  * Path: xpub / 0 / index (external chain).
  * No private keys involved.
  */
-export declare function deriveBtcAddress(xpub: string, index: number, network?: "mainnet" | "testnet" | "regtest"): string;
-/** Derive the BTC treasury address (internal chain, index 0). */
-export declare function deriveBtcTreasury(xpub: string, network?: "mainnet" | "testnet" | "regtest"): string;
+export declare function deriveAddress(xpub: string, index: number, network?: UtxoNetwork, chain?: UtxoChain): string;
+/** Derive the treasury address (internal chain, index 0). */
+export declare function deriveTreasury(xpub: string, network?: UtxoNetwork, chain?: UtxoChain): string;
+/** @deprecated Use `deriveAddress` instead. */
+export declare const deriveBtcAddress: typeof deriveAddress;
+/** @deprecated Use `deriveTreasury` instead. */
+export declare const deriveBtcTreasury: typeof deriveTreasury;
+/** Validate that a string is an xpub (not xprv). */
+export declare function isValidXpub(key: string): boolean;

package/dist/billing/crypto/btc/address-gen.js

@@ -2,33 +2,56 @@ import { ripemd160 } from "@noble/hashes/legacy.js";
 import { sha256 } from "@noble/hashes/sha2.js";
 import { bech32 } from "@scure/base";
 import { HDKey } from "@scure/bip32";
+/** Bech32 HRP (human-readable part) by chain and network. */
+const BECH32_PREFIX = {
+    bitcoin: { mainnet: "bc", testnet: "tb", regtest: "bcrt" },
+    litecoin: { mainnet: "ltc", testnet: "tltc", regtest: "rltc" },
+};
+function getBech32Prefix(chain, network) {
+    return BECH32_PREFIX[chain][network];
+}
 /**
- * Derive a native segwit (bech32, bc1q...) BTC address from an xpub at a given index.
+ * Derive a native segwit (bech32) deposit address from an xpub at a given index.
+ * Works for BTC (bc1q...) and LTC (ltc1q...) — same HASH160 + bech32 encoding.
  * Path: xpub / 0 / index (external chain).
  * No private keys involved.
  */
-export function deriveBtcAddress(xpub, index, network = "mainnet") {
+export function deriveAddress(xpub, index, network = "mainnet", chain = "bitcoin") {
     if (!Number.isInteger(index) || index < 0)
         throw new Error(`Invalid derivation index: ${index}`);
     const master = HDKey.fromExtendedKey(xpub);
     const child = master.deriveChild(0).deriveChild(index);
     if (!child.publicKey)
         throw new Error("Failed to derive public key");
-    // HASH160 = RIPEMD160(SHA256(compressedPubKey))
     const hash160 = ripemd160(sha256(child.publicKey));
-    // Bech32 encode: witness version 0 + 20-byte hash
-    const prefix = network === "mainnet" ? "bc" : "tb";
+    const prefix = getBech32Prefix(chain, network);
     const words = bech32.toWords(hash160);
     return bech32.encode(prefix, [0, ...words]);
 }
-/** Derive the BTC treasury address (internal chain, index 0). */
-export function deriveBtcTreasury(xpub, network = "mainnet") {
+/** Derive the treasury address (internal chain, index 0). */
+export function deriveTreasury(xpub, network = "mainnet", chain = "bitcoin") {
     const master = HDKey.fromExtendedKey(xpub);
     const child = master.deriveChild(1).deriveChild(0); // internal chain
     if (!child.publicKey)
         throw new Error("Failed to derive public key");
     const hash160 = ripemd160(sha256(child.publicKey));
-    const prefix = network === "mainnet" ? "bc" : "tb";
+    const prefix = getBech32Prefix(chain, network);
     const words = bech32.toWords(hash160);
     return bech32.encode(prefix, [0, ...words]);
 }
+/** @deprecated Use `deriveAddress` instead. */
+export const deriveBtcAddress = deriveAddress;
+/** @deprecated Use `deriveTreasury` instead. */
+export const deriveBtcTreasury = deriveTreasury;
+/** Validate that a string is an xpub (not xprv). */
+export function isValidXpub(key) {
+    if (!key.startsWith("xpub"))
+        return false;
+    try {
+        HDKey.fromExtendedKey(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/billing/crypto/btc/index.d.ts

@@ -1,4 +1,5 @@
-export { deriveBtcAddress, deriveBtcTreasury } from "./address-gen.js";
+export type { UtxoChain, UtxoNetwork } from "./address-gen.js";
+export { deriveAddress, deriveBtcAddress, deriveBtcTreasury, deriveTreasury } from "./address-gen.js";
 export type { BtcCheckoutDeps, BtcCheckoutResult } from "./checkout.js";
 export { createBtcCheckout, MIN_BTC_USD } from "./checkout.js";
 export { centsToSats, loadBitcoindConfig, satsToCents } from "./config.js";

package/dist/billing/crypto/btc/index.js

@@ -1,4 +1,4 @@
-export { deriveBtcAddress, deriveBtcTreasury } from "./address-gen.js";
+export { deriveAddress, deriveBtcAddress, deriveBtcTreasury, deriveTreasury } from "./address-gen.js";
 export { createBtcCheckout, MIN_BTC_USD } from "./checkout.js";
 export { centsToSats, loadBitcoindConfig, satsToCents } from "./config.js";
 export { settleBtcPayment } from "./settler.js";

package/dist/fleet/init-fleet-updater.d.ts

@@ -40,6 +40,8 @@ export interface FleetUpdaterConfig {
     configRepo?: ITenantUpdateConfigRepository;
     /** Optional fleet event emitter. When provided, bot.updated / bot.update_failed events are emitted. */
     eventEmitter?: FleetEventEmitter;
+    /** Called with manual-mode tenant IDs when a new image is available but they are excluded from rollout. */
+    onManualTenantsSkipped?: (tenantIds: string[]) => void;
 }
 export interface FleetUpdaterHandle {
     poller: ImagePoller;

package/dist/fleet/init-fleet-updater.js

@@ -30,7 +30,7 @@ import { VolumeSnapshotManager } from "./volume-snapshot-manager.js";
  * @param config - Optional pipeline configuration
  */
 export function initFleetUpdater(docker, fleet, profileStore, profileRepo, config = {}) {
-    const { strategy: strategyType = "rolling-wave", strategyOptions, snapshotDir = "/data/fleet/snapshots", onBotUpdated, onRolloutComplete, configRepo, eventEmitter: configEventEmitter, } = config;
+    const { strategy: strategyType = "rolling-wave", strategyOptions, snapshotDir = "/data/fleet/snapshots", onBotUpdated, onRolloutComplete, configRepo, eventEmitter: configEventEmitter, onManualTenantsSkipped, } = config;
     const emitter = configEventEmitter ?? new FleetEventEmitter();
     const poller = new ImagePoller(docker, profileStore);
     const updater = new ContainerUpdater(docker, profileStore, fleet, poller);
@@ -42,17 +42,36 @@ export function initFleetUpdater(docker, fleet, profileStore, profileRepo, confi
         strategy,
         getUpdatableProfiles: async () => {
             const profiles = await profileRepo.list();
-            const nonManualPolicy = profiles.filter((p) => p.updatePolicy !== "manual");
-            if (!configRepo)
+            // Separate profiles by updatePolicy
+            const manualPolicyIds = [];
+            const nonManualPolicy = profiles.filter((p) => {
+                if (p.updatePolicy === "manual") {
+                    manualPolicyIds.push(p.tenantId);
+                    return false;
+                }
+                return true;
+            });
+            if (!configRepo) {
+                if (manualPolicyIds.length > 0 && onManualTenantsSkipped) {
+                    onManualTenantsSkipped([...new Set(manualPolicyIds)]);
+                }
                 return nonManualPolicy;
+            }
             // Filter out tenants whose per-tenant config is set to manual
+            const configManualIds = [];
             const results = await Promise.all(nonManualPolicy.map(async (p) => {
                 const tenantCfg = await configRepo.get(p.tenantId);
                 // If tenant has an explicit config with mode=manual, exclude
-                if (tenantCfg && tenantCfg.mode === "manual")
+                if (tenantCfg && tenantCfg.mode === "manual") {
+                    configManualIds.push(p.tenantId);
                     return null;
+                }
                 return p;
             }));
+            const allManualIds = [...manualPolicyIds, ...configManualIds];
+            if (allManualIds.length > 0 && onManualTenantsSkipped) {
+                onManualTenantsSkipped([...new Set(allManualIds)]);
+            }
             return results.filter((p) => p !== null);
         },
         onBotUpdated: (result) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/platform-core",
-  "version": "1.32.0",
+  "version": "1.34.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/billing/crypto/btc/address-gen.ts

@@ -3,15 +3,33 @@ import { sha256 } from "@noble/hashes/sha2.js";
 import { bech32 } from "@scure/base";
 import { HDKey } from "@scure/bip32";
 
+/** Supported UTXO chains for bech32 address derivation. */
+export type UtxoChain = "bitcoin" | "litecoin";
+
+/** Supported network types. */
+export type UtxoNetwork = "mainnet" | "testnet" | "regtest";
+
+/** Bech32 HRP (human-readable part) by chain and network. */
+const BECH32_PREFIX = {
+  bitcoin: { mainnet: "bc", testnet: "tb", regtest: "bcrt" },
+  litecoin: { mainnet: "ltc", testnet: "tltc", regtest: "rltc" },
+} as const;
+
+function getBech32Prefix(chain: UtxoChain, network: UtxoNetwork): string {
+  return BECH32_PREFIX[chain][network];
+}
+
 /**
- * Derive a native segwit (bech32, bc1q...) BTC address from an xpub at a given index.
+ * Derive a native segwit (bech32) deposit address from an xpub at a given index.
+ * Works for BTC (bc1q...) and LTC (ltc1q...) — same HASH160 + bech32 encoding.
  * Path: xpub / 0 / index (external chain).
  * No private keys involved.
  */
-export function deriveBtcAddress(
+export function deriveAddress(
   xpub: string,
   index: number,
-  network: "mainnet" | "testnet" | "regtest" = "mainnet",
+  network: UtxoNetwork = "mainnet",
+  chain: UtxoChain = "bitcoin",
 ): string {
   if (!Number.isInteger(index) || index < 0) throw new Error(`Invalid derivation index: ${index}`);
 
@@ -19,23 +37,37 @@ export function deriveBtcAddress(
   const child = master.deriveChild(0).deriveChild(index);
   if (!child.publicKey) throw new Error("Failed to derive public key");
 
-  // HASH160 = RIPEMD160(SHA256(compressedPubKey))
   const hash160 = ripemd160(sha256(child.publicKey));
-
-  // Bech32 encode: witness version 0 + 20-byte hash
-  const prefix = network === "mainnet" ? "bc" : "tb";
+  const prefix = getBech32Prefix(chain, network);
   const words = bech32.toWords(hash160);
   return bech32.encode(prefix, [0, ...words]);
 }
 
-/** Derive the BTC treasury address (internal chain, index 0). */
-export function deriveBtcTreasury(xpub: string, network: "mainnet" | "testnet" | "regtest" = "mainnet"): string {
+/** Derive the treasury address (internal chain, index 0). */
+export function deriveTreasury(xpub: string, network: UtxoNetwork = "mainnet", chain: UtxoChain = "bitcoin"): string {
   const master = HDKey.fromExtendedKey(xpub);
   const child = master.deriveChild(1).deriveChild(0); // internal chain
   if (!child.publicKey) throw new Error("Failed to derive public key");
 
   const hash160 = ripemd160(sha256(child.publicKey));
-  const prefix = network === "mainnet" ? "bc" : "tb";
+  const prefix = getBech32Prefix(chain, network);
   const words = bech32.toWords(hash160);
   return bech32.encode(prefix, [0, ...words]);
 }
+
+/** @deprecated Use `deriveAddress` instead. */
+export const deriveBtcAddress = deriveAddress;
+
+/** @deprecated Use `deriveTreasury` instead. */
+export const deriveBtcTreasury = deriveTreasury;
+
+/** Validate that a string is an xpub (not xprv). */
+export function isValidXpub(key: string): boolean {
+  if (!key.startsWith("xpub")) return false;
+  try {
+    HDKey.fromExtendedKey(key);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/billing/crypto/btc/index.ts

@@ -1,4 +1,5 @@
-export { deriveBtcAddress, deriveBtcTreasury } from "./address-gen.js";
+export type { UtxoChain, UtxoNetwork } from "./address-gen.js";
+export { deriveAddress, deriveBtcAddress, deriveBtcTreasury, deriveTreasury } from "./address-gen.js";
 export type { BtcCheckoutDeps, BtcCheckoutResult } from "./checkout.js";
 export { createBtcCheckout, MIN_BTC_USD } from "./checkout.js";
 export { centsToSats, loadBitcoindConfig, satsToCents } from "./config.js";

package/src/fleet/init-fleet-updater.ts

@@ -39,6 +39,8 @@ export interface FleetUpdaterConfig {
   configRepo?: ITenantUpdateConfigRepository;
   /** Optional fleet event emitter. When provided, bot.updated / bot.update_failed events are emitted. */
   eventEmitter?: FleetEventEmitter;
+  /** Called with manual-mode tenant IDs when a new image is available but they are excluded from rollout. */
+  onManualTenantsSkipped?: (tenantIds: string[]) => void;
 }
 
 export interface FleetUpdaterHandle {
@@ -79,6 +81,7 @@ export function initFleetUpdater(
     onRolloutComplete,
     configRepo,
     eventEmitter: configEventEmitter,
+    onManualTenantsSkipped,
   } = config;
 
   const emitter = configEventEmitter ?? new FleetEventEmitter();
@@ -94,19 +97,43 @@ export function initFleetUpdater(
     strategy,
     getUpdatableProfiles: async () => {
       const profiles = await profileRepo.list();
-      const nonManualPolicy = profiles.filter((p) => p.updatePolicy !== "manual");
 
-      if (!configRepo) return nonManualPolicy;
+      // Separate profiles by updatePolicy
+      const manualPolicyIds: string[] = [];
+      const nonManualPolicy = profiles.filter((p) => {
+        if (p.updatePolicy === "manual") {
+          manualPolicyIds.push(p.tenantId);
+          return false;
+        }
+        return true;
+      });
+
+      if (!configRepo) {
+        if (manualPolicyIds.length > 0 && onManualTenantsSkipped) {
+          onManualTenantsSkipped([...new Set(manualPolicyIds)]);
+        }
+        return nonManualPolicy;
+      }
 
       // Filter out tenants whose per-tenant config is set to manual
+      const configManualIds: string[] = [];
       const results = await Promise.all(
         nonManualPolicy.map(async (p) => {
           const tenantCfg = await configRepo.get(p.tenantId);
           // If tenant has an explicit config with mode=manual, exclude
-          if (tenantCfg && tenantCfg.mode === "manual") return null;
+          if (tenantCfg && tenantCfg.mode === "manual") {
+            configManualIds.push(p.tenantId);
+            return null;
+          }
           return p;
         }),
       );
+
+      const allManualIds = [...manualPolicyIds, ...configManualIds];
+      if (allManualIds.length > 0 && onManualTenantsSkipped) {
+        onManualTenantsSkipped([...new Set(allManualIds)]);
+      }
+
       return results.filter((p) => p !== null);
     },
     onBotUpdated: (result) => {