@aztec/wallet-sdk 0.0.1-commit.001888fc

package/dest/base-wallet/base_wallet.js

@@ -0,0 +1,357 @@
+import { NO_WAIT, extractOffchainOutput } from '@aztec/aztec.js/contracts';
+import { waitForTx } from '@aztec/aztec.js/node';
+import { GAS_ESTIMATION_DA_GAS_LIMIT, GAS_ESTIMATION_L2_GAS_LIMIT, GAS_ESTIMATION_TEARDOWN_DA_GAS_LIMIT, GAS_ESTIMATION_TEARDOWN_L2_GAS_LIMIT } from '@aztec/constants';
+import { AccountFeePaymentMethodOptions } from '@aztec/entrypoints/account';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { createLogger } from '@aztec/foundation/log';
+import { displayDebugLogs } from '@aztec/pxe/client/lazy';
+import { decodeFromAbi } from '@aztec/stdlib/abi';
+import { AztecAddress } from '@aztec/stdlib/aztec-address';
+import { computePartialAddress, getContractClassFromArtifact } from '@aztec/stdlib/contract';
+import { SimulationError } from '@aztec/stdlib/errors';
+import { Gas, GasSettings } from '@aztec/stdlib/gas';
+import { siloNullifier } from '@aztec/stdlib/hash';
+import { mergeExecutionPayloads } from '@aztec/stdlib/tx';
+import { inspect } from 'util';
+import { buildMergedSimulationResult, extractOptimizablePublicStaticCalls, simulateViaNode } from './utils.js';
+/**
+ * A base class for Wallet implementations
+ */ export class BaseWallet {
+    pxe;
+    aztecNode;
+    log;
+    minFeePadding;
+    cancellableTransactions;
+    // Protected because we want to force wallets to instantiate their own PXE.
+    constructor(pxe, aztecNode, log = createLogger('wallet-sdk:base_wallet')){
+        this.pxe = pxe;
+        this.aztecNode = aztecNode;
+        this.log = log;
+        this.minFeePadding = 0.5;
+        this.cancellableTransactions = false;
+    }
+    scopesFrom(from, additionalScopes = []) {
+        const allScopes = from.isZero() ? additionalScopes : [
+            from,
+            ...additionalScopes
+        ];
+        const scopeSet = new Set(allScopes.map((address)=>address.toString()));
+        return [
+            ...scopeSet
+        ].map(AztecAddress.fromString);
+    }
+    /**
+   * Returns the list of aliased contacts associated with the wallet.
+   * This base implementation directly returns PXE's senders, but note that in general contacts are a superset of senders.
+   *  - Senders: Addresses we check during synching in case they sent us notes,
+   *  - Contacts: more general concept akin to a phone's contact list.
+   * @returns The aliased collection of AztecAddresses that form this wallet's address book
+   */ async getAddressBook() {
+        const senders = await this.pxe.getSenders();
+        return senders.map((sender)=>({
+                item: sender,
+                alias: ''
+            }));
+    }
+    async getChainInfo() {
+        const { l1ChainId, rollupVersion } = await this.aztecNode.getNodeInfo();
+        return {
+            chainId: new Fr(l1ChainId),
+            version: new Fr(rollupVersion)
+        };
+    }
+    async createTxExecutionRequestFromPayloadAndFee(executionPayload, from, feeOptions) {
+        const feeExecutionPayload = await feeOptions.walletFeePaymentMethod?.getExecutionPayload();
+        const executionOptions = {
+            txNonce: Fr.random(),
+            cancellable: this.cancellableTransactions,
+            feePaymentMethodOptions: feeOptions.accountFeePaymentMethodOptions
+        };
+        const finalExecutionPayload = feeExecutionPayload ? mergeExecutionPayloads([
+            feeExecutionPayload,
+            executionPayload
+        ]) : executionPayload;
+        const fromAccount = await this.getAccountFromAddress(from);
+        const chainInfo = await this.getChainInfo();
+        return fromAccount.createTxExecutionRequest(finalExecutionPayload, feeOptions.gasSettings, chainInfo, executionOptions);
+    }
+    async createAuthWit(from, messageHashOrIntent) {
+        const account = await this.getAccountFromAddress(from);
+        const chainInfo = await this.getChainInfo();
+        return account.createAuthWit(messageHashOrIntent, chainInfo);
+    }
+    /**
+   * Request capabilities from the wallet.
+   *
+   * This method is wallet-implementation-dependent and must be provided by classes extending BaseWallet.
+   * Embedded wallets typically don't support capability-based authorization (no user authorization flow),
+   * while external wallets (browser extensions, hardware wallets) implement this to reduce authorization
+   * friction by allowing apps to request permissions upfront.
+   *
+   * TODO: Consider making it abstract so implementing it is a conscious decision. Leaving it as-is
+   * while the feature stabilizes.
+   *
+   * @param _manifest - Application capability manifest declaring what operations the app needs
+   */ requestCapabilities(_manifest) {
+        throw new Error('Not implemented');
+    }
+    async batch(methods) {
+        const results = [];
+        for (const method of methods){
+            const { name, args } = method;
+            // Type safety is guaranteed by the BatchedMethod type, which ensures that:
+            // 1. `name` is a valid batchable method name
+            // 2. `args` matches the parameter types of that specific method
+            // 3. The return type is correctly mapped in BatchResults<T>
+            // We use dynamic dispatch here for simplicity, but the types are enforced at the call site.
+            const fn = this[name];
+            const result = await fn.apply(this, args);
+            // Wrap result with method name for discriminated union deserialization
+            results.push({
+                name,
+                result
+            });
+        }
+        return results;
+    }
+    /**
+   * Completes partial user-provided fee options with wallet defaults.
+   * @param from - The address where the transaction is being sent from
+   * @param feePayer - The address paying for fees (if any fee payment method is embedded in the execution payload)
+   * @param gasSettings - User-provided partial gas settings
+   * @returns - Complete fee options that can be used to create a transaction execution request
+   */ async completeFeeOptions(from, feePayer, gasSettings) {
+        const maxFeesPerGas = gasSettings?.maxFeesPerGas ?? (await this.aztecNode.getCurrentMinFees()).mul(1 + this.minFeePadding);
+        let accountFeePaymentMethodOptions;
+        // The transaction does not include a fee payment method, so we set the flag
+        // for the account to use its fee juice balance
+        if (!feePayer) {
+            accountFeePaymentMethodOptions = AccountFeePaymentMethodOptions.PREEXISTING_FEE_JUICE;
+        } else {
+            // The transaction includes fee payment method, so we check if we are the fee payer for it
+            // (this can only happen if the embedded payment method is FeeJuiceWithClaim)
+            accountFeePaymentMethodOptions = from.equals(feePayer) ? AccountFeePaymentMethodOptions.FEE_JUICE_WITH_CLAIM : AccountFeePaymentMethodOptions.EXTERNAL;
+        }
+        const fullGasSettings = GasSettings.default({
+            ...gasSettings,
+            maxFeesPerGas
+        });
+        this.log.debug(`Using L2 gas settings`, fullGasSettings);
+        return {
+            gasSettings: fullGasSettings,
+            walletFeePaymentMethod: undefined,
+            accountFeePaymentMethodOptions
+        };
+    }
+    /**
+   * Completes partial user-provided fee options with unreasonably high gas limits
+   * for gas estimation. Uses the same logic as completeFeeOptions but sets high limits
+   * to avoid running out of gas during estimation.
+   * @param from - The address where the transaction is being sent from
+   * @param feePayer - The address paying for fees (if any fee payment method is embedded in the execution payload)
+   * @param gasSettings - User-provided partial gas settings
+   */ async completeFeeOptionsForEstimation(from, feePayer, gasSettings) {
+        const defaultFeeOptions = await this.completeFeeOptions(from, feePayer, gasSettings);
+        const { gasSettings: { maxFeesPerGas, maxPriorityFeesPerGas } } = defaultFeeOptions;
+        // Use unrealistically high gas limits for estimation to avoid running out of gas.
+        // They will be tuned down after the simulation.
+        const gasSettingsForEstimation = new GasSettings(new Gas(GAS_ESTIMATION_DA_GAS_LIMIT, GAS_ESTIMATION_L2_GAS_LIMIT), new Gas(GAS_ESTIMATION_TEARDOWN_DA_GAS_LIMIT, GAS_ESTIMATION_TEARDOWN_L2_GAS_LIMIT), maxFeesPerGas, maxPriorityFeesPerGas);
+        return {
+            ...defaultFeeOptions,
+            gasSettings: gasSettingsForEstimation
+        };
+    }
+    registerSender(address, _alias = '') {
+        return this.pxe.registerSender(address);
+    }
+    async registerContract(instance, artifact, secretKey) {
+        const existingInstance = await this.pxe.getContractInstance(instance.address);
+        if (existingInstance) {
+            // Instance already registered in the wallet
+            if (artifact) {
+                const thisContractClass = await getContractClassFromArtifact(artifact);
+                if (!thisContractClass.id.equals(existingInstance.currentContractClassId)) {
+                    // wallet holds an outdated version of this contract
+                    await this.pxe.updateContract(instance.address, artifact);
+                    instance.currentContractClassId = thisContractClass.id;
+                }
+            }
+        // If no artifact provided, we just use the existing registration
+        } else {
+            // Instance not registered yet
+            if (!artifact) {
+                // Try to get the artifact from the wallet's contract class storage
+                artifact = await this.pxe.getContractArtifact(instance.currentContractClassId);
+                if (!artifact) {
+                    throw new Error(`Cannot register contract at ${instance.address.toString()}: artifact is required but not provided, and wallet does not have the artifact for contract class ${instance.currentContractClassId.toString()}`);
+                }
+            }
+            await this.pxe.registerContract({
+                artifact,
+                instance
+            });
+        }
+        if (secretKey) {
+            await this.pxe.registerAccount(secretKey, await computePartialAddress(instance));
+        }
+        return instance;
+    }
+    /**
+   * Simulates calls through the standard PXE path (account entrypoint).
+   * @param executionPayload - The execution payload to simulate.
+   * @param from - The sender address.
+   * @param feeOptions - Fee options for the transaction.
+   * @param skipTxValidation - Whether to skip tx validation.
+   * @param skipFeeEnforcement - Whether to skip fee enforcement.
+   * @param scopes - The scopes to use for the simulation.
+   */ async simulateViaEntrypoint(executionPayload, from, feeOptions, scopes, skipTxValidation, skipFeeEnforcement) {
+        const txRequest = await this.createTxExecutionRequestFromPayloadAndFee(executionPayload, from, feeOptions);
+        return this.pxe.simulateTx(txRequest, {
+            simulatePublic: true,
+            skipTxValidation,
+            skipFeeEnforcement,
+            scopes
+        });
+    }
+    /**
+   * Simulates a transaction, optimizing leading public static calls by running them directly
+   * on the node while sending the remaining calls through the standard PXE path.
+   * Return values from both paths are merged back in original call order.
+   * @param executionPayload - The execution payload to simulate.
+   * @param opts - Simulation options (from address, fee settings, etc.).
+   * @returns The merged simulation result.
+   */ async simulateTx(executionPayload, opts) {
+        const feeOptions = opts.fee?.estimateGas ? await this.completeFeeOptionsForEstimation(opts.from, executionPayload.feePayer, opts.fee?.gasSettings) : await this.completeFeeOptions(opts.from, executionPayload.feePayer, opts.fee?.gasSettings);
+        const { optimizableCalls, remainingCalls } = extractOptimizablePublicStaticCalls(executionPayload);
+        const remainingPayload = {
+            ...executionPayload,
+            calls: remainingCalls
+        };
+        const chainInfo = await this.getChainInfo();
+        let blockHeader;
+        // PXE might not be synced yet, so we pull the latest header from the node
+        // To keep things consistent, we'll always try with PXE first
+        try {
+            blockHeader = await this.pxe.getSyncedBlockHeader();
+        } catch  {
+            blockHeader = await this.aztecNode.getBlockHeader();
+        }
+        const [optimizedResults, normalResult] = await Promise.all([
+            optimizableCalls.length > 0 ? simulateViaNode(this.aztecNode, optimizableCalls, opts.from, chainInfo, feeOptions.gasSettings, blockHeader, opts.skipFeeEnforcement ?? true, this.getContractName.bind(this)) : Promise.resolve([]),
+            remainingCalls.length > 0 ? this.simulateViaEntrypoint(remainingPayload, opts.from, feeOptions, this.scopesFrom(opts.from, opts.additionalScopes), opts.skipTxValidation, opts.skipFeeEnforcement ?? true) : Promise.resolve(null)
+        ]);
+        return buildMergedSimulationResult(optimizedResults, normalResult);
+    }
+    async profileTx(executionPayload, opts) {
+        const feeOptions = await this.completeFeeOptions(opts.from, executionPayload.feePayer, opts.fee?.gasSettings);
+        const txRequest = await this.createTxExecutionRequestFromPayloadAndFee(executionPayload, opts.from, feeOptions);
+        return this.pxe.profileTx(txRequest, {
+            profileMode: opts.profileMode,
+            skipProofGeneration: opts.skipProofGeneration ?? true,
+            scopes: this.scopesFrom(opts.from, opts.additionalScopes)
+        });
+    }
+    async sendTx(executionPayload, opts) {
+        const feeOptions = await this.completeFeeOptions(opts.from, executionPayload.feePayer, opts.fee?.gasSettings);
+        const txRequest = await this.createTxExecutionRequestFromPayloadAndFee(executionPayload, opts.from, feeOptions);
+        const provenTx = await this.pxe.proveTx(txRequest, this.scopesFrom(opts.from, opts.additionalScopes));
+        const offchainOutput = extractOffchainOutput(provenTx.getOffchainEffects(), provenTx.publicInputs.constants.anchorBlockHeader.globalVariables.timestamp);
+        const tx = await provenTx.toTx();
+        const txHash = tx.getTxHash();
+        if (await this.aztecNode.getTxEffect(txHash)) {
+            throw new Error(`A settled tx with equal hash ${txHash.toString()} exists.`);
+        }
+        this.log.debug(`Sending transaction ${txHash}`);
+        await this.aztecNode.sendTx(tx).catch((err)=>{
+            throw this.contextualizeError(err, inspect(tx));
+        });
+        this.log.info(`Sent transaction ${txHash}`);
+        // If wait is NO_WAIT, return txHash immediately
+        if (opts.wait === NO_WAIT) {
+            return {
+                txHash,
+                ...offchainOutput
+            };
+        }
+        // Otherwise, wait for the full receipt (default behavior on wait: undefined)
+        const waitOpts = typeof opts.wait === 'object' ? opts.wait : undefined;
+        const receipt = await waitForTx(this.aztecNode, txHash, waitOpts);
+        // Display debug logs from public execution if present (served in test mode only)
+        if (receipt.debugLogs?.length) {
+            await displayDebugLogs(receipt.debugLogs, this.getContractName.bind(this));
+        }
+        return {
+            receipt,
+            ...offchainOutput
+        };
+    }
+    /**
+   * Resolves a contract address to a human-readable name via PXE, if available.
+   * @param address - The contract address to resolve.
+   */ async getContractName(address) {
+        const instance = await this.pxe.getContractInstance(address);
+        if (!instance) {
+            return undefined;
+        }
+        const artifact = await this.pxe.getContractArtifact(instance.currentContractClassId);
+        return artifact?.name;
+    }
+    contextualizeError(err, ...context) {
+        let contextStr = '';
+        if (context.length > 0) {
+            contextStr = `\nContext:\n${context.join('\n')}`;
+        }
+        if (err instanceof SimulationError) {
+            err.setAztecContext(contextStr);
+        } else {
+            this.log.error(err.name, err);
+            this.log.debug(contextStr);
+        }
+        return err;
+    }
+    executeUtility(call, opts) {
+        return this.pxe.executeUtility(call, {
+            authwits: opts.authWitnesses,
+            scopes: [
+                opts.scope
+            ]
+        });
+    }
+    async getPrivateEvents(eventDef, eventFilter) {
+        const pxeEvents = await this.pxe.getPrivateEvents(eventDef.eventSelector, eventFilter);
+        const decodedEvents = pxeEvents.map((pxeEvent)=>{
+            return {
+                event: decodeFromAbi([
+                    eventDef.abiType
+                ], pxeEvent.packedEvent),
+                metadata: {
+                    l2BlockNumber: pxeEvent.l2BlockNumber,
+                    l2BlockHash: pxeEvent.l2BlockHash,
+                    txHash: pxeEvent.txHash
+                }
+            };
+        });
+        return decodedEvents;
+    }
+    async getContractMetadata(address) {
+        const instance = await this.pxe.getContractInstance(address);
+        const initNullifier = await siloNullifier(address, address.toField());
+        const publiclyRegisteredContract = await this.aztecNode.getContract(address);
+        const initNullifierMembershipWitness = await this.aztecNode.getNullifierMembershipWitness('latest', initNullifier);
+        const isContractUpdated = publiclyRegisteredContract && !publiclyRegisteredContract.currentContractClassId.equals(publiclyRegisteredContract.originalContractClassId);
+        return {
+            instance: instance ?? undefined,
+            isContractInitialized: !!initNullifierMembershipWitness,
+            isContractPublished: !!publiclyRegisteredContract,
+            isContractUpdated: !!isContractUpdated,
+            updatedContractClassId: isContractUpdated ? publiclyRegisteredContract.currentContractClassId : undefined
+        };
+    }
+    async getContractClassMetadata(id) {
+        const publiclyRegisteredContractClass = await this.aztecNode.getContractClass(id);
+        return {
+            isArtifactRegistered: !!await this.pxe.getContractArtifact(id),
+            isContractClassPubliclyRegistered: !!publiclyRegisteredContractClass
+        };
+    }
+}

