@aztec/end-to-end 0.0.1-commit.4d3c002 → 0.0.1-commit.4d9804df

package/dest/test-wallet/worker_wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker_wallet.d.ts","sourceRoot":"","sources":["../../src/test-wallet/worker_wallet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worker_wallet.d.ts","sourceRoot":"","sources":["../../src/test-wallet/worker_wallet.ts"],"names":[],"mappings":"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"}

package/dest/test-wallet/worker_wallet.js

@@ -1,6 +1,7 @@
 import { jsonStringify } from '@aztec/foundation/json-rpc';
 import { createLogger } from '@aztec/foundation/log';
 import { promiseWithResolvers } from '@aztec/foundation/promise';
+import { getSchemaReturnType } from '@aztec/foundation/schemas';
 import { sleep } from '@aztec/foundation/sleep';
 import { NodeConnector, TransportClient } from '@aztec/foundation/transport';
 import { Worker } from 'worker_threads';
@@ -39,7 +40,7 @@ const WORKER_READY_TIMEOUT_MS = 120_000;
                 ...process.stderr.isTTY || process.env.FORCE_COLOR ? {
                     FORCE_COLOR: '1'
                 } : {},
-                LOG_LEVEL: process.env.WORKER_LOG_LEVEL ?? 'warn'
+                LOG_LEVEL: process.env.WORKER_LOG_LEVEL ?? 'info'
             }
         });
         const connector = new NodeConnector(worker);
