@wopr-network/platform-core 1.32.0 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/platform-core",
-  "version": "1.32.0",
+  "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";