@wopr-network/platform-core 1.31.1 → 1.33.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/updater.d.ts

@@ -26,7 +26,7 @@ export declare class ContainerUpdater {
     constructor(docker: Docker, store: IProfileStore, fleet: FleetManager, _poller: ImagePoller);
     /**
      * Update a bot's container to the latest image available for its release channel.
-     * Rolls back if the new container fails health checks within 60s.
+     * Rolls back if the new container fails health checks within 120s.
      */
     updateBot(botId: string): Promise<UpdateResult>;
     private doUpdateBot;

package/dist/fleet/updater.js

@@ -1,7 +1,7 @@
 import { logger } from "../config/logger.js";
 import { getContainerDigest } from "./image-poller.js";
 /** How long to wait for a container to become healthy after update (ms) */
-const HEALTH_CHECK_TIMEOUT_MS = 60_000;
+const HEALTH_CHECK_TIMEOUT_MS = 120_000;
 /** How often to check container health during update verification (ms) */
 const HEALTH_CHECK_POLL_MS = 5_000;
 /**
@@ -22,7 +22,7 @@ export class ContainerUpdater {
     }
     /**
      * Update a bot's container to the latest image available for its release channel.
-     * Rolls back if the new container fails health checks within 60s.
+     * Rolls back if the new container fails health checks within 120s.
      */
     async updateBot(botId) {
         if (this.updating.has(botId)) {

package/dist/fleet/updater.test.js

@@ -246,8 +246,8 @@ describe("ContainerUpdater", () => {
             docker.listContainers.mockResolvedValue([{ Id: "container-123" }]);
             docker.getContainer.mockReturnValue(startingContainer);
             const promise = updater.updateBot("bot-1");
-            // Advance past the 60s timeout (60_000ms) in increments of poll interval (5_000ms)
-            for (let i = 0; i < 13; i++) {
+            // Advance past the 120s timeout (120_000ms) in increments of poll interval (5_000ms)
+            for (let i = 0; i < 25; i++) {
                 await vi.advanceTimersByTimeAsync(5_000);
             }
             const result = await promise;

package/dist/node-agent/types.d.ts

@@ -44,14 +44,14 @@ export type CommandType = (typeof ALLOWED_COMMANDS)[number];
 export declare const commandSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodEnum<{
+        "bot.logs": "bot.logs";
         "bot.start": "bot.start";
         "bot.stop": "bot.stop";
         "bot.restart": "bot.restart";
+        "bot.remove": "bot.remove";
         "bot.update": "bot.update";
         "bot.export": "bot.export";
         "bot.import": "bot.import";
-        "bot.remove": "bot.remove";
-        "bot.logs": "bot.logs";
         "bot.inspect": "bot.inspect";
         "backup.upload": "backup.upload";
         "backup.download": "backup.download";

package/dist/trpc/admin-fleet-update-router.d.ts

@@ -0,0 +1,41 @@
+import type { RolloutOrchestrator } from "../fleet/rollout-orchestrator.js";
+import type { ITenantUpdateConfigRepository } from "../fleet/tenant-update-config-repository.js";
+export declare function createAdminFleetUpdateRouter(getOrchestrator: () => RolloutOrchestrator, getConfigRepo: () => ITenantUpdateConfigRepository): import("@trpc/server").TRPCBuiltRouter<{
+    ctx: import("./init.js").TRPCContext;
+    meta: object;
+    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+    transformer: false;
+}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+    /** Get current rollout status */
+    rolloutStatus: import("@trpc/server").TRPCQueryProcedure<{
+        input: void;
+        output: {
+            isRolling: boolean;
+        };
+        meta: object;
+    }>;
+    /** Force trigger a rollout for all auto-update tenants */
+    forceRollout: import("@trpc/server").TRPCMutationProcedure<{
+        input: void;
+        output: {
+            triggered: boolean;
+        };
+        meta: object;
+    }>;
+    /** List all tenant update configs */
+    listTenantConfigs: import("@trpc/server").TRPCQueryProcedure<{
+        input: void;
+        output: import("../fleet/tenant-update-config-repository.js").TenantUpdateConfig[];
+        meta: object;
+    }>;
+    /** Override a specific tenant's update config */
+    setTenantConfig: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            tenantId: string;
+            mode: "manual" | "auto";
+            preferredHourUtc?: number | undefined;
+        };
+        output: void;
+        meta: object;
+    }>;
+}>>;

package/dist/trpc/admin-fleet-update-router.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { logger } from "../config/logger.js";
+import { adminProcedure, router } from "./init.js";
+export function createAdminFleetUpdateRouter(getOrchestrator, getConfigRepo) {
+    return router({
+        /** Get current rollout status */
+        rolloutStatus: adminProcedure.query(() => {
+            const orchestrator = getOrchestrator();
+            return {
+                isRolling: orchestrator.isRolling,
+            };
+        }),
+        /** Force trigger a rollout for all auto-update tenants */
+        forceRollout: adminProcedure.mutation(async () => {
+            const orchestrator = getOrchestrator();
+            logger.info("Admin: fleet.forceRollout");
+            // Fire and forget — don't block the admin request
+            orchestrator.rollout().catch((err) => {
+                logger.error("Force rollout failed", {
+                    error: err.message,
+                });
+            });
+            return { triggered: true };
+        }),
+        /** List all tenant update configs */
+        listTenantConfigs: adminProcedure.query(async () => {
+            const repo = getConfigRepo();
+            return repo.listAutoEnabled();
+        }),
+        /** Override a specific tenant's update config */
+        setTenantConfig: adminProcedure
+            .input(z.object({
+            tenantId: z.string().min(1),
+            mode: z.enum(["auto", "manual"]),
+            preferredHourUtc: z.number().int().min(0).max(23).optional(),
+        }))
+            .mutation(async ({ input }) => {
+            const repo = getConfigRepo();
+            const existing = await repo.get(input.tenantId);
+            await repo.upsert(input.tenantId, {
+                mode: input.mode,
+                preferredHourUtc: input.preferredHourUtc ?? existing?.preferredHourUtc ?? 3,
+            });
+            logger.info("Admin: fleet.setTenantConfig", {
+                tenantId: input.tenantId,
+                mode: input.mode,
+                preferredHourUtc: input.preferredHourUtc ?? existing?.preferredHourUtc ?? 3,
+            });
+        }),
+    });
+}

package/dist/trpc/index.d.ts

@@ -1,3 +1,4 @@
+export { createAdminFleetUpdateRouter } from "./admin-fleet-update-router.js";
 export { createFleetUpdateConfigRouter } from "./fleet-update-config-router.js";
 export { adminProcedure, createCallerFactory, orgAdminProcedure, orgMemberProcedure, protectedProcedure, publicProcedure, router, setTrpcOrgMemberRepo, type TRPCContext, tenantProcedure, } from "./init.js";
 export { createNotificationTemplateRouter } from "./notification-template-router.js";

package/dist/trpc/index.js

@@ -1,3 +1,4 @@
+export { createAdminFleetUpdateRouter } from "./admin-fleet-update-router.js";
 export { createFleetUpdateConfigRouter } from "./fleet-update-config-router.js";
 export { adminProcedure, createCallerFactory, orgAdminProcedure, orgMemberProcedure, protectedProcedure, publicProcedure, router, setTrpcOrgMemberRepo, tenantProcedure, } from "./init.js";
 export { createNotificationTemplateRouter } from "./notification-template-router.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/platform-core",
-  "version": "1.31.1",
+  "version": "1.33.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/updater.test.ts

@@ -287,8 +287,8 @@ describe("ContainerUpdater", () => {
       docker.getContainer.mockReturnValue(startingContainer);
 
       const promise = updater.updateBot("bot-1");
-      // Advance past the 60s timeout (60_000ms) in increments of poll interval (5_000ms)
-      for (let i = 0; i < 13; i++) {
+      // Advance past the 120s timeout (120_000ms) in increments of poll interval (5_000ms)
+      for (let i = 0; i < 25; i++) {
         await vi.advanceTimersByTimeAsync(5_000);
       }
       const result = await promise;

package/src/fleet/updater.ts

@@ -6,7 +6,7 @@ import { getContainerDigest } from "./image-poller.js";
 import type { IProfileStore } from "./profile-store.js";
 
 /** How long to wait for a container to become healthy after update (ms) */
-const HEALTH_CHECK_TIMEOUT_MS = 60_000;
+const HEALTH_CHECK_TIMEOUT_MS = 120_000;
 /** How often to check container health during update verification (ms) */
 const HEALTH_CHECK_POLL_MS = 5_000;
 
@@ -41,7 +41,7 @@ export class ContainerUpdater {
 
   /**
    * Update a bot's container to the latest image available for its release channel.
-   * Rolls back if the new container fails health checks within 60s.
+   * Rolls back if the new container fails health checks within 120s.
    */
   async updateBot(botId: string): Promise<UpdateResult> {
     if (this.updating.has(botId)) {

package/src/trpc/admin-fleet-update-router.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { logger } from "../config/logger.js";
+import type { RolloutOrchestrator } from "../fleet/rollout-orchestrator.js";
+import type { ITenantUpdateConfigRepository } from "../fleet/tenant-update-config-repository.js";
+import { adminProcedure, router } from "./init.js";
+
+export function createAdminFleetUpdateRouter(
+  getOrchestrator: () => RolloutOrchestrator,
+  getConfigRepo: () => ITenantUpdateConfigRepository,
+) {
+  return router({
+    /** Get current rollout status */
+    rolloutStatus: adminProcedure.query(() => {
+      const orchestrator = getOrchestrator();
+      return {
+        isRolling: orchestrator.isRolling,
+      };
+    }),
+
+    /** Force trigger a rollout for all auto-update tenants */
+    forceRollout: adminProcedure.mutation(async () => {
+      const orchestrator = getOrchestrator();
+      logger.info("Admin: fleet.forceRollout");
+      // Fire and forget — don't block the admin request
+      orchestrator.rollout().catch((err: unknown) => {
+        logger.error("Force rollout failed", {
+          error: (err as Error).message,
+        });
+      });
+      return { triggered: true };
+    }),
+
+    /** List all tenant update configs */
+    listTenantConfigs: adminProcedure.query(async () => {
+      const repo = getConfigRepo();
+      return repo.listAutoEnabled();
+    }),
+
+    /** Override a specific tenant's update config */
+    setTenantConfig: adminProcedure
+      .input(
+        z.object({
+          tenantId: z.string().min(1),
+          mode: z.enum(["auto", "manual"]),
+          preferredHourUtc: z.number().int().min(0).max(23).optional(),
+        }),
+      )
+      .mutation(async ({ input }) => {
+        const repo = getConfigRepo();
+        const existing = await repo.get(input.tenantId);
+        await repo.upsert(input.tenantId, {
+          mode: input.mode,
+          preferredHourUtc: input.preferredHourUtc ?? existing?.preferredHourUtc ?? 3,
+        });
+        logger.info("Admin: fleet.setTenantConfig", {
+          tenantId: input.tenantId,
+          mode: input.mode,
+          preferredHourUtc: input.preferredHourUtc ?? existing?.preferredHourUtc ?? 3,
+        });
+      }),
+  });
+}

package/src/trpc/index.ts

@@ -1,3 +1,4 @@
+export { createAdminFleetUpdateRouter } from "./admin-fleet-update-router.js";
 export { createFleetUpdateConfigRouter } from "./fleet-update-config-router.js";
 export {
   adminProcedure,