@@ -91,7 +92,9 @@ const WORKER_READY_TIMEOUT_MS = 120_000;
     async call(fn, ...args) {
         const resultJson = await this.callRaw(fn, ...args);
         const methodSchema = WorkerWalletSchema[fn];
-        return methodSchema.returnType().parseAsync(JSON.parse(resultJson));
+        // Void-returning methods (e.g. registerContract) serialize to `undefined` on the worker side, which
+        // JSON.parse cannot handle; hand it straight to the schema, whose `z.void()` output accepts undefined.
+        return getSchemaReturnType(methodSchema).parseAsync(resultJson === undefined ? undefined : JSON.parse(resultJson));
     }
     getChainInfo() {
         return this.call('getChainInfo');
@@ -117,6 +120,9 @@ const WORKER_READY_TIMEOUT_MS = 120_000;
     registerContract(instance, artifact, secretKey) {
         return this.call('registerContract', instance, artifact, secretKey);
     }
+    registerContractClass(artifact) {
+        return this.call('registerContractClass', artifact);
+    }
     simulateTx(exec, opts) {
         return this.call('simulateTx', exec, opts);
     }
@@ -132,8 +138,8 @@ const WORKER_READY_TIMEOUT_MS = 120_000;
     proveTx(exec, opts) {
         return this.call('proveTx', exec, opts);
     }
-    /** Registers an account inside the worker's TestWallet, populating its accounts map. */ registerAccount(secret, salt) {
-        return this.call('registerAccount', secret, salt);
+    /** Registers an account inside the worker's TestWallet, populating its accounts map. */ registerAccount(secret, salt, signingKey) {
+        return this.call('registerAccount', secret, salt, signingKey);
     }
     createAuthWit(from, messageHashOrIntent) {
         return this.call('createAuthWit', from, messageHashOrIntent);

package/dest/test-wallet/worker_wallet_schema.d.ts

@@ -1,274 +1,4 @@
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { Tx } from '@aztec/stdlib/tx';
-import { z } from 'zod';
+import type { ApiSchema } from '@aztec/foundation/schemas';
 /** Schema for the WorkerWallet API — extends WalletSchema with proveTx and registerAccount. */
-export declare const WorkerWalletSchema: {
-    getPrivateEvents: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/stdlib/abi").EventMetadataDefinition, z.ZodTypeDef, any>, eventFilter: z.ZodType<import("@aztec/aztec.js/wallet").PrivateEventFilter, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/aztec.js/wallet").PrivateEvent<unknown>[], z.ZodTypeDef, any>>;
-    getChainInfo: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodType<import("@aztec/entrypoints/interfaces").ChainInfo, z.ZodTypeDef, any>>;
-    getContractMetadata: z.ZodFunction<z.ZodTuple<[z.ZodType<AztecAddress, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/aztec.js/wallet").ContractMetadata, z.ZodTypeDef, any>>;
-    getContractClassMetadata: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/foundation/schemas").Fr, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/aztec.js/wallet").ContractClassMetadata, z.ZodTypeDef, any>>;
-    registerSender: z.ZodFunction<z.ZodTuple<[z.ZodType<AztecAddress, z.ZodTypeDef, any>, alias?: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodType<string | undefined, z.ZodTypeDef, any>> | undefined], z.ZodUnknown>, z.ZodType<AztecAddress, z.ZodTypeDef, any>>;
-    getAddressBook: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodType<import("@aztec/aztec.js/wallet").Aliased<AztecAddress>[], z.ZodTypeDef, any>>;
-    getAccounts: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodType<import("@aztec/aztec.js/wallet").Aliased<AztecAddress>[], z.ZodTypeDef, any>>;
-    registerContract: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/stdlib/contract").ContractInstanceWithAddress, z.ZodTypeDef, any>, artifact?: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodType<import("@aztec/stdlib/abi").ContractArtifact | undefined, z.ZodTypeDef, any>> | undefined, secretKey?: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodType<import("@aztec/foundation/schemas").Fr | undefined, z.ZodTypeDef, any>> | undefined], z.ZodUnknown>, z.ZodType<import("@aztec/stdlib/contract").ContractInstanceWithAddress, z.ZodTypeDef, any>>;
-    simulateTx: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/stdlib/tx").ExecutionPayload, z.ZodTypeDef, any>, opts: z.ZodType<import("@aztec/aztec.js/wallet").SimulateOptions, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/stdlib/tx").TxSimulationResult, z.ZodTypeDef, any>>;
-    executeUtility: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/stdlib/abi").FunctionCall, z.ZodTypeDef, any>, opts: z.ZodType<import("@aztec/aztec.js/wallet").ExecuteUtilityOptions, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/stdlib/tx").UtilityExecutionResult, z.ZodTypeDef, any>>;
-    profileTx: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/stdlib/tx").ExecutionPayload, z.ZodTypeDef, any>, opts: z.ZodType<import("@aztec/aztec.js/wallet").ProfileOptions, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/stdlib/tx").TxProfileResult, z.ZodTypeDef, any>>;
-    sendTx: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/stdlib/tx").ExecutionPayload, z.ZodTypeDef, any>, opts: z.ZodType<import("@aztec/aztec.js/wallet").SendOptions<import("@aztec/aztec.js/contracts").InteractionWaitOptions>, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/aztec.js/contracts").TxSendResultImmediate | import("@aztec/aztec.js/contracts").TxSendResultMined<import("@aztec/stdlib/tx").TxReceipt>, z.ZodTypeDef, any>>;
-    createAuthWit: z.ZodFunction<z.ZodTuple<[z.ZodType<AztecAddress, z.ZodTypeDef, any>, messageHashOrIntent: z.ZodType<import("@aztec/aztec.js/authorization").CallIntent | import("@aztec/aztec.js/authorization").IntentInnerHash, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/stdlib/auth-witness").AuthWitness, z.ZodTypeDef, any>>;
-    requestCapabilities: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/aztec.js/wallet").AppCapabilities, z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<import("@aztec/aztec.js/wallet").WalletCapabilities, z.ZodTypeDef, any>>;
-    batch: z.ZodFunction<z.ZodTuple<[z.ZodType<readonly import("@aztec/aztec.js/wallet").BatchedMethod[], z.ZodTypeDef, any>], z.ZodUnknown>, z.ZodType<readonly import("@aztec/aztec.js/wallet").BatchedMethodResultWrapper<import("@aztec/aztec.js/wallet").BatchedMethod>[], z.ZodTypeDef, any>>;
-    proveTx: z.ZodFunction<z.ZodTuple<[z.ZodObject<{
-        calls: z.ZodArray<z.ZodEffects<z.ZodObject<{
-            name: z.ZodString;
-            to: import("@aztec/foundation/schemas").ZodFor<AztecAddress>;
-            selector: import("@aztec/foundation/schemas").ZodFor<import("@aztec/stdlib/abi").FunctionSelector>;
-            type: z.ZodNativeEnum<typeof import("@aztec/stdlib/abi").FunctionType>;
-            isStatic: z.ZodBoolean;
-            hideMsgSender: z.ZodBoolean;
-            args: z.ZodArray<import("@aztec/foundation/schemas").ZodFor<import("@aztec/foundation/schemas").Fr>, "many">;
-            returnTypes: z.ZodArray<z.ZodType<import("@aztec/stdlib/abi").AbiType, z.ZodTypeDef, import("@aztec/stdlib/abi").AbiType>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            to: AztecAddress;
-            selector: import("@aztec/stdlib/abi").FunctionSelector;
-            type: import("@aztec/stdlib/abi").FunctionType;
-            isStatic: boolean;
-            hideMsgSender: boolean;
-            args: import("@aztec/foundation/schemas").Fr[];
-            returnTypes: import("@aztec/stdlib/abi").AbiType[];
-        }, {
-            name: string;
-            to?: any;
-            selector?: any;
-            type: import("@aztec/stdlib/abi").FunctionType;
-            isStatic: boolean;
-            hideMsgSender: boolean;
-            args: any[];
-            returnTypes: import("@aztec/stdlib/abi").AbiType[];
-        }>, import("@aztec/stdlib/abi").FunctionCall, {
-            name: string;
-            to?: any;
-            selector?: any;
-            type: import("@aztec/stdlib/abi").FunctionType;
-            isStatic: boolean;
-            hideMsgSender: boolean;
-            args: any[];
-            returnTypes: import("@aztec/stdlib/abi").AbiType[];
-        }>, "many">;
-        authWitnesses: z.ZodArray<z.ZodType<import("@aztec/stdlib/auth-witness").AuthWitness, any, string>, "many">;
-        capsules: z.ZodArray<z.ZodType<import("@aztec/stdlib/tx").Capsule, any, string>, "many">;
-        extraHashedArgs: z.ZodArray<import("@aztec/foundation/schemas").ZodFor<import("@aztec/stdlib/tx").HashedValues>, "many">;
-        feePayer: import("@aztec/foundation/schemas").ZodNullableOptional<import("@aztec/foundation/schemas").ZodFor<AztecAddress>>;
-    }, "strip", z.ZodTypeAny, {
-        calls: import("@aztec/stdlib/abi").FunctionCall[];
-        authWitnesses: import("@aztec/stdlib/auth-witness").AuthWitness[];
-        capsules: import("@aztec/stdlib/tx").Capsule[];
-        extraHashedArgs: import("@aztec/stdlib/tx").HashedValues[];
-        feePayer?: AztecAddress | undefined;
-    }, {
-        calls: {
-            name: string;
-            to?: any;
-            selector?: any;
-            type: import("@aztec/stdlib/abi").FunctionType;
-            isStatic: boolean;
-            hideMsgSender: boolean;
-            args: any[];
-            returnTypes: import("@aztec/stdlib/abi").AbiType[];
-        }[];
-        authWitnesses: string[];
-        capsules: string[];
-        extraHashedArgs: any[];
-        feePayer?: any;
-    }>, z.ZodObject<{
-        from: z.ZodUnion<[import("@aztec/foundation/schemas").ZodFor<AztecAddress>, z.ZodLiteral<"NO_FROM">]>;
-        authWitnesses: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodArray<z.ZodType<import("@aztec/stdlib/auth-witness").AuthWitness, any, string>, "many">>;
-        capsules: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodArray<z.ZodType<import("@aztec/stdlib/tx").Capsule, any, string>, "many">>;
-        fee: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodObject<{
-            gasSettings: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodObject<{
-                gasLimits: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodEffects<z.ZodObject<{
-                    daGas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
-                    l2Gas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
-                }, "strip", z.ZodTypeAny, {
-                    daGas: number;
-                    l2Gas: number;
-                }, {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                }>, import("@aztec/stdlib/gas").Gas, {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                }>>;
-                teardownGasLimits: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodEffects<z.ZodObject<{
-                    daGas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
-                    l2Gas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
-                }, "strip", z.ZodTypeAny, {
-                    daGas: number;
-                    l2Gas: number;
-                }, {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                }>, import("@aztec/stdlib/gas").Gas, {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                }>>;
-                maxFeePerGas: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodObject<{
-                    feePerDaGas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-                    feePerL2Gas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-                }, "strip", z.ZodTypeAny, {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                }, {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                }>>;
-                maxPriorityFeePerGas: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodObject<{
-                    feePerDaGas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-                    feePerL2Gas: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-                }, "strip", z.ZodTypeAny, {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                }, {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                }>>;
-            }, "strip", z.ZodTypeAny, {
-                gasLimits?: import("@aztec/stdlib/gas").Gas | undefined;
-                teardownGasLimits?: import("@aztec/stdlib/gas").Gas | undefined;
-                maxFeePerGas?: {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                } | undefined;
-                maxPriorityFeePerGas?: {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                } | undefined;
-            }, {
-                gasLimits?: {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                } | undefined;
-                teardownGasLimits?: {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                } | undefined;
-                maxFeePerGas?: {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                } | undefined;
-                maxPriorityFeePerGas?: {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                } | undefined;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            gasSettings?: {
-                gasLimits?: import("@aztec/stdlib/gas").Gas | undefined;
-                teardownGasLimits?: import("@aztec/stdlib/gas").Gas | undefined;
-                maxFeePerGas?: {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                } | undefined;
-                maxPriorityFeePerGas?: {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                } | undefined;
-            } | undefined;
-        }, {
-            gasSettings?: {
-                gasLimits?: {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                } | undefined;
-                teardownGasLimits?: {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                } | undefined;
-                maxFeePerGas?: {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                } | undefined;
-                maxPriorityFeePerGas?: {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                } | undefined;
-            } | undefined;
-        }>>;
-        wait: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodUnion<[z.ZodLiteral<"NO_WAIT">, z.ZodObject<{
-            ignoreDroppedReceiptsFor: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodNumber>;
-            timeout: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodNumber>;
-            interval: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodNumber>;
-            dontThrowOnRevert: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodBoolean>;
-        }, "strip", z.ZodTypeAny, {
-            ignoreDroppedReceiptsFor?: number | undefined;
-            timeout?: number | undefined;
-            interval?: number | undefined;
-            dontThrowOnRevert?: boolean | undefined;
-        }, {
-            ignoreDroppedReceiptsFor?: number | undefined;
-            timeout?: number | undefined;
-            interval?: number | undefined;
-            dontThrowOnRevert?: boolean | undefined;
-        }>]>>;
-        additionalScopes: import("@aztec/foundation/schemas").ZodNullableOptional<z.ZodArray<import("@aztec/foundation/schemas").ZodFor<AztecAddress>, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        from: "NO_FROM" | AztecAddress;
-        authWitnesses?: import("@aztec/stdlib/auth-witness").AuthWitness[] | undefined;
-        capsules?: import("@aztec/stdlib/tx").Capsule[] | undefined;
-        fee?: {
-            gasSettings?: {
-                gasLimits?: import("@aztec/stdlib/gas").Gas | undefined;
-                teardownGasLimits?: import("@aztec/stdlib/gas").Gas | undefined;
-                maxFeePerGas?: {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                } | undefined;
-                maxPriorityFeePerGas?: {
-                    feePerDaGas: bigint;
-                    feePerL2Gas: bigint;
-                } | undefined;
-            } | undefined;
-        } | undefined;
-        wait?: "NO_WAIT" | {
-            ignoreDroppedReceiptsFor?: number | undefined;
-            timeout?: number | undefined;
-            interval?: number | undefined;
-            dontThrowOnRevert?: boolean | undefined;
-        } | undefined;
-        additionalScopes?: AztecAddress[] | undefined;
-    }, {
-        from?: any;
-        authWitnesses?: string[] | undefined;
-        capsules?: string[] | undefined;
-        fee?: {
-            gasSettings?: {
-                gasLimits?: {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                } | undefined;
-                teardownGasLimits?: {
-                    daGas: string | number | bigint;
-                    l2Gas: string | number | bigint;
-                } | undefined;
-                maxFeePerGas?: {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                } | undefined;
-                maxPriorityFeePerGas?: {
-                    feePerDaGas: string | number | bigint;
-                    feePerL2Gas: string | number | bigint;
-                } | undefined;
-            } | undefined;
-        } | undefined;
-        wait?: "NO_WAIT" | {
-            ignoreDroppedReceiptsFor?: number | undefined;
-            timeout?: number | undefined;
-            interval?: number | undefined;
-            dontThrowOnRevert?: boolean | undefined;
-        } | undefined;
-        additionalScopes?: any[] | undefined;
-    }>], z.ZodUnknown>, import("@aztec/foundation/schemas").ZodFor<Tx>>;
-    registerAccount: z.ZodFunction<z.ZodTuple<[z.ZodType<import("@aztec/foundation/schemas").Fr, any, string>, z.ZodType<import("@aztec/foundation/schemas").Fr, any, string>], z.ZodUnknown>, import("@aztec/foundation/schemas").ZodFor<AztecAddress>>;
-};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ya2VyX3dhbGxldF9zY2hlbWEuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0LXdhbGxldC93b3JrZXJfd2FsbGV0X3NjaGVtYS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDM0QsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXRDLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsaUdBQStGO0FBQy9GLGVBQU8sTUFBTSxrQkFBa0I7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Q0FJOUIsQ0FBQyJ9
+export declare const WorkerWalletSchema: ApiSchema;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ya2VyX3dhbGxldF9zY2hlbWEuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0LXdhbGxldC93b3JrZXJfd2FsbGV0X3NjaGVtYS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQU8zRCxpR0FBK0Y7QUFDL0YsZUFBTyxNQUFNLGtCQUFrQixFQUFFLFNBSWhDLENBQUMifQ==

package/dest/test-wallet/worker_wallet_schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker_wallet_schema.d.ts","sourceRoot":"","sources":["../../src/test-wallet/worker_wallet_schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iGAA+F;AAC/F,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI9B,CAAC"}
+{"version":3,"file":"worker_wallet_schema.d.ts","sourceRoot":"","sources":["../../src/test-wallet/worker_wallet_schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAO3D,iGAA+F;AAC/F,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC"}

package/dest/test-wallet/worker_wallet_schema.js

@@ -5,6 +5,19 @@ import { Tx } from '@aztec/stdlib/tx';
 import { z } from 'zod';
 /** Schema for the WorkerWallet API — extends WalletSchema with proveTx and registerAccount. */ export const WorkerWalletSchema = {
     ...WalletSchema,
-    proveTx: z.function().args(ExecutionPayloadSchema, SendOptionsSchema).returns(Tx.schema),
-    registerAccount: z.function().args(schemas.Fr, schemas.Fr).returns(AztecAddress.schema)
+    proveTx: z.function({
+        input: z.tuple([
+            ExecutionPayloadSchema,
+            SendOptionsSchema
+        ]),
+        output: Tx.schema
+    }),
+    registerAccount: z.function({
+        input: z.tuple([
+            schemas.Fr,
+            schemas.Fr,
+            schemas.Fq
+        ]),
+        output: AztecAddress.schema
+    })
 };

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@aztec/end-to-end",
-  "version": "0.0.1-commit.4d3c002",
+  "version": "0.0.1-commit.4d9804df",
   "type": "module",
-  "exports": "./dest/index.js",
+  "exports": {
+    ".": "./dest/index.js",
+    "./*": "./dest/*"
+  },
   "inherits": [
     "../package.common.json",
     "./package.local.json"
@@ -26,44 +29,45 @@
     "formatting": "run -T prettier --check ./src && run -T eslint ./src"
   },
   "dependencies": {
-    "@aztec/accounts": "0.0.1-commit.4d3c002",
-    "@aztec/archiver": "0.0.1-commit.4d3c002",
-    "@aztec/aztec": "0.0.1-commit.4d3c002",
-    "@aztec/aztec-node": "0.0.1-commit.4d3c002",
-    "@aztec/aztec.js": "0.0.1-commit.4d3c002",
-    "@aztec/bb-prover": "0.0.1-commit.4d3c002",
-    "@aztec/bb.js": "0.0.1-commit.4d3c002",
-    "@aztec/blob-client": "0.0.1-commit.4d3c002",
-    "@aztec/blob-lib": "0.0.1-commit.4d3c002",
-    "@aztec/bot": "0.0.1-commit.4d3c002",
-    "@aztec/cli": "0.0.1-commit.4d3c002",
-    "@aztec/constants": "0.0.1-commit.4d3c002",
-    "@aztec/entrypoints": "0.0.1-commit.4d3c002",
-    "@aztec/epoch-cache": "0.0.1-commit.4d3c002",
-    "@aztec/ethereum": "0.0.1-commit.4d3c002",
-    "@aztec/foundation": "0.0.1-commit.4d3c002",
-    "@aztec/kv-store": "0.0.1-commit.4d3c002",
-    "@aztec/l1-artifacts": "0.0.1-commit.4d3c002",
-    "@aztec/node-keystore": "0.0.1-commit.4d3c002",
-    "@aztec/noir-contracts.js": "0.0.1-commit.4d3c002",
-    "@aztec/noir-noirc_abi": "0.0.1-commit.4d3c002",
-    "@aztec/noir-protocol-circuits-types": "0.0.1-commit.4d3c002",
-    "@aztec/noir-test-contracts.js": "0.0.1-commit.4d3c002",
-    "@aztec/p2p": "0.0.1-commit.4d3c002",
-    "@aztec/protocol-contracts": "0.0.1-commit.4d3c002",
-    "@aztec/prover-client": "0.0.1-commit.4d3c002",
-    "@aztec/prover-node": "0.0.1-commit.4d3c002",
-    "@aztec/pxe": "0.0.1-commit.4d3c002",
-    "@aztec/sequencer-client": "0.0.1-commit.4d3c002",
-    "@aztec/simulator": "0.0.1-commit.4d3c002",
-    "@aztec/slasher": "0.0.1-commit.4d3c002",
-    "@aztec/stdlib": "0.0.1-commit.4d3c002",
-    "@aztec/telemetry-client": "0.0.1-commit.4d3c002",
-    "@aztec/validator-client": "0.0.1-commit.4d3c002",
-    "@aztec/validator-ha-signer": "0.0.1-commit.4d3c002",
-    "@aztec/wallet-sdk": "0.0.1-commit.4d3c002",
-    "@aztec/wallets": "0.0.1-commit.4d3c002",
-    "@aztec/world-state": "0.0.1-commit.4d3c002",
+    "@aztec/accounts": "0.0.1-commit.4d9804df",
+    "@aztec/archiver": "0.0.1-commit.4d9804df",
+    "@aztec/aztec": "0.0.1-commit.4d9804df",
+    "@aztec/aztec-node": "0.0.1-commit.4d9804df",
+    "@aztec/aztec.js": "0.0.1-commit.4d9804df",
+    "@aztec/bb-prover": "0.0.1-commit.4d9804df",
+    "@aztec/bb.js": "0.0.1-commit.4d9804df",
+    "@aztec/blob-client": "0.0.1-commit.4d9804df",
+    "@aztec/blob-lib": "0.0.1-commit.4d9804df",
+    "@aztec/bot": "0.0.1-commit.4d9804df",
+    "@aztec/cli": "0.0.1-commit.4d9804df",
+    "@aztec/constants": "0.0.1-commit.4d9804df",
+    "@aztec/entrypoints": "0.0.1-commit.4d9804df",
+    "@aztec/epoch-cache": "0.0.1-commit.4d9804df",
+    "@aztec/ethereum": "0.0.1-commit.4d9804df",
+    "@aztec/foundation": "0.0.1-commit.4d9804df",
+    "@aztec/kv-store": "0.0.1-commit.4d9804df",
+    "@aztec/l1-artifacts": "0.0.1-commit.4d9804df",
+    "@aztec/node-keystore": "0.0.1-commit.4d9804df",
+    "@aztec/noir-contracts.js": "0.0.1-commit.4d9804df",
+    "@aztec/noir-noirc_abi": "0.0.1-commit.4d9804df",
+    "@aztec/noir-protocol-circuits-types": "0.0.1-commit.4d9804df",
+    "@aztec/noir-test-contracts.js": "0.0.1-commit.4d9804df",
+    "@aztec/p2p": "0.0.1-commit.4d9804df",
+    "@aztec/protocol-contracts": "0.0.1-commit.4d9804df",
+    "@aztec/prover-client": "0.0.1-commit.4d9804df",
+    "@aztec/prover-node": "0.0.1-commit.4d9804df",
+    "@aztec/pxe": "0.0.1-commit.4d9804df",
+    "@aztec/sequencer-client": "0.0.1-commit.4d9804df",
+    "@aztec/simulator": "0.0.1-commit.4d9804df",
+    "@aztec/slasher": "0.0.1-commit.4d9804df",
+    "@aztec/standard-contracts": "0.0.1-commit.4d9804df",
+    "@aztec/stdlib": "0.0.1-commit.4d9804df",
+    "@aztec/telemetry-client": "0.0.1-commit.4d9804df",
+    "@aztec/validator-client": "0.0.1-commit.4d9804df",
+    "@aztec/validator-ha-signer": "0.0.1-commit.4d9804df",
+    "@aztec/wallet-sdk": "0.0.1-commit.4d9804df",
+    "@aztec/wallets": "0.0.1-commit.4d9804df",
+    "@aztec/world-state": "0.0.1-commit.4d9804df",
     "@iarna/toml": "^2.2.5",
     "@jest/globals": "^30.0.0",
     "@noble/curves": "=1.0.0",
@@ -101,7 +105,7 @@
     "typescript": "^5.3.3",
     "util": "^0.12.5",
     "viem": "npm:@aztec/viem@2.38.2",
-    "zod": "^3.23.8"
+    "zod": "^4"
   },
   "devDependencies": {
     "0x": "^5.7.0",
@@ -159,12 +163,13 @@
     "moduleNameMapper": {
       "^(\\.{1,2}/.*)\\.[cm]?js$": "$1"
     },
+    "resolver": "<rootDir>/legacy-jest-resolver.cjs",
     "testRegex": "./src/.*\\.test\\.(js|mjs|ts)$",
     "rootDir": "./src",
     "testTimeout": 120000,
     "setupFiles": [
       "../../foundation/src/jest/setup.mjs"
     ],
-    "testEnvironment": "../../foundation/src/jest/env.mjs"
+    "testEnvironment": "./shared/timing_env.mjs"
   }
 }

package/src/automine/README.md

@@ -0,0 +1,60 @@
+# `automine` e2e test category
+
+Automine tests run a single Aztec node driving the deterministic `AutomineSequencer`: one block per
+submitted transaction, synchronous L1 publish, no committee, no prover, and no validator client. The
+node opts into this topology through the `AUTOMINE_E2E_OPTS` preset (`fixtures/fixtures.ts`), which the
+base context applies by default. This is the fast, deterministic counterpart to the `single-node`
+category, whose node runs the production sequencer with interval block production. A test belongs here
+when it exercises contract or protocol behavior that does not depend on real block-building or consensus
+(token transfers, nested calls, note discovery, tx semantics); it belongs in `single-node` when it
+asserts on sequencer, proving, or reorg behavior.
+
+## Base class
+
+All tests use `AutomineTestContext` (`automine_test_context.ts`), which owns:
+
+- The environment: an in-process anvil in automine mode plus the L1 contract deploy, wrapping
+  `fixtures/setup.ts:setup()` with `AUTOMINE_E2E_OPTS` and `fundSponsoredFPC` as defaults.
+- The common handles: `context`, `wallet`, `aztecNode`, `aztecNodeAdmin`, `cheatCodes`, `sequencer`,
+  `accounts`, `defaultAccountAddress`, `logger`.
+- `markProvenAndWarp(seconds)`: marks pending checkpoints proven before warping the L2 clock, so a long
+  warp does not trip the rollup's pruning window (see the method's doc comment).
+- `registerContract(...)`: computes and registers a contract instance without an on-chain deploy.
+- `applyManualParentChild()`: deploys a Parent and Child contract for the nested-call tests.
+
+Tests call the static `AutomineTestContext.setup({ numberOfAccounts })` factory (or `new` plus `setup()`
+for the harness subclasses), passing `numberOfAccounts` rather than spreading `AUTOMINE_E2E_OPTS`.
+
+## Harnesses
+
+Two domain harnesses extend `AutomineTestContext` and run their domain setup after `super.setup()`:
+
+- `token/token_contract_test.ts` — a `TokenSimulator` plus opt-in base/mint snapshots for the Token
+  contract tests.
+- `token/blacklist_token_contract_test.ts` — a `TokenSimulator`, the `Role` helper, and the
+  role-change-delay warp (via `markProvenAndWarp`) for the TokenBlacklist tests.
+
+## Organizing principle
+
+The top level groups tests by node topology (automine); the second level names the primary behavior
+under test rather than the shared setup. Each file has a single top-level `describe` named to match its
+path. A `.parallel` suffix marks files with more than one top-level `it`; CI splits each `it` into its
+own job.
+
+## Subfolders
+
+A second-level folder is created only when it earns its keep: a shared harness, an existing sub-hierarchy,
+or a coherent domain of several files. The remaining miscellaneous protocol/execution behaviors live as flat
+files directly under `automine/` — smoke, tx ordering/double-spend/phase checks, mempool limits, the app demos
+(card game, private voting), and the timestamp/PXE tests.
+
+| Path | Contents |
+|---|---|
+| `token/` | Token-economics tests on the two token harnesses plus the `TokenSimulator`/`LendingSimulator`-adjacent DeFi tests: token transfers/minting/burning/access-control, the blacklist token suite, AMM, lending, NFT, orderbook, crowdfunding, and escrow. |
+| `contracts/` | Contract lifecycle and cross-contract behavior. `deploy/` (class registration, deploy method, legacy deploy, private initialization), `nested/` (importer and the manual private/public nested-call patterns), plus contract updates, storage proofs, static calls, nested utility calls, and the ABI/storage-surface tests (ABI types, option params, state variables). |
+| `accounts/` | Account and key behavior: account contracts, keys, multiple accounts sharing an encryption key, two-PXE interop, authwit, and scope isolation. |
+| `effects/` | Note discovery, events, and offchain effects: note getters, pending note hashes, partial notes, event logs, event-only notes, offchain effects and payments, large public events, custom messages, the tx-effect oracle, and note rediscovery after pruned blocks. |
+| `simulation/` | Circuit simulation surface: the AVM simulator, kernelless simulation, and the circuit recorder. |
+
+The `simulation/avm_simulator` file is a genuine outlier: it dumps AVM circuit inputs for the downstream
+`avm_check_circuit` CI job, so it has a bespoke CI line and is excluded from the generic `simulation/` glob.