@tomo-inc/wallet-utils 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,3 @@
+# @tomo-inc/wallet-utils
+
+## 0.0.1

package/README.md

@@ -0,0 +1,14 @@
+# @tomo-inc/wallet-utils
+
+## Plan
+
+1. string: uuid, encrypt
+2. number: transform, format
+3. date
+4. email
+5. password
+6. seed phrase
+7. address
+8. cache: broswer, chrome
+9. sign message validator
+10. message

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@tomo-inc/wallet-utils",
+  "version": "0.0.2",
+  "author": "tomo.inc",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "uuid": "13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}

package/project.json

@@ -0,0 +1,59 @@
+{
+  "name": "wallet-utils",
+  "sourceRoot": "packages/wallet-utils/src",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "outputs": ["{projectRoot}/dist"],
+      "options": {
+        "command": "tsup src/index.ts --format esm,cjs --dts --treeshake",
+        "cwd": "packages/wallet-utils"
+      }
+    },
+    "dev": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "tsup src/index.ts --format esm,cjs --watch --dts",
+        "cwd": "packages/wallet-utils"
+      }
+    },
+    "lint": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "eslint src/**/*.ts",
+        "cwd": "packages/wallet-utils"
+      }
+    },
+    "lint:fix": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "eslint src/**/*.ts --fix",
+        "cwd": "packages/wallet-utils"
+      }
+    },
+    "format": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "prettier --write \"src/**/*.{ts,tsx}\"",
+        "cwd": "packages/wallet-utils"
+      }
+    },
+    "test": {
+      "executor": "nx:run-commands",
+      "outputs": ["{projectRoot}/coverage"],
+      "options": {
+        "command": "vitest run",
+        "cwd": "packages/wallet-utils"
+      }
+    },
+    "test:watch": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "vitest",
+        "cwd": "packages/wallet-utils"
+      }
+    }
+  },
+  "tags": ["npm:public", "scope:wallet-utils", "type:library"]
+}

package/src/broswer.ts

@@ -0,0 +1,38 @@
+export const getBrowserName = (): string => {
+  if (typeof window === "undefined") {
+    return "";
+  }
+
+  const userAgent = window.navigator.userAgent;
+
+  // Safari (must be checked before Chrome as Chrome also includes Safari in userAgent)
+  if (userAgent.includes("Safari/") && !userAgent.includes("Chrome/")) {
+    return "Safari";
+  }
+
+  if (userAgent.includes("Edg/")) {
+    return "Edge";
+  }
+
+  if (userAgent.includes("Firefox/")) {
+    return "Firefox";
+  }
+
+  // Chrome (check after other Chromium-based browsers)
+  if (userAgent.includes("Chrome/")) {
+    return "Chrome";
+  }
+
+  const brave = (window.navigator as any)?.brave;
+  if (brave?.isBrave?.()) {
+    return "Brave";
+  }
+
+  // Opera
+  if (userAgent.includes("Opera/") || userAgent.includes("OPR/")) {
+    return "Opera";
+  }
+
+  // Default fallback
+  return "";
+};

package/src/cache.ts

@@ -0,0 +1,120 @@
+/*
+1: JSON.stringfy --> set --> get --> JSON.parse
+2: data format well return as set`s
+3: undefined in array will be null after stringfy+parse
+4: NS --> namespace
+*/
+
+//key += account id
+let keyNS = "tomo-";
+
+function get(key: string) {
+  /*
+    legal data: "" [] {} null flase true
+
+    illegal: undefined
+        1: key not set
+        2: key is cleared
+        3: key removed
+        4: wrong data format
+    */
+  // Check if we're in a browser environment
+  if (typeof window === "undefined") {
+    return null;
+  }
+
+  const tempKey = keyNS + key;
+  if (!isKeyExist(tempKey)) {
+    return null;
+  }
+  // maybe keyNS could avoid conflict
+  let val: { data: any; type: string } | null = null;
+  try {
+    const data: any = window.localStorage.getItem(tempKey) || window.sessionStorage.getItem(tempKey);
+    val = JSON.parse(data);
+  } catch (err) {
+    console.error(err);
+  }
+  // val format check
+  if (
+    val !== null &&
+    Object.prototype.hasOwnProperty.call(val, "type") &&
+    Object.prototype.hasOwnProperty.call(val, "data")
+  ) {
+    return val["data"];
+  }
+  return null;
+}
+// isPersistent
+function set(key: string, val: any, isTemp: boolean) {
+  // Check if we're in a browser environment
+  if (typeof window === "undefined") {
+    return false;
+  }
+
+  let store;
+  if (isTemp) {
+    store = window.sessionStorage;
+  } else {
+    store = window.localStorage;
+  }
+
+  const data = JSON.stringify({
+    data: val,
+    time: new Date().getTime(), //for manage by time limit
+    type: typeof val,
+  });
+  try {
+    store.setItem(keyNS + key, data);
+    return true;
+  } catch (err: any) {
+    if (err?.name?.toUpperCase().indexOf("QUOTA") >= 0) {
+      window.localStorage.clear();
+      store.setItem(keyNS + key, data);
+    }
+  }
+  return false;
+}
+
+function remove(key: string) {
+  // Check if we're in a browser environment
+  if (typeof window === "undefined") {
+    return;
+  }
+
+  const tempKey = keyNS + key;
+  window.localStorage.removeItem(tempKey);
+  window.sessionStorage.removeItem(tempKey);
+}
+
+function clear() {
+  // Check if we're in a browser environment
+  if (typeof window === "undefined") {
+    return;
+  }
+
+  window?.localStorage?.clear();
+  window?.sessionStorage?.clear();
+}
+
+function isKeyExist(key: string) {
+  // Check if we're in a browser environment
+  if (typeof window === "undefined") {
+    return false;
+  }
+
+  // do not depend on value cause of "",0
+  return (
+    Object.prototype.hasOwnProperty.call(window.localStorage, key) ||
+    Object.prototype.hasOwnProperty.call(window.sessionStorage, key)
+  );
+}
+
+function setKeyNS(NS: string) {
+  const isString = typeof NS === "string";
+  if (isString && NS !== "") {
+    keyNS = NS;
+  }
+}
+
+export { clear, get, remove, set, setKeyNS };

