@aztec/test-wallet 3.0.0-devnet.2

package/dest/bundle.d.ts

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

package/dest/bundle.d.ts.map

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

package/dest/bundle.js

@@ -0,0 +1,2 @@
+export { TestWallet } from './wallet/bundle.js';
+export { deployFundedSchnorrAccounts, registerInitialSandboxAccountsInWallet, ProvenTx, proveInteraction } 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, registerInitialSandboxAccountsInWallet, ProvenTx, proveInteraction, } 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,EACL,2BAA2B,EAC3B,sCAAsC,EACtC,QAAQ,EACR,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dest/lazy.js

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

package/dest/server.d.ts

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

package/dest/server.d.ts.map

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

package/dest/server.js

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

package/dest/utils.d.ts

@@ -0,0 +1,39 @@
+import type { InitialAccountData } from '@aztec/accounts/testing';
+import { AztecAddress } from '@aztec/aztec.js/addresses';
+import { ContractFunctionInteraction, DeployMethod, type DeployOptions, type SendInteractionOptions, SentTx, type WaitOpts } from '@aztec/aztec.js/contracts';
+import type { AztecNode } from '@aztec/aztec.js/node';
+import { type OffchainEffect, type ProvingStats, Tx } from '@aztec/stdlib/tx';
+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, aztecNode: AztecNode, accountsData: InitialAccountData[], waitOptions?: WaitOpts): Promise<import("@aztec/aztec.js/wallet").AccountManager[]>;
+/**
+ * Registers the initial sandbox accounts in the wallet.
+ * @param wallet - Test wallet to use to register the accounts.
+ * @returns Addresses of the registered accounts.
+ */
+export declare function registerInitialSandboxAccountsInWallet(wallet: BaseTestWallet): Promise<AztecAddress[]>;
+/**
+ * A proven transaction that can be sent to the network. Returned by the `prove` method of the test wallet
+ */
+export declare class ProvenTx extends Tx {
+    private node;
+    /** The offchain effects emitted during the execution of the transaction. */
+    offchainEffects: OffchainEffect[];
+    stats?: ProvingStats | undefined;
+    constructor(node: AztecNode, tx: Tx, 
+    /** The offchain effects emitted during the execution of the transaction. */
+    offchainEffects: OffchainEffect[], stats?: ProvingStats | undefined);
+    send(): SentTx;
+}
+/**
+ * Helper function to prove an interaction via a TestWallet
+ * @param wallet - The TestWallet to use
+ * @param interaction - The interaction to prove
+ * @param options - Either SendInteractionOptions (for ContractFunctionInteraction) or DeployOptions (for DeployMethod)
+ * @returns - A proven transaction ready do be sent to the network
+ */
+export declare function proveInteraction(wallet: BaseTestWallet, interaction: ContractFunctionInteraction | DeployMethod, options: SendInteractionOptions | DeployOptions): Promise<ProvenTx>;
+//# 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;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,MAAM,EACN,KAAK,QAAQ,EAEd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,kBAAkB,EAAE,EAClC,WAAW,CAAC,EAAE,QAAQ,8DAiBvB;AAED;;;;GAIG;AACH,wBAAsB,sCAAsC,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO5G;AACD;;GAEG;AACH,qBAAa,QAAS,SAAQ,EAAE;IAE5B,OAAO,CAAC,IAAI;IAEZ,4EAA4E;IACrE,eAAe,EAAE,cAAc,EAAE;IAEjC,KAAK,CAAC,EAAE,YAAY;gBALnB,IAAI,EAAE,SAAS,EACvB,EAAE,EAAE,EAAE;IACN,4EAA4E;IACrE,eAAe,EAAE,cAAc,EAAE,EAEjC,KAAK,CAAC,EAAE,YAAY,YAAA;IAK7B,IAAI;CAOL;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,2BAA2B,GAAG,YAAY,EACvD,OAAO,EAAE,sBAAsB,GAAG,aAAa,qBAShD"}

package/dest/utils.js

