@ysk-mint/sdk 1.0.0

package/dist/validation/native.js

@@ -0,0 +1,53 @@
+import { ErrorCode } from "../errors/codes.js";
+import { err } from "../errors/decode.js";
+const NEAR_ACCOUNT = /^(([a-z\d]+[-_])*[a-z\d]+\.)*([a-z\d]+[-_])*[a-z\d]+$/;
+export function isNearAccountId(id) {
+    return id.length > 1 && id.length <= 64 && NEAR_ACCOUNT.test(id);
+}
+export function isCardanoAddress(addr) {
+    return /^(addr1|addr_test1|stake1|stake_test1)[0-9a-z]+$/.test(addr) || /^[0-9a-f]{16,}$/i.test(addr);
+}
+const B58 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+/** Solana pubkey: base58 of 32 bytes. */
+export function isSolanaAddress(addr) {
+    if (addr.length < 32 || addr.length > 44)
+        return false;
+    const bytes = [];
+    for (const ch of addr) {
+        const val = B58.indexOf(ch);
+        if (val < 0)
+            return false;
+        let carry = val;
+        for (let i = 0; i < bytes.length; i++) {
+            const x = bytes[i] * 58 + carry;
+            bytes[i] = x & 0xff;
+            carry = x >> 8;
+        }
+        while (carry > 0) {
+            bytes.push(carry & 0xff);
+            carry >>= 8;
+        }
+    }
+    for (const ch of addr) {
+        if (ch !== "1")
+            break;
+        bytes.push(0);
+    }
+    return bytes.length === 32;
+}
+export function validateNearAccount(id, locale = "en") {
+    if (!isNearAccountId(id))
+        return [err(ErrorCode.RecipientZero, [], locale)];
+    return [];
+}
+export function validateCardanoAddress(addr, locale = "en") {
+    if (!isCardanoAddress(addr))
+        return [err(ErrorCode.RecipientZero, [], locale)];
+    return [];
+}
+export function validateSolanaAddress(addr, locale = "en") {
+    if (!isSolanaAddress(addr))
+        return [err(ErrorCode.RecipientZero, [], locale)];
+    return [];
+}
+//# sourceMappingURL=native.js.map

package/dist/validation/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/validation/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAG1C,MAAM,YAAY,GAChB,uDAAuD,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,kDAAkD,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,GAAG,GAAG,4DAA4D,CAAC;AAEzE,yCAAyC;AACzC,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,KAAK,GAAG,GAAG,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,EAAE,GAAG,KAAK,CAAC;YACjC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACpB,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;YACzB,KAAK,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,EAAE,KAAK,GAAG;YAAE,MAAM;QACtB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,SAAiB,IAAI;IACnE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,SAAiB,IAAI;IACxE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/E,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAAiB,IAAI;IACvE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9E,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/validation/token.d.ts

@@ -0,0 +1,17 @@
+import { type LaunchError } from "../errors/codes.js";
+import type { Locale } from "../errors/messages.js";
+export declare function utf8Bytes(value: string): number;
+export declare function validateName(name: string, locale?: Locale): LaunchError[];
+export declare function validateSymbol(symbol: string, locale?: Locale): LaunchError[];
+export declare function validateDecimals(decimals: number, locale?: Locale): LaunchError[];
+export declare function validateSupply(supply: bigint, locale?: Locale): LaunchError[];
+export declare function validateSupplyMode(mode: number, locale?: Locale): LaunchError[];
+export declare function validateModuleFlags(flags: number, locale?: Locale): LaunchError[];
+export declare function validateTax(buyBps: number, sellBps: number, recipient: `0x${string}` | string, locale?: Locale): LaunchError[];
+export declare function validateBasics(input: {
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: bigint;
+}, locale?: Locale): LaunchError[];
+//# sourceMappingURL=token.d.ts.map

package/dist/validation/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/validation/token.ts"],"names":[],"mappings":"AAaA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,WAAW,EAAE,CAM/E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,WAAW,EAAE,CASnF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,WAAW,EAAE,CAKvF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,WAAW,EAAE,CAInF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,WAAW,EAAE,CAKrF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,WAAW,EAAE,CAGvF;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,EACjC,MAAM,GAAE,MAAa,GACpB,WAAW,EAAE,CASf;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAC9E,MAAM,GAAE,MAAa,GACpB,WAAW,EAAE,CAOf"}

