@aztec/test-wallet 3.0.0-nightly.20250911

package/dest/index.d.ts

@@ -0,0 +1,4 @@
+export { TestWallet } from './wallet/bundle.js';
+export { type AccountData } from './wallet/test_wallet.js';
+export { deployFundedSchnorrAccounts } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC"}

package/dest/index.js

@@ -0,0 +1,2 @@
+export { TestWallet } from './wallet/bundle.js';
+export { deployFundedSchnorrAccounts } from './utils.js';

package/dest/lazy.d.ts

@@ -0,0 +1,4 @@
+export { TestWallet } from './wallet/lazy.js';
+export { type AccountData } from './wallet/test_wallet.js';
+export { deployFundedSchnorrAccounts } from './utils.js';
+//# sourceMappingURL=lazy.d.ts.map

package/dest/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC"}

package/dest/lazy.js

@@ -0,0 +1,2 @@
+export { TestWallet } from './wallet/lazy.js';
+export { deployFundedSchnorrAccounts } from './utils.js';

package/dest/utils.d.ts

@@ -0,0 +1,9 @@
+import type { InitialAccountData } from '@aztec/accounts/testing';
+import type { WaitOpts } from '@aztec/aztec.js';
+import type { BaseTestWallet } from './wallet/test_wallet.js';
+/**
+ * Deploys the SchnorrAccount contracts backed by prefunded addresses
+ * at genesis. This can be directly used to pay for transactions in FeeJuice.
+ */
+export declare function deployFundedSchnorrAccounts(wallet: BaseTestWallet, accountsData: InitialAccountData[], waitOptions?: WaitOpts): Promise<import("@aztec/aztec.js").AccountManager[]>;
+//# sourceMappingURL=utils.d.ts.map

package/dest/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,kBAAkB,EAAE,EAClC,WAAW,CAAC,EAAE,QAAQ,uDAevB"}

package/dest/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Deploys the SchnorrAccount contracts backed by prefunded addresses
+ * at genesis. This can be directly used to pay for transactions in FeeJuice.
+ */ export async function deployFundedSchnorrAccounts(wallet, accountsData, waitOptions) {
+    const accountManagers = [];
+    // Serial due to https://github.com/AztecProtocol/aztec-packages/issues/12045
+    for(let i = 0; i < accountsData.length; i++){
+        const { secret, salt, signingKey } = accountsData[i];
+        const accountManager = await wallet.createSchnorrAccount(secret, salt, signingKey);
+        await accountManager.deploy({
+            skipClassPublication: i !== 0
+        }).wait(waitOptions);
+        accountManagers.push(accountManager);
+    }
+    return accountManagers;
+}

package/dest/wallet/bundle.d.ts

@@ -0,0 +1,16 @@
+import { AccountManager, type AztecAddress, Fq, Fr } from '@aztec/aztec.js';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts eagerly
+ */
+export declare class TestWallet extends BaseTestWallet {
+    createSchnorrAccount(secret: Fr, salt: Fr, signingKey?: Fq): Promise<AccountManager>;
+    createECDSARAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+    createECDSAKAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+    getFakeAccountDataFor(address: AztecAddress): Promise<{
+        account: import("@aztec/aztec.js").BaseAccount;
+        instance: import("@aztec/aztec.js").ContractInstanceWithAddress;
+        artifact: import("@aztec/aztec.js").ContractArtifact;
+    }>;
+}
+//# sourceMappingURL=bundle.d.ts.map

package/dest/wallet/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/wallet/bundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,EAAE,EAAE,EAAE,EAA8C,MAAM,iBAAiB,CAAC;AAGxH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,oBAAoB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAUpF,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAStF,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAShF,qBAAqB,CAAC,OAAO,EAAE,YAAY;;;;;CAgBlD"}

package/dest/wallet/bundle.js

