@aztec/aztec 0.0.1-commit.24de95ac → 0.0.1-commit.2606882

package/dest/cli/cli.d.ts

@@ -6,4 +6,4 @@ import { Command } from 'commander';
  * @param debugLogger - logger for logging debug messages.
  */
 export declare function injectAztecCommands(program: Command, userLog: LogFn, debugLogger: Logger): Command;
-//# sourceMappingURL=cli.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFM0QsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUtwQzs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0EyQ2xHIn0=

package/dest/cli/cli.js

@@ -20,15 +20,15 @@ import { addOptions, printAztecStartHelpText } from './util.js';
     program.configureHelp({
         sortSubcommands: true
     });
-    program.addHelpText('after', `
+    if (process.env.AZTEC_SHELL_WRAPPER) {
+        program.addHelpText('after', `
+Additional commands:
 
-  Additional commands:
-
-    test [options]: starts a dockerized TXE node via
-      $ aztec start --txe
-    then runs
-      $ aztec-nargo test --silence-warnings --oracle-resolver=<TXE_ADDRESS> [options]
+  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);

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

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

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":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoKzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAsB1E"}

package/dest/cli/cmds/compile.js

@@ -0,0 +1,166 @@
+import { findBbBinary } from '@aztec/bb.js';
+import { getPackageVersion } from '@aztec/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 paths to contract artifacts in the target directory. */ 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)=>f.filePath);
+}
+/** 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);
+    if (!await needsRecompile()) {
+        log('No source changes detected, skipping compilation.');
+        return;
+    }
+    const nargo = process.env.NARGO ?? 'nargo';
+    const bb = process.env.BB ?? findBbBinary() ?? 'bb';
+    await run(nargo, [
+        'compile',
+        ...nargoArgs
+    ]);
+    // Ensure contract crates contain no tests (tests belong in the test crate).
+    await checkNoTestsInContracts(nargo, log);
+    const artifacts = await collectContractArtifacts();
+    if (artifacts.length > 0) {
+        log('Postprocessing contracts...');
+        const bbArgs = artifacts.flatMap((a)=>[
+                '-i',
+                a
+            ]);
+        await run(bb, [
+            'aztec_process',
+            ...bbArgs
+        ]);
+        await stampAztecVersion(artifacts);
+    }
+    log('Compilation complete!');
+}
+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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWlncmF0ZV9oYV9kYi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL21pZ3JhdGVfaGFfZGIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRXpDLHdCQUFnQixvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsT0FBTyxFQUFFLEdBQUcsRUFBRSxDQUFDLEdBQUcsRUFBRSxNQUFNLEtBQUssSUFBSSxHQUFHLE9BQU8sQ0FzQzFGIn0=

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":"AAEA,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/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/foundation/log';
+import type { Command } from 'commander';
+export declare function injectProfileCommand(program: Command, log: LogFn): Command;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3Byb2ZpbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFbkQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBS3pDLHdCQUFnQixvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsT0FBTyxFQUFFLEdBQUcsRUFBRSxLQUFLLEdBQUcsT0FBTyxDQWtCMUUifQ==

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,uBAAuB,CAAC;AAEnD,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/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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZV9mbGFtZWdyYXBoLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY2xpL2NtZHMvcHJvZmlsZV9mbGFtZWdyYXBoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBU25ELDRFQUE0RTtBQUM1RSx3QkFBc0IsaUJBQWlCLENBQUMsWUFBWSxFQUFFLE1BQU0sRUFBRSxZQUFZLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxLQUFLLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQW9EN0cifQ==

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":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AASnD,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/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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZV9nYXRlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3Byb2ZpbGVfZ2F0ZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFnQ25ELG9GQUFvRjtBQUNwRix3QkFBc0IsWUFBWSxDQUFDLFNBQVMsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxHQUFHLEVBQUUsS0FBSyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FnRDlGIn0=

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":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAgCnD,oFAAoF;AACpF,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAgD9F"}

package/dest/cli/cmds/profile_gates.js

@@ -0,0 +1,76 @@
+import { findBbBinary } from '@aztec/bb.js';
+import { asyncPool } from '@aztec/foundation/async-pool';
+import { execFile as execFileCb } from 'child_process';
+import { rm } from 'fs/promises';
+import { promisify } from 'util';
+import { MAX_CONCURRENT, discoverArtifacts } from './profile_utils.js';
+const execFile = promisify(execFileCb);
+/** Parses circuit_size from bb gates JSON output: { "functions": [{ "circuit_size": N }] } */ function parseGateCount(stdout) {
+    const parsed = JSON.parse(stdout);
+    const size = parsed?.functions?.[0]?.circuit_size;
+    if (typeof size !== 'number') {
+        throw new Error('Failed to parse circuit_size from bb gates output');
+    }
+    return size;
+}
+/** Runs bb gates on a single artifact file and returns the gate count. */ async function getGateCount(bb, artifactPath) {
+    const { stdout } = await execFile(bb, [
+        'gates',
+        '--scheme',
+        'chonk',
+        '-b',
+        artifactPath
+    ]);
+    return parseGateCount(stdout);
+}
+/** Profiles all compiled artifacts in a target directory and prints gate counts. */ export async function profileGates(targetDir, json, log) {
+    const bb = process.env.BB ?? findBbBinary() ?? 'bb';
+    const { artifacts, tmpDir } = await discoverArtifacts(targetDir);
+    if (artifacts.length === 0) {
+        if (json) {
+            log('[]');
+        } else {
+            log('No artifacts found in target directory.');
+        }
+        return;
+    }
+    try {
+        const results = await asyncPool(MAX_CONCURRENT, artifacts, async (artifact)=>({
+                name: artifact.name,
+                type: artifact.type,
+                gateCount: await getGateCount(bb, artifact.filePath)
+            }));
+        results.sort((a, b)=>a.name.localeCompare(b.name));
+        if (results.length === 0) {
+            if (json) {
+                log('[]');
+            } else {
+                log('No constrained circuits found.');
+            }
+            return;
+        }
+        if (json) {
+            const entries = results.map((r)=>({
+                    name: r.name,
+                    type: r.type,
+                    gates: r.gateCount
+                }));
+            log(JSON.stringify(entries, null, 2));
+            return;
+        }
+        const maxNameLen = Math.max(...results.map((r)=>r.name.length));
+        log('');
+        log('Gate counts:');
+        log('-'.repeat(maxNameLen + 16));
+        for (const { name, gateCount } of results){
+            log(`${name.padEnd(maxNameLen)}  ${gateCount.toLocaleString().padStart(12)}`);
+        }
+        log('-'.repeat(maxNameLen + 16));
+        log(`Total: ${results.length} circuit(s)`);
+    } finally{
+        await rm(tmpDir, {
+            recursive: true,
+            force: true
+        });
+    }
+}

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

