@totemsdk/core 1.2.5 → 1.2.7

package/dist/cjs/index.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * @module @totemsdk/core
+ * Core cryptographic primitives, adapters, and utilities for Minima blockchain.
+ *
+ * Cryptographic primitives are backed by Rust/WASM (@totemsdk/core-wasm).
+ * Legacy JS implementations are available at @totemsdk/core/legacy.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateChallenge = exports.createChallenge = exports.timingSafeEqual = exports.computeTransactionDigest = exports.serializeTransaction = exports.wotsAddressFromKeypair = exports.parseMxAddress = exports.makeMxAddress = exports.cleanSeedPhrase = exports.validatePhrase = exports.generateWordList = exports.phraseToSeed = exports.verifyMMRProof = exports.mmrRootFromPublicKeys = exports.verifyTreeSignature = exports.deriveUnifiedAddressPublicKey = exports.createUnifiedRootTreeKey = exports.createUnifiedChildTreeKey = exports.precomputeTransactionCoinID = exports.writeMiniString = exports.writeMiniData = exports.writeMiniNumber = exports.deriveRootPrivSeed = exports.derivePerAddressSeed = exports.deriveChainSeedJava = exports.wotsKeypairFromSeed = exports.wotsPublicKeyFromSeed = exports.wotsPkFromSig = exports.wotsVerifyDigest = exports.wotsVerify = exports.wotsSign = exports.deriveFullPublicKey = exports.derivePKdigest = exports.hashChain = exports.expandPrivateKey = exports.sha3_256 = exports.concatBytes = exports.hexToBytes = exports.bytesToHex = exports.TransactionReceiptStore = exports.WatermarkExhaustedError = exports.TransactionLifecycleError = exports.TransactionLifecycle = exports.TransactionService = exports.flatIndexFromLanes = exports.finalizeLease = exports.prepareLease = exports.LeaseMonitor = exports.WatermarkStore = exports.LeaseStore = void 0;
+exports.hex = exports.F = exports.createPerAddressTreeKeyAsync = exports.createPerAddressTreeKey = exports.createUnifiedChildTreeKeyAsync = exports.DEFAULT_LEVELS = exports.DEFAULT_KEYS_PER_LEVEL = exports.getRootPublicKey = exports.deserializeTreeSignature = exports.serializeTreeSignature = exports.TreeKeyNode = exports.TreeKey = exports.serializeMMREntry = exports.serializeMMRData = exports.serializeMMREntryNumber = exports.createMMREntryNumber = exports.deriveUnifiedChildSeed = exports.indexToMiniDataBytes = exports.javaHashAllObjects = exports.writeHashToStream = exports.serializeMiniNumberONE = exports.serializeMiniNumberZERO = exports.hashObject = exports.deriveChildTreeSeedJava = exports.hashAllObjects = exports.serializeMiniData = exports.serializeMiniNumber = exports.bigIntToByteArray = exports.concat = exports.writeMMREntryNumber = exports.writeMiniByte = exports.normalizeHex = exports.deriveAddressFromPublicKey = exports.verifyTreeSignatureDetailed = exports.verifySignatureDetailed = exports.verifySignature = exports.buildMinimaCoin = exports.createDefaultTransaction = exports.serializeCoin = exports.parseDecimalToMiniNumber = exports.MiniNumber = exports.generateSeedPhrase = exports.convertWordListToSeed = exports.convertStringToSeed = exports.WORD_LIST = exports.addressToRoot = exports.scriptToAddress = exports.decodeMx = exports.encodeMx = exports.scriptFromWotsPk = void 0;
+exports.MINIMA_CONSTANTS = exports.bytesToUtf8 = exports.utf8ToBytes = exports.hashCanonical = exports.canonicalJson = exports.toHex = exports.wotsSignLegacy = exports.baseWWithChecksum = exports.toWinternitzDigits = exports.prfChainSeed = exports.h = exports.assert32 = exports.u32be = exports.u16be = exports.fromHex = void 0;
+exports.mxToHex = mxToHex;
+// Version information for bundle duplication detection
+__exportStar(require("./version.js"), exports);
+// Platform-agnostic Adapters (SDK Upgrade)
+__exportStar(require("./adapters/index.js"), exports);
+// Lease Management (SDK Upgrade) - exclude conflicting WotsIndices
+var index_js_1 = require("./lease/index.js");
+Object.defineProperty(exports, "LeaseStore", { enumerable: true, get: function () { return index_js_1.LeaseStore; } });
+Object.defineProperty(exports, "WatermarkStore", { enumerable: true, get: function () { return index_js_1.WatermarkStore; } });
+Object.defineProperty(exports, "LeaseMonitor", { enumerable: true, get: function () { return index_js_1.LeaseMonitor; } });
+Object.defineProperty(exports, "prepareLease", { enumerable: true, get: function () { return index_js_1.prepareLease; } });
+Object.defineProperty(exports, "finalizeLease", { enumerable: true, get: function () { return index_js_1.finalizeLease; } });
+Object.defineProperty(exports, "flatIndexFromLanes", { enumerable: true, get: function () { return index_js_1.flatIndexFromLanes; } });
+// Transaction Management (SDK Upgrade) - exclude conflicting WotsIndices
+var index_js_2 = require("./tx/index.js");
+Object.defineProperty(exports, "TransactionService", { enumerable: true, get: function () { return index_js_2.TransactionService; } });
+Object.defineProperty(exports, "TransactionLifecycle", { enumerable: true, get: function () { return index_js_2.TransactionLifecycle; } });
+Object.defineProperty(exports, "TransactionLifecycleError", { enumerable: true, get: function () { return index_js_2.TransactionLifecycleError; } });
+Object.defineProperty(exports, "WatermarkExhaustedError", { enumerable: true, get: function () { return index_js_2.WatermarkExhaustedError; } });
+Object.defineProperty(exports, "TransactionReceiptStore", { enumerable: true, get: function () { return index_js_2.TransactionReceiptStore; } });
+// ---------------------------------------------------------------------------
+// Cryptographic primitives — backed by Rust/WASM (@totemsdk/core-wasm)
+// ---------------------------------------------------------------------------
+// Utilities
+var wasm_sync_js_1 = require("./wasm-sync.js");
+Object.defineProperty(exports, "bytesToHex", { enumerable: true, get: function () { return wasm_sync_js_1.bytesToHex; } });
+Object.defineProperty(exports, "hexToBytes", { enumerable: true, get: function () { return wasm_sync_js_1.hexToBytes; } });
+Object.defineProperty(exports, "concatBytes", { enumerable: true, get: function () { return wasm_sync_js_1.concatBytes; } });
+const wasm_sync_js_2 = require("./wasm-sync.js");
+// SHA3-256
+var wasm_sync_js_3 = require("./wasm-sync.js");
+Object.defineProperty(exports, "sha3_256", { enumerable: true, get: function () { return wasm_sync_js_3.sha3_256; } });
+// WOTS Signatures
+var wasm_sync_js_4 = require("./wasm-sync.js");
+Object.defineProperty(exports, "expandPrivateKey", { enumerable: true, get: function () { return wasm_sync_js_4.expandPrivateKey; } });
+Object.defineProperty(exports, "hashChain", { enumerable: true, get: function () { return wasm_sync_js_4.hashChain; } });
+Object.defineProperty(exports, "derivePKdigest", { enumerable: true, get: function () { return wasm_sync_js_4.derivePKdigest; } });
+Object.defineProperty(exports, "deriveFullPublicKey", { enumerable: true, get: function () { return wasm_sync_js_4.deriveFullPublicKey; } });
+Object.defineProperty(exports, "wotsSign", { enumerable: true, get: function () { return wasm_sync_js_4.wotsSign; } });
+Object.defineProperty(exports, "wotsVerify", { enumerable: true, get: function () { return wasm_sync_js_4.wotsVerify; } });
+Object.defineProperty(exports, "wotsVerifyDigest", { enumerable: true, get: function () { return wasm_sync_js_4.wotsVerifyDigest; } });
+Object.defineProperty(exports, "wotsPkFromSig", { enumerable: true, get: function () { return wasm_sync_js_4.wotsPkFromSig; } });
+Object.defineProperty(exports, "wotsPublicKeyFromSeed", { enumerable: true, get: function () { return wasm_sync_js_4.wotsPublicKeyFromSeed; } });
+Object.defineProperty(exports, "wotsKeypairFromSeed", { enumerable: true, get: function () { return wasm_sync_js_4.wotsKeypairFromSeed; } });
+// WOTS Params (from params.ts — constants, no crypto)
+__exportStar(require("./params.js"), exports);
+// Java-Compatible Serialization
+var wasm_sync_js_5 = require("./wasm-sync.js");
+Object.defineProperty(exports, "deriveChainSeedJava", { enumerable: true, get: function () { return wasm_sync_js_5.deriveChainSeedJava; } });
+Object.defineProperty(exports, "derivePerAddressSeed", { enumerable: true, get: function () { return wasm_sync_js_5.derivePerAddressSeed; } });
+Object.defineProperty(exports, "deriveRootPrivSeed", { enumerable: true, get: function () { return wasm_sync_js_5.deriveRootPrivSeed; } });
+Object.defineProperty(exports, "writeMiniNumber", { enumerable: true, get: function () { return wasm_sync_js_5.writeMiniNumber; } });
+Object.defineProperty(exports, "writeMiniData", { enumerable: true, get: function () { return wasm_sync_js_5.writeMiniData; } });
+Object.defineProperty(exports, "writeMiniString", { enumerable: true, get: function () { return wasm_sync_js_5.writeMiniString; } });
+Object.defineProperty(exports, "precomputeTransactionCoinID", { enumerable: true, get: function () { return wasm_sync_js_5.precomputeTransactionCoinID; } });
+// TreeKey/TreeKeyNode — WASM-backed
+// createUnifiedChildTreeKey / createUnifiedRootTreeKey come from the TS
+// implementation (returning a full TreeKey object with setUses/sign/getPublicKey)
+// to match the object API that downstream consumers (server, root-identity)
+// rely on. The WASM binding only returns the root public key bytes.
+var treekey_js_1 = require("./treekey.js");
+Object.defineProperty(exports, "createUnifiedChildTreeKey", { enumerable: true, get: function () { return treekey_js_1.createUnifiedChildTreeKey; } });
+Object.defineProperty(exports, "createUnifiedRootTreeKey", { enumerable: true, get: function () { return treekey_js_1.createUnifiedRootTreeKey; } });
+Object.defineProperty(exports, "deriveUnifiedAddressPublicKey", { enumerable: true, get: function () { return treekey_js_1.deriveUnifiedAddressPublicKey; } });
+Object.defineProperty(exports, "verifyTreeSignature", { enumerable: true, get: function () { return treekey_js_1.verifyTreeSignature; } });
+var wasm_sync_js_6 = require("./wasm-sync.js");
+Object.defineProperty(exports, "mmrRootFromPublicKeys", { enumerable: true, get: function () { return wasm_sync_js_6.mmrRootFromPublicKeys; } });
+Object.defineProperty(exports, "verifyMMRProof", { enumerable: true, get: function () { return wasm_sync_js_6.verifyMMRProof; } });
+// BIP39 Seed Phrase Handling
+// NOTE: the TS implementation (bip39.ts) uses the complete 2048-word BIP39
+// word list and Minima-compatible uppercase canonicalization. The WASM
+// binding (wasm-sync.ts) ships a corrupted/partial word list (missing
+// "hungry", contains spurious words) and lowercases instead of uppercasing,
+// so the public API routes through the TS implementation.
+var bip39_js_1 = require("./bip39.js");
+Object.defineProperty(exports, "phraseToSeed", { enumerable: true, get: function () { return bip39_js_1.phraseToSeed; } });
+Object.defineProperty(exports, "generateWordList", { enumerable: true, get: function () { return bip39_js_1.generateWordList; } });
+Object.defineProperty(exports, "validatePhrase", { enumerable: true, get: function () { return bip39_js_1.validatePhrase; } });
+Object.defineProperty(exports, "cleanSeedPhrase", { enumerable: true, get: function () { return bip39_js_1.cleanSeedPhrase; } });
+// Address Derivation
+var wasm_sync_js_7 = require("./wasm-sync.js");
+Object.defineProperty(exports, "makeMxAddress", { enumerable: true, get: function () { return wasm_sync_js_7.makeMxAddress; } });
+Object.defineProperty(exports, "parseMxAddress", { enumerable: true, get: function () { return wasm_sync_js_7.parseMxAddress; } });
+Object.defineProperty(exports, "wotsAddressFromKeypair", { enumerable: true, get: function () { return wasm_sync_js_7.wotsAddressFromKeypair; } });
+// Transaction Serialization & Digest
+var wasm_sync_js_8 = require("./wasm-sync.js");
+Object.defineProperty(exports, "serializeTransaction", { enumerable: true, get: function () { return wasm_sync_js_8.serializeTransaction; } });
+Object.defineProperty(exports, "computeTransactionDigest", { enumerable: true, get: function () { return wasm_sync_js_8.computeTransactionDigest; } });
+// Verification
+var wasm_sync_js_9 = require("./wasm-sync.js");
+Object.defineProperty(exports, "timingSafeEqual", { enumerable: true, get: function () { return wasm_sync_js_9.timingSafeEqual; } });
+Object.defineProperty(exports, "createChallenge", { enumerable: true, get: function () { return wasm_sync_js_9.createChallenge; } });
+Object.defineProperty(exports, "validateChallenge", { enumerable: true, get: function () { return wasm_sync_js_9.validateChallenge; } });
+// ---------------------------------------------------------------------------
+// TypeScript-only modules (no crypto — keep as-is)
+// ---------------------------------------------------------------------------
+// Script helpers (for address derivation)
+var script_js_1 = require("./script.js");
+Object.defineProperty(exports, "scriptFromWotsPk", { enumerable: true, get: function () { return script_js_1.scriptFromWotsPk; } });
+// Base32 Encoding (Minima-compatible) — re-export from WASM
+var wasm_sync_js_10 = require("./wasm-sync.js");
+Object.defineProperty(exports, "encodeMx", { enumerable: true, get: function () { return wasm_sync_js_10.makeMxAddress; } });
+Object.defineProperty(exports, "decodeMx", { enumerable: true, get: function () { return wasm_sync_js_10.parseMxAddress; } });
+/** Convert an Mx (radix-32) or hex Minima address to lowercase hex. */
+function mxToHex(address) {
+    const upper = address.startsWith('0x') || address.startsWith('0X') ? address.slice(2) : address;
+    return upper.toUpperCase().startsWith('MX')
+        ? (0, wasm_sync_js_2.bytesToHex)((0, wasm_sync_js_2.parseMxAddress)(address))
+        : upper.replace(/^0x/i, '');
+}
+// Merkle Mountain Range (original JS — types and helpers)
+__exportStar(require("./mmr.js"), exports);
+// Script Types, Witness Serializer, Contract Helpers
+__exportStar(require("./scripts/index.js"), exports);
+// Address Derivation (original)
+var derive_js_1 = require("./derive.js");
+Object.defineProperty(exports, "scriptToAddress", { enumerable: true, get: function () { return derive_js_1.scriptToAddress; } });
+Object.defineProperty(exports, "addressToRoot", { enumerable: true, get: function () { return derive_js_1.addressToRoot; } });
+// BIP39 — re-export word list and legacy helpers from JS
+var bip39_js_2 = require("./bip39.js");
+Object.defineProperty(exports, "WORD_LIST", { enumerable: true, get: function () { return bip39_js_2.WORD_LIST; } });
+Object.defineProperty(exports, "convertStringToSeed", { enumerable: true, get: function () { return bip39_js_2.convertStringToSeed; } });
+Object.defineProperty(exports, "convertWordListToSeed", { enumerable: true, get: function () { return bip39_js_2.convertWordListToSeed; } });
+Object.defineProperty(exports, "generateSeedPhrase", { enumerable: true, get: function () { return bip39_js_2.generateSeedPhrase; } });
+// MiniNumber class (matches Java MiniNumber/BigDecimal semantics)
+var MiniNumber_js_1 = require("./MiniNumber.js");
+Object.defineProperty(exports, "MiniNumber", { enumerable: true, get: function () { return MiniNumber_js_1.MiniNumber; } });
+// Transaction types (from JS)
+var transaction_js_1 = require("./transaction.js");
+Object.defineProperty(exports, "parseDecimalToMiniNumber", { enumerable: true, get: function () { return transaction_js_1.parseDecimalToMiniNumber; } });
+Object.defineProperty(exports, "serializeCoin", { enumerable: true, get: function () { return transaction_js_1.serializeCoin; } });
+Object.defineProperty(exports, "createDefaultTransaction", { enumerable: true, get: function () { return transaction_js_1.createDefaultTransaction; } });
+Object.defineProperty(exports, "buildMinimaCoin", { enumerable: true, get: function () { return transaction_js_1.buildMinimaCoin; } });
+// High-level Verification API (convenience functions for integrators)
+var verify_js_1 = require("./verify.js");
+Object.defineProperty(exports, "verifySignature", { enumerable: true, get: function () { return verify_js_1.verifySignature; } });
+Object.defineProperty(exports, "verifySignatureDetailed", { enumerable: true, get: function () { return verify_js_1.verifySignatureDetailed; } });
+Object.defineProperty(exports, "verifyTreeSignatureDetailed", { enumerable: true, get: function () { return verify_js_1.verifyTreeSignatureDetailed; } });
+Object.defineProperty(exports, "deriveAddressFromPublicKey", { enumerable: true, get: function () { return verify_js_1.deriveAddressFromPublicKey; } });
+Object.defineProperty(exports, "normalizeHex", { enumerable: true, get: function () { return verify_js_1.normalizeHex; } });
+// Streamable primitives (low-level serialization building blocks)
+var Streamable_js_1 = require("./Streamable.js");
+Object.defineProperty(exports, "writeMiniByte", { enumerable: true, get: function () { return Streamable_js_1.writeMiniByte; } });
+Object.defineProperty(exports, "writeMMREntryNumber", { enumerable: true, get: function () { return Streamable_js_1.writeMMREntryNumber; } });
+Object.defineProperty(exports, "concat", { enumerable: true, get: function () { return Streamable_js_1.concat; } });
+Object.defineProperty(exports, "bigIntToByteArray", { enumerable: true, get: function () { return Streamable_js_1.bigIntToByteArray; } });
+// Java-Compatible Serialization Helpers (non-crypto)
+var javaStreamables_js_1 = require("./javaStreamables.js");
+Object.defineProperty(exports, "serializeMiniNumber", { enumerable: true, get: function () { return javaStreamables_js_1.serializeMiniNumber; } });
+Object.defineProperty(exports, "serializeMiniData", { enumerable: true, get: function () { return javaStreamables_js_1.serializeMiniData; } });
+Object.defineProperty(exports, "hashAllObjects", { enumerable: true, get: function () { return javaStreamables_js_1.hashAllObjects; } });
+Object.defineProperty(exports, "deriveChildTreeSeedJava", { enumerable: true, get: function () { return javaStreamables_js_1.deriveChildTreeSeedJava; } });
+Object.defineProperty(exports, "hashObject", { enumerable: true, get: function () { return javaStreamables_js_1.hashObject; } });
+Object.defineProperty(exports, "serializeMiniNumberZERO", { enumerable: true, get: function () { return javaStreamables_js_1.serializeMiniNumberZERO; } });
+Object.defineProperty(exports, "serializeMiniNumberONE", { enumerable: true, get: function () { return javaStreamables_js_1.serializeMiniNumberONE; } });
+Object.defineProperty(exports, "writeHashToStream", { enumerable: true, get: function () { return javaStreamables_js_1.writeHashToStream; } });
+Object.defineProperty(exports, "javaHashAllObjects", { enumerable: true, get: function () { return javaStreamables_js_1.javaHashAllObjects; } });
+Object.defineProperty(exports, "indexToMiniDataBytes", { enumerable: true, get: function () { return javaStreamables_js_1.indexToMiniDataBytes; } });
+Object.defineProperty(exports, "deriveUnifiedChildSeed", { enumerable: true, get: function () { return javaStreamables_js_1.deriveUnifiedChildSeed; } });
+Object.defineProperty(exports, "createMMREntryNumber", { enumerable: true, get: function () { return javaStreamables_js_1.createMMREntryNumber; } });
+Object.defineProperty(exports, "serializeMMREntryNumber", { enumerable: true, get: function () { return javaStreamables_js_1.serializeMMREntryNumber; } });
+Object.defineProperty(exports, "serializeMMRData", { enumerable: true, get: function () { return javaStreamables_js_1.serializeMMRData; } });
+Object.defineProperty(exports, "serializeMMREntry", { enumerable: true, get: function () { return javaStreamables_js_1.serializeMMREntry; } });
+// TreeKey/TreeKeyNode — JS types and helpers
+var treekey_js_2 = require("./treekey.js");
+Object.defineProperty(exports, "TreeKey", { enumerable: true, get: function () { return treekey_js_2.TreeKey; } });
+Object.defineProperty(exports, "TreeKeyNode", { enumerable: true, get: function () { return treekey_js_2.TreeKeyNode; } });
+Object.defineProperty(exports, "serializeTreeSignature", { enumerable: true, get: function () { return treekey_js_2.serializeTreeSignature; } });
+Object.defineProperty(exports, "deserializeTreeSignature", { enumerable: true, get: function () { return treekey_js_2.deserializeTreeSignature; } });
+Object.defineProperty(exports, "getRootPublicKey", { enumerable: true, get: function () { return treekey_js_2.getRootPublicKey; } });
+Object.defineProperty(exports, "DEFAULT_KEYS_PER_LEVEL", { enumerable: true, get: function () { return treekey_js_2.DEFAULT_KEYS_PER_LEVEL; } });
+Object.defineProperty(exports, "DEFAULT_LEVELS", { enumerable: true, get: function () { return treekey_js_2.DEFAULT_LEVELS; } });
+Object.defineProperty(exports, "createUnifiedChildTreeKeyAsync", { enumerable: true, get: function () { return treekey_js_2.createUnifiedChildTreeKeyAsync; } });
+Object.defineProperty(exports, "createPerAddressTreeKey", { enumerable: true, get: function () { return treekey_js_2.createPerAddressTreeKey; } });
+Object.defineProperty(exports, "createPerAddressTreeKeyAsync", { enumerable: true, get: function () { return treekey_js_2.createPerAddressTreeKeyAsync; } });
+var wots_js_1 = require("./wots.js");
+Object.defineProperty(exports, "F", { enumerable: true, get: function () { return wots_js_1.F; } });
+Object.defineProperty(exports, "hex", { enumerable: true, get: function () { return wots_js_1.hex; } });
+Object.defineProperty(exports, "fromHex", { enumerable: true, get: function () { return wots_js_1.fromHex; } });
+Object.defineProperty(exports, "u16be", { enumerable: true, get: function () { return wots_js_1.u16be; } });
+Object.defineProperty(exports, "u32be", { enumerable: true, get: function () { return wots_js_1.u32be; } });
+Object.defineProperty(exports, "assert32", { enumerable: true, get: function () { return wots_js_1.assert32; } });
+Object.defineProperty(exports, "h", { enumerable: true, get: function () { return wots_js_1.h; } });
+Object.defineProperty(exports, "prfChainSeed", { enumerable: true, get: function () { return wots_js_1.prfChainSeed; } });
+Object.defineProperty(exports, "toWinternitzDigits", { enumerable: true, get: function () { return wots_js_1.toWinternitzDigits; } });
+Object.defineProperty(exports, "baseWWithChecksum", { enumerable: true, get: function () { return wots_js_1.baseWWithChecksum; } });
+Object.defineProperty(exports, "wotsSignLegacy", { enumerable: true, get: function () { return wots_js_1.wotsSignLegacy; } });
+// Canonical helpers (deterministic JSON + hashing)
+var canonical_js_1 = require("./canonical.js");
+Object.defineProperty(exports, "toHex", { enumerable: true, get: function () { return canonical_js_1.toHex; } });
+Object.defineProperty(exports, "canonicalJson", { enumerable: true, get: function () { return canonical_js_1.canonicalJson; } });
+Object.defineProperty(exports, "hashCanonical", { enumerable: true, get: function () { return canonical_js_1.hashCanonical; } });
+// Byte/string utilities
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "utf8ToBytes", { enumerable: true, get: function () { return utils_js_1.utf8ToBytes; } });
+Object.defineProperty(exports, "bytesToUtf8", { enumerable: true, get: function () { return utils_js_1.bytesToUtf8; } });
+// Constants
+exports.MINIMA_CONSTANTS = {
+    WOTS_W: 8,
+    WOTS_N: 32,
+    MAX_SIGNATURES: 262144,
+    SIGNATURE_LEVELS: 3,
+    ADDRESS_PREFIX: 'Mx',
+    NETWORK_ID: 1
+};

