@wopr-network/platform-core 1.57.0 → 1.58.0

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

@@ -1,101 +0,0 @@
-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) 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 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");
-    const hash160 = ripemd160(sha256(child.publicKey));
-    const prefix = getBech32Prefix(chain, network);
-    const words = bech32.toWords(hash160);
-    return bech32.encode(prefix, [0, ...words]);
-}
-/** 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 = getBech32Prefix(chain, network);
-    const words = bech32.toWords(hash160);
-    return bech32.encode(prefix, [0, ...words]);
-}
-/** P2PKH version bytes for Base58Check encoding (chains without bech32). */
-const P2PKH_VERSION = {
-    dogecoin: { mainnet: 0x1e, testnet: 0x71 },
-};
-const BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
-function base58encode(data) {
-    let num = 0n;
-    for (const byte of data)
-        num = num * 256n + BigInt(byte);
-    let encoded = "";
-    while (num > 0n) {
-        encoded = BASE58_ALPHABET[Number(num % 58n)] + encoded;
-        num = num / 58n;
-    }
-    for (const byte of data) {
-        if (byte !== 0)
-            break;
-        encoded = `1${encoded}`;
-    }
-    return encoded;
-}
-/**
- * Derive a P2PKH (Base58Check) address for chains without bech32 (e.g., DOGE → D...).
- */
-export function deriveP2pkhAddress(xpub, index, chain, network = "mainnet") {
-    if (!Number.isInteger(index) || index < 0)
-        throw new Error(`Invalid derivation index: ${index}`);
-    const version = P2PKH_VERSION[chain]?.[network];
-    if (version === undefined)
-        throw new Error(`No P2PKH version for chain=${chain} network=${network}`);
-    const master = HDKey.fromExtendedKey(xpub);
-    const child = master.deriveChild(0).deriveChild(index);
-    if (!child.publicKey)
-        throw new Error("Failed to derive public key");
-    const hash160 = ripemd160(sha256(child.publicKey));
-    const payload = new Uint8Array(21);
-    payload[0] = version;
-    payload.set(hash160, 1);
-    const checksum = sha256(sha256(payload));
-    const full = new Uint8Array(25);
-    full.set(payload);
-    full.set(checksum.slice(0, 4), 21);
-    return base58encode(full);
-}
-/** @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/evm/__tests__/address-gen.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/billing/crypto/evm/__tests__/address-gen.test.js

@@ -1,54 +0,0 @@
-import { HDKey } from "@scure/bip32";
-import { describe, expect, it } from "vitest";
-import { deriveDepositAddress, isValidXpub } from "../address-gen.js";
-// Generate a test xpub deterministically
-function makeTestXpub() {
-    const seed = new Uint8Array(32);
-    seed[0] = 1; // deterministic seed
-    const master = HDKey.fromMasterSeed(seed);
-    // Derive to m/44'/60'/0' (Ethereum BIP-44 path)
-    const account = master.derive("m/44'/60'/0'");
-    return account.publicExtendedKey;
-}
-const TEST_XPUB = makeTestXpub();
-describe("deriveDepositAddress", () => {
-    it("derives a valid Ethereum address", () => {
-        const addr = deriveDepositAddress(TEST_XPUB, 0);
-        expect(addr).toMatch(/^0x[0-9a-fA-F]{40}$/);
-    });
-    it("derives different addresses for different indices", () => {
-        const addr0 = deriveDepositAddress(TEST_XPUB, 0);
-        const addr1 = deriveDepositAddress(TEST_XPUB, 1);
-        expect(addr0).not.toBe(addr1);
-    });
-    it("is deterministic — same xpub + index = same address", () => {
-        const a = deriveDepositAddress(TEST_XPUB, 42);
-        const b = deriveDepositAddress(TEST_XPUB, 42);
-        expect(a).toBe(b);
-    });
-    it("returns checksummed address", () => {
-        const addr = deriveDepositAddress(TEST_XPUB, 0);
-        // Must be a valid 0x-prefixed address
-        expect(addr).toMatch(/^0x[0-9a-fA-F]{40}$/);
-        // viem's publicKeyToAddress always returns EIP-55 checksummed
-        // Verify it's not all-lowercase (checksummed addresses have mixed case)
-        const hexPart = addr.slice(2);
-        const hasUpperCase = hexPart !== hexPart.toLowerCase();
-        const hasLowerCase = hexPart !== hexPart.toUpperCase();
-        // At least one of these should be true for a checksummed address
-        // (unless the address happens to be all digits, which is extremely rare)
-        expect(hasUpperCase || !hexPart.match(/[a-f]/i)).toBe(true);
-        expect(hasLowerCase || !hexPart.match(/[a-f]/i)).toBe(true);
-    });
-});
-describe("isValidXpub", () => {
-    it("accepts valid xpub", () => {
-        expect(isValidXpub(TEST_XPUB)).toBe(true);
-    });
-    it("rejects garbage", () => {
-        expect(isValidXpub("not-an-xpub")).toBe(false);
-    });
-    it("rejects empty string", () => {
-        expect(isValidXpub("")).toBe(false);
-    });
-});

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

@@ -1,8 +0,0 @@
-/**
- * Derive a deposit address from an xpub at a given BIP-44 index.
- * Path: xpub / 0 / index (external chain / address index).
- * Returns a checksummed Ethereum address. No private keys involved.
- */
-export declare function deriveDepositAddress(xpub: string, index: number): `0x${string}`;
-/** Validate that a string is an xpub (not xprv). */
-export declare function isValidXpub(key: string): boolean;

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

