@aztec-labs/aztec 6.0.0-nightly.20260829

package/dest/cli/aztec_start_options.js

@@ -0,0 +1,290 @@
+import { archiverConfigMappings } from '@aztec-labs/archiver/config';
+import { blobClientConfigMapping } from '@aztec-labs/blob-client/client/config';
+import { botConfigMappings } from '@aztec-labs/bot/config';
+import { l1ContractsConfigMappings } from '@aztec-labs/ethereum/config';
+import { l1ContractAddressesMapping } from '@aztec-labs/ethereum/l1-contract-addresses';
+import { l1ReaderConfigMappings } from '@aztec-labs/ethereum/l1-reader';
+import { getKeys } from '@aztec-labs/foundation/collection';
+import { booleanConfigHelper, isBooleanConfigValue, omitConfigMappings } from '@aztec-labs/foundation/config';
+import { sharedNodeConfigMappings } from '@aztec-labs/node-lib/config';
+import { bootnodeConfigMappings, p2pConfigMappings } from '@aztec-labs/p2p/config';
+import { proverAgentConfigMappings, proverBrokerConfigMappings } from '@aztec-labs/prover-client/broker/config';
+import { proverNodeConfigMappings } from '@aztec-labs/prover-node/config';
+import { allPxeConfigMappings } from '@aztec-labs/pxe/config';
+import { sequencerClientConfigMappings } from '@aztec-labs/sequencer-client/config';
+import { chainConfigMappings, nodeRpcConfigMappings } from '@aztec-labs/stdlib/config';
+import { dataConfigMappings } from '@aztec-labs/stdlib/kv-store';
+import { telemetryClientConfigMappings } from '@aztec-labs/telemetry-client/config';
+import { worldStateConfigMappings } from '@aztec-labs/world-state/config';
+import { DefaultMnemonic } from '../mnemonic.js';
+export const getOptions = (namespace, configMappings)=>{
+    const options = [];
+    for (const [key, { env, defaultValue: def, parseEnv, description, printDefault, fallback }] of Object.entries(configMappings)){
+        if (universalOptions.includes(key)) {
+            continue;
+        }
+        const isBoolean = isBooleanConfigValue(configMappings, key);
+        options.push({
+            flag: `--${namespace}.${key}${isBoolean ? '' : ' <value>'}`,
+            description,
+            defaultValue: def,
+            printDefault,
+            env: env,
+            fallback,
+            parseVal: parseEnv
+        });
+    }
+    return options;
+};
+const configToFlag = (flag, configMapping, overrideDefaultValue)=>{
+    if (!configMapping.isBoolean) {
+        flag += ' <value>';
+    }
+    const flagConfig = {
+        flag,
+        env: undefined,
+        defaultValue: undefined,
+        parseVal: configMapping.parseEnv,
+        ...configMapping
+    };
+    if (overrideDefaultValue !== undefined) {
+        flagConfig.defaultValue = overrideDefaultValue;
+    }
+    return flagConfig;
+};
+// These are options used by multiple modules so should be inputted once
+export const universalOptions = [
+    'l1ConsensusHostUrls',
+    'l1ConsensusHostApiKeys',
+    'l1ConsensusHostApiKeyHeaders',
+    'p2pEnabled',
+    'fishermanMode',
+    ...getKeys(chainConfigMappings),
+    ...getKeys(l1ContractsConfigMappings),
+    ...getKeys(l1ContractAddressesMapping),
+    ...getKeys(l1ReaderConfigMappings),
+    ...getKeys(dataConfigMappings),
+    ...getKeys(worldStateConfigMappings)
+];
+export const NETWORK_FLAG = 'network';
+// Define categories and options
+export const aztecStartOptions = {
+    MISC: [
+        {
+            flag: `--${NETWORK_FLAG} <value>`,
+            description: 'Network to run Aztec on',
+            defaultValue: undefined,
+            env: 'NETWORK'
+        },
+        configToFlag('--enable-auto-shutdown', sharedNodeConfigMappings.enableAutoShutdown),
+        configToFlag('--sync-mode', sharedNodeConfigMappings.syncMode),
+        configToFlag('--snapshots-urls', sharedNodeConfigMappings.snapshotsUrls),
+        configToFlag('--fisherman-mode', sharedNodeConfigMappings.fishermanMode)
+    ],
+    LOCAL_NETWORK: [
+        {
+            flag: '--local-network',
+            description: 'Starts Aztec Local Network',
+            defaultValue: undefined,
+            env: undefined
+        },
+        {
+            flag: '--local-network.l1Mnemonic <value>',
+            description: 'Mnemonic for L1 accounts. Will be used ',
+            defaultValue: DefaultMnemonic,
+            env: 'MNEMONIC'
+        },
+        {
+            flag: '--local-network.testAccounts',
+            description: 'Deploy test accounts on local network start',
+            env: 'TEST_ACCOUNTS',
+            ...booleanConfigHelper(true)
+        }
+    ],
+    API: [
+        {
+            flag: '--port <value>',
+            description: 'Port to run the Aztec Services on',
+            defaultValue: 8080,
+            env: 'AZTEC_PORT',
+            parseVal: (val)=>parseInt(val, 10)
+        },
+        {
+            flag: '--admin-port <value>',
+            description: 'Port to run admin APIs of Aztec Services on',
+            defaultValue: 8880,
+            env: 'AZTEC_ADMIN_PORT',
+            parseVal: (val)=>parseInt(val, 10)
+        },
+        {
+            flag: '--admin-api-key-hash <value>',
+            description: 'SHA-256 hex hash of a pre-generated admin API key. When set, the node uses this hash for authentication instead of auto-generating a key.',
+            defaultValue: undefined,
+            env: 'AZTEC_ADMIN_API_KEY_HASH'
+        },
+        {
+            flag: '--disable-admin-api-key',
+            description: 'Disable API key authentication on the admin RPC endpoint. By default, a key is auto-generated, displayed once, and its hash is persisted.',
+            defaultValue: false,
+            env: 'AZTEC_DISABLE_ADMIN_API_KEY',
+            // undefined means the flag was passed without a value (boolean toggle), treat as true.
+            parseVal: (val)=>val === undefined || val === 'true' || val === '1'
+        },
+        {
+            flag: '--reset-admin-api-key',
+            description: 'Force-generate a new admin API key, replacing any previously persisted key hash. The new key is displayed once at startup.',
+            defaultValue: false,
+            env: 'AZTEC_RESET_ADMIN_API_KEY',
+            parseVal: (val)=>val === 'true' || val === '1'
+        },
+        {
+            flag: '--node-debug',
+            description: 'Expose debug endpoints (e.g. mineBlock) on the main RPC port',
+            defaultValue: false,
+            env: 'AZTEC_NODE_DEBUG',
+            parseVal: (val)=>val === undefined || val === 'true' || val === '1'
+        },
+        {
+            flag: '--api-prefix <value>',
+            description: 'Prefix for API routes on any service that is started',
+            defaultValue: '',
+            env: 'API_PREFIX'
+        },
+        configToFlag('--rpcMaxBatchSize', nodeRpcConfigMappings.rpcMaxBatchSize),
+        configToFlag('--rpcMaxBodySize', nodeRpcConfigMappings.rpcMaxBodySize),
+        configToFlag('--rpc-http-keep-alive-timeout-ms', nodeRpcConfigMappings.rpcHttpKeepAliveTimeoutMs),
+        configToFlag('--rpc-http-headers-timeout-ms', nodeRpcConfigMappings.rpcHttpHeadersTimeoutMs),
+        configToFlag('--rpc-cors-allowed-headers', nodeRpcConfigMappings.rpcCorsAllowedHeaders),
+        configToFlag('--rpc-cors-allowed-origins', nodeRpcConfigMappings.rpcCorsAllowedOrigins),
+        configToFlag('--rpc-cors-allow-any-origin', nodeRpcConfigMappings.rpcCorsAllowAnyOrigin)
+    ],
+    ETHEREUM: [
+        configToFlag('--l1-chain-id', l1ReaderConfigMappings.l1ChainId),
+        // Do not set default for CLI: keep undefined unless provided via flag or env
+        configToFlag('--l1-rpc-urls', {
+            ...l1ReaderConfigMappings.l1RpcUrls,
+            defaultValue: undefined
+        }),
+        configToFlag('--l1-consensus-host-urls', blobClientConfigMapping.l1ConsensusHostUrls),
+        configToFlag('--l1-consensus-host-api-keys', blobClientConfigMapping.l1ConsensusHostApiKeys),
+        configToFlag('--l1-consensus-host-api-key-headers', blobClientConfigMapping.l1ConsensusHostApiKeyHeaders)
+    ],
+    'L1 CONTRACTS': [
+        configToFlag('--registry-address', l1ContractAddressesMapping.registryAddress),
+        configToFlag('--rollup-version', chainConfigMappings.rollupVersion)
+    ],
+    STORAGE: [
+        configToFlag('--data-directory', dataConfigMappings.dataDirectory),
+        configToFlag('--data-store-map-size-kb', dataConfigMappings.dataStoreMapSizeKb)
+    ],
+    'WORLD STATE': [
+        configToFlag('--world-state-data-directory', worldStateConfigMappings.worldStateDataDirectory),
+        configToFlag('--world-state-db-map-size-kb', worldStateConfigMappings.worldStateDbMapSizeKb),
+        configToFlag('--world-state-checkpoint-history', worldStateConfigMappings.worldStateCheckpointHistory)
+    ],
+    // We can't easily auto-generate node options as they're parts of modules defined below
+    'AZTEC NODE': [
+        {
+            flag: '--node',
+            description: 'Starts Aztec Node with options',
+            defaultValue: undefined,
+            env: undefined
+        }
+    ],
+    ARCHIVER: [
+        ...getOptions('archiver', omitConfigMappings(archiverConfigMappings, Object.keys(l1ContractsConfigMappings)))
+    ],
+    SEQUENCER: [
+        {
+            flag: '--sequencer',
+            description: 'Starts Aztec Sequencer with options',
+            defaultValue: undefined,
+            env: undefined
+        },
+        ...getOptions('sequencer', omitConfigMappings(sequencerClientConfigMappings, [
+            'fakeProcessingDelayPerTxMs',
+            'fakeThrowAfterProcessingTxCount',
+            'skipCollectingAttestations',
+            'skipInvalidateBlockAsProposer',
+            'blobSinkMapSizeKb'
+        ]))
+    ],
+    'PROVER NODE': [
+        {
+            flag: '--prover-node',
+            description: 'Starts Aztec Prover Node with options',
+            defaultValue: undefined,
+            env: undefined
+        },
+        ...getOptions('proverNode', omitConfigMappings(proverNodeConfigMappings, [
+            // filter out options passed separately
+            ...getKeys(proverBrokerConfigMappings),
+            ...getKeys(proverAgentConfigMappings)
+        ]))
+    ],
+    'PROVER BROKER': [
+        {
+            flag: '--prover-broker',
+            description: 'Starts Aztec proving job broker',
+            defaultValue: undefined,
+            env: undefined
+        },
+        ...getOptions('proverBroker', proverBrokerConfigMappings)
+    ],
+    'PROVER AGENT': [
+        {
+            flag: '--prover-agent',
+            description: 'Starts Aztec Prover Agent with options',
+            defaultValue: undefined,
+            env: undefined
+        },
+        ...getOptions('proverAgent', proverAgentConfigMappings)
+    ],
+    'P2P SUBSYSTEM': [
+        {
+            flag: '--p2p-enabled [value]',
+            description: 'Enable P2P subsystem',
+            env: 'P2P_ENABLED',
+            ...booleanConfigHelper()
+        },
+        ...getOptions('p2p', p2pConfigMappings)
+    ],
+    'P2P BOOTSTRAP': [
+        {
+            flag: '--p2p-bootstrap',
+            description: 'Starts Aztec P2P Bootstrap with options',
+            defaultValue: undefined,
+            env: undefined
+        },
+        ...getOptions('p2pBootstrap', omitConfigMappings(bootnodeConfigMappings, [
+            'p2pIp',
+            'p2pPort',
+            'peerIdPrivateKey',
+            'bootstrapNodes',
+            'listenAddress'
+        ]))
+    ],
+    TELEMETRY: [
+        ...getOptions('tel', telemetryClientConfigMappings)
+    ],
+    BOT: [
+        {
+            flag: '--bot',
+            description: 'Starts Aztec Bot with options',
+            defaultValue: undefined,
+            env: undefined
+        },
+        ...getOptions('bot', botConfigMappings)
+    ],
+    PXE: [
+        ...getOptions('pxe', allPxeConfigMappings)
+    ],
+    TXE: [
+        {
+            flag: '--txe',
+            description: 'Starts Aztec TXE with options',
+            defaultValue: undefined,
+            env: undefined
+        }
+    ]
+};