package/dest/base-wallet/index.d.ts

@@ -0,0 +1,3 @@
+export { BaseWallet, type FeeOptions } from './base_wallet.js';
+export { simulateViaNode, buildMergedSimulationResult, extractOptimizablePublicStaticCalls } from './utils.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9iYXNlLXdhbGxldC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLEtBQUssVUFBVSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDL0QsT0FBTyxFQUFFLGVBQWUsRUFBRSwyQkFBMkIsRUFBRSxtQ0FBbUMsRUFBRSxNQUFNLFlBQVksQ0FBQyJ9

package/dest/base-wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base-wallet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,mCAAmC,EAAE,MAAM,YAAY,CAAC"}

package/dest/base-wallet/index.js

@@ -0,0 +1,2 @@
+export { BaseWallet } from './base_wallet.js';
+export { simulateViaNode, buildMergedSimulationResult, extractOptimizablePublicStaticCalls } from './utils.js';

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

@@ -0,0 +1,49 @@
+import type { AztecNode } from '@aztec/aztec.js/node';
+import type { ChainInfo } from '@aztec/entrypoints/interfaces';
+import type { ContractNameResolver } from '@aztec/pxe/client/lazy';
+import { type FunctionCall } from '@aztec/stdlib/abi';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { GasSettings } from '@aztec/stdlib/gas';
+import { type BlockHeader, type ExecutionPayload, TxSimulationResult } from '@aztec/stdlib/tx';
+/**
+ * Splits an execution payload into a leading prefix of public static calls
+ * (eligible for direct node simulation) and the remaining calls.
+ *
+ * Only a leading run of public static calls is eligible for optimization.
+ * Any non-public-static call may enqueue public state mutations
+ * (e.g. private calls can enqueue public calls), so all calls that follow
+ * must go through the normal simulation path to see the correct state.
+ *
+ */
+export declare function extractOptimizablePublicStaticCalls(payload: ExecutionPayload): {
+    /** Leading public static calls eligible for direct node simulation. */
+    optimizableCalls: FunctionCall[];
+    /** All remaining calls. */
+    remainingCalls: FunctionCall[];
+};
+/**
+ * Simulates public static calls by splitting them into batches of MAX_ENQUEUED_CALLS_PER_CALL
+ * and sending each batch directly to the node.
+ *
+ * @param node - The Aztec node to simulate on.
+ * @param publicStaticCalls - Array of public static function calls to optimize.
+ * @param from - The account address making the calls.
+ * @param chainInfo - Chain information (chainId and version).
+ * @param gasSettings - Gas settings for the transaction.
+ * @param blockHeader - Block header to use as anchor.
+ * @param skipFeeEnforcement - Whether to skip fee enforcement during simulation.
+ * @returns Array of TxSimulationResult, one per batch.
+ */
+export declare function simulateViaNode(node: AztecNode, publicStaticCalls: FunctionCall[], from: AztecAddress, chainInfo: ChainInfo, gasSettings: GasSettings, blockHeader: BlockHeader, skipFeeEnforcement: boolean | undefined, getContractName: ContractNameResolver): Promise<TxSimulationResult[]>;
+/**
+ * Merges simulation results from the optimized (public static) and normal paths.
+ * Since optimized calls are always a leading prefix, return values are simply
+ * concatenated: optimized first, then normal.
+ * Stats are taken from the normal result only (the optimized path doesn't produce them).
+ *
+ * @param optimizedResults - Results from optimized public static call batches.
+ * @param normalResult - Result from normal simulation (null if all calls were optimized).
+ * @returns A single TxSimulationResult with return values in original call order.
+ */
+export declare function buildMergedSimulationResult(optimizedResults: TxSimulationResult[], normalResult: TxSimulationResult | null): TxSimulationResult;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9iYXNlLXdhbGxldC91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUV0RCxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUkvRCxPQUFPLEtBQUssRUFBRSxvQkFBb0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBR25FLE9BQU8sRUFBRSxLQUFLLFlBQVksRUFBb0IsTUFBTSxtQkFBbUIsQ0FBQztBQUN4RSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQVFyRCxPQUFPLEVBQ0wsS0FBSyxXQUFXLEVBQ2hCLEtBQUssZ0JBQWdCLEVBT3JCLGtCQUFrQixFQUNuQixNQUFNLGtCQUFrQixDQUFDO0FBRTFCOzs7Ozs7Ozs7R0FTRztBQUNILHdCQUFnQixtQ0FBbUMsQ0FBQyxPQUFPLEVBQUUsZ0JBQWdCLEdBQUc7SUFDOUUsdUVBQXVFO0lBQ3ZFLGdCQUFnQixFQUFFLFlBQVksRUFBRSxDQUFDO0lBQ2pDLDJCQUEyQjtJQUMzQixjQUFjLEVBQUUsWUFBWSxFQUFFLENBQUM7Q0FDaEMsQ0FPQTtBQXVHRDs7Ozs7Ozs7Ozs7O0dBWUc7QUFDSCx3QkFBc0IsZUFBZSxDQUNuQyxJQUFJLEVBQUUsU0FBUyxFQUNmLGlCQUFpQixFQUFFLFlBQVksRUFBRSxFQUNqQyxJQUFJLEVBQUUsWUFBWSxFQUNsQixTQUFTLEVBQUUsU0FBUyxFQUNwQixXQUFXLEVBQUUsV0FBVyxFQUN4QixXQUFXLEVBQUUsV0FBVyxFQUN4QixrQkFBa0IscUJBQWdCLEVBQ2xDLGVBQWUsRUFBRSxvQkFBb0IsR0FDcEMsT0FBTyxDQUFDLGtCQUFrQixFQUFFLENBQUMsQ0F3Qi9CO0FBRUQ7Ozs7Ozs7OztHQVNHO0FBQ0gsd0JBQWdCLDJCQUEyQixDQUN6QyxnQkFBZ0IsRUFBRSxrQkFBa0IsRUFBRSxFQUN0QyxZQUFZLEVBQUUsa0JBQWtCLEdBQUcsSUFBSSxHQUN0QyxrQkFBa0IsQ0FvQnBCIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/base-wallet/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQrD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAOrB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;GASG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAC9E,uEAAuE;IACvE,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,2BAA2B;IAC3B,cAAc,EAAE,YAAY,EAAE,CAAC;CAChC,CAOA;AAuGD;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,SAAS,EACf,iBAAiB,EAAE,YAAY,EAAE,EACjC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,WAAW,EACxB,kBAAkB,qBAAgB,EAClC,eAAe,EAAE,oBAAoB,GACpC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwB/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,kBAAkB,EAAE,EACtC,YAAY,EAAE,kBAAkB,GAAG,IAAI,GACtC,kBAAkB,CAoBpB"}

