@aztec/end-to-end 0.0.1-commit.ee80a48 → 0.0.1-commit.f103f88

package/dest/test-wallet/test_wallet.js

@@ -0,0 +1,249 @@
+import { EcdsaKAccountContract, EcdsaRAccountContract } from '@aztec/accounts/ecdsa';
+import { SchnorrAccountContract } from '@aztec/accounts/schnorr';
+import { StubEcdsaAccountContractArtifact, createStubEcdsaAccount } from '@aztec/accounts/stub/ecdsa';
+import { StubSchnorrAccountContractArtifact, createStubSchnorrAccount } from '@aztec/accounts/stub/schnorr';
+import { NO_FROM } from '@aztec/aztec.js/account';
+import { SetPublicAuthwitContractInteraction, computeInnerAuthWitHashFromAction, isContractFunctionInteractionCallIntent, lookupValidity } from '@aztec/aztec.js/authorization';
+import { AccountManager } from '@aztec/aztec.js/wallet';
+import { TxSimulationResultWithAppOffset } from '@aztec/aztec.js/wallet';
+import { DefaultEntrypoint } from '@aztec/entrypoints/default';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { GrumpkinScalar } from '@aztec/foundation/curves/grumpkin';
+import { getPXEConfig } from '@aztec/pxe/config';
+import { createPXE } from '@aztec/pxe/server';
+import { getContractInstanceFromInstantiationParams } from '@aztec/stdlib/contract';
+import { deriveSigningKey } from '@aztec/stdlib/keys';
+import { SimulationOverrides } from '@aztec/stdlib/tx';
+import { mergeExecutionPayloads } from '@aztec/stdlib/tx';
+import { BaseWallet } from '@aztec/wallet-sdk/base-wallet';
+import { AztecNodeProxy, ProvenTx } from './utils.js';
+/**
+ * Wallet implementation that stores accounts in memory and provides extra debugging
+ * utilities
+ * It is intended to be used in e2e tests.
+ */ export class TestWallet extends BaseWallet {
+    nodeRef;
+    constructor(pxe, nodeRef){
+        super(pxe, nodeRef), this.nodeRef = nodeRef, this.accounts = new Map(), this.simulationMode = 'kernelless';
+    }
+    static async create(node, overridePXEConfig, options = {
+        loggers: {}
+    }) {
+        const nodeRef = new AztecNodeProxy(node);
+        const pxeConfig = Object.assign(getPXEConfig(), {
+            proverEnabled: overridePXEConfig?.proverEnabled ?? false,
+            ...overridePXEConfig
+        });
+        const pxe = await createPXE(nodeRef, pxeConfig, options);
+        return new TestWallet(pxe, nodeRef);
+    }
+    /**
+   * Updates the underlying node that this wallet and its PXE communicate with.
+   * @param node - The new AztecNode to forward all calls to.
+   */ updateNode(node) {
+        this.nodeRef.updateTargetNode(node);
+    }
+    createSchnorrAccount(secret, salt, signingKey) {
+        signingKey = signingKey ?? deriveSigningKey(secret);
+        return this.createAccount({
+            secret,
+            salt,
+            type: 'schnorr',
+            contract: new SchnorrAccountContract(signingKey)
+        });
+    }
+    createECDSARAccount(secret, salt, signingKey) {
+        return this.createAccount({
+            secret,
+            salt,
+            type: 'ecdsasecp256r1',
+            contract: new EcdsaRAccountContract(signingKey)
+        });
+    }
+    createECDSAKAccount(secret, salt, signingKey) {
+        return this.createAccount({
+            secret,
+            salt,
+            type: 'ecdsasecp256k1',
+            contract: new EcdsaKAccountContract(signingKey)
+        });
+    }
+    /**
+   * Builds contract overrides for all provided addresses by replacing their account contracts with stub implementations.
+   */ async buildAccountOverrides(addresses) {
+        const accounts = await this.getAccounts();
+        const contracts = {};
+        const filtered = accounts.filter((acc)=>addresses.some((addr)=>addr.equals(acc.item)));
+        for (const account of filtered){
+            const address = account.item;
+            const originalAccount = await this.getAccountFromAddress(address);
+            const completeAddress = originalAccount.getCompleteAddress();
+            const contractInstance = await this.pxe.getContractInstance(completeAddress.address);
+            if (!contractInstance) {
+                throw new Error(`No contract instance found for address: ${completeAddress.address} during account override building. This is a bug!`);
+            }
+            const stubArtifact = this.getStubArtifactFor(address);
+            const stubConstructorArgs = this.getTypeFor(address) === 'schnorr' ? [
+                Fr.ZERO,
+                Fr.ZERO
+            ] : [
+                Buffer.alloc(32),
+                Buffer.alloc(32)
+            ];
+            const stubInstance = await getContractInstanceFromInstantiationParams(stubArtifact, {
+                salt: Fr.random(),
+                constructorArgs: stubConstructorArgs
+            });
+            contracts[address.toString()] = {
+                instance: stubInstance,
+                artifact: stubArtifact
+            };
+        }
+        return contracts;
+    }
+    accounts;
+    getTypeFor(address) {
+        return this.accounts.get(address.toString())?.type ?? 'schnorr';
+    }
+    getStubArtifactFor(address) {
+        return this.getTypeFor(address) === 'schnorr' ? StubSchnorrAccountContractArtifact : StubEcdsaAccountContractArtifact;
+    }
+    getStubAccountFor(address, completeAddress) {
+        return this.getTypeFor(address) === 'schnorr' ? createStubSchnorrAccount(completeAddress) : createStubEcdsaAccount(completeAddress);
+    }
+    /**
+   * Controls how the test wallet simulates transactions:
+   * - `kernelless`: Skips kernel circuits but uses the real account contract. Default.
+   * - `kernelless-override`: Skips kernels and replaces the account with a stub that doesn't do authwit validation.
+   * - `full`: Uses real kernel circuits and real account contracts. Slow!
+   */ simulationMode;
+    setSimulationMode(mode) {
+        this.simulationMode = mode;
+    }
+    setMinFeePadding(value) {
+        this.minFeePadding = value ?? 0.5;
+    }
+    getAccountFromAddress(address) {
+        const entry = this.accounts.get(address?.toString() ?? '');
+        if (!entry) {
+            throw new Error(`Account not found in wallet for address: ${address}`);
+        }
+        return Promise.resolve(entry.account);
+    }
+    getAccounts() {
+        return Promise.resolve(Array.from(this.accounts.values()).map((entry)=>({
+                alias: '',
+                item: entry.account.getAddress()
+            })));
+    }
+    async createAccount(accountData) {
+        const secret = accountData?.secret ?? Fr.random();
+        const salt = accountData?.salt ?? Fr.random();
+        const type = accountData?.type ?? 'schnorr';
+        const contract = accountData?.contract ?? new SchnorrAccountContract(GrumpkinScalar.random());
+        const accountManager = await AccountManager.create(this, secret, contract, salt);
+        const instance = accountManager.getInstance();
+        const artifact = await contract.getContractArtifact();
+        await this.registerContract(instance, artifact, secret);
+        const address = accountManager.address.toString();
+        this.accounts.set(address, {
+            account: await accountManager.getAccount(),
+            type
+        });
+        return accountManager;
+    }
+    lookupValidity(onBehalfOf, intent, witness) {
+        return lookupValidity(this, onBehalfOf, intent, witness);
+    }
+    setPublicAuthWit(from, messageHashOrIntent, authorized) {
+        return SetPublicAuthwitContractInteraction.create(this, from, messageHashOrIntent, authorized);
+    }
+    async createAuthWit(from, intent) {
+        const account = await this.getAccountFromAddress(from);
+        const chainInfo = await this.getChainInfo();
+        let intentInnerHash;
+        if ('caller' in intent) {
+            const call = isContractFunctionInteractionCallIntent(intent) ? await intent.action.getFunctionCall() : intent.call;
+            const innerHash = await computeInnerAuthWitHashFromAction(intent.caller, call);
+            intentInnerHash = {
+                innerHash,
+                consumer: call.to
+            };
+        } else {
+            intentInnerHash = intent;
+        }
+        return account.createAuthWit(intentInnerHash, chainInfo);
+    }
+    async simulateViaEntrypoint(executionPayload, opts) {
+        const { from, feeOptions, additionalScopes, skipTxValidation, skipFeeEnforcement } = opts;
+        const scopes = this.scopesFrom(from, additionalScopes);
+        const skipKernels = this.simulationMode !== 'full';
+        const useOverride = this.simulationMode === 'kernelless-override';
+        const feeExecutionPayload = await feeOptions.walletFeePaymentMethod?.getExecutionPayload();
+        const finalExecutionPayload = feeExecutionPayload ? mergeExecutionPayloads([
+            feeExecutionPayload,
+            executionPayload
+        ]) : executionPayload;
+        const chainInfo = await this.getChainInfo();
+        let overrides;
+        let txRequest;
+        if (useOverride) {
+            const accountOverrides = await this.buildAccountOverrides(scopes);
+            overrides = new SimulationOverrides(accountOverrides);
+        }
+        if (from === NO_FROM) {
+            const entrypoint = new DefaultEntrypoint();
+            txRequest = await entrypoint.createTxExecutionRequest(finalExecutionPayload, feeOptions.gasSettings, chainInfo);
+        } else {
+            let fromAccount;
+            if (useOverride) {
+                const originalAccount = await this.getAccountFromAddress(from);
+                fromAccount = this.getStubAccountFor(from, originalAccount.getCompleteAddress());
+            } else {
+                fromAccount = await this.getAccountFromAddress(from);
+            }
+            const executionOptions = {
+                txNonce: Fr.random(),
+                cancellable: this.cancellableTransactions,
+                // If from is an address, feeOptions include the way the account contract should handle the fee payment
+                feePaymentMethodOptions: feeOptions.accountFeePaymentMethodOptions
+            };
+            txRequest = await fromAccount.createTxExecutionRequest(finalExecutionPayload, feeOptions.gasSettings, chainInfo, executionOptions);
+        }
+        const result = await this.pxe.simulateTx(txRequest, {
+            simulatePublic: true,
+            skipKernels,
+            skipFeeEnforcement,
+            skipTxValidation,
+            overrides,
+            scopes
+        });
+        const appCallOffset = await this.computeAppCallOffset(from, feeOptions);
+        return TxSimulationResultWithAppOffset.fromResultAndOffset(result, appCallOffset);
+    }
+    async proveTx(exec, opts) {
+        const fee = await this.completeFeeOptions({
+            from: opts.from,
+            feePayer: exec.feePayer,
+            gasSettings: opts.fee?.gasSettings
+        });
+        const txRequest = await this.createTxExecutionRequestFromPayloadAndFee(exec, opts.from, fee);
+        const txProvingResult = await this.pxe.proveTx(txRequest, this.scopesFrom(opts.from, opts.additionalScopes));
+        return new ProvenTx(this.aztecNode, await txProvingResult.toTx(), txProvingResult.getOffchainEffects(), txProvingResult.stats);
+    }
+    getTxReceipt(txHash) {
+        return this.aztecNode.getTxReceipt(txHash);
+    }
+    getNotes(filter) {
+        return this.pxe.debug.getNotes(filter);
+    }
+    getSyncedBlockHeader() {
+        return this.pxe.getSyncedBlockHeader();
+    }
+    sync() {
+        return this.pxe.debug.sync();
+    }
+    stop() {
+        return this.pxe.stop();
+    }
+}

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