package/dest/cli/cli.d.ts

@@ -0,0 +1,9 @@
+import type { LogFn, Logger } from '@aztec-labs/foundation/log';
+import { Command } from 'commander';
+/**
+ * Returns commander program that defines the 'aztec' command line interface.
+ * @param userLog - log function for logging user output.
+ * @param debugLogger - logger for logging debug messages.
+ */
+export declare function injectAztecCommands(program: Command, userLog: LogFn, debugLogger: Logger): Command;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDaEUsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUtwQzs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0EyQ2xHIn0=

package/dest/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA2ClG"}

package/dest/cli/cli.js

@@ -0,0 +1,37 @@
+import { Command } from 'commander';
+import { aztecStartOptions } from './aztec_start_options.js';
+import { addOptions, printAztecStartHelpText } from './util.js';
+/**
+ * Returns commander program that defines the 'aztec' command line interface.
+ * @param userLog - log function for logging user output.
+ * @param debugLogger - logger for logging debug messages.
+ */ export function injectAztecCommands(program, userLog, debugLogger) {
+    const startCmd = new Command('start').description('Starts Aztec modules. Options for each module can be set as key-value pairs (e.g. "option1=value1,option2=value2") or as environment variables.');
+    // Assuming commands are added elsewhere, here we just add options to the main program
+    Object.keys(aztecStartOptions).forEach((category)=>{
+        addOptions(startCmd, aztecStartOptions[category]);
+    });
+    startCmd.helpInformation = printAztecStartHelpText;
+    startCmd.action(async (options)=>{
+        const { aztecStart } = await import('./aztec_start_action.js');
+        return await aztecStart(options, userLog, debugLogger);
+    });
+    program.addCommand(startCmd);
+    program.configureHelp({
+        sortSubcommands: true
+    });
+    if (process.env.AZTEC_SHELL_WRAPPER) {
+        program.addHelpText('after', `
+Additional commands:
+
+  init               creates a new Aztec Noir workspace in the current directory.
+  new <name>         creates a new Aztec Noir workspace in its own directory (or creates a new contract-test crates pair and adds it to the current workspace if run in workspace).
+  test [options]     starts a TXE and runs "nargo test" using it as the oracle resolver.
+    `);
+    }
+    program.command('preload-crs').description('Preload the points data needed for proving and verifying').action(async (options)=>{
+        const { preloadCrs } = await import('./preload_crs.js');
+        return await preloadCrs(options, userLog, debugLogger);
+    });
+    return program;
+}

