@aztec/aztec 0.0.1-commit.e61ad554 → 0.0.1-commit.ec5f612

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 (91) hide show
  1. package/dest/bin/index.js +5 -1
  2. package/dest/cli/admin_api_key_store.d.ts +45 -0
  3. package/dest/cli/admin_api_key_store.d.ts.map +1 -0
  4. package/dest/cli/admin_api_key_store.js +98 -0
  5. package/dest/cli/aztec_start_action.d.ts +1 -1
  6. package/dest/cli/aztec_start_action.d.ts.map +1 -1
  7. package/dest/cli/aztec_start_action.js +46 -10
  8. package/dest/cli/aztec_start_options.d.ts +1 -1
  9. package/dest/cli/aztec_start_options.d.ts.map +1 -1
  10. package/dest/cli/aztec_start_options.js +23 -6
  11. package/dest/cli/cli.d.ts +1 -1
  12. package/dest/cli/cli.d.ts.map +1 -1
  13. package/dest/cli/cli.js +0 -1
  14. package/dest/cli/cmds/compile.d.ts +4 -0
  15. package/dest/cli/cmds/compile.d.ts.map +1 -0
  16. package/dest/cli/cmds/compile.js +160 -0
  17. package/dest/cli/cmds/profile.d.ts +4 -0
  18. package/dest/cli/cmds/profile.d.ts.map +1 -0
  19. package/dest/cli/cmds/profile.js +8 -0
  20. package/dest/cli/cmds/profile_flamegraph.d.ts +4 -0
  21. package/dest/cli/cmds/profile_flamegraph.d.ts.map +1 -0
  22. package/dest/cli/cmds/profile_flamegraph.js +51 -0
  23. package/dest/cli/cmds/profile_gates.d.ts +4 -0
  24. package/dest/cli/cmds/profile_gates.d.ts.map +1 -0
  25. package/dest/cli/cmds/profile_gates.js +57 -0
  26. package/dest/cli/cmds/profile_utils.d.ts +18 -0
  27. package/dest/cli/cmds/profile_utils.d.ts.map +1 -0
  28. package/dest/cli/cmds/profile_utils.js +50 -0
  29. package/dest/cli/cmds/start_bot.d.ts +3 -3
  30. package/dest/cli/cmds/start_bot.d.ts.map +1 -1
  31. package/dest/cli/cmds/start_bot.js +9 -5
  32. package/dest/cli/cmds/start_node.d.ts +1 -1
  33. package/dest/cli/cmds/start_node.d.ts.map +1 -1
  34. package/dest/cli/cmds/start_node.js +62 -10
  35. package/dest/cli/cmds/start_p2p_bootstrap.d.ts +2 -2
  36. package/dest/cli/cmds/start_p2p_bootstrap.d.ts.map +1 -1
  37. package/dest/cli/cmds/start_p2p_bootstrap.js +1 -2
  38. package/dest/cli/cmds/start_prover_agent.js +2 -2
  39. package/dest/cli/cmds/start_prover_broker.d.ts +1 -1
  40. package/dest/cli/cmds/start_prover_broker.d.ts.map +1 -1
  41. package/dest/cli/cmds/start_prover_broker.js +2 -2
  42. package/dest/cli/cmds/utils/artifacts.d.ts +21 -0
  43. package/dest/cli/cmds/utils/artifacts.d.ts.map +1 -0
  44. package/dest/cli/cmds/utils/artifacts.js +24 -0
  45. package/dest/cli/cmds/utils/spawn.d.ts +3 -0
  46. package/dest/cli/cmds/utils/spawn.d.ts.map +1 -0
  47. package/dest/cli/cmds/utils/spawn.js +16 -0
  48. package/dest/cli/util.d.ts +5 -14
  49. package/dest/cli/util.d.ts.map +1 -1
  50. package/dest/cli/util.js +13 -8
  51. package/dest/examples/token.js +2 -2
  52. package/dest/local-network/local-network.d.ts +4 -2
  53. package/dest/local-network/local-network.d.ts.map +1 -1
  54. package/dest/local-network/local-network.js +32 -13
  55. package/dest/testing/anvil_test_watcher.d.ts +9 -1
  56. package/dest/testing/anvil_test_watcher.d.ts.map +1 -1
  57. package/dest/testing/anvil_test_watcher.js +52 -15
  58. package/package.json +34 -34
  59. package/scripts/aztec.sh +8 -5
  60. package/scripts/init.sh +23 -13
  61. package/scripts/new.sh +17 -16
  62. package/scripts/setup_workspace.sh +124 -0
  63. package/src/bin/index.ts +5 -1
  64. package/src/cli/admin_api_key_store.ts +128 -0
  65. package/src/cli/aztec_start_action.ts +50 -6
  66. package/src/cli/aztec_start_options.ts +25 -5
  67. package/src/cli/cli.ts +0 -1
  68. package/src/cli/cmds/compile.ts +184 -0
  69. package/src/cli/cmds/profile.ts +25 -0
  70. package/src/cli/cmds/profile_flamegraph.ts +63 -0
  71. package/src/cli/cmds/profile_gates.ts +67 -0
  72. package/src/cli/cmds/profile_utils.ts +58 -0
  73. package/src/cli/cmds/start_bot.ts +8 -5
  74. package/src/cli/cmds/start_node.ts +51 -9
  75. package/src/cli/cmds/start_p2p_bootstrap.ts +2 -2
  76. package/src/cli/cmds/start_prover_agent.ts +2 -2
  77. package/src/cli/cmds/start_prover_broker.ts +5 -1
  78. package/src/cli/cmds/utils/artifacts.ts +44 -0
  79. package/src/cli/cmds/utils/spawn.ts +16 -0
  80. package/src/cli/util.ts +16 -21
  81. package/src/examples/token.ts +2 -2
  82. package/src/local-network/local-network.ts +41 -14
  83. package/src/testing/anvil_test_watcher.ts +59 -15
  84. package/dest/cli/cmds/start_prover_node.d.ts +0 -7
  85. package/dest/cli/cmds/start_prover_node.d.ts.map +0 -1
  86. package/dest/cli/cmds/start_prover_node.js +0 -108
  87. package/scripts/compile.sh +0 -44
  88. package/scripts/extract_function.js +0 -47
  89. package/scripts/flamegraph.sh +0 -59
  90. package/scripts/setup_project.sh +0 -31
  91. package/src/cli/cmds/start_prover_node.ts +0 -124