@@ -0,0 +1,65 @@
+import { getInitialTestAccountsData } from '@aztec/accounts/testing/lazy';
+import { AztecAddress } from '@aztec/aztec.js/addresses';
+import { DeployMethod, SentTx, toSendOptions } from '@aztec/aztec.js/contracts';
+import { Tx } from '@aztec/stdlib/tx';
+/**
+ * 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, aztecNode, 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);
+        const deployMethod = await accountManager.getDeployMethod();
+        await deployMethod.send({
+            from: AztecAddress.ZERO,
+            skipClassPublication: i !== 0
+        }).wait(waitOptions);
+        accountManagers.push(accountManager);
+    }
+    return accountManagers;
+}
+/**
+ * Registers the initial sandbox accounts in the wallet.
+ * @param wallet - Test wallet to use to register the accounts.
+ * @returns Addresses of the registered accounts.
+ */ export async function registerInitialSandboxAccountsInWallet(wallet) {
+    const testAccounts = await getInitialTestAccountsData();
+    return Promise.all(testAccounts.map(async (account)=>{
+        return (await wallet.createSchnorrAccount(account.secret, account.salt, account.signingKey)).address;
+    }));
+}
+/**
+ * A proven transaction that can be sent to the network. Returned by the `prove` method of the test wallet
+ */ export class ProvenTx extends Tx {
+    node;
+    offchainEffects;
+    stats;
+    constructor(node, tx, /** The offchain effects emitted during the execution of the transaction. */ offchainEffects, // eslint-disable-next-line jsdoc/require-jsdoc
+    stats){
+        super(tx.getTxHash(), tx.data, tx.clientIvcProof, tx.contractClassLogFields, tx.publicFunctionCalldata), this.node = node, this.offchainEffects = offchainEffects, this.stats = stats;
+    }
+    send() {
+        const sendTx = async ()=>{
+            await this.node.sendTx(this);
+            return this.getTxHash();
+        };
+        return new SentTx(this.node, sendTx);
+    }
+}
+/**
+ * Helper function to prove an interaction via a TestWallet
+ * @param wallet - The TestWallet to use
+ * @param interaction - The interaction to prove
+ * @param options - Either SendInteractionOptions (for ContractFunctionInteraction) or DeployOptions (for DeployMethod)
+ * @returns - A proven transaction ready do be sent to the network
+ */ export async function proveInteraction(wallet, interaction, options) {
+    let execPayload;
+    if (interaction instanceof DeployMethod) {
+        execPayload = await interaction.request(interaction.convertDeployOptionsToRequestOptions(options));
+    } else {
+        execPayload = await interaction.request(options);
+    }
+    return wallet.proveTx(execPayload, await toSendOptions(options));
+}

package/dest/wallet/bundle.d.ts

@@ -0,0 +1,23 @@
+import type { AztecAddress } from '@aztec/aztec.js/addresses';
+import { Fq, Fr } from '@aztec/aztec.js/fields';
+import type { AztecNode } from '@aztec/aztec.js/node';
+import { AccountManager } from '@aztec/aztec.js/wallet';
+import { type PXEConfig, type PXECreationOptions } from '@aztec/pxe/client/bundle';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts eagerly
+ * Note that the only difference from `lazy` and `server` test wallets is that it uses the `createPXE` function
+ * from the `pxe/client/bundle` package.
+ */
+export declare class TestWallet extends BaseTestWallet {
+    static create(node: AztecNode, overridePXEConfig?: Partial<PXEConfig>, options?: PXECreationOptions): Promise<TestWallet>;
+    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/account").BaseAccount;
+        instance: import("@aztec/aztec.js/contracts").ContractInstanceWithAddress;
+        artifact: import("@aztec/aztec.js/abi").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,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,kBAAkB,EAA2B,MAAM,0BAA0B,CAAC;AAG5G,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,cAAc;WAC/B,MAAM,CACjB,IAAI,EAAE,SAAS,EACf,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,GAAE,kBAAoC,GAC5C,OAAO,CAAC,UAAU,CAAC;IAStB,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;;;;;CAkBlD"}

package/dest/wallet/bundle.js

@@ -0,0 +1,67 @@
+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/contracts';
+import { Fr } from '@aztec/aztec.js/fields';
+import { createPXE, getPXEConfig } from '@aztec/pxe/client/bundle';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts eagerly
+ * Note that the only difference from `lazy` and `server` test wallets is that it uses the `createPXE` function
+ * from the `pxe/client/bundle` package.
+ */ export class TestWallet extends BaseTestWallet {
+    static async create(node, overridePXEConfig, options = {
+        loggers: {}
+    }) {
+        const pxeConfig = Object.assign(getPXEConfig(), {
+            proverEnabled: overridePXEConfig?.proverEnabled ?? false,
+            ...overridePXEConfig
+        });
+        const pxe = await createPXE(node, pxeConfig, options);
+        return new TestWallet(pxe, node);
+    }
+    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 chainInfo = await this.getChainInfo();
+        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, chainInfo);
+        const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {
+            salt: Fr.random()
+        });
+        return {
+            account: stubAccount,
+            instance,
+            artifact: StubAccountContractArtifact
+        };
+    }
+}