@@ -0,0 +1,41 @@
+import { ContractFunctionInteraction, DeployMethod, type DeployOptions, type NoWait, type SendInteractionOptions, type WaitOpts } from '@aztec/aztec.js/contracts';
+import { type AztecNode } from '@aztec/aztec.js/node';
+import { type OffchainEffect, type ProvingStats, Tx, TxHash, type TxReceipt } from '@aztec/stdlib/tx';
+import type { TestWallet } from './test_wallet.js';
+export type ProvenTxSendOpts = {
+    wait?: NoWait | WaitOpts;
+};
+export type ProvenTxSendReturn<T extends NoWait | WaitOpts | undefined> = T extends NoWait ? TxHash : TxReceipt;
+export declare class ProvenTx extends Tx {
+    private node;
+    offchainEffects: OffchainEffect[];
+    stats?: ProvingStats | undefined;
+    constructor(node: AztecNode, tx: Tx, offchainEffects: OffchainEffect[], stats?: ProvingStats | undefined);
+    send(options?: Omit<ProvenTxSendOpts, 'wait'>): Promise<TxReceipt>;
+    send<W extends ProvenTxSendOpts['wait']>(options: ProvenTxSendOpts & {
+        wait: W;
+    }): Promise<ProvenTxSendReturn<W>>;
+    private contextualizeError;
+}
+export declare function proveInteraction(wallet: TestWallet, interaction: ContractFunctionInteraction | DeployMethod, options: SendInteractionOptions | DeployOptions): Promise<ProvenTx>;
+/**
+ * Extends AztecNode via declaration merging so instances can be used wherever AztecNode is expected.
+ * The actual method forwarding is handled by a Proxy in the class constructor.
+ */
+export interface AztecNodeProxy extends AztecNode {
+}
+/**
+ * Mutable wrapper around an AztecNode that forwards all calls to the current target.
+ * Allows swapping the underlying node at runtime via updateTargetNode, which is useful
+ * for tests that need to redirect a wallet from one node to another without recreating it.
+ */
+export declare class AztecNodeProxy {
+    private target;
+    constructor(target: AztecNode);
+    /**
+     * Updates the underlying node that this reference points to.
+     * @param node - The new node to forward calls to.
+     */
+    updateTargetNode(node: AztecNode): void;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0LXdhbGxldC91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQ0wsMkJBQTJCLEVBQzNCLFlBQVksRUFDWixLQUFLLGFBQWEsRUFFbEIsS0FBSyxNQUFNLEVBQ1gsS0FBSyxzQkFBc0IsRUFDM0IsS0FBSyxRQUFRLEVBRWQsTUFBTSwyQkFBMkIsQ0FBQztBQUNuQyxPQUFPLEVBQUUsS0FBSyxTQUFTLEVBQWEsTUFBTSxzQkFBc0IsQ0FBQztBQUVqRSxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQUUsS0FBSyxZQUFZLEVBQUUsRUFBRSxFQUFFLE1BQU0sRUFBRSxLQUFLLFNBQVMsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBSXRHLE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRW5ELE1BQU0sTUFBTSxnQkFBZ0IsR0FBRztJQUM3QixJQUFJLENBQUMsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQUFDO0NBQzFCLENBQUM7QUFFRixNQUFNLE1BQU0sa0JBQWtCLENBQUMsQ0FBQyxTQUFTLE1BQU0sR0FBRyxRQUFRLEdBQUcsU0FBUyxJQUFJLENBQUMsU0FBUyxNQUFNLEdBQUcsTUFBTSxHQUFHLFNBQVMsQ0FBQztBQUVoSCxxQkFBYSxRQUFTLFNBQVEsRUFBRTtJQUU1QixPQUFPLENBQUMsSUFBSTtJQUVMLGVBQWUsRUFBRSxjQUFjLEVBQUU7SUFDakMsS0FBSyxDQUFDO0lBSmYsWUFDVSxJQUFJLEVBQUUsU0FBUyxFQUN2QixFQUFFLEVBQUUsRUFBRSxFQUNDLGVBQWUsRUFBRSxjQUFjLEVBQUUsRUFDakMsS0FBSyxDQUFDLDBCQUFjLEVBRzVCO0lBRUQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxFQUFFLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxNQUFNLENBQUMsR0FBRyxPQUFPLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDbkUsSUFBSSxDQUFDLENBQUMsU0FBUyxnQkFBZ0IsQ0FBQyxNQUFNLENBQUMsRUFBRSxPQUFPLEVBQUUsZ0JBQWdCLEdBQUc7UUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFBO0tBQUUsR0FBRyxPQUFPLENBQUMsa0JBQWtCLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQWVsSCxPQUFPLENBQUMsa0JBQWtCO0NBVTNCO0FBRUQsd0JBQXNCLGdCQUFnQixDQUNwQyxNQUFNLEVBQUUsVUFBVSxFQUNsQixXQUFXLEVBQUUsMkJBQTJCLEdBQUcsWUFBWSxFQUN2RCxPQUFPLEVBQUUsc0JBQXNCLEdBQUcsYUFBYSxxQkFTaEQ7QUFFRDs7O0dBR0c7QUFFSCxNQUFNLFdBQVcsY0FBZSxTQUFRLFNBQVM7Q0FBRztBQUVwRDs7OztHQUlHO0FBRUgscUJBQWEsY0FBYztJQUNiLE9BQU8sQ0FBQyxNQUFNO0lBQTFCLFlBQW9CLE1BQU0sRUFBRSxTQUFTLEVBWXBDO0lBRUQ7OztPQUdHO0lBQ0gsZ0JBQWdCLENBQUMsSUFBSSxFQUFFLFNBQVMsR0FBRyxJQUFJLENBRXRDO0NBQ0YifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/test-wallet/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,YAAY,EACZ,KAAK,aAAa,EAElB,KAAK,MAAM,EACX,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EAEd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAItG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,QAAQ,GAAG,SAAS,IAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhH,qBAAa,QAAS,SAAQ,EAAE;IAE5B,OAAO,CAAC,IAAI;IAEL,eAAe,EAAE,cAAc,EAAE;IACjC,KAAK,CAAC;IAJf,YACU,IAAI,EAAE,SAAS,EACvB,EAAE,EAAE,EAAE,EACC,eAAe,EAAE,cAAc,EAAE,EACjC,KAAK,CAAC,0BAAc,EAG5B;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAelH,OAAO,CAAC,kBAAkB;CAU3B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,2BAA2B,GAAG,YAAY,EACvD,OAAO,EAAE,sBAAsB,GAAG,aAAa,qBAShD;AAED;;;GAGG;AAEH,MAAM,WAAW,cAAe,SAAQ,SAAS;CAAG;AAEpD;;;;GAIG;AAEH,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;IAA1B,YAAoB,MAAM,EAAE,SAAS,EAYpC;IAED;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAEtC;CACF"}

package/dest/test-wallet/utils.js

@@ -0,0 +1,71 @@
+import { DeployMethod, NO_WAIT, toSendOptions } from '@aztec/aztec.js/contracts';
+import { waitForTx } from '@aztec/aztec.js/node';
+import { SimulationError } from '@aztec/stdlib/errors';
+import { Tx } from '@aztec/stdlib/tx';
+import { inspect } from 'util';
+export class ProvenTx extends Tx {
+    node;
+    offchainEffects;
+    stats;
+    constructor(node, tx, offchainEffects, stats){
+        super(tx.getTxHash(), tx.data, tx.chonkProof, tx.contractClassLogFields, tx.publicFunctionCalldata), this.node = node, this.offchainEffects = offchainEffects, this.stats = stats;
+    }
+    async send(options) {
+        const txHash = this.getTxHash();
+        await this.node.sendTx(this).catch((err)=>{
+            throw this.contextualizeError(err, inspect(this));
+        });
+        if (options?.wait === NO_WAIT) {
+            return txHash;
+        }
+        const waitOpts = typeof options?.wait === 'object' ? options.wait : undefined;
+        return await waitForTx(this.node, txHash, waitOpts);
+    }
+    contextualizeError(err, ...context) {
+        let contextStr = '';
+        if (context.length > 0) {
+            contextStr = `\nContext:\n${context.join('\n')}`;
+        }
+        if (err instanceof SimulationError) {
+            err.setAztecContext(contextStr);
+        }
+        return err;
+    }
+}
+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, toSendOptions(options));
+}
+/**
+ * Mutable wrapper around an AztecNode that forwards all calls to the current target.
+ * Allows swapping the underlying node at runtime via updateTargetNode, which is useful
+ * for tests that need to redirect a wallet from one node to another without recreating it.
+ */ // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+export class AztecNodeProxy {
+    target;
+    constructor(target){
+        this.target = target;
+        return new Proxy(this, {
+            get: (obj, prop, receiver)=>{
+                // Own properties and methods (updateTargetNode, target) are served directly.
+                if (Reflect.has(obj, prop)) {
+                    return Reflect.get(obj, prop, receiver);
+                }
+                // Everything else is forwarded to the current target node.
+                const val = obj.target[prop];
+                return typeof val === 'function' ? val.bind(obj.target) : val;
+            }
+        });
+    }
+    /**
+   * Updates the underlying node that this reference points to.
+   * @param node - The new node to forward calls to.
+   */ updateTargetNode(node) {
+        this.target = node;
+    }
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2FsbGV0X3dvcmtlcl9zY3JpcHQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0LXdhbGxldC93YWxsZXRfd29ya2VyX3NjcmlwdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet_worker_script.d.ts","sourceRoot":"","sources":["../../src/test-wallet/wallet_worker_script.ts"],"names":[],"mappings":""}