package/dest/bin/index.js CHANGED
@@ -12,7 +12,9 @@ import { injectCommands as injectValidatorKeysCommands } from '@aztec/cli/valida
12
12
  import { getActiveNetworkName } from '@aztec/foundation/config';
13
13
  import { createConsoleLogger, createLogger } from '@aztec/foundation/log';
14
14
  import { Command } from 'commander';
15
+ import { injectCompileCommand } from '../cli/cmds/compile.js';
15
16
  import { injectMigrateCommand } from '../cli/cmds/migrate_ha_db.js';
17
+ import { injectProfileCommand } from '../cli/cmds/profile.js';
16
18
  import { injectAztecCommands } from '../cli/index.js';
17
19
  import { getCliVersion } from '../cli/release_version.js';
18
20
  const NETWORK_FLAG = 'network';
@@ -36,7 +38,7 @@ const debugLogger = createLogger('cli');
36
38
  enrichEnvironmentWithChainName(networkName);
37
39
  const cliVersion = getCliVersion();
38
40
  let program = new Command('aztec');
39
- program.description('Aztec command line interface').version(cliVersion);
41
+ program.description('Aztec command line interface').version(cliVersion).enablePositionalOptions();
40
42
  program = injectAztecCommands(program, userLog, debugLogger);
41
43
  program = injectBuilderCommands(program);
42
44
  program = injectContractCommands(program, userLog, debugLogger);
@@ -45,6 +47,8 @@ const debugLogger = createLogger('cli');
45
47
  program = injectAztecNodeCommands(program, userLog, debugLogger);
46
48
  program = injectMiscCommands(program, userLog);
47
49
  program = injectValidatorKeysCommands(program, userLog);
50
+ program = injectCompileCommand(program, userLog);
51
+ program = injectProfileCommand(program, userLog);
48
52
  program = injectMigrateCommand(program, userLog);
49
53
  await program.parseAsync(process.argv);
50
54
  }
