@koralabs/kora-labs-common 6.9.0 → 6.9.1

package/mpt/index.d.ts

@@ -1,6 +1,15 @@
+import { Trie } from '@aiken-lang/merkle-patricia-forestry';
 import * as labelSet from './labelSet';
 import * as registryValue from './registryValue';
 export { labelSet, registryValue };
+export { Trie };
+/**
+ * THE canonical minting-data MPT (a real {@link Trie}, for proof generation during mint/burn).
+ * Consumers that only need the root hash should use {@link computeMintingDataRoot}; consumers that
+ * generate proofs (the minting engine's verifyRootHash) keep the returned Trie. Value = "" per the
+ * validator's `update_root` — see {@link computeMintingDataRoot} for the full rationale.
+ */
+export declare const buildMintingDataTrie: (handleNames: string[]) => Promise<Trie>;
 /**
  * THE canonical minting-data MPT root. Every Node service (api.handle.me, the minting engine,
  * handle.me/bff) and the on-chain mirror (@koralabs/handles-decentralized-minting) MUST compute

package/mpt/index.js

@@ -23,17 +23,29 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.computeMintingDataRoot = exports.registryValue = exports.labelSet = void 0;
+exports.computeMintingDataRoot = exports.buildMintingDataTrie = exports.Trie = exports.registryValue = exports.labelSet = void 0;
 // Server-only (Node) MPT module. Pulls @aiken-lang/merkle-patricia-forestry (native `level`/`blake2b`)
 // so it is NOT re-exported from the package root — import it from the subpath:
 //   import { computeMintingDataRoot } from '@koralabs/kora-labs-common/mpt';
 // Mirrors the './aws' server-only convention; keeps the package root isomorphic/browser-safe.
 const merkle_patricia_forestry_1 = require("@aiken-lang/merkle-patricia-forestry");
+Object.defineProperty(exports, "Trie", { enumerable: true, get: function () { return merkle_patricia_forestry_1.Trie; } });
 const labelSet = __importStar(require("./labelSet"));
 exports.labelSet = labelSet;
 const registryValue = __importStar(require("./registryValue"));
 exports.registryValue = registryValue;
 const EMPTY_ROOT_HEX = Buffer.alloc(32).toString('hex');
+/**
+ * THE canonical minting-data MPT (a real {@link Trie}, for proof generation during mint/burn).
+ * Consumers that only need the root hash should use {@link computeMintingDataRoot}; consumers that
+ * generate proofs (the minting engine's verifyRootHash) keep the returned Trie. Value = "" per the
+ * validator's `update_root` — see {@link computeMintingDataRoot} for the full rationale.
+ */
+const buildMintingDataTrie = async (handleNames) => {
+    const uniqueKeys = Array.from(new Set(handleNames));
+    return merkle_patricia_forestry_1.Trie.fromList(uniqueKeys.map((key) => ({ key, value: '' })));
+};
+exports.buildMintingDataTrie = buildMintingDataTrie;
 /**
  * THE canonical minting-data MPT root. Every Node service (api.handle.me, the minting engine,
  * handle.me/bff) and the on-chain mirror (@koralabs/handles-decentralized-minting) MUST compute
@@ -52,8 +64,7 @@ const EMPTY_ROOT_HEX = Buffer.alloc(32).toString('hex');
  */
 const computeMintingDataRoot = async (handleNames) => {
     var _a, _b;
-    const uniqueKeys = Array.from(new Set(handleNames));
-    const trie = await merkle_patricia_forestry_1.Trie.fromList(uniqueKeys.map((key) => ({ key, value: '' })));
+    const trie = await (0, exports.buildMintingDataTrie)(handleNames);
     return (_b = (_a = trie.hash) === null || _a === void 0 ? void 0 : _a.toString('hex')) !== null && _b !== void 0 ? _b : EMPTY_ROOT_HEX;
 };
 exports.computeMintingDataRoot = computeMintingDataRoot;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koralabs/kora-labs-common",
-    "version": "6.9.0",
+    "version": "6.9.1",
     "description": "Kora Labs Common Utilities",
     "main": "index.js",
     "types": "index.d.ts",