@aztec/cli 0.16.9 → 0.75.0-commit.c03ba01a2a4122e43e90d5133ba017e54b90e9d2

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 (219) hide show
  1. package/README.md +9 -15
  2. package/dest/cmds/contracts/index.js +12 -0
  3. package/dest/cmds/contracts/inspect_contract.js +37 -0
  4. package/dest/cmds/contracts/parse_parameter_struct.js +13 -0
  5. package/dest/cmds/devnet/bootstrap_network.js +193 -0
  6. package/dest/cmds/devnet/faucet.js +26 -0
  7. package/dest/cmds/devnet/index.js +12 -0
  8. package/dest/cmds/infrastructure/index.js +22 -0
  9. package/dest/cmds/infrastructure/sequencers.js +93 -0
  10. package/dest/cmds/infrastructure/setup_protocol_contract.js +31 -0
  11. package/dest/cmds/l1/advance_epoch.js +10 -0
  12. package/dest/cmds/l1/assume_proven_through.js +12 -0
  13. package/dest/cmds/l1/bridge_erc20.js +31 -0
  14. package/dest/cmds/l1/create_l1_account.js +15 -0
  15. package/dest/cmds/l1/deploy_l1_contracts.js +25 -0
  16. package/dest/cmds/l1/deploy_l1_verifier.js +54 -0
  17. package/dest/cmds/l1/get_l1_balance.js +33 -0
  18. package/dest/cmds/l1/index.js +127 -0
  19. package/dest/cmds/l1/prover_stats.js +145 -0
  20. package/dest/cmds/l1/update_l1_validators.js +186 -0
  21. package/dest/cmds/misc/compute_selector.js +5 -0
  22. package/dest/cmds/misc/example_contracts.js +6 -0
  23. package/dest/cmds/misc/generate_p2p_private_key.js +7 -0
  24. package/dest/cmds/misc/generate_secret_and_hash.js +11 -0
  25. package/dest/cmds/misc/generate_secret_key.js +6 -0
  26. package/dest/cmds/misc/index.js +36 -0
  27. package/dest/cmds/misc/setup_contracts.js +25 -0
  28. package/dest/cmds/misc/update/common.js +3 -0
  29. package/dest/cmds/misc/update/github.js +3 -0
  30. package/dest/cmds/misc/update/noir.js +45 -0
  31. package/dest/cmds/misc/update/npm.js +127 -0
  32. package/dest/cmds/misc/update/utils.js +38 -0
  33. package/dest/cmds/misc/update.js +52 -0
  34. package/dest/cmds/pxe/add_contract.js +27 -0
  35. package/dest/cmds/pxe/block_number.js +10 -0
  36. package/dest/cmds/pxe/get_account.js +10 -0
  37. package/dest/cmds/pxe/get_accounts.js +25 -0
  38. package/dest/cmds/pxe/get_block.js +9 -0
  39. package/dest/cmds/pxe/get_contract_data.js +31 -0
  40. package/dest/cmds/pxe/get_current_base_fee.js +7 -0
  41. package/dest/cmds/pxe/get_l1_to_l2_message_witness.js +11 -0
  42. package/dest/cmds/pxe/get_logs.js +51 -0
  43. package/dest/cmds/pxe/get_node_info.js +61 -0
  44. package/dest/cmds/pxe/get_pxe_info.js +11 -0
  45. package/dest/cmds/pxe/index.js +55 -0
  46. package/dest/utils/aztec.js +162 -0
  47. package/dest/utils/commands.js +303 -0
  48. package/dest/utils/encoding.js +110 -0
  49. package/dest/utils/github.js +3 -0
  50. package/dest/utils/index.js +4 -0
  51. package/dest/utils/inspect.js +177 -0
  52. package/package.json +70 -21
  53. package/src/cmds/contracts/index.ts +34 -0
  54. package/src/cmds/contracts/inspect_contract.ts +51 -0
  55. package/src/cmds/contracts/parse_parameter_struct.ts +27 -0
  56. package/src/cmds/devnet/bootstrap_network.ts +306 -0
  57. package/src/cmds/devnet/faucet.ts +33 -0
  58. package/src/cmds/devnet/index.ts +52 -0
  59. package/src/cmds/infrastructure/index.ts +54 -0
  60. package/src/cmds/infrastructure/sequencers.ts +100 -0
  61. package/src/cmds/infrastructure/setup_protocol_contract.ts +36 -0
  62. package/src/cmds/l1/advance_epoch.ts +12 -0
  63. package/src/cmds/l1/assume_proven_through.ts +25 -0
  64. package/src/cmds/l1/bridge_erc20.ts +53 -0
  65. package/src/cmds/l1/create_l1_account.ts +17 -0
  66. package/src/cmds/l1/deploy_l1_contracts.ts +55 -0
  67. package/src/cmds/l1/deploy_l1_verifier.ts +105 -0
  68. package/src/cmds/l1/get_l1_balance.ts +41 -0
  69. package/src/cmds/l1/index.ts +415 -0
  70. package/src/cmds/l1/prover_stats.ts +192 -0
  71. package/src/cmds/l1/update_l1_validators.ts +238 -0
  72. package/src/cmds/misc/compute_selector.ts +7 -0
  73. package/src/cmds/misc/example_contracts.ts +12 -0
  74. package/src/cmds/misc/generate_p2p_private_key.ts +10 -0
  75. package/src/cmds/misc/generate_secret_and_hash.ts +15 -0
  76. package/src/cmds/misc/generate_secret_key.ts +5 -0
  77. package/src/cmds/misc/index.ts +70 -0
  78. package/src/cmds/misc/setup_contracts.ts +38 -0
  79. package/src/cmds/misc/update/common.ts +16 -0
  80. package/src/cmds/misc/update/github.ts +3 -0
  81. package/src/cmds/misc/update/noir.ts +57 -0
  82. package/src/cmds/misc/update/npm.ts +154 -0
  83. package/src/cmds/misc/update/utils.ts +50 -0
  84. package/src/cmds/misc/update.ts +78 -0
  85. package/src/cmds/pxe/add_contract.ts +39 -0
  86. package/src/cmds/pxe/block_number.ts +9 -0
  87. package/src/cmds/pxe/get_account.ts +16 -0
  88. package/src/cmds/pxe/get_accounts.ts +35 -0
  89. package/src/cmds/pxe/get_block.ts +10 -0
  90. package/src/cmds/pxe/get_contract_data.ts +49 -0
  91. package/src/cmds/pxe/get_current_base_fee.ts +9 -0
  92. package/src/cmds/pxe/get_l1_to_l2_message_witness.ts +25 -0
  93. package/src/cmds/pxe/get_logs.ts +66 -0
  94. package/src/cmds/pxe/get_node_info.ts +71 -0
  95. package/src/cmds/pxe/get_pxe_info.ts +13 -0
  96. package/src/cmds/pxe/index.ts +170 -0
  97. package/src/utils/aztec.ts +218 -0
  98. package/src/utils/commands.ts +384 -0
  99. package/src/utils/encoding.ts +123 -0
  100. package/src/utils/github.ts +3 -0
  101. package/src/utils/index.ts +4 -0
  102. package/src/utils/inspect.ts +207 -0
  103. package/dest/bin/index.d.ts +0 -3
  104. package/dest/bin/index.d.ts.map +0 -1
  105. package/dest/bin/index.js +0 -18
  106. package/dest/client.d.ts +0 -17
  107. package/dest/client.d.ts.map +0 -1
  108. package/dest/client.js +0 -60
  109. package/dest/cmds/add_contract.d.ts +0 -7
  110. package/dest/cmds/add_contract.d.ts.map +0 -1
  111. package/dest/cmds/add_contract.js +0 -15
  112. package/dest/cmds/add_note.d.ts +0 -8
  113. package/dest/cmds/add_note.d.ts.map +0 -1
  114. package/dest/cmds/add_note.js +0 -13
  115. package/dest/cmds/block_number.d.ts +0 -6
  116. package/dest/cmds/block_number.d.ts.map +0 -1
  117. package/dest/cmds/block_number.js +0 -10
  118. package/dest/cmds/call.d.ts +0 -7
  119. package/dest/cmds/call.d.ts.map +0 -1
  120. package/dest/cmds/call.js +0 -18
  121. package/dest/cmds/check_deploy.d.ts +0 -7
  122. package/dest/cmds/check_deploy.d.ts.map +0 -1
  123. package/dest/cmds/check_deploy.js +0 -16
  124. package/dest/cmds/compute_selector.d.ts +0 -6
  125. package/dest/cmds/compute_selector.d.ts.map +0 -1
  126. package/dest/cmds/compute_selector.js +0 -9
  127. package/dest/cmds/create_account.d.ts +0 -7
  128. package/dest/cmds/create_account.d.ts.map +0 -1
  129. package/dest/cmds/create_account.js +0 -30
  130. package/dest/cmds/deploy.d.ts +0 -7
  131. package/dest/cmds/deploy.d.ts.map +0 -1
  132. package/dest/cmds/deploy.js +0 -58
  133. package/dest/cmds/deploy_l1_contracts.d.ts +0 -6
  134. package/dest/cmds/deploy_l1_contracts.d.ts.map +0 -1
  135. package/dest/cmds/deploy_l1_contracts.js +0 -15
  136. package/dest/cmds/example_contracts.d.ts +0 -6
  137. package/dest/cmds/example_contracts.d.ts.map +0 -1
  138. package/dest/cmds/example_contracts.js +0 -10
  139. package/dest/cmds/generate_p2p_private_key.d.ts +0 -6
  140. package/dest/cmds/generate_p2p_private_key.d.ts.map +0 -1
  141. package/dest/cmds/generate_p2p_private_key.js +0 -11
  142. package/dest/cmds/generate_private_key.d.ts +0 -6
  143. package/dest/cmds/generate_private_key.d.ts.map +0 -1
  144. package/dest/cmds/generate_private_key.js +0 -22
  145. package/dest/cmds/get_account.d.ts +0 -7
  146. package/dest/cmds/get_account.d.ts.map +0 -1
  147. package/dest/cmds/get_account.js +0 -15
  148. package/dest/cmds/get_accounts.d.ts +0 -6
  149. package/dest/cmds/get_accounts.d.ts.map +0 -1
  150. package/dest/cmds/get_accounts.js +0 -18
  151. package/dest/cmds/get_contract_data.d.ts +0 -7
  152. package/dest/cmds/get_contract_data.d.ts.map +0 -1
  153. package/dest/cmds/get_contract_data.js +0 -28
  154. package/dest/cmds/get_logs.d.ts +0 -7
  155. package/dest/cmds/get_logs.d.ts.map +0 -1
  156. package/dest/cmds/get_logs.js +0 -54
  157. package/dest/cmds/get_node_info.d.ts +0 -6
  158. package/dest/cmds/get_node_info.d.ts.map +0 -1
  159. package/dest/cmds/get_node_info.js +0 -15
  160. package/dest/cmds/get_recipient.d.ts +0 -7
  161. package/dest/cmds/get_recipient.d.ts.map +0 -1
  162. package/dest/cmds/get_recipient.js +0 -15
  163. package/dest/cmds/get_recipients.d.ts +0 -6
  164. package/dest/cmds/get_recipients.d.ts.map +0 -1
  165. package/dest/cmds/get_recipients.js +0 -18
  166. package/dest/cmds/get_tx_receipt.d.ts +0 -7
  167. package/dest/cmds/get_tx_receipt.d.ts.map +0 -1
  168. package/dest/cmds/get_tx_receipt.js +0 -16
  169. package/dest/cmds/inspect_contract.d.ts +0 -6
  170. package/dest/cmds/inspect_contract.d.ts.map +0 -1
  171. package/dest/cmds/inspect_contract.js +0 -19
  172. package/dest/cmds/parse_parameter_struct.d.ts +0 -6
  173. package/dest/cmds/parse_parameter_struct.d.ts.map +0 -1
  174. package/dest/cmds/parse_parameter_struct.js +0 -20
  175. package/dest/cmds/register_account.d.ts +0 -7
  176. package/dest/cmds/register_account.d.ts.map +0 -1
  177. package/dest/cmds/register_account.js +0 -13
  178. package/dest/cmds/register_recipient.d.ts +0 -7
  179. package/dest/cmds/register_recipient.d.ts.map +0 -1
  180. package/dest/cmds/register_recipient.js +0 -11
  181. package/dest/cmds/send.d.ts +0 -7
  182. package/dest/cmds/send.d.ts.map +0 -1
  183. package/dest/cmds/send.js +0 -26
  184. package/dest/cmds/unbox.d.ts +0 -6
  185. package/dest/cmds/unbox.d.ts.map +0 -1
  186. package/dest/cmds/unbox.js +0 -9
  187. package/dest/encoding.d.ts +0 -15
  188. package/dest/encoding.d.ts.map +0 -1
  189. package/dest/encoding.js +0 -114
  190. package/dest/github.d.ts +0 -4
  191. package/dest/github.d.ts.map +0 -1
  192. package/dest/github.js +0 -4
  193. package/dest/index.d.ts +0 -10
  194. package/dest/index.d.ts.map +0 -1
  195. package/dest/index.js +0 -321
  196. package/dest/parse_args.d.ts +0 -105
  197. package/dest/parse_args.d.ts.map +0 -1
  198. package/dest/parse_args.js +0 -233
  199. package/dest/test/mocks.d.ts +0 -3
  200. package/dest/test/mocks.d.ts.map +0 -1
  201. package/dest/test/mocks.js +0 -65
  202. package/dest/unbox.d.ts +0 -14
  203. package/dest/unbox.d.ts.map +0 -1
  204. package/dest/unbox.js +0 -276
  205. package/dest/update/common.d.ts +0 -17
  206. package/dest/update/common.d.ts.map +0 -1
  207. package/dest/update/common.js +0 -2
  208. package/dest/update/noir.d.ts +0 -10
  209. package/dest/update/noir.d.ts.map +0 -1
  210. package/dest/update/noir.js +0 -63
  211. package/dest/update/npm.d.ts +0 -34
  212. package/dest/update/npm.d.ts.map +0 -1
  213. package/dest/update/npm.js +0 -125
  214. package/dest/update/update.d.ts +0 -3
  215. package/dest/update/update.d.ts.map +0 -1
  216. package/dest/update/update.js +0 -58
  217. package/dest/utils.d.ts +0 -70
  218. package/dest/utils.d.ts.map +0 -1
  219. package/dest/utils.js +0 -168
