@shieldedtech/moth-wallet 0.2.0

package/dist/proof/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/proof/client.ts"],"names":[],"mappings":"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"}

package/dist/proof/provider.d.ts

@@ -0,0 +1,12 @@
+import * as ledger from '@midnight-ntwrk/ledger-v8';
+import { type KeyMaterialProvider } from '@midnight-ntwrk/midnight-js/types';
+import type { ProverConfig } from '../types/network.js';
+/** Build the low-level provider used by contracts and the dApp connector. */
+export declare function createProvingProvider(config: ProverConfig, keyMaterialProvider: KeyMaterialProvider): ledger.ProvingProvider;
+/** Build the transaction-level Midnight.js proof provider. */
+export declare function createProofProvider(config: ProverConfig, keyMaterialProvider: KeyMaterialProvider): import("@midnight-ntwrk/midnight-js-types").ProofProvider;
+/** Build the wallet facade service. WASM follows the SDK's documented setup. */
+export declare function createWalletProvingService(config: ProverConfig): import("@midnightntwrk/wallet-sdk-capabilities").ProvingService<import("@midnightntwrk/wallet-sdk-capabilities").UnboundTransaction>;
+/** Proof servers need a preflight; local WASM proving has no remote health check. */
+export declare function ensureProverReady(config: ProverConfig): Promise<void>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/proof/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/proof/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,EAAmB,KAAK,mBAAmB,EAAC,MAAM,mCAAmC,CAAC;AAW7F,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AA8CtD,6EAA6E;AAC7E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,CAAC,eAAe,CAKxB;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,mBAAmB,EAAE,mBAAmB,6DAiBzC;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,wIAoB9D;AAED,qFAAqF;AACrF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E"}

package/dist/proof/provider.js

@@ -0,0 +1,96 @@
+import * as ledger from '@midnight-ntwrk/ledger-v8';
+import { httpClientProvingProvider, httpClientProofProvider } from '@midnight-ntwrk/midnight-js-http-client-proof-provider';
+import { ZKConfigProvider } from '@midnight-ntwrk/midnight-js/types';
+import { provingProvider as wasmProvingProvider, } from '@midnight-ntwrk/zkir-v2';
+import { makeServerProvingService, makeWasmProvingService, } from '@midnightntwrk/wallet-sdk/capabilities/proving';
+import { WasmProver } from '@midnightntwrk/wallet-sdk/prover-client/effect';
+import { ProofClient } from './client.js';
+/** Adapter from the connector/Midnight.js key interface to ZKConfigProvider. */
+class KeyMaterialZkConfigProvider extends ZKConfigProvider {
+    source;
+    constructor(source) {
+        super();
+        this.source = source;
+    }
+    getZKIR(circuitId) {
+        return this.source.getZKIR(circuitId);
+    }
+    getProverKey(circuitId) {
+        return this.source.getProverKey(circuitId);
+    }
+    getVerifierKey(circuitId) {
+        return this.source.getVerifierKey(circuitId);
+    }
+}
+let defaultWasmKeys;
+function defaultWasmKeyMaterialProvider() {
+    return (defaultWasmKeys ??= WasmProver.makeDefaultKeyMaterialProvider());
+}
+function wasmKeyMaterialProvider(source) {
+    const defaults = defaultWasmKeyMaterialProvider();
+    return {
+        async lookupKey(keyLocation) {
+            // Native wallet circuits come from the SDK-maintained key source. Contract
+            // circuits fall through to the dApp/artifact provider supplied by callers.
+            const builtIn = await defaults.lookupKey(keyLocation);
+            if (builtIn)
+                return builtIn;
+            const [ir, proverKey, verifierKey] = await Promise.all([
+                source.getZKIR(keyLocation),
+                source.getProverKey(keyLocation),
+                source.getVerifierKey(keyLocation),
+            ]);
+            return { ir, proverKey, verifierKey };
+        },
+        getParams: (k) => defaults.getParams(k),
+    };
+}
+/** Build the low-level provider used by contracts and the dApp connector. */
+export function createProvingProvider(config, keyMaterialProvider) {
+    if (config.type === 'server') {
+        return httpClientProvingProvider(config.url, new KeyMaterialZkConfigProvider(keyMaterialProvider));
+    }
+    return wasmProvingProvider(wasmKeyMaterialProvider(keyMaterialProvider));
+}
+/** Build the transaction-level Midnight.js proof provider. */
+export function createProofProvider(config, keyMaterialProvider) {
+    if (config.type === 'server') {
+        // Delegate to the SDK's proof provider rather than re-implementing
+        // proveTx. This keeps payload versioning (ledger-v8 8.1.0 rejects
+        // unversioned circuit-call proofs) and any future proveTx behavior —
+        // e.g. partialProveTxConfig — tracking the SDK instead of drifting from
+        // a hand-rolled copy of the same call.
+        return httpClientProofProvider(config.url, new KeyMaterialZkConfigProvider(keyMaterialProvider));
+    }
+    // WASM path: no SDK proof-provider equivalent, so drive prove() directly
+    // over the local zkir provider.
+    const provingProvider = createProvingProvider(config, keyMaterialProvider);
+    return {
+        proveTx: (transaction) => transaction.prove(provingProvider, ledger.CostModel.initialCostModel()),
+    };
+}
+/** Build the wallet facade service. WASM follows the SDK's documented setup. */
+export function createWalletProvingService(config) {
+    if (config.type === 'server') {
+        return makeServerProvingService({ provingServerUrl: new URL(config.url) });
+    }
+    // This is the SDK-documented path and works in Node, where the package's
+    // proof-worker.js is addressable from node_modules.
+    if (typeof process !== 'undefined' && process.versions?.node) {
+        return makeWasmProvingService();
+    }
+    // Browser bundles do not emit the SDK's dependency-internal proof-worker.js.
+    // Moth already runs the wallet host in its own dedicated Worker, so execute
+    // the same ZKIR WASM provider there directly instead of nesting a missing
+    // worker asset.
+    const provider = wasmProvingProvider(defaultWasmKeyMaterialProvider());
+    return {
+        prove: (transaction) => transaction.prove(provider, ledger.CostModel.initialCostModel()),
+    };
+}
+/** Proof servers need a preflight; local WASM proving has no remote health check. */
+export async function ensureProverReady(config) {
+    if (config.type === 'server')
+        await new ProofClient(config.url).ensureReady();
+}
+//# sourceMappingURL=provider.js.map