@@ -0,0 +1,51 @@
+import { EcdsaKAccountContract, EcdsaRAccountContract } from '@aztec/accounts/ecdsa';
+import { SchnorrAccountContract } from '@aztec/accounts/schnorr';
+import { StubAccountContractArtifact, createStubAccount } from '@aztec/accounts/stub';
+import { getContractInstanceFromInstantiationParams } from '@aztec/aztec.js';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts eagerly
+ */ export class TestWallet extends BaseTestWallet {
+    createSchnorrAccount(secret, salt, signingKey) {
+        signingKey = signingKey ?? deriveSigningKey(secret);
+        const accountData = {
+            secret,
+            salt,
+            contract: new SchnorrAccountContract(signingKey)
+        };
+        return this.createAccount(accountData);
+    }
+    createECDSARAccount(secret, salt, signingKey) {
+        const accountData = {
+            secret,
+            salt,
+            contract: new EcdsaRAccountContract(signingKey)
+        };
+        return this.createAccount(accountData);
+    }
+    createECDSAKAccount(secret, salt, signingKey) {
+        const accountData = {
+            secret,
+            salt,
+            contract: new EcdsaKAccountContract(signingKey)
+        };
+        return this.createAccount(accountData);
+    }
+    async getFakeAccountDataFor(address) {
+        const nodeInfo = await this.pxe.getNodeInfo();
+        const originalAccount = await this.getAccountFromAddress(address);
+        const originalAddress = originalAccount.getCompleteAddress();
+        const { contractInstance } = await this.pxe.getContractMetadata(originalAddress.address);
+        if (!contractInstance) {
+            throw new Error(`No contract instance found for address: ${originalAddress.address}`);
+        }
+        const stubAccount = createStubAccount(originalAddress, nodeInfo);
+        const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {});
+        return {
+            account: stubAccount,
+            instance,
+            artifact: StubAccountContractArtifact
+        };
+    }
+}

package/dest/wallet/lazy.d.ts

@@ -0,0 +1,16 @@
+import { AccountManager, type AztecAddress, Fq, Fr } from '@aztec/aztec.js';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts lazily
+ */
+export declare class TestWallet extends BaseTestWallet {
+    createSchnorrAccount(secret: Fr, salt: Fr, signingKey?: Fq): Promise<AccountManager>;
+    createECDSARAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+    createECDSAKAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+    getFakeAccountDataFor(address: AztecAddress): Promise<{
+        account: import("@aztec/aztec.js").BaseAccount;
+        instance: import("@aztec/aztec.js").ContractInstanceWithAddress;
+        artifact: import("@aztec/aztec.js").ContractArtifact;
+    }>;
+}
+//# sourceMappingURL=lazy.d.ts.map

package/dest/wallet/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/wallet/lazy.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,EAAE,EAAE,EAAE,EAA8C,MAAM,iBAAiB,CAAC;AAGxH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,oBAAoB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAUpF,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAStF,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAShF,qBAAqB,CAAC,OAAO,EAAE,YAAY;;;;;CAiBlD"}

package/dest/wallet/lazy.js

@@ -0,0 +1,52 @@
+import { EcdsaKAccountContract, EcdsaRAccountContract } from '@aztec/accounts/ecdsa/lazy';
+import { SchnorrAccountContract } from '@aztec/accounts/schnorr/lazy';
+import { createStubAccount, getStubAccountContractArtifact } from '@aztec/accounts/stub/lazy';
+import { getContractInstanceFromInstantiationParams } from '@aztec/aztec.js';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts lazily
+ */ export class TestWallet extends BaseTestWallet {
+    createSchnorrAccount(secret, salt, signingKey) {
+        signingKey = signingKey ?? deriveSigningKey(secret);
+        const accountData = {
+            secret,
+            salt,
+            contract: new SchnorrAccountContract(signingKey)
+        };
+        return this.createAccount(accountData);
+    }
+    createECDSARAccount(secret, salt, signingKey) {
+        const accountData = {
+            secret,
+            salt,
+            contract: new EcdsaRAccountContract(signingKey)
+        };
+        return this.createAccount(accountData);
+    }
+    createECDSAKAccount(secret, salt, signingKey) {
+        const accountData = {
+            secret,
+            salt,
+            contract: new EcdsaKAccountContract(signingKey)
+        };
+        return this.createAccount(accountData);
+    }
+    async getFakeAccountDataFor(address) {
+        const nodeInfo = await this.pxe.getNodeInfo();
+        const originalAccount = await this.getAccountFromAddress(address);
+        const originalAddress = originalAccount.getCompleteAddress();
+        const { contractInstance } = await this.pxe.getContractMetadata(originalAddress.address);
+        if (!contractInstance) {
+            throw new Error(`No contract instance found for address: ${originalAddress.address}`);
+        }
+        const stubAccount = createStubAccount(originalAddress, nodeInfo);
+        const StubAccountContractArtifact = await getStubAccountContractArtifact();
+        const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {});
+        return {
+            account: stubAccount,
+            instance,
+            artifact: StubAccountContractArtifact
+        };
+    }
+}

