@shieldedtech/moth-wallet 0.2.0

package/dist/contract/call.js

@@ -0,0 +1,245 @@
+// Circuit call using the official Midnight SDK provider chain.
+// Mirrors deploy.ts: syncs wallet, balances transaction, signs intents, submits.
+import { resolveProverConfig } from '../types/network.js';
+import { createProofProvider, ensureProverReady } from '../proof/provider.js';
+import { NodeZkConfigProvider } from '@midnight-ntwrk/midnight-js-node-zk-config-provider';
+import { createMidnightProvider } from '../providers/midnight-provider.js';
+import { indexerPublicDataProvider } from '@midnight-ntwrk/midnight-js-indexer-public-data-provider';
+import { WalletError } from '../types/errors.js';
+import { toPositionalArgs } from './args-parser.js';
+import { setNetworkId } from '@midnight-ntwrk/midnight-js/network-id';
+import * as Rx from 'rxjs';
+import * as ledger from '@midnight-ntwrk/ledger-v8';
+import { HDWallet, Roles } from '@midnightntwrk/wallet-sdk/hd';
+import { createKeystore } from '@midnightntwrk/wallet-sdk/unshielded';
+export async function callCircuit(options) {
+    const { contractAddress, circuitName, network, artifactPath } = options;
+    if (!artifactPath) {
+        throw new WalletError('INVALID_INPUT', 'Circuit calls require a compiled contract artifact (--artifact). ' +
+            'The artifact provides ZK circuits and contract logic needed for proof generation.');
+    }
+    if (!options.syncedWallet?.facade) {
+        throw new WalletError('WALLET_ERROR', 'Wallet must be synced before calling circuits. Unlock and wait for sync.');
+    }
+    setNetworkId(network.id);
+    await ensureProverReady(resolveProverConfig(network));
+    return callViaSDK(options);
+}
+async function callViaSDK(options) {
+    const { contractAddress, circuitName, args, walletKeys, seedHex, witnesses, network, artifactPath, syncedWallet, projectDir } = options;
+    const { resolve: resolvePath, join, basename } = await import('node:path');
+    const { pathToFileURL } = await import('node:url');
+    const { createRequire } = await import('node:module');
+    const { existsSync } = await import('node:fs');
+    const { homedir } = await import('node:os');
+    const { levelPrivateStateProvider } = await import('@midnight-ntwrk/midnight-js-level-private-state-provider');
+    // Resolve the typed key bundle: prefer the pre-derived walletKeys
+    // (daemon path) and fall back to deriving from seedHex (existing
+    // in-process CLI path). See
+    // docs/spec/wallet-service/05-key-management.md D-KM-3.
+    let shieldedSecretKeys;
+    let dustSecretKey;
+    let nightExternalKey;
+    if (walletKeys) {
+        shieldedSecretKeys = walletKeys.shieldedSecretKeys;
+        dustSecretKey = walletKeys.dustSecretKey;
+        nightExternalKey = walletKeys.nightExternalKey;
+    }
+    else {
+        if (!seedHex) {
+            throw new WalletError('WALLET_ERROR', 'callCircuit requires either walletKeys or seedHex');
+        }
+        const hdWallet = HDWallet.fromSeed(Buffer.from(seedHex, 'hex'));
+        if (hdWallet.type !== 'seedOk')
+            throw new WalletError('WALLET_ERROR', 'Invalid seed');
+        const keyResult = hdWallet.hdWallet
+            .selectAccount(0)
+            .selectRoles([Roles.Zswap, Roles.NightExternal, Roles.Dust])
+            .deriveKeysAt(0);
+        if (keyResult.type !== 'keysDerived')
+            throw new WalletError('WALLET_ERROR', 'Key derivation failed');
+        hdWallet.hdWallet.clear();
+        shieldedSecretKeys = ledger.ZswapSecretKeys.fromSeed(keyResult.keys[Roles.Zswap]);
+        dustSecretKey = ledger.DustSecretKey.fromSeed(keyResult.keys[Roles.Dust]);
+        nightExternalKey = keyResult.keys[Roles.NightExternal];
+    }
+    const keystore = createKeystore(nightExternalKey, network.id);
+    // Wait for wallet sync + dust stabilization (same as deploy.ts)
+    const facade = syncedWallet.facade;
+    const state = await Rx.firstValueFrom(facade.state().pipe(Rx.filter((s) => {
+        try {
+            const unDone = s.unshielded?.progress?.isStrictlyComplete?.() === true;
+            const dustDone = s.dust?.progress?.isStrictlyComplete?.() === true;
+            if (unDone && dustDone)
+                return true;
+        }
+        catch { }
+        return s.isSynced === true;
+    }), Rx.bufferCount(2, 1), Rx.filter(([a, b]) => {
+        try {
+            const dustA = a.dust?.balance?.(new Date()) ?? 0n;
+            const dustB = b.dust?.balance?.(new Date()) ?? 0n;
+            return dustA === dustB;
+        }
+        catch {
+            return true;
+        }
+    }), Rx.map(([, b]) => b)));
+    const coinPublicKey = state.shielded.coinPublicKey.toHexString();
+    const encPublicKey = state.shielded.encryptionPublicKey.toHexString();
+    const unshieldedAddr = keystore.getBech32Address().toString();
+    // Resolve SDK packages from the project's node_modules
+    const projRoot = projectDir?.trim() || resolvePath(artifactPath, '..', '..');
+    const projRequire = createRequire(resolvePath(projRoot, 'node_modules', '_virtual.js'));
+    let CompiledContract;
+    let findDeployedContract;
+    try {
+        CompiledContract = projRequire('@midnight-ntwrk/compact-js').CompiledContract;
+        // findDeployedContract instead of submitCallTx — fixes a bug where
+        // calling a contract moth did not itself deploy throws "No private
+        // state found at private state ID '<contractName>State'".
+        // submitCallTx uses an older code path that doesn't honor
+        // initialPrivateState. findDeployedContract DOES write
+        // initialPrivateState before returning a callTx handle, so the
+        // private state exists by the time the inner submitCallTx runs.
+        findDeployedContract = projRequire('@midnight-ntwrk/midnight-js/contracts').findDeployedContract;
+    }
+    catch {
+        const cjs = await import('@midnight-ntwrk/compact-js');
+        const contracts = await import('@midnight-ntwrk/midnight-js/contracts');
+        CompiledContract = cjs.CompiledContract;
+        findDeployedContract = contracts.findDeployedContract;
+    }
+    // Load the contract module
+    const managedDir = artifactPath;
+    const contractName = basename(managedDir);
+    const contractJs = join(managedDir, 'contract', 'index.js');
+    if (!existsSync(contractJs)) {
+        throw new WalletError('INVALID_INPUT', `No compiled contract at ${contractJs}`);
+    }
+    const contractModule = await import(pathToFileURL(contractJs).href);
+    // Build CompiledContract using the .pipe() pattern (same as deploy)
+    let compiledContract;
+    if (witnesses) {
+        compiledContract = CompiledContract.make(contractName, contractModule.Contract).pipe(CompiledContract.withWitnesses(witnesses), CompiledContract.withCompiledFileAssets(managedDir));
+    }
+    else {
+        compiledContract = CompiledContract.make(contractName, contractModule.Contract).pipe(CompiledContract.withVacantWitnesses, CompiledContract.withCompiledFileAssets(managedDir));
+    }
+    // Providers — same pattern as deploy.ts
+    const zkConfigProvider = new NodeZkConfigProvider(artifactPath);
+    const midnightProvider = createMidnightProvider(network);
+    const indexerHttpUrl = network.indexerUrl;
+    const indexerWsUrl = indexerHttpUrl.replace(/^https:/, 'wss:').replace(/^http:/, 'ws:') + '/ws';
+    const publicDataProvider = indexerPublicDataProvider(indexerHttpUrl, indexerWsUrl);
+    // Selectable prover (reconcile decision #1: keep EITHER WASM or server).
+    // createProofProvider picks per resolveProverConfig(network). For server mode
+    // it proves through the SDK's httpClientProvingProvider via ledger's
+    // transaction.prove(), which runs the preimage through
+    // createProvingPayload/createCheckPayload — i.e. it versions the payload and
+    // attaches the circuit's wrapped-IR from zkConfigProvider. That is why it does
+    // NOT hit the unversioned "expected proof-preimage-versioned" failure that a
+    // hand-rolled bare-preimage POST would (the fix/tui-circuit-call-proof bug):
+    // the versioning happens inside ledger.prove, not in the provider.
+    const proofProvider = createProofProvider(resolveProverConfig(network), zkConfigProvider.asKeyMaterialProvider());
+    // Wallet provider with real transaction balancing + signing (same as deploy.ts)
+    const walletProvider = {
+        getCoinPublicKey: () => coinPublicKey,
+        getEncryptionPublicKey: () => encPublicKey,
+        async balanceTx(tx, ttl) {
+            const recipe = await facade.balanceUnboundTransaction(tx, { shieldedSecretKeys, dustSecretKey }, { ttl: ttl ?? new Date(Date.now() + 30 * 60_000) });
+            const signFn = (payload) => keystore.signData(payload);
+            signTransactionIntents(recipe.baseTransaction, signFn, 'proof');
+            if (recipe.balancingTransaction) {
+                signTransactionIntents(recipe.balancingTransaction, signFn, 'pre-proof');
+            }
+            return facade.finalizeRecipe(recipe);
+        },
+        submitTx: async (tx) => {
+            return facade.submitTransaction(tx);
+        },
+    };
+    const levelDbDir = join(homedir(), '.moth', 'level-db', network.id, encPublicKey.slice(0, 16));
+    const providers = {
+        zkConfigProvider: zkConfigProvider,
+        proofProvider: proofProvider,
+        walletProvider: walletProvider,
+        midnightProvider: walletProvider,
+        publicDataProvider: publicDataProvider,
+        privateStateProvider: levelPrivateStateProvider({
+            midnightDbName: levelDbDir,
+            privateStateStoreName: contractName + '-state',
+            privateStoragePasswordProvider: () => unshieldedAddr,
+            accountId: unshieldedAddr,
+        }),
+    };
+    // Normalize user-supplied args into a positional argument array, matching the
+    // convention used by `deploy` (see toPositionalArgs):
+    //   - a JSON array is spread into positional circuit arguments
+    //   - a single object/scalar becomes one argument
+    //   - the "no args" sentinels that both the CLI and daemon pass when the user
+    //     supplied nothing ({} / undefined) collapse to [], and an explicit empty
+    //     array [] stays empty — so circuits like `issue_credential(context)` that
+    //     take no user args aren't sent a spurious argument ("expected 1 argument,
+    //     received 2").
+    // findDeployedContract populates private state at `privateStateId` from
+    // `initialPrivateState` BEFORE returning a callTx handle. The inner
+    // submitCallTx (invoked when we call deployed.callTx[circuit]) then
+    // finds the state and proceeds normally.
+    const deployed = await findDeployedContract(providers, {
+        contractAddress,
+        compiledContract,
+        privateStateId: contractName + 'State',
+        initialPrivateState: {},
+    });
+    const callArgs = toPositionalArgs(args);
+    let result;
+    try {
+        result = await deployed.callTx[circuitName](...callArgs);
+    }
+    catch (err) {
+        // Effect-TS / midnight-js wraps the real cause inside several layers.
+        // Walk and log them so wallet errors surface in moth's JSON output.
+        let cur = err;
+        let depth = 0;
+        const chain = [];
+        while (cur && depth < 8) {
+            const tag = cur._tag ?? cur.name ?? cur.constructor?.name ?? 'Error';
+            chain.push(`[${depth}] ${tag}: ${cur.message ?? String(cur)}`);
+            cur = cur.cause ?? cur.failure;
+            depth++;
+        }
+        process.stderr.write('Circuit error chain:\n' + chain.join('\n') + '\n');
+        throw err;
+    }
+    return {
+        hash: result?.public?.txId ?? '',
+        status: 'SUCCESS',
+        blockHash: result?.public?.blockHash ?? null,
+        blockHeight: result?.public?.blockHeight ?? null,
+        contractAddress,
+        fees: null,
+    };
+}
+/** Sign unshielded transaction intents (same as deploy.ts / mn-tui) */
+function signTransactionIntents(tx, signFn, proofMarker) {
+    if (!tx.intents || tx.intents.size === 0)
+        return;
+    for (const segment of tx.intents.keys()) {
+        const intent = tx.intents.get(segment);
+        if (!intent)
+            continue;
+        const cloned = ledger.Intent.deserialize('signature', proofMarker, 'pre-binding', intent.serialize());
+        const signature = signFn(cloned.signatureData(segment));
+        if (cloned.fallibleUnshieldedOffer) {
+            const sigs = cloned.fallibleUnshieldedOffer.inputs.map((_, i) => cloned.fallibleUnshieldedOffer.signatures.at(i) ?? signature);
+            cloned.fallibleUnshieldedOffer = cloned.fallibleUnshieldedOffer.addSignatures(sigs);
+        }
+        if (cloned.guaranteedUnshieldedOffer) {
+            const sigs = cloned.guaranteedUnshieldedOffer.inputs.map((_, i) => cloned.guaranteedUnshieldedOffer.signatures.at(i) ?? signature);
+            cloned.guaranteedUnshieldedOffer = cloned.guaranteedUnshieldedOffer.addSignatures(sigs);
+        }
+        tx.intents.set(segment, cloned);
+    }
+}
+//# sourceMappingURL=call.js.map

