@totemsdk/omnia-vtxo 0.2.0 → 0.3.0

package/dist/refresh.js

@@ -1,22 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.refreshVtxo = refreshVtxo;
-const errors_js_1 = require("./errors.js");
-const commitment_js_1 = require("./commitment.js");
-const constants_js_1 = require("./constants.js");
+import { VtxoStatusError, VtxoPolicyError } from './errors.js';
+import { computeVtxoId, buildVtxoProofSet, computeReceiptId } from './commitment.js';
 /**
  * Refreshes a VTXO to a new epoch.
  * @param now - Timestamp in ms. Defaults to Date.now() if omitted — pass explicitly for determinism.
  */
-function refreshVtxo(vtxo, params, now) {
+export function refreshVtxo(vtxo, params, now) {
     const ts = now !== undefined ? now : Date.now();
     if (vtxo.status !== 'active') {
-        throw new errors_js_1.VtxoStatusError(`Cannot refresh VTXO ${vtxo.vtxoId}: status is '${vtxo.status}'`, vtxo.status);
+        throw new VtxoStatusError(`Cannot refresh VTXO ${vtxo.vtxoId}: status is '${vtxo.status}'`, vtxo.status);
     }
     if (params.newEpoch <= vtxo.epoch) {
-        throw new errors_js_1.VtxoPolicyError(`Refresh epoch ${params.newEpoch} must be strictly greater than current epoch ${vtxo.epoch}`);
+        throw new VtxoPolicyError(`Refresh epoch ${params.newEpoch} must be strictly greater than current epoch ${vtxo.epoch}`);
     }
-    const refreshedId = (0, commitment_js_1.computeVtxoId)({
+    const refreshedId = computeVtxoId({
         poolId: vtxo.poolId,
         owner: vtxo.owner,
         amount: vtxo.amount,
@@ -51,7 +47,7 @@ function refreshVtxo(vtxo, params, now) {
             siblings: [],
             positions: [],
             epoch: params.newEpoch,
-            batchId: constants_js_1.MOCK_BATCH_ID,
+            batchId: '',
         },
         history: [
             {
@@ -65,9 +61,9 @@ function refreshVtxo(vtxo, params, now) {
         updatedAt: ts,
         expiresAt: vtxo.expiresAt,
     };
-    const { proofs } = (0, commitment_js_1.buildVtxoProofSet)([rawRefreshed]);
+    const { proofs } = buildVtxoProofSet([rawRefreshed]);
     const refreshedVtxo = { ...rawRefreshed, proof: proofs[refreshedId] };
-    const receiptId = (0, commitment_js_1.computeReceiptId)(vtxo.poolId, 'refresh', [vtxo.vtxoId], [refreshedId], ts);
+    const receiptId = computeReceiptId(vtxo.poolId, 'refresh', [vtxo.vtxoId], [refreshedId], ts);
     return {
         old: oldVtxo,
         refreshed: refreshedVtxo,
@@ -79,7 +75,7 @@ function refreshVtxo(vtxo, params, now) {
             outputIds: [refreshedId],
             epoch: params.newEpoch,
             at: ts,
-            signature: constants_js_1.MOCK_OPERATOR_SIGNATURE,
+            signature: '',
         },
     };
 }

package/dist/serialization.js

@@ -1,9 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeVtxo = serializeVtxo;
-exports.deserializeVtxo = deserializeVtxo;
-exports.serializePool = serializePool;
-exports.deserializePool = deserializePool;
 const BIGINT_PREFIX = '__bigint__:';
 function replacer(_key, value) {
     if (typeof value === 'bigint') {
@@ -17,15 +11,15 @@ function reviver(_key, value) {
     }
     return value;
 }
-function serializeVtxo(vtxo) {
+export function serializeVtxo(vtxo) {
     return JSON.stringify(vtxo, replacer);
 }
-function deserializeVtxo(json) {
+export function deserializeVtxo(json) {
     return JSON.parse(json, reviver);
 }
-function serializePool(pool) {
+export function serializePool(pool) {
     return JSON.stringify(pool, replacer);
 }
-function deserializePool(json) {
+export function deserializePool(json) {
     return JSON.parse(json, reviver);
 }

package/dist/split.js

@@ -1,34 +1,30 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.splitVtxo = splitVtxo;
-const errors_js_1 = require("./errors.js");
-const commitment_js_1 = require("./commitment.js");
-const constants_js_1 = require("./constants.js");
+import { VtxoStatusError, VtxoAmountError, VtxoSplitError } from './errors.js';
+import { computeVtxoId, buildVtxoProofSet, computeReceiptId } from './commitment.js';
 /**
  * Splits a VTXO into multiple outputs.
  * @param now - Timestamp in ms. Defaults to Date.now() if omitted — pass explicitly for determinism.
  */
-function splitVtxo(vtxo, params, now) {
+export function splitVtxo(vtxo, params, now) {
     const ts = now !== undefined ? now : Date.now();
     if (vtxo.status !== 'active') {
-        throw new errors_js_1.VtxoStatusError(`Cannot split VTXO ${vtxo.vtxoId}: status is '${vtxo.status}'`, vtxo.status);
+        throw new VtxoStatusError(`Cannot split VTXO ${vtxo.vtxoId}: status is '${vtxo.status}'`, vtxo.status);
     }
     if (params.amounts.length < 2) {
-        throw new errors_js_1.VtxoSplitError('Split requires at least 2 output amounts');
+        throw new VtxoSplitError('Split requires at least 2 output amounts');
     }
     if (params.amounts.length !== params.nonces.length) {
-        throw new errors_js_1.VtxoSplitError('amounts and nonces arrays must have the same length');
+        throw new VtxoSplitError('amounts and nonces arrays must have the same length');
     }
     for (const amt of params.amounts) {
         if (amt <= BigInt(0)) {
-            throw new errors_js_1.VtxoAmountError(`All split amounts must be > 0, got ${amt}`);
+            throw new VtxoAmountError(`All split amounts must be > 0, got ${amt}`);
         }
     }
     const sum = params.amounts.reduce((a, b) => a + b, BigInt(0));
     if (sum !== vtxo.amount) {
-        throw new errors_js_1.VtxoAmountError(`Split amounts sum ${sum} does not equal VTXO amount ${vtxo.amount}`);
+        throw new VtxoAmountError(`Split amounts sum ${sum} does not equal VTXO amount ${vtxo.amount}`);
     }
-    const outputIds = params.amounts.map((amount, i) => (0, commitment_js_1.computeVtxoId)({
+    const outputIds = params.amounts.map((amount, i) => computeVtxoId({
         poolId: vtxo.poolId,
         owner: vtxo.owner,
         amount,
@@ -63,7 +59,7 @@ function splitVtxo(vtxo, params, now) {
             siblings: [],
             positions: [],
             epoch: vtxo.epoch,
-            batchId: constants_js_1.MOCK_BATCH_ID,
+            batchId: '',
         },
         history: [
             {
@@ -77,9 +73,9 @@ function splitVtxo(vtxo, params, now) {
         createdAt: ts,
         updatedAt: ts,
     }));
-    const { proofs } = (0, commitment_js_1.buildVtxoProofSet)(rawOutputs);
+    const { proofs } = buildVtxoProofSet(rawOutputs);
     const outputs = rawOutputs.map(o => ({ ...o, proof: proofs[o.vtxoId] }));
-    const receiptId = (0, commitment_js_1.computeReceiptId)(vtxo.poolId, 'split', [vtxo.vtxoId], outputIds, ts);
+    const receiptId = computeReceiptId(vtxo.poolId, 'split', [vtxo.vtxoId], outputIds, ts);
     return {
         input: inputVtxo,
         outputs,
@@ -91,7 +87,7 @@ function splitVtxo(vtxo, params, now) {
             outputIds,
             epoch: vtxo.epoch,
             at: ts,
-            signature: constants_js_1.MOCK_OPERATOR_SIGNATURE,
+            signature: '',
         },
     };
 }

package/dist/transfer.js

@@ -1,27 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.transferVtxo = transferVtxo;
-const errors_js_1 = require("./errors.js");
-const commitment_js_1 = require("./commitment.js");
-const constants_js_1 = require("./constants.js");
+import { VtxoStatusError, VtxoAmountError } from './errors.js';
+import { computeVtxoId, buildVtxoProofSet, computeReceiptId } from './commitment.js';
 /**
  * Transfers a VTXO (fully or partially) to a recipient.
  * @param now - Timestamp in ms. Defaults to Date.now() if omitted — pass explicitly for determinism.
  */
-function transferVtxo(vtxo, params, now) {
+export function transferVtxo(vtxo, params, now) {
     const ts = now !== undefined ? now : Date.now();
     if (vtxo.status !== 'active') {
-        throw new errors_js_1.VtxoStatusError(`Cannot transfer VTXO ${vtxo.vtxoId}: status is '${vtxo.status}'`, vtxo.status);
+        throw new VtxoStatusError(`Cannot transfer VTXO ${vtxo.vtxoId}: status is '${vtxo.status}'`, vtxo.status);
     }
     if (params.amount <= BigInt(0)) {
-        throw new errors_js_1.VtxoAmountError(`Transfer amount must be > 0, got ${params.amount}`);
+        throw new VtxoAmountError(`Transfer amount must be > 0, got ${params.amount}`);
     }
     if (params.amount > vtxo.amount) {
-        throw new errors_js_1.VtxoAmountError(`Transfer amount ${params.amount} exceeds VTXO amount ${vtxo.amount}`);
+        throw new VtxoAmountError(`Transfer amount ${params.amount} exceeds VTXO amount ${vtxo.amount}`);
     }
     const isPartial = params.amount < vtxo.amount;
     const changeAmount = vtxo.amount - params.amount;
-    const outputId = (0, commitment_js_1.computeVtxoId)({
+    const outputId = computeVtxoId({
         poolId: vtxo.poolId,
         owner: params.recipient,
         amount: params.amount,
@@ -32,7 +28,7 @@ function transferVtxo(vtxo, params, now) {
     let changeId;
     if (isPartial) {
         const changeNonce = params.changeNonce ?? params.nonce + ':change';
-        changeId = (0, commitment_js_1.computeVtxoId)({
+        changeId = computeVtxoId({
             poolId: vtxo.poolId,
             owner: vtxo.owner,
             amount: changeAmount,
@@ -69,7 +65,7 @@ function transferVtxo(vtxo, params, now) {
             siblings: [],
             positions: [],
             epoch: vtxo.epoch,
-            batchId: constants_js_1.MOCK_BATCH_ID,
+            batchId: '',
         },
         history: [
             {
@@ -99,7 +95,7 @@ function transferVtxo(vtxo, params, now) {
                 siblings: [],
                 positions: [],
                 epoch: vtxo.epoch,
-                batchId: constants_js_1.MOCK_BATCH_ID,
+                batchId: '',
             },
             history: [
                 {
@@ -116,7 +112,7 @@ function transferVtxo(vtxo, params, now) {
         outputIds.push(changeId);
     }
     const activeOutputs = changeVtxo ? [outputVtxo, changeVtxo] : [outputVtxo];
-    const { proofs } = (0, commitment_js_1.buildVtxoProofSet)(activeOutputs);
+    const { proofs } = buildVtxoProofSet(activeOutputs);
     const patchedOutput = { ...outputVtxo, proof: proofs[outputId] };
     const patchedChange = changeVtxo
         ? { ...changeVtxo, proof: proofs[changeId] }
@@ -133,7 +129,7 @@ function transferVtxo(vtxo, params, now) {
         tokenId: vtxo.tokenId,
         at: ts,
     };
-    const receiptId = (0, commitment_js_1.computeReceiptId)(vtxo.poolId, 'transfer', [vtxo.vtxoId], outputIds, ts);
+    const receiptId = computeReceiptId(vtxo.poolId, 'transfer', [vtxo.vtxoId], outputIds, ts);
     return {
         input: inputVtxo,
         output: patchedOutput,
@@ -147,7 +143,7 @@ function transferVtxo(vtxo, params, now) {
             outputIds,
             epoch: vtxo.epoch,
             at: ts,
-            signature: constants_js_1.MOCK_OPERATOR_SIGNATURE,
+            signature: '',
         },
     };
 }

package/dist/types.d.ts

@@ -48,6 +48,13 @@ export interface OmniaVtxo {
     createdAt: number;
     updatedAt: number;
     expiresAt?: number;
+    /** The on-chain funding proof recorded at mint (deep proof, #28). */
+    fundingProof?: unknown;
+    /** Set when an exit draft consumed this VTXO — prevents double-exit. */
+    exitConsumedAt?: number;
+    exitReceiptId?: string;
+    /** The confirming exit transaction's txpowId (set on `markExited`). */
+    exitTxpowId?: string;
 }
 export interface VtxoTransfer {
     inputId: VtxoId;
@@ -84,6 +91,8 @@ export interface MintVtxoParams {
     amount: bigint;
     nonce: string;
     expiresAt?: number;
+    /** The on-chain funding proof (deep proof) recorded at mint. */
+    fundingProof?: unknown;
 }
 export interface TransferVtxoParams {
     recipient: string;
@@ -132,9 +141,11 @@ export interface ExitDraft {
     owner: string;
     amount: bigint;
     tokenId: string;
-    draftType: 'mock-exit';
+    draftType: 'vtxo-exit';
     timelockSeconds: number;
     createdAt: number;
+    /** The verified share this exit is capped at (the VTXO's amount). */
+    verifiedShare: bigint;
 }
 export interface VerifyVtxoResult {
     valid: boolean;

package/dist/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/verify.js

@@ -1,11 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyVtxo = verifyVtxo;
-exports.verifyVtxoProof = verifyVtxoProof;
-exports.verifyVtxoTransfer = verifyVtxoTransfer;
-exports.verifyConservation = verifyConservation;
-const commitment_js_1 = require("./commitment.js");
-function verifyVtxo(vtxo) {
+import { computeVtxoLeaf, verifyMerkleProof } from './commitment.js';
+export function verifyVtxo(vtxo) {
     const errors = [];
     if (!vtxo.vtxoId)
         errors.push('Missing vtxoId');
@@ -27,9 +21,9 @@ function verifyVtxo(vtxo) {
     }
     return { valid: errors.length === 0, errors };
 }
-function verifyVtxoProof(vtxo, proof) {
+export function verifyVtxoProof(vtxo, proof) {
     const errors = [];
-    const expectedLeaf = (0, commitment_js_1.computeVtxoLeaf)(vtxo);
+    const expectedLeaf = computeVtxoLeaf(vtxo);
     if (proof.leaf !== expectedLeaf) {
         errors.push(`Proof leaf mismatch: expected ${expectedLeaf}, got ${proof.leaf}`);
     }
@@ -38,7 +32,7 @@ function verifyVtxoProof(vtxo, proof) {
             sibling,
             position: proof.positions[i],
         }));
-        const valid = (0, commitment_js_1.verifyMerkleProof)(proof.leaf, proofNodes, proof.root);
+        const valid = verifyMerkleProof(proof.leaf, proofNodes, proof.root);
         if (!valid) {
             errors.push('Merkle proof verification failed');
         }
@@ -50,7 +44,7 @@ function verifyVtxoProof(vtxo, proof) {
     }
     return { valid: errors.length === 0, errors };
 }
-function verifyVtxoTransfer(input, output, transfer) {
+export function verifyVtxoTransfer(input, output, transfer) {
     const errors = [];
     if (transfer.inputId !== input.vtxoId) {
         errors.push(`Transfer inputId ${transfer.inputId} does not match input VTXO ${input.vtxoId}`);
@@ -77,7 +71,7 @@ function verifyVtxoTransfer(input, output, transfer) {
  *
  * Always requires: same `poolId` and `tokenId` across all inputs and outputs.
  */
-function verifyConservation(params) {
+export function verifyConservation(params) {
     const errors = [];
     const { inputs, outputs, mode = 'lte' } = params;
     if (inputs.length === 0 || outputs.length === 0) {

package/dist/vtxo.js

@@ -1,13 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isVtxoActive = isVtxoActive;
-exports.mintVtxo = mintVtxo;
-exports.markVtxoSpent = markVtxoSpent;
-const errors_js_1 = require("./errors.js");
-const constants_js_1 = require("./constants.js");
-const commitment_js_1 = require("./commitment.js");
-const pool_js_1 = require("./pool.js");
-function isVtxoActive(vtxo) {
+import { VtxoStatusError } from './errors.js';
+import { computeVtxoId, buildVtxoProofSet, computeReceiptId } from './commitment.js';
+import { assertPoolCanMint } from './pool.js';
+export function isVtxoActive(vtxo) {
     return vtxo.status === 'active';
 }
 /**
@@ -16,10 +10,10 @@ function isVtxoActive(vtxo) {
  * @param params - Mint parameters (owner, amount, nonce).
  * @param now - Timestamp in ms. Defaults to Date.now() if omitted — pass explicitly for determinism.
  */
-function mintVtxo(pool, params, now) {
+export function mintVtxo(pool, params, now) {
     const ts = now !== undefined ? now : Date.now();
-    (0, pool_js_1.assertPoolCanMint)(pool, params.amount);
-    const vtxoId = (0, commitment_js_1.computeVtxoId)({
+    assertPoolCanMint(pool, params.amount);
+    const vtxoId = computeVtxoId({
         poolId: pool.poolId,
         owner: params.owner,
         amount: params.amount,
@@ -40,8 +34,9 @@ function mintVtxo(pool, params, now) {
             siblings: [],
             positions: [],
             epoch: pool.epoch,
-            batchId: constants_js_1.MOCK_BATCH_ID,
+            batchId: '',
         },
+        fundingProof: params.fundingProof,
         history: [
             {
                 op: 'mint',
@@ -54,7 +49,7 @@ function mintVtxo(pool, params, now) {
         updatedAt: ts,
         expiresAt: params.expiresAt,
     };
-    const { root, proofs } = (0, commitment_js_1.buildVtxoProofSet)([vtxo]);
+    const { root, proofs } = buildVtxoProofSet([vtxo]);
     const proof = proofs[vtxoId];
     const mintedVtxo = { ...vtxo, proof };
     const updatedPool = {
@@ -62,7 +57,7 @@ function mintVtxo(pool, params, now) {
         availableCapacity: pool.availableCapacity - params.amount,
         commitmentRoot: root,
     };
-    const receiptId = (0, commitment_js_1.computeReceiptId)(pool.poolId, 'mint', [], [vtxoId], ts);
+    const receiptId = computeReceiptId(pool.poolId, 'mint', [], [vtxoId], ts);
     const receipt = {
         receiptId,
         poolId: pool.poolId,
@@ -71,7 +66,7 @@ function mintVtxo(pool, params, now) {
         outputIds: [vtxoId],
         epoch: pool.epoch,
         at: ts,
-        signature: constants_js_1.MOCK_OPERATOR_SIGNATURE,
+        signature: '',
     };
     return { pool: updatedPool, vtxo: mintedVtxo, receipt };
 }
@@ -79,10 +74,10 @@ function mintVtxo(pool, params, now) {
  * Marks an active VTXO as spent.
  * @param now - Timestamp in ms. Defaults to Date.now() if omitted — pass explicitly for determinism.
  */
-function markVtxoSpent(vtxo, now) {
+export function markVtxoSpent(vtxo, now) {
     const ts = now !== undefined ? now : Date.now();
     if (!isVtxoActive(vtxo)) {
-        throw new errors_js_1.VtxoStatusError(`Cannot mark VTXO ${vtxo.vtxoId} as spent: status is '${vtxo.status}'`, vtxo.status);
+        throw new VtxoStatusError(`Cannot mark VTXO ${vtxo.vtxoId} as spent: status is '${vtxo.status}'`, vtxo.status);
     }
     return {
         ...vtxo,

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "@totemsdk/omnia-vtxo",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Virtual UTXO / payment-pool claim layer for Omnia — cash-like off-chain balance primitive for Totem Edge",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/cjs/index.js",
+  "types": "dist/cjs/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
     }
   },
   "files": [
@@ -19,7 +24,12 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@totemsdk/core": "^1.2.9"
+    "@totemsdk/chain-provider": "^0.2.1",
+    "@totemsdk/omnia": "^1.0.3",
+    "@totemsdk/core": "^1.2.11",
+    "@totemsdk/storage": "^0.1.0",
+    "@totemsdk/wots-lease": "^1.0.1",
+    "@totemsdk/txpow": "^1.0.2"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
@@ -61,8 +71,9 @@
     "off-chain",
     "ark"
   ],
+  "type": "module",
   "scripts": {
-    "build": "npm run build:wasm && tsc && node ../../scripts/clean-wasm-output-ignores.mjs",
+    "build": "tsc && tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'})+'\\n')\"",
     "clean": "rm -rf dist rust/pkg rust/pkg-node rust/target",
     "test": "jest",
     "build:wasm": "cd rust && wasm-pack build --target bundler --out-dir pkg && wasm-pack build --target nodejs --out-dir pkg-node"

package/rust/pkg/package.json

@@ -24,4 +24,4 @@
     "./omnia_vtxo_wasm.js",
     "./snippets/*"
   ]
-}
+}

package/rust/pkg-node/package.json

@@ -18,4 +18,4 @@
   "main": "omnia_vtxo_wasm.js",
   "homepage": "https://totem.ing",
   "types": "omnia_vtxo_wasm.d.ts"
-}
+}