@aztec/cli-wallet 0.0.1-commit.dbf9cec → 0.0.1-commit.e0f15ab9b

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/dest/cmds/authorize_action.d.ts +2 -2
  2. package/dest/cmds/authorize_action.d.ts.map +1 -1
  3. package/dest/cmds/check_tx.d.ts +1 -1
  4. package/dest/cmds/check_tx.d.ts.map +1 -1
  5. package/dest/cmds/check_tx.js +34 -8
  6. package/dest/cmds/create_account.d.ts +4 -3
  7. package/dest/cmds/create_account.d.ts.map +1 -1
  8. package/dest/cmds/create_account.js +32 -21
  9. package/dest/cmds/deploy.d.ts +4 -3
  10. package/dest/cmds/deploy.d.ts.map +1 -1
  11. package/dest/cmds/deploy.js +27 -23
  12. package/dest/cmds/deploy_account.d.ts +4 -3
  13. package/dest/cmds/deploy_account.d.ts.map +1 -1
  14. package/dest/cmds/deploy_account.js +27 -16
  15. package/dest/cmds/get_fee_juice_balance.d.ts +5 -0
  16. package/dest/cmds/get_fee_juice_balance.d.ts.map +1 -0
  17. package/dest/cmds/get_fee_juice_balance.js +27 -0
  18. package/dest/cmds/index.d.ts +1 -1
  19. package/dest/cmds/index.d.ts.map +1 -1
  20. package/dest/cmds/index.js +30 -14
  21. package/dest/cmds/send.d.ts +4 -3
  22. package/dest/cmds/send.d.ts.map +1 -1
  23. package/dest/cmds/send.js +27 -23
  24. package/dest/utils/options/fees.d.ts +1 -1
  25. package/dest/utils/options/fees.d.ts.map +1 -1
  26. package/dest/utils/options/fees.js +2 -0
  27. package/dest/utils/wallet.d.ts +5 -5
  28. package/dest/utils/wallet.d.ts.map +1 -1
  29. package/dest/utils/wallet.js +29 -28
  30. package/package.json +14 -14
  31. package/src/cmds/check_tx.ts +40 -9
  32. package/src/cmds/create_account.ts +32 -18
  33. package/src/cmds/deploy.ts +24 -15
  34. package/src/cmds/deploy_account.ts +26 -13
  35. package/src/cmds/get_fee_juice_balance.ts +37 -0
  36. package/src/cmds/index.ts +56 -3
  37. package/src/cmds/send.ts +24 -16
  38. package/src/cmds/simulate.ts +1 -1
  39. package/src/utils/options/fees.ts +6 -0
  40. package/src/utils/wallet.ts +38 -48
@@ -1,11 +1,12 @@
1
+ import { NO_FROM } from '@aztec/aztec.js/account';
1
2
  import { AztecAddress } from '@aztec/aztec.js/addresses';
2
3
  import { NO_WAIT } from '@aztec/aztec.js/contracts';
3
- import type { AztecNode } from '@aztec/aztec.js/node';
4
+ import { type AztecNode, waitForTx } from '@aztec/aztec.js/node';
4
5
  import type { DeployAccountOptions } from '@aztec/aztec.js/wallet';
5
6
  import { prettyPrintJSON } from '@aztec/cli/cli-utils';
6
7
  import { Fr } from '@aztec/foundation/curves/bn254';
7
8
  import type { LogFn, Logger } from '@aztec/foundation/log';
8
- import type { TxHash, TxReceipt } from '@aztec/stdlib/tx';
9
+ import { type TxHash, type TxReceipt, TxStatus } from '@aztec/stdlib/tx';
9
10
 
10
11
  import { DEFAULT_TX_TIMEOUT_S } from '../utils/cli_wallet_and_node_wrapper.js';
11
12
  import type { AccountType } from '../utils/constants.js';