package/dest/wallet/test_wallet.d.ts

@@ -0,0 +1,51 @@
+import { type Account, type AccountContract, AccountManager, BaseWallet, type ContractArtifact, type IntentAction, type IntentInnerHash, type SimulateMethodOptions } from '@aztec/aztec.js';
+import type { ExecutionPayload } from '@aztec/entrypoints/payload';
+import { Fq, Fr } from '@aztec/foundation/fields';
+import { AuthWitness } from '@aztec/stdlib/auth-witness';
+import { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { ContractInstanceWithAddress } from '@aztec/stdlib/contract';
+import type { TxSimulationResult } from '@aztec/stdlib/tx';
+/**
+ * Data for generating an account.
+ */
+export interface AccountData {
+    /**
+     * Secret to derive the keys for the account.
+     */
+    secret: Fr;
+    /**
+     * Contract address salt.
+     */
+    salt: Fr;
+    /**
+     * Contract that backs the account.
+     */
+    contract: AccountContract;
+}
+/**
+ * Wallet implementation that stores accounts in memory and allows allows their creation
+ * from the outside (which is something actual wallets shouldn't allow!)
+ * It is intended to be used in e2e tests.
+ */
+export declare abstract class BaseTestWallet extends BaseWallet {
+    protected accounts: Map<string, Account>;
+    private simulatedSimulations;
+    enableSimulatedSimulations(): void;
+    disableSimulatedSimulations(): void;
+    protected getAccountFromAddress(address: AztecAddress): Promise<Account>;
+    createAccount(accountData: AccountData): Promise<AccountManager>;
+    abstract createSchnorrAccount(secret: Fr, salt: Fr, signingKey?: Fq): Promise<AccountManager>;
+    abstract createECDSARAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+    abstract createECDSAKAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+    lookupValidity(address: AztecAddress, intent: IntentInnerHash | IntentAction, witness: AuthWitness): Promise<{
+        isValidInPrivate: boolean;
+        isValidInPublic: boolean;
+    }>;
+    abstract getFakeAccountDataFor(address: AztecAddress): Promise<{
+        account: Account;
+        instance: ContractInstanceWithAddress;
+        artifact: ContractArtifact;
+    }>;
+    simulateTx(executionPayload: ExecutionPayload, opts: SimulateMethodOptions): Promise<TxSimulationResult>;
+}
+//# sourceMappingURL=test_wallet.d.ts.map

package/dest/wallet/test_wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_wallet.d.ts","sourceRoot":"","sources":["../../src/wallet/test_wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,cAAc,EAEd,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,eAAe,EAEpB,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,EAAE,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,EAAE,CAAC;IACT;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;;;GAIG;AACH,8BAAsB,cAAe,SAAQ,UAAU;IACrD,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;IAErD,OAAO,CAAC,oBAAoB,CAAS;IAErC,0BAA0B;IAI1B,2BAA2B;cAIX,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBxE,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAgBtE,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAC7F,QAAQ,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/F,QAAQ,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAEzF,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,GAAG,YAAY,EAAE,OAAO,EAAE,WAAW;;;;IAKxG,QAAQ,CAAC,qBAAqB,CAC5B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,2BAA2B,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAEpF,UAAU,CACvB,gBAAgB,EAAE,gBAAgB,EAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,kBAAkB,CAAC;CAc/B"}

package/dest/wallet/test_wallet.js

@@ -0,0 +1,63 @@
+import { AccountManager, BaseWallet, SignerlessAccount } from '@aztec/aztec.js';
+import { DefaultMultiCallEntrypoint } from '@aztec/entrypoints/multicall';
+import { Fr } from '@aztec/foundation/fields';
+import { AztecAddress } from '@aztec/stdlib/aztec-address';
+/**
+ * Wallet implementation that stores accounts in memory and allows allows their creation
+ * from the outside (which is something actual wallets shouldn't allow!)
+ * It is intended to be used in e2e tests.
+ */ export class BaseTestWallet extends BaseWallet {
+    accounts = new Map();
+    simulatedSimulations = false;
+    enableSimulatedSimulations() {
+        this.simulatedSimulations = true;
+    }
+    disableSimulatedSimulations() {
+        this.simulatedSimulations = false;
+    }
+    async getAccountFromAddress(address) {
+        let account;
+        if (address.equals(AztecAddress.ZERO)) {
+            const { l1ChainId: chainId, rollupVersion } = await this.pxe.getNodeInfo();
+            account = new SignerlessAccount(new DefaultMultiCallEntrypoint(chainId, rollupVersion));
+        } else {
+            account = this.accounts.get(address?.toString() ?? '');
+        }
+        if (!account) {
+            throw new Error(`Account not found in wallet for address: ${address}`);
+        }
+        return account;
+    }
+    async createAccount(accountData) {
+        const accountManager = await AccountManager.create(this, this.pxe, accountData.secret, accountData.contract, accountData.salt);
+        await accountManager.register();
+        this.accounts.set(accountManager.getAddress().toString(), await accountManager.getAccount());
+        return accountManager;
+    }
+    async lookupValidity(address, intent, witness) {
+        const account = await this.getAccountFromAddress(address);
+        return account.lookupValidity(this, address, intent, witness);
+    }
+    async simulateTx(executionPayload, opts) {
+        if (!this.simulatedSimulations) {
+            return super.simulateTx(executionPayload, opts);
+        } else {
+            const executionOptions = {
+                txNonce: Fr.random(),
+                cancellable: false
+            };
+            const { account: fromAccount, instance, artifact } = await this.getFakeAccountDataFor(opts.from);
+            const fee = await this.getFeeOptions(fromAccount, executionPayload, opts.fee, executionOptions);
+            const txRequest = await fromAccount.createTxExecutionRequest(executionPayload, fee, executionOptions);
+            const contractOverrides = {
+                [opts.from.toString()]: {
+                    instance,
+                    artifact
+                }
+            };
+            return this.pxe.simulateTx(txRequest, true, true, true, {
+                contracts: contractOverrides
+            });
+        }
+    }
+}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@aztec/test-wallet",
+  "homepage": "https://github.com/AztecProtocol/aztec-packages/tree/master/yarn-project/test-wallet",
+  "version": "3.0.0-nightly.20250911",
+  "type": "module",
+  "exports": {
+    ".": "./dest/index.js",
+    "./lazy": "./dest/lazy.js"
+  },
+  "typedocOptions": {
+    "entryPoints": [
+      "./src/index.ts"
+    ],
+    "tsconfig": "./tsconfig.json"
+  },
+  "scripts": {
+    "build": "yarn clean && tsc -b",
+    "build:dev": "tsc -b --watch",
+    "build:ts": "tsc -b",
+    "clean": "rm -rf ./dest .tsbuildinfo",
+    "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
+  },
+  "inherits": [
+    "../package.common.json"
+  ],
+  "jest": {
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.[cm]?js$": "$1"
+    },
+    "testRegex": "./src/.*\\.test\\.(js|mjs|ts)$",
+    "rootDir": "./src",
+    "transform": {
+      "^.+\\.tsx?$": [
+        "@swc/jest",
+        {
+          "jsc": {
+            "parser": {
+              "syntax": "typescript",
+              "decorators": true
+            },
+            "transform": {
+              "decoratorVersion": "2022-03"
+            }
+          }
+        }
+      ]
+    },
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "reporters": [
+      "default"
+    ],
+    "testTimeout": 120000,
+    "setupFiles": [
+      "../../foundation/src/jest/setup.mjs"
+    ],
+    "testEnvironment": "../../foundation/src/jest/env.mjs",
+    "setupFilesAfterEnv": [
+      "../../foundation/src/jest/setupAfterEnv.mjs"
+    ]
+  },
+  "dependencies": {
+    "@aztec/accounts": "3.0.0-nightly.20250911",
+    "@aztec/aztec.js": "3.0.0-nightly.20250911",
+    "@aztec/entrypoints": "3.0.0-nightly.20250911",
+    "@aztec/foundation": "3.0.0-nightly.20250911",
+    "@aztec/noir-contracts.js": "3.0.0-nightly.20250911",
+    "@aztec/stdlib": "3.0.0-nightly.20250911"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.15.17",
+    "jest": "^30.0.0",
+    "resolve-typescript-plugin": "^2.0.1",
+    "ts-loader": "^9.4.4",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.3.3",
+    "util": "^0.12.5"
+  },
+  "files": [
+    "dest",
+    "src",
+    "!*.test.*",
+    "artifacts"
+  ],
+  "types": "./dest/index.d.ts",
+  "engines": {
+    "node": ">=20.10"
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { TestWallet } from './wallet/bundle.js';
+export { type AccountData } from './wallet/test_wallet.js';
+export { deployFundedSchnorrAccounts } from './utils.js';

package/src/lazy.ts

@@ -0,0 +1,3 @@
+export { TestWallet } from './wallet/lazy.js';
+export { type AccountData } from './wallet/test_wallet.js';
+export { deployFundedSchnorrAccounts } from './utils.js';

package/src/utils.ts

@@ -0,0 +1,28 @@
+import type { InitialAccountData } from '@aztec/accounts/testing';
+import type { WaitOpts } from '@aztec/aztec.js';
+
+import type { BaseTestWallet } from './wallet/test_wallet.js';
+
+/**
+ * Deploys the SchnorrAccount contracts backed by prefunded addresses
+ * at genesis. This can be directly used to pay for transactions in FeeJuice.
+ */
+export async function deployFundedSchnorrAccounts(
+  wallet: BaseTestWallet,
+  accountsData: InitialAccountData[],
+  waitOptions?: WaitOpts,
+) {
+  const accountManagers = [];
+  // Serial due to https://github.com/AztecProtocol/aztec-packages/issues/12045
+  for (let i = 0; i < accountsData.length; i++) {
+    const { secret, salt, signingKey } = accountsData[i];
+    const accountManager = await wallet.createSchnorrAccount(secret, salt, signingKey);
+    await accountManager
+      .deploy({
+        skipClassPublication: i !== 0, // Publish the contract class at most once.
+      })
+      .wait(waitOptions);
+    accountManagers.push(accountManager);
+  }
+  return accountManagers;
+}

package/src/wallet/bundle.ts

@@ -0,0 +1,57 @@
+import { EcdsaKAccountContract, EcdsaRAccountContract } from '@aztec/accounts/ecdsa';
+import { SchnorrAccountContract } from '@aztec/accounts/schnorr';
+import { StubAccountContractArtifact, createStubAccount } from '@aztec/accounts/stub';
+import { AccountManager, type AztecAddress, Fq, Fr, getContractInstanceFromInstantiationParams } from '@aztec/aztec.js';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+
+import { BaseTestWallet } from './test_wallet.js';
+
+/**
+ * A TestWallet implementation that loads the account contract artifacts eagerly
+ */
+export class TestWallet extends BaseTestWallet {
+  createSchnorrAccount(secret: Fr, salt: Fr, signingKey?: Fq): Promise<AccountManager> {
+    signingKey = signingKey ?? deriveSigningKey(secret);
+    const accountData = {
+      secret,
+      salt,
+      contract: new SchnorrAccountContract(signingKey),
+    };
+    return this.createAccount(accountData);
+  }
+
+  createECDSARAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager> {
+    const accountData = {
+      secret,
+      salt,
+      contract: new EcdsaRAccountContract(signingKey),
+    };
+    return this.createAccount(accountData);
+  }
+
+  createECDSAKAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager> {
+    const accountData = {
+      secret,
+      salt,
+      contract: new EcdsaKAccountContract(signingKey),
+    };
+    return this.createAccount(accountData);
+  }
+
+  async getFakeAccountDataFor(address: AztecAddress) {
+    const nodeInfo = await this.pxe.getNodeInfo();
+    const originalAccount = await this.getAccountFromAddress(address);
+    const originalAddress = originalAccount.getCompleteAddress();
+    const { contractInstance } = await this.pxe.getContractMetadata(originalAddress.address);
+    if (!contractInstance) {
+      throw new Error(`No contract instance found for address: ${originalAddress.address}`);
+    }
+    const stubAccount = createStubAccount(originalAddress, nodeInfo);
+    const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {});
+    return {
+      account: stubAccount,
+      instance,
+      artifact: StubAccountContractArtifact,
+    };
+  }
+}