package/dist/validation/token.js

@@ -0,0 +1,73 @@
+import { DECIMALS_MAX, DECIMALS_MIN, MODULE_ALL_MASK, NAME_MAX_BYTES, NAME_MIN_BYTES, SYMBOL_MAX_BYTES, SYMBOL_MIN_BYTES, MAX_SUPPLY, SupplyMode, TAX_MAX_BPS_ONE_SIDE, TAX_MAX_BPS_SUM, } from "@ysk-mint/config";
+import { ErrorCode } from "../errors/codes.js";
+import { err } from "../errors/decode.js";
+const encoder = new TextEncoder();
+export function utf8Bytes(value) {
+    return encoder.encode(value).length;
+}
+export function validateName(name, locale = "en") {
+    const errors = [];
+    const bytes = utf8Bytes(name);
+    if (bytes < NAME_MIN_BYTES || bytes > NAME_MAX_BYTES)
+        errors.push(err(ErrorCode.InvalidName, [], locale));
+    else if (name.trim().length === 0)
+        errors.push(err(ErrorCode.InvalidName, [], locale));
+    return errors;
+}
+export function validateSymbol(symbol, locale = "en") {
+    const errors = [];
+    const bytes = utf8Bytes(symbol);
+    if (bytes < SYMBOL_MIN_BYTES || bytes > SYMBOL_MAX_BYTES) {
+        errors.push(err(ErrorCode.InvalidSymbol, [], locale));
+        return errors;
+    }
+    if (!/^[A-Za-z0-9]+$/.test(symbol))
+        errors.push(err(ErrorCode.InvalidSymbol, [], locale));
+    return errors;
+}
+export function validateDecimals(decimals, locale = "en") {
+    if (!Number.isInteger(decimals) || decimals < DECIMALS_MIN || decimals > DECIMALS_MAX) {
+        return [err(ErrorCode.DecimalsOutOfRange, [decimals], locale)];
+    }
+    return [];
+}
+export function validateSupply(supply, locale = "en") {
+    if (supply === 0n)
+        return [err(ErrorCode.SupplyZero, [], locale)];
+    if (supply > MAX_SUPPLY)
+        return [err(ErrorCode.SupplyOverflow, [supply], locale)];
+    return [];
+}
+export function validateSupplyMode(mode, locale = "en") {
+    if (mode !== SupplyMode.Fixed && mode !== SupplyMode.Mintable) {
+        return [err(ErrorCode.InvalidSupplyMode, [mode], locale)];
+    }
+    return [];
+}
+export function validateModuleFlags(flags, locale = "en") {
+    if ((flags & ~MODULE_ALL_MASK) !== 0)
+        return [err(ErrorCode.UnknownModule, [flags], locale)];
+    return [];
+}
+export function validateTax(buyBps, sellBps, recipient, locale = "en") {
+    const errors = [];
+    if (buyBps > TAX_MAX_BPS_ONE_SIDE)
+        errors.push(err(ErrorCode.TaxTooHigh, [buyBps], locale));
+    if (sellBps > TAX_MAX_BPS_ONE_SIDE)
+        errors.push(err(ErrorCode.TaxTooHigh, [sellBps], locale));
+    if (buyBps + sellBps > TAX_MAX_BPS_SUM)
+        errors.push(err(ErrorCode.TaxTooHigh, [buyBps + sellBps], locale));
+    if ((buyBps > 0 || sellBps > 0) && (!recipient || recipient === "0x0000000000000000000000000000000000000000")) {
+        errors.push(err(ErrorCode.RecipientZero, [], locale));
+    }
+    return errors;
+}
+export function validateBasics(input, locale = "en") {
+    return [
+        ...validateName(input.name, locale),
+        ...validateSymbol(input.symbol, locale),
+        ...validateDecimals(input.decimals, locale),
+        ...validateSupply(input.totalSupply, locale),
+    ];
+}
+//# sourceMappingURL=token.js.map

package/dist/validation/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/validation/token.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ysk-mint/sdk",
+  "version": "1.0.0",
+  "description": "Enums, error codes, validation, and OFT helpers for YSK Mint.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yanshekki/ysk-mint.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://mint.ysk.hk",
+  "bugs": {
+    "url": "https://github.com/yanshekki/ysk-mint/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "viem": "^2.28.0",
+    "@ysk-mint/config": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.9"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}