@aztec/aztec 4.0.0-nightly.20260111 → 4.0.0-nightly.20260113

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=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFM0QsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUtwQzs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0F3RmxHIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFM0QsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUtwQzs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0E0RWxHIn0=

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

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,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,CAwFlG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,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,CA4ElG"}

package/dest/cli/cli.js

@@ -20,7 +20,8 @@ import { addOptions, printAztecStartHelpText } from './util.js';
     program.configureHelp({
         sortSubcommands: true
     });
-    program.addHelpText('after', `
+    if (process.env.AZTEC_SHELL_WRAPPER) {
+        program.addHelpText('after', `
 
   Additional commands:
 
@@ -51,29 +52,16 @@ import { addOptions, printAztecStartHelpText } from './util.js';
       The compiled contracts will be placed in the target/ directory by default.
       Supports standard nargo compile options.
 
-    fmt [options]: formats Noir code using nargo fmt
-      Example:
-        $ aztec fmt                     # formats all Noir files in the project
-
-    check [options]: type-checks Noir code without compiling using nargo check
-      Example:
-        $ aztec check                   # checks all Noir files in the project
-
     test [options]: starts a dockerized TXE node via
       $ aztec start --txe
     then runs
       $ aztec test --silence-warnings --oracle-resolver=<TXE_ADDRESS> [options]
 
-    lsp: starts the Nargo Language Server Protocol server
-      Runs nargo lsp in a Docker container for IDE integration with Noir.
-      This command is typically used by IDE extensions and not called directly by users.
-      Example:
-        $ aztec lsp                     # starts the LSP server
-
     preload-crs: Downloads and caches the Common Reference String (CRS) data required for zero-knowledge proofs.
       Example:
         $ aztec preload-crs             # preloads CRS data
     `);
+    }
     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/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@aztec/aztec",
-  "version": "4.0.0-nightly.20260111",
+  "version": "4.0.0-nightly.20260113",
   "type": "module",
   "exports": {
     ".": "./dest/index.js",
     "./testing": "./dest/testing/index.js"
   },
-  "bin": "./dest/bin/index.js",
+  "bin": "./scripts/aztec.sh",
   "typedocOptions": {
     "entryPoints": [
       "./src/index.ts"
@@ -28,39 +28,39 @@
     "../package.common.json"
   ],
   "dependencies": {
-    "@aztec/accounts": "4.0.0-nightly.20260111",
-    "@aztec/archiver": "4.0.0-nightly.20260111",
-    "@aztec/aztec-faucet": "4.0.0-nightly.20260111",
-    "@aztec/aztec-node": "4.0.0-nightly.20260111",
-    "@aztec/aztec.js": "4.0.0-nightly.20260111",
-    "@aztec/bb-prover": "4.0.0-nightly.20260111",
-    "@aztec/bb.js": "4.0.0-nightly.20260111",
-    "@aztec/blob-client": "4.0.0-nightly.20260111",
-    "@aztec/bot": "4.0.0-nightly.20260111",
-    "@aztec/builder": "4.0.0-nightly.20260111",
-    "@aztec/cli": "4.0.0-nightly.20260111",
-    "@aztec/constants": "4.0.0-nightly.20260111",
-    "@aztec/entrypoints": "4.0.0-nightly.20260111",
-    "@aztec/ethereum": "4.0.0-nightly.20260111",
-    "@aztec/foundation": "4.0.0-nightly.20260111",
-    "@aztec/kv-store": "4.0.0-nightly.20260111",
-    "@aztec/l1-artifacts": "4.0.0-nightly.20260111",
-    "@aztec/node-lib": "4.0.0-nightly.20260111",
-    "@aztec/noir-contracts.js": "4.0.0-nightly.20260111",
-    "@aztec/noir-protocol-circuits-types": "4.0.0-nightly.20260111",
-    "@aztec/p2p": "4.0.0-nightly.20260111",
-    "@aztec/p2p-bootstrap": "4.0.0-nightly.20260111",
-    "@aztec/protocol-contracts": "4.0.0-nightly.20260111",
-    "@aztec/prover-client": "4.0.0-nightly.20260111",
-    "@aztec/prover-node": "4.0.0-nightly.20260111",
-    "@aztec/pxe": "4.0.0-nightly.20260111",
-    "@aztec/sequencer-client": "4.0.0-nightly.20260111",
-    "@aztec/stdlib": "4.0.0-nightly.20260111",
-    "@aztec/telemetry-client": "4.0.0-nightly.20260111",
-    "@aztec/test-wallet": "4.0.0-nightly.20260111",
-    "@aztec/txe": "4.0.0-nightly.20260111",
-    "@aztec/validator-ha-signer": "4.0.0-nightly.20260111",
-    "@aztec/world-state": "4.0.0-nightly.20260111",
+    "@aztec/accounts": "4.0.0-nightly.20260113",
+    "@aztec/archiver": "4.0.0-nightly.20260113",
+    "@aztec/aztec-faucet": "4.0.0-nightly.20260113",
+    "@aztec/aztec-node": "4.0.0-nightly.20260113",
+    "@aztec/aztec.js": "4.0.0-nightly.20260113",
+    "@aztec/bb-prover": "4.0.0-nightly.20260113",
+    "@aztec/bb.js": "4.0.0-nightly.20260113",
+    "@aztec/blob-client": "4.0.0-nightly.20260113",
+    "@aztec/bot": "4.0.0-nightly.20260113",
+    "@aztec/builder": "4.0.0-nightly.20260113",
+    "@aztec/cli": "4.0.0-nightly.20260113",
+    "@aztec/constants": "4.0.0-nightly.20260113",
+    "@aztec/entrypoints": "4.0.0-nightly.20260113",
+    "@aztec/ethereum": "4.0.0-nightly.20260113",
+    "@aztec/foundation": "4.0.0-nightly.20260113",
+    "@aztec/kv-store": "4.0.0-nightly.20260113",
+    "@aztec/l1-artifacts": "4.0.0-nightly.20260113",
+    "@aztec/node-lib": "4.0.0-nightly.20260113",
+    "@aztec/noir-contracts.js": "4.0.0-nightly.20260113",
+    "@aztec/noir-protocol-circuits-types": "4.0.0-nightly.20260113",
+    "@aztec/p2p": "4.0.0-nightly.20260113",
+    "@aztec/p2p-bootstrap": "4.0.0-nightly.20260113",
+    "@aztec/protocol-contracts": "4.0.0-nightly.20260113",
+    "@aztec/prover-client": "4.0.0-nightly.20260113",
+    "@aztec/prover-node": "4.0.0-nightly.20260113",
+    "@aztec/pxe": "4.0.0-nightly.20260113",
+    "@aztec/sequencer-client": "4.0.0-nightly.20260113",
+    "@aztec/stdlib": "4.0.0-nightly.20260113",
+    "@aztec/telemetry-client": "4.0.0-nightly.20260113",
+    "@aztec/test-wallet": "4.0.0-nightly.20260113",
+    "@aztec/txe": "4.0.0-nightly.20260113",
+    "@aztec/validator-ha-signer": "4.0.0-nightly.20260113",
+    "@aztec/world-state": "4.0.0-nightly.20260113",
     "@types/chalk": "^2.2.0",
     "abitype": "^0.8.11",
     "chalk": "^5.3.0",
@@ -71,6 +71,7 @@
   },
   "files": [
     "dest",
+    "scripts",
     "src",
     "!*.test.*"
   ],

package/scripts/aztec.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(dirname "$(realpath "$0")")"
+
+function aztec {
+  exec node --no-warnings $script_dir/../dest/bin/index.js "$@"
+}
+
+cmd=${1:-}
+[ -n "$cmd" ] && shift
+
+export AZTEC_SHELL_WRAPPER=1
+
+case $cmd in
+  test)
+    export LOG_LEVEL="${LOG_LEVEL:-info}"
+    aztec start --txe --port 8081 &
+    server_pid=$!
+    trap 'kill $server_pid &>/dev/null || true' EXIT
+    while ! nc -z 127.0.0.1 8081 &>/dev/null; do sleep 0.2; done
+    export NARGO_FOREIGN_CALL_TIMEOUT=300000
+    nargo test --silence-warnings --pedantic-solving --oracle-resolver http://127.0.0.1:8081 "$@"
+    ;;
+  start)
+    if [ "${1:-}" == "--local-network" ]; then
+      # TODO: Can these just be set in TS?
+      export ARCHIVER_POLLING_INTERVAL_MS=500
+      export P2P_BLOCK_CHECK_INTERVAL_MS=500
+      export SEQ_TX_POLLING_INTERVAL_MS=500
+      export WS_BLOCK_CHECK_INTERVAL_MS=500
+      export ARCHIVER_VIEM_POLLING_INTERVAL_MS=500
+      export TEST_ACCOUNTS=${TEST_ACCOUNTS:-true}
+      export LOG_LEVEL=${LOG_LEVEL:-info;silent:sequencer;verbose:debug_log}
+      export DEPLOY_AZTEC_CONTRACTS_SALT=${DEPLOY_AZTEC_CONTRACTS_SALT:-$RANDOM}
+
+      ANVIL_PORT=${ANVIL_PORT:-8545}
+
+      export L1_CHAIN_ID=${L1_CHAIN_ID:-31337}
+      export ETHEREUM_HOSTS=${ETHEREUM_HOSTS:-"http://127.0.0.1:${ANVIL_PORT}"}
+
+      anvil --version
+      anvil --silent &
+      anvil_pid=$!
+      trap 'kill $anvil_pid &>/dev/null' EXIT
+    fi
+
+    aztec start "$@"
+    ;;
+  compile|new|init|flamegraph)
+    $script_dir/${cmd}.sh "$@"
+    ;;
+  *)
+    aztec $cmd "$@"
+    ;;
+esac

package/scripts/compile.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+NARGO=${NARGO:-nargo}
+BB=${BB:-bb}
+
+# If help is requested, show Aztec-specific info then run nargo compile help and then exit in order to not trigger
+# transpilation
+for arg in "$@"; do
+  if [ "$arg" == "--help" ] || [ "$arg" == "-h" ]; then
+    cat << 'EOF'
+Aztec Compile - Compile Aztec Noir contracts
+
+This command compiles Aztec Noir contracts using nargo and then automatically
+postprocesses them to generate Aztec specific artifacts including:
+- Transpiled contract artifacts
+- Verification keys
+
+The compiled contracts will be placed in the target/ directory by default.
+
+---
+Underlying nargo compile options:
+
+EOF
+    nargo compile --help
+    exit 0
+  fi
+done
+
+# Run nargo compile.
+$NARGO compile "$@"
+
+echo "Postprocessing contract..."
+$BB aztec_process
+
+# Strip internal prefixes from all compiled contract JSONs in target directory
+# TODO: This should be part of bb aztec_process!
+for json in target/*.json; do
+  temp_file="${json}.tmp"
+  jq '.functions |= map(.name |= sub("^__aztec_nr_internals__"; ""))' "$json" > "$temp_file"
+  mv "$temp_file" "$json"
+done
+
+echo "Compilation complete!"

package/scripts/extract_function.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import fs from 'fs/promises';
+import path from 'path';
+
+// Simple script to extract a contract function as a separate Noir artifact.
+// We need to use this since the transpiling that we do on public functions make the contract artifacts
+// unreadable by noir tooling, since they are no longer following the noir artifact format.
+async function main() {
+  let [contractArtifactPath, functionName] = process.argv.slice(2);
+  if (!contractArtifactPath || !functionName) {
+    console.log('Usage: node extractFunctionAsNoirArtifact.js <contractArtifactPath> <functionName>');
+    return;
+  }
+
+  const contractArtifact = JSON.parse(await fs.readFile(contractArtifactPath, 'utf8'));
+  const func = contractArtifact.functions.find(f => f.name === functionName);
+  if (!func) {
+    console.error(`Function ${functionName} not found in ${contractArtifactPath}`);
+    return;
+  }
+
+  const artifact = {
+    noir_version: contractArtifact.noir_version,
+    hash: 0,
+    abi: func.abi,
+    bytecode: func.bytecode,
+    debug_symbols: func.debug_symbols,
+    file_map: contractArtifact.file_map,
+    expression_width: {
+      Bounded: {
+        width: 4,
+      },
+    },
+  };
+
+  const outputDir = path.dirname(contractArtifactPath);
+  const outputName = path.basename(contractArtifactPath, '.json') + `-${functionName}.json`;
+
+  const outPath = path.join(outputDir, outputName);
+
+  await fs.writeFile(outPath, JSON.stringify(artifact, null, 2));
+}
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/scripts/flamegraph.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+set -eu
+
+# If first arg is -h or --help, print usage.
+if [ $# -lt 2 ] || [ "$1" == "-h" ] || [ "$1" == "--help" ]; then
+    cat << 'EOF'
+Aztec Flamegraph - Generate a gate count flamegraph for an aztec contract function.
+
+Usage: aztec flamegraph <contract_artifact> <function>
+
+Options:
+  -h, --help     Print help
+
+Will output an svg at <artifact_path>/<contract>-<function>-flamegraph.svg.
+You can open it in your browser to view it.
+
+EOF
+    exit 0
+fi
+
+cleanup() {
+  set +e
+  if [ -f "$function_artifact" ]; then
+    rm -f "$function_artifact"
+  fi
+}
+
+trap cleanup EXIT
+
+# Get the directory of the script
+script_dir=$(realpath $(dirname $0))
+
+PROFILER=${PROFILER_PATH:-noir-profiler}
+BB=${BB:-bb}
+
+# first console arg is contract name in camel case or path to contract artifact
+contract=$1
+
+# second console arg is the contract function
+function=$2
+
+if [ ! -f "$contract" ]; then
+  echo "Error: Contract artifact not found at: $contract"
+  exit 1
+fi
+artifact_path=$contract
+function_artifact="${artifact_path%%.json}-${function}.json"
+output_dir=$(dirname "$artifact_path")
+
+# Extract artifact for the specific function.
+node $script_dir/extract_function.js "$artifact_path" $function
+
+# Generate the flamegraph
+$PROFILER gates --artifact-path "$function_artifact" --backend-path "$BB" --backend-gates-command "gates" --output "$output_dir" --scheme chonk --include_gates_per_opcode
+
+# Save as $artifact_name-$function-flamegraph.svg
+output_file="${function_artifact%%.json}-flamegraph.svg"
+mv "$output_dir/__aztec_nr_internals__${function}_gates.svg" "$output_file"
+echo "Flamegraph generated at: $output_file"

package/scripts/init.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+NARGO=${NARGO:-nargo}
+script_path=$(realpath $(dirname "$0"))
+
+for arg in "$@"; do
+  if [ "$arg" == "--help" ] || [ "$arg" == "-h" ]; then
+    cat << 'EOF'
+Aztec Init - Create a new Aztec Noir project in the current directory
+
+Usage: aztec init [OPTIONS]
+
+Options:
+  --name <NAME>  Name of the package [default: current directory name]
+  --lib          Use a library template
+  -h, --help     Print help
+
+This command creates a new Aztec Noir project in the current directory using nargo
+and automatically adds the Aztec.nr dependency to your Nargo.toml file.
+
+EOF
+    exit 0
+  fi
+  if [ "$arg" == "--lib" ]; then
+    is_contract=0
+  fi
+done
+
+echo "Initializing Noir project..."
+$NARGO init "$@"
+
+if [ "${is_contract:-1}" -eq 1 ]; then
+  $script_path/setup_project.sh
+fi

package/scripts/new.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+NARGO=${NARGO:-nargo}
+script_path=$(realpath $(dirname "$0"))
+
+type_arg="--contract"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --help|-h)
+      cat << 'EOF'
+Aztec New - Create a new Aztec Noir project in a new directory
+
+Usage: aztec new [OPTIONS] <PATH>
+
+Arguments:
+  <PATH>  The path to save the new project
+
+Options:
+  --name <NAME>  Name of the package [default: package directory name]
+  --lib          Create a library template instead of a contract
+  -h, --help     Print help
+
+This command creates a new Aztec Noir project using nargo and automatically
+adds the Aztec.nr dependency to your Nargo.toml file.
+EOF
+      exit 0
+      ;;
+    --lib)
+      type_arg="--lib"
+      shift
+      ;;
+    --name)
+      name_arg="--name $2"
+      shift 2
+      ;;
+    *)
+      project_path=$1
+      shift
+      break
+      ;;
+  esac
+done
+
+if [ -z "$project_path" ]; then
+  echo "Error: PATH argument is required"
+  echo "Usage: aztec new [OPTIONS] <PATH>"
+  echo "Run 'aztec new --help' for more information"
+  exit 1
+fi
+
+echo "Creating new Noir project at $project_path..."
+$NARGO new $type_arg ${name_arg:-} $project_path
+
+if [ "$type_arg" == "--contract" ]; then
+  cd $project_path
+  $script_path/setup_project.sh
+fi

package/scripts/setup_project.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Get the actual aztec version for the git tag.
+AZTEC_VERSION=$(jq -r '.version' $(dirname $0)/../package.json)
+NARGO_TOML_PATH="Nargo.toml"
+MAIN_NR_PATH="src/main.nr"
+
+if [ ! -f "$NARGO_TOML_PATH" ]; then
+  >&2 echo "Warning: Could not find Nargo.toml at $NARGO_TOML_PATH to add aztec dependency"
+  exit 1
+fi
+
+if [ ! -f "$MAIN_NR_PATH" ]; then
+  >&2 echo "Warning: Could not find main.nr at $MAIN_NR_PATH"
+  exit 1
+fi
+
+# Add aztec dependency to Nargo.toml
+echo "" >> "$NARGO_TOML_PATH"
+echo "aztec = { git=\"https://github.com/AztecProtocol/aztec-nr\", tag=\"v${AZTEC_VERSION}\", directory=\"aztec\" }" >> "$NARGO_TOML_PATH"
+echo "Added aztec dependency (v${AZTEC_VERSION}) to Nargo.toml"
+
+# Replace the contents of main.nr with the Aztec contract template
+cat > "$MAIN_NR_PATH" << 'EOF'
+use aztec::macros::aztec;
+
+#[aztec]
+contract Main {}
+EOF
+echo "Created main.nr with Aztec contract template"

package/src/cli/cli.ts

@@ -31,9 +31,10 @@ export function injectAztecCommands(program: Command, userLog: LogFn, debugLogge
 
   program.configureHelp({ sortSubcommands: true });
 
-  program.addHelpText(
-    'after',
-    `
+  if (process.env.AZTEC_SHELL_WRAPPER) {
+    program.addHelpText(
+      'after',
+      `
 
   Additional commands:
 
@@ -64,30 +65,17 @@ export function injectAztecCommands(program: Command, userLog: LogFn, debugLogge
       The compiled contracts will be placed in the target/ directory by default.
       Supports standard nargo compile options.
 
-    fmt [options]: formats Noir code using nargo fmt
-      Example:
-        $ aztec fmt                     # formats all Noir files in the project
-
-    check [options]: type-checks Noir code without compiling using nargo check
-      Example:
-        $ aztec check                   # checks all Noir files in the project
-
     test [options]: starts a dockerized TXE node via
       $ aztec start --txe
     then runs
       $ aztec test --silence-warnings --oracle-resolver=<TXE_ADDRESS> [options]
 
-    lsp: starts the Nargo Language Server Protocol server
-      Runs nargo lsp in a Docker container for IDE integration with Noir.
-      This command is typically used by IDE extensions and not called directly by users.
-      Example:
-        $ aztec lsp                     # starts the LSP server
-
     preload-crs: Downloads and caches the Common Reference String (CRS) data required for zero-knowledge proofs.
       Example:
         $ aztec preload-crs             # preloads CRS data
     `,
-  );
+    );
+  }
 
   program
     .command('preload-crs')