@@ -0,0 +1,45 @@
1
+ import type { Logger } from '@aztec/foundation/log';
2
+ /**
3
+ * Result of resolving the admin API key.
4
+ * Contains the SHA-256 hex hash of the API key to be used by the auth middleware,
5
+ * and optionally the raw key when newly generated (so the caller can display it).
6
+ */
7
+ export interface AdminApiKeyResolution {
8
+ /** The SHA-256 hash of the API key. */
9
+ apiKeyHash: Buffer;
10
+ /**
11
+ * The raw API key, only present when a new key was generated during this call.
12
+ * The caller MUST display this to the operator — it will not be stored or returned again.
13
+ */
14
+ rawKey?: string;
15
+ }
16
+ export interface ResolveAdminApiKeyOptions {
17
+ /** SHA-256 hex hash of a pre-generated API key. When set, the node uses this hash directly. */
18
+ adminApiKeyHash?: string;
19
+ /** If true, disable admin API key auth entirely. */
20
+ disableAdminApiKey?: boolean;
21
+ /** If true, force-generate a new key even if one is already persisted. */
22
+ resetAdminApiKey?: boolean;
23
+ /** Root data directory for persistent storage. */
24
+ dataDirectory?: string;
25
+ }
26
+ /**
27
+ * Resolves the admin API key for the admin RPC endpoint.
28
+ *
29
+ * Strategy:
30
+ * 1. If opt-out flag is set (`disableAdminApiKey`), return undefined (no auth).
31
+ * 2. If a pre-generated hash is provided (`adminApiKeyHash`), use it directly.
32
+ * 3. If a data directory exists, look for a persisted hash file
33
+ * at `<dataDirectory>/admin/api_key_hash`:
34
+ * - If `resetAdminApiKey` is set, skip loading and force-generate a new key.
35
+ * - Found: use the stored hash (operator already saved the key from first run).
36
+ * - Not found: auto-generate a random key, display it once, persist the hash.
37
+ * 3. If no data directory: generate a random key
38
+ * each run and display it (cannot persist).
39
+ *
40
+ * @param options - The options for resolving the admin API key.
41
+ * @param log - Logger for outputting the key and status messages.
42
+ * @returns The resolved API key hash, or undefined if auth is disabled.
43
+ */
44
+ export declare function resolveAdminApiKey(options: ResolveAdminApiKeyOptions, log: Logger): Promise<AdminApiKeyResolution | undefined>;
45
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRtaW5fYXBpX2tleV9zdG9yZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaS9hZG1pbl9hcGlfa2V5X3N0b3JlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBU3BEOzs7O0dBSUc7QUFDSCxNQUFNLFdBQVcscUJBQXFCO0lBQ3BDLHVDQUF1QztJQUN2QyxVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQ25COzs7T0FHRztJQUNILE1BQU0sQ0FBQyxFQUFFLE1BQU0sQ0FBQztDQUNqQjtBQUVELE1BQU0sV0FBVyx5QkFBeUI7SUFDeEMsK0ZBQStGO0lBQy9GLGVBQWUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUN6QixvREFBb0Q7SUFDcEQsa0JBQWtCLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDN0IsMEVBQTBFO0lBQzFFLGdCQUFnQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQzNCLGtEQUFrRDtJQUNsRCxhQUFhLENBQUMsRUFBRSxNQUFNLENBQUM7Q0FDeEI7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FpQkc7QUFDSCx3QkFBc0Isa0JBQWtCLENBQ3RDLE9BQU8sRUFBRSx5QkFBeUIsRUFDbEMsR0FBRyxFQUFFLE1BQU0sR0FDVixPQUFPLENBQUMscUJBQXFCLEdBQUcsU0FBUyxDQUFDLENBMkQ1QyJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"admin_api_key_store.d.ts","sourceRoot":"","sources":["../../src/cli/admin_api_key_store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AASpD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,EAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA2D5C"}
@@ -0,0 +1,98 @@
1
+ import { randomBytes } from '@aztec/foundation/crypto/random';
2
+ import { sha256Hash } from '@aztec/foundation/json-rpc/server';
3
+ import { promises as fs } from 'fs';
4
+ import { join } from 'path';
5
+ /** Subdirectory under dataDirectory for admin API key storage. */ const ADMIN_STORE_DIR = 'admin';
6
+ const HASH_FILE_NAME = 'api_key_hash';
7
+ /**
8
+ * Resolves the admin API key for the admin RPC endpoint.
9
+ *
10
+ * Strategy:
11
+ * 1. If opt-out flag is set (`disableAdminApiKey`), return undefined (no auth).
12
+ * 2. If a pre-generated hash is provided (`adminApiKeyHash`), use it directly.
13
+ * 3. If a data directory exists, look for a persisted hash file
14
+ * at `<dataDirectory>/admin/api_key_hash`:
15
+ * - If `resetAdminApiKey` is set, skip loading and force-generate a new key.
16
+ * - Found: use the stored hash (operator already saved the key from first run).
17
+ * - Not found: auto-generate a random key, display it once, persist the hash.
18
+ * 3. If no data directory: generate a random key
19
+ * each run and display it (cannot persist).
20
+ *
21
+ * @param options - The options for resolving the admin API key.
22
+ * @param log - Logger for outputting the key and status messages.
23
+ * @returns The resolved API key hash, or undefined if auth is disabled.
24
+ */ export async function resolveAdminApiKey(options, log) {
25
+ // Operator explicitly opted out of admin auth
26
+ if (options.disableAdminApiKey) {
27
+ log.warn('Admin API key authentication is DISABLED (--disable-admin-api-key / AZTEC_DISABLE_ADMIN_API_KEY)');
28
+ return undefined;
29
+ }
30
+ // Operator provided a pre-generated hash (e.g. via AZTEC_ADMIN_API_KEY_HASH env var)
31
+ if (options.adminApiKeyHash) {
32
+ const hex = options.adminApiKeyHash.trim();
33
+ if (hex.length !== 64 || !/^[0-9a-f]{64}$/.test(hex)) {
34
+ throw new Error(`Invalid admin API key hash: expected 64-char hex string, got "${hex}"`);
35
+ }
36
+ log.info('Admin API key authentication enabled (using pre-configured key hash)');
37
+ return {
38
+ apiKeyHash: Buffer.from(hex, 'hex')
39
+ };
40
+ }
41
+ // Persistent storage available, load or generate key
42
+ if (options.dataDirectory) {
43
+ const adminDir = join(options.dataDirectory, ADMIN_STORE_DIR);
44
+ const hashFilePath = join(adminDir, HASH_FILE_NAME);
45
+ // Unless a reset is forced, try to load the existing hash from disk
46
+ if (!options.resetAdminApiKey) {
47
+ try {
48
+ const storedHash = (await fs.readFile(hashFilePath, 'utf-8')).trim();
49
+ if (storedHash.length === 64) {
50
+ log.info('Admin API key authentication enabled (loaded stored key hash from disk)');
51
+ return {
52
+ apiKeyHash: Buffer.from(storedHash, 'hex')
53
+ };
54
+ }
55
+ log.warn(`Invalid stored admin API key hash at ${hashFilePath}, regenerating...`);
56
+ } catch (err) {
57
+ if (err.code !== 'ENOENT') {
58
+ log.warn(`Failed to read admin API key hash from ${hashFilePath}: ${err.message}`);
59
+ }
60
+ // File doesn't exist — fall through to generate
61
+ }
62
+ } else {
63
+ log.warn('Admin API key reset requested — generating a new key');
64
+ }
65
+ // Generate a new key, persist the hash, and return the raw key for the caller to display
66
+ const { rawKey, hash } = generateApiKey();
67
+ await fs.mkdir(adminDir, {
68
+ recursive: true
69
+ });
70
+ await fs.writeFile(hashFilePath, hash.toString('hex'), 'utf-8');
71
+ // Set restrictive permissions (owner read/write only)
72
+ await fs.chmod(hashFilePath, 0o600);
73
+ log.info('Admin API key authentication enabled (new key generated and hash persisted to disk)');
74
+ return {
75
+ apiKeyHash: hash,
76
+ rawKey
77
+ };
78
+ }
79
+ // No data directory, generate a temporary key per session
80
+ const { rawKey, hash } = generateApiKey();
81
+ log.warn('No data directory configured — admin API key cannot be persisted.');
82
+ log.warn('A temporary key has been generated for this session only.');
83
+ return {
84
+ apiKeyHash: hash,
85
+ rawKey
86
+ };
87
+ }
88
+ /**
89
+ * Generates a cryptographically random API key and its SHA-256 hash.
90
+ * @returns The raw key (hex string) and its SHA-256 hash as a Buffer.
91
+ */ function generateApiKey() {
92
+ const rawKey = randomBytes(32).toString('hex');
93
+ const hash = sha256Hash(rawKey);
94
+ return {
95
+ rawKey,
96
+ hash
97
+ };
98
+ }
@@ -1,3 +1,3 @@
1
1
  import type { LogFn, Logger } from '@aztec/foundation/log';