@@ -0,0 +1,154 @@
1
+ import { type LogFn } from '@aztec/foundation/log';
2
+
3
+ import { spawnSync } from 'child_process';
4
+ import { existsSync } from 'fs';
5
+ import { readFile } from 'fs/promises';
6
+ import { join, relative, resolve } from 'path';
7
+ import { type SemVer, parse } from 'semver';
8
+
9
+ import { type DependencyChanges } from './common.js';
10
+ import { atomicUpdateFile } from './utils.js';
11
+
12
+ const deprecatedNpmPackages = new Set<string>(['@aztec/cli', '@aztec/aztec-sandbox']);
13
+ const npmDeprecationMessage = `
14
+ The following packages have been deprecated and will no longer be updated on the npm registry:
15
+ ${Array.from(deprecatedNpmPackages)
16
+ .map(pkg => ` - ${pkg}`)
17
+ .join('\n')}
18
+ Remove them from package.json
19
+ `;
20
+
21
+ /**
22
+ * Looks up a package.json file and returns its contents
23
+ * @param projectPath - Path to Nodejs project
24
+ * @returns The parsed package.json
25
+ */
26
+ export async function readPackageJson(projectPath: string): Promise<{
27
+ /** dependencies */
28
+ dependencies?: Record<string, string>;
29
+ /** devDependencies */
30
+ devDependencies?: Record<string, string>;
31
+ }> {
32
+ const configFilepath = resolve(join(projectPath, 'package.json'));
33
+ const pkg = JSON.parse(await readFile(configFilepath, 'utf-8'));
34
+
35
+ return pkg;
36
+ }
37
+
38
+ /**
39
+ * Queries the npm registry for the latest version of a package
40
+ * @param packageName - The package to query
41
+ * @param distTag - The distribution tag
42
+ * @returns The latest version of the package on that distribution tag
43
+ */
44
+ export async function getNewestVersion(packageName: string, distTag = 'latest'): Promise<SemVer> {
45
+ const url = new URL(packageName, 'https://registry.npmjs.org/');
46
+ const response = await fetch(url);
47
+ if (!response.ok) {
48
+ throw new Error(`Failed to fetch ${url}`);
49
+ }
50
+
51
+ const body = await response.json();
52
+ const latestVersion = parse(body['dist-tags'][distTag]);
53
+ if (!latestVersion) {
54
+ throw new Error(`Failed to get latest version from registry`);
55
+ }
56
+
57
+ return latestVersion;
58
+ }
59
+
60
+ /**
61
+ * Updates a project's \@aztec/* dependencies to the specific version
62
+ * @param projectPath - Path to Nodejs project
63
+ * @param aztecVersion - The version to update to
64
+ * @returns True if the project was updated
65
+ */
66
+ export async function updateAztecDeps(
67
+ projectPath: string,
68
+ aztecVersion: SemVer,
69
+ log: LogFn,
70
+ ): Promise<DependencyChanges> {
71
+ const pkg = await readPackageJson(projectPath);
72
+ const changes: DependencyChanges = {
73
+ file: resolve(join(projectPath, 'package.json')),
74
+ dependencies: [],
75
+ };
76
+
77
+ log(`Updating @aztec packages to ${aztecVersion} in ${relative(process.cwd(), changes.file)}`);
78
+ const version = aztecVersion.version;
79
+
80
+ let detectedDeprecatedPackages = false;
81
+
82
+ for (const depType of ['dependencies', 'devDependencies'] as const) {
83
+ const dependencies = pkg[depType];
84
+ if (!dependencies) {
85
+ continue;
86
+ }
87
+
88
+ for (const name of Object.keys(dependencies)) {
89
+ if (!name.startsWith('@aztec/')) {
90
+ continue;
91
+ }
92
+
93
+ // different release schedule
94
+ if (name === '@aztec/aztec-ui') {
95
+ continue;
96
+ }
97
+
98
+ if (deprecatedNpmPackages.has(name)) {
99
+ detectedDeprecatedPackages = true;
100
+ continue;
101
+ }
102
+
103
+ if (dependencies[name] !== version) {
104
+ changes.dependencies.push({
105
+ name,
106
+ from: dependencies[name],
107
+ to: version,
108
+ });
109
+
110
+ dependencies[name] = version;
111
+ }
112
+ }
113
+ }
114
+
115
+ if (detectedDeprecatedPackages) {
116
+ log(npmDeprecationMessage);
117
+ }
118
+
119
+ if (changes.dependencies.length > 0) {
120
+ const contents = JSON.stringify(pkg, null, 2) + '\n';
121
+ await atomicUpdateFile(resolve(join(projectPath, 'package.json')), contents);
122
+ }
123
+
124
+ return changes;
125
+ }
126
+
127
+ /**
128
+ * Updates a project's yarn.lock or package-lock.json
129
+ * @param projectPath - Path to Nodejs project
130
+ */
131
+ export function updateLockfile(projectPath: string, log: LogFn): void {
132
+ const isNpm = existsSync(resolve(join(projectPath, 'package-lock.json')));
133
+ const isYarn = existsSync(resolve(join(projectPath, 'yarn.lock')));
134
+ const isPnpm = existsSync(resolve(join(projectPath, 'pnpm-lock.yaml')));
135
+
136
+ if (isPnpm) {
137
+ spawnSync('pnpm', ['install'], {
138
+ cwd: projectPath,
139
+ stdio: 'inherit',
140
+ });
141
+ } else if (isYarn) {
142
+ spawnSync('yarn', ['install'], {
143
+ cwd: projectPath,
144
+ stdio: 'inherit',
145
+ });
146
+ } else if (isNpm) {
147
+ spawnSync('npm', ['install'], {
148
+ cwd: projectPath,
149
+ stdio: 'inherit',
150
+ });
151
+ } else {
152
+ log(`No lockfile found in ${projectPath}. Skipping lockfile update...`);
153
+ }
154
+ }
@@ -0,0 +1,50 @@
1
+ import { type NoirPackageConfig } from '@aztec/foundation/noir';
2
+
3
+ import TOML from '@iarna/toml';
4
+ import { CommanderError } from 'commander';
5
+ import { rename, writeFile } from 'fs/promises';
6
+
7
+ /**
8
+ * Updates a file in place atomically.
9
+ * @param filePath - Path to file
10
+ * @param contents - New contents to write
11
+ */
12
+ export async function atomicUpdateFile(filePath: string, contents: string) {
13
+ const tmpFilepath = filePath + '.tmp';
14
+ try {
15
+ await writeFile(tmpFilepath, contents, {
16
+ // let's crash if the tmp file already exists
17
+ flag: 'wx',
18
+ });
19
+ await rename(tmpFilepath, filePath);
20
+ } catch (e) {
21
+ if (e instanceof Error && 'code' in e && e.code === 'EEXIST') {
22
+ const commanderError = new CommanderError(
23
+ 1,
24
+ e.code,
25
+ `Temporary file already exists: ${tmpFilepath}. Delete this file and try again.`,
26
+ );
27
+ commanderError.nestedError = e.message;
28
+ throw commanderError;
29
+ } else {
30
+ throw e;
31
+ }
32
+ }
33
+ }
34
+
35
+ /**
36
+ * Pretty prints Nargo.toml contents to a string
37
+ * @param config - Nargo.toml contents
38
+ * @returns The Nargo.toml contents as a string
39
+ */
40
+ export function prettyPrintNargoToml(config: NoirPackageConfig): string {
41
+ const withoutDependencies = Object.fromEntries(Object.entries(config).filter(([key]) => key !== 'dependencies'));
42
+
43
+ const partialToml = TOML.stringify(withoutDependencies);
44
+ const dependenciesToml = Object.entries(config.dependencies).map(([name, dep]) => {
45
+ const depToml = TOML.stringify.value(dep);
46
+ return `${name} = ${depToml}`;
47
+ });
48
+
49
+ return partialToml + '\n[dependencies]\n' + dependenciesToml.join('\n') + '\n';
50
+ }
@@ -0,0 +1,78 @@
1
+ /* eslint-disable jsdoc/require-jsdoc */
2
+ import { type LogFn } from '@aztec/foundation/log';
3
+
4
+ import { relative, resolve } from 'path';
5
+ import { parse } from 'semver';
6
+
7
+ import { type DependencyChanges } from './update/common.js';
8
+ import { GITHUB_TAG_PREFIX } from './update/github.js';
9
+ import { updateAztecNr } from './update/noir.js';
10
+ import { getNewestVersion, updateAztecDeps, updateLockfile } from './update/npm.js';
11
+
12
+ const AZTECJS_PACKAGE = '@aztec/aztec.js';
13
+ const UPDATE_DOCS_URL = 'https://docs.aztec.network/developers/guides/local_env/versions-updating';
14
+
15
+ export async function updateProject(
16
+ projectPath: string,
17
+ contracts: string[],
18
+ aztecVersion: string,
19
+ log: LogFn,
20
+ ): Promise<void> {
21
+ const targetAztecVersion =
22
+ aztecVersion === 'latest' ? await getNewestVersion(AZTECJS_PACKAGE, 'latest') : parse(aztecVersion);
23
+
24
+ if (!targetAztecVersion) {
25
+ throw new Error(`Invalid aztec version ${aztecVersion}`);
26
+ }
27
+
28
+ const projectDependencyChanges: DependencyChanges[] = [];
29
+ try {
30
+ const npmChanges = await updateAztecDeps(resolve(process.cwd(), projectPath), targetAztecVersion, log);
31
+ if (npmChanges.dependencies.length > 0) {
32
+ updateLockfile(projectPath, log);
33
+ }
34
+
35
+ projectDependencyChanges.push(npmChanges);
36
+ } catch (err) {
37
+ if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
38
+ log(`No package.json found in ${projectPath}. Skipping npm update...`);
39
+ } else {
40
+ throw err;
41
+ }
42
+ }
43
+
44
+ for (const contract of contracts) {
45
+ try {
46
+ projectDependencyChanges.push(
47
+ await updateAztecNr(
48
+ resolve(process.cwd(), projectPath, contract),
49
+ `${GITHUB_TAG_PREFIX}-v${targetAztecVersion.version}`,
50
+ log,
51
+ ),
52
+ );
53
+ } catch (err) {
54
+ if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
55
+ log(`No Nargo.toml found in ${relative(process.cwd(), contract)}. Skipping...`);
56
+ } else {
57
+ throw err;
58
+ }
59
+ }
60
+ }
61
+
62
+ log(`To update Docker containers follow instructions at ${UPDATE_DOCS_URL}`);
63
+
64
+ projectDependencyChanges.forEach(changes => {
65
+ printChanges(changes, log);
66
+ });
67
+ }
68
+
69
+ function printChanges(changes: DependencyChanges, log: LogFn): void {
70
+ log(`\nIn ${relative(process.cwd(), changes.file)}:`);
71
+ if (changes.dependencies.length === 0) {
72
+ log(' No changes');
73
+ } else {
74
+ changes.dependencies.forEach(({ name, from, to }) => {
75
+ log(` Updated ${name} from ${from} to ${to}`);
76
+ });
77
+ }
78
+ }
@@ -0,0 +1,39 @@
1
+ import { AztecAddress, type ContractInstanceWithAddress, type Fr, getContractClassFromArtifact } from '@aztec/aztec.js';
2
+ import { createCompatibleClient } from '@aztec/aztec.js';
3
+ import { PublicKeys } from '@aztec/circuits.js';
4
+ import { computeContractAddressFromInstance } from '@aztec/circuits.js/contract';
5
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
6
+
7
+ import { getContractArtifact } from '../../utils/aztec.js';
8
+
9
+ export async function addContract(
10
+ rpcUrl: string,
11
+ contractArtifactPath: string,
12
+ address: AztecAddress,
13
+ initializationHash: Fr,
14
+ salt: Fr,
15
+ publicKeys: PublicKeys,
16
+ deployer: AztecAddress | undefined,
17
+ debugLogger: Logger,
18
+ log: LogFn,
19
+ ) {
20
+ const artifact = await getContractArtifact(contractArtifactPath, log);
21
+ const instance: ContractInstanceWithAddress = {
22
+ version: 1,
23
+ salt,
24
+ initializationHash,
25
+ contractClassId: (await getContractClassFromArtifact(artifact)).id,
26
+ publicKeys: publicKeys ?? PublicKeys.default(),
27
+ address,
28
+ deployer: deployer ?? AztecAddress.ZERO,
29
+ };
30
+ const computed = await computeContractAddressFromInstance(instance);
31
+ if (!computed.equals(address)) {
32
+ throw new Error(`Contract address ${address.toString()} does not match computed address ${computed.toString()}`);
33
+ }
34
+
35
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
36
+
37
+ await client.registerContract({ artifact, instance });
38
+ log(`\nContract added to PXE at ${address.toString()} with class ${instance.contractClassId.toString()}\n`);
39
+ }
@@ -0,0 +1,9 @@
1
+ import { createCompatibleClient } from '@aztec/aztec.js';
2
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
3
+
4
+ export async function blockNumber(rpcUrl: string, debugLogger: Logger, log: LogFn) {
5
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
6
+ const [latestNum, provenNum] = await Promise.all([client.getBlockNumber(), client.getProvenBlockNumber()]);
7
+ log(`Latest block: ${latestNum}`);
8
+ log(`Proven block: ${provenNum}`);
9
+ }
@@ -0,0 +1,16 @@
1
+ import { type AztecAddress } from '@aztec/aztec.js';
2
+ import { createCompatibleClient } from '@aztec/aztec.js';
3
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
4
+
5
+ export async function getAccount(aztecAddress: AztecAddress, rpcUrl: string, debugLogger: Logger, log: LogFn) {
6
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
7
+ const account = (await client.getRegisteredAccounts()).find(completeAddress =>
8
+ completeAddress.address.equals(aztecAddress),
9
+ );
10
+
11
+ if (!account) {
12
+ log(`Unknown account ${aztecAddress.toString()}`);
13
+ } else {
14
+ log(account.toReadableString());
15
+ }
16
+ }
@@ -0,0 +1,35 @@
1
+ import { createCompatibleClient } from '@aztec/aztec.js';
2
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
3
+
4
+ export async function getAccounts(
5
+ rpcUrl: string,
6
+ json: boolean,
7
+ debugLogger: Logger,
8
+ log: LogFn,
9
+ logJson: (output: any) => void,
10
+ ) {
11
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
12
+ const accounts = await client.getRegisteredAccounts();
13
+ if (!accounts.length) {
14
+ if (json) {
15
+ logJson([]);
16
+ } else {
17
+ log('No accounts found.');
18
+ }
19
+ return;
20
+ }
21
+ if (json) {
22
+ logJson(
23
+ accounts.map(a => ({
24
+ address: a.address.toString(),
25
+ publicKeys: a.publicKeys.toString(),
26
+ partialAddress: a.partialAddress.toString(),
27
+ })),
28
+ );
29
+ } else {
30
+ log(`Accounts found: \n`);
31
+ for (const account of accounts) {
32
+ log(account.toReadableString());
33
+ }
34
+ }
35
+ }
@@ -0,0 +1,10 @@
1
+ import { createCompatibleClient } from '@aztec/aztec.js';
2
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
3
+
4
+ import { inspectBlock } from '../../utils/inspect.js';
5
+
6
+ export async function getBlock(rpcUrl: string, maybeBlockNumber: number | undefined, debugLogger: Logger, log: LogFn) {
7
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
8
+ const blockNumber = maybeBlockNumber ?? (await client.getBlockNumber());
9
+ await inspectBlock(client, blockNumber, log, { showTxs: true });
10
+ }
@@ -0,0 +1,49 @@
1
+ import { type AztecAddress } from '@aztec/aztec.js';
2
+ import { createCompatibleClient } from '@aztec/aztec.js';
3
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
4
+
5
+ export async function getContractData(
6
+ rpcUrl: string,
7
+ contractAddress: AztecAddress,
8
+ includeBytecode: boolean,
9
+ debugLogger: Logger,
10
+ log: LogFn,
11
+ ) {
12
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
13
+ const {
14
+ contractInstance: instance,
15
+ isContractInitialized: isInitialized,
16
+ isContractPubliclyDeployed: isPubliclyDeployed,
17
+ } = await client.getContractMetadata(contractAddress);
18
+ const contractClass =
19
+ includeBytecode && instance && (await client.getContractClassMetadata(instance?.contractClassId)).contractClass;
20
+
21
+ const isPrivatelyDeployed = !!instance;
22
+ const initStr = isInitialized ? 'initialized' : 'not initialized';
23
+ const addrStr = contractAddress.toString();
24
+
25
+ if (isPubliclyDeployed && isPrivatelyDeployed) {
26
+ log(`Contract is ${initStr} and publicly deployed at ${addrStr}`);
27
+ } else if (isPrivatelyDeployed) {
28
+ log(`Contract is ${initStr} and registered in the local pxe at ${addrStr} but not publicly deployed`);
29
+ } else if (isPubliclyDeployed) {
30
+ log(`Contract is ${initStr} and publicly deployed at ${addrStr} but not registered in the local pxe`);
31
+ } else if (isInitialized) {
32
+ log(`Contract is initialized but not publicly deployed nor registered in the local pxe at ${addrStr}`);
33
+ } else {
34
+ log(`No contract found at ${addrStr}`);
35
+ }
36
+
37
+ if (instance) {
38
+ log(``);
39
+ Object.entries(instance).forEach(([key, value]) => {
40
+ const capitalized = key.charAt(0).toUpperCase() + key.slice(1);
41
+ log(`${capitalized}: ${value.toString()}`);
42
+ });
43
+
44
+ if (contractClass) {
45
+ log(`\nBytecode: ${contractClass.packedBytecode.toString('base64')}`);
46
+ }
47
+ log('');
48
+ }
49
+ }
@@ -0,0 +1,9 @@
1
+ import { createCompatibleClient } from '@aztec/aztec.js';
2
+ import { jsonStringify } from '@aztec/foundation/json-rpc';
3
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
4
+
5
+ export async function getCurrentBaseFee(rpcUrl: string, debugLogger: Logger, log: LogFn) {
6
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
7
+ const fees = await client.getCurrentBaseFees();
8
+ log(`Current fees: ${jsonStringify(fees)}`);
9
+ }
@@ -0,0 +1,25 @@
1
+ import { type AztecAddress, type Fr, createCompatibleClient } from '@aztec/aztec.js';
2
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
3
+
4
+ export async function getL1ToL2MessageWitness(
5
+ rpcUrl: string,
6
+ contractAddress: AztecAddress,
7
+ messageHash: Fr,
8
+ secret: Fr,
9
+ debugLogger: Logger,
10
+ log: LogFn,
11
+ ) {
12
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
13
+ const messageWitness = await client.getL1ToL2MembershipWitness(contractAddress, messageHash, secret);
14
+
15
+ log(
16
+ messageWitness === undefined
17
+ ? `
18
+ L1 to L2 Message not found.
19
+ `
20
+ : `
21
+ L1 to L2 message index: ${messageWitness[0]}
22
+ L1 to L2 message sibling path: ${messageWitness[1]}
23
+ `,
24
+ );
25
+ }
@@ -0,0 +1,66 @@
1
+ import { type AztecAddress, type LogFilter, type LogId, type TxHash } from '@aztec/aztec.js';
2
+ import { createCompatibleClient } from '@aztec/aztec.js';
3
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
4
+ import { sleep } from '@aztec/foundation/sleep';
5
+
6
+ export async function getLogs(
7
+ txHash: TxHash,
8
+ fromBlock: number,
9
+ toBlock: number,
10
+ afterLog: LogId,
11
+ contractAddress: AztecAddress,
12
+ rpcUrl: string,
13
+ follow: boolean,
14
+ debugLogger: Logger,
15
+ log: LogFn,
16
+ ) {
17
+ const pxe = await createCompatibleClient(rpcUrl, debugLogger);
18
+
19
+ if (follow) {
20
+ if (txHash) {
21
+ throw Error('Cannot use --follow with --tx-hash');
22
+ }
23
+ if (toBlock) {
24
+ throw Error('Cannot use --follow with --to-block');
25
+ }
26
+ }
27
+
28
+ const filter: LogFilter = { txHash, fromBlock, toBlock, afterLog, contractAddress };
29
+
30
+ const fetchLogs = async () => {
31
+ const response = await pxe.getPublicLogs(filter);
32
+ const logs = response.logs;
33
+
34
+ if (!logs.length) {
35
+ const filterOptions = Object.entries(filter)
36
+ .filter(([, value]) => value !== undefined)
37
+ .map(([key, value]) => `${key}: ${value}`)
38
+ .join(', ');
39
+ if (!follow) {
40
+ log(`No logs found for filter: {${filterOptions}}`);
41
+ }
42
+ } else {
43
+ if (!follow && !filter.afterLog) {
44
+ log('Logs found: \n');
45
+ }
46
+ logs.forEach(publicLog => log(publicLog.toHumanReadable()));
47
+ // Set the continuation parameter for the following requests
48
+ filter.afterLog = logs[logs.length - 1].id;
49
+ }
50
+ return response.maxLogsHit;
51
+ };
52
+
53
+ if (follow) {
54
+ log('Fetching logs...');
55
+ while (true) {
56
+ const maxLogsHit = await fetchLogs();
57
+ if (!maxLogsHit) {
58
+ await sleep(1000);
59
+ }
60
+ }
61
+ } else {
62
+ while (await fetchLogs()) {
63
+ // Keep fetching logs until we reach the end.
64
+ }
65
+ }
66
+ }
@@ -0,0 +1,71 @@
1
+ import { type AztecNode, type PXE, createAztecNodeClient, createCompatibleClient } from '@aztec/aztec.js';
2
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
3
+
4
+ export async function getNodeInfo(
5
+ rpcUrl: string,
6
+ pxeRequest: boolean,
7
+ debugLogger: Logger,
8
+ json: boolean,
9
+ log: LogFn,
10
+ logJson: (output: any) => void,
11
+ ) {
12
+ let client: AztecNode | PXE;
13
+ if (pxeRequest) {
14
+ client = await createCompatibleClient(rpcUrl, debugLogger);
15
+ } else {
16
+ client = createAztecNodeClient(rpcUrl);
17
+ }
18
+ const info = await client.getNodeInfo();
19
+ if (json) {
20
+ logJson({
21
+ nodeVersion: info.nodeVersion,
22
+ l1ChainId: info.l1ChainId,
23
+ protocolVersion: info.protocolVersion,
24
+ enr: info.enr,
25
+ l1ContractAddresses: {
26
+ rollup: info.l1ContractAddresses.rollupAddress.toString(),
27
+ registry: info.l1ContractAddresses.registryAddress.toString(),
28
+ inbox: info.l1ContractAddresses.inboxAddress.toString(),
29
+ outbox: info.l1ContractAddresses.outboxAddress.toString(),
30
+ feeJuice: info.l1ContractAddresses.feeJuiceAddress.toString(),
31
+ stakingAsset: info.l1ContractAddresses.stakingAssetAddress.toString(),
32
+ feeJuicePortal: info.l1ContractAddresses.feeJuicePortalAddress.toString(),
33
+ coinIssuer: info.l1ContractAddresses.coinIssuerAddress.toString(),
34
+ rewardDistributor: info.l1ContractAddresses.rewardDistributorAddress.toString(),
35
+ governanceProposer: info.l1ContractAddresses.governanceProposerAddress.toString(),
36
+ governance: info.l1ContractAddresses.governanceAddress.toString(),
37
+ slashFactory: info.l1ContractAddresses.slashFactoryAddress.toString(),
38
+ },
39
+ protocolContractAddresses: {
40
+ classRegisterer: info.protocolContractAddresses.classRegisterer.toString(),
41
+ feeJuice: info.protocolContractAddresses.feeJuice.toString(),
42
+ instanceDeployer: info.protocolContractAddresses.instanceDeployer.toString(),
43
+ multiCallEntrypoint: info.protocolContractAddresses.multiCallEntrypoint.toString(),
44
+ },
45
+ });
46
+ } else {
47
+ log(`Node Version: ${info.nodeVersion}`);
48
+ log(`Chain Id: ${info.l1ChainId}`);
49
+ log(`Protocol Version: ${info.protocolVersion}`);
50
+ log(`Node ENR: ${info.enr}`);
51
+ log(`L1 Contract Addresses:`);
52
+ log(` Rollup Address: ${info.l1ContractAddresses.rollupAddress.toString()}`);
53
+ log(` Registry Address: ${info.l1ContractAddresses.registryAddress.toString()}`);
54
+ log(` L1 -> L2 Inbox Address: ${info.l1ContractAddresses.inboxAddress.toString()}`);
55
+ log(` L2 -> L1 Outbox Address: ${info.l1ContractAddresses.outboxAddress.toString()}`);
56
+ log(` Fee Juice Address: ${info.l1ContractAddresses.feeJuiceAddress.toString()}`);
57
+ log(` Staking Asset Address: ${info.l1ContractAddresses.stakingAssetAddress.toString()}`);
58
+ log(` Fee Juice Portal Address: ${info.l1ContractAddresses.feeJuicePortalAddress.toString()}`);
59
+ log(` CoinIssuer Address: ${info.l1ContractAddresses.coinIssuerAddress.toString()}`);
60
+ log(` RewardDistributor Address: ${info.l1ContractAddresses.rewardDistributorAddress.toString()}`);
61
+ log(` GovernanceProposer Address: ${info.l1ContractAddresses.governanceProposerAddress.toString()}`);
62
+ log(` Governance Address: ${info.l1ContractAddresses.governanceAddress.toString()}`);
63
+ log(` SlashFactory Address: ${info.l1ContractAddresses.slashFactoryAddress.toString()}`);
64
+
65
+ log(`L2 Contract Addresses:`);
66
+ log(` Class Registerer: ${info.protocolContractAddresses.classRegisterer.toString()}`);
67
+ log(` Fee Juice: ${info.protocolContractAddresses.feeJuice.toString()}`);
68
+ log(` Instance Deployer: ${info.protocolContractAddresses.instanceDeployer.toString()}`);
69
+ log(` MultiCall: ${info.protocolContractAddresses.multiCallEntrypoint.toString()}`);
70
+ }
71
+ }
@@ -0,0 +1,13 @@
1
+ import { createCompatibleClient } from '@aztec/aztec.js';
2
+ import { type LogFn, type Logger } from '@aztec/foundation/log';
3
+
4
+ export async function getPXEInfo(rpcUrl: string, debugLogger: Logger, log: LogFn) {
5
+ const client = await createCompatibleClient(rpcUrl, debugLogger);
6
+ const info = await client.getPXEInfo();
7
+ log(`PXE Version: ${info.pxeVersion}`);
8
+ log(`Protocol Contract Addresses:`);
9
+ log(` Class Registerer: ${info.protocolContractAddresses.classRegisterer.toString()}`);
10
+ log(` Fee Juice: ${info.protocolContractAddresses.feeJuice.toString()}`);
11
+ log(` Instance Deployer: ${info.protocolContractAddresses.instanceDeployer.toString()}`);
12
+ log(` Multi Call Entrypoint: ${info.protocolContractAddresses.multiCallEntrypoint.toString()}`);
13
+ }