From 15c287b6efdcbc287a0e2f2f636f01ef8af24398 Mon Sep 17 00:00:00 2001
From: Otto Allmendinger <otto@bitgo.com>
Date: Thu, 15 Jan 2026 10:23:29 +0100
Subject: [PATCH] feat(wasm-utxo): enhance CoinName type with utility functions

Add helper functions for working with coin names including:
- Converting testnet coins to their mainnet equivalent
- Checking if a coin is mainnet or testnet
- Type guard to validate if a string is a valid CoinName
- Refactor CoinName to use a const array with indexed types

Issue: BTC-2936

Co-authored-by: llm-git <llm-git@ttll.de>
---
 packages/wasm-utxo/js/coinName.ts | 87 +++++++++++++++++++++++--------
 1 file changed, 65 insertions(+), 22 deletions(-)

diff --git a/packages/wasm-utxo/js/coinName.ts b/packages/wasm-utxo/js/coinName.ts
index ed8e8ee..7dd350a 100644
--- a/packages/wasm-utxo/js/coinName.ts
+++ b/packages/wasm-utxo/js/coinName.ts
@@ -1,23 +1,66 @@
 // BitGo coin names (from Network::from_coin_name in src/networks.rs)
-export type CoinName =
-  | "btc"
-  | "tbtc"
-  | "tbtc4"
-  | "tbtcsig"
-  | "tbtcbgsig"
-  | "bch"
-  | "tbch"
-  | "bcha"
-  | "tbcha"
-  | "btg"
-  | "tbtg"
-  | "bsv"
-  | "tbsv"
-  | "dash"
-  | "tdash"
-  | "doge"
-  | "tdoge"
-  | "ltc"
-  | "tltc"
-  | "zec"
-  | "tzec";
+export const coinNames = [
+  "btc",
+  "tbtc",
+  "tbtc4",
+  "tbtcsig",
+  "tbtcbgsig",
+  "bch",
+  "tbch",
+  "bcha",
+  "tbcha",
+  "btg",
+  "tbtg",
+  "bsv",
+  "tbsv",
+  "dash",
+  "tdash",
+  "doge",
+  "tdoge",
+  "ltc",
+  "tltc",
+  "zec",
+  "tzec",
+] as const;
+
+export type CoinName = (typeof coinNames)[number];
+
+export function getMainnet(name: CoinName): CoinName {
+  switch (name) {
+    case "tbtc":
+    case "tbtc4":
+    case "tbtcsig":
+    case "tbtcbgsig":
+      return "btc";
+    case "tbch":
+      return "bch";
+    case "tbcha":
+      return "bcha";
+    case "tbtg":
+      return "btg";
+    case "tbsv":
+      return "bsv";
+    case "tdash":
+      return "dash";
+    case "tdoge":
+      return "doge";
+    case "tltc":
+      return "ltc";
+    case "tzec":
+      return "zec";
+    default:
+      return name;
+  }
+}
+
+export function isMainnet(name: CoinName): boolean {
+  return getMainnet(name) === name;
+}
+
+export function isTestnet(name: CoinName): boolean {
+  return getMainnet(name) !== name;
+}
+
+export function isCoinName(v: string): v is CoinName {
+  return (coinNames as readonly string[]).includes(v);
+}