@@ -18,6 +19,7 @@ export async function createAccount(
18
19
  aztecNode: AztecNode,
19
20
  accountType: AccountType,
20
21
  secretKey: Fr | undefined,
22
+ salt: Fr | undefined,
21
23
  publicKey: string | undefined,
22
24
  alias: string | undefined,
23
25
  deployer: AztecAddress | undefined,
@@ -27,6 +29,7 @@ export async function createAccount(
27
29
  registerClass: boolean,
28
30
  wait: boolean,
29
31
  feeOpts: CLIFeeArgs,
32
+ waitForStatus: TxStatus,
30
33
  json: boolean,
31
34
  verbose: boolean,
32
35
  debugLogger: Logger,
@@ -38,10 +41,10 @@ export async function createAccount(
38
41
  undefined /* address, we don't have it yet */,
39
42
  secretKey,
40
43
  accountType,
41
- Fr.ZERO,
44
+ salt,
42
45
  publicKey,
43
46
  );
44
- const { salt } = account.getInstance();
47
+ const instanceSalt = account.getInstance().salt;
45
48
  const { address, publicKeys, partialAddress } = await account.getCompleteAddress();
46
49
 
47
50
  const out: Record<string, any> = {};
@@ -52,7 +55,7 @@ export async function createAccount(
52
55
  out.secretKey = secretKey;
53
56
  }
54
57
  out.partialAddress = partialAddress;
55
- out.salt = salt;
58
+ out.salt = instanceSalt;
56
59
  out.initHash = account.getInstance().initializationHash;
57
60
  } else {
58
61
  log(`\nNew account:\n`);
@@ -62,7 +65,7 @@ export async function createAccount(
62
65
  log(`Secret key: ${secretKey.toString()}`);
63
66
  }
64
67
  log(`Partial address: ${partialAddress.toString()}`);
65
- log(`Salt: ${salt.toString()}`);
68
+ log(`Salt: ${instanceSalt.toString()}`);
66
69
  log(`Init hash: ${account.getInstance().initializationHash.toString()}`);
67
70
  }
68
71
 
@@ -72,7 +75,7 @@ export async function createAccount(
72
75
  const { paymentMethod, gasSettings } = await feeOpts.toUserFeeOptions(aztecNode, wallet, address);
73
76
 
74
77
  const delegatedDeployment = deployer && !account.address.equals(deployer);
75
- const from = delegatedDeployment ? deployer : AztecAddress.ZERO;
78
+ const from = delegatedDeployment ? deployer : NO_FROM;
76
79
 
77
80
  const deployAccountOpts: DeployAccountOptions = {
78
81
  skipClassPublication: !registerClass,
@@ -82,11 +85,15 @@ export async function createAccount(
82
85
  fee: { paymentMethod, gasSettings },
83
86
  };
84
87
 
88
+ const localStart = performance.now();
85
89
  const deployMethod = await account.getDeployMethod();
86
- const { estimatedGas, stats } = await deployMethod.simulate({
90
+ const sim = await deployMethod.simulate({
87
91
  ...deployAccountOpts,
88
92
  fee: { ...deployAccountOpts.fee, estimateGas: true },
89
93
  });
94
+ // estimateGas: true guarantees these fields are present
95
+ const estimatedGas = sim.estimatedGas!;
96
+ const stats = sim.stats!;
90
97
 
91
98
  if (feeOpts.estimateOnly) {
92
99
  if (json) {
@@ -109,7 +116,7 @@ export async function createAccount(
109
116
  if (!json) {
110
117
  log(`\nWaiting for account contract deployment...`);
111
118
  }
112
- const result = await deployMethod.send({
119
+ const sendOpts = {
113
120
  ...deployAccountOpts,
114
121
  fee: deployAccountOpts.fee
115
122
  ? {
@@ -117,18 +124,25 @@ export async function createAccount(
117
124
  gasSettings: estimatedGas,
118
125
  }
119
126
  : undefined,
120
- wait: wait ? { timeout: DEFAULT_TX_TIMEOUT_S, returnReceipt: true } : NO_WAIT,
121
- });
122
- const isReceipt = (data: TxReceipt | TxHash): data is TxReceipt => 'txHash' in data;
123
- if (isReceipt(result)) {
124
- txReceipt = result;
125
- txHash = result.txHash;
127
+ };
128
+
129
+ ({ txHash } = await deployMethod.send({ ...sendOpts, wait: NO_WAIT }));
130
+ const localTimeMs = performance.now() - localStart;
131
+
132
+ if (wait) {
133
+ const nodeStart = performance.now();
134
+ txReceipt = await waitForTx(aztecNode, txHash, { timeout: DEFAULT_TX_TIMEOUT_S, waitForStatus });
135
+ const nodeTimeMs = performance.now() - nodeStart;
136
+
126
137
  out.txReceipt = {
127
138
  status: txReceipt.status,
128
139
  transactionFee: txReceipt.transactionFee,
129
140
  };
130
- } else {
131
- txHash = result;
141
+
142
+ if (!json) {
143
+ log(` Local processing time: ${(localTimeMs / 1000).toFixed(1)}s`);
144
+ log(` Node inclusion time: ${(nodeTimeMs / 1000).toFixed(1)}s`);
145
+ }
132
146
  }
133
147
  debugLogger.debug(`Account contract tx sent with hash ${txHash.toString()}`);
134
148
  out.txHash = txHash;
@@ -146,5 +160,5 @@ export async function createAccount(
146
160
  }
147
161
  }
148
162
 
149
- return { alias, address, secretKey, salt };
163
+ return { alias, address, secretKey, salt: instanceSalt };
150
164
  }
@@ -1,13 +1,15 @@
1
+ import { NO_FROM } from '@aztec/aztec.js/account';
1
2
  import { AztecAddress } from '@aztec/aztec.js/addresses';
2
3
  import type { DeployOptions } from '@aztec/aztec.js/contracts';
3
4
  import { NO_WAIT } from '@aztec/aztec.js/contracts';
4
5
  import { ContractDeployer } from '@aztec/aztec.js/deployment';
5
6
  import { Fr } from '@aztec/aztec.js/fields';
6
- import type { AztecNode } from '@aztec/aztec.js/node';
7
+ import { type AztecNode, waitForTx } from '@aztec/aztec.js/node';
7
8
  import { encodeArgs, getContractArtifact, prettyPrintJSON } from '@aztec/cli/utils';
8
9
  import type { LogFn, Logger } from '@aztec/foundation/log';
9
10
  import { getAllFunctionAbis, getInitializer } from '@aztec/stdlib/abi';
10
11
  import { PublicKeys } from '@aztec/stdlib/keys';
12
+ import type { TxStatus } from '@aztec/stdlib/tx';
11
13
 
12
14
  import { DEFAULT_TX_TIMEOUT_S } from '../utils/cli_wallet_and_node_wrapper.js';
13
15
  import { CLIFeeArgs } from '../utils/options/fees.js';
@@ -29,6 +31,7 @@ export async function deploy(
29
31
  skipInitialization: boolean | undefined,
30
32
  wait: boolean,
31
33
  feeOpts: CLIFeeArgs,
34
+ waitForStatus: TxStatus,
32
35
  verbose: boolean,
33
36
  timeout: number = DEFAULT_TX_TIMEOUT_S,
34
37
  debugLogger: Logger,
@@ -59,11 +62,11 @@ export async function deploy(
59
62
  debugLogger.debug(`Encoded arguments: ${args.join(', ')}`);
60
63
  }
61
64
 
62
- const deploy = contractDeployer.deploy(...args);
65
+ const deployInteraction = contractDeployer.deploy(...args);
63
66
  const { paymentMethod, gasSettings } = await feeOpts.toUserFeeOptions(node, wallet, deployer);
64
67
  const deployOpts: DeployOptions = {
65
68
  fee: { gasSettings, paymentMethod },
66
- from: deployer ?? AztecAddress.ZERO,
69
+ from: deployer ?? NO_FROM,
67
70
  contractAddressSalt: salt,
68
71
  universalDeploy: !deployer,
69
72
  skipClassPublication,
@@ -71,10 +74,14 @@ export async function deploy(
71
74
  skipInstancePublication,
72
75
  };
73
76
 
74
- const { estimatedGas, stats } = await deploy.simulate({
77
+ const localStart = performance.now();
78
+ const sim = await deployInteraction.simulate({
75
79
  ...deployOpts,
76
80
  fee: { ...deployOpts.fee, estimateGas: true },
77
81
  });
82
+ // estimateGas: true guarantees these fields are present
83
+ const estimatedGas = sim.estimatedGas!;
84
+ const stats = sim.stats!;
78
85
 
79
86
  if (feeOpts.estimateOnly) {
80
87
  if (json) {
@@ -94,14 +101,18 @@ export async function deploy(
94
101
  printProfileResult(stats, log);
95
102
  }
96
103
 
97
- const { address, partialAddress } = deploy;
98
- const instance = await deploy.getInstance();
104
+ const { address, partialAddress } = deployInteraction;
105
+ const instance = await deployInteraction.getInstance();
106
+
107
+ const { txHash } = await deployInteraction.send({ ...deployOpts, wait: NO_WAIT });
108
+ const localTimeMs = performance.now() - localStart;
109
+ debugLogger.debug(`Deploy tx sent with hash ${txHash.toString()}`);
110
+ out.hash = txHash;
99
111
 
100
112
  if (wait) {
101
- const receipt = await deploy.send({ ...deployOpts, wait: { timeout, returnReceipt: true } });
102
- const txHash = receipt.txHash;
103
- debugLogger.debug(`Deploy tx sent with hash ${txHash.toString()}`);
104
- out.hash = txHash;
113
+ const nodeStart = performance.now();
114
+ const receipt = await waitForTx(node, txHash, { timeout, waitForStatus });
115
+ const nodeTimeMs = performance.now() - nodeStart;
105
116
 
106
117
  if (!json) {
107
118
  log(`Contract deployed at ${address?.toString()}`);
@@ -111,6 +122,8 @@ export async function deploy(
111
122
  log(`Deployment salt: ${salt.toString()}`);
112
123
  log(`Deployer: ${instance.deployer.toString()}`);
113
124
  log(`Transaction fee: ${receipt.transactionFee?.toString()}`);
125
+ log(` Local processing time: ${(localTimeMs / 1000).toFixed(1)}s`);
126
+ log(` Node inclusion time: ${(nodeTimeMs / 1000).toFixed(1)}s`);
114
127
  } else {
115
128
  out.contract = {
116
129
  address: address?.toString(),
@@ -121,10 +134,6 @@ export async function deploy(
121
134
  };
122
135
  }
123
136
  } else {
124
- const txHash = await deploy.send({ ...deployOpts, wait: NO_WAIT });
125
- debugLogger.debug(`Deploy tx sent with hash ${txHash.toString()}`);
126
- out.hash = txHash;
127
-
128
137
  if (!json) {
129
138
  log(`Contract deployed at ${address?.toString()}`);
130
139
  log(`Contract partial address ${(await partialAddress)?.toString()}`);
@@ -145,5 +154,5 @@ export async function deploy(
145
154
  if (json) {
146
155
  log(prettyPrintJSON(out));
147
156
  }
148
- return deploy.address;
157
+ return deployInteraction.address;
149
158
  }
@@ -1,10 +1,11 @@
1
+ import { NO_FROM } from '@aztec/aztec.js/account';
1
2
  import { AztecAddress } from '@aztec/aztec.js/addresses';
2
3
  import { NO_WAIT } from '@aztec/aztec.js/contracts';
3
- import type { AztecNode } from '@aztec/aztec.js/node';
4
+ import { type AztecNode, waitForTx } from '@aztec/aztec.js/node';
4
5
  import type { DeployAccountOptions } from '@aztec/aztec.js/wallet';
5
6
  import { prettyPrintJSON } from '@aztec/cli/cli-utils';
6
7
  import type { LogFn, Logger } from '@aztec/foundation/log';
7
- import type { TxHash, TxReceipt } from '@aztec/stdlib/tx';
8
+ import type { TxHash, TxReceipt, TxStatus } from '@aztec/stdlib/tx';
8
9
 
9
10
  import { DEFAULT_TX_TIMEOUT_S } from '../utils/cli_wallet_and_node_wrapper.js';
10
11
  import type { CLIFeeArgs } from '../utils/options/fees.js';
@@ -21,6 +22,7 @@ export async function deployAccount(
21
22
  publicDeploy: boolean,
22
23
  skipInitialization: boolean,
23
24
  feeOpts: CLIFeeArgs,
25
+ waitForStatus: TxStatus,
24
26
  json: boolean,
25
27
  verbose: boolean,
26
28
  debugLogger: Logger,
@@ -52,7 +54,7 @@ export async function deployAccount(
52
54
  const { paymentMethod, gasSettings } = await feeOpts.toUserFeeOptions(aztecNode, wallet, address);
53
55
 
54
56
  const delegatedDeployment = deployer && !account.address.equals(deployer);
55
- const from = delegatedDeployment ? deployer : AztecAddress.ZERO;
57
+ const from = delegatedDeployment ? deployer : NO_FROM;
56
58
 
57
59
  const deployAccountOpts: DeployAccountOptions = {
58
60
  skipClassPublication: !registerClass,
@@ -62,11 +64,15 @@ export async function deployAccount(
62
64
  fee: { paymentMethod, gasSettings },
63
65
  };
64
66
 
67
+ const localStart = performance.now();
65
68
  const deployMethod = await account.getDeployMethod();
66
- const { estimatedGas, stats } = await deployMethod.simulate({
69
+ const sim = await deployMethod.simulate({
67
70
  ...deployAccountOpts,
68
71
  fee: { ...deployAccountOpts.fee, estimateGas: true },
69
72
  });
73
+ // estimateGas: true guarantees these fields are present
74
+ const estimatedGas = sim.estimatedGas!;
75
+ const stats = sim.stats!;
70
76
 
71
77
  if (feeOpts.estimateOnly) {
72
78
  if (json) {
@@ -89,7 +95,7 @@ export async function deployAccount(
89
95
  if (!json) {
90
96
  log(`\nWaiting for account contract deployment...`);
91
97
  }
92
- const result = await deployMethod.send({
98
+ const sendOpts = {
93
99
  ...deployAccountOpts,
94
100
  fee: deployAccountOpts.fee
95
101
  ? {
@@ -97,18 +103,25 @@ export async function deployAccount(
97
103
  gasSettings: estimatedGas,
98
104
  }
99
105
  : undefined,
100
- wait: wait ? { timeout: DEFAULT_TX_TIMEOUT_S, returnReceipt: true } : NO_WAIT,
101
- });
102
- const isReceipt = (data: TxReceipt | TxHash): data is TxReceipt => 'txHash' in data;
103
- if (isReceipt(result)) {
104
- txReceipt = result;
105
- txHash = result.txHash;
106
+ };
107
+
108
+ ({ txHash } = await deployMethod.send({ ...sendOpts, wait: NO_WAIT }));
109
+ const localTimeMs = performance.now() - localStart;
110
+
111
+ if (wait) {
112
+ const nodeStart = performance.now();
113
+ txReceipt = await waitForTx(aztecNode, txHash, { timeout: DEFAULT_TX_TIMEOUT_S, waitForStatus });
114
+ const nodeTimeMs = performance.now() - nodeStart;
115
+
106
116
  out.txReceipt = {
107
117
  status: txReceipt.status,
108
118
  transactionFee: txReceipt.transactionFee,
109
119
  };
110
- } else {
111
- txHash = result;
120
+
121
+ if (!json) {
122
+ log(` Local processing time: ${(localTimeMs / 1000).toFixed(1)}s`);
123
+ log(` Node inclusion time: ${(nodeTimeMs / 1000).toFixed(1)}s`);
124
+ }
112
125
  }
113
126
  debugLogger.debug(`Account contract tx sent with hash ${txHash.toString()}`);
114
127
  out.txHash = txHash;
@@ -0,0 +1,37 @@
1
+ import type { AztecAddress } from '@aztec/aztec.js/addresses';
2
+ import type { AztecNode } from '@aztec/aztec.js/node';
3
+ import { getFeeJuiceBalance } from '@aztec/aztec.js/utils';
4
+ import { prettyPrintJSON } from '@aztec/cli/cli-utils';
5
+ import type { LogFn } from '@aztec/foundation/log';
6
+
7
+ const FEE_JUICE_DECIMALS = 18;
8
+ const FEE_JUICE_UNIT = 10n ** BigInt(FEE_JUICE_DECIMALS);
9
+
10
+ /** Formats a raw FeeJuice balance (18 decimals) for human-readable display. */
11
+ function formatFeeJuice(raw: bigint, exact: boolean): string {
12
+ const whole = raw / FEE_JUICE_UNIT;
13
+ const fractional = raw % FEE_JUICE_UNIT;
14
+ const fracStr = fractional.toString().padStart(FEE_JUICE_DECIMALS, '0');
15
+ if (exact) {
16
+ return `${whole}.${fracStr} FJ`;
17
+ }
18
+ if (fractional === 0n) {
19
+ return `${whole} FJ`;
20
+ }
21
+ return `${whole}.${fracStr.replace(/0+$/, '')} FJ`;
22
+ }
23
+
24
+ export async function getFeeJuiceBalanceCmd(
25
+ node: AztecNode,
26
+ address: AztecAddress,
27
+ json: boolean,
28
+ exact: boolean,
29
+ log: LogFn,
30
+ ) {
31
+ const balance = await getFeeJuiceBalance(address, node);
32
+ if (json) {
33
+ log(prettyPrintJSON({ address: address.toString(), balance: balance.toString() }));
34
+ } else {
35
+ log(`Fee Juice balance for ${address.toString()}: ${formatFeeJuice(balance, exact)}`);
36
+ }
37
+ }
package/src/cmds/index.ts CHANGED
@@ -12,6 +12,7 @@ import {
12
12
  } from '@aztec/cli/utils';
13
13
  import { randomBytes } from '@aztec/foundation/crypto/random';
14
14
  import type { LogFn, Logger } from '@aztec/foundation/log';
15
+ import { TxStatus } from '@aztec/stdlib/tx';
15
16
 
16
17
  import { type Command, Option } from 'commander';
17
18
  import inquirer from 'inquirer';
@@ -40,6 +41,17 @@ import {
40
41
  integerArgParser,
41
42
  } from '../utils/options/index.js';
42
43
 
44
+ function parseWaitForStatus(status: string): TxStatus {
45
+ switch (status) {
46
+ case 'proposed':
47
+ return TxStatus.PROPOSED;
48
+ case 'checkpointed':
49
+ return TxStatus.CHECKPOINTED;
50
+ default:
51
+ throw new Error(`Invalid wait-for-status: ${status}. Use 'proposed' or 'checkpointed'.`);
52
+ }
53
+ }
54
+
43
55
  // TODO: This function is only used in 1 place so we could just inline this
44
56
  export function injectCommands(
45
57
  program: Command,
@@ -90,6 +102,11 @@ export function injectCommands(
90
102
  )
91
103
  .addOption(createAliasOption('Alias for the account. Used for easy reference in subsequent commands.', !db))
92
104
  .addOption(createTypeOption(true))
105
+ .option(
106
+ '-s, --salt <hex string>',
107
+ 'Optional deployment salt as a hex string for generating the deployment address. Defaults to 0.',
108
+ parseFieldFromHexString,
109
+ )
93
110
  .option(
94
111
  '--register-only',
95
112
  'Just register the account on the Wallet. Do not deploy or initialize the account contract.',
@@ -98,6 +115,7 @@ export function injectCommands(
98
115
  // `options.wait` is default true. Passing `--no-wait` will set it to false.
99
116
  // https://github.com/tj/commander.js#other-option-types-negatable-boolean-and-booleanvalue
100
117
  .option('--no-wait', 'Skip waiting for the contract to be deployed. Print the hash of deployment transaction')
118
+ .option('--wait-for-status <status>', "Tx status to wait for: 'proposed' or 'checkpointed'", 'proposed')
101
119
  .addOption(createVerboseOption());
102
120
 
103
121
  addOptions(createAccountCommand, CLIFeeArgs.getOptions()).action(async (_options, command) => {
@@ -107,7 +125,9 @@ export function injectCommands(
107
125
  type,
108
126
  from: parsedFromAddress,
109
127
  secretKey,
128
+ salt,
110
129
  wait,
130
+ waitForStatus: waitForStatusStr,
111
131
  registerOnly,
112
132
  skipInitialization,
113
133
  publicDeploy,
@@ -137,6 +157,7 @@ export function injectCommands(
137
157
  node,
138
158
  type,
139
159
  secretKey,
160
+ salt,
140
161
  publicKey,
141
162
  alias,
142
163
  parsedFromAddress,
@@ -146,6 +167,7 @@ export function injectCommands(
146
167
  registerClass,
147
168
  wait,
148
169
  CLIFeeArgs.parse(options, log, db),
170
+ parseWaitForStatus(waitForStatusStr),
149
171
  json,
150
172
  verbose,
151
173
  debugLogger,
@@ -180,12 +202,22 @@ export function injectCommands(
180
202
  '--skip-initialization',
181
203
  'Skip initializing the account contract. Useful for publicly deploying an existing account.',
182
204
  )
205
+ .option('--wait-for-status <status>', "Tx status to wait for: 'proposed' or 'checkpointed'", 'proposed')
183
206
  .addOption(createVerboseOption());
184
207
 
185
208
  addOptions(deployAccountCommand, CLIFeeArgs.getOptions()).action(async (parsedAccount, _options, command) => {
186
209
  const { deployAccount } = await import('./deploy_account.js');
187
210
  const options = command.optsWithGlobals();
188
- const { wait, from: parsedFromAddress, json, registerClass, skipInitialization, publicDeploy, verbose } = options;
211
+ const {
212
+ wait,
213
+ waitForStatus: waitForStatusStr,
214
+ from: parsedFromAddress,
215
+ json,
216
+ registerClass,
217
+ skipInitialization,
218
+ publicDeploy,
219
+ verbose,
220
+ } = options;
189
221
 
190
222
  const { wallet, node } = walletAndNodeWrapper;
191
223
 
@@ -199,6 +231,7 @@ export function injectCommands(
199
231
  publicDeploy,
200
232
  skipInitialization,
201
233
  CLIFeeArgs.parse(options, log, db),
234
+ parseWaitForStatus(waitForStatusStr),
202
235
  json,
203
236
  verbose,
204
237
  debugLogger,
@@ -219,7 +252,7 @@ export function injectCommands(
219
252
  )
220
253
  .option(
221
254
  '-s, --salt <hex string>',
222
- 'Optional deployment salt as a hex string for generating the deployment address.',
255
+ 'Optional deployment salt as a hex string for generating the deployment address. Defaults to random.',
223
256
  parseFieldFromHexString,
224
257
  )
225
258
  .option('--universal', 'Do not mix the sender address into the deployment.')
@@ -238,6 +271,7 @@ export function injectCommands(
238
271
  'The amount of time in seconds to wait for the deployment to post to L2',
239
272
  ).conflicts('wait'),
240
273
  )
274
+ .option('--wait-for-status <status>', "Tx status to wait for: 'proposed' or 'checkpointed'", 'proposed')
241
275
  .addOption(createVerboseOption());
242
276
 
243
277
  addOptions(deployCommand, CLIFeeArgs.getOptions()).action(async (artifactPathPromise, _options, command) => {
@@ -249,6 +283,7 @@ export function injectCommands(
249
283
  args,
250
284
  salt,
251
285
  wait,
286
+ waitForStatus: waitForStatusStr,
252
287
  classRegistration,
253
288
  init,
254
289
  publicDeployment,
@@ -279,8 +314,9 @@ export function injectCommands(
279
314
  typeof init === 'string' ? false : init,
280
315
  wait,
281
316
  CLIFeeArgs.parse(options, log, db),
282
- timeout,
317
+ parseWaitForStatus(waitForStatusStr),
283
318
  verbose,
319
+ timeout,
284
320
  debugLogger,
285
321
  log,
286
322
  );
@@ -308,6 +344,7 @@ export function injectCommands(
308
344
  )
309
345
  .addOption(createAccountOption('Alias or address of the account to send the transaction from', !db, db))
310
346
  .option('--no-wait', 'Print transaction hash without waiting for it to be mined')
347
+ .option('--wait-for-status <status>', "Tx status to wait for: 'proposed' or 'checkpointed'", 'proposed')
311
348
  .addOption(createVerboseOption());
312
349
 
313
350
  addOptions(sendCommand, CLIFeeArgs.getOptions()).action(async (functionName, _options, command) => {
@@ -319,6 +356,7 @@ export function injectCommands(
319
356
  contractAddress,
320
357
  from: parsedFromAddress,
321
358
  wait,
359
+ waitForStatus: waitForStatusStr,
322
360
  alias,
323
361
  authWitness: authWitnessArray,
324
362
  verbose,
@@ -342,6 +380,7 @@ export function injectCommands(
342
380
  alias,
343
381
  CLIFeeArgs.parse(options, log, db),
344
382
  authWitnesses,
383
+ parseWaitForStatus(waitForStatusStr),
345
384
  verbose,
346
385
  log,
347
386
  );
@@ -492,6 +531,20 @@ export function injectCommands(
492
531
  }
493
532
  });
494
533
 
534
+ program
535
+ .command('get-fee-juice-balance')
536
+ .description('Checks the Fee Juice balance for a given address.')
537
+ .argument('<address>', 'Aztec address or alias to check balance for', address =>
538
+ aliasedAddressParser('accounts', address, db),
539
+ )
540
+ .option('--json', 'Emit output as json')
541
+ .option('--exact', 'Show exact balance with all 18 decimal places')
542
+ .action(async (address, options) => {
543
+ const { getFeeJuiceBalanceCmd } = await import('./get_fee_juice_balance.js');
544
+ const { json, exact } = options;
545
+ await getFeeJuiceBalanceCmd(walletAndNodeWrapper.node, address, json, exact, log);
546
+ });
547
+
495
548
  program
496
549
  .command('create-authwit')
497
550
  .description(
package/src/cmds/send.ts CHANGED
@@ -1,9 +1,10 @@
1
1
  import type { AztecAddress } from '@aztec/aztec.js/addresses';
2
2
  import { AuthWitness } from '@aztec/aztec.js/authorization';
3
3
  import { Contract, NO_WAIT, type SendInteractionOptions } from '@aztec/aztec.js/contracts';
4
- import type { AztecNode } from '@aztec/aztec.js/node';
4
+ import { type AztecNode, waitForTx } from '@aztec/aztec.js/node';
5
5
  import { prepTx } from '@aztec/cli/utils';
6
6
  import type { LogFn } from '@aztec/foundation/log';
7
+ import { TxStatus } from '@aztec/stdlib/tx';
7
8
 
8
9
  import { DEFAULT_TX_TIMEOUT_S } from '../utils/cli_wallet_and_node_wrapper.js';
9
10
  import { CLIFeeArgs } from '../utils/options/fees.js';
@@ -22,6 +23,7 @@ export async function send(
22
23
  cancellable: boolean,
23
24
  feeOpts: CLIFeeArgs,
24
25
  authWitnesses: AuthWitness[],
26
+ waitForStatus: TxStatus,
25
27
  verbose: boolean,
26
28
  log: LogFn,
27
29
  ) {
@@ -37,10 +39,14 @@ export async function send(
37
39
  authWitnesses,
38
40
  };
39
41
 
40
- const { estimatedGas, stats } = await call.simulate({
42
+ const localStart = performance.now();
43
+ const sim = await call.simulate({
41
44
  ...sendOptions,
42
45
  fee: { ...sendOptions.fee, estimateGas: true },
43
46
  });
47
+ // estimateGas: true guarantees these fields are present
48
+ const estimatedGas = sim.estimatedGas!;
49
+ const stats = sim.stats!;
44
50
 
45
51
  if (feeOpts.estimateOnly) {
46
52
  return;
@@ -50,21 +56,29 @@ export async function send(
50
56
  printProfileResult(stats!, log);
51
57
  }
52
58
 
59
+ const { txHash } = await call.send({
60
+ ...sendOptions,
61
+ fee: { ...sendOptions.fee, gasSettings: estimatedGas },
62
+ wait: NO_WAIT,
63
+ });
64
+ const localTimeMs = performance.now() - localStart;
65
+
66
+ log(`\nTransaction hash: ${txHash.toString()}`);
67
+
53
68
  if (wait) {
54
69
  try {
55
- const receipt = await call.send({
56
- ...sendOptions,
57
- fee: { ...sendOptions.fee, gasSettings: estimatedGas },
58
- wait: { timeout: DEFAULT_TX_TIMEOUT_S },
59
- });
70
+ const nodeStart = performance.now();
71
+ const receipt = await waitForTx(node, txHash, { timeout: DEFAULT_TX_TIMEOUT_S, waitForStatus });
72
+ const nodeTimeMs = performance.now() - nodeStart;
60
73
 
61
- const txHash = receipt.txHash;
62
- log(`\nTransaction hash: ${txHash.toString()}`);
63
- log('Transaction has been mined');
74
+ const statusLabel = waitForStatus === TxStatus.PROPOSED ? 'proposed' : 'checkpointed';
75
+ log(`Transaction has been ${statusLabel}`);
64
76
  log(` Tx fee: ${receipt.transactionFee}`);
65
77
  log(` Status: ${receipt.status}`);
66
78
  log(` Block number: ${receipt.blockNumber}`);
67
79
  log(` Block hash: ${receipt.blockHash?.toString()}`);
80
+ log(` Local processing time: ${(localTimeMs / 1000).toFixed(1)}s`);
81
+ log(` Node inclusion time: ${(nodeTimeMs / 1000).toFixed(1)}s`);
68
82
 
69
83
  return {
70
84
  txHash,
@@ -74,12 +88,6 @@ export async function send(
74
88
  throw err;
75
89
  }
76
90
  } else {
77
- const txHash = await call.send({
78
- ...sendOptions,
79
- fee: { ...sendOptions.fee, gasSettings: estimatedGas },
80
- wait: NO_WAIT,
81
- });
82
- log(`\nTransaction hash: ${txHash.toString()}`);
83
91
  log('Transaction pending. Check status with check-tx');
84
92
  return {
85
93
  txHash,
@@ -38,7 +38,7 @@ export async function simulate(
38
38
  });
39
39
  if (verbose) {
40
40
  await printAuthorizations(
41
- simulationResult.offchainEffects!,
41
+ simulationResult.offchainEffects,
42
42
  async (address: AztecAddress) => {
43
43
  const metadata = await wallet.getContractMetadata(address);
44
44
  if (!metadata.instance) {
@@ -171,6 +171,9 @@ export function parsePaymentMethod(
171
171
  case 'fpc-public': {
172
172
  const fpc = getFpc();
173
173
  const asset = getAsset();
174
+ log(
175
+ `WARNING: fpc-public is deprecated and will not work on mainnet alpha. Use fee_juice or fpc-sponsored instead.`,
176
+ );
174
177
  log(`Using public fee payment with asset ${asset} via paymaster ${fpc}`);
175
178
  const { PublicFeePaymentMethod } = await import('@aztec/aztec.js/fee');
176
179
  return new PublicFeePaymentMethod(fpc, from, wallet, gasSettings);
@@ -178,6 +181,9 @@ export function parsePaymentMethod(
178
181
  case 'fpc-private': {
179
182
  const fpc = getFpc();
180
183
  const asset = getAsset();
184
+ log(
185
+ `WARNING: fpc-private is deprecated and will not work on mainnet alpha. Use fee_juice or fpc-sponsored instead.`,
186
+ );
181
187
  log(`Using private fee payment with asset ${asset} via paymaster ${fpc}`);
182
188
  const { PrivateFeePaymentMethod } = await import('@aztec/aztec.js/fee');
183
189
  return new PrivateFeePaymentMethod(fpc, from, wallet, gasSettings);