package/dist/cjs/javaStreamables.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Java-Compatible Serialization Helpers
+ *
+ * Matches Minima Java serialization exactly:
+ * - MiniNumber.java: writeDataStream / readDataStream
+ * - MiniData.java: writeDataStream / readDataStream
+ * - Crypto.java: hashAllObjects - serializes Streamables then SHA3-256
+ *
+ * These helpers are used for seed derivation to match TreeKeyNode.java:
+ *   MiniData seed = Crypto.getInstance().hashAllObjects(new MiniNumber(i), zPrivateSeed);
+ *
+ * NOTE: This module provides number-based wrappers for backward compatibility.
+ * The canonical implementations are in Streamable.ts which uses bigint for precision.
+ */
+/**
+ * Serialize a number in MiniNumber format (Java compatible)
+ *
+ * Thin wrapper over Streamable.writeMiniNumber that accepts number for backward compatibility.
+ *
+ * @param n - Non-negative integer to serialize
+ * @returns Serialized bytes matching Java MiniNumber format
+ */
+export declare function serializeMiniNumber(n: number): Uint8Array;
+/**
+ * Serialize bytes in MiniData format (Java compatible)
+ *
+ * Re-export of Streamable.writeMiniData for backward compatibility.
+ *
+ * @param data - Bytes to serialize
+ * @returns Serialized bytes matching Java MiniData format
+ */
+export declare function serializeMiniData(data: Uint8Array): Uint8Array;
+/**
+ * Hash multiple Streamable objects (Java compatible)
+ *
+ * From Crypto.java hashAllObjects:
+ *   1. Write each object to DataOutputStream
+ *   2. SHA3-256 hash the combined bytes
+ *
+ * This matches TreeKeyNode.java seed derivation:
+ *   Crypto.getInstance().hashAllObjects(new MiniNumber(i), zPrivateSeed)
+ *
+ * @param items - Array of serialized objects (use serializeMiniNumber/serializeMiniData)
+ * @returns 32-byte SHA3-256 hash
+ */
+export declare function hashAllObjects(...items: Uint8Array[]): Uint8Array;
+/**
+ * Derive per-chain seed matching Java TreeKeyNode.java exactly
+ *
+ * From TreeKeyNode.java constructor (line 43-44):
+ *   MiniData seed = Crypto.getInstance().hashAllObjects(new MiniNumber(i), zPrivateSeed);
+ *
+ * @param privateSeed - 32-byte private seed
+ * @param index - Chain index (0-63)
+ * @returns 32-byte derived seed for this chain
+ */
+export declare function deriveChainSeedJava(privateSeed: Uint8Array, index: number): Uint8Array;
+/**
+ * Derive child tree seed matching Java TreeKeyNode.java exactly
+ *
+ * From TreeKeyNode.java getChild (line 68):
+ *   MiniData seed = Crypto.getInstance().hashAllObjects(new MiniNumber(zChild), mChildSeed);
+ *
+ * The child seed is derived from parent's private seed:
+ *   mChildSeed = Crypto.getInstance().hashObject(zPrivateSeed); // line 30
+ *
+ * @param childSeed - 32-byte child seed (hash of parent's private seed)
+ * @param childIndex - Child index (0-63)
+ * @returns 32-byte derived seed for child tree
+ */
+export declare function deriveChildTreeSeedJava(childSeed: Uint8Array, childIndex: number): Uint8Array;
+/**
+ * Hash a single object matching Java's Crypto.hashObject()
+ *
+ * From TreeKeyNode.java line 30:
+ *   mChildSeed = Crypto.getInstance().hashObject(zPrivateSeed);
+ *
+ * This serializes the object as MiniData (length-prefixed) and hashes it.
+ *
+ * @param data - Raw bytes (will be serialized as MiniData)
+ * @returns 32-byte SHA3-256 hash
+ */
+export declare function hashObject(data: Uint8Array): Uint8Array;
+/**
+ * Convert index to MiniData bytes matching Java's:
+ *   new MiniData(new BigInteger(Integer.toString(index)))
+ *
+ * BigInteger uses minimum byte representation (no leading zeros).
+ * This is used for per-address key derivation in Wallet.java.
+ *
+ * @param index - Non-negative integer (0, 1, 2, ...)
+ * @returns Minimal byte representation of the index
+ */
+export declare function indexToMiniDataBytes(index: number): Uint8Array;
+/**
+ * Derive per-address private seed matching Minima Wallet.java exactly
+ *
+ * From Wallet.java createNewKey() (lines 498-503):
+ *   MiniData modifier = new MiniData(new BigInteger(Integer.toString(numkeys)));
+ *   MiniData privseed = Crypto.getInstance().hashObjects(new MiniData(mBaseSeed.getSeed()), modifier);
+ *
+ * CRITICAL: This is DIFFERENT from deriveChainSeedJava!
+ * - deriveChainSeedJava: hashAllObjects(MiniNumber(index), MiniData(seed)) - index first as MiniNumber
+ * - This function: hashObjects(MiniData(baseSeed), MiniData(modifier)) - baseSeed first, both as MiniData
+ *
+ * @param baseSeed - 32-byte base wallet seed (from mnemonic)
+ * @param addressIndex - Address index (0, 1, 2, ... 63)
+ * @returns 32-byte private seed for this address's TreeKey
+ */
+export declare function derivePerAddressSeed(baseSeed: Uint8Array, addressIndex: number): Uint8Array;
+/**
+ * Serialize MiniNumber.ZERO - cached for performance
+ * Returns: [0x00, 0x01, 0x00] = scale(0) + length(1) + value(0)
+ */
+export declare function serializeMiniNumberZERO(): Uint8Array;
+/**
+ * Serialize MiniNumber.ONE
+ * Returns: [0x00, 0x01, 0x01] = scale(0) + length(1) + value(1)
+ */
+export declare function serializeMiniNumberONE(): Uint8Array;
+/**
+ * Serialize hash in MiniData.writeHashToStream format (4-byte length prefix)
+ *
+ * Re-export of Streamable.writeHashToStream for backward compatibility.
+ *
+ * @param data - Hash bytes (max 64 bytes per MINIMA_MAX_HASH_LENGTH)
+ * @returns Serialized bytes with 4-byte length prefix
+ */
+export declare function writeHashToStream(data: Uint8Array): Uint8Array;
+/**
+ * Java hashAllObjects for MMRData hashing
+ * Used for MMRData.CreateMMRDataLeafNode and CreateMMRDataParentNode
+ *
+ * From Crypto.java hashAllObjects:
+ * Serializes each Streamable object and hashes the concatenation.
+ *
+ * For MMRData, the serialization is:
+ * - MiniNumber: [scale][len][data] (see serializeMiniNumber)
+ * - MiniData: [4-byte len][data] for writeDataStream
+ * - Hash: [4-byte len][data] for writeHashToStream (same as MiniData)
+ *
+ * CRITICAL: Java writeHashToStream uses writeInt (4-byte prefix),
+ * identical to writeDataStream. See MiniData.java lines 282-289.
+ *
+ * @param items - Pre-serialized items to concatenate and hash
+ * @returns 32-byte SHA3-256 hash
+ */
+export declare function javaHashAllObjects(...items: Uint8Array[]): Uint8Array;
+/**
+ * MMREntryNumber interface matching Minima's MMREntryNumber.java
+ * Represents a BigDecimal position in the MMR tree
+ */
+export interface MMREntryNumber {
+    scale: number;
+    unscaled: bigint;
+}
+/**
+ * Create MMREntryNumber from bigint (common case for integer positions)
+ */
+export declare function createMMREntryNumber(value: bigint): MMREntryNumber;
+/**
+ * Serialize MMREntryNumber matching Java MMREntryNumber.writeDataStream()
+ *
+ * From MMREntryNumber.java:
+ *   MiniNumber.WriteToStream(zOut, mNumber.scale());
+ *   MiniData.WriteToStream(zOut, mNumber.unscaledValue().toByteArray());
+ *
+ * @param entry - MMREntryNumber to serialize
+ * @returns Serialized bytes: MiniNumber(scale) + MiniData(unscaled bytes)
+ */
+export declare function serializeMMREntryNumber(entry: MMREntryNumber): Uint8Array;
+/**
+ * MMRData interface for serialization purposes
+ * Matches Minima's MMRData.java
+ */
+export interface MMRData {
+    data: Uint8Array;
+    value: bigint;
+}
+/**
+ * Serialize MMRData matching Java MMRData.writeDataStream()
+ *
+ * From MMRData.java:
+ *   mData.writeHashToStream(zOut);  // 4-byte length prefix + hash bytes
+ *   mValue.writeDataStream(zOut);   // MiniNumber format
+ *
+ * @param mmrData - MMRData to serialize
+ * @returns Serialized bytes: writeHashToStream(hash) + MiniNumber(value)
+ */
+export declare function serializeMMRData(mmrData: MMRData): Uint8Array;
+/**
+ * MMREntry interface for serialization purposes
+ * Matches Minima's MMREntry.java
+ */
+export interface MMREntry {
+    row: number;
+    entryNumber: MMREntryNumber;
+    mmrData: MMRData;
+}
+/**
+ * Serialize MMREntry matching Java MMREntry.writeDataStream()
+ *
+ * From MMREntry.java:
+ *   MiniNumber row = new MiniNumber(mRow);
+ *   row.writeDataStream(zOut);
+ *   mEntryNumber.writeDataStream(zOut);
+ *   mMMRData.writeDataStream(zOut);
+ *
+ * @param entry - MMREntry to serialize
+ * @returns Serialized bytes: MiniNumber(row) + MMREntryNumber + MMRData
+ */
+export declare function serializeMMREntry(entry: MMREntry): Uint8Array;
+/**
+ * Derive the unified root private seed from a base wallet seed.
+ *
+ * Architecture:
+ *   root_priv_seed = SHA3-256( serializeMiniData(baseSeed) ‖ serializeMiniData("ROOT_IDENTITY" bytes) )
+ *
+ * @param baseSeed - 32-byte wallet base seed (from mnemonic)
+ * @returns 32-byte root private seed
+ */
+export declare function deriveRootPrivSeed(baseSeed: Uint8Array): Uint8Array;
+/**
+ * Derive a unified child seed for the address at `index`.
+ *
+ * Architecture:
+ *   child_seed_i = SHA3-256( serializeMiniData(root_priv_seed) ‖ serializeMiniData(indexBytes(i)) )
+ *
+ * @param baseSeed - 32-byte wallet base seed (from mnemonic)
+ * @param index - Address index (0-63)
+ * @returns 32-byte child seed for the TreeKey at this address
+ */
+export declare function deriveUnifiedChildSeed(baseSeed: Uint8Array, index: number): Uint8Array;
+/**
+ * Precompute output coin IDs before computing the transaction digest.
+ *
+ * CRITICAL: Java's txnsign command calls TxPoWGenerator.precomputeTransactionCoinID(txn)
+ * BEFORE calculateTransactionID(). This means the transaction digest that gets signed
+ * includes the PRECOMPUTED output coin IDs, not the placeholder 0x00.
+ *
+ * Formula: outputCoinID = SHA3-256( writeMiniData(input[0].coinID) || writeMiniNumber(outputIndex) )
+ * This matches Java's Crypto.hashObjects(baseCoinID, new MiniNumber(outputNum))
+ *
+ * Without this, the wallet signs a different digest than what the node verifies against,
+ * causing allsignaturesvalid=false on every transaction.
+ *
+ * @param inputs - Transaction inputs array, each must have a coinId (Uint8Array)
+ * @param outputs - Transaction outputs array, each will have its coinId mutated in-place
+ */
+export declare function precomputeTransactionCoinID(inputs: {
+    coinId: Uint8Array;
+}[], outputs: {
+    coinId: Uint8Array;
+}[]): void;