package/dest/cli/cmds/compile.d.ts

@@ -0,0 +1,4 @@
+import type { LogFn } from '@aztec-labs/foundation/log';
+import type { Command } from 'commander';
+export declare function injectCompileCommand(program: Command, log: LogFn): Command;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tcGlsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL2NvbXBpbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFHeEQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBMEt6Qyx3QkFBZ0Isb0JBQW9CLENBQUMsT0FBTyxFQUFFLE9BQU8sRUFBRSxHQUFHLEVBQUUsS0FBSyxHQUFHLE9BQU8sQ0FzQjFFIn0=

package/dest/cli/cmds/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/compile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAGxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0KzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAsB1E"}

package/dest/cli/cmds/compile.js

@@ -0,0 +1,174 @@
+import { findBbBinary } from '@aztec/bb.js';
+import { getPackageVersion } from '@aztec-labs/stdlib/update-checker';
+import { execFileSync } from 'child_process';
+import { readFile, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { readArtifactFiles } from './utils/artifacts.js';
+import { needsRecompile } from './utils/needs_recompile.js';
+import { run } from './utils/spawn.js';
+import { warnIfAztecVersionMismatch } from './utils/warn_if_aztec_version_mismatch.js';
+/** Returns contract artifacts in the target directory along with whether each has already been postprocessed. */ async function collectContractArtifacts() {
+    let files;
+    try {
+        files = await readArtifactFiles('target');
+    } catch (err) {
+        if (err?.message?.includes('does not exist')) {
+            return [];
+        }
+        throw err;
+    }
+    return files.filter((f)=>Array.isArray(f.content.functions)).map((f)=>({
+            filePath: f.filePath,
+            transpiled: f.content.transpiled === true
+        }));
+}
+/** Stamps the Aztec stack version into the contract artifacts. */ async function stampAztecVersion(artifactPaths) {
+    const version = getPackageVersion();
+    for (const path of artifactPaths){
+        const artifact = JSON.parse(await readFile(path, 'utf-8'));
+        // eslint-disable-next-line camelcase
+        artifact.aztec_version = version;
+        await writeFile(path, JSON.stringify(artifact, null, 2) + '\n');
+    }
+}
+/** Returns the set of package names that are contract crates in the current workspace. */ async function getContractPackageNames() {
+    const contractNames = new Set();
+    let rootToml;
+    try {
+        rootToml = await readFile('Nargo.toml', 'utf-8');
+    } catch  {
+        return contractNames;
+    }
+    const membersMatch = rootToml.match(/members\s*=\s*\[([^\]]*)\]/);
+    if (membersMatch) {
+        const members = membersMatch[1].split(',').map((m)=>m.trim().replace(/^"|"$/g, '')).filter((m)=>m.length > 0);
+        for (const member of members){
+            try {
+                const memberToml = await readFile(join(member, 'Nargo.toml'), 'utf-8');
+                if (/type\s*=\s*"contract"/.test(memberToml)) {
+                    const nameMatch = memberToml.match(/name\s*=\s*"([^"]+)"/);
+                    if (nameMatch) {
+                        contractNames.add(nameMatch[1]);
+                    }
+                }
+            } catch  {
+            // Member directory might not exist or have no Nargo.toml; skip.
+            }
+        }
+    } else {
+        // Single-crate project (no workspace): check if the root Nargo.toml itself is a contract.
+        if (/type\s*=\s*"contract"/.test(rootToml)) {
+            const nameMatch = rootToml.match(/name\s*=\s*"([^"]+)"/);
+            if (nameMatch) {
+                contractNames.add(nameMatch[1]);
+            }
+        }
+    }
+    return contractNames;
+}
+/** Checks that no tests exist in contract crates and fails with a helpful message if they do. */ async function checkNoTestsInContracts(nargo, log) {
+    const contractPackages = await getContractPackageNames();
+    if (contractPackages.size === 0) {
+        return;
+    }
+    let output;
+    try {
+        // We list tests for all the crates in the workspace
+        output = execFileSync(nargo, [
+            'test',
+            '--list-tests',
+            '--silence-warnings'
+        ], {
+            encoding: 'utf-8',
+            stdio: [
+                'pipe',
+                'pipe',
+                'inherit'
+            ]
+        });
+    } catch  {
+        // If listing tests fails (e.g. test crate has compile errors), skip the check.
+        return;
+    }
+    // The output of the `nargo test --list-tests` command is as follows:
+    // ```
+    // crate_name_1 test_name_1
+    // crate_name_2 test_name_2
+    // ...
+    // crate_name_n test_name_n
+    // ```
+    //
+    // We parse the individual lines and then we check if any contract crate appeared in the parsed output.
+    const lines = output.trim().split('\n').filter((line)=>line.length > 0);
+    const testsInContracts = [];
+    for (const line of lines){
+        const spaceIndex = line.indexOf(' ');
+        if (spaceIndex === -1) {
+            continue;
+        }
+        const packageName = line.substring(0, spaceIndex);
+        const testName = line.substring(spaceIndex + 1);
+        if (contractPackages.has(packageName)) {
+            testsInContracts.push({
+                packageName,
+                testName
+            });
+        }
+    }
+    if (testsInContracts.length > 0) {
+        const details = testsInContracts.map((t)=>`  ${t.packageName}::${t.testName}`).join('\n');
+        log(`WARNING: Found tests in contract crate(s):\n${details}\n\n` + `Tests should be in a dedicated test crate, not in the contract crate.\n` + `Learn more: https://docs.aztec.network/errors/1`);
+    }
+}
+/** Compiles Aztec Noir contracts and postprocesses artifacts. */ async function compileAztecContract(nargoArgs, log) {
+    await warnIfAztecVersionMismatch(log);
+    const nargo = process.env.NARGO ?? 'nargo';
+    const bb = process.env.BB ?? findBbBinary() ?? 'bb';
+    const shouldRecompile = await needsRecompile();
+    if (shouldRecompile) {
+        await run(nargo, [
+            'compile',
+            ...nargoArgs
+        ]);
+        // Ensure contract crates contain no tests (tests belong in the test crate).
+        await checkNoTestsInContracts(nargo, log);
+    }
+    // Postprocess any untranspiled artifacts: those just produced by nargo above, and any left behind by a bare
+    // `nargo compile` run outside `aztec compile`.
+    const unprocessed = (await collectContractArtifacts()).filter((a)=>!a.transpiled).map((a)=>a.filePath);
+    if (unprocessed.length > 0) {
+        log('Postprocessing contracts...');
+        const bbArgs = unprocessed.flatMap((a)=>[
+                '-i',
+                a
+            ]);
+        await run(bb, [
+            'aztec_process',
+            ...bbArgs
+        ]);
+        await stampAztecVersion(unprocessed);
+    }
+    if (shouldRecompile || unprocessed.length > 0) {
+        log('Compilation complete!');
+    } else {
+        log('No source changes detected, skipping compilation.');
+    }
+}
+export function injectCompileCommand(program, log) {
+    program.command('compile').argument('[nargo-args...]').passThroughOptions().allowUnknownOption().description('Compile Aztec Noir contracts using nargo and postprocess them to generate transpiled artifacts and verification keys. All options are forwarded to nargo compile.').addHelpText('after', ()=>{
+        // Show nargo's own compile options so users see all available flags in one place.
+        const nargo = process.env.NARGO ?? 'nargo';
+        try {
+            const output = execFileSync(nargo, [
+                'compile',
+                '--help'
+            ], {
+                encoding: 'utf-8'
+            });
+            return `\nUnderlying nargo compile options:\n\n${output}`;
+        } catch  {
+            return '\n(Run "nargo compile --help" to see available nargo options)';
+        }
+    }).action((nargoArgs)=>compileAztecContract(nargoArgs, log));
+    return program;
+}

