tbc-tx-parser 0.1.0

package/dist/utils/token-amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-amount.d.ts","sourceRoot":"","sources":["../../src/utils/token-amount.ts"],"names":[],"mappings":"AAmCA,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExF;AAGD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvF"}

package/dist/utils/token-amount.js

@@ -0,0 +1,37 @@
+// Token amount formatting uses smallest units internally and scales by decimal for display.
+const MAX_TOKEN_DISPLAY_DECIMALS = 6;
+const MAX_SAFE_DECIMALS = 18;
+// Clamp decimals read from on-chain tape to a safe range to bound processing cost for malformed input.
+function normalizeDecimal(decimal) {
+    if (!Number.isFinite(decimal)) {
+        return 0;
+    }
+    return Math.min(Math.max(Math.floor(decimal), 0), MAX_SAFE_DECIMALS);
+}
+// Format a smallest-unit amount for humans without rounding away significant trailing digits.
+function formatMinimalUnitAmount(rawAmount, decimal, maxFractionDigits) {
+    const value = typeof rawAmount === 'bigint' ? rawAmount : BigInt(rawAmount || '0');
+    const safeDecimal = normalizeDecimal(decimal);
+    if (safeDecimal === 0) {
+        return value.toString();
+    }
+    const divisor = BigInt(10) ** BigInt(safeDecimal);
+    const integerPart = value / divisor;
+    const fractionPart = value % divisor;
+    if (fractionPart === BigInt(0)) {
+        return integerPart.toString();
+    }
+    const displayDecimals = Math.min(safeDecimal, Math.max(Math.floor(maxFractionDigits), 0));
+    const fractionStr = fractionPart.toString().padStart(safeDecimal, '0').slice(0, displayDecimals);
+    return `${integerPart.toString()}.${fractionStr}`;
+}
+// Display at most six decimal places by default for UI and semantic display amounts.
+export function formatTokenRawAmount(rawAmount, decimal) {
+    return formatMinimalUnitAmount(rawAmount, decimal, MAX_TOKEN_DISPLAY_DECIMALS);
+}
+// Support legacy numeric amounts while preferring raw and display fields for exact values.
+export function toTokenAmountNumber(rawAmount, decimal) {
+    const n = Number(formatMinimalUnitAmount(rawAmount, decimal, MAX_SAFE_DECIMALS));
+    return Number.isFinite(n) ? n : 0;
+}
+//# sourceMappingURL=token-amount.js.map

package/dist/utils/token-amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-amount.js","sourceRoot":"","sources":["../../src/utils/token-amount.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,0BAA0B,GAAG,CAAC,CAAC;AACrC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,uGAAuG;AACvG,SAAS,gBAAgB,CAAC,OAAe;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACvE,CAAC;AAED,8FAA8F;AAC9F,SAAS,uBAAuB,CAAC,SAA0B,EAAE,OAAe,EAAE,iBAAyB;IACrG,MAAM,KAAK,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC;IACnF,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;IACpC,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;IACrC,IAAI,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACjG,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,WAAW,EAAE,CAAC;AACpD,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAAC,SAA0B,EAAE,OAAe;IAC9E,OAAO,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC;AACjF,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,mBAAmB,CAAC,SAA0B,EAAE,OAAe;IAC7E,MAAM,CAAC,GAAG,MAAM,CAAC,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "tbc-tx-parser",
+  "version": "0.1.0",
+  "description": "Decode TBC txraw hex into structured transaction facts.",
+  "type": "module",
+  "packageManager": "pnpm@10.25.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.check.json",
+    "test": "vitest run tests/unit tests/integration",
+    "generate:decode-cases": "vitest run tests/decode",
+    "pool-nft:preflight": "node --experimental-strip-types scripts/pool-nft.ts preflight",
+    "pool-nft:run": "node --experimental-strip-types scripts/pool-nft.ts run",
+    "pool-nft:status": "node --experimental-strip-types scripts/pool-nft.ts status",
+    "pool-nft:fixtures": "npm run build && node --experimental-strip-types scripts/generate-pool-nft-fixtures.ts",
+    "prepack": "pnpm build",
+    "prepublishOnly": "pnpm build && pnpm typecheck && pnpm test"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "~5.8.0",
+    "vitest": "^3.2.0"
+  },
+  "keywords": [
+    "tbc",
+    "txraw",
+    "decoder",
+    "blockchain",
+    "transaction"
+  ],
+  "dependencies": {
+    "tbc-contract": "1.6.5",
+    "tbc-lib-js": "^1.0.30"
+  }
+}