package/src/email.ts

@@ -0,0 +1,26 @@
+export const maskEmail = (email: string) => {
+  if (!email) {
+    return;
+  }
+  const parts = email.split("@");
+
+  if (parts.length === 2) {
+    let username = parts[0];
+    const domain = parts[1];
+
+    if (username.length >= 4) {
+      username = username.slice(0, -3) + "***";
+    } else {
+      username = username + "*".repeat(4 - username.length);
+    }
+
+    const maskedEmail = `${username}@${domain}`;
+    return maskedEmail;
+  } else {
+    return null;
+  }
+};
+
+export const isEmail = (email: string) => {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+};

package/src/global-config.ts

@@ -0,0 +1,79 @@
+export enum ChainTypes {
+  BTC = "btc",
+  DOGE = "doge",
+  EVM = "evm",
+  SOL = "sol",
+  SUI = "sui",
+  TON = "ton",
+  TRON = "tron",
+  COSMOS = "cosmos",
+  APTOS = "aptos",
+}
+
+interface ChainTypeConfig {
+  chainId?: string;
+  chainIndex?: number;
+  support: boolean;
+  gasFee: number;
+  dust: number;
+  reserve?: number;
+}
+
+export const SupportedChainTypes: Record<ChainTypes, ChainTypeConfig> = {
+  [ChainTypes.DOGE]: {
+    chainId: "3",
+    chainIndex: 300,
+    support: true,
+    gasFee: 0.5,
+    dust: 0.0001,
+  },
+  [ChainTypes.EVM]: {
+    chainId: "1",
+    chainIndex: 100,
+    support: true,
+    gasFee: 0.00001,
+    dust: 0,
+  },
+  [ChainTypes.SOL]: {
+    chainId: "501",
+    chainIndex: 50100,
+    support: true,
+    gasFee: 0.0001,
+    dust: 0,
+    reserve: 0.0009, // Available balance = Total balance - Reserve balance (for rent exemption)
+  },
+  [ChainTypes.TRON]: {
+    chainId: "19484",
+    chainIndex: 1948400,
+    support: true,
+    gasFee: 0.5,
+    dust: 0,
+  },
+  [ChainTypes.BTC]: {
+    chainId: "0", //livenet
+    chainIndex: 0,
+    support: false,
+    gasFee: 0.00001,
+    dust: 0.0001,
+  },
+  [ChainTypes.SUI]: {
+    support: false,
+    gasFee: 0,
+    dust: 0,
+  },
+  [ChainTypes.TON]: {
+    support: false,
+    gasFee: 0,
+    dust: 0,
+  },
+  [ChainTypes.COSMOS]: {
+    support: false,
+    gasFee: 0,
+    dust: 0,
+  },
+  [ChainTypes.APTOS]: {
+    support: false,
+    gasFee: 0,
+    dust: 0,
+  },
+};

package/src/index.ts

@@ -0,0 +1,34 @@
+import * as cache from "./cache";
+export { cache };
+
+export * from "./broswer";
+export * from "./email";
+export * from "./global-config";
+export * from "./password";
+export * from "./string";
+
+export type TomoStage = "prod" | "pre" | "dev";
+export type CubeStage = "gamma" | "prod";
+export const CubeStages = {
+  prod: "prod",
+  pre: "prod",
+  dev: "gamma",
+};
+
+export const CubeOrgIds = {
+  prod: "Org#49944bce-9daf-423f-a982-269f6d0d301b",
+  pre: "Org#71c13f6d-b992-4660-874d-2ae0fadc789f",
+  dev: "Org#3d07a75a-1188-4bd0-acfa-671a198b83eb",
+};
+
+export const RelayOrigins = {
+  prod: "https://social-relay.tomo.inc",
+  pre: "https://social-relay.tomo.inc",
+  dev: "https://social-relay-dev.tomo.inc",
+};
+
+export const TomoApiDomains = {
+  prod: "https://wallet-pro.tomo.inc",
+  pre: "https://wallet-pre-wlfi.tomo.inc",
+  dev: "https://wallet-test.tomo.inc",
+};