package/src/wallet/lazy.ts

@@ -0,0 +1,58 @@
+import { EcdsaKAccountContract, EcdsaRAccountContract } from '@aztec/accounts/ecdsa/lazy';
+import { SchnorrAccountContract } from '@aztec/accounts/schnorr/lazy';
+import { createStubAccount, getStubAccountContractArtifact } from '@aztec/accounts/stub/lazy';
+import { AccountManager, type AztecAddress, Fq, Fr, getContractInstanceFromInstantiationParams } from '@aztec/aztec.js';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+
+import { BaseTestWallet } from './test_wallet.js';
+
+/**
+ * A TestWallet implementation that loads the account contract artifacts lazily
+ */
+export class TestWallet extends BaseTestWallet {
+  createSchnorrAccount(secret: Fr, salt: Fr, signingKey?: Fq): Promise<AccountManager> {
+    signingKey = signingKey ?? deriveSigningKey(secret);
+    const accountData = {
+      secret,
+      salt,
+      contract: new SchnorrAccountContract(signingKey),
+    };
+    return this.createAccount(accountData);
+  }
+
+  createECDSARAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager> {
+    const accountData = {
+      secret,
+      salt,
+      contract: new EcdsaRAccountContract(signingKey),
+    };
+    return this.createAccount(accountData);
+  }
+
+  createECDSAKAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager> {
+    const accountData = {
+      secret,
+      salt,
+      contract: new EcdsaKAccountContract(signingKey),
+    };
+    return this.createAccount(accountData);
+  }
+
+  async getFakeAccountDataFor(address: AztecAddress) {
+    const nodeInfo = await this.pxe.getNodeInfo();
+    const originalAccount = await this.getAccountFromAddress(address);
+    const originalAddress = originalAccount.getCompleteAddress();
+    const { contractInstance } = await this.pxe.getContractMetadata(originalAddress.address);
+    if (!contractInstance) {
+      throw new Error(`No contract instance found for address: ${originalAddress.address}`);
+    }
+    const stubAccount = createStubAccount(originalAddress, nodeInfo);
+    const StubAccountContractArtifact = await getStubAccountContractArtifact();
+    const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {});
+    return {
+      account: stubAccount,
+      instance,
+      artifact: StubAccountContractArtifact,
+    };
+  }
+}