package/dest/cli/cmds/migrate_ha_db.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function injectMigrateCommand(program: Command, log: (msg: string) => void): Command;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWlncmF0ZV9oYV9kYi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL21pZ3JhdGVfaGFfZGIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRXpDLHdCQUFnQixvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsT0FBTyxFQUFFLEdBQUcsRUFBRSxDQUFDLEdBQUcsRUFBRSxNQUFNLEtBQUssSUFBSSxHQUFHLE9BQU8sQ0FzQzFGIn0=

package/dest/cli/cmds/migrate_ha_db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate_ha_db.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/migrate_ha_db.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAsC1F"}

package/dest/cli/cmds/migrate_ha_db.js

@@ -0,0 +1,27 @@
+import { runMigrations } from '@aztec-labs/validator-ha-signer/migrations';
+export function injectMigrateCommand(program, log) {
+    const migrateCommand = program.command('migrate-ha-db').description('Run validator-ha-signer database migrations');
+    migrateCommand.command('up').description('Apply pending migrations').requiredOption('--database-url <string>', 'PostgreSQL connection string', process.env.DATABASE_URL).option('--verbose', 'Enable verbose output', false).action(async (options)=>{
+        const migrations = await runMigrations(options.databaseUrl, {
+            direction: 'up',
+            verbose: options.verbose
+        });
+        if (migrations.length > 0) {
+            log(`Applied migrations: ${migrations.join(', ')}`);
+        } else {
+            log('No migrations to apply - schema is up to date');
+        }
+    });
+    migrateCommand.command('down').description('Rollback the last migration').requiredOption('--database-url <string>', 'PostgreSQL connection string', process.env.DATABASE_URL).option('--verbose', 'Enable verbose output', false).action(async (options)=>{
+        const migrations = await runMigrations(options.databaseUrl, {
+            direction: 'down',
+            verbose: options.verbose
+        });
+        if (migrations.length > 0) {
+            log(`Rolled back migrations: ${migrations.join(', ')}`);
+        } else {
+            log('No migrations to rollback');
+        }
+    });
+    return program;
+}