package/src/password.ts

@@ -0,0 +1,6 @@
+export const validatePassword = (password: string) => {
+  const lengthValid = password.length >= 8 && password.length <= 32;
+  const hasLetter = /[a-zA-Z]/.test(password);
+  const hasNumber = /[0-9]/.test(password);
+  return lengthValid && hasLetter && hasNumber;
+};

package/src/string.ts

@@ -0,0 +1,88 @@
+export function stripHexPrefix(str: string) {
+  if (typeof str !== "string") {
+    return str;
+  }
+  return str.startsWith("0x") ? str.slice(2) : str;
+}
+
+export function compareString(a: string, b: string) {
+  return a.toLowerCase() === b.toLowerCase();
+}
+
+export function subs(temp: string, data: any, regexp?: RegExp) {
+  if (!(Object.prototype.toString.call(data) === "[object Array]")) data = [data];
+  const ret = [];
+  for (let i = 0, j = data.length; i < j; i++) {
+    ret.push(replaceAction(data[i]));
+  }
+  return ret.join("");
+  function replaceAction(object: any) {
+    return temp.replace(regexp || /\\?\{([^}]+)\}/g, function (match, name) {
+      if (match.charAt(0) == "\\") return match.slice(1);
+      return object[name] != undefined ? object[name] : "";
+    });
+  }
+}
+
+export function getExplorerUrl(chainIndex: number, data: { txId: string }) {
+  const linkTpls = {
+    "0": "",
+    "100": "https://etherscan.io/tx/{txId}",
+    "300": "https://dogechain.info/tx/{txId}",
+    "400": "",
+    "1000": "https://optimistic.etherscan.io/tx/{txId}",
+    "5600": "https://bscscan.com/tx/{txId}",
+    "12600": "https://explorer.movementnetwork.xyz/txn/{txId}?network=mainnet",
+    "13700": "https://polygonscan.com/tx/{txId}",
+    "20400": "https://opbnb.bscscan.com/tx/{txId}",
+    "22300": "https://explorer.bsquared.network/tx/{txId}",
+    "22700": "https://promscan.io/tx/{txId}",
+    "32400": "https://mainnet.era.zksync.io/tx/{txId}",
+    "48000": "https://worldchain-mainnet.explorer.alchemy.com/tx/{txId}",
+    "50100": "https://solscan.io/tx/{txId}",
+    "78400": "",
+    "110000": "",
+    "132900": "https://seitrace.com/tx/{txId}",
+    "151400": "https://mainnet.storyscan.xyz/tx/{txId}",
+    "162500": "https://explorer.gravity.xyz/tx/{txId}",
+    "264900": "https://mainnet-explorer.ailayer.xyz/tx/{txId}",
+    "420000": "https://scan.merlinchain.io/tx/{txId}",
+    "554500": "https://scan.duckchain.io/tx/{txId}",
+    "833300": "https://mainnet-rpc.b3.fun/http/tx/{txId}",
+    "845300": "https://base.blockscout.com/tx/{txId}",
+    "1948400": "https://tronscan.org/#/transaction/{txId}",
+    "4216100": "https://arbiscan.io/tx/{txId}",
+    "4311400": "https://snowtrace.io/tx/{txId}",
+    "4776300": "https://neotube.io/transaction/{txId}",
+    "5914400": "https://lineascan.build/tx/{txId}",
+    "6080800": "https://rpc.gobob.xyz/tx/{txId}",
+    "8009400": "https://berascan.com/tx/{txId}",
+    "8145700": "https://blastscan.io/tx/{txId}",
+    "20090100": "https://rpc.bitlayer.org/tx/{txId}",
+    "53435200": "https://scrollscan.com/tx/{txId}",
+    "221122420": "https://blockscout.devnet.doge.xyz/tx/{txId}",
+    "2100000000": "https://maizenet-explorer.usecorn.com/tx/{txId}",
+  };
+
+  const key = chainIndex.toString() as keyof typeof linkTpls;
+  const linkTpl: string = linkTpls[key] || "";
+  if (linkTpl === "") {
+    throw new Error(`chainIndex ${chainIndex} tpl not found`);
+  }
+  return subs(linkTpl, data);
+}
+
+export function calcCtrLength(str: string) {
+  let length = 0;
+  str = str.trim();
+  for (let i = 0; i < str.length; i++) {
+    const code = str.charCodeAt(i);
+    //chianese character: \u4e00-\u9fa5
+    if (code >= 0x4e00 && code <= 0x9fa5) {
+      length += 2;
+    } else {
+      length += 1;
+    }
+  }
+  return { len: length, originLen: str.length };
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM"],
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "baseUrl": "./src"
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm", "cjs"],
+  dts: true,
+  treeshake: true,
+  clean: true,
+  platform: "browser",
+  outExtension({ format }) {
+    return {
+      js: format === "esm" ? ".js" : ".cjs",
+    };
+  },
+});