package/src/wallet/test_wallet.ts

@@ -0,0 +1,119 @@
+import {
+  type Account,
+  type AccountContract,
+  AccountManager,
+  BaseAccount,
+  BaseWallet,
+  type ContractArtifact,
+  type IntentAction,
+  type IntentInnerHash,
+  SignerlessAccount,
+  type SimulateMethodOptions,
+} from '@aztec/aztec.js';
+import { DefaultMultiCallEntrypoint } from '@aztec/entrypoints/multicall';
+import type { ExecutionPayload } from '@aztec/entrypoints/payload';
+import { Fq, Fr } from '@aztec/foundation/fields';
+import { AuthWitness } from '@aztec/stdlib/auth-witness';
+import { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { ContractInstanceWithAddress } from '@aztec/stdlib/contract';
+import type { TxSimulationResult } from '@aztec/stdlib/tx';
+
+/**
+ * Data for generating an account.
+ */
+export interface AccountData {
+  /**
+   * Secret to derive the keys for the account.
+   */
+  secret: Fr;
+  /**
+   * Contract address salt.
+   */
+  salt: Fr;
+  /**
+   * Contract that backs the account.
+   */
+  contract: AccountContract;
+}
+
+/**
+ * Wallet implementation that stores accounts in memory and allows allows their creation
+ * from the outside (which is something actual wallets shouldn't allow!)
+ * It is intended to be used in e2e tests.
+ */
+export abstract class BaseTestWallet extends BaseWallet {
+  protected accounts: Map<string, Account> = new Map();
+
+  private simulatedSimulations = false;
+
+  enableSimulatedSimulations() {
+    this.simulatedSimulations = true;
+  }
+
+  disableSimulatedSimulations() {
+    this.simulatedSimulations = false;
+  }
+
+  protected async getAccountFromAddress(address: AztecAddress): Promise<Account> {
+    let account: Account | undefined;
+    if (address.equals(AztecAddress.ZERO)) {
+      const { l1ChainId: chainId, rollupVersion } = await this.pxe.getNodeInfo();
+      account = new SignerlessAccount(new DefaultMultiCallEntrypoint(chainId, rollupVersion));
+    } else {
+      account = this.accounts.get(address?.toString() ?? '');
+    }
+
+    if (!account) {
+      throw new Error(`Account not found in wallet for address: ${address}`);
+    }
+
+    return account;
+  }
+
+  async createAccount(accountData: AccountData): Promise<AccountManager> {
+    const accountManager = await AccountManager.create(
+      this,
+      this.pxe,
+      accountData.secret,
+      accountData.contract,
+      accountData.salt,
+    );
+
+    await accountManager.register();
+
+    this.accounts.set(accountManager.getAddress().toString(), await accountManager.getAccount());
+
+    return accountManager;
+  }
+
+  abstract createSchnorrAccount(secret: Fr, salt: Fr, signingKey?: Fq): Promise<AccountManager>;
+  abstract createECDSARAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+  abstract createECDSAKAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager>;
+
+  async lookupValidity(address: AztecAddress, intent: IntentInnerHash | IntentAction, witness: AuthWitness) {
+    const account = (await this.getAccountFromAddress(address)) as BaseAccount;
+    return account.lookupValidity(this, address, intent, witness);
+  }
+
+  abstract getFakeAccountDataFor(
+    address: AztecAddress, // eslint-disable-next-line jsdoc/require-jsdoc
+  ): Promise<{ account: Account; instance: ContractInstanceWithAddress; artifact: ContractArtifact }>;
+
+  override async simulateTx(
+    executionPayload: ExecutionPayload,
+    opts: SimulateMethodOptions,
+  ): Promise<TxSimulationResult> {
+    if (!this.simulatedSimulations) {
+      return super.simulateTx(executionPayload, opts);
+    } else {
+      const executionOptions = { txNonce: Fr.random(), cancellable: false };
+      const { account: fromAccount, instance, artifact } = await this.getFakeAccountDataFor(opts.from);
+      const fee = await this.getFeeOptions(fromAccount, executionPayload, opts.fee, executionOptions);
+      const txRequest = await fromAccount.createTxExecutionRequest(executionPayload, fee, executionOptions);
+      const contractOverrides = {
+        [opts.from.toString()]: { instance, artifact },
+      };
+      return this.pxe.simulateTx(txRequest, true /* simulatePublic */, true, true, { contracts: contractOverrides });
+    }
+  }
+}