@@ -0,0 +1,18 @@
+import type { CompiledArtifact, ContractFunction } from './utils/artifacts.js';
+export declare const MAX_CONCURRENT = 4;
+export interface DiscoveredArtifact {
+    name: string;
+    filePath: string;
+    type: 'contract-function' | 'program';
+}
+/**
+ * Reads a target directory and returns a list of discovered artifacts with temp files
+ * created for contract functions. Caller must clean up tmpDir when done.
+ */
+export declare function discoverArtifacts(targetDir: string): Promise<{
+    artifacts: DiscoveredArtifact[];
+    tmpDir: string;
+}>;
+/** Extracts a contract function as a standalone program artifact JSON string. */
+export declare function makeFunctionArtifact(artifact: CompiledArtifact, func: ContractFunction): string;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZV91dGlscy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3Byb2ZpbGVfdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUEsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUcvRSxlQUFPLE1BQU0sY0FBYyxJQUFJLENBQUM7QUFFaEMsTUFBTSxXQUFXLGtCQUFrQjtJQUNqQyxJQUFJLEVBQUUsTUFBTSxDQUFDO0lBQ2IsUUFBUSxFQUFFLE1BQU0sQ0FBQztJQUNqQixJQUFJLEVBQUUsbUJBQW1CLEdBQUcsU0FBUyxDQUFDO0NBQ3ZDO0FBRUQ7OztHQUdHO0FBQ0gsd0JBQXNCLGlCQUFpQixDQUNyQyxTQUFTLEVBQUUsTUFBTSxHQUNoQixPQUFPLENBQUM7SUFBRSxTQUFTLEVBQUUsa0JBQWtCLEVBQUUsQ0FBQztJQUFDLE1BQU0sRUFBRSxNQUFNLENBQUE7Q0FBRSxDQUFDLENBc0I5RDtBQUVELGlGQUFpRjtBQUNqRix3QkFBZ0Isb0JBQW9CLENBQUMsUUFBUSxFQUFFLGdCQUFnQixFQUFFLElBQUksRUFBRSxnQkFBZ0IsVUFXdEYifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_utils.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/profile_utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB9D;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,UAWtF"}

