@aztec-labs/entrypoints 6.0.0-nightly.20260829

package/README.md

@@ -0,0 +1,8 @@
+# Account Entrypoints
+
+This package contains different transaction entrypoints for the Aztec Network.
+
+## Available entrypoints
+
+- **Account entrypoint**: this entrypoint encodes the payload to start an interaction through an Account Contract. It is meant to be used with accounts implementing the interface defined by `@aztec-labs/accounts`.
+- **DApp entrypoint**: this encodes the payload so that it may run a dapp directly, instead of going through an account contract.

package/dest/account_entrypoint.d.ts

@@ -0,0 +1,59 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import type { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { GasSettings } from '@aztec-labs/stdlib/gas';
+import { ExecutionPayload, TxExecutionRequest } from '@aztec-labs/stdlib/tx';
+import type { AuthWitnessProvider, ChainInfo, EntrypointInterface } from './interfaces.js';
+/**
+ * The mechanism via which an account contract will pay for a transaction in which it gets invoked.
+ */
+export declare enum AccountFeePaymentMethodOptions {
+    /**
+     * Signals that some other contract is in charge of paying the fee, nothing needs to be done.
+     */
+    EXTERNAL = 0,
+    /**
+     * Used to make the account contract publicly pay for the transaction with its own fee juice balance,
+     * **which it must already have prior to this transaction**.
+     *
+     * The contract will set itself as the fee payer and end the setup phase.
+     */
+    PREEXISTING_FEE_JUICE = 1,
+    /**
+     * Used to make the account contract publicly pay for the transaction with its own fee juice balance
+     * **which is being claimed in the same transaction**.
+     *
+     * The contract will set itself as the fee payer but not end setup phase - this is done by the Fee Juice
+     * contract after enqueuing a public call, which unlike most public calls is whitelisted by the nodes
+     * to be executable during the setup phase.
+     */
+    FEE_JUICE_WITH_CLAIM = 2
+}
+/**
+ * General options for the tx execution.
+ */
+export type DefaultAccountEntrypointOptions = {
+    /** Whether the transaction can be cancelled. */
+    cancellable?: boolean;
+    /**
+     * A nonce to inject into the app payload of the transaction. When used with cancellable=true, this nonce will be
+     * used to compute a nullifier that allows cancelling this transaction by submitting a new one with the same nonce
+     * but higher fee. The nullifier ensures only one transaction can succeed.
+     */
+    txNonce?: Fr;
+    /** Options that configure how the account contract behaves depending on the fee payment method of the tx */
+    feePaymentMethodOptions: AccountFeePaymentMethodOptions;
+};
+/**
+ * Implementation for an entrypoint interface that follows the default entrypoint signature
+ * for an account, which accepts an AppPayload and a FeePayload as defined in noir-libs/aztec-noir/src/entrypoint module
+ */
+export declare class DefaultAccountEntrypoint implements EntrypointInterface {
+    #private;
+    private address;
+    private auth;
+    constructor(address: AztecAddress, auth: AuthWitnessProvider);
+    createTxExecutionRequest(exec: ExecutionPayload, gasSettings: GasSettings, chainInfo: ChainInfo, options: DefaultAccountEntrypointOptions): Promise<TxExecutionRequest>;
+    wrapExecutionPayload(exec: ExecutionPayload, chainInfo: ChainInfo, options: DefaultAccountEntrypointOptions): Promise<ExecutionPayload>;
+    private getEntrypointAbi;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNjb3VudF9lbnRyeXBvaW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvYWNjb3VudF9lbnRyeXBvaW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQVN6RCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNyRSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUMxRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQTJCLGtCQUFrQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFHdEcsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsU0FBUyxFQUFFLG1CQUFtQixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFM0Y7O0dBRUc7QUFDSCxvQkFBWSw4QkFBOEI7SUFDeEM7O09BRUc7SUFDSCxRQUFRLElBQUk7SUFDWjs7Ozs7T0FLRztJQUNILHFCQUFxQixJQUFJO0lBQ3pCOzs7Ozs7O09BT0c7SUFDSCxvQkFBb0IsSUFBSTtDQUN6QjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxNQUFNLCtCQUErQixHQUFHO0lBQzVDLGdEQUFnRDtJQUNoRCxXQUFXLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDdEI7Ozs7T0FJRztJQUNILE9BQU8sQ0FBQyxFQUFFLEVBQUUsQ0FBQztJQUNiLDRHQUE0RztJQUM1Ryx1QkFBdUIsRUFBRSw4QkFBOEIsQ0FBQztDQUN6RCxDQUFDO0FBRUY7OztHQUdHO0FBQ0gscUJBQWEsd0JBQXlCLFlBQVcsbUJBQW1COztJQUVoRSxPQUFPLENBQUMsT0FBTztJQUNmLE9BQU8sQ0FBQyxJQUFJO0lBRmQsWUFDVSxPQUFPLEVBQUUsWUFBWSxFQUNyQixJQUFJLEVBQUUsbUJBQW1CLEVBQy9CO0lBRUUsd0JBQXdCLENBQzVCLElBQUksRUFBRSxnQkFBZ0IsRUFDdEIsV0FBVyxFQUFFLFdBQVcsRUFDeEIsU0FBUyxFQUFFLFNBQVMsRUFDcEIsT0FBTyxFQUFFLCtCQUErQixHQUN2QyxPQUFPLENBQUMsa0JBQWtCLENBQUMsQ0FnQjdCO0lBRUssb0JBQW9CLENBQ3hCLElBQUksRUFBRSxnQkFBZ0IsRUFDdEIsU0FBUyxFQUFFLFNBQVMsRUFDcEIsT0FBTyxFQUFFLCtCQUErQixHQUN2QyxPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0F1QjNCO0lBdUNELE9BQU8sQ0FBQyxnQkFBZ0I7Q0EwRHpCIn0=

package/dest/account_entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account_entrypoint.d.ts","sourceRoot":"","sources":["../src/account_entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AASzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAA2B,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGtG,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3F;;GAEG;AACH,oBAAY,8BAA8B;IACxC;;OAEG;IACH,QAAQ,IAAI;IACZ;;;;;OAKG;IACH,qBAAqB,IAAI;IACzB;;;;;;;OAOG;IACH,oBAAoB,IAAI;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC;IACb,4GAA4G;IAC5G,uBAAuB,EAAE,8BAA8B,CAAC;CACzD,CAAC;AAEF;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;;IAEhE,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI;IAFd,YACU,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,mBAAmB,EAC/B;IAEE,wBAAwB,CAC5B,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;IAEK,oBAAoB,CACxB,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;IAuCD,OAAO,CAAC,gBAAgB;CA0DzB"}

package/dest/account_entrypoint.js

@@ -0,0 +1,226 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { FunctionCall, FunctionSelector, encodeArguments, getFunctionReturnType } from '@aztec-labs/stdlib/abi';
+import { computeOuterAuthWitHash } from '@aztec-labs/stdlib/auth-witness';
+import { ExecutionPayload, HashedValues, TxContext, TxExecutionRequest } from '@aztec-labs/stdlib/tx';
+import { EncodedAppEntrypointCalls } from './encoding.js';
+/**
+ * The mechanism via which an account contract will pay for a transaction in which it gets invoked.
+ */ export var AccountFeePaymentMethodOptions = /*#__PURE__*/ function(AccountFeePaymentMethodOptions) {
+    /**
+   * Signals that some other contract is in charge of paying the fee, nothing needs to be done.
+   */ AccountFeePaymentMethodOptions[AccountFeePaymentMethodOptions["EXTERNAL"] = 0] = "EXTERNAL";
+    /**
+   * Used to make the account contract publicly pay for the transaction with its own fee juice balance,
+   * **which it must already have prior to this transaction**.
+   *
+   * The contract will set itself as the fee payer and end the setup phase.
+   */ AccountFeePaymentMethodOptions[AccountFeePaymentMethodOptions["PREEXISTING_FEE_JUICE"] = 1] = "PREEXISTING_FEE_JUICE";
+    /**
+   * Used to make the account contract publicly pay for the transaction with its own fee juice balance
+   * **which is being claimed in the same transaction**.
+   *
+   * The contract will set itself as the fee payer but not end setup phase - this is done by the Fee Juice
+   * contract after enqueuing a public call, which unlike most public calls is whitelisted by the nodes
+   * to be executable during the setup phase.
+   */ AccountFeePaymentMethodOptions[AccountFeePaymentMethodOptions["FEE_JUICE_WITH_CLAIM"] = 2] = "FEE_JUICE_WITH_CLAIM";
+    return AccountFeePaymentMethodOptions;
+}({});
+/**
+ * Implementation for an entrypoint interface that follows the default entrypoint signature
+ * for an account, which accepts an AppPayload and a FeePayload as defined in noir-libs/aztec-noir/src/entrypoint module
+ */ export class DefaultAccountEntrypoint {
+    address;
+    auth;
+    constructor(address, auth){
+        this.address = address;
+        this.auth = auth;
+    }
+    async createTxExecutionRequest(exec, gasSettings, chainInfo, options) {
+        const { authWitnesses, capsules, extraHashedArgs } = exec;
+        const callData = await this.#buildEntrypointCallData(exec, chainInfo, options);
+        const entrypointHashedArgs = await HashedValues.fromArgs(callData.encodedArgs);
+        const txRequest = TxExecutionRequest.from({
+            firstCallArgsHash: entrypointHashedArgs.hash,
+            origin: this.address,
+            functionSelector: callData.functionSelector,
+            txContext: new TxContext(chainInfo.chainId.toNumber(), chainInfo.version.toNumber(), gasSettings),
+            argsOfCalls: [
+                ...callData.encodedCalls.hashedArguments,
+                entrypointHashedArgs,
+                ...extraHashedArgs
+            ],
+            authWitnesses: [
+                ...authWitnesses,
+                callData.payloadAuthWitness
+            ],
+            capsules,
+            salt: Fr.random()
+        });
+        return txRequest;
+    }
+    async wrapExecutionPayload(exec, chainInfo, options) {
+        const { authWitnesses, capsules, extraHashedArgs, feePayer } = exec;
+        const callData = await this.#buildEntrypointCallData(exec, chainInfo, options);
+        // Build the entrypoint function call
+        const entrypointCall = FunctionCall.from({
+            name: callData.abi.name,
+            to: this.address,
+            selector: callData.functionSelector,
+            type: callData.abi.functionType,
+            hideMsgSender: false,
+            isStatic: callData.abi.isStatic,
+            args: callData.encodedArgs,
+            returnType: getFunctionReturnType(callData.abi)
+        });
+        return new ExecutionPayload([
+            entrypointCall
+        ], [
+            callData.payloadAuthWitness,
+            ...authWitnesses
+        ], capsules, [
+            ...callData.encodedCalls.hashedArguments,
+            ...extraHashedArgs
+        ], feePayer ?? this.address);
+    }
+    /**
+   * Builds the shared data needed for both creating a tx execution request and wrapping an execution payload.
+   * This includes encoding calls, building entrypoint arguments, and creating the authwitness.
+   * @param exec - The execution payload containing calls to encode
+   * @param chainInfo - Chain information (chainId and version) for replay protection
+   * @param options - Account entrypoint options including tx nonce and fee payment method
+   * @returns Encoded call data, ABI, function selector, and auth witness
+   */ async #buildEntrypointCallData(exec, chainInfo, options) {
+        const { calls } = exec;
+        const { cancellable, txNonce, feePaymentMethodOptions } = options;
+        const encodedCalls = await EncodedAppEntrypointCalls.create(calls, txNonce);
+        const abi = this.getEntrypointAbi();
+        const args = [
+            encodedCalls,
+            feePaymentMethodOptions,
+            !!cancellable
+        ];
+        const encodedArgs = encodeArguments(abi, args);
+        const functionSelector = await FunctionSelector.fromNameAndParameters(abi.name, abi.parameters);
+        const payloadHash = await encodedCalls.hash();
+        const messageHash = await computeOuterAuthWitHash(this.address, chainInfo.chainId, chainInfo.version, payloadHash);
+        const payloadAuthWitness = await this.auth.createAuthWit(messageHash);
+        return {
+            encodedCalls,
+            abi,
+            encodedArgs,
+            functionSelector,
+            payloadAuthWitness
+        };
+    }
+    getEntrypointAbi() {
+        return {
+            name: 'entrypoint',
+            isInitializer: false,
+            functionType: 'private',
+            isOnlySelf: false,
+            isStatic: false,
+            parameters: [
+                {
+                    name: 'app_payload',
+                    type: {
+                        kind: 'struct',
+                        path: 'authwit::entrypoint::app::AppPayload',
+                        fields: [
+                            {
+                                name: 'function_calls',
+                                type: {
+                                    kind: 'array',
+                                    length: 5,
+                                    type: {
+                                        kind: 'struct',
+                                        path: 'authwit::entrypoint::function_call::FunctionCall',
+                                        fields: [
+                                            {
+                                                name: 'args_hash',
+                                                type: {
+                                                    kind: 'field'
+                                                }
+                                            },
+                                            {
+                                                name: 'function_selector',
+                                                type: {
+                                                    kind: 'struct',
+                                                    path: 'authwit::aztec::protocol_types::abis::function_selector::FunctionSelector',
+                                                    fields: [
+                                                        {
+                                                            name: 'inner',
+                                                            type: {
+                                                                kind: 'integer',
+                                                                sign: 'unsigned',
+                                                                width: 32
+                                                            }
+                                                        }
+                                                    ]
+                                                }
+                                            },
+                                            {
+                                                name: 'target_address',
+                                                type: {
+                                                    kind: 'struct',
+                                                    path: 'authwit::aztec::protocol_types::address::AztecAddress',
+                                                    fields: [
+                                                        {
+                                                            name: 'inner',
+                                                            type: {
+                                                                kind: 'field'
+                                                            }
+                                                        }
+                                                    ]
+                                                }
+                                            },
+                                            {
+                                                name: 'is_public',
+                                                type: {
+                                                    kind: 'boolean'
+                                                }
+                                            },
+                                            {
+                                                name: 'hide_msg_sender',
+                                                type: {
+                                                    kind: 'boolean'
+                                                }
+                                            },
+                                            {
+                                                name: 'is_static',
+                                                type: {
+                                                    kind: 'boolean'
+                                                }
+                                            }
+                                        ]
+                                    }
+                                }
+                            },
+                            {
+                                name: 'tx_nonce',
+                                type: {
+                                    kind: 'field'
+                                }
+                            }
+                        ]
+                    },
+                    visibility: 'public'
+                },
+                {
+                    name: 'fee_payment_method',
+                    type: {
+                        kind: 'integer',
+                        sign: 'unsigned',
+                        width: 8
+                    }
+                },
+                {
+                    name: 'cancellable',
+                    type: {
+                        kind: 'boolean'
+                    }
+                }
+            ],
+            errorTypes: {}
+        };
+    }
+}

package/dest/constants.d.ts

@@ -0,0 +1,5 @@
+/** Default L1 chain ID to use when constructing txs (matches hardhat and anvil's default). */
+export declare const DEFAULT_CHAIN_ID = 31337;
+/** Default protocol version to use. */
+export declare const DEFAULT_VERSION = 1;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uc3RhbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLDhGQUE4RjtBQUM5RixlQUFPLE1BQU0sZ0JBQWdCLFFBQVEsQ0FBQztBQUN0Qyx1Q0FBdUM7QUFDdkMsZUFBTyxNQUFNLGVBQWUsSUFBSSxDQUFDIn0=

package/dest/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,uCAAuC;AACvC,eAAO,MAAM,eAAe,IAAI,CAAC"}

package/dest/constants.js

@@ -0,0 +1,2 @@
+/** Default L1 chain ID to use when constructing txs (matches hardhat and anvil's default). */ export const DEFAULT_CHAIN_ID = 31337;
+/** Default protocol version to use. */ export const DEFAULT_VERSION = 1;

package/dest/default_entrypoint.d.ts

@@ -0,0 +1,11 @@
+import type { GasSettings } from '@aztec-labs/stdlib/gas';
+import { ExecutionPayload, TxExecutionRequest } from '@aztec-labs/stdlib/tx';
+import type { ChainInfo, EntrypointInterface } from './interfaces.js';
+/**
+ * Default implementation of the entrypoint interface. It calls a function on a contract directly
+ */
+export declare class DefaultEntrypoint implements EntrypointInterface {
+    createTxExecutionRequest(exec: ExecutionPayload, gasSettings: GasSettings, chainInfo: ChainInfo): Promise<TxExecutionRequest>;
+    wrapExecutionPayload(exec: ExecutionPayload, _chainInfo: ChainInfo, _options?: any): Promise<ExecutionPayload>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVmYXVsdF9lbnRyeXBvaW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZGVmYXVsdF9lbnRyeXBvaW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzFELE9BQU8sRUFBRSxnQkFBZ0IsRUFBMkIsa0JBQWtCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUV0RyxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUV0RTs7R0FFRztBQUNILHFCQUFhLGlCQUFrQixZQUFXLG1CQUFtQjtJQUNyRCx3QkFBd0IsQ0FDNUIsSUFBSSxFQUFFLGdCQUFnQixFQUN0QixXQUFXLEVBQUUsV0FBVyxFQUN4QixTQUFTLEVBQUUsU0FBUyxHQUNuQixPQUFPLENBQUMsa0JBQWtCLENBQUMsQ0EyQjdCO0lBRUssb0JBQW9CLENBQUMsSUFBSSxFQUFFLGdCQUFnQixFQUFFLFVBQVUsRUFBRSxTQUFTLEVBQUUsUUFBUSxDQUFDLEVBQUUsR0FBRyxHQUFHLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQWdCbkg7Q0FDRiJ9

package/dest/default_entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default_entrypoint.d.ts","sourceRoot":"","sources":["../src/default_entrypoint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAA2B,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEtG,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;GAEG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IACrD,wBAAwB,CAC5B,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,kBAAkB,CAAC,CA2B7B;IAEK,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgBnH;CACF"}

package/dest/default_entrypoint.js

@@ -0,0 +1,39 @@
+import { FunctionType } from '@aztec-labs/stdlib/abi';
+import { ExecutionPayload, HashedValues, TxContext, TxExecutionRequest } from '@aztec-labs/stdlib/tx';
+/**
+ * Default implementation of the entrypoint interface. It calls a function on a contract directly
+ */ export class DefaultEntrypoint {
+    async createTxExecutionRequest(exec, gasSettings, chainInfo) {
+        // Initial request with calls, authWitnesses and capsules
+        const { calls, authWitnesses, capsules, extraHashedArgs } = exec;
+        if (calls.length > 1) {
+            throw new Error(`Expected a single call, got ${calls.length}`);
+        }
+        const call = calls[0];
+        // Hash the arguments for the function call
+        const hashedArguments = [
+            await HashedValues.fromArgs(call.args)
+        ];
+        if (call.type !== FunctionType.PRIVATE) {
+            throw new Error('Public entrypoints are not allowed');
+        }
+        // Assemble the tx request
+        return new TxExecutionRequest(call.to, call.selector, hashedArguments[0].hash, new TxContext(chainInfo.chainId.toNumber(), chainInfo.version.toNumber(), gasSettings), [
+            ...hashedArguments,
+            ...extraHashedArgs
+        ], authWitnesses, capsules);
+    }
+    async wrapExecutionPayload(exec, _chainInfo, _options) {
+        if (exec.calls.length !== 1) {
+            throw new Error(`DefaultEntrypoint can only wrap a single call, got ${exec.calls.length}`);
+        }
+        const call = exec.calls[0];
+        const hashedArguments = await HashedValues.fromArgs(call.args);
+        return new ExecutionPayload([
+            call
+        ], exec.authWitnesses, exec.capsules, [
+            hashedArguments,
+            ...exec.extraHashedArgs
+        ], exec.feePayer);
+    }
+}

package/dest/default_multi_call_entrypoint.d.ts

@@ -0,0 +1,16 @@
+import type { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { GasSettings } from '@aztec-labs/stdlib/gas';
+import { ExecutionPayload, TxExecutionRequest } from '@aztec-labs/stdlib/tx';
+import type { ChainInfo, EntrypointInterface } from './interfaces.js';
+/**
+ * Implementation for an entrypoint interface that can execute multiple function calls in a single transaction
+ */
+export declare class DefaultMultiCallEntrypoint implements EntrypointInterface {
+    #private;
+    private address;
+    constructor(address?: AztecAddress);
+    createTxExecutionRequest(exec: ExecutionPayload, gasSettings: GasSettings, chainInfo: ChainInfo): Promise<TxExecutionRequest>;
+    wrapExecutionPayload(exec: ExecutionPayload, _chainInfo: ChainInfo, _options?: any): Promise<ExecutionPayload>;
+    private getEntrypointAbi;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVmYXVsdF9tdWx0aV9jYWxsX2VudHJ5cG9pbnQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9kZWZhdWx0X211bHRpX2NhbGxfZW50cnlwb2ludC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFTQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNyRSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUMxRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQTJCLGtCQUFrQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFHdEcsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLG1CQUFtQixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFdEU7O0dBRUc7QUFDSCxxQkFBYSwwQkFBMkIsWUFBVyxtQkFBbUI7O0lBQ3hELE9BQU8sQ0FBQyxPQUFPO0lBQTNCLFlBQW9CLE9BQU8sR0FBRSxZQUFxRCxFQUFJO0lBRWhGLHdCQUF3QixDQUM1QixJQUFJLEVBQUUsZ0JBQWdCLEVBQ3RCLFdBQVcsRUFBRSxXQUFXLEVBQ3hCLFNBQVMsRUFBRSxTQUFTLEdBQ25CLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQWlCN0I7SUFFSyxvQkFBb0IsQ0FBQyxJQUFJLEVBQUUsZ0JBQWdCLEVBQUUsVUFBVSxFQUFFLFNBQVMsRUFBRSxRQUFRLENBQUMsRUFBRSxHQUFHLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBcUJuSDtJQTBCRCxPQUFPLENBQUMsZ0JBQWdCO0NBd0R6QiJ9

package/dest/default_multi_call_entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default_multi_call_entrypoint.d.ts","sourceRoot":"","sources":["../src/default_multi_call_entrypoint.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAA2B,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGtG,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;GAEG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;;IACxD,OAAO,CAAC,OAAO;IAA3B,YAAoB,OAAO,GAAE,YAAqD,EAAI;IAEhF,wBAAwB,CAC5B,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAiB7B;IAEK,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqBnH;IA0BD,OAAO,CAAC,gBAAgB;CAwDzB"}

package/dest/default_multi_call_entrypoint.js

@@ -0,0 +1,170 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS } from '@aztec-labs/standard-contracts/multi-call-entrypoint/constants';
+import { FunctionCall, FunctionSelector, encodeArguments, getFunctionReturnType } from '@aztec-labs/stdlib/abi';
+import { ExecutionPayload, HashedValues, TxContext, TxExecutionRequest } from '@aztec-labs/stdlib/tx';
+import { EncodedAppEntrypointCalls } from './encoding.js';
+/**
+ * Implementation for an entrypoint interface that can execute multiple function calls in a single transaction
+ */ export class DefaultMultiCallEntrypoint {
+    address;
+    constructor(address = STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS){
+        this.address = address;
+    }
+    async createTxExecutionRequest(exec, gasSettings, chainInfo) {
+        const { authWitnesses, capsules, extraHashedArgs } = exec;
+        const callData = await this.#buildEntrypointCallData(exec);
+        const entrypointHashedArgs = await HashedValues.fromArgs(callData.encodedArgs);
+        const txRequest = TxExecutionRequest.from({
+            firstCallArgsHash: entrypointHashedArgs.hash,
+            origin: this.address,
+            functionSelector: callData.functionSelector,
+            txContext: new TxContext(chainInfo.chainId.toNumber(), chainInfo.version.toNumber(), gasSettings),
+            argsOfCalls: [
+                ...callData.encodedCalls.hashedArguments,
+                entrypointHashedArgs,
+                ...extraHashedArgs
+            ],
+            authWitnesses,
+            capsules,
+            salt: Fr.random()
+        });
+        return Promise.resolve(txRequest);
+    }
+    async wrapExecutionPayload(exec, _chainInfo, _options) {
+        const { authWitnesses, capsules, extraHashedArgs } = exec;
+        const callData = await this.#buildEntrypointCallData(exec);
+        const entrypointCall = FunctionCall.from({
+            name: callData.abi.name,
+            to: this.address,
+            selector: callData.functionSelector,
+            type: callData.abi.functionType,
+            hideMsgSender: false,
+            isStatic: callData.abi.isStatic,
+            args: callData.encodedArgs,
+            returnType: getFunctionReturnType(callData.abi)
+        });
+        return new ExecutionPayload([
+            entrypointCall
+        ], authWitnesses, capsules, [
+            ...callData.encodedCalls.hashedArguments,
+            ...extraHashedArgs
+        ], exec.feePayer);
+    }
+    /**
+   * Builds the shared data needed for both creating a tx execution request and wrapping an execution payload.
+   * This includes encoding calls and building entrypoint arguments.
+   * @param exec - The execution payload containing calls to encode
+   * @returns Encoded call data, ABI, encoded arguments, and function selector
+   */ async #buildEntrypointCallData(exec) {
+        const { calls } = exec;
+        const encodedCalls = await EncodedAppEntrypointCalls.create(calls);
+        const abi = this.getEntrypointAbi();
+        const encodedArgs = encodeArguments(abi, [
+            encodedCalls
+        ]);
+        const functionSelector = await FunctionSelector.fromNameAndParameters(abi.name, abi.parameters);
+        return {
+            encodedCalls,
+            abi,
+            encodedArgs,
+            functionSelector
+        };
+    }
+    getEntrypointAbi() {
+        return {
+            name: 'entrypoint',
+            isInitializer: false,
+            functionType: 'private',
+            isOnlySelf: false,
+            isStatic: false,
+            parameters: [
+                {
+                    name: 'app_payload',
+                    type: {
+                        kind: 'struct',
+                        path: 'authwit::entrypoint::app::AppPayload',
+                        fields: [
+                            {
+                                name: 'function_calls',
+                                type: {
+                                    kind: 'array',
+                                    length: 5,
+                                    type: {
+                                        kind: 'struct',
+                                        path: 'authwit::entrypoint::function_call::FunctionCall',
+                                        fields: [
+                                            {
+                                                name: 'args_hash',
+                                                type: {
+                                                    kind: 'field'
+                                                }
+                                            },
+                                            {
+                                                name: 'function_selector',
+                                                type: {
+                                                    kind: 'struct',
+                                                    path: 'authwit::aztec::protocol_types::abis::function_selector::FunctionSelector',
+                                                    fields: [
+                                                        {
+                                                            name: 'inner',
+                                                            type: {
+                                                                kind: 'integer',
+                                                                sign: 'unsigned',
+                                                                width: 32
+                                                            }
+                                                        }
+                                                    ]
+                                                }
+                                            },
+                                            {
+                                                name: 'target_address',
+                                                type: {
+                                                    kind: 'struct',
+                                                    path: 'authwit::aztec::protocol_types::address::AztecAddress',
+                                                    fields: [
+                                                        {
+                                                            name: 'inner',
+                                                            type: {
+                                                                kind: 'field'
+                                                            }
+                                                        }
+                                                    ]
+                                                }
+                                            },
+                                            {
+                                                name: 'is_public',
+                                                type: {
+                                                    kind: 'boolean'
+                                                }
+                                            },
+                                            {
+                                                name: 'hide_msg_sender',
+                                                type: {
+                                                    kind: 'boolean'
+                                                }
+                                            },
+                                            {
+                                                name: 'is_static',
+                                                type: {
+                                                    kind: 'boolean'
+                                                }
+                                            }
+                                        ]
+                                    }
+                                }
+                            },
+                            {
+                                name: 'tx_nonce',
+                                type: {
+                                    kind: 'field'
+                                }
+                            }
+                        ]
+                    },
+                    visibility: 'public'
+                }
+            ],
+            errorTypes: {}
+        };
+    }
+}