package/dest/base-wallet/utils.js

@@ -0,0 +1,131 @@
+import { MAX_ENQUEUED_CALLS_PER_CALL } from '@aztec/constants';
+import { makeTuple } from '@aztec/foundation/array';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { displayDebugLogs } from '@aztec/pxe/client/lazy';
+import { generateSimulatedProvingResult } from '@aztec/pxe/simulator';
+import { ClaimedLengthArray, CountedPublicCallRequest, PrivateCircuitPublicInputs, PublicCallRequest } from '@aztec/stdlib/kernel';
+import { ChonkProof } from '@aztec/stdlib/proofs';
+import { HashedValues, PrivateCallExecutionResult, PrivateExecutionResult, Tx, TxContext, TxSimulationResult } from '@aztec/stdlib/tx';
+/**
+ * Splits an execution payload into a leading prefix of public static calls
+ * (eligible for direct node simulation) and the remaining calls.
+ *
+ * Only a leading run of public static calls is eligible for optimization.
+ * Any non-public-static call may enqueue public state mutations
+ * (e.g. private calls can enqueue public calls), so all calls that follow
+ * must go through the normal simulation path to see the correct state.
+ *
+ */ export function extractOptimizablePublicStaticCalls(payload) {
+    const splitIndex = payload.calls.findIndex((call)=>!call.isPublicStatic());
+    const boundary = splitIndex === -1 ? payload.calls.length : splitIndex;
+    return {
+        optimizableCalls: payload.calls.slice(0, boundary),
+        remainingCalls: payload.calls.slice(boundary)
+    };
+}
+/**
+ * Simulates a batch of public static calls by bypassing account entrypoint and private execution,
+ * directly constructing a minimal Tx and calling node.simulatePublicCalls.
+ *
+ * @param node - The Aztec node to simulate on.
+ * @param publicStaticCalls - Array of public static function calls (max MAX_ENQUEUED_CALLS_PER_CALL).
+ * @param from - The account address making the calls.
+ * @param chainInfo - Chain information (chainId and version).
+ * @param gasSettings - Gas settings for the transaction.
+ * @param blockHeader - Block header to use as anchor.
+ * @param skipFeeEnforcement - Whether to skip fee enforcement during simulation.
+ * @returns TxSimulationResult with public return values.
+ */ async function simulateBatchViaNode(node, publicStaticCalls, from, chainInfo, gasSettings, blockHeader, skipFeeEnforcement, getContractName) {
+    const txContext = new TxContext(chainInfo.chainId, chainInfo.version, gasSettings);
+    const publicFunctionCalldata = [];
+    for (const call of publicStaticCalls){
+        const calldata = await HashedValues.fromCalldata([
+            call.selector.toField(),
+            ...call.args
+        ]);
+        publicFunctionCalldata.push(calldata);
+    }
+    const publicCallRequests = makeTuple(MAX_ENQUEUED_CALLS_PER_CALL, (i)=>{
+        const call = publicStaticCalls[i];
+        if (!call) {
+            return CountedPublicCallRequest.empty();
+        }
+        const publicCallRequest = new PublicCallRequest(from, call.to, call.isStatic, publicFunctionCalldata[i].hash);
+        // Counter starts at 1 (minRevertibleSideEffectCounter) so all calls are revertible
+        return new CountedPublicCallRequest(publicCallRequest, i + 1);
+    });
+    const publicCallRequestsArray = new ClaimedLengthArray(publicCallRequests, publicStaticCalls.length);
+    const publicInputs = PrivateCircuitPublicInputs.from({
+        ...PrivateCircuitPublicInputs.empty(),
+        anchorBlockHeader: blockHeader,
+        txContext: txContext,
+        publicCallRequests: publicCallRequestsArray,
+        startSideEffectCounter: new Fr(0),
+        endSideEffectCounter: new Fr(publicStaticCalls.length + 1)
+    });
+    // Minimal entrypoint structure — no real private execution, just public call requests
+    const emptyEntrypoint = new PrivateCallExecutionResult(Buffer.alloc(0), Buffer.alloc(0), new Map(), publicInputs, [], new Map(), [], [], [], [], []);
+    const privateResult = new PrivateExecutionResult(emptyEntrypoint, Fr.random(), publicFunctionCalldata);
+    const provingResult = await generateSimulatedProvingResult(privateResult, (_contractAddress, _functionSelector)=>Promise.resolve(''), node, 1);
+    provingResult.publicInputs.feePayer = from;
+    const tx = await Tx.create({
+        data: provingResult.publicInputs,
+        chonkProof: ChonkProof.empty(),
+        contractClassLogFields: [],
+        publicFunctionCalldata: publicFunctionCalldata
+    });
+    const publicOutput = await node.simulatePublicCalls(tx, skipFeeEnforcement);
+    if (publicOutput.revertReason) {
+        throw publicOutput.revertReason;
+    }
+    // Display debug logs from the public simulation.
+    await displayDebugLogs(publicOutput.debugLogs, getContractName);
+    return new TxSimulationResult(privateResult, provingResult.publicInputs, publicOutput, undefined);
+}
+/**
+ * Simulates public static calls by splitting them into batches of MAX_ENQUEUED_CALLS_PER_CALL
+ * and sending each batch directly to the node.
+ *
+ * @param node - The Aztec node to simulate on.
+ * @param publicStaticCalls - Array of public static function calls to optimize.
+ * @param from - The account address making the calls.
+ * @param chainInfo - Chain information (chainId and version).
+ * @param gasSettings - Gas settings for the transaction.
+ * @param blockHeader - Block header to use as anchor.
+ * @param skipFeeEnforcement - Whether to skip fee enforcement during simulation.
+ * @returns Array of TxSimulationResult, one per batch.
+ */ export async function simulateViaNode(node, publicStaticCalls, from, chainInfo, gasSettings, blockHeader, skipFeeEnforcement = true, getContractName) {
+    const batches = [];
+    for(let i = 0; i < publicStaticCalls.length; i += MAX_ENQUEUED_CALLS_PER_CALL){
+        batches.push(publicStaticCalls.slice(i, i + MAX_ENQUEUED_CALLS_PER_CALL));
+    }
+    const results = [];
+    for (const batch of batches){
+        const result = await simulateBatchViaNode(node, batch, from, chainInfo, gasSettings, blockHeader, skipFeeEnforcement, getContractName);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Merges simulation results from the optimized (public static) and normal paths.
+ * Since optimized calls are always a leading prefix, return values are simply
+ * concatenated: optimized first, then normal.
+ * Stats are taken from the normal result only (the optimized path doesn't produce them).
+ *
+ * @param optimizedResults - Results from optimized public static call batches.
+ * @param normalResult - Result from normal simulation (null if all calls were optimized).
+ * @returns A single TxSimulationResult with return values in original call order.
+ */ export function buildMergedSimulationResult(optimizedResults, normalResult) {
+    const optimizedReturnValues = optimizedResults.flatMap((r)=>r.publicOutput?.publicReturnValues ?? []);
+    const normalReturnValues = normalResult?.publicOutput?.publicReturnValues ?? [];
+    const allReturnValues = [
+        ...optimizedReturnValues,
+        ...normalReturnValues
+    ];
+    const baseResult = normalResult ?? optimizedResults[0];
+    const mergedPublicOutput = baseResult.publicOutput ? {
+        ...baseResult.publicOutput,
+        publicReturnValues: allReturnValues
+    } : undefined;
+    return new TxSimulationResult(baseResult.privateExecutionResult, baseResult.publicInputs, mergedPublicOutput, normalResult?.stats);
+}