package/dest/cli/cmds/profile_utils.js

@@ -0,0 +1,50 @@
+import { mkdtemp, writeFile } from 'fs/promises';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { readArtifactFiles } from './utils/artifacts.js';
+export const MAX_CONCURRENT = 4;
+/**
+ * Reads a target directory and returns a list of discovered artifacts with temp files
+ * created for contract functions. Caller must clean up tmpDir when done.
+ */ export async function discoverArtifacts(targetDir) {
+    const files = await readArtifactFiles(targetDir);
+    const tmpDir = await mkdtemp(join(tmpdir(), 'aztec-profile-'));
+    const artifacts = [];
+    for (const file of files){
+        if (Array.isArray(file.content.functions)) {
+            for (const func of file.content.functions){
+                if (!func.bytecode || func.is_unconstrained) {
+                    continue;
+                }
+                const name = `${file.name}::${func.name}`;
+                const tmpPath = join(tmpDir, `${file.name}-${func.name}.json`);
+                await writeFile(tmpPath, makeFunctionArtifact(file.content, func));
+                artifacts.push({
+                    name,
+                    filePath: tmpPath,
+                    type: 'contract-function'
+                });
+            }
+        } else if (file.content.bytecode) {
+            artifacts.push({
+                name: file.name,
+                filePath: file.filePath,
+                type: 'program'
+            });
+        }
+    }
+    return {
+        artifacts,
+        tmpDir
+    };
+}
+/** Extracts a contract function as a standalone program artifact JSON string. */ export function makeFunctionArtifact(artifact, func) {
+    /* eslint-disable camelcase */ return JSON.stringify({
+        noir_version: artifact.noir_version,
+        hash: 0,
+        abi: func.abi,
+        bytecode: func.bytecode,
+        debug_symbols: func.debug_symbols,
+        file_map: artifact.file_map
+    });
+/* eslint-enable camelcase */ }

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

@@ -0,0 +1,30 @@
+import type { Fr } from '@aztec/aztec.js/fields';
+import type { GenesisStateConfig } from '@aztec/ethereum/config';
+import type { EthAddress } from '@aztec/foundation/eth-address';
+import type { LogFn } from '@aztec/foundation/log';
+/**
+ * Computes the expected genesis archive root from the genesis state config.
+ * Reads test accounts and sponsored FPC addresses as specified, then computes
+ * the genesis values including the archive root and prefilled public data.
+ */
+export declare function computeExpectedGenesisRoot(config: GenesisStateConfig, userLog: LogFn): Promise<{
+    genesisArchiveRoot: Fr;
+    genesis: import("@aztec/stdlib/world-state").GenesisData;
+}>;
+/**
+ * Waits until the canonical rollup's genesis archive root, VK tree root, and protocol contracts hash
+ * all match the expected local values. If the rollup is not yet compatible (e.g. during L1 contract upgrades),
+ * enters standby mode: starts a lightweight HTTP server for K8s liveness probes and polls every 60s
+ * until a compatible rollup appears.
+ */
+export declare function waitForCompatibleRollup(config: {
+    l1RpcUrls: string[];
+    l1ChainId: number;
+    registryAddress: EthAddress;
+    rollupVersion?: number;
+}, expected: {
+    genesisArchiveRoot: Fr;
+    vkTreeRoot: Fr;
+    protocolContractsHash: Fr;
+}, port: number | undefined, userLog: LogFn): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhbmRieS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3N0YW5kYnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFHakQsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUVqRSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUVoRSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQVNuRDs7OztHQUlHO0FBQ0gsd0JBQXNCLDBCQUEwQixDQUFDLE1BQU0sRUFBRSxrQkFBa0IsRUFBRSxPQUFPLEVBQUUsS0FBSzs7O0dBYTFGO0FBd0JEOzs7OztHQUtHO0FBQ0gsd0JBQXNCLHVCQUF1QixDQUMzQyxNQUFNLEVBQUU7SUFDTixTQUFTLEVBQUUsTUFBTSxFQUFFLENBQUM7SUFDcEIsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixlQUFlLEVBQUUsVUFBVSxDQUFDO0lBQzVCLGFBQWEsQ0FBQyxFQUFFLE1BQU0sQ0FBQztDQUN4QixFQUNELFFBQVEsRUFBRTtJQUFFLGtCQUFrQixFQUFFLEVBQUUsQ0FBQztJQUFDLFVBQVUsRUFBRSxFQUFFLENBQUM7SUFBQyxxQkFBcUIsRUFBRSxFQUFFLENBQUE7Q0FBRSxFQUMvRSxJQUFJLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFDeEIsT0FBTyxFQUFFLEtBQUssR0FDYixPQUFPLENBQUMsSUFBSSxDQUFDLENBd0RmIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"standby.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/standby.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAGjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AASnD;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK;;;GAa1F;AAwBD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,UAAU,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,EACD,QAAQ,EAAE;IAAE,kBAAkB,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,EAAE,CAAC;IAAC,qBAAqB,EAAE,EAAE,CAAA;CAAE,EAC/E,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,KAAK,GACb,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dest/cli/cmds/standby.js