package/dest/cli/cmds/profile.d.ts

@@ -0,0 +1,4 @@
+import type { LogFn } from '@aztec-labs/foundation/log';
+import type { Command } from 'commander';
+export declare function injectProfileCommand(program: Command, log: LogFn): Command;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3Byb2ZpbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDeEQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBS3pDLHdCQUFnQixvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsT0FBTyxFQUFFLEdBQUcsRUFBRSxLQUFLLEdBQUcsT0FBTyxDQWtCMUUifQ==

package/dest/cli/cmds/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAkB1E"}

package/dest/cli/cmds/profile.js

@@ -0,0 +1,8 @@
+import { profileFlamegraph } from './profile_flamegraph.js';
+import { profileGates } from './profile_gates.js';
+export function injectProfileCommand(program, log) {
+    const profile = program.command('profile').description('Profile compiled Aztec artifacts.');
+    profile.command('gates').argument('[target-dir]', 'Path to the compiled artifacts directory', './target').option('--json', 'Output gate counts as JSON instead of a table', false).description('Display gate counts for all compiled Aztec artifacts in a target directory.').action((targetDir, options)=>profileGates(targetDir, options.json, log));
+    profile.command('flamegraph').argument('<contract-artifact>', 'Path to the compiled contract artifact JSON').argument('<function>', 'Name of the contract function to profile').description('Generate a gate count flamegraph SVG for a contract function.').action((artifactPath, functionName)=>profileFlamegraph(artifactPath, functionName, log));
+    return program;
+}

