@totemsdk/txpow 1.0.2 → 1.1.1

package/dist/difficulty.d.ts

@@ -8,6 +8,30 @@
 export interface TxPowParams {
     minTxPowWork: string;
 }
+/** Anything that can expose a node's live minimum TxPoW work (hex). */
+export interface MinWorkSource {
+    getMinTxPowWork?(): Promise<string | null>;
+}
+/**
+ * Convert a live `currentmintxpowwork` value (32-byte hex target) into a mining
+ * target, applying the same 10% margin the node's own wallet uses
+ * (`minwork * 10 / 11`, see Java `TxPoWGenerator.generateTxPoW`).
+ *
+ * `TxPoWChecker.checkTxPoWSimple` rejects only when
+ * `txnDifficulty > magic.getMinTxPowWork()`, so a target that is harder than
+ * the live minimum is always accepted; the margin absorbs the tiny per-block
+ * Magic retarget.
+ */
+export declare function targetFromMinWork(minWorkHex: string): Uint8Array;
+/**
+ * Resolve the TxPoW mining target from a live node when it exposes
+ * `getMinTxPowWork()`, otherwise fall back to `TX_POW_MIN_DIFFICULTY`.
+ *
+ * Never throws: a node/protocol hiccup must not block transaction
+ * construction. The fallback is the protocol default target (MAX/1e6), which
+ * is harder than the network hard floor (`Magic.MIN_HASHES = 10000`).
+ */
+export declare function resolveTxPowTarget(source?: MinWorkSource | null, fallback?: Uint8Array): Promise<Uint8Array>;
 /**
  * Fetch the current minimum TxPoW work from the Axia API.
  *

package/dist/difficulty.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * difficulty.ts — Fetch and manage the TxPoW difficulty target.
  *
@@ -6,9 +5,58 @@
  * On any error (timeout, network failure, invalid response) we fall back to
  * the hardcoded TX_POW_MIN_DIFFICULTY constant, which is the protocol floor.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchTxPowTarget = fetchTxPowTarget;
-const constants_js_1 = require("./constants.js");
+import { TX_POW_MIN_DIFFICULTY } from './constants.js';
+/**
+ * Convert a live `currentmintxpowwork` value (32-byte hex target) into a mining
+ * target, applying the same 10% margin the node's own wallet uses
+ * (`minwork * 10 / 11`, see Java `TxPoWGenerator.generateTxPoW`).
+ *
+ * `TxPoWChecker.checkTxPoWSimple` rejects only when
+ * `txnDifficulty > magic.getMinTxPowWork()`, so a target that is harder than
+ * the live minimum is always accepted; the margin absorbs the tiny per-block
+ * Magic retarget.
+ */
+export function targetFromMinWork(minWorkHex) {
+    const clean = minWorkHex.replace(/^0x/i, '').trim();
+    if (clean.length === 0 || clean.length > 64 || !/^[0-9a-fA-F]+$/.test(clean)) {
+        throw new Error(`Invalid minTxPowWork: ${minWorkHex}`);
+    }
+    const value = BigInt('0x' + clean);
+    const adjusted = (value * 10n) / 11n;
+    const target = adjusted > 0n ? adjusted : value;
+    let hex = target.toString(16);
+    if (hex.length % 2 !== 0)
+        hex = '0' + hex;
+    while (hex.length < 64)
+        hex = '0' + hex;
+    const out = new Uint8Array(32);
+    for (let i = 0; i < 32; i++) {
+        out[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return out;
+}
+/**
+ * Resolve the TxPoW mining target from a live node when it exposes
+ * `getMinTxPowWork()`, otherwise fall back to `TX_POW_MIN_DIFFICULTY`.
+ *
+ * Never throws: a node/protocol hiccup must not block transaction
+ * construction. The fallback is the protocol default target (MAX/1e6), which
+ * is harder than the network hard floor (`Magic.MIN_HASHES = 10000`).
+ */
+export async function resolveTxPowTarget(source, fallback = TX_POW_MIN_DIFFICULTY) {
+    try {
+        const hex = await source?.getMinTxPowWork?.();
+        if (hex) {
+            const target = targetFromMinWork(hex);
+            if (target.some((b) => b !== 0))
+                return target;
+        }
+    }
+    catch {
+        // fall through to the constant
+    }
+    return new Uint8Array(fallback);
+}
 function hexToBytes(hex) {
     const h = hex.startsWith('0x') ? hex.slice(2) : hex;
     const out = new Uint8Array(h.length / 2);
@@ -26,7 +74,7 @@ function hexToBytes(hex) {
  * @param axiaBaseUrl  Base URL of the Axia API, e.g. "https://api.axia.to"
  * @param timeoutMs    Request timeout in ms (default: 3000)
  */
-async function fetchTxPowTarget(axiaBaseUrl, timeoutMs = 3000) {
+export async function fetchTxPowTarget(axiaBaseUrl, timeoutMs = 3000) {
     try {
         const base = axiaBaseUrl.replace(/\/$/, '');
         const url = `${base}/v1/wallet/txpow-params`;
@@ -53,6 +101,6 @@ async function fetchTxPowTarget(axiaBaseUrl, timeoutMs = 3000) {
         return hexToBytes(clean);
     }
     catch {
-        return new Uint8Array(constants_js_1.TX_POW_MIN_DIFFICULTY);
+        return new Uint8Array(TX_POW_MIN_DIFFICULTY);
     }
 }

package/dist/index.d.ts

@@ -22,7 +22,7 @@ export { MAX_HASH, ZERO_HASH, TX_POW_MIN_DIFFICULTY, CASCADE_LEVELS, MAIN_NET_CH
 export { serializeMagic } from './magic.js';
 export { mineTxPoW, mineTxPoWInProcess, mineHeaderTail, buildHeaderTail, isLessThan, setBrowserWorkerUrl, type MineResult, type MineOptions, } from './mine.js';
 export { setWasmUrl, getBrowserWasmUrl, isWasmAvailable } from './mine-wasm.js';
-export { fetchTxPowTarget, type TxPowParams } from './difficulty.js';
+export { fetchTxPowTarget, targetFromMinWork, resolveTxPowTarget, type TxPowParams, type MinWorkSource, } from './difficulty.js';
 export { verifyProofOfWork, verifyTxPoWWork, verifyTxPoWParts, type VerifyResult } from './verify.js';
 export { calibrateHashRate, estimateMiningCost, type MiningEstimate, } from './calibrate.js';
 export { createWorkChallenge, validateWorkChallenge, challengeFingerprint, canonicalChallenge, computeActionCommitment, canonicalAction, mineWorkAdmission, verifyWorkAdmission, buildBlockHeaderTail, serializeSuperParents, isBlockWinner, computeSuperLevel, templateFreshness, computeBlockCandidateId, buildEmptyBlockBody, buildEmptyTransactionBytes, buildEmptyWitnessBytes, buildEmptyBurnTxBytes, buildEmptyBurnWitnessBytes, assembleTxPoWEnvelope, reconstructTxPoWEnvelope, MACHINE_WORK_ADMISSION_VERSION, MACHINE_WORK_DOMAIN, DEFAULT_CHALLENGE_TTL_MS, MAX_CHALLENGE_TTL_MS, type WorkChallenge, type MachineWorkAction, type MinimaWorkTemplate, type MinimaWorkTemplateProvider, type MinimaWorkRelay, type MachineWorkAdmissionProof, type WorkAdmissionVerification, type MineWorkAdmissionOptions, type VerifyWorkAdmissionOptions, } from './admission/index.js';

package/dist/index.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * @totemsdk/txpow
  *
@@ -18,68 +17,16 @@
  *   const check = verifyProofOfWork(txpowId, mTxnDifficulty);
  *   if (!check.valid) drop(check.reason);
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_CHALLENGE_TTL_MS = exports.DEFAULT_CHALLENGE_TTL_MS = exports.MACHINE_WORK_DOMAIN = exports.MACHINE_WORK_ADMISSION_VERSION = exports.reconstructTxPoWEnvelope = exports.assembleTxPoWEnvelope = exports.buildEmptyBurnWitnessBytes = exports.buildEmptyBurnTxBytes = exports.buildEmptyWitnessBytes = exports.buildEmptyTransactionBytes = exports.buildEmptyBlockBody = exports.computeBlockCandidateId = exports.templateFreshness = exports.computeSuperLevel = exports.isBlockWinner = exports.serializeSuperParents = exports.buildBlockHeaderTail = exports.verifyWorkAdmission = exports.mineWorkAdmission = exports.canonicalAction = exports.computeActionCommitment = exports.canonicalChallenge = exports.challengeFingerprint = exports.validateWorkChallenge = exports.createWorkChallenge = exports.estimateMiningCost = exports.calibrateHashRate = exports.verifyTxPoWParts = exports.verifyTxPoWWork = exports.verifyProofOfWork = exports.fetchTxPowTarget = exports.isWasmAvailable = exports.getBrowserWasmUrl = exports.setWasmUrl = exports.setBrowserWorkerUrl = exports.isLessThan = exports.buildHeaderTail = exports.mineHeaderTail = exports.mineTxPoWInProcess = exports.mineTxPoW = exports.serializeMagic = exports.MAIN_NET_CHAIN_ID = exports.CASCADE_LEVELS = exports.TX_POW_MIN_DIFFICULTY = exports.ZERO_HASH = exports.MAX_HASH = exports.computeTxPoWId = exports.serializeTxPoW = exports.serializeTxBody = exports.serializeTxHeader = void 0;
-var serialization_js_1 = require("./serialization.js");
-Object.defineProperty(exports, "serializeTxHeader", { enumerable: true, get: function () { return serialization_js_1.serializeTxHeader; } });
-Object.defineProperty(exports, "serializeTxBody", { enumerable: true, get: function () { return serialization_js_1.serializeTxBody; } });
-Object.defineProperty(exports, "serializeTxPoW", { enumerable: true, get: function () { return serialization_js_1.serializeTxPoW; } });
-Object.defineProperty(exports, "computeTxPoWId", { enumerable: true, get: function () { return serialization_js_1.computeTxPoWId; } });
-var constants_js_1 = require("./constants.js");
-Object.defineProperty(exports, "MAX_HASH", { enumerable: true, get: function () { return constants_js_1.MAX_HASH; } });
-Object.defineProperty(exports, "ZERO_HASH", { enumerable: true, get: function () { return constants_js_1.ZERO_HASH; } });
-Object.defineProperty(exports, "TX_POW_MIN_DIFFICULTY", { enumerable: true, get: function () { return constants_js_1.TX_POW_MIN_DIFFICULTY; } });
-Object.defineProperty(exports, "CASCADE_LEVELS", { enumerable: true, get: function () { return constants_js_1.CASCADE_LEVELS; } });
-Object.defineProperty(exports, "MAIN_NET_CHAIN_ID", { enumerable: true, get: function () { return constants_js_1.MAIN_NET_CHAIN_ID; } });
-var magic_js_1 = require("./magic.js");
-Object.defineProperty(exports, "serializeMagic", { enumerable: true, get: function () { return magic_js_1.serializeMagic; } });
-var mine_js_1 = require("./mine.js");
-Object.defineProperty(exports, "mineTxPoW", { enumerable: true, get: function () { return mine_js_1.mineTxPoW; } });
-Object.defineProperty(exports, "mineTxPoWInProcess", { enumerable: true, get: function () { return mine_js_1.mineTxPoWInProcess; } });
-Object.defineProperty(exports, "mineHeaderTail", { enumerable: true, get: function () { return mine_js_1.mineHeaderTail; } });
-Object.defineProperty(exports, "buildHeaderTail", { enumerable: true, get: function () { return mine_js_1.buildHeaderTail; } });
-Object.defineProperty(exports, "isLessThan", { enumerable: true, get: function () { return mine_js_1.isLessThan; } });
-Object.defineProperty(exports, "setBrowserWorkerUrl", { enumerable: true, get: function () { return mine_js_1.setBrowserWorkerUrl; } });
-var mine_wasm_js_1 = require("./mine-wasm.js");
-Object.defineProperty(exports, "setWasmUrl", { enumerable: true, get: function () { return mine_wasm_js_1.setWasmUrl; } });
-Object.defineProperty(exports, "getBrowserWasmUrl", { enumerable: true, get: function () { return mine_wasm_js_1.getBrowserWasmUrl; } });
-Object.defineProperty(exports, "isWasmAvailable", { enumerable: true, get: function () { return mine_wasm_js_1.isWasmAvailable; } });
-var difficulty_js_1 = require("./difficulty.js");
-Object.defineProperty(exports, "fetchTxPowTarget", { enumerable: true, get: function () { return difficulty_js_1.fetchTxPowTarget; } });
-var verify_js_1 = require("./verify.js");
-Object.defineProperty(exports, "verifyProofOfWork", { enumerable: true, get: function () { return verify_js_1.verifyProofOfWork; } });
-Object.defineProperty(exports, "verifyTxPoWWork", { enumerable: true, get: function () { return verify_js_1.verifyTxPoWWork; } });
-Object.defineProperty(exports, "verifyTxPoWParts", { enumerable: true, get: function () { return verify_js_1.verifyTxPoWParts; } });
-var calibrate_js_1 = require("./calibrate.js");
-Object.defineProperty(exports, "calibrateHashRate", { enumerable: true, get: function () { return calibrate_js_1.calibrateHashRate; } });
-Object.defineProperty(exports, "estimateMiningCost", { enumerable: true, get: function () { return calibrate_js_1.estimateMiningCost; } });
+export { serializeTxHeader, serializeTxBody, serializeTxPoW, computeTxPoWId, } from './serialization.js';
+export { MAX_HASH, ZERO_HASH, TX_POW_MIN_DIFFICULTY, CASCADE_LEVELS, MAIN_NET_CHAIN_ID, } from './constants.js';
+export { serializeMagic } from './magic.js';
+export { mineTxPoW, mineTxPoWInProcess, mineHeaderTail, buildHeaderTail, isLessThan, setBrowserWorkerUrl, } from './mine.js';
+export { setWasmUrl, getBrowserWasmUrl, isWasmAvailable } from './mine-wasm.js';
+export { fetchTxPowTarget, targetFromMinWork, resolveTxPowTarget, } from './difficulty.js';
+export { verifyProofOfWork, verifyTxPoWWork, verifyTxPoWParts } from './verify.js';
+export { calibrateHashRate, estimateMiningCost, } from './calibrate.js';
 // ── Machine Work Admission ──────────────────────────────────────────────────
 // Receiver-controlled computational admission bound to a real Minima block
 // candidate. The same nonce search that admits a machine action also searches
 // for Minima blocks (Super-0 … Super-31).
-var index_js_1 = require("./admission/index.js");
-Object.defineProperty(exports, "createWorkChallenge", { enumerable: true, get: function () { return index_js_1.createWorkChallenge; } });
-Object.defineProperty(exports, "validateWorkChallenge", { enumerable: true, get: function () { return index_js_1.validateWorkChallenge; } });
-Object.defineProperty(exports, "challengeFingerprint", { enumerable: true, get: function () { return index_js_1.challengeFingerprint; } });
-Object.defineProperty(exports, "canonicalChallenge", { enumerable: true, get: function () { return index_js_1.canonicalChallenge; } });
-Object.defineProperty(exports, "computeActionCommitment", { enumerable: true, get: function () { return index_js_1.computeActionCommitment; } });
-Object.defineProperty(exports, "canonicalAction", { enumerable: true, get: function () { return index_js_1.canonicalAction; } });
-Object.defineProperty(exports, "mineWorkAdmission", { enumerable: true, get: function () { return index_js_1.mineWorkAdmission; } });
-Object.defineProperty(exports, "verifyWorkAdmission", { enumerable: true, get: function () { return index_js_1.verifyWorkAdmission; } });
-Object.defineProperty(exports, "buildBlockHeaderTail", { enumerable: true, get: function () { return index_js_1.buildBlockHeaderTail; } });
-Object.defineProperty(exports, "serializeSuperParents", { enumerable: true, get: function () { return index_js_1.serializeSuperParents; } });
-Object.defineProperty(exports, "isBlockWinner", { enumerable: true, get: function () { return index_js_1.isBlockWinner; } });
-Object.defineProperty(exports, "computeSuperLevel", { enumerable: true, get: function () { return index_js_1.computeSuperLevel; } });
-Object.defineProperty(exports, "templateFreshness", { enumerable: true, get: function () { return index_js_1.templateFreshness; } });
-Object.defineProperty(exports, "computeBlockCandidateId", { enumerable: true, get: function () { return index_js_1.computeBlockCandidateId; } });
-Object.defineProperty(exports, "buildEmptyBlockBody", { enumerable: true, get: function () { return index_js_1.buildEmptyBlockBody; } });
-Object.defineProperty(exports, "buildEmptyTransactionBytes", { enumerable: true, get: function () { return index_js_1.buildEmptyTransactionBytes; } });
-Object.defineProperty(exports, "buildEmptyWitnessBytes", { enumerable: true, get: function () { return index_js_1.buildEmptyWitnessBytes; } });
-Object.defineProperty(exports, "buildEmptyBurnTxBytes", { enumerable: true, get: function () { return index_js_1.buildEmptyBurnTxBytes; } });
-Object.defineProperty(exports, "buildEmptyBurnWitnessBytes", { enumerable: true, get: function () { return index_js_1.buildEmptyBurnWitnessBytes; } });
-Object.defineProperty(exports, "assembleTxPoWEnvelope", { enumerable: true, get: function () { return index_js_1.assembleTxPoWEnvelope; } });
-Object.defineProperty(exports, "reconstructTxPoWEnvelope", { enumerable: true, get: function () { return index_js_1.reconstructTxPoWEnvelope; } });
-Object.defineProperty(exports, "MACHINE_WORK_ADMISSION_VERSION", { enumerable: true, get: function () { return index_js_1.MACHINE_WORK_ADMISSION_VERSION; } });
-Object.defineProperty(exports, "MACHINE_WORK_DOMAIN", { enumerable: true, get: function () { return index_js_1.MACHINE_WORK_DOMAIN; } });
-Object.defineProperty(exports, "DEFAULT_CHALLENGE_TTL_MS", { enumerable: true, get: function () { return index_js_1.DEFAULT_CHALLENGE_TTL_MS; } });
-Object.defineProperty(exports, "MAX_CHALLENGE_TTL_MS", { enumerable: true, get: function () { return index_js_1.MAX_CHALLENGE_TTL_MS; } });
+export { createWorkChallenge, validateWorkChallenge, challengeFingerprint, canonicalChallenge, computeActionCommitment, canonicalAction, mineWorkAdmission, verifyWorkAdmission, buildBlockHeaderTail, serializeSuperParents, isBlockWinner, computeSuperLevel, templateFreshness, computeBlockCandidateId, buildEmptyBlockBody, buildEmptyTransactionBytes, buildEmptyWitnessBytes, buildEmptyBurnTxBytes, buildEmptyBurnWitnessBytes, assembleTxPoWEnvelope, reconstructTxPoWEnvelope, MACHINE_WORK_ADMISSION_VERSION, MACHINE_WORK_DOMAIN, DEFAULT_CHALLENGE_TTL_MS, MAX_CHALLENGE_TTL_MS, } from './admission/index.js';

package/dist/magic.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * magic.ts — Serialize the Minima Magic struct.
  *
@@ -17,19 +16,17 @@
  *   maxTxnPerBlock = 256
  *   minTxPoWWork  = MAX_HASH (all 0xFF, 32 bytes) — placeholder in fresh TxPoW
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeMagic = serializeMagic;
-const core_1 = require("@totemsdk/core");
-const constants_js_1 = require("./constants.js");
-function serializeMagic() {
+import { writeMiniNumber, writeMiniData, concat } from '@totemsdk/core';
+import { MAX_HASH } from './constants.js';
+export function serializeMagic() {
     const parts = [];
-    parts.push((0, core_1.writeMiniNumber)(65536n, 0));
-    parts.push((0, core_1.writeMiniNumber)(1024n, 0));
-    parts.push((0, core_1.writeMiniNumber)(256n, 0));
-    parts.push((0, core_1.writeMiniData)(constants_js_1.MAX_HASH));
-    parts.push((0, core_1.writeMiniNumber)(65536n, 0));
-    parts.push((0, core_1.writeMiniNumber)(1024n, 0));
-    parts.push((0, core_1.writeMiniNumber)(256n, 0));
-    parts.push((0, core_1.writeMiniData)(constants_js_1.MAX_HASH));
-    return (0, core_1.concat)(...parts);
+    parts.push(writeMiniNumber(65536n, 0));
+    parts.push(writeMiniNumber(1024n, 0));
+    parts.push(writeMiniNumber(256n, 0));
+    parts.push(writeMiniData(MAX_HASH));
+    parts.push(writeMiniNumber(65536n, 0));
+    parts.push(writeMiniNumber(1024n, 0));
+    parts.push(writeMiniNumber(256n, 0));
+    parts.push(writeMiniData(MAX_HASH));
+    return concat(...parts);
 }

package/dist/mine-wasm.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * mine-wasm.ts — WASM mining loop loader and wrapper.
  *
@@ -26,17 +25,11 @@
  *
  * mine() returns the found nonce, or -1 (0xFFFFFFFF) if no nonce found in chunk.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WASM_HEADER_OFFSET = void 0;
-exports.setWasmUrl = setWasmUrl;
-exports.getBrowserWasmUrl = getBrowserWasmUrl;
-exports.isWasmAvailable = isWasmAvailable;
-exports.mineChunkWasm = mineChunkWasm;
-const core_1 = require("@totemsdk/core");
+import { sha3_256 as nobleSha3_256 } from '@totemsdk/core';
 /** Byte offset in WASM linear memory where the hash output is written. */
 const HASH_OUT_OFFSET = 0;
 /** First byte of the header region (after the 32-byte hash output buffer). */
-exports.WASM_HEADER_OFFSET = 32;
+export const WASM_HEADER_OFFSET = 32;
 /**
  * Sentinel returned by WASM mine() when no nonce is found in the chunk.
  * The WAT uses `i32.const -1` (= 0xFFFFFFFF bit pattern).
@@ -58,7 +51,7 @@ let _browserWasmUrl = null;
  *   import { setWasmUrl } from '@totemsdk/txpow';
  *   setWasmUrl(browser.runtime.getURL('miner.wasm'));
  */
-function setWasmUrl(url) {
+export function setWasmUrl(url) {
     _browserWasmUrl = url;
     _loadAttempted = false;
     _instance = null;
@@ -68,7 +61,7 @@ function setWasmUrl(url) {
  * Return the current browser WASM URL, or null if not yet configured.
  * Used by the main thread to pass the URL into spawned browser Web Workers.
  */
-function getBrowserWasmUrl() {
+export function getBrowserWasmUrl() {
     return _browserWasmUrl;
 }
 let _instance = null;
@@ -89,7 +82,7 @@ function buildImports() {
                 const memView = new Uint8Array(_memory.buffer);
                 // Slice to get a clean copy unaffected by future mutations
                 const input = memView.slice(headerPtr, headerPtr + headerLen);
-                const hash = (0, core_1.sha3_256)(input);
+                const hash = nobleSha3_256(input);
                 memView.set(hash, outPtr);
             },
         },
@@ -159,7 +152,7 @@ async function loadWasm() {
  * Returns true when the WASM binary is loaded and `mine` is ready to use.
  * Cached after the first call; subsequent calls are synchronous (via memoised flag).
  */
-async function isWasmAvailable() {
+export async function isWasmAvailable() {
     return (await loadWasm()) !== null;
 }
 /**
@@ -180,7 +173,7 @@ async function isWasmAvailable() {
  * @param startNonce  First nonce value to try.
  * @param chunkCount  Number of consecutive nonce values to try.
  */
-async function mineChunkWasm(headerBuf, nonceOffset, nonceLen, target, startNonce, chunkCount) {
+export async function mineChunkWasm(headerBuf, nonceOffset, nonceLen, target, startNonce, chunkCount) {
     const inst = await loadWasm();
     if (!inst || !_memory)
         return null;
@@ -189,7 +182,7 @@ async function mineChunkWasm(headerBuf, nonceOffset, nonceLen, target, startNonc
     // instance exports (which has no such property → undefined), making headerPtr=0.
     const wasmExports = inst.exports;
     // Memory layout: [0..31]=hash output, [32..32+headerLen-1]=header, [32+headerLen..32+headerLen+31]=target
-    const headerPtr = exports.WASM_HEADER_OFFSET;
+    const headerPtr = WASM_HEADER_OFFSET;
     const targetPtr = headerPtr + headerBuf.length;
     const totalNeeded = targetPtr + 32;
     // Grow memory if necessary

package/dist/mine.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * mine.ts — Local TxPoW proof-of-work mining loop.
  *
@@ -27,18 +26,11 @@
  *   This means `source` is always accurate: 'wasm' when the binary was used for
  *   the winning chunk; 'js' when the JS path found the nonce.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isLessThan = isLessThan;
-exports.buildHeaderTail = buildHeaderTail;
-exports.setBrowserWorkerUrl = setBrowserWorkerUrl;
-exports.mineHeaderTail = mineHeaderTail;
-exports.mineTxPoWInProcess = mineTxPoWInProcess;
-exports.mineTxPoW = mineTxPoW;
-const core_1 = require("@totemsdk/core");
-const core_2 = require("@totemsdk/core");
-const magic_js_1 = require("./magic.js");
-const constants_js_1 = require("./constants.js");
-const mine_wasm_js_1 = require("./mine-wasm.js");
+import { sha3_256 } from '@totemsdk/core';
+import { writeMiniNumber, writeMiniData, writeHashToStream, concat, } from '@totemsdk/core';
+import { serializeMagic } from './magic.js';
+import { MAX_HASH, ZERO_HASH, CASCADE_LEVELS, MAIN_NET_CHAIN_ID } from './constants.js';
+import { mineChunkWasm, isWasmAvailable, getBrowserWasmUrl } from './mine-wasm.js';
 // ─────────────────────────────────────────────────────────────────────────────
 // Internal helpers
 // ─────────────────────────────────────────────────────────────────────────────
@@ -46,7 +38,7 @@ const mine_wasm_js_1 = require("./mine-wasm.js");
  * Big-endian 256-bit comparison: true if a < b.
  * Used to check: txpowId < mTxnDifficulty.
  */
-function isLessThan(a, b) {
+export function isLessThan(a, b) {
     for (let i = 0; i < 32; i++) {
         if (a[i] < b[i])
             return true;
@@ -65,7 +57,7 @@ function isLessThan(a, b) {
  *   k=3: 2^23 = 8388608
  */
 function nextNonceBoundary(nonce) {
-    const nonceValueLen = (0, core_2.writeMiniNumber)(nonce, 0).length - 2;
+    const nonceValueLen = writeMiniNumber(nonce, 0).length - 2;
     return 2n ** BigInt(8 * nonceValueLen - 1);
 }
 /**
@@ -78,8 +70,8 @@ function nextNonceBoundary(nonce) {
  * mining (Machine Work Admission) builds its own tail via
  * `admission/template.ts` with real chain state and a customHash commitment.
  */
-function buildHeaderTail(txBodyHash, timeMilli) {
-    return (0, core_2.concat)((0, core_2.writeMiniData)(constants_js_1.MAIN_NET_CHAIN_ID), (0, core_2.writeMiniNumber)(timeMilli, 0), (0, core_2.writeMiniNumber)(0n, 0), (0, core_2.writeMiniData)(constants_js_1.MAX_HASH), new Uint8Array([constants_js_1.CASCADE_LEVELS]), (0, core_2.writeHashToStream)(constants_js_1.ZERO_HASH), (0, core_2.writeHashToStream)(constants_js_1.ZERO_HASH), (0, core_2.writeMiniNumber)(0n, 0), (0, magic_js_1.serializeMagic)(), (0, core_2.writeHashToStream)(constants_js_1.ZERO_HASH), (0, core_2.writeHashToStream)(txBodyHash));
+export function buildHeaderTail(txBodyHash, timeMilli) {
+    return concat(writeMiniData(MAIN_NET_CHAIN_ID), writeMiniNumber(timeMilli, 0), writeMiniNumber(0n, 0), writeMiniData(MAX_HASH), new Uint8Array([CASCADE_LEVELS]), writeHashToStream(ZERO_HASH), writeHashToStream(ZERO_HASH), writeMiniNumber(0n, 0), serializeMagic(), writeHashToStream(ZERO_HASH), writeHashToStream(txBodyHash));
 }
 /**
  * Synchronously mine a chunk of nonces within a fixed encoding boundary.
@@ -95,7 +87,7 @@ function mineChunkJs(headerBuf, nonceValueLen, target, startNonce, endNonce) {
             headerBuf[nonceValueOffset + i] = Number(n & 0xffn);
             n >>= 8n;
         }
-        const hash = (0, core_1.sha3_256)(headerBuf);
+        const hash = sha3_256(headerBuf);
         if (isLessThan(hash, target))
             return nonce;
     }
@@ -116,7 +108,7 @@ let _browserWorkerUrl = null;
  *   import { setBrowserWorkerUrl } from '@totemsdk/txpow';
  *   setBrowserWorkerUrl(browser.runtime.getURL('mine-worker.js'));
  */
-function setBrowserWorkerUrl(url) {
+export function setBrowserWorkerUrl(url) {
     _browserWorkerUrl = url;
 }
 /**
@@ -170,7 +162,7 @@ async function mineTxPoWViaBrowserWorker(txBodyBytes, txnDifficulty, options) {
         // Pass the WASM URL so the worker can call setWasmUrl() in its own JS context.
         // Web Workers have isolated module state — the main thread's setWasmUrl() call
         // does not carry over. Without this the worker mines in pure JS.
-        const wasmUrl = (0, mine_wasm_js_1.getBrowserWasmUrl)();
+        const wasmUrl = getBrowserWasmUrl();
         worker.postMessage({
             txBodyBytes: Array.from(txBodyBytes),
             txnDifficulty: Array.from(txnDifficulty),
@@ -301,14 +293,14 @@ async function mineTxPoWViaNodeWorker(txBodyBytes, txnDifficulty, options) {
  * @param target      32-byte difficulty target (big-endian 256-bit).
  * @param options     Chunk size, max iterations, abort signal, timeMilli override.
  */
-async function mineHeaderTail(headerTail, target, options) {
+export async function mineHeaderTail(headerTail, target, options) {
     const chunkSize = BigInt(options?.chunkSize ?? 10000);
     const maxIterations = options?.maxIterations !== undefined
         ? BigInt(options.maxIterations)
         : undefined;
     const signal = options?.signal;
     const forceJs = options?.forceJs ?? false;
-    const useWasm = !forceJs && (await (0, mine_wasm_js_1.isWasmAvailable)());
+    const useWasm = !forceJs && (await isWasmAvailable());
     const startTime = Date.now();
     let totalIterations = 0n;
     let nonce = 0n;
@@ -321,16 +313,16 @@ async function mineHeaderTail(headerTail, target, options) {
         }
         const boundary = nextNonceBoundary(nonce);
         const chunkEnd = nonce + chunkSize < boundary ? nonce + chunkSize : boundary;
-        const nonceBytes = (0, core_2.writeMiniNumber)(nonce, 0);
+        const nonceBytes = writeMiniNumber(nonce, 0);
         const nonceValueLen = nonceBytes.length - 2;
-        const headerBuf = (0, core_2.concat)(nonceBytes, headerTail);
+        const headerBuf = concat(nonceBytes, headerTail);
         // ── CRITICAL: WASM and JS are mutually exclusive per chunk ──────────────
         // When WASM returns null (no nonce in chunk), the chunk has been fully
         // scanned by WASM — we do NOT re-scan it with JS. Doing so would double
         // work and could incorrectly set source='wasm' on a JS-found nonce.
         let found;
         if (useWasm) {
-            found = await (0, mine_wasm_js_1.mineChunkWasm)(headerBuf.slice(), // WASM gets its own copy to avoid aliasing
+            found = await mineChunkWasm(headerBuf.slice(), // WASM gets its own copy to avoid aliasing
             2, nonceValueLen, target, nonce, chunkEnd - nonce);
         }
         else {
@@ -338,9 +330,9 @@ async function mineHeaderTail(headerTail, target, options) {
         }
         // ── End mutually exclusive section ───────────────────────────────────────
         if (found !== null) {
-            const finalNonceBytes = (0, core_2.writeMiniNumber)(found, 0);
-            const finalHeader = (0, core_2.concat)(finalNonceBytes, headerTail);
-            const txpowId = (0, core_1.sha3_256)(finalHeader);
+            const finalNonceBytes = writeMiniNumber(found, 0);
+            const finalHeader = concat(finalNonceBytes, headerTail);
+            const txpowId = sha3_256(finalHeader);
             return {
                 minedHeaderBytes: finalHeader,
                 txpowId,
@@ -365,9 +357,9 @@ async function mineHeaderTail(headerTail, target, options) {
  * Run the mining loop in the current thread/task.
  * Called directly by the Node.js worker, and by the browser code path.
  */
-async function mineTxPoWInProcess(txBodyBytes, txnDifficulty, options) {
+export async function mineTxPoWInProcess(txBodyBytes, txnDifficulty, options) {
     const timeMilli = options?.timeMilli ?? BigInt(Date.now());
-    const bodyHash = (0, core_1.sha3_256)(txBodyBytes);
+    const bodyHash = sha3_256(txBodyBytes);
     const headerTail = buildHeaderTail(bodyHash, timeMilli);
     return mineHeaderTail(headerTail, txnDifficulty, options);
 }
@@ -389,7 +381,7 @@ async function mineTxPoWInProcess(txBodyBytes, txnDifficulty, options) {
  * @param txnDifficulty 32-byte target. MUST be ≤ TX_POW_MIN_DIFFICULTY.
  * @param options       Chunk size, max iterations, abort signal, timeMilli override.
  */
-async function mineTxPoW(txBodyBytes, txnDifficulty, options) {
+export async function mineTxPoW(txBodyBytes, txnDifficulty, options) {
     // ── Node.js: spawn a worker_threads Worker (keeps event loop unblocked) ──
     if (shouldUseNodeWorker(options)) {
         return mineTxPoWViaNodeWorker(txBodyBytes, txnDifficulty, options);

package/dist/serialization.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * serialization.ts — TxPoW envelope serialization.
  *
@@ -51,45 +50,40 @@
  * TxPoW ID:
  *   SHA3-256( TxHeader bytes )  — Java: Crypto.getInstance().hashObject(mHeader)
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeTxHeader = serializeTxHeader;
-exports.computeTxPoWId = computeTxPoWId;
-exports.serializeTxBody = serializeTxBody;
-exports.serializeTxPoW = serializeTxPoW;
-const core_1 = require("@totemsdk/core");
-const core_2 = require("@totemsdk/core");
-const magic_js_1 = require("./magic.js");
-const constants_js_1 = require("./constants.js");
+import { sha3_256 } from '@totemsdk/core';
+import { writeMiniNumber, writeMiniData, concat, writeHashToStream, } from '@totemsdk/core';
+import { serializeMagic } from './magic.js';
+import { MAX_HASH, ZERO_HASH, CASCADE_LEVELS, MAIN_NET_CHAIN_ID, } from './constants.js';
 /**
  * Serialize a TxHeader per Minima's TxHeader.writeDataStream().
  *
  * @param txBodyHash  SHA3-256 of the serialized TxBody (32 bytes)
  * @param options     Optional nonce and timeMilli overrides
  */
-function serializeTxHeader(txBodyHash, options) {
+export function serializeTxHeader(txBodyHash, options) {
     const nonce = options?.nonce ?? 0n;
     const timeMilli = options?.timeMilli ?? BigInt(Date.now());
     const parts = [];
-    parts.push((0, core_2.writeMiniNumber)(nonce, 0));
-    parts.push((0, core_2.writeMiniData)(constants_js_1.MAIN_NET_CHAIN_ID));
-    parts.push((0, core_2.writeMiniNumber)(timeMilli, 0));
-    parts.push((0, core_2.writeMiniNumber)(0n, 0));
-    parts.push((0, core_2.writeMiniData)(constants_js_1.MAX_HASH));
-    parts.push(new Uint8Array([constants_js_1.CASCADE_LEVELS]));
-    parts.push((0, core_2.writeHashToStream)(constants_js_1.ZERO_HASH));
-    parts.push((0, core_2.writeHashToStream)(constants_js_1.ZERO_HASH));
-    parts.push((0, core_2.writeMiniNumber)(0n, 0));
-    parts.push((0, magic_js_1.serializeMagic)());
-    parts.push((0, core_2.writeHashToStream)(constants_js_1.ZERO_HASH));
-    parts.push((0, core_2.writeHashToStream)(txBodyHash));
-    return (0, core_2.concat)(...parts);
+    parts.push(writeMiniNumber(nonce, 0));
+    parts.push(writeMiniData(MAIN_NET_CHAIN_ID));
+    parts.push(writeMiniNumber(timeMilli, 0));
+    parts.push(writeMiniNumber(0n, 0));
+    parts.push(writeMiniData(MAX_HASH));
+    parts.push(new Uint8Array([CASCADE_LEVELS]));
+    parts.push(writeHashToStream(ZERO_HASH));
+    parts.push(writeHashToStream(ZERO_HASH));
+    parts.push(writeMiniNumber(0n, 0));
+    parts.push(serializeMagic());
+    parts.push(writeHashToStream(ZERO_HASH));
+    parts.push(writeHashToStream(txBodyHash));
+    return concat(...parts);
 }
 /**
  * Compute TxPoW ID = SHA3-256(TxHeader bytes).
  * Matches Java: Crypto.getInstance().hashObject(mHeader) via SHA3Digest(256).
  */
-function computeTxPoWId(headerBytes) {
-    return (0, core_1.sha3_256)(headerBytes);
+export function computeTxPoWId(headerBytes) {
+    return sha3_256(headerBytes);
 }
 /**
  * Build the empty burn transaction bytes.
@@ -103,7 +97,7 @@ function computeTxPoWId(headerBytes) {
  *   writeHashToStream([0x00])        linkHash = ZERO_TXPOWID (1 byte)
  */
 function buildEmptyBurnTxBytes() {
-    return (0, core_2.concat)((0, core_2.writeMiniNumber)(0n, 0), (0, core_2.writeMiniNumber)(0n, 0), (0, core_2.writeMiniNumber)(0n, 0), (0, core_2.writeHashToStream)(new Uint8Array([0x00])));
+    return concat(writeMiniNumber(0n, 0), writeMiniNumber(0n, 0), writeMiniNumber(0n, 0), writeHashToStream(new Uint8Array([0x00])));
 }
 /**
  * Build the empty burn witness bytes.
@@ -114,7 +108,7 @@ function buildEmptyBurnTxBytes() {
  *   writeMiniNumber(0n)   scriptproof count
  */
 function buildEmptyBurnWitnessBytes() {
-    return (0, core_2.concat)((0, core_2.writeMiniNumber)(0n, 0), (0, core_2.writeMiniNumber)(0n, 0), (0, core_2.writeMiniNumber)(0n, 0));
+    return concat(writeMiniNumber(0n, 0), writeMiniNumber(0n, 0), writeMiniNumber(0n, 0));
 }
 /**
  * Serialize a TxBody per Minima's TxBody.writeDataStream().
@@ -123,8 +117,8 @@ function buildEmptyBurnWitnessBytes() {
  * @param witnessBytes  Pre-serialized Witness bytes (from extension's serializeWitness)
  * @param options       Optional txnDifficulty override and test PRNG
  */
-function serializeTxBody(txBytes, witnessBytes, options) {
-    const txnDifficulty = options?.txnDifficulty ?? constants_js_1.MAX_HASH;
+export function serializeTxBody(txBytes, witnessBytes, options) {
+    const txnDifficulty = options?.txnDifficulty ?? MAX_HASH;
     let prng;
     if (options?.prng) {
         prng = options.prng;
@@ -137,7 +131,7 @@ function serializeTxBody(txBytes, witnessBytes, options) {
         crypto.getRandomValues(fresh);
         prng = fresh;
     }
-    return (0, core_2.concat)((0, core_2.writeHashToStream)(prng), (0, core_2.writeMiniData)(txnDifficulty), txBytes, witnessBytes, buildEmptyBurnTxBytes(), buildEmptyBurnWitnessBytes(), (0, core_2.writeMiniNumber)(0n, 0));
+    return concat(writeHashToStream(prng), writeMiniData(txnDifficulty), txBytes, witnessBytes, buildEmptyBurnTxBytes(), buildEmptyBurnWitnessBytes(), writeMiniNumber(0n, 0));
 }
 /**
  * Serialize a complete TxPoW per Minima's TxPoW.writeDataStream().
@@ -153,8 +147,8 @@ function serializeTxBody(txBytes, witnessBytes, options) {
  * @param witnessBytes  Pre-serialized Witness bytes
  * @param options       Optional txnDifficulty, nonce, timeMilli, prng
  */
-function serializeTxPoW(txBytes, witnessBytes, options) {
+export function serializeTxPoW(txBytes, witnessBytes, options) {
     const txBody = serializeTxBody(txBytes, witnessBytes, options);
-    const txBodyHash = (0, core_1.sha3_256)(txBody);
-    return (0, core_2.concat)(serializeTxHeader(txBodyHash, options), new Uint8Array([0x01]), txBody);
+    const txBodyHash = sha3_256(txBody);
+    return concat(serializeTxHeader(txBodyHash, options), new Uint8Array([0x01]), txBody);
 }