package/dest/wallet/lazy.d.ts

@@ -0,0 +1,23 @@
+import type { AztecAddress } from '@aztec/aztec.js/addresses';
+import { Fq, Fr } from '@aztec/aztec.js/fields';
+import type { AztecNode } from '@aztec/aztec.js/node';
+import { AccountManager } from '@aztec/aztec.js/wallet';
+import { type PXEConfig, type PXECreationOptions } from '@aztec/pxe/client/lazy';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts lazily
+ * Note that the only difference from `server` and `bundle` test wallets is that it uses the `createPXE` function
+ * from the `pxe/client/lazy` package.
+ */
+export declare class TestWallet extends BaseTestWallet {
+    static create(node: AztecNode, overridePXEConfig?: Partial<PXEConfig>, options?: PXECreationOptions): Promise<TestWallet>;
+    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/account").BaseAccount;
+        instance: import("@aztec/aztec.js/contracts").ContractInstanceWithAddress;
+        artifact: import("@aztec/aztec.js/abi").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,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,kBAAkB,EAA2B,MAAM,wBAAwB,CAAC;AAG1G,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,cAAc;WAC/B,MAAM,CACjB,IAAI,EAAE,SAAS,EACf,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,GAAE,kBAAoC,GAC5C,OAAO,CAAC,UAAU,CAAC;IAStB,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;;;;;CAmBlD"}

package/dest/wallet/lazy.js

@@ -0,0 +1,68 @@
+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/contracts';
+import { Fr } from '@aztec/aztec.js/fields';
+import { createPXE, getPXEConfig } from '@aztec/pxe/client/lazy';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation that loads the account contract artifacts lazily
+ * Note that the only difference from `server` and `bundle` test wallets is that it uses the `createPXE` function
+ * from the `pxe/client/lazy` package.
+ */ export class TestWallet extends BaseTestWallet {
+    static async create(node, overridePXEConfig, options = {
+        loggers: {}
+    }) {
+        const pxeConfig = Object.assign(getPXEConfig(), {
+            proverEnabled: overridePXEConfig?.proverEnabled ?? false,
+            ...overridePXEConfig
+        });
+        const pxe = await createPXE(node, pxeConfig, options);
+        return new TestWallet(pxe, node);
+    }
+    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 chainInfo = await this.getChainInfo();
+        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, chainInfo);
+        const StubAccountContractArtifact = await getStubAccountContractArtifact();
+        const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {
+            salt: Fr.random()
+        });
+        return {
+            account: stubAccount,
+            instance,
+            artifact: StubAccountContractArtifact
+        };
+    }
+}

package/dest/wallet/server.d.ts

