@totemsdk/core 1.0.11 → 1.2.0

package/dist/legacy.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Legacy JS implementations — backward compatibility.
+ *
+ * These are the original TypeScript implementations preserved for
+ * environments where WASM is not available. The main entry point
+ * (`@totemsdk/core`) now delegates to WASM by default.
+ *
+ * Import legacy implementations directly:
+ *   import { wotsSign } from '@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.legacyGenerateWordList = exports.legacyPhraseToSeed = exports.convertWordListToSeed = exports.convertStringToSeed = exports.legacyValidatePhrase = exports.legacyCleanSeedPhrase = exports.WORD_LIST = exports.serializeRealMMRProof = exports.serializeMMRProof = exports.deserializeMMRProof = exports.parseMMRProofFromHex = exports.legacyVerifyMMRProof = exports.calculateProofRoot = exports.createMMRDataParentNode = exports.createMMRDataLeafNode = exports.mmrRootFromSingleLeaf = exports.mmrLeafExact = exports.MMRTree = exports.createPerAddressTreeKeyAsync = exports.createPerAddressTreeKey = exports.legacyDeriveUnifiedAddressPublicKey = exports.legacyCreateUnifiedRootTreeKey = exports.createUnifiedChildTreeKeyAsync = exports.legacyCreateUnifiedChildTreeKey = exports.DEFAULT_LEVELS = exports.DEFAULT_KEYS_PER_LEVEL = exports.getRootPublicKey = exports.deserializeTreeSignature = exports.serializeTreeSignature = exports.legacyVerifyTreeSignature = exports.TreeKeyNode = exports.TreeKey = exports.legacyWotsPublicKeyFromSeed = exports.legacyWotsVerifyDigest = exports.legacyWotsVerify = exports.legacyWotsPkFromSig = exports.wotsSignLegacy = exports.legacyWotsSign = exports.legacyWotsKeypairFromSeed = exports.legacyDerivePKdigest = exports.baseWWithChecksum = exports.toWinternitzDigits = exports.prfChainSeed = exports.h = exports.assert32 = exports.u32be = exports.u16be = exports.fromHex = exports.hex = exports.F = void 0;
+exports.legacyPrecomputeTransactionCoinIDTx = exports.serializeMMREntry = exports.serializeMMRData = exports.serializeMMREntryNumber = exports.createMMREntryNumber = exports.deriveUnifiedChildSeed = exports.legacyDeriveRootPrivSeed = exports.legacyDerivePerAddressSeed = exports.indexToMiniDataBytes = exports.javaHashAllObjects = exports.serializeMiniNumberONE = exports.serializeMiniNumberZERO = exports.hashObject = exports.deriveChildTreeSeedJava = exports.legacyDeriveChainSeedJava = exports.hashAllObjects = exports.serializeMiniData = exports.serializeMiniNumber = exports.writeHashToStream = exports.legacyWriteMiniString = exports.bigIntToByteArray = exports.legacyBytesToHex = exports.legacyHexToBytes = exports.concat = exports.writeMMREntryNumber = exports.writeMiniByte = exports.legacyWriteMiniData = exports.legacyWriteMiniNumber = exports.convertMinimaAddress = exports.makeMinimaAddress = exports.decodeMx = exports.encodeMx = exports.mxToHex = exports.hexToMx = exports.legacyParseMxAddress = exports.legacyMakeMxAddress = exports.decodeMxRadix32Frame = exports.encodeMxRadix32Frame = exports.legacyWotsAddressFromKeypair = exports.scriptFromWotsPk = exports.addressToRoot = exports.scriptToAddress = exports.buildMinimaCoin = exports.createDefaultTransaction = exports.legacyPrecomputeTransactionCoinID = exports.legacyComputeTransactionDigest = exports.legacySerializeTransaction = exports.serializeCoin = exports.parseDecimalToMiniNumber = exports.generateSeedPhrase = void 0;
+exports.legacyValidateChallenge = exports.legacyCreateChallenge = exports.normalizeHex = exports.deriveAddressFromPublicKey = exports.verifyTreeSignatureDetailed = exports.verifySignatureDetailed = exports.verifySignature = exports.legacyConcatBytes = void 0;
+// WOTS — unique exports
+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, "legacyDerivePKdigest", { enumerable: true, get: function () { return wots_js_1.derivePKdigest; } });
+Object.defineProperty(exports, "legacyWotsKeypairFromSeed", { enumerable: true, get: function () { return wots_js_1.wotsKeypairFromSeed; } });
+Object.defineProperty(exports, "legacyWotsSign", { enumerable: true, get: function () { return wots_js_1.wotsSign; } });
+Object.defineProperty(exports, "wotsSignLegacy", { enumerable: true, get: function () { return wots_js_1.wotsSignLegacy; } });
+Object.defineProperty(exports, "legacyWotsPkFromSig", { enumerable: true, get: function () { return wots_js_1.wotsPkFromSig; } });
+Object.defineProperty(exports, "legacyWotsVerify", { enumerable: true, get: function () { return wots_js_1.wotsVerify; } });
+Object.defineProperty(exports, "legacyWotsVerifyDigest", { enumerable: true, get: function () { return wots_js_1.wotsVerifyDigest; } });
+Object.defineProperty(exports, "legacyWotsPublicKeyFromSeed", { enumerable: true, get: function () { return wots_js_1.wotsPublicKeyFromSeed; } });
+// TreeKey — unique exports
+var treekey_js_1 = require("./treekey.js");
+Object.defineProperty(exports, "TreeKey", { enumerable: true, get: function () { return treekey_js_1.TreeKey; } });
+Object.defineProperty(exports, "TreeKeyNode", { enumerable: true, get: function () { return treekey_js_1.TreeKeyNode; } });
+Object.defineProperty(exports, "legacyVerifyTreeSignature", { enumerable: true, get: function () { return treekey_js_1.verifyTreeSignature; } });
+Object.defineProperty(exports, "serializeTreeSignature", { enumerable: true, get: function () { return treekey_js_1.serializeTreeSignature; } });
+Object.defineProperty(exports, "deserializeTreeSignature", { enumerable: true, get: function () { return treekey_js_1.deserializeTreeSignature; } });
+Object.defineProperty(exports, "getRootPublicKey", { enumerable: true, get: function () { return treekey_js_1.getRootPublicKey; } });
+Object.defineProperty(exports, "DEFAULT_KEYS_PER_LEVEL", { enumerable: true, get: function () { return treekey_js_1.DEFAULT_KEYS_PER_LEVEL; } });
+Object.defineProperty(exports, "DEFAULT_LEVELS", { enumerable: true, get: function () { return treekey_js_1.DEFAULT_LEVELS; } });
+Object.defineProperty(exports, "legacyCreateUnifiedChildTreeKey", { enumerable: true, get: function () { return treekey_js_1.createUnifiedChildTreeKey; } });
+Object.defineProperty(exports, "createUnifiedChildTreeKeyAsync", { enumerable: true, get: function () { return treekey_js_1.createUnifiedChildTreeKeyAsync; } });
+Object.defineProperty(exports, "legacyCreateUnifiedRootTreeKey", { enumerable: true, get: function () { return treekey_js_1.createUnifiedRootTreeKey; } });
+Object.defineProperty(exports, "legacyDeriveUnifiedAddressPublicKey", { enumerable: true, get: function () { return treekey_js_1.deriveUnifiedAddressPublicKey; } });
+Object.defineProperty(exports, "createPerAddressTreeKey", { enumerable: true, get: function () { return treekey_js_1.createPerAddressTreeKey; } });
+Object.defineProperty(exports, "createPerAddressTreeKeyAsync", { enumerable: true, get: function () { return treekey_js_1.createPerAddressTreeKeyAsync; } });
+// MMR — unique exports
+var mmr_js_1 = require("./mmr.js");
+Object.defineProperty(exports, "MMRTree", { enumerable: true, get: function () { return mmr_js_1.MMRTree; } });
+Object.defineProperty(exports, "mmrLeafExact", { enumerable: true, get: function () { return mmr_js_1.mmrLeafExact; } });
+Object.defineProperty(exports, "mmrRootFromSingleLeaf", { enumerable: true, get: function () { return mmr_js_1.mmrRootFromSingleLeaf; } });
+Object.defineProperty(exports, "createMMRDataLeafNode", { enumerable: true, get: function () { return mmr_js_1.createMMRDataLeafNode; } });
+Object.defineProperty(exports, "createMMRDataParentNode", { enumerable: true, get: function () { return mmr_js_1.createMMRDataParentNode; } });
+Object.defineProperty(exports, "calculateProofRoot", { enumerable: true, get: function () { return mmr_js_1.calculateProofRoot; } });
+Object.defineProperty(exports, "legacyVerifyMMRProof", { enumerable: true, get: function () { return mmr_js_1.verifyMMRProof; } });
+Object.defineProperty(exports, "parseMMRProofFromHex", { enumerable: true, get: function () { return mmr_js_1.parseMMRProofFromHex; } });
+Object.defineProperty(exports, "deserializeMMRProof", { enumerable: true, get: function () { return mmr_js_1.deserializeMMRProof; } });
+Object.defineProperty(exports, "serializeMMRProof", { enumerable: true, get: function () { return mmr_js_1.serializeMMRProof; } });
+Object.defineProperty(exports, "serializeRealMMRProof", { enumerable: true, get: function () { return mmr_js_1.serializeRealMMRProof; } });
+// BIP39
+var bip39_js_1 = require("./bip39.js");
+Object.defineProperty(exports, "WORD_LIST", { enumerable: true, get: function () { return bip39_js_1.WORD_LIST; } });
+Object.defineProperty(exports, "legacyCleanSeedPhrase", { enumerable: true, get: function () { return bip39_js_1.cleanSeedPhrase; } });
+Object.defineProperty(exports, "legacyValidatePhrase", { enumerable: true, get: function () { return bip39_js_1.validatePhrase; } });
+Object.defineProperty(exports, "convertStringToSeed", { enumerable: true, get: function () { return bip39_js_1.convertStringToSeed; } });
+Object.defineProperty(exports, "convertWordListToSeed", { enumerable: true, get: function () { return bip39_js_1.convertWordListToSeed; } });
+Object.defineProperty(exports, "legacyPhraseToSeed", { enumerable: true, get: function () { return bip39_js_1.phraseToSeed; } });
+Object.defineProperty(exports, "legacyGenerateWordList", { enumerable: true, get: function () { return bip39_js_1.generateWordList; } });
+Object.defineProperty(exports, "generateSeedPhrase", { enumerable: true, get: function () { return bip39_js_1.generateSeedPhrase; } });
+// Transaction
+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, "legacySerializeTransaction", { enumerable: true, get: function () { return transaction_js_1.serializeTransaction; } });
+Object.defineProperty(exports, "legacyComputeTransactionDigest", { enumerable: true, get: function () { return transaction_js_1.computeTransactionDigest; } });
+Object.defineProperty(exports, "legacyPrecomputeTransactionCoinID", { enumerable: true, get: function () { return transaction_js_1.precomputeTransactionCoinID; } });
+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; } });
+// Derive
+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; } });
+// Script
+var script_js_1 = require("./script.js");
+Object.defineProperty(exports, "scriptFromWotsPk", { enumerable: true, get: function () { return script_js_1.scriptFromWotsPk; } });
+Object.defineProperty(exports, "legacyWotsAddressFromKeypair", { enumerable: true, get: function () { return script_js_1.wotsAddressFromKeypair; } });
+// Minima32
+var minima32_js_1 = require("./minima32.js");
+Object.defineProperty(exports, "encodeMxRadix32Frame", { enumerable: true, get: function () { return minima32_js_1.encodeMxRadix32Frame; } });
+Object.defineProperty(exports, "decodeMxRadix32Frame", { enumerable: true, get: function () { return minima32_js_1.decodeMxRadix32Frame; } });
+Object.defineProperty(exports, "legacyMakeMxAddress", { enumerable: true, get: function () { return minima32_js_1.makeMxAddress; } });
+Object.defineProperty(exports, "legacyParseMxAddress", { enumerable: true, get: function () { return minima32_js_1.parseMxAddress; } });
+Object.defineProperty(exports, "hexToMx", { enumerable: true, get: function () { return minima32_js_1.hexToMx; } });
+Object.defineProperty(exports, "mxToHex", { enumerable: true, get: function () { return minima32_js_1.mxToHex; } });
+Object.defineProperty(exports, "encodeMx", { enumerable: true, get: function () { return minima32_js_1.encodeMx; } });
+Object.defineProperty(exports, "decodeMx", { enumerable: true, get: function () { return minima32_js_1.decodeMx; } });
+Object.defineProperty(exports, "makeMinimaAddress", { enumerable: true, get: function () { return minima32_js_1.makeMinimaAddress; } });
+Object.defineProperty(exports, "convertMinimaAddress", { enumerable: true, get: function () { return minima32_js_1.convertMinimaAddress; } });
+// Streamable
+var Streamable_js_1 = require("./Streamable.js");
+Object.defineProperty(exports, "legacyWriteMiniNumber", { enumerable: true, get: function () { return Streamable_js_1.writeMiniNumber; } });
+Object.defineProperty(exports, "legacyWriteMiniData", { enumerable: true, get: function () { return Streamable_js_1.writeMiniData; } });
+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, "legacyHexToBytes", { enumerable: true, get: function () { return Streamable_js_1.hexToBytes; } });
+Object.defineProperty(exports, "legacyBytesToHex", { enumerable: true, get: function () { return Streamable_js_1.bytesToHex; } });
+Object.defineProperty(exports, "bigIntToByteArray", { enumerable: true, get: function () { return Streamable_js_1.bigIntToByteArray; } });
+Object.defineProperty(exports, "legacyWriteMiniString", { enumerable: true, get: function () { return Streamable_js_1.writeMiniString; } });
+Object.defineProperty(exports, "writeHashToStream", { enumerable: true, get: function () { return Streamable_js_1.writeHashToStream; } });
+// JavaStreamables
+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, "legacyDeriveChainSeedJava", { enumerable: true, get: function () { return javaStreamables_js_1.deriveChainSeedJava; } });
+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, "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, "legacyDerivePerAddressSeed", { enumerable: true, get: function () { return javaStreamables_js_1.derivePerAddressSeed; } });
+Object.defineProperty(exports, "legacyDeriveRootPrivSeed", { enumerable: true, get: function () { return javaStreamables_js_1.deriveRootPrivSeed; } });
+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; } });
+Object.defineProperty(exports, "legacyPrecomputeTransactionCoinIDTx", { enumerable: true, get: function () { return javaStreamables_js_1.precomputeTransactionCoinID; } });
+// Utils
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "legacyConcatBytes", { enumerable: true, get: function () { return utils_js_1.concatBytes; } });
+// Params
+__exportStar(require("./params.js"), exports);
+// Verify
+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; } });
+Object.defineProperty(exports, "legacyCreateChallenge", { enumerable: true, get: function () { return verify_js_1.createChallenge; } });
+Object.defineProperty(exports, "legacyValidateChallenge", { enumerable: true, get: function () { return verify_js_1.validateChallenge; } });

