@aztec-labs/aztec.js 6.0.0-nightly.20260829

package/dest/fee/fee_payment_method.d.ts

@@ -0,0 +1,26 @@
+import type { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { GasSettings } from '@aztec-labs/stdlib/gas';
+import type { ExecutionPayload } from '@aztec-labs/stdlib/tx';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */
+export interface FeePaymentMethod {
+    /** The asset used to pay the fee. */
+    getAsset(): Promise<AztecAddress>;
+    /**
+     * Returns the data to be added to the final execution request
+     * to pay the fee in the given asset
+     * @returns The function calls to pay the fee.
+     */
+    getExecutionPayload(): Promise<ExecutionPayload>;
+    /**
+     * The expected fee payer for this tx.
+     */
+    getFeePayer(): Promise<AztecAddress>;
+    /**
+     * The gas settings (if any) used to compute the
+     * execution payload of the payment method
+     */
+    getGasSettings(): GasSettings | undefined;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVlX3BheW1lbnRfbWV0aG9kLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZmVlL2ZlZV9wYXltZW50X21ldGhvZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNyRSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBRTlEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGdCQUFnQjtJQUMvQixxQ0FBcUM7SUFDckMsUUFBUSxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsQ0FBQztJQUNsQzs7OztPQUlHO0lBQ0gsbUJBQW1CLElBQUksT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBQUM7SUFDakQ7O09BRUc7SUFDSCxXQUFXLElBQUksT0FBTyxDQUFDLFlBQVksQ0FBQyxDQUFDO0lBQ3JDOzs7T0FHRztJQUNILGNBQWMsSUFBSSxXQUFXLEdBQUcsU0FBUyxDQUFDO0NBQzNDIn0=

package/dest/fee/fee_payment_method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee_payment_method.d.ts","sourceRoot":"","sources":["../../src/fee/fee_payment_method.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAClC;;;;OAIG;IACH,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjD;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC;;;OAGG;IACH,cAAc,IAAI,WAAW,GAAG,SAAS,CAAC;CAC3C"}

package/dest/fee/fee_payment_method.js

@@ -0,0 +1,3 @@
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */ export { };

package/dest/fee/private_fee_payment_method.d.ts

@@ -0,0 +1,69 @@
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { GasSettings } from '@aztec-labs/stdlib/gas';
+import { ExecutionPayload } from '@aztec-labs/stdlib/tx';
+import type { Wallet } from '../wallet/wallet.js';
+import type { FeePaymentMethod } from './fee_payment_method.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ * @deprecated Is not supported on mainnet. Use {@link FeeJuicePaymentMethodWithClaim} or `SponsoredFeePaymentMethod` instead.
+ */
+export declare class PrivateFeePaymentMethod implements FeePaymentMethod {
+    /**
+     * Address which will hold the fee payment.
+     */
+    private paymentContract;
+    /**
+     * Address of the account that will pay the fee
+     */
+    private sender;
+    /**
+     * A wallet to perform the simulation to get the accepted asset
+     */
+    private wallet;
+    /**
+     * Gas settings used to compute the maximum fee the user is willing to pay
+     */
+    protected gasSettings: GasSettings;
+    /**
+     * If true, the max fee will be set to 1.
+     * TODO(#7694): Remove this param once the lacking feature in TXE is implemented.
+     */
+    private setMaxFeeToOne;
+    private assetPromise;
+    constructor(
+    /**
+     * Address which will hold the fee payment.
+     */
+    paymentContract: AztecAddress, 
+    /**
+     * Address of the account that will pay the fee
+     */
+    sender: AztecAddress, 
+    /**
+     * A wallet to perform the simulation to get the accepted asset
+     */
+    wallet: Wallet, 
+    /**
+     * Gas settings used to compute the maximum fee the user is willing to pay
+     */
+    gasSettings: GasSettings, 
+    /**
+     * If true, the max fee will be set to 1.
+     * TODO(#7694): Remove this param once the lacking feature in TXE is implemented.
+     */
+    setMaxFeeToOne?: boolean);
+    /**
+     * The asset used to pay the fee.
+     * @returns The asset used to pay the fee.
+     */
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    /**
+     * Creates an execution payload to pay the fee using a private function through an FPC in the desired asset
+     * @param gasSettings - The gas settings.
+     * @returns An execution payload that contains the required function calls and auth witnesses.
+     */
+    getExecutionPayload(): Promise<ExecutionPayload>;
+    getGasSettings(): GasSettings | undefined;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJpdmF0ZV9mZWVfcGF5bWVudF9tZXRob2QuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9mZWUvcHJpdmF0ZV9mZWVfcGF5bWVudF9tZXRob2QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBU0EsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGtDQUFrQyxDQUFDO0FBQ2hFLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzFELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBSXpELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ2xELE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFaEU7OztHQUdHO0FBQ0gscUJBQWEsdUJBQXdCLFlBQVcsZ0JBQWdCO0lBSTVEOztPQUVHO0lBQ0gsT0FBTyxDQUFDLGVBQWU7SUFFdkI7O09BRUc7SUFDSCxPQUFPLENBQUMsTUFBTTtJQUVkOztPQUVHO0lBQ0gsT0FBTyxDQUFDLE1BQU07SUFDZDs7T0FFRztJQUNILFNBQVMsQ0FBQyxXQUFXLEVBQUUsV0FBVztJQUNsQzs7O09BR0c7SUFDSCxPQUFPLENBQUMsY0FBYztJQXpCeEIsT0FBTyxDQUFDLFlBQVksQ0FBc0M7SUFFMUQ7SUFDRTs7T0FFRztJQUNLLGVBQWUsRUFBRSxZQUFZO0lBRXJDOztPQUVHO0lBQ0ssTUFBTSxFQUFFLFlBQVk7SUFFNUI7O09BRUc7SUFDSyxNQUFNLEVBQUUsTUFBTTtJQUN0Qjs7T0FFRztJQUNPLFdBQVcsRUFBRSxXQUFXO0lBQ2xDOzs7T0FHRztJQUNLLGNBQWMsVUFBUSxFQUM1QjtJQUVKOzs7T0FHRztJQUNHLFFBQVEsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLENBcUN0QztJQUVELFdBQVcsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLENBRW5DO0lBRUQ7Ozs7T0FJRztJQUNHLG1CQUFtQixJQUFJLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQW9DckQ7SUFFRCxjQUFjLElBQUksV0FBVyxHQUFHLFNBQVMsQ0FFeEM7Q0FDRiJ9

package/dest/fee/private_fee_payment_method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private_fee_payment_method.d.ts","sourceRoot":"","sources":["../../src/fee/private_fee_payment_method.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAI5D;;OAEG;IACH,OAAO,CAAC,eAAe;IAEvB;;OAEG;IACH,OAAO,CAAC,MAAM;IAEd;;OAEG;IACH,OAAO,CAAC,MAAM;IACd;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,WAAW;IAClC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAzBxB,OAAO,CAAC,YAAY,CAAsC;IAE1D;IACE;;OAEG;IACK,eAAe,EAAE,YAAY;IAErC;;OAEG;IACK,MAAM,EAAE,YAAY;IAE5B;;OAEG;IACK,MAAM,EAAE,MAAM;IACtB;;OAEG;IACO,WAAW,EAAE,WAAW;IAClC;;;OAGG;IACK,cAAc,UAAQ,EAC5B;IAEJ;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAqCtC;IAED,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAEnC;IAED;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAoCrD;IAED,cAAc,IAAI,WAAW,GAAG,SAAS,CAExC;CACF"}

package/dest/fee/private_fee_payment_method.js

@@ -0,0 +1,122 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { FunctionCall, FunctionSelector, FunctionType, decodeFromAbi, getFunctionReturnType } from '@aztec-labs/stdlib/abi';
+import { ExecutionPayload } from '@aztec-labs/stdlib/tx';
+import { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
+import { NO_FROM } from '../contract/interaction_options.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ * @deprecated Is not supported on mainnet. Use {@link FeeJuicePaymentMethodWithClaim} or `SponsoredFeePaymentMethod` instead.
+ */ export class PrivateFeePaymentMethod {
+    paymentContract;
+    sender;
+    wallet;
+    gasSettings;
+    setMaxFeeToOne;
+    assetPromise;
+    constructor(/**
+     * Address which will hold the fee payment.
+     */ paymentContract, /**
+     * Address of the account that will pay the fee
+     */ sender, /**
+     * A wallet to perform the simulation to get the accepted asset
+     */ wallet, /**
+     * Gas settings used to compute the maximum fee the user is willing to pay
+     */ gasSettings, /**
+     * If true, the max fee will be set to 1.
+     * TODO(#7694): Remove this param once the lacking feature in TXE is implemented.
+     */ setMaxFeeToOne = false){
+        this.paymentContract = paymentContract;
+        this.sender = sender;
+        this.wallet = wallet;
+        this.gasSettings = gasSettings;
+        this.setMaxFeeToOne = setMaxFeeToOne;
+        this.assetPromise = null;
+    }
+    /**
+   * The asset used to pay the fee.
+   * @returns The asset used to pay the fee.
+   */ async getAsset() {
+        if (!this.assetPromise) {
+            const abi = {
+                name: 'get_accepted_asset',
+                functionType: FunctionType.PRIVATE,
+                isOnlySelf: false,
+                isStatic: false,
+                parameters: [],
+                returnType: {
+                    kind: 'struct',
+                    path: 'authwit::aztec::protocol_types::address::aztec_address::AztecAddress',
+                    fields: [
+                        {
+                            name: 'inner',
+                            type: {
+                                kind: 'field'
+                            }
+                        }
+                    ]
+                },
+                errorTypes: {},
+                isInitializer: false
+            };
+            const interaction = new ContractFunctionInteraction(this.wallet, this.paymentContract, abi, []);
+            const executionPayload = await interaction.request();
+            this.assetPromise = this.wallet.simulateTx(executionPayload, {
+                from: NO_FROM,
+                skipFeeEnforcement: true
+            }).then((simulationResult)=>{
+                const rawReturnValues = simulationResult.getPrivateReturnValues().values;
+                return decodeFromAbi(getFunctionReturnType(abi), rawReturnValues);
+            });
+        }
+        return this.assetPromise;
+    }
+    getFeePayer() {
+        return Promise.resolve(this.paymentContract);
+    }
+    /**
+   * Creates an execution payload to pay the fee using a private function through an FPC in the desired asset
+   * @param gasSettings - The gas settings.
+   * @returns An execution payload that contains the required function calls and auth witnesses.
+   */ async getExecutionPayload() {
+        // We assume 1:1 exchange rate between fee juice and token. But in reality you would need to convert feeLimit
+        // (maxFee) to be in token denomination.
+        const maxFee = this.setMaxFeeToOne ? Fr.ONE : this.gasSettings.getFeeLimit();
+        const txNonce = Fr.random();
+        const witness = await this.wallet.createAuthWit(this.sender, {
+            caller: this.paymentContract,
+            call: FunctionCall.from({
+                name: 'transfer_to_public',
+                to: await this.getAsset(),
+                selector: await FunctionSelector.fromSignature('transfer_to_public((Field),(Field),u128,Field)'),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [
+                    this.sender.toField(),
+                    this.paymentContract.toField(),
+                    maxFee,
+                    txNonce
+                ]
+            })
+        });
+        return new ExecutionPayload([
+            FunctionCall.from({
+                name: 'fee_entrypoint_private',
+                to: this.paymentContract,
+                selector: await FunctionSelector.fromSignature('fee_entrypoint_private(u128,Field)'),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [
+                    maxFee,
+                    txNonce
+                ]
+            })
+        ], [
+            witness
+        ], [], [], this.paymentContract);
+    }
+    getGasSettings() {
+        return this.gasSettings;
+    }
+}

package/dest/fee/public_fee_payment_method.d.ts

@@ -0,0 +1,59 @@
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import { GasSettings } from '@aztec-labs/stdlib/gas';
+import { ExecutionPayload } from '@aztec-labs/stdlib/tx';
+import type { Wallet } from '../wallet/wallet.js';
+import type { FeePaymentMethod } from './fee_payment_method.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ * @deprecated Is not supported on mainnet. Use {@link FeeJuicePaymentMethodWithClaim} or `SponsoredFeePaymentMethod` instead.
+ */
+export declare class PublicFeePaymentMethod implements FeePaymentMethod {
+    /**
+     * Address which will hold the fee payment.
+     */
+    protected paymentContract: AztecAddress;
+    /**
+     * An auth witness provider to authorize fee payments
+     */
+    protected sender: AztecAddress;
+    /**
+     * A wallet to perform the simulation to get the accepted asset
+     */
+    protected wallet: Wallet;
+    /**
+     * Gas settings used to compute the maximum fee the user is willing to pay
+     */
+    protected gasSettings: GasSettings;
+    private assetPromise;
+    constructor(
+    /**
+     * Address which will hold the fee payment.
+     */
+    paymentContract: AztecAddress, 
+    /**
+     * An auth witness provider to authorize fee payments
+     */
+    sender: AztecAddress, 
+    /**
+     * A wallet to perform the simulation to get the accepted asset
+     */
+    wallet: Wallet, 
+    /**
+     * Gas settings used to compute the maximum fee the user is willing to pay
+     */
+    gasSettings: GasSettings);
+    /**
+     * The asset used to pay the fee.
+     * @returns The asset used to pay the fee.
+     */
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    /**
+     * Creates an execution payload to pay the fee using a public function through an FPC in the desired asset
+     * @param gasSettings - The gas settings.
+     * @returns An execution payload that contains the required function calls.
+     */
+    getExecutionPayload(): Promise<ExecutionPayload>;
+    getGasSettings(): GasSettings | undefined;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHVibGljX2ZlZV9wYXltZW50X21ldGhvZC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ZlZS9wdWJsaWNfZmVlX3BheW1lbnRfbWV0aG9kLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQVNBLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNoRSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDckQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFLekQsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDbEQsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUVoRTs7O0dBR0c7QUFDSCxxQkFBYSxzQkFBdUIsWUFBVyxnQkFBZ0I7SUFJM0Q7O09BRUc7SUFDSCxTQUFTLENBQUMsZUFBZSxFQUFFLFlBQVk7SUFDdkM7O09BRUc7SUFDSCxTQUFTLENBQUMsTUFBTSxFQUFFLFlBQVk7SUFDOUI7O09BRUc7SUFDSCxTQUFTLENBQUMsTUFBTSxFQUFFLE1BQU07SUFDeEI7O09BRUc7SUFDSCxTQUFTLENBQUMsV0FBVyxFQUFFLFdBQVc7SUFsQnBDLE9BQU8sQ0FBQyxZQUFZLENBQXNDO0lBRTFEO0lBQ0U7O09BRUc7SUFDTyxlQUFlLEVBQUUsWUFBWTtJQUN2Qzs7T0FFRztJQUNPLE1BQU0sRUFBRSxZQUFZO0lBQzlCOztPQUVHO0lBQ08sTUFBTSxFQUFFLE1BQU07SUFDeEI7O09BRUc7SUFDTyxXQUFXLEVBQUUsV0FBVyxFQUNoQztJQUVKOzs7T0FHRztJQUNHLFFBQVEsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLENBcUN0QztJQUVELFdBQVcsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLENBRW5DO0lBRUQ7Ozs7T0FJRztJQUNHLG1CQUFtQixJQUFJLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQTBDckQ7SUFFRCxjQUFjLElBQUksV0FBVyxHQUFHLFNBQVMsQ0FFeEM7Q0FDRiJ9

package/dest/fee/public_fee_payment_method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_fee_payment_method.d.ts","sourceRoot":"","sources":["../../src/fee/public_fee_payment_method.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAKzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAI3D;;OAEG;IACH,SAAS,CAAC,eAAe,EAAE,YAAY;IACvC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY;IAC9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;IACxB;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,WAAW;IAlBpC,OAAO,CAAC,YAAY,CAAsC;IAE1D;IACE;;OAEG;IACO,eAAe,EAAE,YAAY;IACvC;;OAEG;IACO,MAAM,EAAE,YAAY;IAC9B;;OAEG;IACO,MAAM,EAAE,MAAM;IACxB;;OAEG;IACO,WAAW,EAAE,WAAW,EAChC;IAEJ;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAqCtC;IAED,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAEnC;IAED;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA0CrD;IAED,cAAc,IAAI,WAAW,GAAG,SAAS,CAExC;CACF"}

package/dest/fee/public_fee_payment_method.js

@@ -0,0 +1,116 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { FunctionCall, FunctionSelector, FunctionType, decodeFromAbi, getFunctionReturnType } from '@aztec-labs/stdlib/abi';
+import { ExecutionPayload } from '@aztec-labs/stdlib/tx';
+import { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
+import { NO_FROM } from '../contract/interaction_options.js';
+import { SetPublicAuthwitContractInteraction } from '../utils/authwit.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ * @deprecated Is not supported on mainnet. Use {@link FeeJuicePaymentMethodWithClaim} or `SponsoredFeePaymentMethod` instead.
+ */ export class PublicFeePaymentMethod {
+    paymentContract;
+    sender;
+    wallet;
+    gasSettings;
+    assetPromise;
+    constructor(/**
+     * Address which will hold the fee payment.
+     */ paymentContract, /**
+     * An auth witness provider to authorize fee payments
+     */ sender, /**
+     * A wallet to perform the simulation to get the accepted asset
+     */ wallet, /**
+     * Gas settings used to compute the maximum fee the user is willing to pay
+     */ gasSettings){
+        this.paymentContract = paymentContract;
+        this.sender = sender;
+        this.wallet = wallet;
+        this.gasSettings = gasSettings;
+        this.assetPromise = null;
+    }
+    /**
+   * The asset used to pay the fee.
+   * @returns The asset used to pay the fee.
+   */ async getAsset() {
+        if (!this.assetPromise) {
+            const abi = {
+                name: 'get_accepted_asset',
+                functionType: FunctionType.PRIVATE,
+                isOnlySelf: false,
+                isStatic: false,
+                parameters: [],
+                returnType: {
+                    kind: 'struct',
+                    path: 'authwit::aztec::protocol_types::address::aztec_address::AztecAddress',
+                    fields: [
+                        {
+                            name: 'inner',
+                            type: {
+                                kind: 'field'
+                            }
+                        }
+                    ]
+                },
+                errorTypes: {},
+                isInitializer: false
+            };
+            const interaction = new ContractFunctionInteraction(this.wallet, this.paymentContract, abi, []);
+            const executionPayload = await interaction.request();
+            this.assetPromise = this.wallet.simulateTx(executionPayload, {
+                from: NO_FROM,
+                skipFeeEnforcement: true
+            }).then((simulationResult)=>{
+                const rawReturnValues = simulationResult.getPrivateReturnValues().values;
+                return decodeFromAbi(getFunctionReturnType(abi), rawReturnValues);
+            });
+        }
+        return this.assetPromise;
+    }
+    getFeePayer() {
+        return Promise.resolve(this.paymentContract);
+    }
+    /**
+   * Creates an execution payload to pay the fee using a public function through an FPC in the desired asset
+   * @param gasSettings - The gas settings.
+   * @returns An execution payload that contains the required function calls.
+   */ async getExecutionPayload() {
+        const txNonce = Fr.random();
+        const maxFee = this.gasSettings.getFeeLimit();
+        const intent = {
+            caller: this.paymentContract,
+            call: FunctionCall.from({
+                name: 'transfer_in_public',
+                to: await this.getAsset(),
+                selector: await FunctionSelector.fromSignature('transfer_in_public((Field),(Field),u128,Field)'),
+                type: FunctionType.PUBLIC,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [
+                    this.sender.toField(),
+                    this.paymentContract.toField(),
+                    maxFee,
+                    txNonce
+                ]
+            })
+        };
+        const setPublicAuthWitInteraction = await SetPublicAuthwitContractInteraction.create(this.wallet, this.sender, intent, true);
+        return new ExecutionPayload([
+            ...(await setPublicAuthWitInteraction.request()).calls,
+            FunctionCall.from({
+                name: 'fee_entrypoint_public',
+                to: this.paymentContract,
+                selector: await FunctionSelector.fromSignature('fee_entrypoint_public(u128,Field)'),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [
+                    maxFee,
+                    txNonce
+                ]
+            })
+        ], [], [], [], this.paymentContract);
+    }
+    getGasSettings() {
+        return this.gasSettings;
+    }
+}

package/dest/fee/sponsored_fee_payment.d.ts

@@ -0,0 +1,17 @@
+import type { FeePaymentMethod } from '@aztec-labs/aztec.js/fee';
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { GasSettings } from '@aztec-labs/stdlib/gas';
+import { ExecutionPayload } from '@aztec-labs/stdlib/tx';
+/**
+ * A fee payment method that uses a contract that blindly sponsors transactions.
+ * This contract is expected to be prefunded in testing environments.
+ */
+export declare class SponsoredFeePaymentMethod implements FeePaymentMethod {
+    private paymentContract;
+    constructor(paymentContract: AztecAddress);
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    getExecutionPayload(): Promise<ExecutionPayload>;
+    getGasSettings(): GasSettings | undefined;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3BvbnNvcmVkX2ZlZV9wYXltZW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZmVlL3Nwb25zb3JlZF9mZWVfcGF5bWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRWpFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUMxRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUV6RDs7O0dBR0c7QUFDSCxxQkFBYSx5QkFBMEIsWUFBVyxnQkFBZ0I7SUFDcEQsT0FBTyxDQUFDLGVBQWU7SUFBbkMsWUFBb0IsZUFBZSxFQUFFLFlBQVksRUFBSTtJQUVyRCxRQUFRLElBQUksT0FBTyxDQUFDLFlBQVksQ0FBQyxDQUVoQztJQUVELFdBQVcsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLENBRW5DO0lBRUssbUJBQW1CLElBQUksT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBa0JyRDtJQUVELGNBQWMsSUFBSSxXQUFXLEdBQUcsU0FBUyxDQUV4QztDQUNGIn0=

package/dest/fee/sponsored_fee_payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sponsored_fee_payment.d.ts","sourceRoot":"","sources":["../../src/fee/sponsored_fee_payment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IACpD,OAAO,CAAC,eAAe;IAAnC,YAAoB,eAAe,EAAE,YAAY,EAAI;IAErD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAEhC;IAED,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAEnC;IAEK,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAkBrD;IAED,cAAc,IAAI,WAAW,GAAG,SAAS,CAExC;CACF"}

package/dest/fee/sponsored_fee_payment.js

@@ -0,0 +1,33 @@
+import { FunctionCall, FunctionSelector, FunctionType } from '@aztec-labs/stdlib/abi';
+import { ExecutionPayload } from '@aztec-labs/stdlib/tx';
+/**
+ * A fee payment method that uses a contract that blindly sponsors transactions.
+ * This contract is expected to be prefunded in testing environments.
+ */ export class SponsoredFeePaymentMethod {
+    paymentContract;
+    constructor(paymentContract){
+        this.paymentContract = paymentContract;
+    }
+    getAsset() {
+        throw new Error('Asset is not required for sponsored fpc.');
+    }
+    getFeePayer() {
+        return Promise.resolve(this.paymentContract);
+    }
+    async getExecutionPayload() {
+        return new ExecutionPayload([
+            FunctionCall.from({
+                name: 'sponsor_unconditionally',
+                to: this.paymentContract,
+                selector: await FunctionSelector.fromSignature('sponsor_unconditionally()'),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: []
+            })
+        ], [], [], [], this.paymentContract);
+    }
+    getGasSettings() {
+        return;
+    }
+}

package/dest/scripts/generate_protocol_contract_types.d.ts

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

package/dest/scripts/generate_protocol_contract_types.d.ts.map

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

package/dest/scripts/generate_protocol_contract_types.js

@@ -0,0 +1,128 @@
+/**
+ * Generates type-safe contract wrappers for protocol contracts.
+ * These wrappers use a minimal artifact (without bytecode) since PXE already has the full artifacts registered.
+ */ import { generateTypescriptContractInterface } from '@aztec-labs/builder/codegen';
+import { fileURLToPath } from '@aztec-labs/foundation/url';
+import { FunctionType, getAllFunctionAbis, getFunctionReturnType, loadContractArtifact } from '@aztec-labs/stdlib/abi';
+import { promises as fs } from 'fs';
+import path from 'path';
+const log = console.log;
+const artifactsPkgRoot = path.dirname(fileURLToPath(import.meta.resolve('@aztec/protocol-contracts-artifacts/package.json')));
+const srcPath = path.join(artifactsPkgRoot, 'artifacts');
+const outputDir = path.join(import.meta.dirname, '../contract/protocol_contracts');
+function toKebabCase(str) {
+    return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+}
+function functionTypeToEnum(type) {
+    switch(type){
+        case FunctionType.PRIVATE:
+            return 'FunctionType.PRIVATE';
+        case FunctionType.PUBLIC:
+            return 'FunctionType.PUBLIC';
+        case FunctionType.UTILITY:
+            return 'FunctionType.UTILITY';
+    }
+}
+function generateFunctionAbiJson(abi) {
+    const baseObj = {
+        name: abi.name,
+        isOnlySelf: abi.isOnlySelf,
+        isStatic: abi.isStatic,
+        isInitializer: abi.isInitializer,
+        parameters: abi.parameters,
+        returnType: getFunctionReturnType(abi),
+        errorTypes: abi.errorTypes
+    };
+    const jsonStr = JSON.stringify(baseObj);
+    return jsonStr.replace('{', `{ functionType: ${functionTypeToEnum(abi.functionType)},`);
+}
+function generateProtocolContractArtifact(input) {
+    const allAbis = getAllFunctionAbis(input);
+    const functionAbis = input.functions.map((f)=>allAbis.find((abi)=>abi.name === f.name));
+    const nonDispatchAbis = input.nonDispatchPublicFunctions;
+    const functionsArray = functionAbis.map((abi)=>`{ ...${generateFunctionAbiJson(abi)}, bytecode: Buffer.from([]), debugSymbols: '' }`).join(',\n    ');
+    const nonDispatchArray = nonDispatchAbis.map((abi)=>generateFunctionAbiJson(abi)).join(',\n    ');
+    return `{
+  name: '${input.name}',
+  aztecVersion: '${input.aztecVersion}',
+  functions: [
+    ${functionsArray}
+  ],
+  nonDispatchPublicFunctions: [
+    ${nonDispatchArray}
+  ],
+  outputs: { structs: {}, globals: {} },
+  storageLayout: {},
+  fileMap: {},
+}`;
+}
+async function generateProtocolContractInterface(input, protocolContractName) {
+    const baseInterface = await generateTypescriptContractInterface(input);
+    // Match everything between "public declare methods: {" and the closing "};"
+    const methodsMatch = baseInterface.match(/public declare methods: \{([\s\S]*?)\n  \};/);
+    if (!methodsMatch) {
+        throw new Error('Could not extract methods from generated interface');
+    }
+    const artifactCode = generateProtocolContractArtifact(input);
+    const contractName = `${input.name}Contract`;
+    return `
+/* Autogenerated file, do not edit! */
+
+/* eslint-disable */
+import { ProtocolContractAddress } from '@aztec-labs/protocol-contracts';
+import { FunctionType } from '@aztec-labs/stdlib/abi';
+
+import type { ContractArtifact } from '../../api/abi.js';
+import { PublicKeys } from '../../api/keys.js';
+import type { AztecAddressLike, EthAddressLike, FieldLike, FunctionSelectorLike, OptionLike, WrappedFieldLike } from '../../utils/abi_types.js';
+import { ContractBase, type ContractMethod } from '../contract_base.js';
+import { ContractFunctionInteraction } from '../contract_function_interaction.js';
+import type { Wallet } from '../../wallet/wallet.js';
+
+const ${contractName}Artifact: ContractArtifact = ${artifactCode};
+
+export class ${contractName} extends ContractBase {
+  private constructor(wallet: Wallet) {
+    super(ProtocolContractAddress.${protocolContractName}, ${contractName}Artifact, wallet);
+  }
+
+  /** Returns an interface to the canonical ${contractName} instance, bound to the given wallet. */
+  public static withWallet(wallet: Wallet): ${contractName} {
+    return new ${contractName}(wallet);
+  }
+
+  /** @deprecated Use \`withWallet\` instead. */
+  public static at(wallet: Wallet): ${contractName} {
+    return ${contractName}.withWallet(wallet);
+  }
+
+  public declare methods: {${methodsMatch[1]}
+  };
+}
+`;
+}
+async function main() {
+    await fs.rm(outputDir, {
+        recursive: true,
+        force: true
+    });
+    await fs.mkdir(outputDir, {
+        recursive: true
+    });
+    const srcNames = JSON.parse(await fs.readFile(path.join(artifactsPkgRoot, 'protocol_contracts.json'), 'utf8'));
+    for (const srcName of srcNames){
+        // srcName is like "auth_registry_contract-AuthRegistry", split to get the contract name
+        const name = srcName.split('-')[1];
+        const artifactPath = path.join(srcPath, `${srcName}.json`);
+        const json = JSON.parse(await fs.readFile(artifactPath, 'utf8'));
+        const contractArtifact = loadContractArtifact(json);
+        const content = await generateProtocolContractInterface(contractArtifact, name);
+        const fileName = `${toKebabCase(name)}.ts`;
+        await fs.writeFile(path.join(outputDir, fileName), content);
+        log(`Generated ${fileName}`);
+    }
+}
+main().catch((err)=>{
+    console.error('Error generating protocol contract types:', err);
+    process.exit(1);
+});

package/dest/test/fixtures.d.ts

@@ -0,0 +1,13 @@
+import { type ContractArtifact } from '@aztec-labs/stdlib/abi';
+/**
+ * A minimal but representative `ContractArtifact` shared by unit tests in this package. Covers
+ * every function shape the tests exercise: a private initializer (`constructor`), the standard
+ * `public_dispatch` entry, a private function with mixed-visibility params (`bar`), a utility
+ * function (`qux`), and two functions exercising Noir `Option<Field>` parameters (`optionEcho`,
+ * `mixedParams`).
+ *
+ * We deliberately do not depend on `@aztec-labs/noir-test-contracts.js` here: that package depends on
+ * `@aztec-labs/aztec.js`, so importing from it would create a workspace cycle.
+ */
+export declare const testContractArtifact: ContractArtifact;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZml4dHVyZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0L2ZpeHR1cmVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBRSxLQUFLLGdCQUFnQixFQUFnQixNQUFNLHdCQUF3QixDQUFDO0FBRzdFOzs7Ozs7Ozs7R0FTRztBQUNILGVBQU8sTUFBTSxvQkFBb0IsRUFBRSxnQkE4R2xDLENBQUMifQ==

package/dest/test/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/test/fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,wBAAwB,CAAC;AAG7E;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBA8GlC,CAAC"}