@aztec/aztec 0.0.1-commit.fffb133c → 0.0.1-dev

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 (142) hide show
  1. package/dest/bin/index.js +7 -3
  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 +72 -18
  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 +37 -14
  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 +3 -4
  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 +166 -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 +52 -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 +76 -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/standby.d.ts +58 -0
  30. package/dest/cli/cmds/standby.d.ts.map +1 -0
  31. package/dest/cli/cmds/standby.js +140 -0
  32. package/dest/cli/cmds/start_bot.d.ts +3 -3
  33. package/dest/cli/cmds/start_bot.d.ts.map +1 -1
  34. package/dest/cli/cmds/start_bot.js +9 -5
  35. package/dest/cli/cmds/start_node.d.ts +3 -2
  36. package/dest/cli/cmds/start_node.d.ts.map +1 -1
  37. package/dest/cli/cmds/start_node.js +74 -28
  38. package/dest/cli/cmds/start_p2p_bootstrap.d.ts +2 -2
  39. package/dest/cli/cmds/start_p2p_bootstrap.d.ts.map +1 -1
  40. package/dest/cli/cmds/start_p2p_bootstrap.js +1 -2
  41. package/dest/cli/cmds/start_prover_agent.d.ts +1 -1
  42. package/dest/cli/cmds/start_prover_agent.d.ts.map +1 -1
  43. package/dest/cli/cmds/start_prover_agent.js +6 -18
  44. package/dest/cli/cmds/start_prover_broker.d.ts +1 -1
  45. package/dest/cli/cmds/start_prover_broker.d.ts.map +1 -1
  46. package/dest/cli/cmds/start_prover_broker.js +16 -10
  47. package/dest/cli/cmds/utils/artifacts.d.ts +21 -0
  48. package/dest/cli/cmds/utils/artifacts.d.ts.map +1 -0
  49. package/dest/cli/cmds/utils/artifacts.js +24 -0
  50. package/dest/cli/cmds/utils/collect_crate_dirs.d.ts +21 -0
  51. package/dest/cli/cmds/utils/collect_crate_dirs.d.ts.map +1 -0
  52. package/dest/cli/cmds/utils/collect_crate_dirs.js +114 -0
  53. package/dest/cli/cmds/utils/needs_recompile.d.ts +10 -0
  54. package/dest/cli/cmds/utils/needs_recompile.d.ts.map +1 -0
  55. package/dest/cli/cmds/utils/needs_recompile.js +90 -0
  56. package/dest/cli/cmds/utils/spawn.d.ts +3 -0
  57. package/dest/cli/cmds/utils/spawn.d.ts.map +1 -0
  58. package/dest/cli/cmds/utils/spawn.js +16 -0
  59. package/dest/cli/cmds/utils/warn_if_aztec_version_mismatch.d.ts +4 -0
  60. package/dest/cli/cmds/utils/warn_if_aztec_version_mismatch.d.ts.map +1 -0
  61. package/dest/cli/cmds/utils/warn_if_aztec_version_mismatch.js +61 -0
  62. package/dest/cli/util.d.ts +13 -19
  63. package/dest/cli/util.d.ts.map +1 -1
  64. package/dest/cli/util.js +28 -93
  65. package/dest/examples/token.js +6 -6
  66. package/dest/local-network/banana_fpc.d.ts +1 -1
  67. package/dest/local-network/banana_fpc.d.ts.map +1 -1
  68. package/dest/local-network/banana_fpc.js +9 -7
  69. package/dest/local-network/local-network.d.ts +4 -2
  70. package/dest/local-network/local-network.d.ts.map +1 -1
  71. package/dest/local-network/local-network.js +50 -18
  72. package/dest/testing/anvil_test_watcher.d.ts +9 -1
  73. package/dest/testing/anvil_test_watcher.d.ts.map +1 -1
  74. package/dest/testing/anvil_test_watcher.js +81 -18
  75. package/dest/testing/cheat_codes.d.ts +11 -15
  76. package/dest/testing/cheat_codes.d.ts.map +1 -1
  77. package/dest/testing/cheat_codes.js +34 -32
  78. package/dest/testing/epoch_test_settler.d.ts +1 -1
  79. package/dest/testing/epoch_test_settler.d.ts.map +1 -1
  80. package/dest/testing/epoch_test_settler.js +3 -4
  81. package/dest/testing/index.d.ts +2 -1
  82. package/dest/testing/index.d.ts.map +1 -1
  83. package/dest/testing/index.js +1 -0
  84. package/dest/testing/token_allowed_setup.d.ts +7 -0
  85. package/dest/testing/token_allowed_setup.d.ts.map +1 -0
  86. package/dest/testing/token_allowed_setup.js +20 -0
  87. package/package.json +35 -34
  88. package/scripts/add_crate.sh +53 -0
  89. package/scripts/aztec.sh +10 -4
  90. package/scripts/init.sh +23 -19
  91. package/scripts/new.sh +48 -24
  92. package/scripts/setup_workspace.sh +69 -0
  93. package/scripts/templates/blank/contract/Nargo.toml +6 -0
  94. package/scripts/templates/blank/contract/src/main.nr +10 -0
  95. package/scripts/templates/blank/test/Nargo.toml +7 -0
  96. package/scripts/templates/blank/test/src/lib.nr +11 -0
  97. package/scripts/templates/counter/contract/Nargo.toml +7 -0
  98. package/scripts/templates/counter/contract/src/main.nr +48 -0
  99. package/scripts/templates/counter/test/Nargo.toml +7 -0
  100. package/scripts/templates/counter/test/src/lib.nr +32 -0
  101. package/src/bin/index.ts +7 -3
  102. package/src/cli/admin_api_key_store.ts +128 -0
  103. package/src/cli/aztec_start_action.ts +65 -14
  104. package/src/cli/aztec_start_options.ts +40 -16
  105. package/src/cli/cli.ts +3 -4
  106. package/src/cli/cmds/compile.ts +192 -0
  107. package/src/cli/cmds/profile.ts +26 -0
  108. package/src/cli/cmds/profile_flamegraph.ts +64 -0
  109. package/src/cli/cmds/profile_gates.ts +84 -0
  110. package/src/cli/cmds/profile_utils.ts +58 -0
  111. package/src/cli/cmds/standby.ts +184 -0
  112. package/src/cli/cmds/start_bot.ts +8 -5
  113. package/src/cli/cmds/start_node.ts +82 -39
  114. package/src/cli/cmds/start_p2p_bootstrap.ts +2 -2
  115. package/src/cli/cmds/start_prover_agent.ts +7 -10
  116. package/src/cli/cmds/start_prover_broker.ts +21 -17
  117. package/src/cli/cmds/utils/artifacts.ts +44 -0
  118. package/src/cli/cmds/utils/collect_crate_dirs.ts +118 -0
  119. package/src/cli/cmds/utils/needs_recompile.ts +98 -0
  120. package/src/cli/cmds/utils/spawn.ts +16 -0
  121. package/src/cli/cmds/utils/warn_if_aztec_version_mismatch.ts +76 -0
  122. package/src/cli/util.ts +31 -110
  123. package/src/examples/token.ts +8 -6
  124. package/src/local-network/banana_fpc.ts +5 -8
  125. package/src/local-network/local-network.ts +54 -17
  126. package/src/testing/anvil_test_watcher.ts +85 -18
  127. package/src/testing/cheat_codes.ts +42 -36
  128. package/src/testing/epoch_test_settler.ts +3 -4
  129. package/src/testing/index.ts +1 -0
  130. package/src/testing/token_allowed_setup.ts +19 -0
  131. package/dest/cli/cmds/start_prover_node.d.ts +0 -7
  132. package/dest/cli/cmds/start_prover_node.d.ts.map +0 -1
  133. package/dest/cli/cmds/start_prover_node.js +0 -108
  134. package/dest/cli/release_version.d.ts +0 -2
  135. package/dest/cli/release_version.d.ts.map +0 -1
  136. package/dest/cli/release_version.js +0 -14
  137. package/scripts/compile.sh +0 -44
  138. package/scripts/extract_function.js +0 -47
  139. package/scripts/flamegraph.sh +0 -59
  140. package/scripts/setup_project.sh +0 -31
  141. package/src/cli/cmds/start_prover_node.ts +0 -124
  142. package/src/cli/release_version.ts +0 -21
