@aztec/cli 4.0.0-nightly.20250907 → 4.0.0-nightly.20260108

package/src/cmds/pxe/add_contract.ts

@@ -1,41 +0,0 @@
-import { AztecAddress, type ContractInstanceWithAddress, type Fr, getContractClassFromArtifact } from '@aztec/aztec.js';
-import { createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-import { computeContractAddressFromInstance } from '@aztec/stdlib/contract';
-import { PublicKeys } from '@aztec/stdlib/keys';
-
-import { getContractArtifact } from '../../utils/aztec.js';
-
-export async function addContract(
-  rpcUrl: string,
-  contractArtifactPath: string,
-  address: AztecAddress,
-  initializationHash: Fr,
-  salt: Fr,
-  publicKeys: PublicKeys,
-  deployer: AztecAddress | undefined,
-  debugLogger: Logger,
-  log: LogFn,
-) {
-  const artifact = await getContractArtifact(contractArtifactPath, log);
-  const contractClass = await getContractClassFromArtifact(artifact);
-  const instance: ContractInstanceWithAddress = {
-    version: 1,
-    salt,
-    initializationHash,
-    currentContractClassId: contractClass.id,
-    originalContractClassId: contractClass.id,
-    publicKeys: publicKeys ?? PublicKeys.default(),
-    address,
-    deployer: deployer ?? AztecAddress.ZERO,
-  };
-  const computed = await computeContractAddressFromInstance(instance);
-  if (!computed.equals(address)) {
-    throw new Error(`Contract address ${address.toString()} does not match computed address ${computed.toString()}`);
-  }
-
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-
-  await client.registerContract({ artifact, instance });
-  log(`\nContract added to PXE at ${address.toString()} with class ${instance.currentContractClassId.toString()}\n`);
-}

package/src/cmds/pxe/block_number.ts

@@ -1,9 +0,0 @@
-import { createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-export async function blockNumber(rpcUrl: string, debugLogger: Logger, log: LogFn) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const [latestNum, provenNum] = await Promise.all([client.getBlockNumber(), client.getProvenBlockNumber()]);
-  log(`Latest block: ${latestNum}`);
-  log(`Proven block: ${provenNum}`);
-}

package/src/cmds/pxe/get_account.ts

@@ -1,16 +0,0 @@
-import type { AztecAddress } from '@aztec/aztec.js';
-import { createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-export async function getAccount(aztecAddress: AztecAddress, rpcUrl: string, debugLogger: Logger, log: LogFn) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const account = (await client.getRegisteredAccounts()).find(completeAddress =>
-    completeAddress.address.equals(aztecAddress),
-  );
-
-  if (!account) {
-    log(`Unknown account ${aztecAddress.toString()}`);
-  } else {
-    log(account.toReadableString());
-  }
-}

package/src/cmds/pxe/get_accounts.ts

@@ -1,35 +0,0 @@
-import { createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-export async function getAccounts(
-  rpcUrl: string,
-  json: boolean,
-  debugLogger: Logger,
-  log: LogFn,
-  logJson: (output: any) => void,
-) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const accounts = await client.getRegisteredAccounts();
-  if (!accounts.length) {
-    if (json) {
-      logJson([]);
-    } else {
-      log('No accounts found.');
-    }
-    return;
-  }
-  if (json) {
-    logJson(
-      accounts.map(a => ({
-        address: a.address.toString(),
-        publicKeys: a.publicKeys.toString(),
-        partialAddress: a.partialAddress.toString(),
-      })),
-    );
-  } else {
-    log(`Accounts found: \n`);
-    for (const account of accounts) {
-      log(account.toReadableString());
-    }
-  }
-}

package/src/cmds/pxe/get_block.ts

@@ -1,10 +0,0 @@
-import { createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-import { inspectBlock } from '../../utils/inspect.js';
-
-export async function getBlock(rpcUrl: string, maybeBlockNumber: number | undefined, debugLogger: Logger, log: LogFn) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const blockNumber = maybeBlockNumber ?? (await client.getBlockNumber());
-  await inspectBlock(client, blockNumber, log, { showTxs: true });
-}

package/src/cmds/pxe/get_contract_data.ts

@@ -1,51 +0,0 @@
-import type { AztecAddress } from '@aztec/aztec.js';
-import { createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-export async function getContractData(
-  rpcUrl: string,
-  contractAddress: AztecAddress,
-  includeBytecode: boolean,
-  debugLogger: Logger,
-  log: LogFn,
-) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const {
-    contractInstance: instance,
-    isContractInitialized: isInitialized,
-    isContractPublished: isPubliclyDeployed,
-  } = await client.getContractMetadata(contractAddress);
-  const contractClass =
-    includeBytecode &&
-    instance &&
-    (await client.getContractClassMetadata(instance?.currentContractClassId)).contractClass;
-
-  const isPrivatelyDeployed = !!instance;
-  const initStr = isInitialized ? 'initialized' : 'not initialized';
-  const addrStr = contractAddress.toString();
-
-  if (isPubliclyDeployed && isPrivatelyDeployed) {
-    log(`Contract is ${initStr} and publicly deployed at ${addrStr}`);
-  } else if (isPrivatelyDeployed) {
-    log(`Contract is ${initStr} and registered in the local pxe at ${addrStr} but not publicly deployed`);
-  } else if (isPubliclyDeployed) {
-    log(`Contract is ${initStr} and publicly deployed at ${addrStr} but not registered in the local pxe`);
-  } else if (isInitialized) {
-    log(`Contract is initialized but not publicly deployed nor registered in the local pxe at ${addrStr}`);
-  } else {
-    log(`No contract found at ${addrStr}`);
-  }
-
-  if (instance) {
-    log(``);
-    Object.entries(instance).forEach(([key, value]) => {
-      const capitalized = key.charAt(0).toUpperCase() + key.slice(1);
-      log(`${capitalized}: ${value.toString()}`);
-    });
-
-    if (contractClass) {
-      log(`\nBytecode: ${contractClass.packedBytecode.toString('base64')}`);
-    }
-    log('');
-  }
-}

package/src/cmds/pxe/get_current_base_fee.ts

@@ -1,9 +0,0 @@
-import { createCompatibleClient } from '@aztec/aztec.js';
-import { jsonStringify } from '@aztec/foundation/json-rpc';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-export async function getCurrentBaseFee(rpcUrl: string, debugLogger: Logger, log: LogFn) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const fees = await client.getCurrentBaseFees();
-  log(`Current fees: ${jsonStringify(fees)}`);
-}