package/dist/proof/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/proof/provider.ts"],"names":[],"mappings":"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"}

package/dist/providers/index.d.ts

@@ -0,0 +1,2 @@
+export { createMidnightProvider } from './midnight-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,2 @@
+export { createMidnightProvider } from './midnight-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/providers/midnight-provider.d.ts

@@ -0,0 +1,11 @@
+import type { NetworkConfig } from '../types/network.js';
+/**
+ * MidnightProvider that submits finalized transactions to the node
+ * via the SDK's PolkadotNodeClient (which uses @polkadot/api internally).
+ */
+export declare function createMidnightProvider(network: NetworkConfig): {
+    submitTx(finalizedTx: {
+        serialize(): Uint8Array;
+    }): Promise<string>;
+};
+//# sourceMappingURL=midnight-provider.d.ts.map

package/dist/providers/midnight-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"midnight-provider.d.ts","sourceRoot":"","sources":["../../src/providers/midnight-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAQvD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa;0BAe7B;QAAC,SAAS,IAAI,UAAU,CAAA;KAAC,GAAG,OAAO,CAAC,MAAM,CAAC;EAQ1E"}

package/dist/providers/midnight-provider.js

@@ -0,0 +1,30 @@
+import { PolkadotNodeClient, makeConfig } from '@midnightntwrk/wallet-sdk/node-client';
+import { SerializedTransaction } from '@midnightntwrk/wallet-sdk';
+function toWsUrl(url) {
+    return url.replace(/^https:/, 'wss:').replace(/^http:/, 'ws:');
+}
+/**
+ * MidnightProvider that submits finalized transactions to the node
+ * via the SDK's PolkadotNodeClient (which uses @polkadot/api internally).
+ */
+export function createMidnightProvider(network) {
+    let clientPromise = null;
+    function getClient() {
+        if (!clientPromise) {
+            clientPromise = PolkadotNodeClient.init(makeConfig({
+                nodeURL: new URL(toWsUrl(network.nodeUrl)),
+            }));
+        }
+        return clientPromise;
+    }
+    return {
+        async submitTx(finalizedTx) {
+            const client = await getClient();
+            const serialized = SerializedTransaction.from(finalizedTx);
+            // Wait only for Submitted — finalization is tracked separately by publicDataProvider.
+            const event = await client.sendMidnightTransactionAndWait(serialized, 'Submitted');
+            return event.txHash;
+        },
+    };
+}
+//# sourceMappingURL=midnight-provider.js.map

