@aztec-labs/cli 6.0.0-nightly.20260829

package/dest/utils/inspect.d.ts

@@ -0,0 +1,11 @@
+import { BlockNumber } from '@aztec-labs/foundation/branded-types';
+import type { LogFn } from '@aztec-labs/foundation/log';
+import type { AztecNode } from '@aztec-labs/stdlib/interfaces/client';
+import type { TxHash } from '@aztec-labs/stdlib/tx';
+export declare function inspectBlock(aztecNode: AztecNode, blockNumber: BlockNumber, log: LogFn, opts?: {
+    showTxs?: boolean;
+}): Promise<void>;
+export declare function inspectTx(aztecNode: AztecNode, txHash: TxHash, log: LogFn, opts?: {
+    includeBlockInfo?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5zcGVjdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2luc3BlY3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBQ25FLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3hELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBQ3RFLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBRXBELHdCQUFzQixZQUFZLENBQ2hDLFNBQVMsRUFBRSxTQUFTLEVBQ3BCLFdBQVcsRUFBRSxXQUFXLEVBQ3hCLEdBQUcsRUFBRSxLQUFLLEVBQ1YsSUFBSSxHQUFFO0lBQUUsT0FBTyxDQUFDLEVBQUUsT0FBTyxDQUFBO0NBQU8saUJBeUJqQztBQUVELHdCQUFzQixTQUFTLENBQzdCLFNBQVMsRUFBRSxTQUFTLEVBQ3BCLE1BQU0sRUFBRSxNQUFNLEVBQ2QsR0FBRyxFQUFFLEtBQUssRUFDVixJQUFJLEdBQUU7SUFBRSxnQkFBZ0IsQ0FBQyxFQUFFLE9BQU8sQ0FBQTtDQUFPLGlCQXNFMUMifQ==

package/dest/utils/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/utils/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,wBAAsB,YAAY,CAChC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,KAAK,EACV,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,iBAyBjC;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,KAAK,EACV,IAAI,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,iBAsE1C"}

package/dest/utils/inspect.js

@@ -0,0 +1,90 @@
+export async function inspectBlock(aztecNode, blockNumber, log, opts = {}) {
+    const block = await aztecNode.getBlock(blockNumber, {
+        includeTransactions: opts.showTxs
+    });
+    if (!block) {
+        log(`No block found for block number ${blockNumber}`);
+        return;
+    }
+    log(`Block ${blockNumber} (${block.hash.toString()})`);
+    log(` Total fees: ${block.header.totalFees.toBigInt()}`);
+    log(` Total mana used: ${block.header.totalManaUsed.toBigInt()}`);
+    log(` Fee per gas unit: DA=${block.header.globalVariables.gasFees.feePerDaGas} L2=${block.header.globalVariables.gasFees.feePerL2Gas}`);
+    log(` Coinbase: ${block.header.globalVariables.coinbase}`);
+    log(` Fee recipient: ${block.header.globalVariables.feeRecipient}`);
+    log(` Timestamp: ${new Date(Number(block.header.globalVariables.timestamp) * 500)}`);
+    if (opts.showTxs && block.body) {
+        log(``);
+        for (const txHash of block.body.txEffects.map((tx)=>tx.txHash)){
+            await inspectTx(aztecNode, txHash, log, {
+                includeBlockInfo: false
+            });
+        }
+    } else if (block.body) {
+        log(` Transactions: ${block.body.txEffects.length}`);
+    }
+}
+export async function inspectTx(aztecNode, txHash, log, opts = {}) {
+    const receipt = await aztecNode.getTxReceipt(txHash, {
+        includeTxEffect: true
+    });
+    // Base tx data
+    log(`Tx ${txHash.toString()}`);
+    log(` Status: ${receipt.status}`);
+    if (receipt.executionResult) {
+        log(` Execution result: ${receipt.executionResult}`);
+    }
+    if (receipt.error) {
+        log(` Error: ${receipt.error}`);
+    }
+    if (!receipt.isMined() || !receipt.txEffect) {
+        return;
+    }
+    const effects = receipt.txEffect;
+    if (opts.includeBlockInfo) {
+        log(` Block: ${receipt.blockNumber} (${receipt.blockHash?.toString()})`);
+    }
+    if (receipt.transactionFee) {
+        log(` Fee: ${receipt.transactionFee.toString()}`);
+    }
+    // Public logs
+    const publicLogs = effects.publicLogs;
+    if (publicLogs.length > 0) {
+        log(' Logs:');
+        for (const publicLog of publicLogs){
+            log(`  ${publicLog.toHumanReadable()}`);
+        }
+    }
+    // Public data writes
+    const writes = effects.publicDataWrites;
+    if (writes.length > 0) {
+        log(' Public data writes:');
+        for (const write of writes){
+            log(`  Leaf ${write.leafSlot.toString()} = ${write.value.toString()}`);
+        }
+    }
+    // Created notes
+    const notes = effects.noteHashes;
+    if (notes.length > 0) {
+        log(' Created notes:');
+        log(`  Total: ${notes.length}`);
+        for (const note of notes){
+            log(`  Note hash: ${note.toShortString()}`);
+        }
+    }
+    // Created nullifiers
+    const nullifiers = effects.nullifiers;
+    if (nullifiers.length > 0) {
+        log(' Created nullifiers:');
+        for (const nullifier of nullifiers){
+            log(`  Nullifier: ${nullifier.toShortString()}`);
+        }
+    }
+    // L2 to L1 messages
+    if (effects.l2ToL1Msgs.length > 0) {
+        log(` L2 to L1 messages:`);
+        for (const msg of effects.l2ToL1Msgs){
+            log(`  ${msg.toString()}`);
+        }
+    }
+}

package/dest/utils/setup_contracts.d.ts

@@ -0,0 +1,3 @@
+import type { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+export declare function getSponsoredFPCAddress(): Promise<AztecAddress>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2V0dXBfY29udHJhY3RzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvc2V0dXBfY29udHJhY3RzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBWW5FLHdCQUFzQixzQkFBc0IsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLENBTXBFIn0=

package/dest/utils/setup_contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup_contracts.d.ts","sourceRoot":"","sources":["../../src/utils/setup_contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAYnE,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,YAAY,CAAC,CAMpE"}

package/dest/utils/setup_contracts.js

@@ -0,0 +1,16 @@
+import { getContractInstanceFromInstantiationParams } from '@aztec-labs/aztec.js/contracts';
+import { Fr } from '@aztec-labs/aztec.js/fields';
+import { SPONSORED_FPC_SALT } from '@aztec-labs/constants';
+async function getSponsoredFPCContract() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - Importing noir-contracts.js even in devDeps results in a circular dependency error. Need to ignore because this line doesn't cause an error in a dev environment
+    const { SponsoredFPCContract } = await import('@aztec-labs/noir-contracts.js/SponsoredFPC');
+    return SponsoredFPCContract;
+}
+export async function getSponsoredFPCAddress() {
+    const SponsoredFPCContract = await getSponsoredFPCContract();
+    const sponsoredFPCInstance = await getContractInstanceFromInstantiationParams(SponsoredFPCContract.artifact, {
+        salt: new Fr(SPONSORED_FPC_SALT)
+    });
+    return sponsoredFPCInstance.address;
+}

package/package.json

@@ -0,0 +1,141 @@
+{
+  "name": "@aztec-labs/cli",
+  "version": "6.0.0-nightly.20260829",
+  "type": "module",
+  "exports": {
+    "./devnet": "./dest/cmds/devnet/index.js",
+    "./infrastructure": "./dest/cmds/infrastructure/index.js",
+    "./l1": "./dest/cmds/l1/index.js",
+    "./l1/validators": "./dest/cmds/l1/update_l1_validators.js",
+    "./aztec_node": "./dest/cmds/aztec_node/index.js",
+    "./cli-utils": "./dest/utils/index.js",
+    "./misc": "./dest/cmds/misc/index.js",
+    "./validator_keys": "./dest/cmds/validator_keys/index.js",
+    "./setup-contracts": "./dest/cmds/misc/setup_contracts.js",
+    "./utils": "./dest/utils/index.js",
+    "./inspect": "./dest/utils/inspect.js",
+    "./config": "./dest/config/index.js",
+    "./config/chain": "./dest/config/chain_l2_config.js",
+    "./config/network": "./dest/config/network_config.js"
+  },
+  "typedocOptions": {
+    "entryPoints": [
+      "./dest/builder/index.js"
+    ],
+    "name": "Aztec CLI",
+    "tsconfig": "./tsconfig.json"
+  },
+  "scripts": {
+    "build": "yarn clean && ../scripts/tsc.sh",
+    "build:dev": "../scripts/tsc.sh --watch",
+    "clean": "rm -rf ./dest .tsbuildinfo",
+    "copy-generated": "mkdir -p dest/config/generated/networks && cp src/config/generated/networks/*.json dest/config/generated/networks/",
+    "generate": "./scripts/generate.sh",
+    "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
+  },
+  "inherits": [
+    "../package.common.json",
+    "./package.local.json"
+  ],
+  "jest": {
+    "preset": "ts-jest/presets/default-esm",
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.[cm]?js$": "$1"
+    },
+    "testRegex": "./src/.*\\.test\\.(js|mjs|ts)$",
+    "rootDir": "./src",
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "transform": {
+      "^.+\\.tsx?$": [
+        "@swc/jest",
+        {
+          "jsc": {
+            "parser": {
+              "syntax": "typescript",
+              "decorators": true
+            },
+            "transform": {
+              "decoratorVersion": "2022-03"
+            }
+          }
+        }
+      ]
+    },
+    "reporters": [
+      "default"
+    ],
+    "testTimeout": 120000,
+    "setupFiles": [
+      "../../foundation/src/jest/setup.mjs"
+    ],
+    "testEnvironment": "../../foundation/src/jest/env.mjs",
+    "setupFilesAfterEnv": [
+      "../../foundation/src/jest/setupAfterEnv.mjs"
+    ]
+  },
+  "dependencies": {
+    "@aztec-labs/accounts": "6.0.0-nightly.20260829",
+    "@aztec-labs/archiver": "6.0.0-nightly.20260829",
+    "@aztec-labs/aztec.js": "6.0.0-nightly.20260829",
+    "@aztec-labs/constants": "6.0.0-nightly.20260829",
+    "@aztec-labs/ethereum": "6.0.0-nightly.20260829",
+    "@aztec-labs/foundation": "6.0.0-nightly.20260829",
+    "@aztec-labs/node-keystore": "6.0.0-nightly.20260829",
+    "@aztec-labs/p2p": "6.0.0-nightly.20260829",
+    "@aztec-labs/protocol-contracts": "6.0.0-nightly.20260829",
+    "@aztec-labs/stdlib": "6.0.0-nightly.20260829",
+    "@aztec-labs/wallets": "6.0.0-nightly.20260829",
+    "@aztec-labs/world-state": "6.0.0-nightly.20260829",
+    "@aztec/l1-artifacts": "6.0.0-nightly.20260826",
+    "@ethersproject/wallet": "^5.8.0",
+    "@iarna/toml": "^2.2.5",
+    "@libp2p/peer-id-factory": "^3.0.4",
+    "@scure/bip39": "^2.0.1",
+    "commander": "^12.1.0",
+    "lodash.chunk": "^4.2.0",
+    "lodash.groupby": "^4.6.0",
+    "semver": "^7.5.4",
+    "source-map-support": "^0.5.21",
+    "tslib": "^2.4.0",
+    "viem": "npm:@aztec/viem@2.38.2"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/lodash.chunk": "^4.2.9",
+    "@types/lodash.groupby": "^4.6.9",
+    "@types/lodash.startcase": "^4.4.7",
+    "@types/node": "^22.15.17",
+    "@types/semver": "^7.5.2",
+    "@types/source-map-support": "^0.5.10",
+    "@typescript/native-preview": "7.0.0-dev.20260113.1",
+    "jest": "^30.0.0",
+    "jest-mock-extended": "^4.0.0",
+    "ts-jest": "^29.4.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "@aztec-labs/accounts": "6.0.0-nightly.20260829",
+    "@aztec-labs/bb-prover": "6.0.0-nightly.20260829",
+    "@aztec-labs/ethereum": "6.0.0-nightly.20260829",
+    "@aztec-labs/noir-contracts.js": "6.0.0-nightly.20260829",
+    "@aztec-labs/noir-protocol-circuits-types": "6.0.0-nightly.20260829",
+    "@aztec-labs/noir-test-contracts.js": "6.0.0-nightly.20260829",
+    "@aztec-labs/protocol-contracts": "6.0.0-nightly.20260829",
+    "@aztec-labs/stdlib": "6.0.0-nightly.20260829",
+    "@aztec/l1-artifacts": "6.0.0-nightly.20260826"
+  },
+  "files": [
+    "dest",
+    "src",
+    "!*.test.*",
+    "public_include_metric_prefixes.json"
+  ],
+  "types": "./dest/index.d.ts",
+  "engines": {
+    "node": ">=20.10"
+  }
+}

package/public_include_metric_prefixes.json

@@ -0,0 +1 @@
+["aztec.validator", "aztec.tx_collector", "aztec.mempool", "aztec.p2p.gossip.agg_", "aztec.ivc_verifier.agg_"]

package/src/cmds/aztec_node/block_number.ts

@@ -0,0 +1,9 @@
+import { createAztecNodeClient } from '@aztec-labs/aztec.js/node';
+import type { LogFn } from '@aztec-labs/foundation/log';
+
+export async function blockNumber(nodeUrl: string, log: LogFn) {
+  const aztecNode = createAztecNodeClient(nodeUrl);
+  const [latestNum, provenNum] = await Promise.all([aztecNode.getBlockNumber(), aztecNode.getBlockNumber('proven')]);
+  log(`Latest block: ${latestNum}`);
+  log(`Proven block: ${provenNum}`);
+}

package/src/cmds/aztec_node/get_block.ts

@@ -0,0 +1,11 @@
+import { createAztecNodeClient } from '@aztec-labs/aztec.js/node';
+import { BlockNumber } from '@aztec-labs/foundation/branded-types';
+import type { LogFn } from '@aztec-labs/foundation/log';
+
+import { inspectBlock } from '../../utils/inspect.js';
+
+export async function getBlock(nodeUrl: string, maybeBlockNumber: number | undefined, log: LogFn) {
+  const aztecNode = createAztecNodeClient(nodeUrl);
+  const blockNumber: BlockNumber = maybeBlockNumber ? BlockNumber(maybeBlockNumber) : await aztecNode.getBlockNumber();
+  await inspectBlock(aztecNode, blockNumber, log, { showTxs: true });
+}

package/src/cmds/aztec_node/get_current_min_fee.ts

@@ -0,0 +1,9 @@
+import { createAztecNodeClient } from '@aztec-labs/aztec.js/node';
+import { jsonStringify } from '@aztec-labs/foundation/json-rpc';
+import type { LogFn, Logger } from '@aztec-labs/foundation/log';
+
+export async function getCurrentMinFee(nodeUrl: string, debugLogger: Logger, log: LogFn) {
+  const node = createAztecNodeClient(nodeUrl);
+  const fees = await node.getCurrentMinFees();
+  log(`Current fees: ${jsonStringify(fees)}`);
+}

package/src/cmds/aztec_node/get_l1_to_l2_message_witness.ts

@@ -0,0 +1,27 @@
+import type { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import type { Fr } from '@aztec-labs/aztec.js/fields';
+import { createAztecNodeClient } from '@aztec-labs/aztec.js/node';
+import type { LogFn } from '@aztec-labs/foundation/log';
+import { getNonNullifiedL1ToL2MessageWitness } from '@aztec-labs/stdlib/messaging';
+
+export async function getL1ToL2MessageWitness(
+  nodeUrl: string,
+  contractAddress: AztecAddress,
+  messageHash: Fr,
+  secret: Fr,
+  log: LogFn,
+) {
+  const node = createAztecNodeClient(nodeUrl);
+  const messageWitness = await getNonNullifiedL1ToL2MessageWitness(node, contractAddress, messageHash, secret);
+
+  log(
+    messageWitness === undefined
+      ? `
+    L1 to L2 Message not found.
+    `
+      : `
+    L1 to L2 message index: ${messageWitness[0]}
+    L1 to L2 message sibling path: ${messageWitness[1]}
+    `,
+  );
+}

package/src/cmds/aztec_node/get_logs.ts

@@ -0,0 +1,100 @@
+import type { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import { createAztecNodeClient } from '@aztec-labs/aztec.js/node';
+import type { TxHash } from '@aztec-labs/aztec.js/tx';
+import type { BlockNumber } from '@aztec-labs/foundation/branded-types';
+import type { LogFn } from '@aztec-labs/foundation/log';
+import { sleep } from '@aztec-labs/foundation/sleep';
+import {
+  LogCursor,
+  type PublicLogsQuery,
+  type Tag,
+  logResultToHumanReadable,
+  queryAllPublicLogsByTags,
+} from '@aztec-labs/stdlib/logs';
+
+/** Options for the `get-logs` CLI command. */
+export type GetLogsOptions = {
+  /** Contract address that emitted the logs (required). */
+  contractAddress: AztecAddress;
+  /** Tag to filter logs by (required). */
+  tag: Tag;
+  /** Restrict the search to this tx hash. Mutually exclusive with `fromBlock`/`toBlock`. */
+  txHash?: TxHash;
+  /** Lower block bound, inclusive. */
+  fromBlock?: BlockNumber;
+  /** Upper block bound, exclusive. */
+  toBlock?: BlockNumber;
+  /** Log cursor to resume pagination strictly after a previously-seen log. */
+  afterLog?: LogCursor;
+  /** Node RPC URL. */
+  nodeUrl: string;
+  /** When set, polls indefinitely for new logs. Incompatible with `txHash` and `toBlock`. */
+  follow: boolean;
+  /** Log function. */
+  log: LogFn;
+};
+
+/**
+ * Fetches public logs for a (contract, tag) pair, draining all pages via the stdlib pagination helper.
+ * In `--follow` mode, polls indefinitely: each round drains all currently-available logs, then sleeps
+ * until the next poll if nothing new was found.
+ */
+export async function getLogs(options: GetLogsOptions): Promise<void> {
+  const { txHash, fromBlock, toBlock, contractAddress, tag, nodeUrl, follow, log } = options;
+  let afterLog = options.afterLog;
+
+  if (follow) {
+    if (txHash) {
+      throw Error('Cannot use --follow with --tx-hash');
+    }
+    if (toBlock) {
+      throw Error('Cannot use --follow with --to-block');
+    }
+  }
+  if (txHash !== undefined && (fromBlock !== undefined || toBlock !== undefined)) {
+    throw Error('Cannot combine --tx-hash with --from-block / --to-block');
+  }
+
+  const node = createAztecNodeClient(nodeUrl);
+
+  const drainLogs = async () => {
+    const query: PublicLogsQuery = {
+      contractAddress,
+      tags: [afterLog !== undefined ? { tag, afterLog } : tag],
+      fromBlock,
+      toBlock,
+      txHash,
+    };
+    const [logsForTag] = await queryAllPublicLogsByTags(node, query);
+    if (logsForTag.length > 0) {
+      afterLog = LogCursor.fromLog(logsForTag[logsForTag.length - 1]);
+    }
+    return logsForTag;
+  };
+
+  if (follow) {
+    log('Fetching logs...');
+    while (true) {
+      const results = await drainLogs();
+      if (results.length === 0) {
+        await sleep(1000);
+      } else {
+        results.forEach(r => log(logResultToHumanReadable(r)));
+      }
+    }
+  } else {
+    const results = await drainLogs();
+    if (results.length === 0) {
+      log(
+        `No logs found for {contractAddress: ${contractAddress.toString()}, tag: ${tag.toString()}` +
+          `${txHash ? `, txHash: ${txHash.toString()}` : ''}` +
+          `${fromBlock !== undefined ? `, fromBlock: ${fromBlock}` : ''}` +
+          `${toBlock !== undefined ? `, toBlock: ${toBlock}` : ''}` +
+          `${afterLog ? `, afterLog: ${afterLog.toString()}` : ''}}`,
+      );
+    } else {
+      log('Logs found: \n');
+      results.forEach(r => log(logResultToHumanReadable(r)));
+    }
+  }
+}

package/src/cmds/aztec_node/get_node_info.ts

@@ -0,0 +1,61 @@
+import { createAztecNodeClient } from '@aztec-labs/aztec.js/node';
+import type { LogFn } from '@aztec-labs/foundation/log';
+
+export async function getNodeInfo(nodeUrl: string, json: boolean, log: LogFn, logJson: (output: any) => void) {
+  const client = createAztecNodeClient(nodeUrl);
+
+  const info = await client.getNodeInfo();
+  if (json) {
+    logJson({
+      nodeVersion: info.nodeVersion,
+      l1ChainId: info.l1ChainId,
+      rollupVersion: info.rollupVersion,
+      enr: info.enr,
+      l1ContractAddresses: {
+        rollup: info.l1ContractAddresses.rollupAddress.toString(),
+        registry: info.l1ContractAddresses.registryAddress.toString(),
+        inbox: info.l1ContractAddresses.inboxAddress.toString(),
+        outbox: info.l1ContractAddresses.outboxAddress.toString(),
+        feeJuice: info.l1ContractAddresses.feeJuiceAddress.toString(),
+        stakingAsset: info.l1ContractAddresses.stakingAssetAddress.toString(),
+        feeJuicePortal: info.l1ContractAddresses.feeJuicePortalAddress.toString(),
+        coinIssuer: info.l1ContractAddresses.coinIssuerAddress.toString(),
+        rewardDistributor: info.l1ContractAddresses.rewardDistributorAddress.toString(),
+        governanceProposer: info.l1ContractAddresses.governanceProposerAddress.toString(),
+        governance: info.l1ContractAddresses.governanceAddress.toString(),
+        feeAssetHandler: info.l1ContractAddresses.feeAssetHandlerAddress?.toString(),
+        stakingAssetHandler: info.l1ContractAddresses.stakingAssetHandlerAddress?.toString(),
+      },
+      protocolContractAddresses: {
+        classRegistry: info.protocolContractAddresses.classRegistry.toString(),
+        feeJuice: info.protocolContractAddresses.feeJuice.toString(),
+        instanceRegistry: info.protocolContractAddresses.instanceRegistry.toString(),
+        multiCallEntrypoint: info.protocolContractAddresses.multiCallEntrypoint.toString(),
+      },
+    });
+  } else {
+    log(`Node Version: ${info.nodeVersion}`);
+    log(`Chain Id: ${info.l1ChainId}`);
+    log(`Rollup Version: ${info.rollupVersion}`);
+    log(`Node ENR: ${info.enr}`);
+    log(`L1 Contract Addresses:`);
+    log(` Rollup Address: ${info.l1ContractAddresses.rollupAddress.toString()}`);
+    log(` Registry Address: ${info.l1ContractAddresses.registryAddress.toString()}`);
+    log(` L1 -> L2 Inbox Address: ${info.l1ContractAddresses.inboxAddress.toString()}`);
+    log(` L2 -> L1 Outbox Address: ${info.l1ContractAddresses.outboxAddress.toString()}`);
+    log(` Fee Juice Address: ${info.l1ContractAddresses.feeJuiceAddress.toString()}`);
+    log(` Staking Asset Address: ${info.l1ContractAddresses.stakingAssetAddress.toString()}`);
+    log(` Fee Juice Portal Address: ${info.l1ContractAddresses.feeJuicePortalAddress.toString()}`);
+    log(` CoinIssuer Address: ${info.l1ContractAddresses.coinIssuerAddress.toString()}`);
+    log(` RewardDistributor Address: ${info.l1ContractAddresses.rewardDistributorAddress.toString()}`);
+    log(` GovernanceProposer Address: ${info.l1ContractAddresses.governanceProposerAddress.toString()}`);
+    log(` Governance Address: ${info.l1ContractAddresses.governanceAddress.toString()}`);
+    log(` FeeAssetHandler Address: ${info.l1ContractAddresses.feeAssetHandlerAddress?.toString()}`);
+    log(` StakingAssetHandler Address: ${info.l1ContractAddresses.stakingAssetHandlerAddress?.toString()}`);
+    log(`L2 Contract Addresses:`);
+    log(` Class Registry: ${info.protocolContractAddresses.classRegistry.toString()}`);
+    log(` Fee Juice: ${info.protocolContractAddresses.feeJuice.toString()}`);
+    log(` Instance Deployer: ${info.protocolContractAddresses.instanceRegistry.toString()}`);
+    log(` MultiCall: ${info.protocolContractAddresses.multiCallEntrypoint.toString()}`);
+  }
+}

package/src/cmds/aztec_node/index.ts

@@ -0,0 +1,91 @@
+import type { LogFn, Logger } from '@aztec-labs/foundation/log';
+import type { Command } from 'commander';
+
+import {
+  logJson,
+  nodeOption,
+  parseAztecAddress,
+  parseField,
+  parseOptionalInteger,
+  parseOptionalLogCursor,
+  parseOptionalTxHash,
+  parseTag,
+} from '../../utils/commands.js';
+
+export function injectCommands(program: Command, log: LogFn, debugLogger: Logger) {
+  program
+    .command('get-block')
+    .description('Gets info for a given block or latest.')
+    .argument('[blockNumber]', 'Block height', parseOptionalInteger)
+    .addOption(nodeOption)
+    .action(async (blockNumber, options) => {
+      const { getBlock } = await import('./get_block.js');
+      await getBlock(options.nodeUrl, blockNumber, log);
+    });
+
+  program
+    .command('get-current-min-fee')
+    .description('Gets the current base fee.')
+    .addOption(nodeOption)
+    .action(async options => {
+      const { getCurrentMinFee } = await import('./get_current_min_fee.js');
+      await getCurrentMinFee(options.rpcUrl, debugLogger, log);
+    });
+
+  program
+    .command('get-l1-to-l2-message-witness')
+    .description('Gets a L1 to L2 message witness.')
+    .requiredOption('-ca, --contract-address <address>', 'Aztec address of the contract.', parseAztecAddress)
+    .requiredOption('--message-hash <messageHash>', 'The L1 to L2 message hash.', parseField)
+    .requiredOption('--secret <secret>', 'The secret used to claim the L1 to L2 message', parseField)
+    .addOption(nodeOption)
+    .action(async ({ contractAddress, messageHash, secret, nodeUrl }) => {
+      const { getL1ToL2MessageWitness } = await import('./get_l1_to_l2_message_witness.js');
+      await getL1ToL2MessageWitness(nodeUrl, contractAddress, messageHash, secret, log);
+    });
+
+  program
+    .command('get-logs')
+    .description('Gets public logs for a contract and tag, optionally restricted by block range or tx hash.')
+    .requiredOption('-ca, --contract-address <address>', 'Contract address that emitted the logs.', parseAztecAddress)
+    .requiredOption('--tag <tag>', 'Tag (Fr value) to filter logs by.', parseTag)
+    .option('-tx, --tx-hash <txHash>', 'A transaction hash to restrict the search to.', parseOptionalTxHash)
+    .option(
+      '-fb, --from-block <blockNum>',
+      'Initial block number for getting logs (defaults to 1).',
+      parseOptionalInteger,
+    )
+    .option('-tb, --to-block <blockNum>', 'Up to which block to fetch logs (defaults to latest).', parseOptionalInteger)
+    .option(
+      '-al --after-log <cursor>',
+      'Log cursor of the form <blockNumber>-<txIndexWithinBlock>-<logIndexWithinTx> to resume pagination after.',
+      parseOptionalLogCursor,
+    )
+    .addOption(nodeOption)
+    .option('--follow', 'If set, will keep polling for new logs until interrupted.')
+    .action(async ({ txHash, fromBlock, toBlock, afterLog, contractAddress, tag, nodeUrl, follow }) => {
+      const { getLogs } = await import('./get_logs.js');
+      await getLogs({ txHash, fromBlock, toBlock, afterLog, contractAddress, tag, nodeUrl, follow, log });
+    });
+
+  program
+    .command('block-number')
+    .description('Gets the current Aztec L2 block number.')
+    .addOption(nodeOption)
+    .action(async (options: any) => {
+      const { blockNumber } = await import('./block_number.js');
+      await blockNumber(options.nodeUrl, log);
+    });
+
+  program
+    .command('get-node-info')
+    .description('Gets the information of an Aztec node from a PXE or directly from an Aztec node.')
+    .option('--json', 'Emit output as json')
+    .addOption(nodeOption)
+    .action(async options => {
+      const { getNodeInfo } = await import('./get_node_info.js');
+      await getNodeInfo(options.nodeUrl, options.json, log, logJson(log));
+    });
+
+  return program;
+}

package/src/cmds/infrastructure/index.ts

@@ -0,0 +1,51 @@
+import type { LogFn } from '@aztec-labs/foundation/log';
+import type { Command } from 'commander';
+
+import { ETHEREUM_HOSTS, l1ChainIdOption, nodeOption, parseOptionalInteger } from '../../utils/commands.js';
+
+export function injectCommands(program: Command, log: LogFn) {
+  program
+    .command('setup-protocol-contracts')
+    .description('Bootstrap the blockchain by initializing all the protocol contracts')
+    .addOption(nodeOption)
+    .option('--testAccounts', 'Deploy funded test accounts.')
+    .option('--json', 'Output the contract addresses in JSON format')
+    .action(async options => {
+      const { setupL2Contracts } = await import('./setup_l2_contract.js');
+      await setupL2Contracts(options.nodeUrl, options.testAccounts, options.json, log);
+    });
+
+  program
+    .command('sequencers')
+    .argument('<command>', 'Command to run: list, add, remove, who-next')
+    .argument('[who]', 'Who to add/remove')
+    .description('Manages or queries registered sequencers on the L1 rollup contract.')
+    .requiredOption<string[]>(
+      '--l1-rpc-urls <string>',
+      'List of Ethereum host URLs. Chain identifiers localhost and testnet can be used (comma separated)',
+      (arg: string) => arg.split(','),
+      [ETHEREUM_HOSTS],
+    )
+    .option(
+      '-m, --mnemonic <string>',
+      'The mnemonic for the sender of the tx',
+      'test test test test test test test test test test test junk',
+    )
+    .option('--block-number <number>', 'Block number to query next sequencer for', parseOptionalInteger)
+    .addOption(nodeOption)
+    .addOption(l1ChainIdOption)
+    .action(async (command, who, options) => {
+      const { sequencers } = await import('./sequencers.js');
+      await sequencers({
+        command: command,
+        who,
+        mnemonic: options.mnemonic,
+        nodeUrl: options.nodeUrl,
+        l1RpcUrls: options.l1RpcUrls,
+        chainId: options.l1ChainId,
+        log,
+      });
+    });
+
+  return program;
+}