package/src/cmds/pxe/get_l1_to_l2_message_witness.ts

@@ -1,25 +0,0 @@
-import { type AztecAddress, type Fr, createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-export async function getL1ToL2MessageWitness(
-  rpcUrl: string,
-  contractAddress: AztecAddress,
-  messageHash: Fr,
-  secret: Fr,
-  debugLogger: Logger,
-  log: LogFn,
-) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const messageWitness = await client.getL1ToL2MembershipWitness(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/pxe/get_pxe_info.ts

@@ -1,13 +0,0 @@
-import { createCompatibleClient } from '@aztec/aztec.js';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-export async function getPXEInfo(rpcUrl: string, debugLogger: Logger, log: LogFn) {
-  const client = await createCompatibleClient(rpcUrl, debugLogger);
-  const info = await client.getPXEInfo();
-  log(`PXE Version: ${info.pxeVersion}`);
-  log(`Protocol Contract Addresses:`);
-  log(` Class Registry: ${info.protocolContractAddresses.classRegistry.toString()}`);
-  log(` Fee Juice: ${info.protocolContractAddresses.feeJuice.toString()}`);
-  log(` Instance Deployer: ${info.protocolContractAddresses.instanceRegistry.toString()}`);
-  log(` Multi Call Entrypoint: ${info.protocolContractAddresses.multiCallEntrypoint.toString()}`);
-}

package/src/cmds/pxe/index.ts

@@ -1,170 +0,0 @@
-import { Fr } from '@aztec/foundation/fields';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-import type { Command } from 'commander';
-
-import {
-  logJson,
-  makePxeOption,
-  parseAztecAddress,
-  parseEthereumAddress,
-  parseField,
-  parseFieldFromHexString,
-  parseOptionalAztecAddress,
-  parseOptionalInteger,
-  parseOptionalLogId,
-  parseOptionalTxHash,
-  parsePublicKey,
-  pxeOption,
-} from '../../utils/commands.js';
-
-export function injectCommands(program: Command, log: LogFn, debugLogger: Logger) {
-  program
-    .command('add-contract')
-    .description(
-      'Adds an existing contract to the PXE. This is useful if you have deployed a contract outside of the PXE and want to use it with the PXE.',
-    )
-    .requiredOption(
-      '-c, --contract-artifact <fileLocation>',
-      "A compiled Aztec.nr contract's ABI in JSON format or name of a contract ABI exported by @aztec/noir-contracts.js",
-    )
-    .requiredOption('-ca, --contract-address <address>', 'Aztec address of the contract.', parseAztecAddress)
-    .requiredOption('--init-hash <init hash>', 'Initialization hash', parseFieldFromHexString)
-    .option('--salt <salt>', 'Optional deployment salt', parseFieldFromHexString)
-    .option('-p, --public-key <public key>', 'Optional public key for this contract', parsePublicKey)
-    .option('--portal-address <address>', 'Optional address to a portal contract on L1', parseEthereumAddress)
-    .option('--deployer-address <address>', 'Optional address of the contract deployer', parseAztecAddress)
-    .addOption(pxeOption)
-    .action(async options => {
-      const { addContract } = await import('./add_contract.js');
-      await addContract(
-        options.rpcUrl,
-        options.contractArtifact,
-        options.contractAddress,
-        options.initHash,
-        options.salt ?? Fr.ZERO,
-        options.publicKey,
-        options.deployerAddress,
-        debugLogger,
-        log,
-      );
-    });
-
-  program
-    .command('get-block')
-    .description('Gets info for a given block or latest.')
-    .argument('[blockNumber]', 'Block height', parseOptionalInteger)
-    .addOption(pxeOption)
-    .action(async (blockNumber, options) => {
-      const { getBlock } = await import('./get_block.js');
-      await getBlock(options.rpcUrl, blockNumber, debugLogger, log);
-    });
-
-  program
-    .command('get-current-base-fee')
-    .description('Gets the current base fee.')
-    .addOption(pxeOption)
-    .action(async options => {
-      const { getCurrentBaseFee } = await import('./get_current_base_fee.js');
-      await getCurrentBaseFee(options.rpcUrl, debugLogger, log);
-    });
-
-  program
-    .command('get-contract-data')
-    .description('Gets information about the Aztec contract deployed at the specified address.')
-    .argument('<contractAddress>', 'Aztec address of the contract.', parseAztecAddress)
-    .addOption(pxeOption)
-    .option('-b, --include-bytecode <boolean>', "Include the contract's public function bytecode, if any.", false)
-    .action(async (contractAddress, options) => {
-      const { getContractData } = await import('./get_contract_data.js');
-      await getContractData(options.rpcUrl, contractAddress, options.includeBytecode, debugLogger, log);
-    });
-
-  program
-    .command('get-logs')
-    .description('Gets all the public logs from an intersection of all the filter params.')
-    .option('-tx, --tx-hash <txHash>', 'A transaction hash to get the receipt for.', 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 <logId>', 'ID of a log after which to fetch the logs.', parseOptionalLogId)
-    .option('-ca, --contract-address <address>', 'Contract address to filter logs by.', parseOptionalAztecAddress)
-    .addOption(pxeOption)
-    .option('--follow', 'If set, will keep polling for new logs until interrupted.')
-    .action(async ({ txHash, fromBlock, toBlock, afterLog, contractAddress, rpcUrl, follow }) => {
-      const { getLogs } = await import('./get_logs.js');
-      await getLogs(txHash, fromBlock, toBlock, afterLog, contractAddress, rpcUrl, follow, debugLogger, log);
-    });
-
-  program
-    .command('get-accounts')
-    .description('Gets all the Aztec accounts stored in the PXE.')
-    .addOption(pxeOption)
-    .option('--json', 'Emit output as json')
-    .action(async (options: any) => {
-      const { getAccounts } = await import('./get_accounts.js');
-      await getAccounts(options.rpcUrl, options.json, debugLogger, log, logJson(log));
-    });
-
-  program
-    .command('get-account')
-    .description('Gets an account given its Aztec address.')
-    .argument('<address>', 'The Aztec address to get account for', parseAztecAddress)
-    .addOption(pxeOption)
-    .action(async (address, options) => {
-      const { getAccount } = await import('./get_account.js');
-      await getAccount(address, options.rpcUrl, debugLogger, log);
-    });
-
-  program
-    .command('block-number')
-    .description('Gets the current Aztec L2 block number.')
-    .addOption(pxeOption)
-    .action(async (options: any) => {
-      const { blockNumber } = await import('./block_number.js');
-      await blockNumber(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(pxeOption)
-    .action(async ({ contractAddress, messageHash, secret, rpcUrl }) => {
-      const { getL1ToL2MessageWitness } = await import('./get_l1_to_l2_message_witness.js');
-      await getL1ToL2MessageWitness(rpcUrl, contractAddress, messageHash, secret, debugLogger, log);
-    });
-
-  program
-    .command('get-node-info')
-    .description('Gets the information of an Aztec node from a PXE or directly from an Aztec node.')
-    .option('--node-url <string>', 'URL of the node.')
-    .option('--json', 'Emit output as json')
-    .addOption(makePxeOption(false))
-    .action(async options => {
-      const { getNodeInfo } = await import('./get_node_info.js');
-      let url: string;
-      if (options.nodeUrl) {
-        url = options.nodeUrl;
-      } else {
-        url = options.rpcUrl;
-      }
-      await getNodeInfo(url, !options.nodeUrl, debugLogger, options.json, log, logJson(log));
-    });
-
-  program
-    .command('get-pxe-info')
-    .description('Gets the information of a PXE at a URL.')
-    .addOption(pxeOption)
-    .action(async options => {
-      const { getPXEInfo } = await import('./get_pxe_info.js');
-      await getPXEInfo(options.rpcUrl, debugLogger, log);
-    });
-
-  return program;
-}