@aztec/aztec 3.0.0-nightly.20251111 → 3.0.0-nightly.20251112

package/README.md

@@ -8,7 +8,7 @@ Aztec is a package that allows for a simple development environment on Aztec sta
 
 The easiest way to run is by using `docker compose up`. This will create two containers:
 
-1. The sandbox listening on port `8080`
+1. The local network listening on port `8080`
 2. An anvil instance listening on port `8545`
 
 ### Node Server

package/dest/cli/aztec_start_action.js

@@ -2,7 +2,7 @@ import { createNamespacedSafeJsonRpcServer, startHttpRpcServer } from '@aztec/fo
 import { AztecNodeApiSchema } from '@aztec/stdlib/interfaces/client';
 import { getVersioningMiddleware } from '@aztec/stdlib/versioning';
 import { getOtelJsonRpcPropagationMiddleware } from '@aztec/telemetry-client';
-import { createSandbox } from '../sandbox/index.js';
+import { createLocalNetwork } from '../local-network/index.js';
 import { github, splash } from '../splash.js';
 import { getCliVersion } from './release_version.js';
 import { extractNamespacedOptions, installSignalHandlers } from './util.js';
@@ -13,17 +13,17 @@ export async function aztecStart(options, userLog, debugLogger) {
     const services = {};
     const adminServices = {};
     let config = undefined;
-    if (options.sandbox) {
+    if (options.localNetwork) {
         const cliVersion = getCliVersion();
-        const sandboxOptions = extractNamespacedOptions(options, 'sandbox');
-        sandboxOptions.testAccounts = true;
+        const localNetwork = extractNamespacedOptions(options, 'local-network');
+        localNetwork.testAccounts = true;
         userLog(`${splash}\n${github}\n\n`);
-        userLog(`Setting up Aztec Sandbox ${cliVersion}, please stand by...`);
-        const { node, stop } = await createSandbox({
-            l1Mnemonic: sandboxOptions.l1Mnemonic,
+        userLog(`Setting up Aztec local network ${cliVersion}, please stand by...`);
+        const { node, stop } = await createLocalNetwork({
+            l1Mnemonic: localNetwork.l1Mnemonic,
             l1RpcUrls: options.l1RpcUrls,
-            deployAztecContractsSalt: sandboxOptions.deployAztecContractsSalt,
-            testAccounts: sandboxOptions.testAccounts,
+            deployAztecContractsSalt: localNetwork.deployAztecContractsSalt,
+            testAccounts: localNetwork.testAccounts,
             realProofs: false
         }, userLog);
         // Start Node and PXE JSON-RPC server

package/dest/cli/aztec_start_options.js

@@ -78,22 +78,22 @@ export const aztecStartOptions = {
         configToFlag('--sync-mode', sharedNodeConfigMappings.syncMode),
         configToFlag('--snapshots-urls', sharedNodeConfigMappings.snapshotsUrls)
     ],
-    SANDBOX: [
+    LOCAL_NETWORK: [
         {
-            flag: '--sandbox',
-            description: 'Starts Aztec Sandbox',
+            flag: '--local-network',
+            description: 'Starts Aztec Local Network',
             defaultValue: undefined,
             env: undefined
         },
         {
-            flag: '--sandbox.l1Mnemonic <value>',
+            flag: '--local-network.l1Mnemonic <value>',
             description: 'Mnemonic for L1 accounts. Will be used ',
             defaultValue: DefaultMnemonic,
             env: 'MNEMONIC'
         },
         {
-            flag: '--sandbox.deployAztecContractsSalt <value>',
-            description: 'Numeric salt for deploying L1 Aztec contracts before starting the sandbox. Needs mnemonic or private key to be set.',
+            flag: '--local-network.deployAztecContractsSalt <value>',
+            description: 'Numeric salt for deploying L1 Aztec contracts before starting the local network. Needs mnemonic or private key to be set.',
             env: 'DEPLOY_AZTEC_CONTRACTS_SALT',
             defaultValue: undefined,
             parseVal: (val)=>val ? parseInt(val) : undefined

package/dest/cli/cmds/start_node.js

@@ -11,7 +11,7 @@ import { P2PApiSchema } from '@aztec/stdlib/interfaces/server';
 import { initTelemetryClient, telemetryClientConfigMappings } from '@aztec/telemetry-client';
 import { TestWallet } from '@aztec/test-wallet/server';
 import { getGenesisValues } from '@aztec/world-state/testing';
-import { createAztecNode } from '../../sandbox/index.js';
+import { createAztecNode } from '../../local-network/index.js';
 import { extractNamespacedOptions, extractRelevantOptions, preloadCrsDataForVerifying, setupUpdateMonitor } from '../util.js';
 export async function startNode(options, signalHandlers, services, adminServices, userLog) {
     // All options set from environment variables

package/dest/examples/token.js

@@ -13,7 +13,7 @@ const TRANSFER_AMOUNT = 33n;
  */ async function main() {
     logger.info('Running token contract test on HTTP interface.');
     const wallet = await TestWallet.create(node);
-    // During sandbox setup we deploy a few accounts. Below we add them to our wallet.
+    // During local network setup we deploy a few accounts. Below we add them to our wallet.
     const [aliceInitialAccountData, bobInitialAccountData] = await getInitialTestAccountsData();
     await wallet.createSchnorrAccount(aliceInitialAccountData.secret, aliceInitialAccountData.salt);
     await wallet.createSchnorrAccount(bobInitialAccountData.secret, bobInitialAccountData.salt);

package/dest/index.d.ts

@@ -1,2 +1,2 @@
-export { createSandbox, registerDeployedBananaCoinInWalletAndGetAddress, registerDeployedBananaFPCInWalletAndGetAddress, registerDeployedSponsoredFPCInWalletAndGetAddress, } from './sandbox/index.js';
+export { createLocalNetwork, registerDeployedBananaCoinInWalletAndGetAddress, registerDeployedBananaFPCInWalletAndGetAddress, registerDeployedSponsoredFPCInWalletAndGetAddress, } from './local-network/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,+CAA+C,EAC/C,8CAA8C,EAC9C,iDAAiD,GAClD,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,+CAA+C,EAC/C,8CAA8C,EAC9C,iDAAiD,GAClD,MAAM,0BAA0B,CAAC"}

package/dest/index.js

@@ -1 +1 @@
-export { createSandbox, registerDeployedBananaCoinInWalletAndGetAddress, registerDeployedBananaFPCInWalletAndGetAddress, registerDeployedSponsoredFPCInWalletAndGetAddress } from './sandbox/index.js';
+export { createLocalNetwork, registerDeployedBananaCoinInWalletAndGetAddress, registerDeployedBananaFPCInWalletAndGetAddress, registerDeployedSponsoredFPCInWalletAndGetAddress } from './local-network/index.js';

package/dest/local-network/banana_fpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banana_fpc.d.ts","sourceRoot":"","sources":["../../src/local-network/banana_fpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAA8B,MAAM,yBAAyB,CAAC;AAC9F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAwB3D,wBAAsB,oBAAoB,CAAC,eAAe,EAAE,kBAAkB,EAAE,yBAE/E;AAWD,wBAAsB,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,EAAE,yBAE9E;AAED,wBAAsB,cAAc,CAAC,eAAe,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,iBAcrG;AAED,wBAAsB,+CAA+C,CAAC,MAAM,EAAE,MAAM,yBAMnF;AAED,wBAAsB,8CAA8C,CAAC,MAAM,EAAE,MAAM,yBAMlF"}

package/dest/{sandbox → local-network}/index.d.ts

@@ -1,4 +1,4 @@
-export * from './sandbox.js';
+export * from './local-network.js';
 export { registerDeployedBananaCoinInWalletAndGetAddress, registerDeployedBananaFPCInWalletAndGetAddress, } from './banana_fpc.js';
 export { registerDeployedSponsoredFPCInWalletAndGetAddress } from './sponsored_fpc.js';
 //# sourceMappingURL=index.d.ts.map

package/dest/local-network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/local-network/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EACL,+CAA+C,EAC/C,8CAA8C,GAC/C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iDAAiD,EAAE,MAAM,oBAAoB,CAAC"}

package/dest/{sandbox → local-network}/index.js

@@ -1,3 +1,3 @@
-export * from './sandbox.js';
+export * from './local-network.js';
 export { registerDeployedBananaCoinInWalletAndGetAddress, registerDeployedBananaFPCInWalletAndGetAddress } from './banana_fpc.js';
 export { registerDeployedSponsoredFPCInWalletAndGetAddress } from './sponsored_fpc.js';

package/dest/{sandbox/sandbox.d.ts → local-network/local-network.d.ts}

@@ -9,7 +9,7 @@ import type { PublicDataTreeLeaf } from '@aztec/stdlib/trees';
 import { type TelemetryClient } from '@aztec/telemetry-client';
 import { type HDAccount, type PrivateKeyAccount } from 'viem';
 /**
- * Function to deploy our L1 contracts to the sandbox L1
+ * Function to deploy our L1 contracts to the local network L1
  * @param aztecNodeConfig - The Aztec Node Config
  * @param hdAccount - Account for publishing L1 contracts
  */
@@ -42,21 +42,21 @@ export declare function deployContractsToL1(aztecNodeConfig: AztecNodeConfig, hd
 } & {
     rollupAddress: EthAddress;
 }>;
-/** Sandbox settings. */
-export type SandboxConfig = AztecNodeConfig & {
+/** Local network settings. */
+export type LocalNetworkConfig = AztecNodeConfig & {
     /** Mnemonic used to derive the L1 deployer private key.*/
     l1Mnemonic: string;
     /** Salt used to deploy L1 contracts.*/
     deployAztecContractsSalt: string;
-    /** Whether to deploy test accounts on sandbox start.*/
+    /** Whether to deploy test accounts on local network start.*/
     testAccounts: boolean;
 };
 /**
  * Create and start a new Aztec Node and PXE. Deploys L1 contracts.
  * Does not start any HTTP services nor populate any initial accounts.
- * @param config - Optional Sandbox settings.
+ * @param config - Optional local network settings.
  */
-export declare function createSandbox(config: Partial<SandboxConfig> | undefined, userLog: LogFn): Promise<{
+export declare function createLocalNetwork(config: Partial<LocalNetworkConfig> | undefined, userLog: LogFn): Promise<{
     node: AztecNodeService;
     stop: () => Promise<void>;
 }>;
@@ -71,4 +71,4 @@ export declare function createAztecNode(config?: Partial<AztecNodeConfig>, deps?
 }, options?: {
     prefilledPublicData?: PublicDataTreeLeaf[];
 }): Promise<AztecNodeService>;
-//# sourceMappingURL=sandbox.d.ts.map
+//# sourceMappingURL=local-network.d.ts.map

package/dest/local-network/local-network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-network.d.ts","sourceRoot":"","sources":["../../src/local-network/local-network.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,gBAAgB,EAAoB,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,KAAK,uBAAuB,EAAwB,MAAM,yBAAyB,CAAC;AAY7F,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAoB,MAAM,yBAAyB,CAAC;AAGzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAA2D,MAAM,MAAM,CAAC;AAcvH;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,GAAG,iBAAiB,EACxC,oBAAoB,yCAAS,EAC7B,IAAI,GAAE;IACJ,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,EAAE,CAAC;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CAClC;;;;;;;;;;;;;;;;;;;;;;;GAkCP;AAED,8BAA8B;AAC9B,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,wBAAwB,EAAE,MAAM,CAAC;IACjC,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,YAAK,EAAE,OAAO,EAAE,KAAK;;;GAgHhG;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,eAAe,CAAC;IAAC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAO,EACjH,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAO,6BAW7D"}

package/dest/{sandbox/sandbox.js → local-network/local-network.js}

@@ -23,10 +23,10 @@ import { DefaultMnemonic } from '../mnemonic.js';
 import { AnvilTestWatcher } from '../testing/anvil_test_watcher.js';
 import { getBananaFPCAddress, setupBananaFPC } from './banana_fpc.js';
 import { getSponsoredFPCAddress } from './sponsored_fpc.js';
-const logger = createLogger('sandbox');
+const logger = createLogger('local-network');
 const localAnvil = foundry;
 /**
- * Function to deploy our L1 contracts to the sandbox L1
+ * Function to deploy our L1 contracts to the local network L1
  * @param aztecNodeConfig - The Aztec Node Config
  * @param hdAccount - Account for publishing L1 contracts
  */ export async function deployContractsToL1(aztecNodeConfig, hdAccount, contractDeployLogger = logger, opts = {}) {
@@ -54,15 +54,15 @@ const localAnvil = foundry;
 /**
  * Create and start a new Aztec Node and PXE. Deploys L1 contracts.
  * Does not start any HTTP services nor populate any initial accounts.
- * @param config - Optional Sandbox settings.
- */ export async function createSandbox(config = {}, userLog) {
-    // sandbox is meant for test envs. We should only need one l1RpcUrl
+ * @param config - Optional local network settings.
+ */ export async function createLocalNetwork(config = {}, userLog) {
+    // local network is meant for test envs. We should only need one l1RpcUrl
     const l1RpcUrl = config.l1RpcUrls?.[0];
     if (!l1RpcUrl) {
         throw new Error('An L1 RPC URL is required');
     }
     if ((config.l1RpcUrls?.length || 0) > 1) {
-        logger.warn(`Multiple L1 RPC URLs provided. Sandbox will only use the first one: ${l1RpcUrl}`);
+        logger.warn(`Multiple L1 RPC URLs provided. Local networks will only use the first one: ${l1RpcUrl}`);
     }
     const aztecNodeConfig = {
         ...getConfigEnvVars(),
@@ -124,11 +124,11 @@ const localAnvil = foundry;
         watcher = new AnvilTestWatcher(new EthCheatCodes([
             l1RpcUrl
         ], dateProvider), l1ContractAddresses.rollupAddress, publicClient, dateProvider);
-        watcher.setIsSandbox(true);
+        watcher.setisLocalNetwork(true);
         await watcher.start();
     }
     const telemetry = initTelemetryClient(getTelemetryClientConfig());
-    // Create a local blob sink client inside the sandbox, no http connectivity
+    // Create a local blob sink client inside the local network, no http connectivity
     const blobSinkClient = createBlobSinkClient();
     const node = await createAztecNode(aztecNodeConfig, {
         telemetry,

package/dest/local-network/sponsored_fpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sponsored_fpc.d.ts","sourceRoot":"","sources":["../../src/local-network/sponsored_fpc.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAUrD,wBAAsB,sBAAsB,8DAE3C;AAED,wBAAsB,iDAAiD,CAAC,MAAM,EAAE,MAAM,6DAKrF"}

package/dest/testing/anvil_test_watcher.d.ts

@@ -12,7 +12,7 @@ import type { TestDateProvider } from '@aztec/foundation/timer';
 export declare class AnvilTestWatcher {
     private cheatcodes;
     private dateProvider?;
-    private isSandbox;
+    private isLocalNetwork;
     private rollup;
     private rollupCheatCodes;
     private l2SlotDuration;
@@ -23,7 +23,7 @@ export declare class AnvilTestWatcher {
     private isMarkingAsProven;
     constructor(cheatcodes: EthCheatCodes, rollupAddress: EthAddress, l1Client: ViemClient, dateProvider?: TestDateProvider | undefined);
     setIsMarkingAsProven(isMarkingAsProven: boolean): void;
-    setIsSandbox(isSandbox: boolean): void;
+    setisLocalNetwork(isLocalNetwork: boolean): void;
     start(): Promise<void>;
     stop(): Promise<void>;
     trigger(): Promise<void>;

package/dest/testing/anvil_test_watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anvil_test_watcher.d.ts","sourceRoot":"","sources":["../../src/testing/anvil_test_watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAgBzB,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,YAAY,CAAC;IAlBvB,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAU;IAEhC,OAAO,CAAC,oBAAoB,CAAC,CAAiB;IAC9C,OAAO,CAAC,uBAAuB,CAAC,CAAiB;IACjD,OAAO,CAAC,6BAA6B,CAAC,CAAiB;IAEvD,OAAO,CAAC,MAAM,CAAiD;IAE/D,OAAO,CAAC,iBAAiB,CAAQ;gBAGvB,UAAU,EAAE,aAAa,EACjC,aAAa,EAAE,UAAU,EACzB,QAAQ,EAAE,UAAU,EACZ,YAAY,CAAC,EAAE,gBAAgB,YAAA;IAezC,oBAAoB,CAAC,iBAAiB,EAAE,OAAO;IAK/C,YAAY,CAAC,SAAS,EAAE,OAAO;IAIzB,KAAK;IA2BL,IAAI;IAMJ,OAAO;IAMP,YAAY;IAOZ,4BAA4B;IAiB5B,gBAAgB;CAwCvB"}
+{"version":3,"file":"anvil_test_watcher.d.ts","sourceRoot":"","sources":["../../src/testing/anvil_test_watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAgBzB,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,YAAY,CAAC;IAlBvB,OAAO,CAAC,cAAc,CAAkB;IAExC,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAU;IAEhC,OAAO,CAAC,oBAAoB,CAAC,CAAiB;IAC9C,OAAO,CAAC,uBAAuB,CAAC,CAAiB;IACjD,OAAO,CAAC,6BAA6B,CAAC,CAAiB;IAEvD,OAAO,CAAC,MAAM,CAAiD;IAE/D,OAAO,CAAC,iBAAiB,CAAQ;gBAGvB,UAAU,EAAE,aAAa,EACjC,aAAa,EAAE,UAAU,EACzB,QAAQ,EAAE,UAAU,EACZ,YAAY,CAAC,EAAE,gBAAgB,YAAA;IAezC,oBAAoB,CAAC,iBAAiB,EAAE,OAAO;IAK/C,iBAAiB,CAAC,cAAc,EAAE,OAAO;IAInC,KAAK;IA2BL,IAAI;IAMJ,OAAO;IAMP,YAAY;IAOZ,4BAA4B;IAiB5B,gBAAgB;CAwCvB"}

package/dest/testing/anvil_test_watcher.js

@@ -12,7 +12,7 @@ import { getAddress, getContract } from 'viem';
  */ export class AnvilTestWatcher {
     cheatcodes;
     dateProvider;
-    isSandbox;
+    isLocalNetwork;
     rollup;
     rollupCheatCodes;
     l2SlotDuration;
@@ -24,7 +24,7 @@ import { getAddress, getContract } from 'viem';
     constructor(cheatcodes, rollupAddress, l1Client, dateProvider){
         this.cheatcodes = cheatcodes;
         this.dateProvider = dateProvider;
-        this.isSandbox = false;
+        this.isLocalNetwork = false;
         this.logger = createLogger(`aztecjs:utils:watcher`);
         this.isMarkingAsProven = true;
         this.rollup = getContract({
@@ -41,8 +41,8 @@ import { getAddress, getContract } from 'viem';
         this.logger.warn(`Watcher is now ${isMarkingAsProven ? 'marking' : 'not marking'} blocks as proven`);
         this.isMarkingAsProven = isMarkingAsProven;
     }
-    setIsSandbox(isSandbox) {
-        this.isSandbox = isSandbox;
+    setisLocalNetwork(isLocalNetwork) {
+        this.isLocalNetwork = isLocalNetwork;
     }
     async start() {
         if (this.filledRunningPromise) {
@@ -52,7 +52,7 @@ import { getAddress, getContract } from 'viem';
         this.l2SlotDuration = config.slotDuration;
         // If auto mining is not supported (e.g., we are on a real network), then we
         // will simple do nothing. But if on an anvil or the like, this make sure that
-        // the sandbox and tests don't break because time is frozen and we never get to
+        // the local network and tests don't break because time is frozen and we never get to
         // the next slot.
         const isAutoMining = await this.cheatcodes.isAutoMining();
         if (isAutoMining) {
@@ -84,7 +84,7 @@ import { getAddress, getContract } from 'viem';
         await this.rollupCheatCodes.markAsProven();
     }
     async syncDateProviderToL1IfBehind() {
-        // this doesn't apply to the sandbox, because we don't have a date provider in the sandbox
+        // this doesn't apply to the local network, because we don't have a date provider in the local network
         if (!this.dateProvider) {
             return;
         }
@@ -120,8 +120,8 @@ import { getAddress, getContract } from 'viem';
                 this.logger.info(`Slot ${currentSlot} was filled, jumped to next slot`);
                 return;
             }
-            // If we are not in sandbox, we don't need to warp time
-            if (!this.isSandbox) {
+            // If we are not in local network, we don't need to warp time
+            if (!this.isLocalNetwork) {
                 return;
             }
             const currentTimestamp = this.dateProvider?.now() ?? Date.now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/aztec",
-  "version": "3.0.0-nightly.20251111",
+  "version": "3.0.0-nightly.20251112",
   "type": "module",
   "exports": {
     ".": "./dest/index.js",
@@ -18,7 +18,7 @@
     "build": "yarn clean && tsc -b",
     "start": "node --no-warnings ./dest/bin",
     "start:debug": "node --inspect=0.0.0.0:9221 --no-warnings ./dest/bin",
-    "start:sandbox": "ETHEREUM_HOSTS=http://0.0.0.0:8545/ && yarn start start --sandbox",
+    "start:local-network": "ETHEREUM_HOSTS=http://0.0.0.0:8545/ && yarn start start --local-network",
     "clean": "rm -rf ./dest .tsbuildinfo",
     "build:dev": "tsc -b --watch",
     "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}",
@@ -28,37 +28,37 @@
     "../package.common.json"
   ],
   "dependencies": {
-    "@aztec/accounts": "3.0.0-nightly.20251111",
-    "@aztec/archiver": "3.0.0-nightly.20251111",
-    "@aztec/aztec-faucet": "3.0.0-nightly.20251111",
-    "@aztec/aztec-node": "3.0.0-nightly.20251111",
-    "@aztec/aztec.js": "3.0.0-nightly.20251111",
-    "@aztec/bb-prover": "3.0.0-nightly.20251111",
-    "@aztec/bb.js": "3.0.0-nightly.20251111",
-    "@aztec/blob-sink": "3.0.0-nightly.20251111",
-    "@aztec/bot": "3.0.0-nightly.20251111",
-    "@aztec/builder": "3.0.0-nightly.20251111",
-    "@aztec/cli": "3.0.0-nightly.20251111",
-    "@aztec/constants": "3.0.0-nightly.20251111",
-    "@aztec/entrypoints": "3.0.0-nightly.20251111",
-    "@aztec/ethereum": "3.0.0-nightly.20251111",
-    "@aztec/foundation": "3.0.0-nightly.20251111",
-    "@aztec/kv-store": "3.0.0-nightly.20251111",
-    "@aztec/l1-artifacts": "3.0.0-nightly.20251111",
-    "@aztec/node-lib": "3.0.0-nightly.20251111",
-    "@aztec/noir-contracts.js": "3.0.0-nightly.20251111",
-    "@aztec/noir-protocol-circuits-types": "3.0.0-nightly.20251111",
-    "@aztec/p2p": "3.0.0-nightly.20251111",
-    "@aztec/p2p-bootstrap": "3.0.0-nightly.20251111",
-    "@aztec/protocol-contracts": "3.0.0-nightly.20251111",
-    "@aztec/prover-client": "3.0.0-nightly.20251111",
-    "@aztec/prover-node": "3.0.0-nightly.20251111",
-    "@aztec/pxe": "3.0.0-nightly.20251111",
-    "@aztec/stdlib": "3.0.0-nightly.20251111",
-    "@aztec/telemetry-client": "3.0.0-nightly.20251111",
-    "@aztec/test-wallet": "3.0.0-nightly.20251111",
-    "@aztec/txe": "3.0.0-nightly.20251111",
-    "@aztec/world-state": "3.0.0-nightly.20251111",
+    "@aztec/accounts": "3.0.0-nightly.20251112",
+    "@aztec/archiver": "3.0.0-nightly.20251112",
+    "@aztec/aztec-faucet": "3.0.0-nightly.20251112",
+    "@aztec/aztec-node": "3.0.0-nightly.20251112",
+    "@aztec/aztec.js": "3.0.0-nightly.20251112",
+    "@aztec/bb-prover": "3.0.0-nightly.20251112",
+    "@aztec/bb.js": "3.0.0-nightly.20251112",
+    "@aztec/blob-sink": "3.0.0-nightly.20251112",
+    "@aztec/bot": "3.0.0-nightly.20251112",
+    "@aztec/builder": "3.0.0-nightly.20251112",
+    "@aztec/cli": "3.0.0-nightly.20251112",
+    "@aztec/constants": "3.0.0-nightly.20251112",
+    "@aztec/entrypoints": "3.0.0-nightly.20251112",
+    "@aztec/ethereum": "3.0.0-nightly.20251112",
+    "@aztec/foundation": "3.0.0-nightly.20251112",
+    "@aztec/kv-store": "3.0.0-nightly.20251112",
+    "@aztec/l1-artifacts": "3.0.0-nightly.20251112",
+    "@aztec/node-lib": "3.0.0-nightly.20251112",
+    "@aztec/noir-contracts.js": "3.0.0-nightly.20251112",
+    "@aztec/noir-protocol-circuits-types": "3.0.0-nightly.20251112",
+    "@aztec/p2p": "3.0.0-nightly.20251112",
+    "@aztec/p2p-bootstrap": "3.0.0-nightly.20251112",
+    "@aztec/protocol-contracts": "3.0.0-nightly.20251112",
+    "@aztec/prover-client": "3.0.0-nightly.20251112",
+    "@aztec/prover-node": "3.0.0-nightly.20251112",
+    "@aztec/pxe": "3.0.0-nightly.20251112",
+    "@aztec/stdlib": "3.0.0-nightly.20251112",
+    "@aztec/telemetry-client": "3.0.0-nightly.20251112",
+    "@aztec/test-wallet": "3.0.0-nightly.20251112",
+    "@aztec/txe": "3.0.0-nightly.20251112",
+    "@aztec/world-state": "3.0.0-nightly.20251112",
     "@types/chalk": "^2.2.0",
     "abitype": "^0.8.11",
     "chalk": "^5.3.0",

package/src/cli/aztec_start_action.ts

@@ -9,7 +9,7 @@ import { AztecNodeApiSchema } from '@aztec/stdlib/interfaces/client';
 import { getVersioningMiddleware } from '@aztec/stdlib/versioning';
 import { getOtelJsonRpcPropagationMiddleware } from '@aztec/telemetry-client';
 
-import { createSandbox } from '../sandbox/index.js';
+import { createLocalNetwork } from '../local-network/index.js';
 import { github, splash } from '../splash.js';
 import { getCliVersion } from './release_version.js';
 import { extractNamespacedOptions, installSignalHandlers } from './util.js';
@@ -22,19 +22,19 @@ export async function aztecStart(options: any, userLog: LogFn, debugLogger: Logg
   const adminServices: NamespacedApiHandlers = {};
   let config: ChainConfig | undefined = undefined;
 
-  if (options.sandbox) {
+  if (options.localNetwork) {
     const cliVersion = getCliVersion();
-    const sandboxOptions = extractNamespacedOptions(options, 'sandbox');
-    sandboxOptions.testAccounts = true;
+    const localNetwork = extractNamespacedOptions(options, 'local-network');
+    localNetwork.testAccounts = true;
     userLog(`${splash}\n${github}\n\n`);
-    userLog(`Setting up Aztec Sandbox ${cliVersion}, please stand by...`);
+    userLog(`Setting up Aztec local network ${cliVersion}, please stand by...`);
 
-    const { node, stop } = await createSandbox(
+    const { node, stop } = await createLocalNetwork(
       {
-        l1Mnemonic: sandboxOptions.l1Mnemonic,
+        l1Mnemonic: localNetwork.l1Mnemonic,
         l1RpcUrls: options.l1RpcUrls,
-        deployAztecContractsSalt: sandboxOptions.deployAztecContractsSalt,
-        testAccounts: sandboxOptions.testAccounts,
+        deployAztecContractsSalt: localNetwork.deployAztecContractsSalt,
+        testAccounts: localNetwork.testAccounts,
         realProofs: false,
       },
       userLog,

package/src/cli/aztec_start_options.ts

@@ -108,23 +108,23 @@ export const aztecStartOptions: { [key: string]: AztecStartOption[] } = {
     configToFlag('--sync-mode', sharedNodeConfigMappings.syncMode),
     configToFlag('--snapshots-urls', sharedNodeConfigMappings.snapshotsUrls),
   ],
-  SANDBOX: [
+  LOCAL_NETWORK: [
     {
-      flag: '--sandbox',
-      description: 'Starts Aztec Sandbox',
+      flag: '--local-network',
+      description: 'Starts Aztec Local Network',
       defaultValue: undefined,
       env: undefined,
     },
     {
-      flag: '--sandbox.l1Mnemonic <value>',
+      flag: '--local-network.l1Mnemonic <value>',
       description: 'Mnemonic for L1 accounts. Will be used ',
       defaultValue: DefaultMnemonic,
       env: 'MNEMONIC',
     },
     {
-      flag: '--sandbox.deployAztecContractsSalt <value>',
+      flag: '--local-network.deployAztecContractsSalt <value>',
       description:
-        'Numeric salt for deploying L1 Aztec contracts before starting the sandbox. Needs mnemonic or private key to be set.',
+        'Numeric salt for deploying L1 Aztec contracts before starting the local network. Needs mnemonic or private key to be set.',
       env: 'DEPLOY_AZTEC_CONTRACTS_SALT',
       defaultValue: undefined,
       parseVal: (val: string) => (val ? parseInt(val) : undefined),

package/src/cli/cmds/start_node.ts

@@ -18,7 +18,7 @@ import {
 import { TestWallet } from '@aztec/test-wallet/server';
 import { getGenesisValues } from '@aztec/world-state/testing';
 
-import { createAztecNode } from '../../sandbox/index.js';
+import { createAztecNode } from '../../local-network/index.js';
 import {
   extractNamespacedOptions,
   extractRelevantOptions,

package/src/examples/token.ts

@@ -21,7 +21,7 @@ async function main() {
 
   const wallet = await TestWallet.create(node);
 
-  // During sandbox setup we deploy a few accounts. Below we add them to our wallet.
+  // During local network setup we deploy a few accounts. Below we add them to our wallet.
   const [aliceInitialAccountData, bobInitialAccountData] = await getInitialTestAccountsData();
   await wallet.createSchnorrAccount(aliceInitialAccountData.secret, aliceInitialAccountData.salt);
   await wallet.createSchnorrAccount(bobInitialAccountData.secret, bobInitialAccountData.salt);

package/src/index.ts

@@ -1,6 +1,6 @@
 export {
-  createSandbox,
+  createLocalNetwork,
   registerDeployedBananaCoinInWalletAndGetAddress,
   registerDeployedBananaFPCInWalletAndGetAddress,
   registerDeployedSponsoredFPCInWalletAndGetAddress,
-} from './sandbox/index.js';
+} from './local-network/index.js';

package/src/{sandbox → local-network}/index.ts

@@ -1,4 +1,4 @@
-export * from './sandbox.js';
+export * from './local-network.js';
 
 export {
   registerDeployedBananaCoinInWalletAndGetAddress,

package/src/{sandbox/sandbox.ts → local-network/local-network.ts}

@@ -38,12 +38,12 @@ import { AnvilTestWatcher } from '../testing/anvil_test_watcher.js';
 import { getBananaFPCAddress, setupBananaFPC } from './banana_fpc.js';
 import { getSponsoredFPCAddress } from './sponsored_fpc.js';
 
-const logger = createLogger('sandbox');
+const logger = createLogger('local-network');
 
 const localAnvil = foundry;
 
 /**
- * Function to deploy our L1 contracts to the sandbox L1
+ * Function to deploy our L1 contracts to the local network L1
  * @param aztecNodeConfig - The Aztec Node Config
  * @param hdAccount - Account for publishing L1 contracts
  */
@@ -78,8 +78,8 @@ export async function deployContractsToL1(
       genesisArchiveRoot: opts.genesisArchiveRoot ?? new Fr(GENESIS_ARCHIVE_ROOT),
       salt: opts.salt,
       feeJuicePortalInitialBalance: opts.feeJuicePortalInitialBalance,
-      aztecTargetCommitteeSize: 0, // no committee in sandbox
-      slasherFlavor: 'none', // no slashing in sandbox
+      aztecTargetCommitteeSize: 0, // no committee in local network
+      slasherFlavor: 'none', // no slashing in local network
       realVerifier: false,
     },
   );
@@ -92,29 +92,29 @@ export async function deployContractsToL1(
   return aztecNodeConfig.l1Contracts;
 }
 
-/** Sandbox settings. */
-export type SandboxConfig = AztecNodeConfig & {
+/** Local network settings. */
+export type LocalNetworkConfig = AztecNodeConfig & {
   /** Mnemonic used to derive the L1 deployer private key.*/
   l1Mnemonic: string;
   /** Salt used to deploy L1 contracts.*/
   deployAztecContractsSalt: string;
-  /** Whether to deploy test accounts on sandbox start.*/
+  /** Whether to deploy test accounts on local network start.*/
   testAccounts: boolean;
 };
 
 /**
  * Create and start a new Aztec Node and PXE. Deploys L1 contracts.
  * Does not start any HTTP services nor populate any initial accounts.
- * @param config - Optional Sandbox settings.
+ * @param config - Optional local network settings.
  */
-export async function createSandbox(config: Partial<SandboxConfig> = {}, userLog: LogFn) {
-  // sandbox is meant for test envs. We should only need one l1RpcUrl
+export async function createLocalNetwork(config: Partial<LocalNetworkConfig> = {}, userLog: LogFn) {
+  // local network is meant for test envs. We should only need one l1RpcUrl
   const l1RpcUrl = config.l1RpcUrls?.[0];
   if (!l1RpcUrl) {
     throw new Error('An L1 RPC URL is required');
   }
   if ((config.l1RpcUrls?.length || 0) > 1) {
-    logger.warn(`Multiple L1 RPC URLs provided. Sandbox will only use the first one: ${l1RpcUrl}`);
+    logger.warn(`Multiple L1 RPC URLs provided. Local networks will only use the first one: ${l1RpcUrl}`);
   }
   const aztecNodeConfig: AztecNodeConfig = { ...getConfigEnvVars(), ...config };
   const hdAccount = mnemonicToAccount(config.l1Mnemonic || DefaultMnemonic);
@@ -179,12 +179,12 @@ export async function createSandbox(config: Partial<SandboxConfig> = {}, userLog
       publicClient,
       dateProvider,
     );
-    watcher.setIsSandbox(true);
+    watcher.setisLocalNetwork(true);
     await watcher.start();
   }
 
   const telemetry = initTelemetryClient(getTelemetryClientConfig());
-  // Create a local blob sink client inside the sandbox, no http connectivity
+  // Create a local blob sink client inside the local network, no http connectivity
   const blobSinkClient = createBlobSinkClient();
   const node = await createAztecNode(
     aztecNodeConfig,

package/src/testing/anvil_test_watcher.ts

@@ -16,7 +16,7 @@ import { type GetContractReturnType, getAddress, getContract } from 'viem';
  * block within the slot. And if so, it will time travel into the next slot.
  */
 export class AnvilTestWatcher {
-  private isSandbox: boolean = false;
+  private isLocalNetwork: boolean = false;
 
   private rollup: GetContractReturnType<typeof RollupAbi, ViemClient>;
   private rollupCheatCodes: RollupCheatCodes;
@@ -54,8 +54,8 @@ export class AnvilTestWatcher {
     this.isMarkingAsProven = isMarkingAsProven;
   }
 
-  setIsSandbox(isSandbox: boolean) {
-    this.isSandbox = isSandbox;
+  setisLocalNetwork(isLocalNetwork: boolean) {
+    this.isLocalNetwork = isLocalNetwork;
   }
 
   async start() {
@@ -68,7 +68,7 @@ export class AnvilTestWatcher {
 
     // If auto mining is not supported (e.g., we are on a real network), then we
     // will simple do nothing. But if on an anvil or the like, this make sure that
-    // the sandbox and tests don't break because time is frozen and we never get to
+    // the local network and tests don't break because time is frozen and we never get to
     // the next slot.
     const isAutoMining = await this.cheatcodes.isAutoMining();
 
@@ -105,7 +105,7 @@ export class AnvilTestWatcher {
   }
 
   async syncDateProviderToL1IfBehind() {
-    // this doesn't apply to the sandbox, because we don't have a date provider in the sandbox
+    // this doesn't apply to the local network, because we don't have a date provider in the local network
     if (!this.dateProvider) {
       return;
     }
@@ -142,8 +142,8 @@ export class AnvilTestWatcher {
         return;
       }
 
-      // If we are not in sandbox, we don't need to warp time
-      if (!this.isSandbox) {
+      // If we are not in local network, we don't need to warp time
+      if (!this.isLocalNetwork) {
         return;
       }
 

package/dest/sandbox/banana_fpc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"banana_fpc.d.ts","sourceRoot":"","sources":["../../src/sandbox/banana_fpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAA8B,MAAM,yBAAyB,CAAC;AAC9F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAwB3D,wBAAsB,oBAAoB,CAAC,eAAe,EAAE,kBAAkB,EAAE,yBAE/E;AAWD,wBAAsB,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,EAAE,yBAE9E;AAED,wBAAsB,cAAc,CAAC,eAAe,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,iBAcrG;AAED,wBAAsB,+CAA+C,CAAC,MAAM,EAAE,MAAM,yBAMnF;AAED,wBAAsB,8CAA8C,CAAC,MAAM,EAAE,MAAM,yBAMlF"}

package/dest/sandbox/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EACL,+CAA+C,EAC/C,8CAA8C,GAC/C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iDAAiD,EAAE,MAAM,oBAAoB,CAAC"}

package/dest/sandbox/sandbox.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/sandbox/sandbox.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,gBAAgB,EAAoB,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,KAAK,uBAAuB,EAAwB,MAAM,yBAAyB,CAAC;AAY7F,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAoB,MAAM,yBAAyB,CAAC;AAGzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAA2D,MAAM,MAAM,CAAC;AAcvH;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,GAAG,iBAAiB,EACxC,oBAAoB,yCAAS,EAC7B,IAAI,GAAE;IACJ,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,EAAE,CAAC;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CAClC;;;;;;;;;;;;;;;;;;;;;;;GAkCP;AAED,wBAAwB;AACxB,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG;IAC5C,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,wBAAwB,EAAE,MAAM,CAAC;IACjC,uDAAuD;IACvD,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,YAAK,EAAE,OAAO,EAAE,KAAK;;;GAgHtF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,eAAe,CAAC;IAAC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAO,EACjH,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAO,6BAW7D"}

package/dest/sandbox/sponsored_fpc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sponsored_fpc.d.ts","sourceRoot":"","sources":["../../src/sandbox/sponsored_fpc.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAUrD,wBAAsB,sBAAsB,8DAE3C;AAED,wBAAsB,iDAAiD,CAAC,MAAM,EAAE,MAAM,6DAKrF"}