package/dist/treekey.d.ts

@@ -326,58 +326,74 @@ export declare function serializeTreeSignature(sig: TreeSignature): Bytes;
 export declare function deserializeTreeSignature(data: Bytes): TreeSignature;
 /**
  * ============================================================================
- * PER-ADDRESS TREEKEY FACTORY
+ * UNIFIED TREEKEY FACTORY
  * ============================================================================
  *
- * Minima Wallet.createNewKey() creates independent TreeKeys per address:
- *   MiniData modifier = new MiniData(new BigInteger(Integer.toString(numkeys)));
- *   MiniData privseed = Crypto.getInstance().hashObjects(baseSeed, modifier);
- *   TreeKey treekey = TreeKey.createDefault(privseed);
+ * Single hierarchical derivation scheme:
  *
- * Each address gets its own TreeKey with:
- * - Unique seed derived from baseSeed + addressIndex
- * - Size=64, depth=3 (matching TreeKey.createDefault)
- * - 4096 one-time signatures per address (64×64)
+ *   root_priv_seed  = deriveRootPrivSeed(baseSeed)
+ *   child_seed_i    = deriveUnifiedChildSeed(baseSeed, i)
+ *   child_treekey_i = new TreeKey(child_seed_i, 64, 3)   ← spend address i
+ *   root_treekey    = new TreeKey(root_priv_seed, 64, 3)  ← identity anchor
  *
- * Total wallet capacity: 64 addresses × 4096 signatures = 262,144 signatures
+ * Child seeds are cryptographically descended from root_priv_seed, not siblings.
+ * Addresses are Minima-compatible (RETURN SIGNEDBY(pubkey) scripts, WOTS sigs).
+ * The root TreeKey is NEVER used as a spend address.
+ *
+ * Signature capacity: 64 addresses × 4 096 signatures each = 262 144 total.
+ * Root identity capacity: 4 096 attestation signatures.
  * ============================================================================
  */
 /**
- * Create a per-address TreeKey matching Minima Wallet.createNewKey()
+ * Create the unified child TreeKey for spend address at `index`.
+ *
+ * Derivation: child_seed_i = deriveUnifiedChildSeed(baseSeed, i)
+ *             treeKey = new TreeKey(child_seed_i, 64, 3)
  *
  * @param baseSeed - 32-byte wallet base seed (from mnemonic)
- * @param addressIndex - Address index (0-63)
- * @returns TreeKey for this address with size=64, depth=3
+ * @param index - Address index (0-63)
+ * @returns TreeKey for this spend address with size=64, depth=3
  */
