@shieldedtech/moth-cli 0.2.0

package/dist/commands/dust/register.js

@@ -0,0 +1,120 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { getPassphrase } from '../../adapters/passphrase.js';
+import { designateForDustWithKeys, estimateDustRegistration, describeWait, DustRegistrationNotYetError, startWalletSync, } from '@shieldedtech/moth-wallet';
+export default class DustRegister extends BaseCommand {
+    static description = 'Register wallet for DUST generation';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        receiver: Flags.string({
+            description: 'DUST receiver address override (default: own DUST address)',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Skip confirmation prompt',
+        }),
+        // Registration self-funds from the DUST its NIGHT would already have
+        // generated, so a freshly funded wallet has to wait. Without this the only
+        // option is to re-run the command — which re-syncs first, so the wait costs
+        // far more than it should.
+        wait: Flags.boolean({
+            default: false,
+            description: 'Wait until the registration fee is covered, instead of exiting',
+        }),
+        'wait-timeout': Flags.integer({
+            default: 3600,
+            description: 'Seconds to keep waiting with --wait before giving up',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DustRegister);
+        this.outputFormat = flags.output ?? 'text';
+        this.verbose = flags.verbose;
+        const walletName = await this.resolveWalletName(flags);
+        const passphrase = await getPassphrase();
+        const wallet = await this.walletManager.unlock(walletName, passphrase);
+        const network = await this.getNetworkConfig(flags.network, this.getNetworkOverrides(flags));
+        // SR-003: Confirm transaction
+        await this.confirmTransaction({
+            'Operation': 'Register for DUST generation',
+            'Network': network.id,
+            'Wallet': walletName,
+            ...(flags.receiver ? { 'Receiver': flags.receiver } : {}),
+        }, flags);
+        process.stderr.write('Syncing wallet before registration...\n');
+        const syncedWallet = await startWalletSync(wallet.walletKeys, network, (msg) => {
+            this.log_verbose(msg);
+        }, walletName);
+        try {
+            // Ask before building. The estimate is the only place the wait is
+            // knowable, and finding out by failing means paying for a sync first.
+            let estimate = await estimateDustRegistration(syncedWallet.facade);
+            if (!estimate.affordable) {
+                if (estimate.secondsUntilAffordable === null) {
+                    this.outputError('WALLET_ERROR', 'This wallet does not hold enough NIGHT to cover the registration fee, and waiting will not change that.', 'Registration pays its own fee from the DUST its NIGHT would already have generated; that amount is capped by how much NIGHT you hold. Fund the wallet with more NIGHT.');
+                    this.exit(1);
+                }
+                if (!flags.wait) {
+                    this.outputSuccess({
+                        status: 'not_yet',
+                        message: `Registration pays its own fee from the DUST this NIGHT has generated since it arrived. ` +
+                            `Ready in ${describeWait(estimate.secondsUntilAffordable)}. Re-run with --wait to block until then.`,
+                        feeSpecks: estimate.fee.toString(),
+                        availableSpecks: estimate.available.toString(),
+                        secondsUntilAffordable: estimate.secondsUntilAffordable,
+                        wallet: walletName,
+                        network: network.id,
+                    });
+                    return;
+                }
+                // Poll rather than sleeping the whole predicted wait in one go: the
+                // estimate moves if the wallet's NIGHT changes under us, and a long
+                // blind sleep would report success or failure minutes late either way.
+                const deadline = Date.now() + flags['wait-timeout'] * 1_000;
+                while (!estimate.affordable) {
+                    if (Date.now() >= deadline) {
+                        this.outputError('WALLET_ERROR', `Still short of the registration fee after ${flags['wait-timeout']}s.`, `Needed ${describeWait(estimate.secondsUntilAffordable ?? 0)} at the last check; raise --wait-timeout or hold more NIGHT.`);
+                        this.exit(1);
+                    }
+                    const remaining = estimate.secondsUntilAffordable ?? 30;
+                    const sleepSeconds = Math.min(Math.max(remaining, 5), 30);
+                    process.stderr.write(`Waiting for generated DUST to cover the fee — ${describeWait(remaining)} to go...\n`);
+                    await new Promise((r) => setTimeout(r, sleepSeconds * 1_000));
+                    estimate = await estimateDustRegistration(syncedWallet.facade);
+                }
+            }
+            const txHash = await designateForDustWithKeys(syncedWallet.facade, wallet.walletKeys, network.id, flags.receiver, (stage) => { process.stderr.write(`DUST register: ${stage}\n`); });
+            if (txHash) {
+                this.outputSuccess({
+                    status: 'registered',
+                    txHash,
+                    wallet: walletName,
+                    network: network.id,
+                });
+            }
+            else {
+                this.outputSuccess({
+                    status: 'already_registered',
+                    message: 'All NIGHT UTXOs already registered for DUST generation',
+                    wallet: walletName,
+                });
+            }
+        }
+        catch (err) {
+            // Belt and braces: the pre-flight above should have caught this, but the
+            // wallet's NIGHT can change between the estimate and the build. Report it
+            // as "not yet" rather than as a stack trace either way.
+            if (err instanceof DustRegistrationNotYetError) {
+                this.outputError('WALLET_ERROR', err.message, 'Re-run with --wait to block until the fee is covered.');
+                this.exit(1);
+            }
+            throw err;
+        }
+        finally {
+            await syncedWallet.stop();
+            wallet.lock();
+        }
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/commands/dust/register.js.map

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

package/dist/commands/dust/status.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../base-command.js';
+export default class DustStatus extends BaseCommand {
+    static description: string;
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        network: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wallet: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'proof-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        prover: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        indexer: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'node-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/dust/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/dust/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,WAAW,SAAiC;IAE5D,OAAgB,KAAK;;;;;;;;;;MAEnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C3B"}

package/dist/commands/dust/status.js

@@ -0,0 +1,47 @@
+import { BaseCommand } from '../../base-command.js';
+import { IndexerClient } from '@shieldedtech/moth-wallet';
+export default class DustStatus extends BaseCommand {
+    static description = 'Show DUST generation status';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(DustStatus);
+        this.outputFormat = flags.output ?? 'text';
+        this.verbose = flags.verbose;
+        const walletName = await this.resolveWalletName(flags);
+        const wallets = await this.walletManager.list();
+        const wallet = wallets.find((w) => w.name === walletName);
+        if (!wallet) {
+            this.outputError('WALLET_ERROR', `Wallet "${walletName}" not found`);
+            this.exit(1);
+            return;
+        }
+        const network = await this.getNetworkConfig(flags.network, this.getNetworkOverrides(flags));
+        const client = new IndexerClient(network.indexerUrl);
+        // Query DUST status — requires the Cardano reward address
+        // For now, use the wallet address as a placeholder
+        const statuses = await client.getDustGenerationStatus([wallet.address]);
+        if (statuses.length === 0) {
+            this.outputSuccess({
+                registered: false,
+                dustAddress: null,
+                nightBalance: '0',
+                generationRate: '0',
+                maxCapacity: '0',
+                currentCapacity: '0',
+            });
+            return;
+        }
+        const status = statuses[0];
+        this.outputSuccess({
+            registered: status.registered,
+            dustAddress: status.dustAddress,
+            nightBalance: status.nightBalance,
+            generationRate: status.generationRate,
+            maxCapacity: status.maxCapacity,
+            currentCapacity: status.currentCapacity,
+        });
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/dust/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/dust/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAU,WAAW,GAAG,6BAA6B,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,WAAW,CAAC,SAAS;KACzB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAI,KAAK,CAAC,MAA0B,IAAI,MAAM,CAAC;QAChE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAE5E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,WAAW,UAAU,aAAa,CAAC,CAAC;YACrE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAErD,0DAA0D;QAC1D,mDAAmD;QACnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAExE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC;gBACjB,UAAU,EAAE,KAAK;gBACjB,WAAW,EAAE,IAAI;gBACjB,YAAY,EAAE,GAAG;gBACjB,cAAc,EAAE,GAAG;gBACnB,WAAW,EAAE,GAAG;gBAChB,eAAe,EAAE,GAAG;aACrB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/info.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../base-command.js';
+export default class Info extends BaseCommand {
+    static description: string;
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        network: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wallet: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'proof-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        prover: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        indexer: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'node-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=info.d.ts.map

package/dist/commands/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,OAAgB,WAAW,SAAuC;IAElE,OAAgB,KAAK;;;;;;;;;;MAEnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+B3B"}

package/dist/commands/info.js

@@ -0,0 +1,37 @@
+import { BaseCommand } from '../base-command.js';
+import { JsonRpcNodeClient, resolveProverConfig } from '@shieldedtech/moth-wallet';
+export default class Info extends BaseCommand {
+    static description = 'Show network and node information';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(Info);
+        this.outputFormat = flags.output ?? 'text';
+        this.verbose = flags.verbose;
+        const network = await this.getNetworkConfig(flags.network, this.getNetworkOverrides(flags));
+        let blockHeight = 'unknown';
+        let syncStatus = 'disconnected';
+        try {
+            const client = new JsonRpcNodeClient();
+            await client.connect(network);
+            blockHeight = await client.getBlockHeight();
+            syncStatus = 'connected';
+            await client.disconnect();
+        }
+        catch {
+            syncStatus = 'unreachable';
+        }
+        const prover = resolveProverConfig(network);
+        this.outputSuccess({
+            network: network.id,
+            nodeUrl: network.nodeUrl,
+            indexerUrl: network.indexerUrl,
+            prover: prover.type,
+            proofServerUrl: prover.type === 'server' ? prover.url : null,
+            blockHeight,
+            syncStatus,
+        });
+    }
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEnF,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,MAAM,CAAU,WAAW,GAAG,mCAAmC,CAAC;IAElE,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,WAAW,CAAC,SAAS;KACzB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAI,KAAK,CAAC,MAA0B,IAAI,MAAM,CAAC;QAChE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5F,IAAI,WAAW,GAAoB,SAAS,CAAC;QAC7C,IAAI,UAAU,GAAG,cAAc,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACvC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9B,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;YAC5C,UAAU,GAAG,WAAW,CAAC;YACzB,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,aAAa,CAAC;QAC7B,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,aAAa,CAAC;YACjB,OAAO,EAAE,OAAO,CAAC,EAAE;YACnB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,cAAc,EAAE,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;YAC5D,WAAW;YACX,UAAU;SACX,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/maintenance/insert-vk.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../base-command.js';
+export default class MaintenanceInsertVk extends BaseCommand {
+    static description: string;
+    static flags: {
+        address: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'circuit-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'vk-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        artifact: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'project-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        network: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wallet: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'proof-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        prover: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        indexer: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'node-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=insert-vk.d.ts.map

package/dist/commands/maintenance/insert-vk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-vk.d.ts","sourceRoot":"","sources":["../../../src/commands/maintenance/insert-vk.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUpD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,WAAW;IAC1D,OAAgB,WAAW,SAAqF;IAEhH,OAAgB,KAAK;;;;;;;;;;;;;;;;MAuBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiE3B"}

package/dist/commands/maintenance/insert-vk.js

@@ -0,0 +1,92 @@
+import { Flags } from '@oclif/core';
+import { resolve } from 'node:path';
+import { BaseCommand } from '../../base-command.js';
+import { describeProver, insertVerifierKey, loadContractArtifact, resolveProverConfig, startWalletSync, } from '@shieldedtech/moth-wallet';
+import { getPassphrase } from '../../adapters/passphrase.js';
+export default class MaintenanceInsertVk extends BaseCommand {
+    static description = 'Insert a verifier key for a circuit on a deployed contract (maintenance update)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        address: Flags.string({
+            required: false,
+            description: 'Deployed contract address',
+        }),
+        'circuit-id': Flags.string({
+            required: false,
+            description: 'Name of the circuit whose verifier key is being inserted',
+        }),
+        'vk-file': Flags.string({
+            required: false,
+            description: 'Path to the .verifier file (raw bytes from compact compile)',
+        }),
+        artifact: Flags.string({
+            required: false,
+            description: 'Path to the FULL compiled contract artifact directory (the one declaring this circuit)',
+        }),
+        'project-dir': Flags.string({
+            description: 'Project directory for SDK dependency resolution',
+            env: 'MOTH_PROJECT_DIR',
+        }),
+        yes: Flags.boolean({ char: 'y', description: 'Skip confirmation prompt', default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(MaintenanceInsertVk);
+        this.outputFormat = flags.output ?? 'text';
+        this.verbose = flags.verbose;
+        const address = await this.promptIfMissing(flags.address, 'Contract address');
+        const circuitId = await this.promptIfMissing(flags['circuit-id'], 'Circuit ID');
+        const vkPath = await this.promptIfMissing(flags['vk-file'], 'Verifier key file (.verifier)');
+        const artifactPath = await this.promptIfMissing(flags.artifact, 'Full compiled contract artifact directory');
+        const artifact = await loadContractArtifact(resolve(artifactPath));
+        this.log_verbose(`Loaded artifact: ${artifact.path}`);
+        const walletName = await this.resolveWalletName(flags);
+        const passphrase = await getPassphrase();
+        const wallet = await this.walletManager.unlock(walletName, passphrase);
+        const network = await this.getNetworkConfig(flags.network, this.getNetworkOverrides(flags));
+        await this.confirmTransaction({
+            'Operation': `Insert verifier key for circuit "${circuitId}"`,
+            'Contract': address,
+            'Verifier key file': resolve(vkPath),
+            'Artifact': artifact.path,
+            'Network': network.id,
+            'Wallet': walletName,
+            'Prover': describeProver(resolveProverConfig(network)),
+        }, flags);
+        process.stderr.write('Syncing wallet before maintenance update...\n');
+        const syncedWallet = await startWalletSync(wallet.walletKeys, network, (msg) => {
+            this.log_verbose(msg);
+            if (msg.includes('syncing') || msg.includes('synced')) {
+                process.stderr.write(`\r  ${msg}${''.padEnd(20)}`);
+            }
+        }, walletName);
+        process.stderr.write('\n');
+        try {
+            process.stderr.write(`Inserting verifier key for "${circuitId}"...\n`);
+            const result = await insertVerifierKey({
+                contractAddress: address,
+                circuitId,
+                verifierKeyPath: resolve(vkPath),
+                keys: wallet.keys,
+                walletKeys: wallet.walletKeys,
+                network,
+                syncedWallet,
+                artifactPath: artifact.path,
+                projectDir: flags['project-dir'] ? resolve(flags['project-dir']) : undefined,
+                timeoutMs: flags.timeout ? flags.timeout * 1000 : 120_000,
+            });
+            this.outputSuccess({
+                txHash: result.hash,
+                status: result.status,
+                blockHash: result.blockHash,
+                blockHeight: result.blockHeight,
+                circuitId,
+                contractAddress: result.contractAddress,
+            });
+        }
+        finally {
+            await syncedWallet.stop();
+            wallet.lock();
+        }
+    }
+}
+//# sourceMappingURL=insert-vk.js.map

package/dist/commands/maintenance/insert-vk.js.map

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

package/dist/commands/maintenance/insert-vks-batch.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../base-command.js';
+export default class MaintenanceInsertVksBatch extends BaseCommand {
+    static description: string;
+    static flags: {
+        address: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        artifact: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        circuits: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'skip-existing': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'project-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        network: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wallet: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'proof-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        prover: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        indexer: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'node-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=insert-vks-batch.d.ts.map

package/dist/commands/maintenance/insert-vks-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-vks-batch.d.ts","sourceRoot":"","sources":["../../../src/commands/maintenance/insert-vks-batch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUpD,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,WAAW;IAChE,OAAgB,WAAW,SAG0C;IAErE,OAAgB,KAAK;;;;;;;;;;;;;;;;MAoBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0G3B"}

package/dist/commands/maintenance/insert-vks-batch.js

@@ -0,0 +1,130 @@
+import { Flags } from '@oclif/core';
+import { resolve, join } from 'node:path';
+import { readdirSync, existsSync } from 'node:fs';
+import { BaseCommand } from '../../base-command.js';
+import { describeProver, insertVerifierKeys, loadContractArtifact, resolveProverConfig, startWalletSync, } from '@shieldedtech/moth-wallet';
+import { getPassphrase } from '../../adapters/passphrase.js';
+export default class MaintenanceInsertVksBatch extends BaseCommand {
+    static description = 'Insert multiple verifier keys for a deployed contract in one command (Level 1 batching — '
+        + 'one tx per VK, shared wallet sync). Use for staged deployment of contracts whose '
+        + 'verifier-key payload would exceed the per-tx block weight cap.';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        address: Flags.string({ required: false, description: 'Deployed contract address' }),
+        artifact: Flags.string({
+            required: false,
+            description: 'Path to the FULL compiled artifact directory (contains keys/*.verifier)',
+        }),
+        circuits: Flags.string({
+            required: false,
+            description: 'Comma-separated circuit names to insert. Default: every .verifier in <artifact>/keys.',
+        }),
+        'skip-existing': Flags.boolean({
+            default: false,
+            description: 'Query the chain first and skip circuits already on-chain.',
+        }),
+        'project-dir': Flags.string({
+            description: 'Project directory for SDK dep resolution',
+            env: 'MOTH_PROJECT_DIR',
+        }),
+        yes: Flags.boolean({ char: 'y', description: 'Skip confirmation prompt', default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(MaintenanceInsertVksBatch);
+        this.outputFormat = flags.output ?? 'text';
+        this.verbose = flags.verbose;
+        const address = await this.promptIfMissing(flags.address, 'Contract address');
+        const artifactPath = await this.promptIfMissing(flags.artifact, 'Full compiled artifact directory');
+        const artifact = await loadContractArtifact(resolve(artifactPath));
+        this.log_verbose(`Loaded artifact: ${artifact.path}`);
+        // Resolve circuit list
+        const keysDir = join(artifact.path, 'keys');
+        if (!existsSync(keysDir)) {
+            this.error(`No keys/ directory in artifact: ${keysDir}`);
+        }
+        const allKeyFiles = readdirSync(keysDir).filter(f => f.endsWith('.verifier'));
+        const allCircuitNames = allKeyFiles.map(f => f.replace(/\.verifier$/, ''));
+        let circuitsToInsert;
+        if (flags.circuits && flags.circuits.trim()) {
+            circuitsToInsert = flags.circuits.split(',').map(s => s.trim()).filter(Boolean);
+            const missing = circuitsToInsert.filter(c => !allCircuitNames.includes(c));
+            if (missing.length > 0) {
+                this.error(`Requested circuits not found in artifact keys/: ${missing.join(', ')}`);
+            }
+        }
+        else {
+            circuitsToInsert = allCircuitNames;
+        }
+        if (circuitsToInsert.length === 0) {
+            this.error('No circuits to insert.');
+        }
+        const entries = circuitsToInsert.map(circuitId => ({
+            circuitId,
+            verifierKeyPath: join(keysDir, `${circuitId}.verifier`),
+        }));
+        const walletName = await this.resolveWalletName(flags);
+        const passphrase = await getPassphrase();
+        const wallet = await this.walletManager.unlock(walletName, passphrase);
+        const network = await this.getNetworkConfig(flags.network, this.getNetworkOverrides(flags));
+        await this.confirmTransaction({
+            'Operation': `Insert ${entries.length} verifier key(s)`,
+            'Contract': address,
+            'Artifact': artifact.path,
+            'Circuits': entries.map(e => e.circuitId).join(', '),
+            'Skip already-defined': flags['skip-existing'] ? 'yes' : 'no',
+            'Network': network.id,
+            'Wallet': walletName,
+            'Prover': describeProver(resolveProverConfig(network)),
+        }, flags);
+        process.stderr.write('Syncing wallet before batch maintenance update...\n');
+        const syncedWallet = await startWalletSync(wallet.walletKeys, network, (msg) => {
+            this.log_verbose(msg);
+            if (msg.includes('syncing') || msg.includes('synced')) {
+                process.stderr.write(`\r  ${msg}${''.padEnd(20)}`);
+            }
+        }, walletName);
+        process.stderr.write('\n');
+        try {
+            const result = await insertVerifierKeys({
+                contractAddress: address,
+                entries,
+                keys: wallet.keys,
+                walletKeys: wallet.walletKeys,
+                network,
+                syncedWallet,
+                artifactPath: artifact.path,
+                skipExisting: flags['skip-existing'],
+                projectDir: flags['project-dir'] ? resolve(flags['project-dir']) : undefined,
+                timeoutMs: flags.timeout ? flags.timeout * 1000 : 120_000,
+                onProgress: (e) => {
+                    if (e.status === 'inserted') {
+                        process.stderr.write(`  ✓ ${e.circuitId} — tx ${e.txHash?.slice(0, 12) ?? ''} @ block ${e.blockHeight}\n`);
+                    }
+                    else if (e.status === 'skipped-existing') {
+                        process.stderr.write(`  · ${e.circuitId} — already on chain, skipped\n`);
+                    }
+                    else {
+                        process.stderr.write(`  ✗ ${e.circuitId} — ${e.error}\n`);
+                    }
+                },
+            });
+            this.outputSuccess({
+                contractAddress: result.contractAddress,
+                total: result.total,
+                inserted: result.inserted,
+                skipped: result.skipped,
+                failed: result.failed,
+                entries: result.entries,
+            });
+            if (result.failed > 0) {
+                process.stderr.write(`\n${result.failed} circuit(s) failed. Re-run with --skip-existing to retry only the missing ones.\n`);
+                process.exit(2);
+            }
+        }
+        finally {
+            await syncedWallet.stop();
+            wallet.lock();
+        }
+    }
+}
+//# sourceMappingURL=insert-vks-batch.js.map

package/dist/commands/maintenance/insert-vks-batch.js.map

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

package/dist/commands/mint.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../base-command.js';
+export default class Mint extends BaseCommand {
+    static description: string;
+    static args: {
+        amount: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        address: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        recipient: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        unshielded: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        network: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wallet: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'proof-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        prover: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        indexer: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'node-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=mint.d.ts.map

package/dist/commands/mint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint.d.ts","sourceRoot":"","sources":["../../src/commands/mint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAUjD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,OAAgB,WAAW,SAOd;IAEb,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;;;;;;;;;;MAanB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6F3B"}