@aztec-labs/cli-wallet 6.0.0-nightly.20260829

package/src/cmds/deploy.ts

@@ -0,0 +1,157 @@
+import { NO_FROM } from '@aztec-labs/aztec.js/account';
+import type { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import type { DeployOptions } from '@aztec-labs/aztec.js/contracts';
+import { NO_WAIT } from '@aztec-labs/aztec.js/contracts';
+import { ContractDeployer } from '@aztec-labs/aztec.js/deployment';
+import { Fr } from '@aztec-labs/aztec.js/fields';
+import { type AztecNode, waitForTx } from '@aztec-labs/aztec.js/node';
+import { encodeArgs, getContractArtifact, prettyPrintJSON } from '@aztec-labs/cli/utils';
+import type { LogFn, Logger } from '@aztec-labs/foundation/log';
+import { getAllFunctionAbis, getInitializer } from '@aztec-labs/stdlib/abi';
+import { PublicKeys } from '@aztec-labs/stdlib/keys';
+import type { TxStatus } from '@aztec-labs/stdlib/tx';
+
+import { DEFAULT_TX_TIMEOUT_S } from '../utils/cli_wallet_and_node_wrapper.js';
+import { CLIFeeArgs } from '../utils/options/fees.js';
+import { printProfileResult } from '../utils/profiling.js';
+import type { CLIWallet } from '../utils/wallet.js';
+
+export async function deploy(
+  wallet: CLIWallet,
+  node: AztecNode,
+  deployer: AztecAddress,
+  artifactPath: string,
+  json: boolean,
+  publicKeys: PublicKeys | undefined,
+  rawArgs: any[],
+  salt: Fr | undefined,
+  initializer: string | undefined,
+  skipInstancePublication: boolean,
+  skipClassPublication: boolean,
+  skipInitialization: boolean | undefined,
+  wait: boolean,
+  feeOpts: CLIFeeArgs,
+  waitForStatus: TxStatus,
+  verbose: boolean,
+  timeout: number = DEFAULT_TX_TIMEOUT_S,
+  debugLogger: Logger,
+  log: LogFn,
+  universal?: boolean,
+) {
+  const out: Record<string, any> = {};
+  salt ??= Fr.random();
+  const contractArtifact = await getContractArtifact(artifactPath, log);
+  const hasInitializer = getAllFunctionAbis(contractArtifact).some(fn => fn.isInitializer);
+  const constructorArtifact = hasInitializer ? getInitializer(contractArtifact, initializer) : undefined;
+
+  // TODO(#12081): Add contractArtifact.noirVersion and check here (via Noir.lock)?
+
+  const contractDeployer = new ContractDeployer(contractArtifact, wallet, initializer);
+
+  let args = [];
+  if (rawArgs.length > 0) {
+    if (!constructorArtifact) {
+      throw new Error(`Cannot process constructor arguments as no constructor was found`);
+    }
+    debugLogger.debug(`Input arguments: ${rawArgs.map((x: any) => `"${x}"`).join(', ')}`);
+    args = encodeArgs(rawArgs, constructorArtifact!.parameters);
+    debugLogger.debug(`Encoded arguments: ${args.join(', ')}`);
+  }
+
+  const deployInteraction = contractDeployer.deploy(args, {
+    salt,
+    publicKeys: publicKeys ?? PublicKeys.default(),
+    ...(universal ? { universalDeploy: true as const } : {}),
+  });
+  const { paymentMethod, gasSettings } = await feeOpts.toUserFeeOptions(node, wallet, deployer);
+  const deployOpts: DeployOptions = {
+    fee: { gasSettings, paymentMethod },
+    from: deployer ?? NO_FROM,
+    skipClassPublication,
+    skipInitialization,
+    skipInstancePublication,
+  };
+
+  const localStart = performance.now();
+  const sim = await deployInteraction.simulate({
+    ...deployOpts,
+    includeMetadata: true,
+  });
+  // includeMetadata: true guarantees these fields are present
+  const estimatedGas = await wallet.estimateGasLimits(sim.gasUsed!);
+  const stats = sim.stats!;
+
+  if (feeOpts.estimateOnly) {
+    if (json) {
+      out.fee = {
+        gasLimits: {
+          da: estimatedGas.gasLimits.daGas,
+          l2: estimatedGas.gasLimits.l2Gas,
+        },
+        teardownGasLimits: {
+          da: estimatedGas.teardownGasLimits.daGas,
+          l2: estimatedGas.teardownGasLimits,
+        },
+      };
+    }
+  } else {
+    if (verbose) {
+      printProfileResult(stats, log);
+    }
+
+    const instance = await deployInteraction.getInstance();
+    const address = instance.address;
+    const partialAddress = await deployInteraction.getPartialAddress();
+
+    const { txHash } = await deployInteraction.send({ ...deployOpts, wait: NO_WAIT });
+    const localTimeMs = performance.now() - localStart;
+    debugLogger.debug(`Deploy tx sent with hash ${txHash.toString()}`);
+    out.hash = txHash;
+
+    if (wait) {
+      const nodeStart = performance.now();
+      const receipt = await waitForTx(node, txHash, { timeout, waitForStatus });
+      const nodeTimeMs = performance.now() - nodeStart;
+
+      if (!json) {
+        log(`Contract deployed at ${address.toString()}`);
+        log(`Contract partial address ${partialAddress.toString()}`);
+        log(`Contract init hash ${instance.initializationHash.toString()}`);
+        log(`Deployment tx hash: ${txHash.toString()}`);
+        log(`Deployment salt: ${salt.toString()}`);
+        log(`Deployer: ${instance.deployer.toString()}`);
+        log(`Transaction fee: ${receipt.transactionFee?.toString()}`);
+        log(` Local processing time: ${(localTimeMs / 1000).toFixed(1)}s`);
+        log(` Node inclusion time: ${(nodeTimeMs / 1000).toFixed(1)}s`);
+      } else {
+        out.contract = {
+          address: address.toString(),
+          partialAddress: partialAddress.toString(),
+          initializationHash: instance.initializationHash.toString(),
+          salt: salt.toString(),
+          transactionFee: receipt.transactionFee?.toString(),
+        };
+      }
+    } else {
+      if (!json) {
+        log(`Contract deployed at ${address.toString()}`);
+        log(`Contract partial address ${partialAddress.toString()}`);
+        log(`Contract init hash ${instance.initializationHash.toString()}`);
+        log(`Deployment tx hash: ${txHash.toString()}`);
+        log(`Deployment salt: ${salt.toString()}`);
+        log(`Deployer: ${instance.deployer.toString()}`);
+      } else {
+        out.contract = {
+          address: address.toString(),
+          partialAddress: partialAddress.toString(),
+          initializationHash: instance.initializationHash.toString(),
+          salt: salt.toString(),
+        };
+      }
+    }
+  }
+  if (json) {
+    log(prettyPrintJSON(out));
+  }
+  return await deployInteraction.getAddress();
+}

package/src/cmds/deploy_account.ts

@@ -0,0 +1,140 @@
+import { NO_FROM } from '@aztec-labs/aztec.js/account';
+import { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import { NO_WAIT } from '@aztec-labs/aztec.js/contracts';
+import { type AztecNode, waitForTx } from '@aztec-labs/aztec.js/node';
+import type { DeployAccountOptions } from '@aztec-labs/aztec.js/wallet';
+import { prettyPrintJSON } from '@aztec-labs/cli/cli-utils';
+import type { LogFn, Logger } from '@aztec-labs/foundation/log';
+import type { TxHash, TxReceipt, TxStatus } from '@aztec-labs/stdlib/tx';
+
+import { DEFAULT_TX_TIMEOUT_S } from '../utils/cli_wallet_and_node_wrapper.js';
+import type { CLIFeeArgs } from '../utils/options/fees.js';
+import { printProfileResult } from '../utils/profiling.js';
+import type { CLIWallet } from '../utils/wallet.js';
+
+export async function deployAccount(
+  wallet: CLIWallet,
+  aztecNode: AztecNode,
+  address: AztecAddress,
+  wait: boolean,
+  deployer: AztecAddress | undefined,
+  registerClass: boolean,
+  publicDeploy: boolean,
+  skipInitialization: boolean,
+  feeOpts: CLIFeeArgs,
+  waitForStatus: TxStatus,
+  json: boolean,
+  verbose: boolean,
+  debugLogger: Logger,
+  log: LogFn,
+) {
+  const out: Record<string, any> = {};
+
+  const account = await wallet.retrieveAccount(address);
+  const { partialAddress, publicKeys } = await account.getCompleteAddress();
+  const { initializationHash, salt } = account.getInstance();
+
+  if (json) {
+    out.address = address;
+    out.partialAddress = partialAddress;
+    out.salt = salt;
+    out.initHash = initializationHash;
+    out.deployer = deployer;
+  } else {
+    log(`\nNew account:\n`);
+    log(`Address:         ${address.toString()}`);
+    log(`Public key:      ${publicKeys.toString()}`);
+    log(`Partial address: ${partialAddress.toString()}`);
+    log(`Salt:            ${salt.toString()}`);
+    log(`Init hash:       ${initializationHash.toString()}`);
+  }
+
+  let txHash: TxHash | undefined;
+  let txReceipt: TxReceipt | undefined;
+  const { paymentMethod, gasSettings } = await feeOpts.toUserFeeOptions(aztecNode, wallet, address);
+
+  const delegatedDeployment = deployer && !account.address.equals(deployer);
+  const from = delegatedDeployment ? deployer : NO_FROM;
+
+  const deployAccountOpts: DeployAccountOptions = {
+    skipClassPublication: !registerClass,
+    skipInstancePublication: !publicDeploy,
+    skipInitialization,
+    from,
+    fee: { paymentMethod, gasSettings },
+  };
+
+  const localStart = performance.now();
+  const deployMethod = await account.getDeployMethod();
+  const sim = await deployMethod.simulate({
+    ...deployAccountOpts,
+    includeMetadata: true,
+  });
+  // includeMetadata: true guarantees these fields are present
+  const estimatedGas = await wallet.estimateGasLimits(sim.gasUsed!);
+  const stats = sim.stats!;
+
+  if (feeOpts.estimateOnly) {
+    if (json) {
+      out.fee = {
+        gasLimits: {
+          da: estimatedGas.gasLimits.daGas,
+          l2: estimatedGas.gasLimits.l2Gas,
+        },
+        teardownGasLimits: {
+          da: estimatedGas.teardownGasLimits.daGas,
+          l2: estimatedGas.teardownGasLimits,
+        },
+      };
+    }
+  } else {
+    if (verbose) {
+      printProfileResult(stats, log);
+    }
+
+    if (!json) {
+      log(`\nWaiting for account contract deployment...`);
+    }
+    const sendOpts = {
+      ...deployAccountOpts,
+      fee: deployAccountOpts.fee
+        ? {
+            ...deployAccountOpts.fee,
+            gasSettings: estimatedGas,
+          }
+        : undefined,
+    };
+
+    ({ txHash } = await deployMethod.send({ ...sendOpts, wait: NO_WAIT }));
+    const localTimeMs = performance.now() - localStart;
+
+    if (wait) {
+      const nodeStart = performance.now();
+      txReceipt = await waitForTx(aztecNode, txHash, { timeout: DEFAULT_TX_TIMEOUT_S, waitForStatus });
+      const nodeTimeMs = performance.now() - nodeStart;
+
+      out.txReceipt = {
+        status: txReceipt.status,
+        transactionFee: txReceipt.transactionFee,
+      };
+
+      if (!json) {
+        log(` Local processing time: ${(localTimeMs / 1000).toFixed(1)}s`);
+        log(` Node inclusion time: ${(nodeTimeMs / 1000).toFixed(1)}s`);
+      }
+    }
+    debugLogger.debug(`Account contract tx sent with hash ${txHash.toString()}`);
+    out.txHash = txHash;
+  }
+
+  if (json) {
+    log(prettyPrintJSON(out));
+  } else {
+    if (txHash) {
+      log(`Deploy tx hash:  ${txHash.toString()}`);
+    }
+    if (txReceipt) {
+      log(`Deploy tx fee:   ${txReceipt.transactionFee}`);
+    }
+  }
+}

package/src/cmds/get_fee_juice_balance.ts

@@ -0,0 +1,37 @@
+import type { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import type { AztecNode } from '@aztec-labs/aztec.js/node';
+import { getFeeJuiceBalance } from '@aztec-labs/aztec.js/utils';
+import { prettyPrintJSON } from '@aztec-labs/cli/cli-utils';
+import type { LogFn } from '@aztec-labs/foundation/log';
+
+const FEE_JUICE_DECIMALS = 18;
+const FEE_JUICE_UNIT = 10n ** BigInt(FEE_JUICE_DECIMALS);
+
+/** Formats a raw FeeJuice balance (18 decimals) for human-readable display. */
+function formatFeeJuice(raw: bigint, exact: boolean): string {
+  const whole = raw / FEE_JUICE_UNIT;
+  const fractional = raw % FEE_JUICE_UNIT;
+  const fracStr = fractional.toString().padStart(FEE_JUICE_DECIMALS, '0');
+  if (exact) {
+    return `${whole}.${fracStr} FJ`;
+  }
+  if (fractional === 0n) {
+    return `${whole} FJ`;
+  }
+  return `${whole}.${fracStr.replace(/0+$/, '')} FJ`;
+}
+
+export async function getFeeJuiceBalanceCmd(
+  node: AztecNode,
+  address: AztecAddress,
+  json: boolean,
+  exact: boolean,
+  log: LogFn,
+) {
+  const balance = await getFeeJuiceBalance(address, node);
+  if (json) {
+    log(prettyPrintJSON({ address: address.toString(), balance: balance.toString() }));
+  } else {
+    log(`Fee Juice balance for ${address.toString()}: ${formatFeeJuice(balance, exact)}`);
+  }
+}

package/src/cmds/import_test_accounts.ts

@@ -0,0 +1,54 @@
+import { getInitialTestAccountsData } from '@aztec-labs/accounts/testing';
+import { Fr } from '@aztec-labs/aztec.js/fields';
+import { prettyPrintJSON } from '@aztec-labs/cli/cli-utils';
+import type { LogFn } from '@aztec-labs/foundation/log';
+
+import type { WalletDB } from '../storage/wallet_db.js';
+import type { CLIWallet } from '../utils/wallet.js';
+
+export async function importTestAccounts(wallet: CLIWallet, db: WalletDB, json: boolean, log: LogFn) {
+  const testAccounts = await getInitialTestAccountsData();
+
+  const out: Record<string, any> = {};
+  await Promise.all(
+    testAccounts.map(async (account, i) => {
+      const alias = `test${i}`;
+      const secret = testAccounts[i].secret;
+      const salt = new Fr(account.salt);
+      const address = account.address;
+      await db.storeAccount(
+        address,
+        {
+          type: 'schnorr_initializerless',
+          signingKey: account.signingKey,
+          secretKey: secret,
+          salt,
+          alias,
+          publicKey: undefined,
+        },
+        log,
+      );
+
+      if (json) {
+        out[alias] = {
+          alias,
+          address,
+          secret,
+          salt,
+        };
+      } else {
+        log(`\nTest account:`);
+        log(`Alias:           ${alias}`);
+        log(`Address:         ${address}`);
+        log(`Secret key:      ${secret}`);
+        log(`Salt:            ${salt}`);
+      }
+    }),
+  );
+
+  if (json) {
+    log(prettyPrintJSON(out));
+  } else {
+    log(`\n${testAccounts.length} test accounts imported to wallet db.\n`);
+  }
+}