@aztec/cli 3.0.0-nightly.20250924 → 3.0.0-nightly.20250926

package/dest/cmds/pxe/index.js

@@ -1,25 +0,0 @@
-import { Fr } from '@aztec/foundation/fields';
-import { logJson, parseAztecAddress, parseEthereumAddress, parseFieldFromHexString, parsePublicKey, pxeOption } from '../../utils/commands.js';
-export function injectCommands(program, log, debugLogger) {
-    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-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-accounts').description('Gets all the Aztec accounts stored in the PXE.').addOption(pxeOption).option('--json', 'Emit output as json').action(async (options)=>{
-        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('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;
-}

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/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_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_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,88 +0,0 @@
-import { Fr } from '@aztec/foundation/fields';
-import type { LogFn, Logger } from '@aztec/foundation/log';
-
-import type { Command } from 'commander';
-
-import {
-  logJson,
-  parseAztecAddress,
-  parseEthereumAddress,
-  parseFieldFromHexString,
-  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-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-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('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;
-}