package/dist/contract/call.js.map

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

package/dist/contract/deploy.d.ts

@@ -0,0 +1,36 @@
+import type { TransactionResult } from '../types/transaction.js';
+import { type NetworkConfig } from '../types/network.js';
+import type { ContractArtifact } from './artifact-loader.js';
+import type { SyncedWallet } from '../sync/wallet-sync.js';
+import type { WalletKeys } from '../sync/operations.js';
+export interface DeployOptions {
+    artifact: ContractArtifact;
+    /** Pre-derived typed key bundle. Preferred over `seedHex` when
+     *  available — the daemon path passes this so the raw seed never
+     *  has to enter the contract module. See
+     *  docs/spec/wallet-service/05-key-management.md D-KM-3. */
+    walletKeys?: WalletKeys;
+    /** BIP-39 hex seed. Required only when `walletKeys` is not supplied. */
+    seedHex?: string;
+    network: NetworkConfig;
+    /** A synced wallet facade — required for balancing transactions */
+    syncedWallet?: SyncedWallet;
+    witnessPath?: string;
+    /** Project directory containing node_modules with matching SDK versions */
+    projectDir?: string;
+    timeoutMs?: number;
+    onProgress?: (stage: string) => void;
+    /**
+     * Positional constructor arguments, in the order defined by the compiled contract's
+     * generated `initialState(ctx, ...ctorArgs)`. Omit (or pass an empty array) for
+     * contracts with a no-argument constructor.
+     */
+    args?: unknown[];
+    /**
+     * The initial private state to run the contract constructor against. Defaults to `{}`
+     * to preserve prior behavior for contracts with no meaningful private state.
+     */
+    initialPrivateState?: unknown;
+}
+export declare function deployContract(options: DeployOptions): Promise<TransactionResult>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/contract/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/contract/deploy.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAsB,KAAK,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAE5E,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;gEAG4D;IAC5D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,mEAAmE;IACnE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAkFD,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgTvF"}