-export declare function createPerAddressTreeKey(baseSeed: Bytes, addressIndex: number): TreeKey;
+export declare function createUnifiedChildTreeKey(baseSeed: Bytes, index: number): TreeKey;
 /**
- * Async version with progress reporting for UI
+ * Async version with progress reporting for UI.
  *
  * @param baseSeed - 32-byte wallet base seed
- * @param addressIndex - Address index (0-63)
+ * @param index - Address index (0-63)
  * @param onProgress - Optional progress callback
- * @returns Promise resolving to TreeKey for this address
+ * @returns Promise resolving to the child TreeKey
  */
-export declare function createPerAddressTreeKeyAsync(baseSeed: Bytes, addressIndex: number, onProgress?: ProgressCallback): Promise<TreeKey>;
+export declare function createUnifiedChildTreeKeyAsync(baseSeed: Bytes, index: number, onProgress?: ProgressCallback): Promise<TreeKey>;
 /**
- * Derive address public key from base seed and address index
+ * Create the unified root identity TreeKey (identity anchor, never a spend address).
  *
- * This is the fast path for getting an address public key without
- * needing to construct the full TreeKey. Useful for address derivation
- * during wallet initialization.
+ * Derivation: root_priv_seed = deriveRootPrivSeed(baseSeed)
+ *             treeKey = new TreeKey(root_priv_seed, 64, 3)
  *
- * @param baseSeed - 32-byte wallet base seed
- * @param addressIndex - Address index (0-63)
- * @returns 32-byte address public key (MMR root of per-address TreeKey)
+ * @param baseSeed - 32-byte wallet base seed (from mnemonic)
+ * @returns Root identity TreeKey with size=64, depth=3
  */