package/dest/cli/cmds/profile_flamegraph.d.ts

@@ -0,0 +1,4 @@
+import type { LogFn } from '@aztec-labs/foundation/log';
+/** Generates a gate count flamegraph SVG for a single contract function. */
+export declare function profileFlamegraph(artifactPath: string, functionName: string, log: LogFn): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZV9mbGFtZWdyYXBoLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY2xpL2NtZHMvcHJvZmlsZV9mbGFtZWdyYXBoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBUXhELDRFQUE0RTtBQUM1RSx3QkFBc0IsaUJBQWlCLENBQUMsWUFBWSxFQUFFLE1BQU0sRUFBRSxZQUFZLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxLQUFLLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQW9EN0cifQ==

package/dest/cli/cmds/profile_flamegraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_flamegraph.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/profile_flamegraph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAQxD,4EAA4E;AAC5E,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD7G"}

package/dest/cli/cmds/profile_flamegraph.js

@@ -0,0 +1,52 @@
+import { findBbBinary } from '@aztec/bb.js';
+import { readFile, rename, rm, writeFile } from 'fs/promises';
+import { basename, dirname, join } from 'path';
+import { makeFunctionArtifact } from './profile_utils.js';
+import { run } from './utils/spawn.js';
+/** Generates a gate count flamegraph SVG for a single contract function. */ export async function profileFlamegraph(artifactPath, functionName, log) {
+    const raw = await readFile(artifactPath, 'utf-8');
+    const artifact = JSON.parse(raw);
+    if (!Array.isArray(artifact.functions)) {
+        throw new Error(`${artifactPath} does not appear to be a contract artifact (no functions array)`);
+    }
+    const func = artifact.functions.find((f)=>f.name === functionName);
+    if (!func) {
+        const available = artifact.functions.map((f)=>f.name).join(', ');
+        throw new Error(`Function "${functionName}" not found in artifact. Available: ${available}`);
+    }
+    if (func.is_unconstrained) {
+        throw new Error(`Function "${functionName}" is unconstrained and cannot be profiled`);
+    }
+    const outputDir = dirname(artifactPath);
+    const contractName = basename(artifactPath, '.json');
+    const functionArtifact = join(outputDir, `${contractName}-${functionName}.json`);
+    try {
+        await writeFile(functionArtifact, makeFunctionArtifact(artifact, func));
+        const profiler = process.env.PROFILER_PATH ?? 'noir-profiler';
+        const bb = process.env.BB ?? findBbBinary() ?? 'bb';
+        await run(profiler, [
+            'gates',
+            '--artifact-path',
+            functionArtifact,
+            '--backend-path',
+            bb,
+            '--backend-gates-command',
+            'gates',
+            '--output',
+            outputDir,
+            '--scheme',
+            'chonk',
+            '--include_gates_per_opcode'
+        ]);
+        // noir-profiler names the SVG using the internal function name which
+        // retains the __aztec_nr_internals__ prefix in the bytecode metadata.
+        const srcSvg = join(outputDir, `__aztec_nr_internals__${functionName}_gates.svg`);
+        const destSvg = join(outputDir, `${contractName}-${functionName}-flamegraph.svg`);
+        await rename(srcSvg, destSvg);
+        log(`Flamegraph written to ${destSvg}`);
+    } finally{
+        await rm(functionArtifact, {
+            force: true
+        });
+    }
+}

package/dest/cli/cmds/profile_gates.d.ts

@@ -0,0 +1,4 @@
+import type { LogFn } from '@aztec-labs/foundation/log';
+/** Profiles all compiled artifacts in a target directory and prints gate counts. */
+export declare function profileGates(targetDir: string, json: boolean, log: LogFn): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZV9nYXRlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3Byb2ZpbGVfZ2F0ZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUErQnhELG9GQUFvRjtBQUNwRix3QkFBc0IsWUFBWSxDQUFDLFNBQVMsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxHQUFHLEVBQUUsS0FBSyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FnRDlGIn0=

package/dest/cli/cmds/profile_gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_gates.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/profile_gates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AA+BxD,oFAAoF;AACpF,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAgD9F"}