@@ -0,0 +1,84 @@
1
+ import { findBbBinary } from '@aztec/bb.js';
2
+ import { asyncPool } from '@aztec/foundation/async-pool';
3
+ import type { LogFn } from '@aztec/foundation/log';
4
+
5
+ import { execFile as execFileCb } from 'child_process';
6
+ import { rm } from 'fs/promises';
7
+ import { promisify } from 'util';
8
+
9
+ import { type DiscoveredArtifact, MAX_CONCURRENT, discoverArtifacts } from './profile_utils.js';
10
+
11
+ const execFile = promisify(execFileCb);
12
+
13
+ interface GateCountResult {
14
+ name: string;
15
+ type: DiscoveredArtifact['type'];
16
+ gateCount: number;
17
+ }
18
+
19
+ /** Parses circuit_size from bb gates JSON output: { "functions": [{ "circuit_size": N }] } */
20
+ function parseGateCount(stdout: string): number {
21
+ const parsed = JSON.parse(stdout);
22
+ const size = parsed?.functions?.[0]?.circuit_size;
23
+ if (typeof size !== 'number') {
24
+ throw new Error('Failed to parse circuit_size from bb gates output');
25
+ }
26
+ return size;
27
+ }
28
+
29
+ /** Runs bb gates on a single artifact file and returns the gate count. */
30
+ async function getGateCount(bb: string, artifactPath: string): Promise<number> {
31
+ const { stdout } = await execFile(bb, ['gates', '--scheme', 'chonk', '-b', artifactPath]);
32
+ return parseGateCount(stdout);
33
+ }
34
+
35
+ /** Profiles all compiled artifacts in a target directory and prints gate counts. */
36
+ export async function profileGates(targetDir: string, json: boolean, log: LogFn): Promise<void> {
37
+ const bb = process.env.BB ?? findBbBinary() ?? 'bb';
38
+ const { artifacts, tmpDir } = await discoverArtifacts(targetDir);
39
+
40
+ if (artifacts.length === 0) {
41
+ if (json) {
42
+ log('[]');
43
+ } else {
44
+ log('No artifacts found in target directory.');
45
+ }
46
+ return;
47
+ }
48
+
49
+ try {
50
+ const results: GateCountResult[] = await asyncPool(MAX_CONCURRENT, artifacts, async artifact => ({
51
+ name: artifact.name,
52
+ type: artifact.type,
53
+ gateCount: await getGateCount(bb, artifact.filePath),
54
+ }));
55
+ results.sort((a, b) => a.name.localeCompare(b.name));
56
+
57
+ if (results.length === 0) {
58
+ if (json) {
59
+ log('[]');
60
+ } else {
61
+ log('No constrained circuits found.');
62
+ }
63
+ return;
64
+ }
65
+
66
+ if (json) {
67
+ const entries = results.map(r => ({ name: r.name, type: r.type, gates: r.gateCount }));
68
+ log(JSON.stringify(entries, null, 2));
69
+ return;
70
+ }
71
+
72
+ const maxNameLen = Math.max(...results.map(r => r.name.length));
73
+ log('');
74
+ log('Gate counts:');
75
+ log('-'.repeat(maxNameLen + 16));
76
+ for (const { name, gateCount } of results) {
77
+ log(`${name.padEnd(maxNameLen)} ${gateCount.toLocaleString().padStart(12)}`);
78
+ }
79
+ log('-'.repeat(maxNameLen + 16));
80
+ log(`Total: ${results.length} circuit(s)`);
81
+ } finally {
82
+ await rm(tmpDir, { recursive: true, force: true });
83
+ }
84
+ }
@@ -0,0 +1,58 @@
1
+ import { mkdtemp, writeFile } from 'fs/promises';
2
+ import { tmpdir } from 'os';
3
+ import { join } from 'path';
4
+
5
+ import type { CompiledArtifact, ContractFunction } from './utils/artifacts.js';
6
+ import { readArtifactFiles } from './utils/artifacts.js';
7
+
8
+ export const MAX_CONCURRENT = 4;
9
+
10
+ export interface DiscoveredArtifact {
11
+ name: string;
12
+ filePath: string;
13
+ type: 'contract-function' | 'program';
14
+ }
15
+
16
+ /**
17
+ * Reads a target directory and returns a list of discovered artifacts with temp files
18
+ * created for contract functions. Caller must clean up tmpDir when done.
19
+ */
20
+ export async function discoverArtifacts(
21
+ targetDir: string,
22
+ ): Promise<{ artifacts: DiscoveredArtifact[]; tmpDir: string }> {
23
+ const files = await readArtifactFiles(targetDir);
24
+ const tmpDir = await mkdtemp(join(tmpdir(), 'aztec-profile-'));
25
+ const artifacts: DiscoveredArtifact[] = [];
26
+
27
+ for (const file of files) {
28
+ if (Array.isArray(file.content.functions)) {
29
+ for (const func of file.content.functions) {
30
+ if (!func.bytecode || func.is_unconstrained) {
31
+ continue;
32
+ }
33
+ const name = `${file.name}::${func.name}`;
34
+ const tmpPath = join(tmpDir, `${file.name}-${func.name}.json`);
35
+ await writeFile(tmpPath, makeFunctionArtifact(file.content, func));
36
+ artifacts.push({ name, filePath: tmpPath, type: 'contract-function' });
37
+ }
38
+ } else if (file.content.bytecode) {
39
+ artifacts.push({ name: file.name, filePath: file.filePath, type: 'program' });
40
+ }
41
+ }
42
+
43
+ return { artifacts, tmpDir };
44
+ }
45
+
46
+ /** Extracts a contract function as a standalone program artifact JSON string. */
47
+ export function makeFunctionArtifact(artifact: CompiledArtifact, func: ContractFunction) {
48
+ /* eslint-disable camelcase */
49
+ return JSON.stringify({
50
+ noir_version: artifact.noir_version,
51
+ hash: 0,
52
+ abi: func.abi,
53
+ bytecode: func.bytecode,
54
+ debug_symbols: func.debug_symbols,
55
+ file_map: artifact.file_map,
56
+ });
57
+ /* eslint-enable camelcase */
58
+ }
@@ -0,0 +1,184 @@
1
+ import { getInitialTestAccountsData } from '@aztec/accounts/testing';
2
+ import type { Fr } from '@aztec/aztec.js/fields';
3
+ import { getSponsoredFPCAddress } from '@aztec/cli/cli-utils';
4
+ import { getPublicClient } from '@aztec/ethereum/client';
5
+ import type { GenesisStateConfig } from '@aztec/ethereum/config';
6
+ import { RegistryContract, RollupContract } from '@aztec/ethereum/contracts';
7
+ import type { EthAddress } from '@aztec/foundation/eth-address';
8
+ import { startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
9
+ import { type LogFn, createLogger } from '@aztec/foundation/log';
10
+ import { retryUntil } from '@aztec/foundation/retry';
11
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
12
+ import type { VersionCheck } from '@aztec/stdlib/update-checker';
13
+ import { getGenesisValues } from '@aztec/world-state/testing';
14
+
15
+ import Koa from 'koa';
16
+
17
+ import { isShuttingDown, softShutdown } from '../util.js';
18
+
19
+ const ROLLUP_POLL_INTERVAL_S = 60;
20
+
21
+ /**
22
+ * Computes the expected genesis archive root from the genesis state config.
23
+ * Reads test accounts and sponsored FPC addresses as specified, then computes
24
+ * the genesis values including the archive root and prefilled public data.
25
+ */
26
+ export async function computeExpectedGenesisRoot(config: GenesisStateConfig, userLog: LogFn) {
27
+ const testAccounts = config.testAccounts ? (await getInitialTestAccountsData()).map(a => a.address) : [];
28
+ const sponsoredFPCAccounts = config.sponsoredFPC ? [await getSponsoredFPCAddress()] : [];
29
+ const prefundAddresses = (config.prefundAddresses ?? []).map(a => AztecAddress.fromString(a));
30
+ const initialFundedAccounts = testAccounts.concat(sponsoredFPCAccounts).concat(prefundAddresses);
31
+
32
+ userLog(`Initial funded accounts: ${initialFundedAccounts.map(a => a.toString()).join(', ')}`);
33
+
34
+ const { genesisArchiveRoot, prefilledPublicData } = await getGenesisValues(initialFundedAccounts);
35
+
36
+ userLog(`Genesis archive root: ${genesisArchiveRoot.toString()}`);
37
+
38
+ return { genesisArchiveRoot, prefilledPublicData };
39
+ }
40
+
41
+ /**
42
+ * Compares the rollup's on-chain protocol constants (genesis archive root, VK tree root, protocol
43
+ * contracts hash) against the node's expected local values. Returns a list of human-readable mismatch
44
+ * descriptions, empty if the rollup is compatible.
45
+ */
46
+ export async function checkRollupCompatibility(
47
+ rollup: RollupContract,
48
+ expected: { genesisArchiveRoot: Fr; vkTreeRoot: Fr; protocolContractsHash: Fr },
49
+ ): Promise<string[]> {
50
+ const mismatches: string[] = [];
51
+ const [l1Genesis, l1Vk, l1Protocol] = await Promise.all([
52
+ rollup.getGenesisArchiveTreeRoot(),
53
+ rollup.getVkTreeRoot(),
54
+ rollup.getProtocolContractsHash(),
55
+ ]);
56
+ if (!l1Genesis.equals(expected.genesisArchiveRoot)) {
57
+ mismatches.push(`genesis archive root (expected ${expected.genesisArchiveRoot}, got ${l1Genesis})`);
58
+ }
59
+ if (!l1Vk.equals(expected.vkTreeRoot)) {
60
+ mismatches.push(`VK tree root (expected ${expected.vkTreeRoot}, got ${l1Vk})`);
61
+ }
62
+ if (!l1Protocol.equals(expected.protocolContractsHash)) {
63
+ mismatches.push(`protocol contracts hash (expected ${expected.protocolContractsHash}, got ${l1Protocol})`);
64
+ }
65
+ return mismatches;
66
+ }
67
+
68
+ /**
69
+ * Waits until the canonical rollup's genesis archive root, VK tree root, and protocol contracts hash
70
+ * all match the expected local values. If the rollup is not yet compatible (e.g. during L1 contract upgrades),
71
+ * enters standby mode: starts a lightweight HTTP server for K8s liveness probes and polls every 60s
72
+ * until a compatible rollup appears.
73
+ */
74
+ export async function waitForCompatibleRollup(
75
+ config: {
76
+ l1RpcUrls: string[];
77
+ l1ChainId: number;
78
+ l1Contracts: { registryAddress: EthAddress };
79
+ rollupVersion?: number;
80
+ },
81
+ expected: { genesisArchiveRoot: Fr; vkTreeRoot: Fr; protocolContractsHash: Fr },
82
+ port: number | undefined,
83
+ userLog: LogFn,
84
+ ): Promise<void> {
85
+ const publicClient = getPublicClient(config);
86
+ const rollupVersion: number | 'canonical' = config.rollupVersion ?? 'canonical';
87
+
88
+ const registry = new RegistryContract(publicClient, config.l1Contracts.registryAddress);
89
+ const rollupAddress = await registry.getRollupAddress(rollupVersion);
90
+ const rollup = new RollupContract(publicClient, rollupAddress.toString());
91
+
92
+ let mismatches: string[];
93
+ try {
94
+ mismatches = await checkRollupCompatibility(rollup, expected);
95
+ } catch (err: any) {
96
+ throw new Error(`Could not retrieve rollup config from canonical rollup at ${rollupAddress}: ${err.message}`);
97
+ }
98
+
99
+ if (mismatches.length === 0) {
100
+ return;
101
+ }
102
+
103
+ userLog(
104
+ `Rollup at ${rollupAddress} is incompatible: ${mismatches.join('; ')}. ` +
105
+ `Entering standby mode. Will poll every ${ROLLUP_POLL_INTERVAL_S}s for a compatible rollup...`,
106
+ );
107
+
108
+ const standbyServer = await startHttpRpcServer({ getApp: () => new Koa(), isHealthy: () => true }, { port });
109
+ userLog(`Standby status server listening on port ${standbyServer.port}`);
110
+
111
+ try {
112
+ await retryUntil(
113
+ async () => {
114
+ const currentRollupAddress = await registry.getRollupAddress(rollupVersion);
115
+ const currentRollup = new RollupContract(publicClient, currentRollupAddress.toString());
116
+
117
+ let currentMismatches: string[];
118
+ try {
119
+ currentMismatches = await checkRollupCompatibility(currentRollup, expected);
120
+ } catch {
121
+ userLog(`Failed to fetch rollup config from rollup at ${currentRollupAddress}. Retrying...`);
122
+ return undefined;
123
+ }
124
+
125
+ if (currentMismatches.length === 0) {
126
+ userLog(`Compatible rollup found at ${currentRollupAddress}. Exiting standby mode.`);
127
+ return true;
128
+ }
129
+
130
+ userLog(`Still waiting. Rollup at ${currentRollupAddress}: ${currentMismatches.join('; ')}.`);
131
+ return undefined;
132
+ },
133
+ 'compatible rollup',
134
+ 0,
135
+ ROLLUP_POLL_INTERVAL_S,
136
+ );
137
+ } finally {
138
+ await new Promise<void>((resolve, reject) => standbyServer.close(err => (err ? reject(err) : resolve())));
139
+ }
140
+ }
141
+
142
+ /**
143
+ * Polls the canonical rollup's protocol constants every 10 minutes and soft-shuts-down the node once they
144
+ * diverge from the node's expected local values (i.e. an incompatible rollup has become canonical on L1).
145
+ * The HTTP health server is left running so K8s probes keep passing on the wound-down pod. This is the
146
+ * inverse of {@link waitForCompatibleRollup}; it should only be set up for nodes following the canonical
147
+ * rollup. Reuses the {@link checkRollupCompatibility} diff and the generic VersionChecker poll primitive.
148
+ */
149
+ export async function setupAutoShutdown(
150
+ config: { l1RpcUrls: string[]; l1ChainId: number },
151
+ registryAddress: EthAddress,
152
+ rollupVersion: number | 'canonical',
153
+ expected: { genesisArchiveRoot: Fr; vkTreeRoot: Fr; protocolContractsHash: Fr },
154
+ signalHandlers: Array<() => Promise<void>>,
155
+ ): Promise<void> {
156
+ const { VersionChecker } = await import('@aztec/stdlib/update-checker');
157
+
158
+ const logger = createLogger('auto_shutdown');
159
+ const publicClient = getPublicClient(config);
160
+ const registry = new RegistryContract(publicClient, registryAddress);
161
+
162
+ const check: VersionCheck = {
163
+ name: 'rollup',
164
+ currentVersion: 'compatible',
165
+ getLatestVersion: async () => {
166
+ const rollupAddress = await registry.getRollupAddress(rollupVersion);
167
+ const rollup = new RollupContract(publicClient, rollupAddress.toString());
168
+ const mismatches = await checkRollupCompatibility(rollup, expected);
169
+ return mismatches.length === 0 ? 'compatible' : `incompatible: ${mismatches.join('; ')}`;
170
+ },
171
+ };
172
+
173
+ const checker = new VersionChecker([check], 600_000, logger);
174
+ checker.on('newVersion', ({ latestVersion }) => {
175
+ if (isShuttingDown()) {
176
+ return;
177
+ }
178
+ logger.warn('Canonical rollup is no longer compatible; auto-shutting down node', { latestVersion });
179
+ // softShutdown never rejects (it awaits handlers via allSettled); fire-and-forget from the listener.
180
+ void softShutdown(logger.info.bind(logger), signalHandlers);
181
+ });
182
+ checker.start();
183
+ signalHandlers.push(() => checker.stop());
184
+ }
@@ -10,9 +10,9 @@ import {
10
10
  initTelemetryClient,
11
11
  makeTracedFetch,
12
12
  } from '@aztec/telemetry-client';
13
- import { TestWallet } from '@aztec/test-wallet/server';
13
+ import { EmbeddedWallet } from '@aztec/wallets/embedded';
14
14
 
15
- import { extractRelevantOptions } from '../util.js';
15
+ import { extractRelevantOptions, stringifyConfig } from '../util.js';
16
16
  import { getVersions } from '../versioning.js';
17
17
 
18
18
  export async function startBot(
@@ -38,22 +38,25 @@ export async function startBot(
38
38
  const aztecNode = createAztecNodeClient(config.nodeUrl, getVersions(), fetch);
39
39
 
40
40
  const pxeConfig = extractRelevantOptions<PXEConfig & CliPXEOptions>(options, allPxeConfigMappings, 'pxe');
41
- const wallet = await TestWallet.create(aztecNode, pxeConfig);
41
+ userLog(`Creating bot wallet with config ${stringifyConfig(pxeConfig)}`);
42
+ const wallet = await EmbeddedWallet.create(aztecNode, { pxeConfig });
42
43
 
43
44
  const telemetry = await initTelemetryClient(getTelemetryClientConfig());
44
- await addBot(options, signalHandlers, services, wallet, aztecNode, telemetry, undefined);
45
+ await addBot(options, signalHandlers, services, wallet, aztecNode, telemetry, undefined, userLog);
45
46
  }
46
47
 
47
48
  export async function addBot(
48
49
  options: any,
49
50
  signalHandlers: (() => Promise<void>)[],
50
51
  services: NamespacedApiHandlers,
51
- wallet: TestWallet,
52
+ wallet: EmbeddedWallet,
52
53
  aztecNode: AztecNode,
53
54
  telemetry: TelemetryClient,
54
55
  aztecNodeAdmin?: AztecNodeAdmin,
56
+ userLog?: LogFn,
55
57
  ) {
56
58
  const config = extractRelevantOptions<BotConfig>(options, botConfigMappings, 'bot');
59
+ userLog?.(`Starting bot with config ${stringifyConfig(config)}`);
57
60
 
58
61
  const db = await (config.dataDirectory
59
62
  ? createStore('bot', BotStore.SCHEMA_VERSION, config)
@@ -1,30 +1,34 @@
1
- import { getInitialTestAccountsData } from '@aztec/accounts/testing';
2
1
  import { type AztecNodeConfig, aztecNodeConfigMappings, getConfigEnvVars } from '@aztec/aztec-node';
3
2
  import { Fr } from '@aztec/aztec.js/fields';
4
- import { getSponsoredFPCAddress } from '@aztec/cli/cli-utils';
5
3
  import { getL1Config } from '@aztec/cli/config';
6
- import { getPublicClient } from '@aztec/ethereum/client';
7
- import { SecretValue } from '@aztec/foundation/config';
4
+ import { getGenesisStateConfigEnvVars } from '@aztec/ethereum/config';
5
+ import { type NetworkNames, SecretValue } from '@aztec/foundation/config';
8
6
  import type { NamespacedApiHandlers } from '@aztec/foundation/json-rpc/server';
7
+ import { Agent, makeUndiciFetch } from '@aztec/foundation/json-rpc/undici';
9
8
  import type { LogFn } from '@aztec/foundation/log';
9
+ import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
10
+ import { protocolContractsHash } from '@aztec/protocol-contracts';
11
+ import {
12
+ ProvingJobConsumerSchema,
13
+ createProvingJobBrokerClient,
14
+ proverBrokerBackoff,
15
+ } from '@aztec/prover-client/broker';
10
16
  import { type CliPXEOptions, type PXEConfig, allPxeConfigMappings } from '@aztec/pxe/config';
11
17
  import { AztecNodeAdminApiSchema, AztecNodeApiSchema } from '@aztec/stdlib/interfaces/client';
12
- import { P2PApiSchema } from '@aztec/stdlib/interfaces/server';
18
+ import { P2PApiSchema, ProverNodeApiSchema, type ProvingJobBroker } from '@aztec/stdlib/interfaces/server';
13
19
  import {
14
20
  type TelemetryClientConfig,
15
21
  initTelemetryClient,
22
+ makeTracedFetch,
16
23
  telemetryClientConfigMappings,
17
24
  } from '@aztec/telemetry-client';
18
- import { TestWallet } from '@aztec/test-wallet/server';
19
- import { getGenesisValues } from '@aztec/world-state/testing';
25
+ import { EmbeddedWallet } from '@aztec/wallets/embedded';
20
26
 
21
27
  import { createAztecNode } from '../../local-network/index.js';
22
- import {
23
- extractNamespacedOptions,
24
- extractRelevantOptions,
25
- preloadCrsDataForVerifying,
26
- setupUpdateMonitor,
27
- } from '../util.js';
28
+ import { extractNamespacedOptions, extractRelevantOptions, preloadCrsDataForVerifying } from '../util.js';
29
+ import { getVersions } from '../versioning.js';
30
+ import { computeExpectedGenesisRoot, setupAutoShutdown, waitForCompatibleRollup } from './standby.js';
31
+ import { startProverBroker } from './start_prover_broker.js';
28
32
 
29
33
  export async function startNode(
30
34
  options: any,
@@ -32,6 +36,7 @@ export async function startNode(
32
36
  services: NamespacedApiHandlers,
33
37
  adminServices: NamespacedApiHandlers,
34
38
  userLog: LogFn,
39
+ networkName: NetworkNames,
35
40
  ): Promise<{ config: AztecNodeConfig }> {
36
41
  // All options set from environment variables
37
42
  const configFromEnvVars = getConfigEnvVars();
@@ -45,22 +50,34 @@ export async function startNode(
45
50
  ...relevantOptions,
46
51
  };
47
52
 
53
+ // Prover node configuration and broker setup
54
+ // REFACTOR: Move the broker setup out of here and into the prover-node factory
55
+ let broker: ProvingJobBroker | undefined = undefined;
48
56
  if (options.proverNode) {
49
- userLog(`Running a Prover Node within a Node is not yet supported`);
50
- process.exit(1);
57
+ nodeConfig.enableProverNode = true;
58
+ if (nodeConfig.proverAgentCount === 0) {
59
+ userLog(
60
+ `Running prover node without local prover agent. Connect prover agents or pass --proverAgent.proverAgentCount`,
61
+ );
62
+ }
63
+ if (nodeConfig.proverBrokerUrl) {
64
+ // at 1TPS we'd enqueue ~1k chonk verifier proofs and ~1k AVM proofs immediately
65
+ // set a lower connection limit such that we don't overload the server
66
+ // Retry indefinitely until the epoch proving times out and the chain reorgs
67
+ const fetch = makeTracedFetch(proverBrokerBackoff, false, makeUndiciFetch(new Agent({ connections: 100 })));
68
+ broker = createProvingJobBrokerClient(nodeConfig.proverBrokerUrl, getVersions(nodeConfig), fetch);
69
+ } else if (options.proverBroker) {
70
+ ({ broker } = await startProverBroker(options, signalHandlers, services, userLog));
71
+ } else {
72
+ userLog(`--prover-broker-url or --prover-broker is required to start a Prover Node`);
73
+ process.exit(1);
74
+ }
51
75
  }
52
76
 
53
77
  await preloadCrsDataForVerifying(nodeConfig, userLog);
54
78
 
55
- const testAccounts = nodeConfig.testAccounts ? (await getInitialTestAccountsData()).map(a => a.address) : [];
56
- const sponsoredFPCAccounts = nodeConfig.sponsoredFPC ? [await getSponsoredFPCAddress()] : [];
57
- const initialFundedAccounts = testAccounts.concat(sponsoredFPCAccounts);
58
-
59
- userLog(`Initial funded accounts: ${initialFundedAccounts.map(a => a.toString()).join(', ')}`);
60
-
61
- const { genesisArchiveRoot, prefilledPublicData } = await getGenesisValues(initialFundedAccounts);
62
-
63
- userLog(`Genesis archive root: ${genesisArchiveRoot.toString()}`);
79
+ const genesisConfig = getGenesisStateConfigEnvVars();
80
+ const { genesisArchiveRoot, prefilledPublicData } = await computeExpectedGenesisRoot(genesisConfig, userLog);
64
81
 
65
82
  const followsCanonicalRollup =
66
83
  typeof nodeConfig.rollupVersion !== 'number' || (nodeConfig.rollupVersion as unknown as string) === 'canonical';
@@ -68,6 +85,16 @@ export async function startNode(
68
85
  if (!nodeConfig.l1Contracts.registryAddress || nodeConfig.l1Contracts.registryAddress.isZero()) {
69
86
  throw new Error('L1 registry address is required to start Aztec Node');
70
87
  }
88
+
89
+ // Wait for a compatible rollup before proceeding with full L1 config fetch.
90
+ // This prevents crashes when the canonical rollup hasn't been upgraded yet.
91
+ await waitForCompatibleRollup(
92
+ nodeConfig,
93
+ { genesisArchiveRoot, vkTreeRoot: getVKTreeRoot(), protocolContractsHash },
94
+ options.port,
95
+ userLog,
96
+ );
97
+
71
98
  const { addresses, config } = await getL1Config(
72
99
  nodeConfig.l1Contracts.registryAddress,
73
100
  nodeConfig.l1RpcUrls,
@@ -101,12 +128,17 @@ export async function startNode(
101
128
  ...extractNamespacedOptions(options, 'sequencer'),
102
129
  };
103
130
  // If no publisher private keys have been given, use the first validator key
104
- if (sequencerConfig.publisherPrivateKeys === undefined || !sequencerConfig.publisherPrivateKeys.length) {
131
+ if (
132
+ sequencerConfig.sequencerPublisherPrivateKeys === undefined ||
133
+ !sequencerConfig.sequencerPublisherPrivateKeys.length
134
+ ) {
105
135
  if (sequencerConfig.validatorPrivateKeys?.getValue().length) {
106
- sequencerConfig.publisherPrivateKeys = [new SecretValue(sequencerConfig.validatorPrivateKeys.getValue()[0])];
136
+ sequencerConfig.sequencerPublisherPrivateKeys = [
137
+ new SecretValue(sequencerConfig.validatorPrivateKeys.getValue()[0]),
138
+ ];
107
139
  }
108
140
  }
109
- nodeConfig.publisherPrivateKeys = sequencerConfig.publisherPrivateKeys;
141
+ nodeConfig.sequencerPublisherPrivateKeys = sequencerConfig.sequencerPublisherPrivateKeys;
110
142
  }
111
143
 
112
144
  if (nodeConfig.p2pEnabled) {
@@ -120,13 +152,22 @@ export async function startNode(
120
152
  const telemetry = await initTelemetryClient(telemetryConfig);
121
153
 
122
154
  // Create and start Aztec Node
123
- const node = await createAztecNode(nodeConfig, { telemetry }, { prefilledPublicData });
155
+ const node = await createAztecNode(nodeConfig, { telemetry, proverBroker: broker }, { prefilledPublicData });
124
156
 
125
157
  // Add node and p2p to services list
126
158
  services.node = [node, AztecNodeApiSchema];
127
159
  services.p2p = [node.getP2P(), P2PApiSchema];
128
160
  adminServices.nodeAdmin = [node, AztecNodeAdminApiSchema];
129
161
 
162
+ // Register prover-node services if the prover node subsystem is running
163
+ const proverNode = node.getProverNode();
164
+ if (proverNode) {
165
+ services.prover = [proverNode, ProverNodeApiSchema];
166
+ if (!nodeConfig.proverBrokerUrl) {
167
+ services.provingJobSource = [proverNode.getProver().getProvingJobSource(), ProvingJobConsumerSchema];
168
+ }
169
+ }
170
+
130
171
  // Add node stop function to signal handlers
131
172
  signalHandlers.push(node.stop.bind(node));
132
173
 
@@ -135,21 +176,23 @@ export async function startNode(
135
176
  const { addBot } = await import('./start_bot.js');
136
177
 
137
178
  const pxeConfig = extractRelevantOptions<PXEConfig & CliPXEOptions>(options, allPxeConfigMappings, 'pxe');
138
- const wallet = await TestWallet.create(node, pxeConfig);
179
+ const wallet = await EmbeddedWallet.create(node, { pxeConfig });
139
180
 
140
181
  await addBot(options, signalHandlers, services, wallet, node, telemetry, undefined);
141
182
  }
142
183
 
143
- if (nodeConfig.autoUpdate !== 'disabled' && nodeConfig.autoUpdateUrl) {
144
- await setupUpdateMonitor(
145
- nodeConfig.autoUpdate,
146
- new URL(nodeConfig.autoUpdateUrl),
147
- followsCanonicalRollup,
148
- getPublicClient(nodeConfig!),
149
- nodeConfig.l1Contracts.registryAddress,
150
- signalHandlers,
151
- async config => node.setConfig((await AztecNodeAdminApiSchema.setConfig.parameters().parseAsync([config]))[0]),
152
- );
184
+ if (nodeConfig.enableAutoShutdown && networkName !== 'local' && followsCanonicalRollup) {
185
+ try {
186
+ await setupAutoShutdown(
187
+ nodeConfig,
188
+ nodeConfig.l1Contracts.registryAddress,
189
+ (nodeConfig.rollupVersion as number | 'canonical') ?? 'canonical',
190
+ { genesisArchiveRoot, vkTreeRoot: getVKTreeRoot(), protocolContractsHash },
191
+ signalHandlers,
192
+ );
193
+ } catch {
194
+ /* no-op */
195
+ }
153
196
  }
154
197
 
155
198
  return { config: nodeConfig };
@@ -1,6 +1,6 @@
1
1
  import { jsonStringify } from '@aztec/foundation/json-rpc';
2
2
  import type { NamespacedApiHandlers } from '@aztec/foundation/json-rpc/server';
3
- import { type LogFn, createLogger } from '@aztec/foundation/log';
3
+ import type { LogFn } from '@aztec/foundation/log';
4
4
  import { createStore } from '@aztec/kv-store/lmdb-v2';
5
5
  import { type BootnodeConfig, BootstrapNode, bootnodeConfigMappings } from '@aztec/p2p';
6
6
  import { emptyChainConfig } from '@aztec/stdlib/config';
@@ -27,7 +27,7 @@ export async function startP2PBootstrap(
27
27
  const telemetryConfig = extractRelevantOptions<TelemetryClientConfig>(options, telemetryClientConfigMappings, 'tel');
28
28
  const telemetryClient = await initTelemetryClient(telemetryConfig);
29
29
 
30
- const store = await createStore('p2p-bootstrap', 1, config, createLogger('p2p:bootstrap:store'));
30
+ const store = await createStore('p2p-bootstrap', 1, config);
31
31
  const node = new BootstrapNode(store, telemetryClient);
32
32
  await node.start(config);
33
33
  signalHandlers.push(() => node.stop());
@@ -4,11 +4,12 @@ import { Agent, makeUndiciFetch } from '@aztec/foundation/json-rpc/undici';
4
4
  import type { LogFn } from '@aztec/foundation/log';
5
5
  import { buildServerCircuitProver } from '@aztec/prover-client';
6
6
  import {
7
- InlineProofStore,
8
7
  type ProverAgentConfig,
9
8
  ProvingAgent,
9
+ createProofStore,
10
10
  createProvingJobBrokerClient,
11
11
  proverAgentConfigMappings,
12
+ proverBrokerBackoff,
12
13
  } from '@aztec/prover-client/broker';
13
14
  import { getProverNodeAgentConfigFromEnv } from '@aztec/prover-node';
14
15
  import { ProverAgentApiSchema } from '@aztec/stdlib/interfaces/server';
@@ -23,8 +24,8 @@ export async function startProverAgent(
23
24
  services: NamespacedApiHandlers,
24
25
  userLog: LogFn,
25
26
  ) {
26
- if (options.node || options.sequencer || options.pxe || options.p2pBootstrap || options.txe) {
27
- userLog(`Starting a prover agent with --node, --sequencer, --pxe, --p2p-bootstrap, or --txe is not supported.`);
27
+ if (options.node || options.sequencer || options.p2pBootstrap || options.txe) {
28
+ userLog(`Starting a prover agent with --node, --sequencer, --p2p-bootstrap, or --txe is not supported.`);
28
29
  process.exit(1);
29
30
  }
30
31
 
@@ -45,17 +46,13 @@ export async function startProverAgent(
45
46
 
46
47
  await preloadCrsDataForServerSideProving(config, userLog);
47
48
 
48
- const fetch = makeTracedFetch(
49
- // retry connections every 3s, up to 30s before giving up
50
- [1, 2, 3, 3, 3, 3, 3, 3, 3, 3, 3],
51
- false,
52
- makeUndiciFetch(new Agent({ connections: 10 })),
53
- );
49
+ // Retry indefinitely until the epoch proving times out and the chain reorgs
50
+ const fetch = makeTracedFetch(proverBrokerBackoff, false, makeUndiciFetch(new Agent({ connections: 10 })));
54
51
  const broker = createProvingJobBrokerClient(config.proverBrokerUrl, getVersions(), fetch);
55
52
 
56
53
  const telemetry = await initTelemetryClient(extractRelevantOptions(options, telemetryClientConfigMappings, 'tel'));
57
54
  const prover = await buildServerCircuitProver(config, telemetry);
58
- const proofStore = new InlineProofStore();
55
+ const proofStore = await createProofStore(config.proofStore);
59
56
  const agents = times(
60
57
  config.proverAgentCount,
61
58
  () => new ProvingAgent(broker, proofStore, prover, config.proverAgentProofTypes, config.proverAgentPollIntervalMs),