-export declare function deriveAddressPublicKey(baseSeed: Bytes, addressIndex: number): Bytes;
+export declare function createUnifiedRootTreeKey(baseSeed: Bytes): TreeKey;
 /**
- * Get the address public key from a per-address TreeKey
- *
- * In the per-address architecture, each address has its own TreeKey,
- * and the address public key is simply the TreeKey's root public key.
+ * Fast path for deriving a child address public key without constructing
+ * the full TreeKey. Useful during wallet initialisation.
  *
- * @param treeKey - Per-address TreeKey
- * @returns 32-byte address public key (TreeKey root)
+ * @param baseSeed - 32-byte wallet base seed
+ * @param index - Address index (0-63)
+ * @returns 32-byte address public key (MMR root of child TreeKey)
+ */
+export declare function deriveUnifiedAddressPublicKey(baseSeed: Bytes, index: number): Bytes;
+/**
+ * @deprecated Use {@link createUnifiedChildTreeKey} instead.
+ * This wrapper preserves the LEGACY per-address seed derivation
+ * (`SHA3-256(baseSeed ‖ indexBytes(i))`) so that existing callers
+ * that import this symbol by name continue to derive the same keys.
+ * New code must use createUnifiedChildTreeKey which applies the unified
+ * two-step derivation (root_priv_seed → child_seed_i).
  */