@@ -1,29 +0,0 @@
-import { HDKey } from "@scure/bip32";
-import { publicKeyToAddress } from "viem/accounts";
-/**
- * Derive a deposit address from an xpub at a given BIP-44 index.
- * Path: xpub / 0 / index (external chain / address index).
- * Returns a checksummed Ethereum address. No private keys involved.
- */
-export function deriveDepositAddress(xpub, index) {
-    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");
-    const hexPubKey = `0x${Array.from(child.publicKey, (b) => b.toString(16).padStart(2, "0")).join("")}`;
-    return publicKeyToAddress(hexPubKey);
-}
-/** 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/src/billing/crypto/btc/__tests__/address-gen.test.ts

@@ -1,53 +0,0 @@
-import { HDKey } from "@scure/bip32";
-import { describe, expect, it } from "vitest";
-import { deriveBtcAddress, deriveBtcTreasury } from "../address-gen.js";
-
-function makeTestXpub(): string {
-  const seed = new Uint8Array(32);
-  seed[0] = 1;
-  const master = HDKey.fromMasterSeed(seed);
-  return master.derive("m/44'/0'/0'").publicExtendedKey;
-}
-
-const TEST_XPUB = makeTestXpub();
-
-describe("deriveBtcAddress", () => {
-  it("derives a valid bech32 address", () => {
-    const addr = deriveBtcAddress(TEST_XPUB, 0);
-    expect(addr).toMatch(/^bc1q[a-z0-9]+$/);
-  });
-
-  it("derives different addresses for different indices", () => {
-    const a = deriveBtcAddress(TEST_XPUB, 0);
-    const b = deriveBtcAddress(TEST_XPUB, 1);
-    expect(a).not.toBe(b);
-  });
-
-  it("is deterministic", () => {
-    const a = deriveBtcAddress(TEST_XPUB, 42);
-    const b = deriveBtcAddress(TEST_XPUB, 42);
-    expect(a).toBe(b);
-  });
-
-  it("uses tb prefix for testnet/regtest", () => {
-    const addr = deriveBtcAddress(TEST_XPUB, 0, "testnet");
-    expect(addr).toMatch(/^tb1q[a-z0-9]+$/);
-  });
-
-  it("rejects negative index", () => {
-    expect(() => deriveBtcAddress(TEST_XPUB, -1)).toThrow("Invalid");
-  });
-});
-
-describe("deriveBtcTreasury", () => {
-  it("derives a valid bech32 address", () => {
-    const addr = deriveBtcTreasury(TEST_XPUB);
-    expect(addr).toMatch(/^bc1q[a-z0-9]+$/);
-  });
-
-  it("differs from deposit address at index 0", () => {
-    const deposit = deriveBtcAddress(TEST_XPUB, 0);
-    const treasury = deriveBtcTreasury(TEST_XPUB);
-    expect(deposit).not.toBe(treasury);
-  });
-});

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

@@ -1,122 +0,0 @@
-import { ripemd160 } from "@noble/hashes/legacy.js";
-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) 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 deriveAddress(
-  xpub: string,
-  index: number,
-  network: UtxoNetwork = "mainnet",
-  chain: UtxoChain = "bitcoin",
-): string {
-  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");
-
-  const hash160 = ripemd160(sha256(child.publicKey));
-  const prefix = getBech32Prefix(chain, network);
-  const words = bech32.toWords(hash160);
-  return bech32.encode(prefix, [0, ...words]);
-}
-
-/** 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 = getBech32Prefix(chain, network);
-  const words = bech32.toWords(hash160);
-  return bech32.encode(prefix, [0, ...words]);
-}
-
-/** P2PKH version bytes for Base58Check encoding (chains without bech32). */
-const P2PKH_VERSION: Record<string, Record<string, number>> = {
-  dogecoin: { mainnet: 0x1e, testnet: 0x71 },
-};
-
-const BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
-function base58encode(data: Uint8Array): string {
-  let num = 0n;
-  for (const byte of data) num = num * 256n + BigInt(byte);
-  let encoded = "";
-  while (num > 0n) {
-    encoded = BASE58_ALPHABET[Number(num % 58n)] + encoded;
-    num = num / 58n;
-  }
-  for (const byte of data) {
-    if (byte !== 0) break;
-    encoded = `1${encoded}`;
-  }
-  return encoded;
-}
-
-/**
- * Derive a P2PKH (Base58Check) address for chains without bech32 (e.g., DOGE → D...).
- */
-export function deriveP2pkhAddress(
-  xpub: string,
-  index: number,
-  chain: string,
-  network: "mainnet" | "testnet" = "mainnet",
-): string {
-  if (!Number.isInteger(index) || index < 0) throw new Error(`Invalid derivation index: ${index}`);
-  const version = P2PKH_VERSION[chain]?.[network];
-  if (version === undefined) throw new Error(`No P2PKH version for chain=${chain} network=${network}`);
-
-  const master = HDKey.fromExtendedKey(xpub);
-  const child = master.deriveChild(0).deriveChild(index);
-  if (!child.publicKey) throw new Error("Failed to derive public key");
-
-  const hash160 = ripemd160(sha256(child.publicKey));
-  const payload = new Uint8Array(21);
-  payload[0] = version;
-  payload.set(hash160, 1);
-  const checksum = sha256(sha256(payload));
-  const full = new Uint8Array(25);
-  full.set(payload);
-  full.set(checksum.slice(0, 4), 21);
-  return base58encode(full);
-}
-
-/** @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/evm/__tests__/address-gen.test.ts

@@ -1,63 +0,0 @@
-import { HDKey } from "@scure/bip32";
-import { describe, expect, it } from "vitest";
-import { deriveDepositAddress, isValidXpub } from "../address-gen.js";
-
-// Generate a test xpub deterministically
-function makeTestXpub(): string {
-  const seed = new Uint8Array(32);
-  seed[0] = 1; // deterministic seed
-  const master = HDKey.fromMasterSeed(seed);
-  // Derive to m/44'/60'/0' (Ethereum BIP-44 path)
-  const account = master.derive("m/44'/60'/0'");
-  return account.publicExtendedKey;
-}
-
-const TEST_XPUB = makeTestXpub();
-
-describe("deriveDepositAddress", () => {
-  it("derives a valid Ethereum address", () => {
-    const addr = deriveDepositAddress(TEST_XPUB, 0);
-    expect(addr).toMatch(/^0x[0-9a-fA-F]{40}$/);
-  });
-
-  it("derives different addresses for different indices", () => {
-    const addr0 = deriveDepositAddress(TEST_XPUB, 0);
-    const addr1 = deriveDepositAddress(TEST_XPUB, 1);
-    expect(addr0).not.toBe(addr1);
-  });
-
-  it("is deterministic — same xpub + index = same address", () => {
-    const a = deriveDepositAddress(TEST_XPUB, 42);
-    const b = deriveDepositAddress(TEST_XPUB, 42);
-    expect(a).toBe(b);
-  });
-
-  it("returns checksummed address", () => {
-    const addr = deriveDepositAddress(TEST_XPUB, 0);
-    // Must be a valid 0x-prefixed address
-    expect(addr).toMatch(/^0x[0-9a-fA-F]{40}$/);
-    // viem's publicKeyToAddress always returns EIP-55 checksummed
-    // Verify it's not all-lowercase (checksummed addresses have mixed case)
-    const hexPart = addr.slice(2);
-    const hasUpperCase = hexPart !== hexPart.toLowerCase();
-    const hasLowerCase = hexPart !== hexPart.toUpperCase();
-    // At least one of these should be true for a checksummed address
-    // (unless the address happens to be all digits, which is extremely rare)
-    expect(hasUpperCase || !hexPart.match(/[a-f]/i)).toBe(true);
-    expect(hasLowerCase || !hexPart.match(/[a-f]/i)).toBe(true);
-  });
-});
-
-describe("isValidXpub", () => {
-  it("accepts valid xpub", () => {
-    expect(isValidXpub(TEST_XPUB)).toBe(true);
-  });
-
-  it("rejects garbage", () => {
-    expect(isValidXpub("not-an-xpub")).toBe(false);
-  });
-
-  it("rejects empty string", () => {
-    expect(isValidXpub("")).toBe(false);
-  });
-});

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

@@ -1,29 +0,0 @@
-import { HDKey } from "@scure/bip32";
-import { publicKeyToAddress } from "viem/accounts";
-
-/**
- * Derive a deposit address from an xpub at a given BIP-44 index.
- * Path: xpub / 0 / index (external chain / address index).
- * Returns a checksummed Ethereum address. No private keys involved.
- */
-export function deriveDepositAddress(xpub: string, index: number): `0x${string}` {
-  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");
-
-  const hexPubKey =
-    `0x${Array.from(child.publicKey, (b) => b.toString(16).padStart(2, "0")).join("")}` as `0x${string}`;
-  return publicKeyToAddress(hexPubKey);
-}
-
-/** 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;
-  }
-}