@drift-labs/common 1.0.54 → 1.0.56

package/lib/utils/validation.d.ts

@@ -0,0 +1,17 @@
+import { BigNum } from '@drift-labs/sdk';
+export declare const isNotionalDust: (val: BigNum) => boolean;
+export declare const isValidPublicKey: (str: string) => boolean;
+export declare const BITCOIN_CHAIN_ID = "8253038";
+export declare const TRON_CHAIN_ID = "728126428";
+export declare const SOLANA_CHAIN_ID = "1151111081099710";
+/**
+ * Validates a recipient address based on the destination chain.
+ * EVM chains use 0x-prefixed hex address format.
+ * Bitcoin, Tron, and Solana each have their own format.
+ */
+export declare function isValidAddressForChain(address: string, chainId: string | null): boolean;
+/**
+ * Returns a human-readable address format hint for the given chain.
+ */
+export declare function getAddressFormatHint(chainId: string | null): string;
+export declare function isEvmChain(chainId: string): boolean;

package/lib/utils/validation.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEvmChain = exports.getAddressFormatHint = exports.isValidAddressForChain = exports.SOLANA_CHAIN_ID = exports.TRON_CHAIN_ID = exports.BITCOIN_CHAIN_ID = exports.isValidPublicKey = exports.isNotionalDust = void 0;
+const sdk_1 = require("@drift-labs/sdk");
+const isNotionalDust = (val) => {
+    return !val.eqZero() && val.abs().toNum() < 0.01;
+};
+exports.isNotionalDust = isNotionalDust;
+const isValidPublicKey = (str) => {
+    try {
+        new sdk_1.PublicKey(str);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.isValidPublicKey = isValidPublicKey;
+// Chain ID constants
+exports.BITCOIN_CHAIN_ID = '8253038';
+exports.TRON_CHAIN_ID = '728126428';
+exports.SOLANA_CHAIN_ID = '1151111081099710';
+// EVM chains (all others default to EVM validation)
+const NON_EVM_CHAIN_IDS = new Set([
+    exports.BITCOIN_CHAIN_ID,
+    exports.TRON_CHAIN_ID,
+    exports.SOLANA_CHAIN_ID,
+]);
+function isValidEvmAddress(address) {
+    return /^0x[0-9a-fA-F]{40}$/.test(address);
+}
+function isValidBitcoinAddress(address) {
+    // P2PKH (1...), P2SH (3...)
+    if (/^[13]/.test(address)) {
+        return /^(1[1-9A-HJ-NP-Za-km-z]{25,34}|3[1-9A-HJ-NP-Za-km-z]{25,34})$/.test(address);
+    }
+    // Bech32 — must be single-case (lowercase or uppercase, not mixed)
+    if (/^bc1/.test(address)) {
+        return /^bc1[0-9a-z]{25,62}$/.test(address);
+    }
+    if (/^BC1/.test(address)) {
+        return /^BC1[0-9A-Z]{25,62}$/.test(address);
+    }
+    return false;
+}
+function isValidTronAddress(address) {
+    // Tron addresses start with T and are 34 chars, base58
+    return /^T[1-9A-HJ-NP-Za-km-z]{33}$/.test(address);
+}
+function isValidSolanaAddress(address) {
+    return (0, exports.isValidPublicKey)(address);
+}
+/**
+ * Validates a recipient address based on the destination chain.
+ * EVM chains use 0x-prefixed hex address format.
+ * Bitcoin, Tron, and Solana each have their own format.
+ */
+function isValidAddressForChain(address, chainId) {
+    if (!address || !chainId)
+        return false;
+    if (chainId === exports.BITCOIN_CHAIN_ID)
+        return isValidBitcoinAddress(address);
+    if (chainId === exports.TRON_CHAIN_ID)
+        return isValidTronAddress(address);
+    if (chainId === exports.SOLANA_CHAIN_ID)
+        return isValidSolanaAddress(address);
+    return isValidEvmAddress(address);
+}
+exports.isValidAddressForChain = isValidAddressForChain;
+/**
+ * Returns a human-readable address format hint for the given chain.
+ */
+function getAddressFormatHint(chainId) {
+    if (!chainId)
+        return 'address';
+    if (chainId === exports.BITCOIN_CHAIN_ID)
+        return 'Bitcoin address (1.., 3.., bc1..)';
+    if (chainId === exports.TRON_CHAIN_ID)
+        return 'Tron address (T..)';
+    if (chainId === exports.SOLANA_CHAIN_ID)
+        return 'Solana address';
+    return 'EVM address (0x..)';
+}
+exports.getAddressFormatHint = getAddressFormatHint;
+function isEvmChain(chainId) {
+    return !NON_EVM_CHAIN_IDS.has(chainId);
+}
+exports.isEvmChain = isEvmChain;
+//# sourceMappingURL=validation.js.map

package/lib/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { BigNum, PublicKey } from '@drift-labs/sdk';\n\nexport const isNotionalDust = (val: BigNum) => {\n\treturn !val.eqZero() && val.abs().toNum() < 0.01;\n};\n\nexport const isValidPublicKey = (str: string): boolean => {\n\ttry {\n\t\tnew PublicKey(str);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n};\n\n// Chain ID constants\nexport const BITCOIN_CHAIN_ID = '8253038';\nexport const TRON_CHAIN_ID = '728126428';\nexport const SOLANA_CHAIN_ID = '1151111081099710';\n\n// EVM chains (all others default to EVM validation)\nconst NON_EVM_CHAIN_IDS = new Set([\n\tBITCOIN_CHAIN_ID,\n\tTRON_CHAIN_ID,\n\tSOLANA_CHAIN_ID,\n]);\n\nfunction isValidEvmAddress(address: string): boolean {\n\treturn /^0x[0-9a-fA-F]{40}$/.test(address);\n}\n\nfunction isValidBitcoinAddress(address: string): boolean {\n\t// P2PKH (1...), P2SH (3...)\n\tif (/^[13]/.test(address)) {\n\t\treturn /^(1[1-9A-HJ-NP-Za-km-z]{25,34}|3[1-9A-HJ-NP-Za-km-z]{25,34})$/.test(\n\t\t\taddress\n\t\t);\n\t}\n\t// Bech32 — must be single-case (lowercase or uppercase, not mixed)\n\tif (/^bc1/.test(address)) {\n\t\treturn /^bc1[0-9a-z]{25,62}$/.test(address);\n\t}\n\tif (/^BC1/.test(address)) {\n\t\treturn /^BC1[0-9A-Z]{25,62}$/.test(address);\n\t}\n\treturn false;\n}\n\nfunction isValidTronAddress(address: string): boolean {\n\t// Tron addresses start with T and are 34 chars, base58\n\treturn /^T[1-9A-HJ-NP-Za-km-z]{33}$/.test(address);\n}\n\nfunction isValidSolanaAddress(address: string): boolean {\n\treturn isValidPublicKey(address);\n}\n\n/**\n * Validates a recipient address based on the destination chain.\n * EVM chains use 0x-prefixed hex address format.\n * Bitcoin, Tron, and Solana each have their own format.\n */\nexport function isValidAddressForChain(\n\taddress: string,\n\tchainId: string | null\n): boolean {\n\tif (!address || !chainId) return false;\n\n\tif (chainId === BITCOIN_CHAIN_ID) return isValidBitcoinAddress(address);\n\tif (chainId === TRON_CHAIN_ID) return isValidTronAddress(address);\n\tif (chainId === SOLANA_CHAIN_ID) return isValidSolanaAddress(address);\n\n\treturn isValidEvmAddress(address);\n}\n\n/**\n * Returns a human-readable address format hint for the given chain.\n */\nexport function getAddressFormatHint(chainId: string | null): string {\n\tif (!chainId) return 'address';\n\tif (chainId === BITCOIN_CHAIN_ID) return 'Bitcoin address (1.., 3.., bc1..)';\n\tif (chainId === TRON_CHAIN_ID) return 'Tron address (T..)';\n\tif (chainId === SOLANA_CHAIN_ID) return 'Solana address';\n\treturn 'EVM address (0x..)';\n}\n\nexport function isEvmChain(chainId: string): boolean {\n\treturn !NON_EVM_CHAIN_IDS.has(chainId);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@drift-labs/common",
-	"version": "1.0.54",
+	"version": "1.0.56",
 	"description": "Common functions for Drift",
 	"main": "./lib/index.js",
 	"types": "./lib/index.d.ts",