-export declare function getPerAddressPublicKey(treeKey: TreeKey): Bytes;
+export declare function createPerAddressTreeKey(baseSeed: Bytes, addressIndex: number): TreeKey;
+/**
+ * @deprecated Use {@link createUnifiedChildTreeKeyAsync} instead.
+ * Preserves legacy per-address seed derivation for backward compatibility.
+ */
+export declare function createPerAddressTreeKeyAsync(baseSeed: Bytes, addressIndex: number, onProgress?: ProgressCallback): Promise<TreeKey>;

package/dist/treekey.js

@@ -18,10 +18,12 @@ exports.getRootPublicKey = getRootPublicKey;
 exports.verifyTreeSignature = verifyTreeSignature;
 exports.serializeTreeSignature = serializeTreeSignature;
 exports.deserializeTreeSignature = deserializeTreeSignature;
+exports.createUnifiedChildTreeKey = createUnifiedChildTreeKey;
+exports.createUnifiedChildTreeKeyAsync = createUnifiedChildTreeKeyAsync;
+exports.createUnifiedRootTreeKey = createUnifiedRootTreeKey;
+exports.deriveUnifiedAddressPublicKey = deriveUnifiedAddressPublicKey;
 exports.createPerAddressTreeKey = createPerAddressTreeKey;
 exports.createPerAddressTreeKeyAsync = createPerAddressTreeKeyAsync;
-exports.deriveAddressPublicKey = deriveAddressPublicKey;
-exports.getPerAddressPublicKey = getPerAddressPublicKey;
 const javaStreamables_js_1 = require("./javaStreamables.js");
 const wots_js_1 = require("./wots.js");
 const params_js_1 = require("./params.js");