package/dest/test-wallet/wallet_worker_script.js

@@ -0,0 +1,48 @@
+import { createAztecNodeClient } from '@aztec/aztec.js/node';
+import { jsonStringify } from '@aztec/foundation/json-rpc';
+import { createLogger } from '@aztec/foundation/log';
+import { parseWithOptionals, schemaHasMethod } from '@aztec/foundation/schemas';
+import { NodeListener, TransportServer } from '@aztec/foundation/transport';
+import { Tx } from '@aztec/stdlib/tx';
+import { workerData } from 'worker_threads';
+import { TestWallet } from './test_wallet.js';
+import { WorkerWalletSchema } from './worker_wallet_schema.js';
+const logger = createLogger('e2e:test-wallet:worker');
+try {
+    const { nodeUrl, pxeConfig } = workerData;
+    logger.info('Initializing worker wallet', {
+        nodeUrl
+    });
+    const node = createAztecNodeClient(nodeUrl);
+    const wallet = await TestWallet.create(node, pxeConfig);
+    logger.info('Worker wallet initialized');
+    const customMethods = {
+        proveTx: async (exec, opts)=>{
+            const provenTx = await wallet.proveTx(exec, opts);
+            return new Tx(provenTx.getTxHash(), provenTx.data, provenTx.chonkProof, provenTx.contractClassLogFields, provenTx.publicFunctionCalldata);
+        },
+        registerAccount: async (secret, salt)=>{
+            const manager = await wallet.createSchnorrAccount(secret, salt);
+            return manager.address;
+        }
+    };
+    const schema = WorkerWalletSchema;
+    const listener = new NodeListener();
+    const server = new TransportServer(listener, async (msg)=>{
+        if (!schemaHasMethod(schema, msg.fn)) {
+            throw new Error(`Unknown method: ${msg.fn}`);
+        }
+        const jsonParams = JSON.parse(msg.args);
+        const args = await parseWithOptionals(jsonParams, schema[msg.fn].parameters());
+        // we have to erase the fn type in order to be able to spread ...args
+        const handler = msg.fn in customMethods ? customMethods[msg.fn] : undefined;
+        const result = handler ? await handler(...args) : await wallet[msg.fn](...args);
+        return jsonStringify(result);
+    });
+    server.start();
+} catch (err) {
+    logger.error('Worker wallet initialization failed', {
+        error: err instanceof Error ? err.stack : String(err)
+    });
+    process.exit(1);
+}

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