@@ -0,0 +1,97 @@
+import { getInitialTestAccountsData } from '@aztec/accounts/testing';
+import { getSponsoredFPCAddress } from '@aztec/cli/cli-utils';
+import { getPublicClient } from '@aztec/ethereum/client';
+import { RegistryContract, RollupContract } from '@aztec/ethereum/contracts';
+import { startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
+import { retryUntil } from '@aztec/foundation/retry';
+import { AztecAddress } from '@aztec/stdlib/aztec-address';
+import { getGenesisValues } from '@aztec/world-state/testing';
+import Koa from 'koa';
+const ROLLUP_POLL_INTERVAL_S = 60;
+/**
+ * Computes the expected genesis archive root from the genesis state config.
+ * Reads test accounts and sponsored FPC addresses as specified, then computes
+ * the genesis values including the archive root and prefilled public data.
+ */ export async function computeExpectedGenesisRoot(config, userLog) {
+    const testAccounts = config.testAccounts ? (await getInitialTestAccountsData()).map((a)=>a.address) : [];
+    const sponsoredFPCAccounts = config.sponsoredFPC ? [
+        await getSponsoredFPCAddress()
+    ] : [];
+    const prefundAddresses = (config.prefundAddresses ?? []).map((a)=>AztecAddress.fromString(a));
+    const initialFundedAccounts = testAccounts.concat(sponsoredFPCAccounts).concat(prefundAddresses);
+    userLog(`Initial funded accounts: ${initialFundedAccounts.map((a)=>a.toString()).join(', ')}`);
+    const { genesisArchiveRoot, genesis } = await getGenesisValues(initialFundedAccounts);
+    userLog(`Genesis archive root: ${genesisArchiveRoot.toString()}`);
+    return {
+        genesisArchiveRoot,
+        genesis
+    };
+}
+async function checkRollupCompatibility(rollup, expected) {
+    const mismatches = [];
+    const [l1Genesis, l1Vk, l1Protocol] = await Promise.all([
+        rollup.getGenesisArchiveTreeRoot(),
+        rollup.getVkTreeRoot(),
+        rollup.getProtocolContractsHash()
+    ]);
+    if (!l1Genesis.equals(expected.genesisArchiveRoot)) {
+        mismatches.push(`genesis archive root (expected ${expected.genesisArchiveRoot}, got ${l1Genesis})`);
+    }
+    if (!l1Vk.equals(expected.vkTreeRoot)) {
+        mismatches.push(`VK tree root (expected ${expected.vkTreeRoot}, got ${l1Vk})`);
+    }
+    if (!l1Protocol.equals(expected.protocolContractsHash)) {
+        mismatches.push(`protocol contracts hash (expected ${expected.protocolContractsHash}, got ${l1Protocol})`);
+    }
+    return mismatches;
+}
+/**
+ * Waits until the canonical rollup's genesis archive root, VK tree root, and protocol contracts hash
+ * all match the expected local values. If the rollup is not yet compatible (e.g. during L1 contract upgrades),
+ * enters standby mode: starts a lightweight HTTP server for K8s liveness probes and polls every 60s
+ * until a compatible rollup appears.
+ */ export async function waitForCompatibleRollup(config, expected, port, userLog) {
+    const publicClient = getPublicClient(config);
+    const rollupVersion = config.rollupVersion ?? 'canonical';
+    const registry = new RegistryContract(publicClient, config.registryAddress);
+    const rollupAddress = await registry.getRollupAddress(rollupVersion);
+    const rollup = new RollupContract(publicClient, rollupAddress.toString());
+    let mismatches;
+    try {
+        mismatches = await checkRollupCompatibility(rollup, expected);
+    } catch (err) {
+        throw new Error(`Could not retrieve rollup config from canonical rollup at ${rollupAddress}: ${err.message}`);
+    }
+    if (mismatches.length === 0) {
+        return;
+    }
+    userLog(`Rollup at ${rollupAddress} is incompatible: ${mismatches.join('; ')}. ` + `Entering standby mode. Will poll every ${ROLLUP_POLL_INTERVAL_S}s for a compatible rollup...`);
+    const standbyServer = await startHttpRpcServer({
+        getApp: ()=>new Koa(),
+        isHealthy: ()=>true
+    }, {
+        port
+    });
+    userLog(`Standby status server listening on port ${standbyServer.port}`);
+    try {
+        await retryUntil(async ()=>{
+            const currentRollupAddress = await registry.getRollupAddress(rollupVersion);
+            const currentRollup = new RollupContract(publicClient, currentRollupAddress.toString());
+            let currentMismatches;
+            try {
+                currentMismatches = await checkRollupCompatibility(currentRollup, expected);
+            } catch  {
+                userLog(`Failed to fetch rollup config from rollup at ${currentRollupAddress}. Retrying...`);
+                return undefined;
+            }
+            if (currentMismatches.length === 0) {
+                userLog(`Compatible rollup found at ${currentRollupAddress}. Exiting standby mode.`);
+                return true;
+            }
+            userLog(`Still waiting. Rollup at ${currentRollupAddress}: ${currentMismatches.join('; ')}.`);
+            return undefined;
+        }, 'compatible rollup', 0, ROLLUP_POLL_INTERVAL_S);
+    } finally{
+        await new Promise((resolve, reject)=>standbyServer.close((err)=>err ? reject(err) : resolve()));
+    }
+}

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

@@ -2,7 +2,7 @@ import type { NamespacedApiHandlers } from '@aztec/foundation/json-rpc/server';
 import type { LogFn } from '@aztec/foundation/log';
 import { type AztecNode, type AztecNodeAdmin } from '@aztec/stdlib/interfaces/client';
 import type { TelemetryClient } from '@aztec/telemetry-client';
-import { TestWallet } from '@aztec/test-wallet/server';
+import { EmbeddedWallet } from '@aztec/wallets/embedded';
 export declare function startBot(options: any, signalHandlers: (() => Promise<void>)[], services: NamespacedApiHandlers, userLog: LogFn): Promise<void>;
-export declare function addBot(options: any, signalHandlers: (() => Promise<void>)[], services: NamespacedApiHandlers, wallet: TestWallet, aztecNode: AztecNode, telemetry: TelemetryClient, aztecNodeAdmin?: AztecNodeAdmin): Promise<void>;
-//# sourceMappingURL=start_bot.d.ts.map
+export declare function addBot(options: any, signalHandlers: (() => Promise<void>)[], services: NamespacedApiHandlers, wallet: EmbeddedWallet, aztecNode: AztecNode, telemetry: TelemetryClient, aztecNodeAdmin?: AztecNodeAdmin, userLog?: LogFn): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhcnRfYm90LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY2xpL2NtZHMvc3RhcnRfYm90LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFDL0UsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFHbkQsT0FBTyxFQUFFLEtBQUssU0FBUyxFQUFFLEtBQUssY0FBYyxFQUF5QixNQUFNLGlDQUFpQyxDQUFDO0FBQzdHLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBTS9ELE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUt6RCx3QkFBc0IsUUFBUSxDQUM1QixPQUFPLEVBQUUsR0FBRyxFQUNaLGNBQWMsRUFBRSxDQUFDLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsRUFDdkMsUUFBUSxFQUFFLHFCQUFxQixFQUMvQixPQUFPLEVBQUUsS0FBSyxpQkFzQmY7QUFFRCx3QkFBc0IsTUFBTSxDQUMxQixPQUFPLEVBQUUsR0FBRyxFQUNaLGNBQWMsRUFBRSxDQUFDLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsRUFDdkMsUUFBUSxFQUFFLHFCQUFxQixFQUMvQixNQUFNLEVBQUUsY0FBYyxFQUN0QixTQUFTLEVBQUUsU0FBUyxFQUNwQixTQUFTLEVBQUUsZUFBZSxFQUMxQixjQUFjLENBQUMsRUFBRSxjQUFjLEVBQy9CLE9BQU8sQ0FBQyxFQUFFLEtBQUssaUJBbUJoQiJ9