@@ -706,69 +708,95 @@ function deserializeTreeSignature(data) {
 }
 /**
  * ============================================================================
- * PER-ADDRESS TREEKEY FACTORY
+ * UNIFIED TREEKEY FACTORY
  * ============================================================================
  *
- * Minima Wallet.createNewKey() creates independent TreeKeys per address:
- *   MiniData modifier = new MiniData(new BigInteger(Integer.toString(numkeys)));
- *   MiniData privseed = Crypto.getInstance().hashObjects(baseSeed, modifier);
- *   TreeKey treekey = TreeKey.createDefault(privseed);
+ * Single hierarchical derivation scheme:
  *
- * Each address gets its own TreeKey with:
- * - Unique seed derived from baseSeed + addressIndex
- * - Size=64, depth=3 (matching TreeKey.createDefault)
- * - 4096 one-time signatures per address (64×64)
+ *   root_priv_seed  = deriveRootPrivSeed(baseSeed)
+ *   child_seed_i    = deriveUnifiedChildSeed(baseSeed, i)
+ *   child_treekey_i = new TreeKey(child_seed_i, 64, 3)   ← spend address i
+ *   root_treekey    = new TreeKey(root_priv_seed, 64, 3)  ← identity anchor
  *
- * Total wallet capacity: 64 addresses × 4096 signatures = 262,144 signatures
+ * Child seeds are cryptographically descended from root_priv_seed, not siblings.
+ * Addresses are Minima-compatible (RETURN SIGNEDBY(pubkey) scripts, WOTS sigs).
+ * The root TreeKey is NEVER used as a spend address.
+ *
+ * Signature capacity: 64 addresses × 4 096 signatures each = 262 144 total.
+ * Root identity capacity: 4 096 attestation signatures.
  * ============================================================================
  */
 /**
- * Create a per-address TreeKey matching Minima Wallet.createNewKey()
+ * Create the unified child TreeKey for spend address at `index`.
+ *
+ * Derivation: child_seed_i = deriveUnifiedChildSeed(baseSeed, i)
+ *             treeKey = new TreeKey(child_seed_i, 64, 3)
  *
  * @param baseSeed - 32-byte wallet base seed (from mnemonic)
- * @param addressIndex - Address index (0-63)
- * @returns TreeKey for this address with size=64, depth=3
+ * @param index - Address index (0-63)
+ * @returns TreeKey for this spend address with size=64, depth=3
  */