@@ -0,0 +1,23 @@
+import type { AztecAddress } from '@aztec/aztec.js/addresses';
+import { Fq, Fr } from '@aztec/aztec.js/fields';
+import type { AztecNode } from '@aztec/aztec.js/node';
+import { AccountManager } from '@aztec/aztec.js/wallet';
+import { type PXEConfig, type PXECreationOptions } from '@aztec/pxe/server';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation to be used in server settings (e.g. e2e tests).
+ * Note that the only difference from `lazy` and `bundle` test wallets is that it uses the `createPXE` function
+ * from the `pxe/server` package.
+ */
+export declare class TestWallet extends BaseTestWallet {
+    static create(node: AztecNode, overridePXEConfig?: Partial<PXEConfig>, options?: PXECreationOptions): Promise<TestWallet>;
+    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/account").BaseAccount;
+        instance: import("@aztec/aztec.js/contracts").ContractInstanceWithAddress;
+        artifact: import("@aztec/aztec.js/abi").ContractArtifact;
+    }>;
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/wallet/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,kBAAkB,EAA2B,MAAM,mBAAmB,CAAC;AAGrG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,cAAc;WAC/B,MAAM,CACjB,IAAI,EAAE,SAAS,EACf,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,GAAE,kBAAoC,GAC5C,OAAO,CAAC,UAAU,CAAC;IAStB,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;;;;;CAkBlD"}

package/dest/wallet/server.js

@@ -0,0 +1,67 @@
+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/contracts';
+import { Fr } from '@aztec/aztec.js/fields';
+import { createPXE, getPXEConfig } from '@aztec/pxe/server';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+import { BaseTestWallet } from './test_wallet.js';
+/**
+ * A TestWallet implementation to be used in server settings (e.g. e2e tests).
+ * Note that the only difference from `lazy` and `bundle` test wallets is that it uses the `createPXE` function
+ * from the `pxe/server` package.
+ */ export class TestWallet extends BaseTestWallet {
+    static async create(node, overridePXEConfig, options = {
+        loggers: {}
+    }) {
+        const pxeConfig = Object.assign(getPXEConfig(), {
+            proverEnabled: overridePXEConfig?.proverEnabled ?? false,
+            ...overridePXEConfig
+        });
+        const pxe = await createPXE(node, pxeConfig, options);
+        return new TestWallet(pxe, node);
+    }
+    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 chainInfo = await this.getChainInfo();
+        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, chainInfo);
+        const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {
+            salt: Fr.random()
+        });
+        return {
+            account: stubAccount,
+            instance,
+            artifact: StubAccountContractArtifact
+        };
+    }
+}

package/dest/wallet/test_wallet.d.ts