@@ -0,0 +1,52 @@
+import type { CallIntent, IntentInnerHash } from '@aztec/aztec.js/authorization';
+import type { InteractionWaitOptions, SendReturn } from '@aztec/aztec.js/contracts';
+import type { Aliased, AppCapabilities, BatchResults, BatchedMethod, ContractClassMetadata, ContractMetadata, ExecuteUtilityOptions, PrivateEvent, PrivateEventFilter, ProfileOptions, SendOptions, SimulateOptions, TxSimulationResultWithAppOffset, Wallet, WalletCapabilities } from '@aztec/aztec.js/wallet';
+import type { ChainInfo } from '@aztec/entrypoints/interfaces';
+import type { Fr } from '@aztec/foundation/curves/bn254';
+import type { PXEConfig } from '@aztec/pxe/config';
+import type { ContractArtifact, EventMetadataDefinition, FunctionCall } from '@aztec/stdlib/abi';
+import type { AuthWitness } from '@aztec/stdlib/auth-witness';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { ContractInstanceWithAddress } from '@aztec/stdlib/contract';
+import type { ExecutionPayload, TxProfileResult, UtilityExecutionResult } from '@aztec/stdlib/tx';
+import { Tx } from '@aztec/stdlib/tx';
+/**
+ * Wallet implementation that offloads all work to a worker thread.
+ * Implements the Wallet interface by proxying calls over a transport layer
+ * using JSON serialization with Zod schema parsing on both ends.
+ */
+export declare class WorkerWallet implements Wallet {
+    private worker;
+    private client;
+    private constructor();
+    /**
+     * Creates a WorkerWallet by spawning a worker thread that creates a TestWallet internally.
+     * @param nodeUrl - URL of the Aztec node to connect to.
+     * @param pxeConfig - Optional PXE configuration overrides.
+     * @returns A WorkerWallet ready to use.
+     */
+    static create(nodeUrl: string, pxeConfig?: Partial<PXEConfig>): Promise<WorkerWallet>;
+    private callRaw;
+    private call;
+    getChainInfo(): Promise<ChainInfo>;
+    getContractMetadata(address: AztecAddress): Promise<ContractMetadata>;
+    getContractClassMetadata(id: Fr): Promise<ContractClassMetadata>;
+    getPrivateEvents<T>(eventMetadata: EventMetadataDefinition, eventFilter: PrivateEventFilter): Promise<PrivateEvent<T>[]>;
+    registerSender(address: AztecAddress, alias?: string): Promise<AztecAddress>;
+    getAddressBook(): Promise<Aliased<AztecAddress>[]>;
+    getAccounts(): Promise<Aliased<AztecAddress>[]>;
+    registerContract(instance: ContractInstanceWithAddress, artifact?: ContractArtifact, secretKey?: Fr): Promise<ContractInstanceWithAddress>;
+    simulateTx(exec: ExecutionPayload, opts: SimulateOptions): Promise<TxSimulationResultWithAppOffset>;
+    executeUtility(call: FunctionCall, opts: ExecuteUtilityOptions): Promise<UtilityExecutionResult>;
+    profileTx(exec: ExecutionPayload, opts: ProfileOptions): Promise<TxProfileResult>;
+    sendTx<W extends InteractionWaitOptions = undefined>(exec: ExecutionPayload, opts: SendOptions<W>): Promise<SendReturn<W>>;
+    proveTx(exec: ExecutionPayload, opts: Omit<SendOptions, 'wait'>): Promise<Tx>;
+    /** Registers an account inside the worker's TestWallet, populating its accounts map. */
+    registerAccount(secret: Fr, salt: Fr): Promise<AztecAddress>;
+    createAuthWit(from: AztecAddress, messageHashOrIntent: IntentInnerHash | CallIntent): Promise<AuthWitness>;
+    requestCapabilities(manifest: AppCapabilities): Promise<WalletCapabilities>;
+    batch<const T extends readonly BatchedMethod[]>(methods: T): Promise<BatchResults<T>>;
+    /** Shuts down the worker thread and closes the transport. */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ya2VyX3dhbGxldC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rlc3Qtd2FsbGV0L3dvcmtlcl93YWxsZXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLGVBQWUsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQ2pGLE9BQU8sS0FBSyxFQUFFLHNCQUFzQixFQUFFLFVBQVUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ3BGLE9BQU8sS0FBSyxFQUNWLE9BQU8sRUFDUCxlQUFlLEVBQ2YsWUFBWSxFQUNaLGFBQWEsRUFDYixxQkFBcUIsRUFDckIsZ0JBQWdCLEVBQ2hCLHFCQUFxQixFQUNyQixZQUFZLEVBQ1osa0JBQWtCLEVBQ2xCLGNBQWMsRUFDZCxXQUFXLEVBQ1gsZUFBZSxFQUNmLCtCQUErQixFQUMvQixNQUFNLEVBQ04sa0JBQWtCLEVBQ25CLE1BQU0sd0JBQXdCLENBQUM7QUFDaEMsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDL0QsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFPekQsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDbkQsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsdUJBQXVCLEVBQUUsWUFBWSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDakcsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDOUQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDaEUsT0FBTyxLQUFLLEVBQUUsMkJBQTJCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUMxRSxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxlQUFlLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUNsRyxPQUFP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

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker_wallet.d.ts","sourceRoot":"","sources":["../../src/test-wallet/worker_wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,eAAe,EACf,+BAA+B,EAC/B,MAAM,EACN,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAOzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAYtC;;;;GAIG;AACH,qBAAa,YAAa,YAAW,MAAM;IAEvC,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAFhB,OAAO,eAGH;IAEJ;;;;;OAKG;IACH,OAAa,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAsD1F;YAEa,OAAO;YAKP,IAAI;IAMlB,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAEjC;IAED,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEpE;IAED,wBAAwB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAE/D;IAED,gBAAgB,CAAC,CAAC,EAChB,aAAa,EAAE,uBAAuB,EACtC,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAE5B;IAED,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAE3E;IAED,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAEjD;IAED,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAE9C;IAED,gBAAgB,CACd,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,SAAS,CAAC,EAAE,EAAE,GACb,OAAO,CAAC,2BAA2B,CAAC,CAEtC;IAED,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAElG;IAED,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAE/F;IAED,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAEhF;IAED,MAAM,CAAC,CAAC,SAAS,sBAAsB,GAAG,SAAS,EACjD,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAExB;IAED,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAE5E;IAED,wFAAwF;IACxF,eAAe,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAE3D;IAED,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAEzG;IAED,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE1E;IAED,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAEpF;IAED,6DAA6D;IACvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1B;CACF"}

package/dest/test-wallet/worker_wallet.js

@@ -0,0 +1,151 @@
+import { jsonStringify } from '@aztec/foundation/json-rpc';
+import { createLogger } from '@aztec/foundation/log';
+import { promiseWithResolvers } from '@aztec/foundation/promise';
+import { sleep } from '@aztec/foundation/sleep';
+import { NodeConnector, TransportClient } from '@aztec/foundation/transport';
+import { Worker } from 'worker_threads';
+import { WorkerWalletSchema } from './worker_wallet_schema.js';
+const log = createLogger('e2e:test-wallet:worker-wallet');
+const WORKER_READY_TIMEOUT_MS = 120_000;
+/**
+ * Wallet implementation that offloads all work to a worker thread.
+ * Implements the Wallet interface by proxying calls over a transport layer
+ * using JSON serialization with Zod schema parsing on both ends.
+ */ export class WorkerWallet {
+    worker;
+    client;
+    constructor(worker, client){
+        this.worker = worker;
+        this.client = client;
+    }
+    /**
+   * Creates a WorkerWallet by spawning a worker thread that creates a TestWallet internally.
+   * @param nodeUrl - URL of the Aztec node to connect to.
+   * @param pxeConfig - Optional PXE configuration overrides.
+   * @returns A WorkerWallet ready to use.
+   */ static async create(nodeUrl, pxeConfig) {
+        // replace stc/ with dest/ so the wallet works in Jest tests
+        const workerUrl = new URL('./wallet_worker_script.js', import.meta.url);
+        workerUrl.pathname = workerUrl.pathname.replace('/src/', '/dest/');
+        // remove JEST_WORKER_ID so the worker uses pino-pretty transport instead of Jest's raw output.
+        const { JEST_WORKER_ID: _, ...parentEnv } = process.env;
+        const worker = new Worker(workerUrl, {
+            workerData: {
+                nodeUrl,
+                pxeConfig
+            },
+            env: {
+                ...parentEnv,
+                ...process.stderr.isTTY || process.env.FORCE_COLOR ? {
+                    FORCE_COLOR: '1'
+                } : {},
+                LOG_LEVEL: process.env.WORKER_LOG_LEVEL ?? 'warn'
+            }
+        });
+        const connector = new NodeConnector(worker);
+        const client = new TransportClient(connector);
+        await client.open();
+        const wallet = new WorkerWallet(worker, client);
+        const { promise: workerDied, reject: rejectWorkerDied } = promiseWithResolvers();
+        // reject if the worker exits or errors before the warmup completes.
+        const onError = (err)=>{
+            worker.off('exit', onExit);
+            rejectWorkerDied(new Error(`Worker wallet thread error: ${err.message}`));
+        };
+        const onExit = (code)=>{
+            worker.off('error', onError);
+            rejectWorkerDied(new Error(`Worker wallet thread exited with code ${code} before becoming ready`));
+        };
+        worker.once('error', onError);
+        worker.once('exit', onExit);
+        const timeout = sleep(WORKER_READY_TIMEOUT_MS).then(()=>{
+            throw new Error(`Worker wallet creation timed out after ${WORKER_READY_TIMEOUT_MS / 1000}s`);
+        });
+        try {
+            // wait for worker wallet to start
+            await Promise.race([
+                wallet.getChainInfo(),
+                workerDied,
+                timeout
+            ]);
+        } catch (err) {
+            log.error('Worker wallet creation failed, cleaning up', {
+                error: String(err)
+            });
+            client.close();
+            await worker.terminate();
+            throw err;
+        } finally{
+            worker.off('error', onError);
+            worker.off('exit', onExit);
+        }
+        return wallet;
+    }
+    async callRaw(fn, ...args) {
+        const argsJson = jsonStringify(args);
+        return await this.client.request({
+            fn,
+            args: argsJson
+        });
+    }
+    async call(fn, ...args) {
+        const resultJson = await this.callRaw(fn, ...args);
+        const methodSchema = WorkerWalletSchema[fn];
+        return methodSchema.returnType().parseAsync(JSON.parse(resultJson));
+    }
+    getChainInfo() {
+        return this.call('getChainInfo');
+    }
+    getContractMetadata(address) {
+        return this.call('getContractMetadata', address);
+    }
+    getContractClassMetadata(id) {
+        return this.call('getContractClassMetadata', id);
+    }
+    getPrivateEvents(eventMetadata, eventFilter) {
+        return this.call('getPrivateEvents', eventMetadata, eventFilter);
+    }
+    registerSender(address, alias) {
+        return this.call('registerSender', address, alias);
+    }
+    getAddressBook() {
+        return this.call('getAddressBook');
+    }
+    getAccounts() {
+        return this.call('getAccounts');
+    }
+    registerContract(instance, artifact, secretKey) {
+        return this.call('registerContract', instance, artifact, secretKey);
+    }
+    simulateTx(exec, opts) {
+        return this.call('simulateTx', exec, opts);
+    }
+    executeUtility(call, opts) {
+        return this.call('executeUtility', call, opts);
+    }
+    profileTx(exec, opts) {
+        return this.call('profileTx', exec, opts);
+    }
+    sendTx(exec, opts) {
+        return this.call('sendTx', exec, opts);
+    }
+    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);
+    }
+    createAuthWit(from, messageHashOrIntent) {
+        return this.call('createAuthWit', from, messageHashOrIntent);
+    }
+    requestCapabilities(manifest) {
+        return this.call('requestCapabilities', manifest);
+    }
+    batch(methods) {
+        return this.call('batch', methods);
+    }
+    /** Shuts down the worker thread and closes the transport. */ async stop() {
+        this.client.close();
+        await this.worker.terminate();
+    }
+}