2
2
  export declare function aztecStart(options: any, userLog: LogFn, debugLogger: Logger): Promise<void>;
3
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWNfc3RhcnRfYWN0aW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2F6dGVjX3N0YXJ0X2FjdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFLQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFZM0Qsd0JBQXNCLFVBQVUsQ0FBQyxPQUFPLEVBQUUsR0FBRyxFQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUJBOEZqRiJ9
3
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWNfc3RhcnRfYWN0aW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2F6dGVjX3N0YXJ0X2FjdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFNQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFhM0Qsd0JBQXNCLFVBQVUsQ0FBQyxPQUFPLEVBQUUsR0FBRyxFQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUJBd0lqRiJ9
@@ -1 +1 @@
1
- {"version":3,"file":"aztec_start_action.d.ts","sourceRoot":"","sources":["../../src/cli/aztec_start_action.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAY3D,wBAAsB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBA8FjF"}
1
+ {"version":3,"file":"aztec_start_action.d.ts","sourceRoot":"","sources":["../../src/cli/aztec_start_action.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAa3D,wBAAsB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAwIjF"}
@@ -1,9 +1,10 @@
1
- import { createNamespacedSafeJsonRpcServer, startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
1
+ import { createNamespacedSafeJsonRpcServer, getApiKeyAuthMiddleware, startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
2
2
  import { AztecNodeApiSchema } from '@aztec/stdlib/interfaces/client';
3
3
  import { getVersioningMiddleware } from '@aztec/stdlib/versioning';
4
4
  import { getOtelJsonRpcPropagationMiddleware } from '@aztec/telemetry-client';
5
5
  import { createLocalNetwork } from '../local-network/index.js';
6
6
  import { github, splash } from '../splash.js';
7
+ import { resolveAdminApiKey } from './admin_api_key_store.js';
7
8
  import { getCliVersion } from './release_version.js';
8
9
  import { extractNamespacedOptions, installSignalHandlers } from './util.js';
9
10
  import { getVersions } from './versioning.js';
@@ -24,11 +25,11 @@ export async function aztecStart(options, userLog, debugLogger) {
24
25
  l1RpcUrls: options.l1RpcUrls,
25
26
  testAccounts: localNetwork.testAccounts,
26
27
  realProofs: false,
27
- // Setting the epoch duration to 4 by default for local network. This allows the epoch to be "proven" faster, so
28
+ // Setting the epoch duration to 2 by default for local network. This allows the epoch to be "proven" faster, so
28
29
  // the users can consume out hash without having to wait for a long time.
29
30
  // Note: We are not proving anything in the local network (realProofs == false). But in `createLocalNetwork`,
30
31
  // the EpochTestSettler will set the out hash to the outbox when an epoch is complete.
31
- aztecEpochDuration: 4
32
+ aztecEpochDuration: 2
32
33
  }, userLog);
33
34
  // Start Node and PXE JSON-RPC server
34
35
  signalHandlers.push(stop);
@@ -37,15 +38,16 @@ export async function aztecStart(options, userLog, debugLogger) {
37
38
  AztecNodeApiSchema
38
39
  ];
39
40
  } else {
41
+ // Route --prover-node through startNode
42
+ if (options.proverNode && !options.node) {
43
+ options.node = true;
44
+ }
40
45
  if (options.node) {
41
46
  const { startNode } = await import('./cmds/start_node.js');
42
47
  ({ config } = await startNode(options, signalHandlers, services, adminServices, userLog));
43
48
  } else if (options.bot) {
44
49
  const { startBot } = await import('./cmds/start_bot.js');
45
50
  await startBot(options, signalHandlers, services, userLog);
46
- } else if (options.proverNode) {
47
- const { startProverNode } = await import('./cmds/start_prover_node.js');
48
- ({ config } = await startProverNode(options, signalHandlers, services, userLog));
49
51
  } else if (options.archiver) {
50
52
  const { startArchiver } = await import('./cmds/start_archiver.js');
51
53
  ({ config } = await startArchiver(options, signalHandlers, services));
@@ -90,13 +92,26 @@ export async function aztecStart(options, userLog, debugLogger) {
90
92
  }
91
93
  // If there are any admin services, start a separate JSON-RPC server for them
92
94
  if (Object.entries(adminServices).length > 0) {
95
+ const adminMiddlewares = [
96
+ getOtelJsonRpcPropagationMiddleware(),
97
+ getVersioningMiddleware(versions)
98
+ ];
99
+ // Resolve the admin API key (auto-generated and persisted, or opt-out)
100
+ const apiKeyResolution = await resolveAdminApiKey({
101
+ adminApiKeyHash: options.adminApiKeyHash,
102
+ disableAdminApiKey: options.disableAdminApiKey,
103
+ resetAdminApiKey: options.resetAdminApiKey,
104
+ dataDirectory: options.dataDirectory
105
+ }, debugLogger);
106
+ if (apiKeyResolution) {
107
+ adminMiddlewares.unshift(getApiKeyAuthMiddleware(apiKeyResolution.apiKeyHash));
108
+ } else {
109
+ debugLogger.warn('No admin API key set — admin endpoint is unauthenticated');
110
+ }
93
111
  const rpcServer = createNamespacedSafeJsonRpcServer(adminServices, {
94
112
  http200OnError: false,
95
113
  log: debugLogger,
96
- middlewares: [
97
- getOtelJsonRpcPropagationMiddleware(),
98
- getVersioningMiddleware(versions)
99
- ],
114
+ middlewares: adminMiddlewares,
100
115
  maxBatchSize: options.rpcMaxBatchSize,
101
116
  maxBodySizeBytes: options.rpcMaxBodySize
102
117
  });
@@ -104,5 +119,26 @@ export async function aztecStart(options, userLog, debugLogger) {
104
119
  port: options.adminPort
105
120
  });
106
121
  debugLogger.info(`Aztec Server admin API listening on port ${port}`, versions);
122
+ // Display the API key after the server has started
123
+ // Uses userLog which is never filtered by LOG_LEVEL.
124
+ if (apiKeyResolution?.rawKey) {
125
+ const separator = '='.repeat(70);
126
+ userLog('');
127
+ userLog(separator);
128
+ userLog(' ADMIN API KEY (save this — it will NOT be shown again)');
129
+ userLog('');
130
+ userLog(` ${apiKeyResolution.rawKey}`);
131
+ userLog('');
132
+ userLog(` Use via header: x-api-key: <key>`);
133
+ userLog(` Or via header: Authorization: Bearer <key>`);
134
+ if (options.dataDirectory) {
135
+ userLog('');
136
+ userLog(' The key hash has been persisted — on next restart, the same key will be used.');
137
+ }
138
+ userLog('');
139
+ userLog(' To disable admin auth: --disable-admin-api-key or AZTEC_DISABLE_ADMIN_API_KEY=true');
140
+ userLog(separator);
141
+ userLog('');
142
+ }
107
143
  }
108
144
  }
@@ -14,4 +14,4 @@ export declare const NETWORK_FLAG = "network";
14
14
  export declare const aztecStartOptions: {
15
15
  [key: string]: AztecStartOption[];
16
16
  };
17
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWNfc3RhcnRfb3B0aW9ucy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaS9henRlY19zdGFydF9vcHRpb25zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQU9BLE9BQU8sRUFDTCxLQUFLLGFBQWEsRUFDbEIsS0FBSyxNQUFNLEVBSVosTUFBTSwwQkFBMEIsQ0FBQztBQWVsQyxNQUFNLFdBQVcsZ0JBQWdCO0lBQy9CLElBQUksRUFBRSxNQUFNLENBQUM7SUFDYixXQUFXLEVBQUUsTUFBTSxDQUFDO0lBQ3BCLFlBQVksRUFBRSxHQUFHLENBQUM7SUFDbEIsWUFBWSxDQUFDLEVBQUUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxLQUFLLE1BQU0sQ0FBQztJQUNwQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQztJQUN4QixRQUFRLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQztJQUNwQixRQUFRLENBQUMsRUFBRSxDQUFDLEdBQUcsRUFBRSxNQUFNLEtBQUssR0FBRyxDQUFDO0NBQ2pDO0FBRUQsZUFBTyxNQUFNLFVBQVUsMEZBb0J0QixDQUFDO0FBdUJGLGVBQU8sTUFBTSxnQkFBZ0IsVUFZNUIsQ0FBQztBQUVGLGVBQU8sTUFBTSxZQUFZLFlBQVksQ0FBQztBQUd0QyxlQUFPLE1BQU0saUJBQWlCLEVBQUU7SUFBRSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsZ0JBQWdCLEVBQUUsQ0FBQTtDQW1ObEUsQ0FBQyJ9
17
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWNfc3RhcnRfb3B0aW9ucy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaS9henRlY19zdGFydF9vcHRpb25zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQU9BLE9BQU8sRUFDTCxLQUFLLGFBQWEsRUFDbEIsS0FBSyxNQUFNLEVBSVosTUFBTSwwQkFBMEIsQ0FBQztBQWVsQyxNQUFNLFdBQVcsZ0JBQWdCO0lBQy9CLElBQUksRUFBRSxNQUFNLENBQUM7SUFDYixXQUFXLEVBQUUsTUFBTSxDQUFDO0lBQ3BCLFlBQVksRUFBRSxHQUFHLENBQUM7SUFDbEIsWUFBWSxDQUFDLEVBQUUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxLQUFLLE1BQU0sQ0FBQztJQUNwQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQztJQUN4QixRQUFRLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQztJQUNwQixRQUFRLENBQUMsRUFBRSxDQUFDLEdBQUcsRUFBRSxNQUFNLEtBQUssR0FBRyxDQUFDO0NBQ2pDO0FBRUQsZUFBTyxNQUFNLFVBQVUsMEZBb0J0QixDQUFDO0FBdUJGLGVBQU8sTUFBTSxnQkFBZ0IsVUFZNUIsQ0FBQztBQUVGLGVBQU8sTUFBTSxZQUFZLFlBQVksQ0FBQztBQUd0QyxlQUFPLE1BQU0saUJBQWlCLEVBQUU7SUFBRSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsZ0JBQWdCLEVBQUUsQ0FBQTtDQXVPbEUsQ0FBQyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"aztec_start_options.d.ts","sourceRoot":"","sources":["../../src/cli/aztec_start_options.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,MAAM,EAIZ,MAAM,0BAA0B,CAAC;AAelC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IACpC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;CACjC;AAED,eAAO,MAAM,UAAU,0FAoBtB,CAAC;AAuBF,eAAO,MAAM,gBAAgB,UAY5B,CAAC;AAEF,eAAO,MAAM,YAAY,YAAY,CAAC;AAGtC,eAAO,MAAM,iBAAiB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAAA;CAmNlE,CAAC"}
1
+ {"version":3,"file":"aztec_start_options.d.ts","sourceRoot":"","sources":["../../src/cli/aztec_start_options.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,MAAM,EAIZ,MAAM,0BAA0B,CAAC;AAelC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IACpC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;CACjC;AAED,eAAO,MAAM,UAAU,0FAoBtB,CAAC;AAuBF,eAAO,MAAM,gBAAgB,UAY5B,CAAC;AAEF,eAAO,MAAM,YAAY,YAAY,CAAC;AAGtC,eAAO,MAAM,iBAAiB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAAA;CAuOlE,CAAC"}
@@ -111,6 +111,27 @@ export const aztecStartOptions = {
111
111
  env: 'AZTEC_ADMIN_PORT',
112
112
  parseVal: (val)=>parseInt(val, 10)
113
113
  },
114
+ {
115
+ flag: '--admin-api-key-hash <value>',
116
+ description: 'SHA-256 hex hash of a pre-generated admin API key. When set, the node uses this hash for authentication instead of auto-generating a key.',
117
+ defaultValue: undefined,
118
+ env: 'AZTEC_ADMIN_API_KEY_HASH'
119
+ },
120
+ {
121
+ flag: '--disable-admin-api-key',
122
+ description: 'Disable API key authentication on the admin RPC endpoint. By default, a key is auto-generated, displayed once, and its hash is persisted.',
123
+ defaultValue: false,
124
+ env: 'AZTEC_DISABLE_ADMIN_API_KEY',
125
+ // undefined means the flag was passed without a value (boolean toggle), treat as true.
126
+ parseVal: (val)=>val === undefined || val === 'true' || val === '1'
127
+ },
128
+ {
129
+ flag: '--reset-admin-api-key',
130
+ description: 'Force-generate a new admin API key, replacing any previously persisted key hash. The new key is displayed once at startup.',
131
+ defaultValue: false,
132
+ env: 'AZTEC_RESET_ADMIN_API_KEY',
133
+ parseVal: (val)=>val === 'true' || val === '1'
134
+ },
114
135
  {
115
136
  flag: '--api-prefix <value>',
116
137
  description: 'Prefix for API routes on any service that is started',
@@ -142,7 +163,7 @@ export const aztecStartOptions = {
142
163
  'WORLD STATE': [
143
164
  configToFlag('--world-state-data-directory', worldStateConfigMappings.worldStateDataDirectory),
144
165
  configToFlag('--world-state-db-map-size-kb', worldStateConfigMappings.worldStateDbMapSizeKb),
145
- configToFlag('--world-state-block-history', worldStateConfigMappings.worldStateBlockHistory)
166
+ configToFlag('--world-state-checkpoint-history', worldStateConfigMappings.worldStateCheckpointHistory)
146
167
  ],
147
168
  // We can't easily auto-generate node options as they're parts of modules defined below
148
169
  'AZTEC NODE': [
@@ -186,12 +207,8 @@ export const aztecStartOptions = {
186
207
  },
187
208
  ...getOptions('proverNode', omitConfigMappings(proverNodeConfigMappings, [
188
209
  // filter out options passed separately
189
- ...getKeys(archiverConfigMappings),
190
210
  ...getKeys(proverBrokerConfigMappings),
191
- ...getKeys(proverAgentConfigMappings),
192
- ...getKeys(p2pConfigMappings),
193
- ...getKeys(worldStateConfigMappings),
194
- ...getKeys(sharedNodeConfigMappings)
211
+ ...getKeys(proverAgentConfigMappings)
195
212
  ]))
196
213
  ],
197
214
  'PROVER BROKER': [
package/dest/cli/cli.d.ts CHANGED
@@ -6,4 +6,4 @@ import { Command } from 'commander';
6
6
  * @param debugLogger - logger for logging debug messages.
7
7
  */
8
8
  export declare function injectAztecCommands(program: Command, userLog: LogFn, debugLogger: Logger): Command;
9
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFM0QsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUtwQzs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0E0Q2xHIn0=
9
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFM0QsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUtwQzs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0EyQ2xHIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA4ClG"}
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA2ClG"}
package/dest/cli/cli.js CHANGED
@@ -26,7 +26,6 @@ Additional commands:
26
26
 
27
27
  init [folder] [options] creates a new Aztec Noir project.
28
28
  new <path> [options] creates a new Aztec Noir project in a new directory.
29
- compile [options] compiles Aztec Noir contracts.
30
29
  test [options] starts a TXE and runs "nargo test" using it as the oracle resolver.
31
30
  `);
32
31
  }
@@ -0,0 +1,4 @@
1
+ import type { LogFn } from '@aztec/foundation/log';
2
+ import type { Command } from 'commander';
3
+ export declare function injectCompileCommand(program: Command, log: LogFn): Command;
4
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tcGlsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL2NvbXBpbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFHbkQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBOEp6Qyx3QkFBZ0Isb0JBQW9CLENBQUMsT0FBTyxFQUFFLE9BQU8sRUFBRSxHQUFHLEVBQUUsS0FBSyxHQUFHLE9BQU8sQ0FzQjFFIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/compile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8JzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAsB1E"}
@@ -0,0 +1,160 @@
1
+ import { execFileSync } from 'child_process';
2
+ import { readFile, writeFile } from 'fs/promises';
3
+ import { join } from 'path';
4
+ import { readArtifactFiles } from './utils/artifacts.js';
5
+ import { run } from './utils/spawn.js';
6
+ /** Returns paths to contract artifacts in the target directory. */ async function collectContractArtifacts() {
7
+ let files;
8
+ try {
9
+ files = await readArtifactFiles('target');
10
+ } catch (err) {
11
+ if (err?.message?.includes('does not exist')) {
12
+ return [];
13
+ }
14
+ throw err;
15
+ }
16
+ return files.filter((f)=>Array.isArray(f.content.functions)).map((f)=>f.filePath);
17
+ }
18
+ /** Strips the `__aztec_nr_internals__` prefix from function names in contract artifacts. */ async function stripInternalPrefixes(artifactPaths) {
19
+ for (const path of artifactPaths){
20
+ const artifact = JSON.parse(await readFile(path, 'utf-8'));
21
+ for (const fn of artifact.functions){
22
+ if (typeof fn.name === 'string') {
23
+ fn.name = fn.name.replace(/^__aztec_nr_internals__/, '');
24
+ }
25
+ }
26
+ await writeFile(path, JSON.stringify(artifact, null, 2) + '\n');
27
+ }
28
+ }
29
+ /** Returns the set of package names that are contract crates in the current workspace. */ async function getContractPackageNames() {
30
+ const contractNames = new Set();
31
+ let rootToml;
32
+ try {
33
+ rootToml = await readFile('Nargo.toml', 'utf-8');
34
+ } catch {
35
+ return contractNames;
36
+ }
37
+ const membersMatch = rootToml.match(/members\s*=\s*\[([^\]]*)\]/);
38
+ if (membersMatch) {
39
+ const members = membersMatch[1].split(',').map((m)=>m.trim().replace(/^"|"$/g, '')).filter((m)=>m.length > 0);
40
+ for (const member of members){
41
+ try {
42
+ const memberToml = await readFile(join(member, 'Nargo.toml'), 'utf-8');
43
+ if (/type\s*=\s*"contract"/.test(memberToml)) {
44
+ const nameMatch = memberToml.match(/name\s*=\s*"([^"]+)"/);
45
+ if (nameMatch) {
46
+ contractNames.add(nameMatch[1]);
47
+ }
48
+ }
49
+ } catch {
50
+ // Member directory might not exist or have no Nargo.toml; skip.
51
+ }
52
+ }
53
+ } else {
54
+ // Single-crate project (no workspace): check if the root Nargo.toml itself is a contract.
55
+ if (/type\s*=\s*"contract"/.test(rootToml)) {
56
+ const nameMatch = rootToml.match(/name\s*=\s*"([^"]+)"/);
57
+ if (nameMatch) {
58
+ contractNames.add(nameMatch[1]);
59
+ }
60
+ }
61
+ }
62
+ return contractNames;
63
+ }
64
+ /** Checks that no tests exist in contract crates and fails with a helpful message if they do. */ async function checkNoTestsInContracts(nargo, log) {
65
+ const contractPackages = await getContractPackageNames();
66
+ if (contractPackages.size === 0) {
67
+ return;
68
+ }
69
+ let output;
70
+ try {
71
+ // We list tests for all the crates in the workspace
72
+ output = execFileSync(nargo, [
73
+ 'test',
74
+ '--list-tests',
75
+ '--silence-warnings'
76
+ ], {
77
+ encoding: 'utf-8',
78
+ stdio: [
79
+ 'pipe',
80
+ 'pipe',
81
+ 'inherit'
82
+ ]
83
+ });
84
+ } catch {
85
+ // If listing tests fails (e.g. test crate has compile errors), skip the check.
86
+ return;
87
+ }
88
+ // The output of the `nargo test --list-tests` command is as follows:
89
+ // ```
90
+ // crate_name_1 test_name_1
91
+ // crate_name_2 test_name_2
92
+ // ...
93
+ // crate_name_n test_name_n
94
+ // ```
95
+ //
96
+ // We parse the individual lines and then we check if any contract crate appeared in the parsed output.
97
+ const lines = output.trim().split('\n').filter((line)=>line.length > 0);
98
+ const testsInContracts = [];
99
+ for (const line of lines){
100
+ const spaceIndex = line.indexOf(' ');
101
+ if (spaceIndex === -1) {
102
+ continue;
103
+ }
104
+ const packageName = line.substring(0, spaceIndex);
105
+ const testName = line.substring(spaceIndex + 1);
106
+ if (contractPackages.has(packageName)) {
107
+ testsInContracts.push({
108
+ packageName,
109
+ testName
110
+ });
111
+ }
112
+ }
113
+ if (testsInContracts.length > 0) {
114
+ const details = testsInContracts.map((t)=>` ${t.packageName}::${t.testName}`).join('\n');
115
+ log(`WARNING: Found tests in contract crate(s):\n${details}\n\n` + `Tests should be in a dedicated test crate, not in the contract crate.\n` + `Learn more: https://docs.aztec.network/errors/1`);
116
+ }
117
+ }
118
+ /** Compiles Aztec Noir contracts and postprocesses artifacts. */ async function compileAztecContract(nargoArgs, log) {
119
+ const nargo = process.env.NARGO ?? 'nargo';
120
+ const bb = process.env.BB ?? 'bb';
121
+ await run(nargo, [
122
+ 'compile',
123
+ ...nargoArgs
124
+ ]);
125
+ // Ensure contract crates contain no tests (tests belong in the test crate).
126
+ await checkNoTestsInContracts(nargo, log);
127
+ const artifacts = await collectContractArtifacts();
128
+ if (artifacts.length > 0) {
129
+ log('Postprocessing contracts...');
130
+ const bbArgs = artifacts.flatMap((a)=>[
131
+ '-i',
132
+ a
133
+ ]);
134
+ await run(bb, [
135
+ 'aztec_process',
136
+ ...bbArgs
137
+ ]);
138
+ // TODO: This should be part of bb aztec_process!
139
+ await stripInternalPrefixes(artifacts);
140
+ }
141
+ log('Compilation complete!');
142
+ }
143
+ export function injectCompileCommand(program, log) {
144
+ program.command('compile').argument('[nargo-args...]').passThroughOptions().allowUnknownOption().description('Compile Aztec Noir contracts using nargo and postprocess them to generate transpiled artifacts and verification keys. All options are forwarded to nargo compile.').addHelpText('after', ()=>{
145
+ // Show nargo's own compile options so users see all available flags in one place.
146
+ const nargo = process.env.NARGO ?? 'nargo';
147
+ try {
148
+ const output = execFileSync(nargo, [
149
+ 'compile',
150
+ '--help'
151
+ ], {
152
+ encoding: 'utf-8'
153
+ });
154
+ return `\nUnderlying nargo compile options:\n\n${output}`;
155
+ } catch {
156
+ return '\n(Run "nargo compile --help" to see available nargo options)';
157
+ }
158
+ }).action((nargoArgs)=>compileAztecContract(nargoArgs, log));
159
+ return program;
160
+ }
@@ -0,0 +1,4 @@
1
+ import type { LogFn } from '@aztec/foundation/log';
2
+ import type { Command } from 'commander';
3
+ export declare function injectProfileCommand(program: Command, log: LogFn): Command;
4
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3Byb2ZpbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFbkQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBS3pDLHdCQUFnQixvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsT0FBTyxFQUFFLEdBQUcsRUFBRSxLQUFLLEdBQUcsT0FBTyxDQWlCMUUifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAiB1E"}
@@ -0,0 +1,8 @@
1
+ import { profileFlamegraph } from './profile_flamegraph.js';
2
+ import { profileGates } from './profile_gates.js';
3
+ export function injectProfileCommand(program, log) {
4
+ const profile = program.command('profile').description('Profile compiled Aztec artifacts.');
5
+ profile.command('gates').argument('[target-dir]', 'Path to the compiled artifacts directory', './target').description('Display gate counts for all compiled Aztec artifacts in a target directory.').action((targetDir)=>profileGates(targetDir, log));
6
+ profile.command('flamegraph').argument('<contract-artifact>', 'Path to the compiled contract artifact JSON').argument('<function>', 'Name of the contract function to profile').description('Generate a gate count flamegraph SVG for a contract function.').action((artifactPath, functionName)=>profileFlamegraph(artifactPath, functionName, log));
7
+ return program;
8
+ }
@@ -0,0 +1,4 @@
1
+ import type { LogFn } from '@aztec/foundation/log';
2
+ /** Generates a gate count flamegraph SVG for a single contract function. */
3
+ export declare function profileFlamegraph(artifactPath: string, functionName: string, log: LogFn): Promise<void>;
4
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZV9mbGFtZWdyYXBoLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY2xpL2NtZHMvcHJvZmlsZV9mbGFtZWdyYXBoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBU25ELDRFQUE0RTtBQUM1RSx3QkFBc0IsaUJBQWlCLENBQUMsWUFBWSxFQUFFLE1BQU0sRUFBRSxZQUFZLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxLQUFLLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQW9EN0cifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profile_flamegraph.d.ts","sourceRoot":"","sources":["../../../src/cli/cmds/profile_flamegraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AASnD,4EAA4E;AAC5E,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD7G"}
@@ -0,0 +1,51 @@
1
+ import { readFile, rename, rm, writeFile } from 'fs/promises';
2
+ import { basename, dirname, join } from 'path';
3
+ import { makeFunctionArtifact } from './profile_utils.js';
4
+ import { run } from './utils/spawn.js';
5
+ /** Generates a gate count flamegraph SVG for a single contract function. */ export async function profileFlamegraph(artifactPath, functionName, log) {
6
+ const raw = await readFile(artifactPath, 'utf-8');
7
+ const artifact = JSON.parse(raw);
8
+ if (!Array.isArray(artifact.functions)) {
9
+ throw new Error(`${artifactPath} does not appear to be a contract artifact (no functions array)`);
10
+ }
11
+ const func = artifact.functions.find((f)=>f.name === functionName);
12
+ if (!func) {
13
+ const available = artifact.functions.map((f)=>f.name).join(', ');
14
+ throw new Error(`Function "${functionName}" not found in artifact. Available: ${available}`);
15
+ }
16
+ if (func.is_unconstrained) {
17
+ throw new Error(`Function "${functionName}" is unconstrained and cannot be profiled`);
18
+ }
19
+ const outputDir = dirname(artifactPath);
20
+ const contractName = basename(artifactPath, '.json');
21
+ const functionArtifact = join(outputDir, `${contractName}-${functionName}.json`);
22
+ try {
23
+ await writeFile(functionArtifact, makeFunctionArtifact(artifact, func));
24
+ const profiler = process.env.PROFILER_PATH ?? 'noir-profiler';
25
+ const bb = process.env.BB ?? 'bb';
26
+ await run(profiler, [
27
+ 'gates',
28
+ '--artifact-path',
29
+ functionArtifact,
30
+ '--backend-path',
31
+ bb,
32
+ '--backend-gates-command',
33
+ 'gates',
34
+ '--output',
35
+ outputDir,
36
+ '--scheme',
37
+ 'chonk',
38
+ '--include_gates_per_opcode'
39
+ ]);
40
+ // noir-profiler names the SVG using the internal function name which
41
+ // retains the __aztec_nr_internals__ prefix in the bytecode metadata.
42
+ const srcSvg = join(outputDir, `__aztec_nr_internals__${functionName}_gates.svg`);
43
+ const destSvg = join(outputDir, `${contractName}-${functionName}-flamegraph.svg`);
44
+ await rename(srcSvg, destSvg);
45
+ log(`Flamegraph written to ${destSvg}`);
46
+ } finally{
47
+ await rm(functionArtifact, {
48
+ force: true
49
+ });
50
+ }
51
+ }
@@ -0,0 +1,4 @@
1
+ import type { LogFn } from '@aztec/foundation/log';
2
+ /** Profiles all compiled artifacts in a target directory and prints gate counts. */
3
+ export declare function profileGates(targetDir: string, log: LogFn): Promise<void>;
4
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZmlsZV9nYXRlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NsaS9jbWRzL3Byb2ZpbGVfZ2F0ZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUErQm5ELG9GQUFvRjtBQUNwRix3QkFBc0IsWUFBWSxDQUFDLFNBQVMsRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLEtBQUssR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBaUMvRSJ9