@aztec/cli 0.0.1-commit.9372f48 → 0.0.1-commit.949a33fd8

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 (53) hide show
  1. package/dest/cmds/aztec_node/block_number.js +1 -1
  2. package/dest/cmds/aztec_node/get_node_info.d.ts +1 -1
  3. package/dest/cmds/aztec_node/get_node_info.d.ts.map +1 -1
  4. package/dest/cmds/aztec_node/get_node_info.js +0 -2
  5. package/dest/cmds/infrastructure/setup_l2_contract.d.ts +1 -1
  6. package/dest/cmds/infrastructure/setup_l2_contract.d.ts.map +1 -1
  7. package/dest/cmds/infrastructure/setup_l2_contract.js +3 -2
  8. package/dest/cmds/l1/compute_genesis_values.d.ts +4 -0
  9. package/dest/cmds/l1/compute_genesis_values.d.ts.map +1 -0
  10. package/dest/cmds/l1/compute_genesis_values.js +17 -0
  11. package/dest/cmds/l1/deploy_l1_contracts_cmd.d.ts +1 -1
  12. package/dest/cmds/l1/deploy_l1_contracts_cmd.d.ts.map +1 -1
  13. package/dest/cmds/l1/deploy_l1_contracts_cmd.js +0 -1
  14. package/dest/cmds/l1/deploy_new_rollup.d.ts +1 -1
  15. package/dest/cmds/l1/deploy_new_rollup.d.ts.map +1 -1
  16. package/dest/cmds/l1/deploy_new_rollup.js +2 -4
  17. package/dest/cmds/l1/index.d.ts +1 -1
  18. package/dest/cmds/l1/index.d.ts.map +1 -1
  19. package/dest/cmds/l1/index.js +4 -0
  20. package/dest/cmds/l1/update_l1_validators.js +5 -5
  21. package/dest/config/cached_fetch.d.ts +19 -10
  22. package/dest/config/cached_fetch.d.ts.map +1 -1
  23. package/dest/config/cached_fetch.js +110 -32
  24. package/dest/config/chain_l2_config.d.ts +1 -1
  25. package/dest/config/chain_l2_config.d.ts.map +1 -1
  26. package/dest/config/chain_l2_config.js +3 -1
  27. package/dest/config/generated/networks.d.ts +49 -39
  28. package/dest/config/generated/networks.d.ts.map +1 -1
  29. package/dest/config/generated/networks.js +50 -40
  30. package/dest/config/network_config.d.ts +1 -1
  31. package/dest/config/network_config.d.ts.map +1 -1
  32. package/dest/config/network_config.js +6 -2
  33. package/dest/utils/aztec.d.ts +1 -2
  34. package/dest/utils/aztec.d.ts.map +1 -1
  35. package/dest/utils/aztec.js +2 -3
  36. package/dest/utils/inspect.d.ts +1 -1
  37. package/dest/utils/inspect.d.ts.map +1 -1
  38. package/dest/utils/inspect.js +6 -5
  39. package/package.json +30 -30
  40. package/src/cmds/aztec_node/block_number.ts +1 -1
  41. package/src/cmds/aztec_node/get_node_info.ts +0 -2
  42. package/src/cmds/infrastructure/setup_l2_contract.ts +4 -3
  43. package/src/cmds/l1/compute_genesis_values.ts +29 -0
  44. package/src/cmds/l1/deploy_l1_contracts_cmd.ts +0 -1
  45. package/src/cmds/l1/deploy_new_rollup.ts +1 -3
  46. package/src/cmds/l1/index.ts +18 -0
  47. package/src/cmds/l1/update_l1_validators.ts +5 -5
  48. package/src/config/cached_fetch.ts +119 -31
  49. package/src/config/chain_l2_config.ts +3 -1
  50. package/src/config/generated/networks.ts +48 -38
  51. package/src/config/network_config.ts +6 -2
  52. package/src/utils/aztec.ts +12 -18
  53. package/src/utils/inspect.ts +4 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/cli",
3
- "version": "0.0.1-commit.9372f48",
3
+ "version": "0.0.1-commit.949a33fd8",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./contracts": "./dest/cmds/contracts/index.js",
@@ -77,23 +77,23 @@
77
77
  ]
78
78
  },
79
79
  "dependencies": {
80
- "@aztec/accounts": "0.0.1-commit.9372f48",
81
- "@aztec/archiver": "0.0.1-commit.9372f48",
82
- "@aztec/aztec.js": "0.0.1-commit.9372f48",
83
- "@aztec/constants": "0.0.1-commit.9372f48",
84
- "@aztec/entrypoints": "0.0.1-commit.9372f48",
85
- "@aztec/ethereum": "0.0.1-commit.9372f48",
86
- "@aztec/foundation": "0.0.1-commit.9372f48",
87
- "@aztec/l1-artifacts": "0.0.1-commit.9372f48",
88
- "@aztec/node-keystore": "0.0.1-commit.9372f48",
89
- "@aztec/node-lib": "0.0.1-commit.9372f48",
90
- "@aztec/p2p": "0.0.1-commit.9372f48",
91
- "@aztec/protocol-contracts": "0.0.1-commit.9372f48",
92
- "@aztec/sequencer-client": "0.0.1-commit.9372f48",
93
- "@aztec/slasher": "0.0.1-commit.9372f48",
94
- "@aztec/stdlib": "0.0.1-commit.9372f48",
95
- "@aztec/test-wallet": "0.0.1-commit.9372f48",
96
- "@aztec/world-state": "0.0.1-commit.9372f48",
80
+ "@aztec/accounts": "0.0.1-commit.949a33fd8",
81
+ "@aztec/archiver": "0.0.1-commit.949a33fd8",
82
+ "@aztec/aztec.js": "0.0.1-commit.949a33fd8",
83
+ "@aztec/constants": "0.0.1-commit.949a33fd8",
84
+ "@aztec/entrypoints": "0.0.1-commit.949a33fd8",
85
+ "@aztec/ethereum": "0.0.1-commit.949a33fd8",
86
+ "@aztec/foundation": "0.0.1-commit.949a33fd8",
87
+ "@aztec/l1-artifacts": "0.0.1-commit.949a33fd8",
88
+ "@aztec/node-keystore": "0.0.1-commit.949a33fd8",
89
+ "@aztec/node-lib": "0.0.1-commit.949a33fd8",
90
+ "@aztec/p2p": "0.0.1-commit.949a33fd8",
91
+ "@aztec/protocol-contracts": "0.0.1-commit.949a33fd8",
92
+ "@aztec/sequencer-client": "0.0.1-commit.949a33fd8",
93
+ "@aztec/slasher": "0.0.1-commit.949a33fd8",
94
+ "@aztec/stdlib": "0.0.1-commit.949a33fd8",
95
+ "@aztec/wallets": "0.0.1-commit.949a33fd8",
96
+ "@aztec/world-state": "0.0.1-commit.949a33fd8",
97
97
  "@ethersproject/wallet": "^5.8.0",
98
98
  "@iarna/toml": "^2.2.5",
99
99
  "@libp2p/peer-id-factory": "^3.0.4",
@@ -107,9 +107,9 @@
107
107
  "viem": "npm:@aztec/viem@2.38.2"
108
108
  },
109
109
  "devDependencies": {
110
- "@aztec/aztec-node": "0.0.1-commit.9372f48",
111
- "@aztec/kv-store": "0.0.1-commit.9372f48",
112
- "@aztec/telemetry-client": "0.0.1-commit.9372f48",
110
+ "@aztec/aztec-node": "0.0.1-commit.949a33fd8",
111
+ "@aztec/kv-store": "0.0.1-commit.949a33fd8",
112
+ "@aztec/telemetry-client": "0.0.1-commit.949a33fd8",
113
113
  "@jest/globals": "^30.0.0",
114
114
  "@types/jest": "^30.0.0",
115
115
  "@types/lodash.chunk": "^4.2.9",
@@ -126,15 +126,15 @@
126
126
  "typescript": "^5.3.3"
127
127
  },
128
128
  "peerDependencies": {
129
- "@aztec/accounts": "0.0.1-commit.9372f48",
130
- "@aztec/bb-prover": "0.0.1-commit.9372f48",
131
- "@aztec/ethereum": "0.0.1-commit.9372f48",
132
- "@aztec/l1-artifacts": "0.0.1-commit.9372f48",
133
- "@aztec/noir-contracts.js": "0.0.1-commit.9372f48",
134
- "@aztec/noir-protocol-circuits-types": "0.0.1-commit.9372f48",
135
- "@aztec/noir-test-contracts.js": "0.0.1-commit.9372f48",
136
- "@aztec/protocol-contracts": "0.0.1-commit.9372f48",
137
- "@aztec/stdlib": "0.0.1-commit.9372f48"
129
+ "@aztec/accounts": "0.0.1-commit.949a33fd8",
130
+ "@aztec/bb-prover": "0.0.1-commit.949a33fd8",
131
+ "@aztec/ethereum": "0.0.1-commit.949a33fd8",
132
+ "@aztec/l1-artifacts": "0.0.1-commit.949a33fd8",
133
+ "@aztec/noir-contracts.js": "0.0.1-commit.949a33fd8",
134
+ "@aztec/noir-protocol-circuits-types": "0.0.1-commit.949a33fd8",
135
+ "@aztec/noir-test-contracts.js": "0.0.1-commit.949a33fd8",
136
+ "@aztec/protocol-contracts": "0.0.1-commit.949a33fd8",
137
+ "@aztec/stdlib": "0.0.1-commit.949a33fd8"
138
138
  },
139
139
  "files": [
140
140
  "dest",
@@ -3,7 +3,7 @@ import type { LogFn } from '@aztec/foundation/log';
3
3
 
4
4
  export async function blockNumber(nodeUrl: string, log: LogFn) {
5
5
  const aztecNode = createAztecNodeClient(nodeUrl);
6
- const [latestNum, provenNum] = await Promise.all([aztecNode.getBlockNumber(), aztecNode.getProvenBlockNumber()]);
6
+ const [latestNum, provenNum] = await Promise.all([aztecNode.getBlockNumber(), aztecNode.getBlockNumber('proven')]);
7
7
  log(`Latest block: ${latestNum}`);
8
8
  log(`Proven block: ${provenNum}`);
9
9
  }
@@ -23,7 +23,6 @@ export async function getNodeInfo(nodeUrl: string, json: boolean, log: LogFn, lo
23
23
  rewardDistributor: info.l1ContractAddresses.rewardDistributorAddress.toString(),
24
24
  governanceProposer: info.l1ContractAddresses.governanceProposerAddress.toString(),
25
25
  governance: info.l1ContractAddresses.governanceAddress.toString(),
26
- slashFactory: info.l1ContractAddresses.slashFactoryAddress?.toString(),
27
26
  feeAssetHandler: info.l1ContractAddresses.feeAssetHandlerAddress?.toString(),
28
27
  stakingAssetHandler: info.l1ContractAddresses.stakingAssetHandlerAddress?.toString(),
29
28
  },
@@ -51,7 +50,6 @@ export async function getNodeInfo(nodeUrl: string, json: boolean, log: LogFn, lo
51
50
  log(` RewardDistributor Address: ${info.l1ContractAddresses.rewardDistributorAddress.toString()}`);
52
51
  log(` GovernanceProposer Address: ${info.l1ContractAddresses.governanceProposerAddress.toString()}`);
53
52
  log(` Governance Address: ${info.l1ContractAddresses.governanceAddress.toString()}`);
54
- log(` SlashFactory Address: ${info.l1ContractAddresses.slashFactoryAddress?.toString()}`);
55
53
  log(` FeeAssetHandler Address: ${info.l1ContractAddresses.feeAssetHandlerAddress?.toString()}`);
56
54
  log(` StakingAssetHandler Address: ${info.l1ContractAddresses.stakingAssetHandlerAddress?.toString()}`);
57
55
  log(`L2 Contract Addresses:`);
@@ -1,12 +1,13 @@
1
1
  import { getInitialTestAccountsData } from '@aztec/accounts/testing';
2
- import type { AztecAddress } from '@aztec/aztec.js/addresses';
2
+ import { AztecAddress } from '@aztec/aztec.js/addresses';
3
3
  import type { WaitOpts } from '@aztec/aztec.js/contracts';
4
4
  import { createAztecNodeClient } from '@aztec/aztec.js/node';
5
5
  import { AccountManager } from '@aztec/aztec.js/wallet';
6
6
  import { jsonStringify } from '@aztec/foundation/json-rpc';
7
7
  import type { LogFn } from '@aztec/foundation/log';
8
8
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
9
- import { TestWallet, deployFundedSchnorrAccounts } from '@aztec/test-wallet/server';
9
+ import { EmbeddedWallet } from '@aztec/wallets/embedded';
10
+ import { deployFundedSchnorrAccounts } from '@aztec/wallets/testing';
10
11
 
11
12
  export async function setupL2Contracts(nodeUrl: string, testAccounts: boolean, json: boolean, log: LogFn) {
12
13
  const waitOpts: WaitOpts = {
@@ -16,7 +17,7 @@ export async function setupL2Contracts(nodeUrl: string, testAccounts: boolean, j
16
17
  log('setupL2Contracts: Wait options' + jsonStringify(waitOpts));
17
18
  log('setupL2Contracts: Creating PXE client...');
18
19
  const node = createAztecNodeClient(nodeUrl);
19
- const wallet = await TestWallet.create(node);
20
+ const wallet = await EmbeddedWallet.create(node);
20
21
 
21
22
  let deployedAccountManagers: AccountManager[] = [];
22
23
  if (testAccounts) {
@@ -0,0 +1,29 @@
1
+ import { getInitialTestAccountsData } from '@aztec/accounts/testing';
2
+ import type { LogFn } from '@aztec/foundation/log';
3
+ import { protocolContractsHash } from '@aztec/protocol-contracts';
4
+ import { getGenesisValues } from '@aztec/world-state/testing';
5
+
6
+ import { getSponsoredFPCAddress } from '../../utils/setup_contracts.js';
7
+
8
+ /** Computes and prints genesis values needed for L1 contract deployment. */
9
+ export async function computeGenesisValuesCmd(testAccounts: boolean, sponsoredFPC: boolean, log: LogFn) {
10
+ const initialAccounts = testAccounts ? await getInitialTestAccountsData() : [];
11
+ const sponsoredFPCAddresses = sponsoredFPC ? await getSponsoredFPCAddress() : [];
12
+ const initialFundedAccounts = initialAccounts.map(a => a.address).concat(sponsoredFPCAddresses);
13
+ const { genesisArchiveRoot } = await getGenesisValues(initialFundedAccounts);
14
+
15
+ const { getVKTreeRoot } = await import('@aztec/noir-protocol-circuits-types/vk-tree');
16
+ const vkTreeRoot = getVKTreeRoot();
17
+
18
+ log(
19
+ JSON.stringify(
20
+ {
21
+ vkTreeRoot: vkTreeRoot.toString(),
22
+ protocolContractsHash: protocolContractsHash.toString(),
23
+ genesisArchiveRoot: genesisArchiveRoot.toString(),
24
+ },
25
+ null,
26
+ 2,
27
+ ),
28
+ );
29
+ }
@@ -96,7 +96,6 @@ export async function deployL1ContractsCmd(
96
96
  log(`RewardDistributor Address: ${l1ContractAddresses.rewardDistributorAddress.toString()}`);
97
97
  log(`GovernanceProposer Address: ${l1ContractAddresses.governanceProposerAddress.toString()}`);
98
98
  log(`Governance Address: ${l1ContractAddresses.governanceAddress.toString()}`);
99
- log(`SlashFactory Address: ${l1ContractAddresses.slashFactoryAddress?.toString()}`);
100
99
  log(`FeeAssetHandler Address: ${l1ContractAddresses.feeAssetHandlerAddress?.toString()}`);
101
100
  log(`StakingAssetHandler Address: ${l1ContractAddresses.stakingAssetHandlerAddress?.toString()}`);
102
101
  log(`ZK Passport Verifier Address: ${l1ContractAddresses.zkPassportVerifierAddress?.toString()}`);
@@ -29,7 +29,7 @@ export async function deployNewRollup(
29
29
  const initialFundedAccounts = initialAccounts.map(a => a.address).concat(sponsoredFPCAddress);
30
30
  const { genesisArchiveRoot, fundingNeeded } = await getGenesisValues(initialFundedAccounts);
31
31
 
32
- const { rollup, slashFactoryAddress } = await deployNewRollupContracts(
32
+ const { rollup } = await deployNewRollupContracts(
33
33
  registryAddress,
34
34
  rpcUrls,
35
35
  privateKey,
@@ -51,7 +51,6 @@ export async function deployNewRollup(
51
51
  initialFundedAccounts: initialFundedAccounts.map(a => a.toString()),
52
52
  initialValidators: initialValidators.map(a => a.attester.toString()),
53
53
  genesisArchiveRoot: genesisArchiveRoot.toString(),
54
- slashFactoryAddress: slashFactoryAddress.toString(),
55
54
  },
56
55
  null,
57
56
  2,
@@ -62,6 +61,5 @@ export async function deployNewRollup(
62
61
  log(`Initial funded accounts: ${initialFundedAccounts.map(a => a.toString()).join(', ')}`);
63
62
  log(`Initial validators: ${initialValidators.map(a => a.attester.toString()).join(', ')}`);
64
63
  log(`Genesis archive root: ${genesisArchiveRoot.toString()}`);
65
- log(`Slash Factory Address: ${slashFactoryAddress.toString()}`);
66
64
  }
67
65
  }
@@ -106,6 +106,24 @@ export function injectCommands(program: Command, log: LogFn, debugLogger: Logger
106
106
  );
107
107
  });
108
108
 
109
+ program
110
+ .command('compute-genesis-values')
111
+ .description('Computes genesis values (VK tree root, protocol contracts hash, genesis archive root).')
112
+ .addOption(
113
+ new Option('--test-accounts <boolean>', 'Include initial test accounts in genesis state')
114
+ .env('TEST_ACCOUNTS')
115
+ .argParser(arg => arg === 'true'),
116
+ )
117
+ .addOption(
118
+ new Option('--sponsored-fpc <boolean>', 'Include sponsored FPC contract in genesis state')
119
+ .env('SPONSORED_FPC')
120
+ .argParser(arg => arg === 'true'),
121
+ )
122
+ .action(async options => {
123
+ const { computeGenesisValuesCmd } = await import('./compute_genesis_values.js');
124
+ await computeGenesisValuesCmd(options.testAccounts, options.sponsoredFpc, log);
125
+ });
126
+
109
127
  program
110
128
  .command('deposit-governance-tokens')
111
129
  .description('Deposits governance tokens to the governance contract.')
@@ -2,7 +2,7 @@ import { createEthereumChain, isAnvilTestChain } from '@aztec/ethereum/chain';
2
2
  import { createExtendedL1Client, getPublicClient } from '@aztec/ethereum/client';
3
3
  import { getL1ContractsConfigEnvVars } from '@aztec/ethereum/config';
4
4
  import { GSEContract, RollupContract } from '@aztec/ethereum/contracts';
5
- import { createL1TxUtilsFromViemWallet } from '@aztec/ethereum/l1-tx-utils';
5
+ import { createL1TxUtils } from '@aztec/ethereum/l1-tx-utils';
6
6
  import { EthCheatCodes } from '@aztec/ethereum/test';
7
7
  import type { EthAddress } from '@aztec/foundation/eth-address';
8
8
  import type { LogFn, Logger } from '@aztec/foundation/log';
@@ -88,7 +88,7 @@ export async function addL1Validator({
88
88
  const gse = new GSEContract(l1Client, gseAddress);
89
89
  const registrationTuple = await gse.makeRegistrationTuple(blsSecretKey);
90
90
 
91
- const l1TxUtils = createL1TxUtilsFromViemWallet(l1Client, { logger: debugLogger });
91
+ const l1TxUtils = createL1TxUtils(l1Client, { logger: debugLogger });
92
92
  const proofParamsObj = ZkPassportProofParams.fromBuffer(proofParams);
93
93
 
94
94
  // Step 1: Claim STK tokens from the faucet
@@ -194,7 +194,7 @@ export async function addL1ValidatorViaRollup({
194
194
 
195
195
  const registrationTuple = await gse.makeRegistrationTuple(blsSecretKey);
196
196
 
197
- const l1TxUtils = createL1TxUtilsFromViemWallet(l1Client, { logger: debugLogger });
197
+ const l1TxUtils = createL1TxUtils(l1Client, { logger: debugLogger });
198
198
 
199
199
  const { receipt } = await l1TxUtils.sendAndMonitorTransaction({
200
200
  to: rollupAddress.toString(),
@@ -241,7 +241,7 @@ export async function removeL1Validator({
241
241
  const account = getAccount(privateKey, mnemonic);
242
242
  const chain = createEthereumChain(rpcUrls, chainId);
243
243
  const l1Client = createExtendedL1Client(rpcUrls, account, chain.chainInfo);
244
- const l1TxUtils = createL1TxUtilsFromViemWallet(l1Client, { logger: debugLogger });
244
+ const l1TxUtils = createL1TxUtils(l1Client, { logger: debugLogger });
245
245
 
246
246
  dualLog(`Removing validator ${validatorAddress.toString()} from rollup ${rollupAddress.toString()}`);
247
247
  const { receipt } = await l1TxUtils.sendAndMonitorTransaction({
@@ -268,7 +268,7 @@ export async function pruneRollup({
268
268
  const account = getAccount(privateKey, mnemonic);
269
269
  const chain = createEthereumChain(rpcUrls, chainId);
270
270
  const l1Client = createExtendedL1Client(rpcUrls, account, chain.chainInfo);
271
- const l1TxUtils = createL1TxUtilsFromViemWallet(l1Client, { logger: debugLogger });
271
+ const l1TxUtils = createL1TxUtils(l1Client, { logger: debugLogger });
272
272
 
273
273
  dualLog(`Trying prune`);
274
274
  const { receipt } = await l1TxUtils.sendAndMonitorTransaction({
@@ -1,24 +1,48 @@
1
1
  import { createLogger } from '@aztec/aztec.js/log';
2
2
 
3
- import { mkdir, readFile, stat, writeFile } from 'fs/promises';
3
+ import { mkdir, readFile, writeFile } from 'fs/promises';
4
4
  import { dirname } from 'path';
5
5
 
6
6
  export interface CachedFetchOptions {
7
- /** Cache duration in milliseconds */
8
- cacheDurationMs: number;
9
- /** The cache file */
7
+ /** The cache file path for storing data. If not provided, no caching is performed. */
10
8
  cacheFile?: string;
9
+ /** Fallback max-age in milliseconds when server sends no Cache-Control header. Defaults to 5 minutes. */
10
+ defaultMaxAgeMs?: number;
11
+ }
12
+
13
+ /** Cache metadata stored in a sidecar .meta file alongside the data file. */
14
+ interface CacheMeta {
15
+ etag?: string;
16
+ expiresAt: number;
17
+ }
18
+
19
+ const DEFAULT_MAX_AGE_MS = 5 * 60 * 1000; // 5 minutes
20
+
21
+ /** Extracts max-age value in milliseconds from a Response's Cache-Control header. Returns undefined if not present. */
22
+ export function parseMaxAge(response: { headers: { get(name: string): string | null } }): number | undefined {
23
+ const cacheControl = response.headers.get('cache-control');
24
+ if (!cacheControl) {
25
+ return undefined;
26
+ }
27
+ const match = cacheControl.match(/max-age=(\d+)/);
28
+ if (!match) {
29
+ return undefined;
30
+ }
31
+ return parseInt(match[1], 10) * 1000;
11
32
  }
12
33
 
13
34
  /**
14
- * Fetches data from a URL with file-based caching support.
15
- * This utility can be used by both remote config and bootnodes fetching.
35
+ * Fetches data from a URL with file-based HTTP conditional caching.
36
+ *
37
+ * Data is stored as raw JSON in the cache file (same format as the server returns).
38
+ * Caching metadata (ETag, expiry) is stored in a separate sidecar `.meta` file.
39
+ * This keeps the data file human-readable and backward-compatible with older code.
16
40
  *
17
41
  * @param url - The URL to fetch from
18
- * @param networkName - Network name for cache directory structure
19
- * @param options - Caching and error handling options
20
- * @param cacheDir - Optional cache directory (defaults to no caching)
21
- * @returns The fetched and parsed JSON data, or undefined if fetch fails and throwOnError is false
42
+ * @param options - Caching options
43
+ * @param fetch - Fetch implementation (defaults to globalThis.fetch)
44
+ * @param log - Logger instance
45
+ * @returns The fetched and parsed JSON data, or undefined if fetch fails
22
46
  */
23
47
  export async function cachedFetch<T = any>(
24
48
  url: string,
@@ -26,42 +50,106 @@ export async function cachedFetch<T = any>(
26
50
  fetch = globalThis.fetch,
27
51
  log = createLogger('cached_fetch'),
28
52
  ): Promise<T | undefined> {
29
- const { cacheDurationMs, cacheFile } = options;
53
+ const { cacheFile, defaultMaxAgeMs = DEFAULT_MAX_AGE_MS } = options;
54
+
55
+ // If no cacheFile, just fetch normally without caching
56
+ if (!cacheFile) {
57
+ return fetchAndParse<T>(url, fetch, log);
58
+ }
59
+
60
+ const metaFile = cacheFile + '.meta';
30
61
 
31
- // Try to read from cache first
62
+ // Try to read metadata
63
+ let meta: CacheMeta | undefined;
32
64
  try {
33
- if (cacheFile) {
34
- const info = await stat(cacheFile);
35
- if (info.mtimeMs + cacheDurationMs > Date.now()) {
36
- const cachedData = JSON.parse(await readFile(cacheFile, 'utf-8'));
37
- return cachedData;
38
- }
39
- }
65
+ meta = JSON.parse(await readFile(metaFile, 'utf-8'));
40
66
  } catch {
41
- log.trace('Failed to read data from cache');
67
+ log.trace('No usable cache metadata found');
42
68
  }
43
69
 
70
+ // Try to read cached data
71
+ let cachedData: T | undefined;
44
72
  try {
45
- const response = await fetch(url);
73
+ cachedData = JSON.parse(await readFile(cacheFile, 'utf-8'));
74
+ } catch {
75
+ log.trace('No usable cached data found');
76
+ }
77
+
78
+ // If metadata and data exist and cache is fresh, return directly
79
+ if (meta && cachedData !== undefined && meta.expiresAt > Date.now()) {
80
+ return cachedData;
81
+ }
82
+
83
+ // Cache is stale or missing — make a (possibly conditional) request
84
+ try {
85
+ const headers: Record<string, string> = {};
86
+ if (meta?.etag && cachedData !== undefined) {
87
+ headers['If-None-Match'] = meta.etag;
88
+ }
89
+
90
+ const response = await fetch(url, { headers });
91
+
92
+ if (response.status === 304 && cachedData !== undefined) {
93
+ // Not modified — recompute expiry from new response headers and return cached data
94
+ const maxAgeMs = parseMaxAge(response) ?? defaultMaxAgeMs;
95
+ await writeMetaFile(metaFile, { etag: meta?.etag, expiresAt: Date.now() + maxAgeMs }, log);
96
+ return cachedData;
97
+ }
98
+
46
99
  if (!response.ok) {
47
100
  log.warn(`Failed to fetch from ${url}: ${response.status} ${response.statusText}`);
48
- return undefined;
101
+ return cachedData;
49
102
  }
50
103
 
51
- const data = await response.json();
104
+ // 200 — parse new data and cache it
105
+ const data = (await response.json()) as T;
106
+ const maxAgeMs = parseMaxAge(response) ?? defaultMaxAgeMs;
107
+ const etag = response.headers.get('etag') ?? undefined;
52
108
 
53
- try {
54
- if (cacheFile) {
55
- await mkdir(dirname(cacheFile), { recursive: true });
56
- await writeFile(cacheFile, JSON.stringify(data), 'utf-8');
57
- }
58
- } catch (err) {
59
- log.warn('Failed to cache data on disk: ' + cacheFile, { cacheFile, err });
60
- }
109
+ await ensureDir(cacheFile, log);
110
+ await Promise.all([
111
+ writeFile(cacheFile, JSON.stringify(data), 'utf-8'),
112
+ writeFile(metaFile, JSON.stringify({ etag, expiresAt: Date.now() + maxAgeMs }), 'utf-8'),
113
+ ]);
61
114
 
62
115
  return data;
116
+ } catch (err) {
117
+ log.warn(`Failed to fetch from ${url}`, { err });
118
+ return cachedData;
119
+ }
120
+ }
121
+
122
+ async function fetchAndParse<T>(
123
+ url: string,
124
+ fetch: typeof globalThis.fetch,
125
+ log: ReturnType<typeof createLogger>,
126
+ ): Promise<T | undefined> {
127
+ try {
128
+ const response = await fetch(url);
129
+ if (!response.ok) {
130
+ log.warn(`Failed to fetch from ${url}: ${response.status} ${response.statusText}`);
131
+ return undefined;
132
+ }
133
+ return (await response.json()) as T;
63
134
  } catch (err) {
64
135
  log.warn(`Failed to fetch from ${url}`, { err });
65
136
  return undefined;
66
137
  }
67
138
  }
139
+
140
+ async function ensureDir(filePath: string, log: ReturnType<typeof createLogger>) {
141
+ try {
142
+ await mkdir(dirname(filePath), { recursive: true });
143
+ } catch (err) {
144
+ log.warn('Failed to create cache directory for: ' + filePath, { err });
145
+ }
146
+ }
147
+
148
+ async function writeMetaFile(metaFile: string, meta: CacheMeta, log: ReturnType<typeof createLogger>) {
149
+ try {
150
+ await mkdir(dirname(metaFile), { recursive: true });
151
+ await writeFile(metaFile, JSON.stringify(meta), 'utf-8');
152
+ } catch (err) {
153
+ log.warn('Failed to write cache metadata: ' + metaFile, { err });
154
+ }
155
+ }
@@ -45,7 +45,9 @@ export function enrichEnvironmentWithChainName(networkName: NetworkNames) {
45
45
  }
46
46
 
47
47
  // Apply generated network config from defaults.yml
48
- const generatedConfig = NetworkConfigs[networkName];
48
+ // For devnet iterations (v4-devnet-1, etc.), use the base devnet config
49
+ const configKey = /^v\d+-devnet-\d+$/.test(networkName) ? 'devnet' : networkName;
50
+ const generatedConfig = NetworkConfigs[configKey];
49
51
  if (generatedConfig) {
50
52
  enrichEnvironmentWithNetworkConfig(generatedConfig);
51
53
  }