-function createPerAddressTreeKey(baseSeed, addressIndex) {
-    const addressSeed = (0, javaStreamables_js_1.derivePerAddressSeed)(baseSeed, addressIndex);
-    return new TreeKey(addressSeed, 64, 3);
+function createUnifiedChildTreeKey(baseSeed, index) {
+    const childSeed = (0, javaStreamables_js_1.deriveUnifiedChildSeed)(baseSeed, index);
+    return new TreeKey(childSeed, 64, 3);
 }
 /**
- * Async version with progress reporting for UI
+ * Async version with progress reporting for UI.
  *
  * @param baseSeed - 32-byte wallet base seed
- * @param addressIndex - Address index (0-63)
+ * @param index - Address index (0-63)
  * @param onProgress - Optional progress callback
- * @returns Promise resolving to TreeKey for this address
+ * @returns Promise resolving to the child TreeKey
  */
-async function createPerAddressTreeKeyAsync(baseSeed, addressIndex, onProgress) {
-    const addressSeed = (0, javaStreamables_js_1.derivePerAddressSeed)(baseSeed, addressIndex);
-    return TreeKey.createWithProgress(addressSeed, 64, 3, onProgress);
+async function createUnifiedChildTreeKeyAsync(baseSeed, index, onProgress) {
+    const childSeed = (0, javaStreamables_js_1.deriveUnifiedChildSeed)(baseSeed, index);
+    return TreeKey.createWithProgress(childSeed, 64, 3, onProgress);
 }
 /**
- * Derive address public key from base seed and address index
+ * Create the unified root identity TreeKey (identity anchor, never a spend address).
  *
- * This is the fast path for getting an address public key without
- * needing to construct the full TreeKey. Useful for address derivation
- * during wallet initialization.
+ * Derivation: root_priv_seed = deriveRootPrivSeed(baseSeed)
+ *             treeKey = new TreeKey(root_priv_seed, 64, 3)
  *
- * @param baseSeed - 32-byte wallet base seed
- * @param addressIndex - Address index (0-63)
- * @returns 32-byte address public key (MMR root of per-address TreeKey)
+ * @param baseSeed - 32-byte wallet base seed (from mnemonic)
+ * @returns Root identity TreeKey with size=64, depth=3
  */
-function deriveAddressPublicKey(baseSeed, addressIndex) {
-    const treeKey = createPerAddressTreeKey(baseSeed, addressIndex);
-    return treeKey.getPublicKey();
+function createUnifiedRootTreeKey(baseSeed) {
+    const rootPrivSeed = (0, javaStreamables_js_1.deriveRootPrivSeed)(baseSeed);
+    return new TreeKey(rootPrivSeed, 64, 3);
 }
 /**
- * Get the address public key from a per-address TreeKey
+ * Fast path for deriving a child address public key without constructing
+ * the full TreeKey. Useful during wallet initialisation.
  *
- * In the per-address architecture, each address has its own TreeKey,
- * and the address public key is simply the TreeKey's root public key.
- *
- * @param treeKey - Per-address TreeKey
- * @returns 32-byte address public key (TreeKey root)
+ * @param baseSeed - 32-byte wallet base seed
+ * @param index - Address index (0-63)
+ * @returns 32-byte address public key (MMR root of child TreeKey)
  */
-function getPerAddressPublicKey(treeKey) {
-    return treeKey.getPublicKey();
+function deriveUnifiedAddressPublicKey(baseSeed, index) {
+    return createUnifiedChildTreeKey(baseSeed, index).getPublicKey();
+}
+// ---------------------------------------------------------------------------
+// Deprecated aliases — kept for migration compatibility only.
+// Downstream consumers should migrate to createUnifiedChildTreeKey.
+// ---------------------------------------------------------------------------
+/**
+ * @deprecated Use {@link createUnifiedChildTreeKey} instead.
+ * This wrapper preserves the LEGACY per-address seed derivation
+ * (`SHA3-256(baseSeed ‖ indexBytes(i))`) so that existing callers
+ * that import this symbol by name continue to derive the same keys.
+ * New code must use createUnifiedChildTreeKey which applies the unified
+ * two-step derivation (root_priv_seed → child_seed_i).
+ */
+function createPerAddressTreeKey(baseSeed, addressIndex) {
+    const perAddressSeed = (0, javaStreamables_js_1.derivePerAddressSeed)(baseSeed instanceof Uint8Array ? baseSeed : new Uint8Array(baseSeed), addressIndex);
+    return new TreeKey(perAddressSeed, 64, 3);
+}
+/**
+ * @deprecated Use {@link createUnifiedChildTreeKeyAsync} instead.
+ * Preserves legacy per-address seed derivation for backward compatibility.
+ */
+async function createPerAddressTreeKeyAsync(baseSeed, addressIndex, onProgress) {
+    const perAddressSeed = (0, javaStreamables_js_1.derivePerAddressSeed)(baseSeed instanceof Uint8Array ? baseSeed : new Uint8Array(baseSeed), addressIndex);
+    return TreeKey.createWithProgress(perAddressSeed, 64, 3, onProgress);
 }

package/dist/tx/TransactionService.js

@@ -41,8 +41,6 @@ class TransactionService {
                 burn: params.burn || null,
                 paramSet: this.config.paramSet || 'v2-spec',
                 addressIndex: params.addressIndex,
-                walletMode: params.walletMode || 'AnonTree',
-                perAddressPublicKey: params.perAddressPublicKey ?? null,
             }, {
                 headers: {
                     'Content-Type': 'application/json',
@@ -106,9 +104,9 @@ class TransactionService {
         if (digestBytes.length !== 32) {
             throw new Error(`Invalid digest length: ${digestBytes.length}, expected 32 bytes`);
         }
-        // Derive per-address TreeKey matching Minima Wallet.java
-        this.logger.debug(`  Deriving per-address TreeKey for index ${addressIndex}...`);
-        const treeKey = (0, treekey_js_1.createPerAddressTreeKey)(seed, addressIndex);
+        // Derive unified child TreeKey for this address index
+        this.logger.debug(`  Deriving unified child TreeKey for index ${addressIndex}...`);
+        const treeKey = (0, treekey_js_1.createUnifiedChildTreeKey)(seed, addressIndex);
         // Convert (l1, l2) to Java-compatible 'uses' counter
         // Java's TreeKey.sign() uses baseConversion(uses) to compute path
         const KEYS_PER_LEVEL = 64;

package/dist/tx/types.d.ts

@@ -14,8 +14,6 @@ export interface PrepareRequest {
     burn?: string;
     txId?: string;
     addressIndex?: number;
-    walletMode?: 'AnonTree' | 'RootTree';
-    perAddressPublicKey?: string;
 }
 export interface PrepareResponse {
     addressIndex: number;

package/dist/wasm-bridge.d.ts

@@ -0,0 +1,54 @@
+/**
+ * WASM Bridge — thin TypeScript wrappers around @totemsdk/core-wasm.
+ *
+ * This module provides the same public API as the legacy JS implementations
+ * but delegates to Rust/WASM for all cryptographic operations.
+ *
+ * The legacy JS implementations remain available via:
+ *   import { ... } from '@totemsdk/core/legacy';
+ */
+import type { WotsKeypair } from '../types.js';
+export declare function getParams(): Promise<{
+    w: number;
+    n: number;
+    L: number;
+    maxDigit: number;
+    maxSignatures: number;
+    signatureLevels: number;
+    addressPrefix: string;
+}>;
+export declare function sha3_256(data: Uint8Array): Promise<Uint8Array>;
+export declare function expandPrivateKey(seed: Uint8Array): Promise<Uint8Array[]>;
+export declare function hashChain(x: Uint8Array, rounds: number): Promise<Uint8Array>;
+export declare function derivePKdigest(seed: Uint8Array, keyIndex: number): Promise<Uint8Array>;
+export declare function deriveFullPublicKey(seed: Uint8Array, keyIndex: number): Promise<Uint8Array>;
+export declare function wotsSign(seed: Uint8Array, keyIndex: number, message: Uint8Array): Promise<Uint8Array>;
+export declare function wotsVerify(sig: Uint8Array, message: Uint8Array, pkFull: Uint8Array): Promise<boolean>;
+export declare function wotsVerifyDigest(sig: Uint8Array, message: Uint8Array, pkDigest: Uint8Array): Promise<boolean>;
+export declare function wotsPkFromSig(message: Uint8Array, signature: Uint8Array): Promise<Uint8Array>;
+export declare function wotsPublicKeyFromSeed(seed: Uint8Array, keyIndex?: number): Promise<Uint8Array>;
+export declare function wotsKeypairFromSeed(seed: Uint8Array, index: number): Promise<WotsKeypair>;
+export declare function deriveChainSeedJava(seed: Uint8Array, keyIndex: number): Promise<Uint8Array>;
+export declare function derivePerAddressSeed(rootSeed: Uint8Array, addressIndex: number): Promise<Uint8Array>;
+export declare function deriveRootPrivSeed(bip39Seed: Uint8Array): Promise<Uint8Array>;
+export declare function phraseToSeed(phrase: string): Promise<Uint8Array>;
+export declare function generateWordList(): Promise<string>;
+export declare function validatePhrase(phrase: string): Promise<boolean>;
+export declare function cleanSeedPhrase(phrase: string): Promise<string>;
+export declare function makeMxAddress(root32: Uint8Array): Promise<string>;
+export declare function parseMxAddress(address: string): Promise<Uint8Array>;
+export declare function wotsAddressFromKeypair(seed: Uint8Array, keyIndex: number): Promise<string>;
+export declare function serializeTransaction(tx: any): Promise<Uint8Array>;
+export declare function computeTransactionDigest(serializedTx: Uint8Array): Promise<Uint8Array>;
+export declare function precomputeTransactionCoinID(txid: Uint8Array, outputIndex: number): Promise<Uint8Array>;
+export declare function verifyTreeSignature(rootPublicKey: Uint8Array, message: Uint8Array, signature: any): Promise<boolean>;
+export declare function timingSafeEqual(a: Uint8Array, b: Uint8Array): Promise<boolean>;
+export declare function createChallenge(domain: string, statement: string): Promise<string>;
+export declare function validateChallenge(challengeJson: string, domain: string): Promise<boolean>;
+export declare function writeMiniNumber(value: number, scale?: number): Promise<Uint8Array>;
+export declare function writeMiniData(data: Uint8Array): Promise<Uint8Array>;
+export declare function writeMiniString(s: string): Promise<Uint8Array>;
+export declare function bytesToHex(bytes: Uint8Array): Promise<string>;
+export declare function hexToBytes(hexStr: string): Promise<Uint8Array>;
+export declare function concatBytes(...arrays: Uint8Array[]): Promise<Uint8Array>;
+export { getParams as getParamSet } from './wasm-bridge.js';