package/dist/providers/midnight-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"midnight-provider.js","sourceRoot":"","sources":["../../src/providers/midnight-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,kBAAkB,EAAE,UAAU,EAAC,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAEhE,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsB;IAC3D,IAAI,aAAa,GAAuC,IAAI,CAAC;IAE7D,SAAS,SAAS;QAChB,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,kBAAkB,CAAC,IAAI,CACrC,UAAU,CAAC;gBACT,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aAC3C,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,WAAsC;YACnD,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3D,sFAAsF;YACtF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YACnF,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/storage/adapter.d.ts

@@ -0,0 +1,8 @@
+export interface StorageAdapter {
+    read(key: string): Promise<Uint8Array | null>;
+    write(key: string, data: Uint8Array): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/storage/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/storage/adapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC9C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC"}

package/dist/storage/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/storage/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/storage/adapter.ts"],"names":[],"mappings":""}

package/dist/storage/fs-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { StorageAdapter } from './adapter.js';
+export declare class FilesystemStorageAdapter implements StorageAdapter {
+    private readonly baseDir;
+    constructor(baseDir?: string);
+    private resolvePath;
+    read(key: string): Promise<Uint8Array | null>;
+    write(key: string, data: Uint8Array): Promise<void>;
+    private acquireLock;
+    private releaseLock;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=fs-adapter.d.ts.map

package/dist/storage/fs-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-adapter.d.ts","sourceRoot":"","sources":["../../src/storage/fs-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,SAAc;IAIjC,OAAO,CAAC,WAAW;IAIb,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAU7C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YA2B3C,WAAW;YA8BX,WAAW;IAQnB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYvC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ5C"}

package/dist/storage/fs-adapter.js

@@ -0,0 +1,126 @@
+import { readFile, writeFile, unlink, readdir, stat, mkdir, chmod, open, rename } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { safePath } from './safe-path.js';
+const DEFAULT_DIR = join(homedir(), '.moth');
+const LOCK_SUFFIX = '.lock';
+const LOCK_STALE_MS = 30_000; // Consider lock stale after 30s
+export class FilesystemStorageAdapter {
+    baseDir;
+    constructor(baseDir = DEFAULT_DIR) {
+        this.baseDir = baseDir;
+    }
+    resolvePath(key) {
+        return safePath(this.baseDir, key);
+    }
+    async read(key) {
+        try {
+            const data = await readFile(this.resolvePath(key));
+            return new Uint8Array(data);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return null;
+            throw err;
+        }
+    }
+    async write(key, data) {
+        const path = this.resolvePath(key);
+        await mkdir(dirname(path), { recursive: true });
+        // Advisory file locking for concurrent access (T087)
+        const lockPath = path + LOCK_SUFFIX;
+        await this.acquireLock(lockPath);
+        try {
+            // Atomic write: stage into a temp file in the same directory, then
+            // rename over the target. rename(2) is atomic on POSIX, so a crash or
+            // full disk mid-write leaves either the old file intact or the new one
+            // complete — never a half-written keystore that can't be opened.
+            const tmpPath = `${path}.tmp.${process.pid}.${Date.now()}`;
+            try {
+                await writeFile(tmpPath, data, { mode: 0o600 });
+                // Ensure owner-only perms (FR-005) before the file becomes visible.
+                await chmod(tmpPath, 0o600);
+                await rename(tmpPath, path);
+            }
+            catch (err) {
+                await unlink(tmpPath).catch(() => { });
+                throw err;
+            }
+        }
+        finally {
+            await this.releaseLock(lockPath);
+        }
+    }
+    async acquireLock(lockPath) {
+        const maxRetries = 10;
+        for (let i = 0; i < maxRetries; i++) {
+            try {
+                // O_CREAT | O_EXCL — fails if file exists (atomic lock)
+                const handle = await open(lockPath, 'wx');
+                await handle.writeFile(String(process.pid));
+                await handle.close();
+                return;
+            }
+            catch (err) {
+                if (err.code === 'EEXIST') {
+                    // Check if lock is stale
+                    try {
+                        const lockStat = await stat(lockPath);
+                        if (Date.now() - lockStat.mtimeMs > LOCK_STALE_MS) {
+                            await unlink(lockPath);
+                            continue; // Retry after removing stale lock
+                        }
+                    }
+                    catch {
+                        continue; // Lock disappeared, retry
+                    }
+                    await new Promise(resolve => setTimeout(resolve, 100));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw new Error(`Could not acquire lock on ${lockPath} — another process may be using this wallet`);
+    }
+    async releaseLock(lockPath) {
+        try {
+            await unlink(lockPath);
+        }
+        catch {
+            // Lock already released — not an error
+        }
+    }
+    async delete(key) {
+        try {
+            await unlink(this.resolvePath(key));
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return;
+            throw err;
+        }
+    }
+    async list(prefix) {
+        // Use safePath to prevent path traversal outside baseDir (CWE-22)
+        const dir = safePath(this.baseDir, prefix);
+        try {
+            const entries = await readdir(dir);
+            return entries.map(e => `${prefix}/${e}`);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw err;
+        }
+    }
+    async exists(key) {
+        try {
+            await stat(this.resolvePath(key));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=fs-adapter.js.map

package/dist/storage/fs-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-adapter.js","sourceRoot":"","sources":["../../src/storage/fs-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1G,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAC7C,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,gCAAgC;AAE9D,MAAM,OAAO,wBAAwB;IAClB,OAAO,CAAS;IAEjC,YAAY,OAAO,GAAG,WAAW;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEO,WAAW,CAAC,GAAW;QAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YACnD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAClE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,IAAgB;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,qDAAqD;QACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,WAAW,CAAC;QACpC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,mEAAmE;YACnE,sEAAsE;YACtE,uEAAuE;YACvE,iEAAiE;YACjE,MAAM,OAAO,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC3D,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChD,oEAAoE;gBACpE,MAAM,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC5B,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACtC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,QAAgB;QACxC,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,wDAAwD;gBACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC1C,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACrD,yBAAyB;oBACzB,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;wBACtC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,GAAG,aAAa,EAAE,CAAC;4BAClD,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;4BACvB,SAAS,CAAC,kCAAkC;wBAC9C,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS,CAAC,0BAA0B;oBACtC,CAAC;oBACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;oBACvD,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,6CAA6C,CAAC,CAAC;IACtG,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,QAAgB;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO;YAC7D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,kEAAkE;QAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAChE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/storage/safe-path.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validate that a path segment is safe to join with a base directory.
+ * Rejects: absolute paths, .., empty segments, path separators.
+ * CWE-22 / CWE-73 mitigation.
+ */
+export declare function validatePathSegment(segment: string): void;
+/**
+ * Resolve a path relative to a base directory and verify containment.
+ * Returns the resolved absolute path.
+ * Throws if the resolved path escapes the base directory.
+ */
+export declare function safePath(baseDir: string, key: string): string;
+//# sourceMappingURL=safe-path.d.ts.map

package/dist/storage/safe-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-path.d.ts","sourceRoot":"","sources":["../../src/storage/safe-path.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAazD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAU7D"}

package/dist/storage/safe-path.js

@@ -0,0 +1,35 @@
+import { resolve, relative, normalize } from 'node:path';
+/**
+ * Validate that a path segment is safe to join with a base directory.
+ * Rejects: absolute paths, .., empty segments, path separators.
+ * CWE-22 / CWE-73 mitigation.
+ */
+export function validatePathSegment(segment) {
+    if (!segment || segment.trim() === '') {
+        throw new Error('Path segment cannot be empty');
+    }
+    if (segment.includes('..')) {
+        throw new Error(`Path segment contains traversal: ${segment}`);
+    }
+    if (segment.startsWith('/') || segment.startsWith('\\')) {
+        throw new Error(`Path segment is absolute: ${segment}`);
+    }
+    if (/[/\\]/.test(segment) && segment.includes('..')) {
+        throw new Error(`Path segment contains traversal: ${segment}`);
+    }
+}
+/**
+ * Resolve a path relative to a base directory and verify containment.
+ * Returns the resolved absolute path.
+ * Throws if the resolved path escapes the base directory.
+ */
+export function safePath(baseDir, key) {
+    const absBase = resolve(baseDir);
+    const absPath = resolve(absBase, normalize(key));
+    const rel = relative(absBase, absPath);
+    if (rel.startsWith('..') || resolve(absPath) !== absPath) {
+        throw new Error(`Path escapes base directory: ${key}`);
+    }
+    return absPath;
+}
+//# sourceMappingURL=safe-path.js.map

package/dist/storage/safe-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-path.js","sourceRoot":"","sources":["../../src/storage/safe-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAW;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEvC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/sync/activity.d.ts

@@ -0,0 +1,53 @@
+import type { WalletEntry } from '@midnightntwrk/wallet-sdk/facade';
+export type ActivityKind = 'sent' | 'received' | 'swap' | 'dust';
+export type ActivityStatus = 'SUCCESS' | 'FAILURE' | 'PARTIAL_SUCCESS';
+/** Net movement of one token for the wallet; negative = left the wallet. */
+export interface ActivityDelta {
+    tokenType: string;
+    kind: 'shielded' | 'unshielded';
+    amount: bigint;
+}
+export interface ActivityEntry {
+    hash: string;
+    /** Stable logical identifiers for this transaction, when history exposes them. */
+    identifiers?: string[];
+    kind: ActivityKind;
+    status: ActivityStatus;
+    /** Block timestamp; null for older/partial records. */
+    timestamp: Date | null;
+    /** Net per-token movements, largest magnitude first. Excludes DUST. */
+    deltas: ActivityDelta[];
+    /** Net DUST movement (initial values of received minus spent DUST UTXOs). */
+    dustDelta: bigint;
+    /** The other side's unshielded address, when the entry reveals it. */
+    counterparty: string | null;
+    /** DUST paid in fees, when the indexer reported it. */
+    fees: bigint | null;
+    /** True for a locally-submitted transaction not yet seen on chain. */
+    pending: boolean;
+    /** Number of outgoing destination outputs the wallet can see — how many
+     *  transfers a single (possibly batched) transaction carried. Counts
+     *  external unshielded created UTxOs; shielded recipients are unknowable
+     *  (their notes can't be decrypted), so a shielded-only batch reads 0. */
+    outputs?: number;
+}
+/**
+ * Derive one activity entry from a stored history entry.
+ *
+ * Unshielded UTXOs carry an owner address: the wallet's own movements are the
+ * UTXOs it owns, and any foreign owner is the counterparty (recipient on a
+ * created UTXO, sender on a spent one). Some indexers only report the wallet's
+ * own UTXOs — then no foreign owner appears and the counterparty stays null.
+ * If NO owner matches `ownAddress`, the address comparison itself is broken
+ * (unexpected encoding); every UTXO is then counted as the wallet's own, which
+ * matches the wallet-relevant-only reporting model, instead of derailing every
+ * entry to zero movement. Shielded coins never carry owners: only the wallet
+ * can decrypt its own notes, so they are all wallet movements by construction.
+ */
+export declare function deriveActivityEntry(entry: WalletEntry, ownAddress: string): ActivityEntry;
+/** Newest first; entries without a timestamp keep their relative order at the end. */
+export declare function sortActivity<T extends {
+    timestamp: Date | null;
+}>(entries: T[]): T[];
+export declare function deriveActivity(entries: readonly WalletEntry[], ownAddress: string): ActivityEntry[];
+//# sourceMappingURL=activity.d.ts.map

package/dist/sync/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/sync/activity.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AACjE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAEvE,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,uDAAuD;IACvD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,uEAAuE;IACvE,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB;;;8EAG0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CAuDzF;AAMD,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAElF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAEnG"}

package/dist/sync/activity.js

@@ -0,0 +1,92 @@
+// Activity feed derivation: turns the SDK's stored transaction-history entries
+// (WalletEntry — per-tx shielded/unshielded/dust sections) into display-ready
+// entries with a direction, net per-token movements and, when the entry reveals
+// it, the counterparty address.
+//
+// IMPORTANT: this module must stay WASM-free (type-only SDK imports) — UI
+// bundles import it for the types and pure helpers.
+function addDelta(deltas, kind, tokenType, amount) {
+    const key = `${kind}:${tokenType}`;
+    const existing = deltas.get(key);
+    if (existing)
+        existing.amount += amount;
+    else
+        deltas.set(key, { tokenType, kind, amount });
+}
+/**
+ * Derive one activity entry from a stored history entry.
+ *
+ * Unshielded UTXOs carry an owner address: the wallet's own movements are the
+ * UTXOs it owns, and any foreign owner is the counterparty (recipient on a
+ * created UTXO, sender on a spent one). Some indexers only report the wallet's
+ * own UTXOs — then no foreign owner appears and the counterparty stays null.
+ * If NO owner matches `ownAddress`, the address comparison itself is broken
+ * (unexpected encoding); every UTXO is then counted as the wallet's own, which
+ * matches the wallet-relevant-only reporting model, instead of derailing every
+ * entry to zero movement. Shielded coins never carry owners: only the wallet
+ * can decrypt its own notes, so they are all wallet movements by construction.
+ */
+export function deriveActivityEntry(entry, ownAddress) {
+    const deltas = new Map();
+    let recipient = null;
+    let sender = null;
+    const created = entry.unshielded?.createdUtxos ?? [];
+    const spent = entry.unshielded?.spentUtxos ?? [];
+    const anyOwn = [...created, ...spent].some((utxo) => utxo.owner === ownAddress);
+    const isOwn = (owner) => !anyOwn || owner === ownAddress;
+    let outputs = 0;
+    for (const utxo of created) {
+        if (isOwn(utxo.owner))
+            addDelta(deltas, 'unshielded', utxo.tokenType, utxo.value);
+        else {
+            recipient ??= utxo.owner;
+            outputs += 1; // each external created UTxO is one outgoing transfer
+        }
+    }
+    for (const utxo of spent) {
+        if (isOwn(utxo.owner))
+            addDelta(deltas, 'unshielded', utxo.tokenType, -utxo.value);
+        else
+            sender ??= utxo.owner;
+    }
+    for (const coin of entry.shielded?.receivedCoins ?? []) {
+        addDelta(deltas, 'shielded', coin.type, coin.value);
+    }
+    for (const coin of entry.shielded?.spentCoins ?? []) {
+        addDelta(deltas, 'shielded', coin.type, -coin.value);
+    }
+    let dustDelta = 0n;
+    for (const utxo of entry.dust?.receivedUtxos ?? [])
+        dustDelta += utxo.initialValue;
+    for (const utxo of entry.dust?.spentUtxos ?? [])
+        dustDelta -= utxo.initialValue;
+    const net = [...deltas.values()].filter((delta) => delta.amount !== 0n);
+    net.sort((a, b) => (abs(b.amount) > abs(a.amount) ? 1 : abs(b.amount) < abs(a.amount) ? -1 : 0));
+    const hasNegative = net.some((delta) => delta.amount < 0n);
+    const hasPositive = net.some((delta) => delta.amount > 0n);
+    const kind = hasNegative && hasPositive ? 'swap' : hasNegative ? 'sent' : hasPositive ? 'received' : 'dust';
+    return {
+        hash: entry.hash,
+        identifiers: entry.identifiers ? [...entry.identifiers] : undefined,
+        kind,
+        status: entry.status,
+        timestamp: entry.timestamp ?? null,
+        deltas: net,
+        dustDelta,
+        counterparty: kind === 'sent' || kind === 'swap' ? recipient : kind === 'received' ? sender : null,
+        fees: entry.fees ?? null,
+        pending: false,
+        outputs,
+    };
+}
+function abs(value) {
+    return value < 0n ? -value : value;
+}
+/** Newest first; entries without a timestamp keep their relative order at the end. */
+export function sortActivity(entries) {
+    return [...entries].sort((a, b) => (b.timestamp?.getTime() ?? 0) - (a.timestamp?.getTime() ?? 0));
+}
+export function deriveActivity(entries, ownAddress) {
+    return sortActivity(entries.map((entry) => deriveActivityEntry(entry, ownAddress)));
+}
+//# sourceMappingURL=activity.js.map

package/dist/sync/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/sync/activity.ts"],"names":[],"mappings":"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"}