@@ -0,0 +1,143 @@
+import type { ContractArtifact } from '@aztec/aztec.js/abi';
+import { type Account, type AccountContract } from '@aztec/aztec.js/account';
+import { type CallIntent, type ContractFunctionInteractionCallIntent, type IntentInnerHash, SetPublicAuthwitContractInteraction } from '@aztec/aztec.js/authorization';
+import { BaseWallet, type SendOptions, type SimulateOptions } from '@aztec/aztec.js/wallet';
+import { AccountManager } from '@aztec/aztec.js/wallet';
+import { 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 { NotesFilter, UniqueNote } from '@aztec/stdlib/note';
+import type { TxSimulationResult } from '@aztec/stdlib/tx';
+import { ProvenTx } from '../utils.js';
+/**
+ * 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>;
+    /**
+     * Toggle for running "simulated simulations" when calling simulateTx.
+     *
+     * Terminology:
+     * - "simulation": run private circuits normally and then run the kernel in a simulated (brillig) mode on ACVM.
+     *   No kernel witnesses are generated, but protocol rules are checked.
+     * - "simulated simulation": skip running kernels in ACVM altogether and emulate their behavior in TypeScript
+     *   (akin to generateSimulatedProvingResult). We mutate public inputs like the kernels would and can swap in
+     *   fake/private bytecode or accounts for tests. This is much faster but is not usable in situations where we
+     *   need kernel witnesses.
+     *
+     * When this flag is true, simulateTx constructs a request using a fake account (and accepts contract overrides
+     * on the input) and the PXE emulates kernel effects without generating kernel witnesses. When false, simulateTx
+     * defers to the standard simulation path.
+     */
+    private simulatedSimulations;
+    /** Enable the "simulated simulation" path for simulateTx. */
+    enableSimulatedSimulations(): void;
+    /** Disable the "simulated simulation" path for simulateTx. */
+    disableSimulatedSimulations(): void;
+    setBaseFeePadding(value?: number): void;
+    protected getAccountFromAddress(address: AztecAddress): Promise<Account>;
+    getAccounts(): Promise<{
+        alias: string;
+        item: AztecAddress;
+    }[]>;
+    /**
+     * Creates a new account with the provided account data or generates random values and uses SchnorrAccountContract
+     * if not provided.
+     *
+     * @param accountData - Optional account configuration containing secret, salt and account contract.
+     * @returns A new AccountManager instance for the created 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>;
+    /**
+     * Lookup the validity of an authwit in private and public contexts.
+     *
+     * Uses the chain id and version of the wallet.
+     *
+     * @param wallet - The wallet use to simulate and read the public data
+     * @param onBehalfOf - The address of the "approver"
+     * @param intent - The consumer and inner hash or the caller and action to lookup
+     * @param witness - The computed authentication witness to check
+     * @returns - A struct containing the validity of the authwit in private and public contexts.
+     */
+    lookupValidity(onBehalfOf: AztecAddress, intent: IntentInnerHash | CallIntent | ContractFunctionInteractionCallIntent, witness: AuthWitness): Promise<{
+        /** boolean flag indicating if the authwit is valid in private context */
+        isValidInPrivate: boolean;
+        /** boolean flag indicating if the authwit is valid in public context */
+        isValidInPublic: boolean;
+    }>;
+    /**
+     * Returns an interaction that can be used to set the authorization status
+     * of an intent
+     * @param from - The address authorizing/revoking the action
+     * @param messageHashOrIntent - The action to authorize/revoke
+     * @param authorized - Whether the action can be performed or not
+     */
+    setPublicAuthWit(from: AztecAddress, messageHashOrIntent: Fr | Buffer | IntentInnerHash | CallIntent | ContractFunctionInteractionCallIntent, authorized: boolean): Promise<SetPublicAuthwitContractInteraction>;
+    /**
+     * Creates and returns an authwit according the the rules
+     * of the provided account. This authwit can be verified
+     * by the account contract
+     * @param from - The address authorizing the action
+     * @param messageHashOrIntent - The action to authorize
+     */
+    createAuthWit(from: AztecAddress, messageHashOrIntent: Fr | Buffer | IntentInnerHash | CallIntent | ContractFunctionInteractionCallIntent): Promise<AuthWitness>;
+    abstract getFakeAccountDataFor(address: AztecAddress): Promise<{
+        account: Account;
+        instance: ContractInstanceWithAddress;
+        artifact: ContractArtifact;
+    }>;
+    simulateTx(executionPayload: ExecutionPayload, opts: SimulateOptions): Promise<TxSimulationResult>;
+    /**
+     * A utility to prove a transaction using this wallet and return it to be sent by a different entity on their own accord
+     *
+     * Note that this should not be used in production code since a proven transaction could be sent to a malicious
+     * node to index and track. It also makes it very difficult for the wallet to keep track of the interaction.
+     * @param exec - The execution payload to prove.
+     * @param opts - The options to configure the interaction
+     * @returns - A proven tx ready to be sent to the network
+     */
+    proveTx(exec: ExecutionPayload, opts: SendOptions): Promise<ProvenTx>;
+    /**
+     * A debugging utility to get notes based on the provided filter.
+     *
+     * Note that this should not be used in production code because the structure of notes is considered to be
+     * an implementation detail of contracts. This is only meant to be used for debugging purposes. If you need to obtain
+     * note-related information in production code, please implement a custom utility function on your contract and call
+     * that function instead (e.g. `get_balance(owner: AztecAddress) -> u128` utility function on a Token contract).
+     *
+     * @param filter - The filter to apply to the notes.
+     * @returns The requested notes.
+     */
+    getNotes(filter: NotesFilter): Promise<UniqueNote[]>;
+    /**
+     * Stops the internal job queue.
+     *
+     * This function is typically used when tearing down tests.
+     */
+    stop(): Promise<void>;
+}
+//# 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":"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"}