@wonderland/aztec-fee-payment 0.0.0 → 4.1.0-rc.4

package/dist/src/ts/fee-payment-methods/bridged.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridged.d.ts","sourceRoot":"","sources":["../../../../src/ts/fee-payment-methods/bridged.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAGpD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iCAAkC,YAAW,gBAAgB;IAEtE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAJT,UAAU,EAAE,YAAY,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,EAAE,EACV,IAAI,EAAE,EAAE,EACR,SAAS,EAAE,EAAE;IAGhC,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAIjC,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAI9B,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA0CtD,cAAc,IAAI,WAAW,GAAG,SAAS;CAG1C"}

package/dist/src/ts/fee-payment-methods/bridged.js

@@ -0,0 +1,69 @@
+import { FunctionCall, FunctionSelector, FunctionType, } from "@aztec/stdlib/abi";
+import { ExecutionPayload } from "@aztec/stdlib/tx";
+import { Fr } from "@aztec/foundation/curves/bn254";
+import { ProtocolContractAddress } from "@aztec/protocol-contracts";
+/**
+ * Fee payment method for BridgedFPC that bundles FeeJuice.claim +
+ * mint_and_pay_fee in a single transaction setup phase.
+ *
+ * Enables cold-start fee sponsorship directly from a L1 bridge deposit,
+ * with no prior `mint` call needed. The caller's wallet only needs to
+ * have done the L1 deposit; the L2 claim and wFJ credit happen atomically here.
+ *
+ * The payment calls (in order):
+ *   1. FeeJuice.claim(fpcAddress, amount, secret, leafIndex)
+ *      - Consumes the L1→L2 message; emits the FeeJuice nullifier.
+ *   2. BridgedFPC.mint_and_pay_fee(amount, salt, leafIndex)
+ *      - Asserts the FeeJuice nullifier exists (pending from step 1).
+ *      - Credits (amount - max_gas_cost) to msg_sender.
+ *      - Sets BridgedFPC as fee payer and ends setup.
+ */
+export class BridgedMintAndPayFeePaymentMethod {
+    constructor(fpcAddress, amount, secret, salt, leafIndex) {
+        this.fpcAddress = fpcAddress;
+        this.amount = amount;
+        this.secret = secret;
+        this.salt = salt;
+        this.leafIndex = leafIndex;
+    }
+    getAsset() {
+        throw new Error("Asset is not required for bridged fee payment.");
+    }
+    getFeePayer() {
+        return Promise.resolve(this.fpcAddress);
+    }
+    async getExecutionPayload() {
+        const feeJuiceAddress = ProtocolContractAddress.FeeJuice;
+        return new ExecutionPayload([
+            FunctionCall.from({
+                name: "claim",
+                to: feeJuiceAddress,
+                selector: await FunctionSelector.fromSignature("claim((Field),u128,Field,Field)"),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [
+                    this.fpcAddress.toField(),
+                    new Fr(this.amount),
+                    this.secret,
+                    this.leafIndex,
+                ],
+                returnTypes: [],
+            }),
+            FunctionCall.from({
+                name: "mint_and_pay_fee",
+                to: this.fpcAddress,
+                selector: await FunctionSelector.fromSignature("mint_and_pay_fee(u128,Field,Field)"),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [new Fr(this.amount), this.salt, this.leafIndex],
+                returnTypes: [],
+            }),
+        ], [], [], [], this.fpcAddress);
+    }
+    getGasSettings() {
+        return;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJpZGdlZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy90cy9mZWUtcGF5bWVudC1tZXRob2RzL2JyaWRnZWQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUNMLFlBQVksRUFDWixnQkFBZ0IsRUFDaEIsWUFBWSxHQUNiLE1BQU0sbUJBQW1CLENBQUM7QUFHM0IsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDcEQsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSx1QkFBdUIsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBFOzs7Ozs7Ozs7Ozs7Ozs7R0FlRztBQUNILE1BQU0sT0FBTyxpQ0FBaUM7SUFDNUMsWUFDbUIsVUFBd0IsRUFDeEIsTUFBYyxFQUNkLE1BQVUsRUFDVixJQUFRLEVBQ1IsU0FBYTtRQUpiLGVBQVUsR0FBVixVQUFVLENBQWM7UUFDeEIsV0FBTSxHQUFOLE1BQU0sQ0FBUTtRQUNkLFdBQU0sR0FBTixNQUFNLENBQUk7UUFDVixTQUFJLEdBQUosSUFBSSxDQUFJO1FBQ1IsY0FBUyxHQUFULFNBQVMsQ0FBSTtJQUM3QixDQUFDO0lBRUosUUFBUTtRQUNOLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0RBQWdELENBQUMsQ0FBQztJQUNwRSxDQUFDO0lBRUQsV0FBVztRQUNULE9BQU8sT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDMUMsQ0FBQztJQUVELEtBQUssQ0FBQyxtQkFBbUI7UUFDdkIsTUFBTSxlQUFlLEdBQUcsdUJBQXVCLENBQUMsUUFBUSxDQUFDO1FBRXpELE9BQU8sSUFBSSxnQkFBZ0IsQ0FDekI7WUFDRSxZQUFZLENBQUMsSUFBSSxDQUFDO2dCQUNoQixJQUFJLEVBQUUsT0FBTztnQkFDYixFQUFFLEVBQUUsZUFBZTtnQkFDbkIsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUMsYUFBYSxDQUM1QyxpQ0FBaUMsQ0FDbEM7Z0JBQ0QsSUFBSSxFQUFFLFlBQVksQ0FBQyxPQUFPO2dCQUMxQixhQUFhLEVBQUUsS0FBSztnQkFDcEIsUUFBUSxFQUFFLEtBQUs7Z0JBQ2YsSUFBSSxFQUFFO29CQUNKLElBQUksQ0FBQyxVQUFVLENBQUMsT0FBTyxFQUFFO29CQUN6QixJQUFJLEVBQUUsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDO29CQUNuQixJQUFJLENBQUMsTUFBTTtvQkFDWCxJQUFJLENBQUMsU0FBUztpQkFDZjtnQkFDRCxXQUFXLEVBQUUsRUFBRTthQUNoQixDQUFDO1lBQ0YsWUFBWSxDQUFDLElBQUksQ0FBQztnQkFDaEIsSUFBSSxFQUFFLGtCQUFrQjtnQkFDeEIsRUFBRSxFQUFFLElBQUksQ0FBQyxVQUFVO2dCQUNuQixRQUFRLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQyxhQUFhLENBQzVDLG9DQUFvQyxDQUNyQztnQkFDRCxJQUFJLEVBQUUsWUFBWSxDQUFDLE9BQU87Z0JBQzFCLGFBQWEsRUFBRSxLQUFLO2dCQUNwQixRQUFRLEVBQUUsS0FBSztnQkFDZixJQUFJLEVBQUUsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDO2dCQUN0RCxXQUFXLEVBQUUsRUFBRTthQUNoQixDQUFDO1NBQ0gsRUFDRCxFQUFFLEVBQ0YsRUFBRSxFQUNGLEVBQUUsRUFDRixJQUFJLENBQUMsVUFBVSxDQUNoQixDQUFDO0lBQ0osQ0FBQztJQUVELGNBQWM7UUFDWixPQUFPO0lBQ1QsQ0FBQztDQUNGIn0=

package/dist/src/ts/fee-payment-methods/index.d.ts

@@ -0,0 +1,3 @@
+export { FPCFeePaymentMethod, FPCExactFeePaymentMethod } from "./shared.js";
+export { BridgedMintAndPayFeePaymentMethod } from "./bridged.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/ts/fee-payment-methods/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ts/fee-payment-methods/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/ts/fee-payment-methods/index.js

@@ -0,0 +1,3 @@
+export { FPCFeePaymentMethod, FPCExactFeePaymentMethod } from "./shared.js";
+export { BridgedMintAndPayFeePaymentMethod } from "./bridged.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvdHMvZmVlLXBheW1lbnQtbWV0aG9kcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDNUUsT0FBTyxFQUFFLGlDQUFpQyxFQUFFLE1BQU0sY0FBYyxDQUFDIn0=

package/dist/src/ts/fee-payment-methods/shared.d.ts

@@ -0,0 +1,34 @@
+import type { FeePaymentMethod } from "@aztec/aztec.js/fee";
+import { AztecAddress } from "@aztec/stdlib/aztec-address";
+import type { GasSettings } from "@aztec/stdlib/gas";
+import { ExecutionPayload } from "@aztec/stdlib/tx";
+/**
+ * Generic fee payment method compatible with any FPC contract that implements pay_fee().
+ * Deducts max gas cost from the sender's internal balance. Does not refund unused gas.
+ * Suitable for any FPC that implements pay_fee().
+ *
+ * Use FPCExactFeePaymentMethod for transactions that need unused gas refunded.
+ */
+export declare class FPCFeePaymentMethod implements FeePaymentMethod {
+    private readonly fpcAddress;
+    constructor(fpcAddress: AztecAddress);
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    getExecutionPayload(): Promise<ExecutionPayload>;
+    getGasSettings(): GasSettings | undefined;
+}
+/**
+ * Generic fee payment method compatible with any FPC contract that implements pay_fee_exact().
+ * Deducts max gas cost upfront, then refunds (max - actual) in the teardown phase via a partial note.
+ *
+ * Use REASONABLE_TEARDOWN_GAS_LIMITS in the transaction's gasSettings to budget the teardown phase.
+ */
+export declare class FPCExactFeePaymentMethod implements FeePaymentMethod {
+    private readonly fpcAddress;
+    constructor(fpcAddress: AztecAddress);
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    getExecutionPayload(): Promise<ExecutionPayload>;
+    getGasSettings(): GasSettings | undefined;
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/ts/fee-payment-methods/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/ts/fee-payment-methods/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,YAAY;IAErD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAIjC,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAI9B,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAqBtD,cAAc,IAAI,WAAW,GAAG,SAAS;CAG1C;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,YAAY;IAErD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAIjC,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAI9B,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAqBtD,cAAc,IAAI,WAAW,GAAG,SAAS;CAG1C"}

package/dist/src/ts/fee-payment-methods/shared.js

@@ -0,0 +1,72 @@
+import { FunctionCall, FunctionSelector, FunctionType, } from "@aztec/stdlib/abi";
+import { ExecutionPayload } from "@aztec/stdlib/tx";
+/**
+ * Generic fee payment method compatible with any FPC contract that implements pay_fee().
+ * Deducts max gas cost from the sender's internal balance. Does not refund unused gas.
+ * Suitable for any FPC that implements pay_fee().
+ *
+ * Use FPCExactFeePaymentMethod for transactions that need unused gas refunded.
+ */
+export class FPCFeePaymentMethod {
+    constructor(fpcAddress) {
+        this.fpcAddress = fpcAddress;
+    }
+    getAsset() {
+        throw new Error("Asset is not required for FPC fee payment.");
+    }
+    getFeePayer() {
+        return Promise.resolve(this.fpcAddress);
+    }
+    async getExecutionPayload() {
+        return new ExecutionPayload([
+            FunctionCall.from({
+                name: "pay_fee",
+                to: this.fpcAddress,
+                selector: await FunctionSelector.fromSignature("pay_fee()"),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [],
+                returnTypes: [],
+            }),
+        ], [], [], [], this.fpcAddress);
+    }
+    getGasSettings() {
+        return;
+    }
+}
+/**
+ * Generic fee payment method compatible with any FPC contract that implements pay_fee_exact().
+ * Deducts max gas cost upfront, then refunds (max - actual) in the teardown phase via a partial note.
+ *
+ * Use REASONABLE_TEARDOWN_GAS_LIMITS in the transaction's gasSettings to budget the teardown phase.
+ */
+export class FPCExactFeePaymentMethod {
+    constructor(fpcAddress) {
+        this.fpcAddress = fpcAddress;
+    }
+    getAsset() {
+        throw new Error("Asset is not required for FPC fee payment.");
+    }
+    getFeePayer() {
+        return Promise.resolve(this.fpcAddress);
+    }
+    async getExecutionPayload() {
+        return new ExecutionPayload([
+            FunctionCall.from({
+                name: "pay_fee_exact",
+                to: this.fpcAddress,
+                selector: await FunctionSelector.fromSignature("pay_fee_exact()"),
+                type: FunctionType.PRIVATE,
+                hideMsgSender: false,
+                isStatic: false,
+                args: [],
+                returnTypes: [],
+            }),
+        ], [], [], [], this.fpcAddress);
+    }
+    getGasSettings() {
+        return;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2hhcmVkLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RzL2ZlZS1wYXltZW50LW1ldGhvZHMvc2hhcmVkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFDTCxZQUFZLEVBQ1osZ0JBQWdCLEVBQ2hCLFlBQVksR0FDYixNQUFNLG1CQUFtQixDQUFDO0FBRzNCLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXBEOzs7Ozs7R0FNRztBQUNILE1BQU0sT0FBTyxtQkFBbUI7SUFDOUIsWUFBNkIsVUFBd0I7UUFBeEIsZUFBVSxHQUFWLFVBQVUsQ0FBYztJQUFHLENBQUM7SUFFekQsUUFBUTtRQUNOLE1BQU0sSUFBSSxLQUFLLENBQUMsNENBQTRDLENBQUMsQ0FBQztJQUNoRSxDQUFDO0lBRUQsV0FBVztRQUNULE9BQU8sT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDMUMsQ0FBQztJQUVELEtBQUssQ0FBQyxtQkFBbUI7UUFDdkIsT0FBTyxJQUFJLGdCQUFnQixDQUN6QjtZQUNFLFlBQVksQ0FBQyxJQUFJLENBQUM7Z0JBQ2hCLElBQUksRUFBRSxTQUFTO2dCQUNmLEVBQUUsRUFBRSxJQUFJLENBQUMsVUFBVTtnQkFDbkIsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUMsYUFBYSxDQUFDLFdBQVcsQ0FBQztnQkFDM0QsSUFBSSxFQUFFLFlBQVksQ0FBQyxPQUFPO2dCQUMxQixhQUFhLEVBQUUsS0FBSztnQkFDcEIsUUFBUSxFQUFFLEtBQUs7Z0JBQ2YsSUFBSSxFQUFFLEVBQUU7Z0JBQ1IsV0FBVyxFQUFFLEVBQUU7YUFDaEIsQ0FBQztTQUNILEVBQ0QsRUFBRSxFQUNGLEVBQUUsRUFDRixFQUFFLEVBQ0YsSUFBSSxDQUFDLFVBQVUsQ0FDaEIsQ0FBQztJQUNKLENBQUM7SUFFRCxjQUFjO1FBQ1osT0FBTztJQUNULENBQUM7Q0FDRjtBQUVEOzs7OztHQUtHO0FBQ0gsTUFBTSxPQUFPLHdCQUF3QjtJQUNuQyxZQUE2QixVQUF3QjtRQUF4QixlQUFVLEdBQVYsVUFBVSxDQUFjO0lBQUcsQ0FBQztJQUV6RCxRQUFRO1FBQ04sTUFBTSxJQUFJLEtBQUssQ0FBQyw0Q0FBNEMsQ0FBQyxDQUFDO0lBQ2hFLENBQUM7SUFFRCxXQUFXO1FBQ1QsT0FBTyxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUMxQyxDQUFDO0lBRUQsS0FBSyxDQUFDLG1CQUFtQjtRQUN2QixPQUFPLElBQUksZ0JBQWdCLENBQ3pCO1lBQ0UsWUFBWSxDQUFDLElBQUksQ0FBQztnQkFDaEIsSUFBSSxFQUFFLGVBQWU7Z0JBQ3JCLEVBQUUsRUFBRSxJQUFJLENBQUMsVUFBVTtnQkFDbkIsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUMsYUFBYSxDQUFDLGlCQUFpQixDQUFDO2dCQUNqRSxJQUFJLEVBQUUsWUFBWSxDQUFDLE9BQU87Z0JBQzFCLGFBQWEsRUFBRSxLQUFLO2dCQUNwQixRQUFRLEVBQUUsS0FBSztnQkFDZixJQUFJLEVBQUUsRUFBRTtnQkFDUixXQUFXLEVBQUUsRUFBRTthQUNoQixDQUFDO1NBQ0gsRUFDRCxFQUFFLEVBQ0YsRUFBRSxFQUNGLEVBQUUsRUFDRixJQUFJLENBQUMsVUFBVSxDQUNoQixDQUFDO0lBQ0osQ0FBQztJQUVELGNBQWM7UUFDWixPQUFPO0lBQ1QsQ0FBQztDQUNGIn0=

package/dist/src/ts/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @defi-wonderland/aztec-fee-payment
+ *
+ * Fee Payment Contracts (FPCs) for Aztec - enables bridged fee payment strategies.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   BridgedFPCContract,
+ *   FPCFeePaymentMethod,
+ *   registerBridgedContract,
+ * } from '@defi-wonderland/aztec-fee-payment';
+ *
+ * // Register (no deploy needed — fully private contract)
+ * const fpc = await registerBridgedContract(wallet);
+ *
+ * // Use FPCFeePaymentMethod after minting internal balance
+ * await someContract.methods.doSomething()
+ *   .send({
+ *     fee: { paymentMethod: new FPCFeePaymentMethod(fpc.address) }
+ *   });
+ * ```
+ */
+export { BridgedFPCContract, BridgedFPCContractArtifact, } from "../artifacts/BridgedFPC.js";
+export { FPCFeePaymentMethod, FPCExactFeePaymentMethod, BridgedMintAndPayFeePaymentMethod, } from "./fee-payment-methods/index.js";
+export { DEFAULT_FEE_MULTIPLIER, REASONABLE_GAS_LIMITS, REASONABLE_TEARDOWN_GAS_LIMITS, maxFeesPerGasFromBaseFees, maxGasCostFor, registerBridgedContract, } from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/ts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAEL,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EACzB,aAAa,EAEb,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/src/ts/index.js

@@ -0,0 +1,34 @@
+/**
+ * @defi-wonderland/aztec-fee-payment
+ *
+ * Fee Payment Contracts (FPCs) for Aztec - enables bridged fee payment strategies.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   BridgedFPCContract,
+ *   FPCFeePaymentMethod,
+ *   registerBridgedContract,
+ * } from '@defi-wonderland/aztec-fee-payment';
+ *
+ * // Register (no deploy needed — fully private contract)
+ * const fpc = await registerBridgedContract(wallet);
+ *
+ * // Use FPCFeePaymentMethod after minting internal balance
+ * await someContract.methods.doSomething()
+ *   .send({
+ *     fee: { paymentMethod: new FPCFeePaymentMethod(fpc.address) }
+ *   });
+ * ```
+ */
+// Contract artifacts and type-safe wrappers
+export { BridgedFPCContract, BridgedFPCContractArtifact, } from "../artifacts/BridgedFPC.js";
+// Fee payment method implementations
+export { FPCFeePaymentMethod, FPCExactFeePaymentMethod, BridgedMintAndPayFeePaymentMethod, } from "./fee-payment-methods/index.js";
+// Utilities for integrators
+export { 
+// Gas calculations
+DEFAULT_FEE_MULTIPLIER, REASONABLE_GAS_LIMITS, REASONABLE_TEARDOWN_GAS_LIMITS, maxFeesPerGasFromBaseFees, maxGasCostFor, 
+// Deployment
+registerBridgedContract, } from "./utils/index.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FzQkc7QUFFSCw0Q0FBNEM7QUFDNUMsT0FBTyxFQUNMLGtCQUFrQixFQUNsQiwwQkFBMEIsR0FDM0IsTUFBTSw0QkFBNEIsQ0FBQztBQUVwQyxxQ0FBcUM7QUFDckMsT0FBTyxFQUNMLG1CQUFtQixFQUNuQix3QkFBd0IsRUFDeEIsaUNBQWlDLEdBQ2xDLE1BQU0sZ0NBQWdDLENBQUM7QUFFeEMsNEJBQTRCO0FBQzVCLE9BQU87QUFDTCxtQkFBbUI7QUFDbkIsc0JBQXNCLEVBQ3RCLHFCQUFxQixFQUNyQiw4QkFBOEIsRUFDOUIseUJBQXlCLEVBQ3pCLGFBQWE7QUFDYixhQUFhO0FBQ2IsdUJBQXVCLEdBQ3hCLE1BQU0sa0JBQWtCLENBQUMifQ==

package/dist/src/ts/utils/deploy.d.ts

@@ -0,0 +1,22 @@
+import { Fr } from "@aztec/foundation/curves/bn254";
+import { Wallet } from "@aztec/aztec.js/wallet";
+import { BridgedFPCContract } from "../../artifacts/BridgedFPC.js";
+/**
+ * Registers the BridgedFPC contract with the PXE without sending any deployment transaction.
+ *
+ * BridgedFPC is a fully private contract (no public functions, no constructor, no initializer).
+ * The Aztec protocol allows interacting with such contracts immediately once registered —
+ * no on-chain deployment transaction is required.
+ *
+ * The contract address is computed deterministically from its class hash and the provided salt,
+ * with `deployer: AztecAddress.ZERO` so the deployer address is NOT mixed in. This means the same
+ * salt always produces the same address regardless of who calls this function.
+ * (`universalDeploy` is only available on `.send()` options; for `.register()` the equivalent
+ * is setting `deployer` to `AztecAddress.ZERO`.)
+ *
+ * @param wallet The wallet used to register the contract with the PXE
+ * @param salt   Optional address salt (defaults to Fr.ZERO for a canonical address)
+ * @returns The registered BridgedFPC contract instance
+ */
+export declare function registerBridgedContract(wallet: Wallet, salt?: Fr): Promise<BridgedFPCContract>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/src/ts/utils/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../../src/ts/utils/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,EAAY,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAM7B"}

package/dist/src/ts/utils/deploy.js

@@ -0,0 +1,28 @@
+import { Fr } from "@aztec/foundation/curves/bn254";
+import { AztecAddress } from "@aztec/aztec.js/addresses";
+import { BridgedFPCContract } from "../../artifacts/BridgedFPC.js";
+/**
+ * Registers the BridgedFPC contract with the PXE without sending any deployment transaction.
+ *
+ * BridgedFPC is a fully private contract (no public functions, no constructor, no initializer).
+ * The Aztec protocol allows interacting with such contracts immediately once registered —
+ * no on-chain deployment transaction is required.
+ *
+ * The contract address is computed deterministically from its class hash and the provided salt,
+ * with `deployer: AztecAddress.ZERO` so the deployer address is NOT mixed in. This means the same
+ * salt always produces the same address regardless of who calls this function.
+ * (`universalDeploy` is only available on `.send()` options; for `.register()` the equivalent
+ * is setting `deployer` to `AztecAddress.ZERO`.)
+ *
+ * @param wallet The wallet used to register the contract with the PXE
+ * @param salt   Optional address salt (defaults to Fr.ZERO for a canonical address)
+ * @returns The registered BridgedFPC contract instance
+ */
+export async function registerBridgedContract(wallet, salt = Fr.ZERO) {
+    return BridgedFPCContract.deploy(wallet).register({
+        contractAddressSalt: salt,
+        skipInitialization: true,
+        deployer: AztecAddress.ZERO,
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVwbG95LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RzL3V0aWxzL2RlcGxveS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFcEQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXpELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRW5FOzs7Ozs7Ozs7Ozs7Ozs7O0dBZ0JHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSx1QkFBdUIsQ0FDM0MsTUFBYyxFQUNkLE9BQVcsRUFBRSxDQUFDLElBQUk7SUFFbEIsT0FBTyxrQkFBa0IsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUMsUUFBUSxDQUFDO1FBQ2hELG1CQUFtQixFQUFFLElBQUk7UUFDekIsa0JBQWtCLEVBQUUsSUFBSTtRQUN4QixRQUFRLEVBQUUsWUFBWSxDQUFDLElBQUk7S0FDNUIsQ0FBQyxDQUFDO0FBQ0wsQ0FBQyJ9

package/dist/src/ts/utils/gas.d.ts

@@ -0,0 +1,51 @@
+import { Gas, GasFees } from "@aztec/stdlib/gas";
+/**
+ * Default safety multiplier applied to base fees.
+ * Provides headroom above the current minimum to avoid rejection under fee spikes.
+ */
+export declare const DEFAULT_FEE_MULTIPLIER = 3n;
+/**
+ * Reasonable default gas limits for most transactions.
+ */
+export declare const REASONABLE_GAS_LIMITS: Gas;
+/**
+ * Teardown gas limits for transactions that use pay_fee_exact().
+ *
+ * These are Aztec's protocol-wide defaults (DEFAULT_TEARDOWN_DA_GAS_LIMIT = 393,216;
+ * DEFAULT_TEARDOWN_L2_GAS_LIMIT = 1,000,000). They are NOT calibrated to the _refund
+ * teardown function, which only emits one note hash and costs roughly 40-50k L2 gas
+ * in practice (~20x cheaper than this limit).
+ *
+ * The protocol bills teardown gas at the limit (rather than actual usage), this
+ * overestimate inflates the cost of every pay_fee_exact transaction. Consider
+ * benchmarking _refund's actual gas consumption and replacing this with a tighter
+ * constant.
+ *
+ * NOTE: teardown gas is already included in the gas_limits fee calculation by the protocol,
+ * so this must NOT be passed to maxGasCostFor (that would double-count teardown cost).
+ */
+export declare const REASONABLE_TEARDOWN_GAS_LIMITS: Gas;
+/**
+ * Calculate max fees per gas from base fees with a multiplier.
+ * @param baseFees - The current base fees from the node
+ * @param multiplier - Multiplier to apply (default: DEFAULT_FEE_MULTIPLIER)
+ * @returns GasFees object with calculated max fees
+ */
+export declare function maxFeesPerGasFromBaseFees(baseFees: {
+    feePerDaGas: string | number | bigint;
+    feePerL2Gas: string | number | bigint;
+}, multiplier?: bigint): GasFees;
+/**
+ * Calculate the maximum gas cost for a transaction.
+ *
+ * Teardown gas is already accounted for inside gasLimits by the protocol
+ * (the kernel's gas_meter includes teardown in the overall fee computation),
+ * so teardownGasLimits must NOT be added again here — doing so would
+ * double-count the teardown cost.
+ *
+ * @param maxFeesPerGas - Maximum fees per gas unit
+ * @param gasLimits - Gas limits for the transaction (already covers teardown allocation)
+ * @returns Maximum possible gas cost in wei
+ */
+export declare function maxGasCostFor(maxFeesPerGas: GasFees, gasLimits: Gas): bigint;
+//# sourceMappingURL=gas.d.ts.map

package/dist/src/ts/utils/gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../../../../src/ts/utils/gas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAQjD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,qBAAqB,KAGhC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B,KAGzC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE;IACR,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACvC,EACD,UAAU,GAAE,MAA+B,GAC1C,OAAO,CAKT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM,CAK5E"}

package/dist/src/ts/utils/gas.js

@@ -0,0 +1,60 @@
+import { Gas, GasFees } from "@aztec/stdlib/gas";
+import { DEFAULT_DA_GAS_LIMIT, DEFAULT_L2_GAS_LIMIT, DEFAULT_TEARDOWN_DA_GAS_LIMIT, DEFAULT_TEARDOWN_L2_GAS_LIMIT, } from "@aztec/constants";
+/**
+ * Default safety multiplier applied to base fees.
+ * Provides headroom above the current minimum to avoid rejection under fee spikes.
+ */
+export const DEFAULT_FEE_MULTIPLIER = 3n;
+/**
+ * Reasonable default gas limits for most transactions.
+ */
+export const REASONABLE_GAS_LIMITS = Gas.from({
+    daGas: DEFAULT_DA_GAS_LIMIT,
+    l2Gas: DEFAULT_L2_GAS_LIMIT,
+});
+/**
+ * Teardown gas limits for transactions that use pay_fee_exact().
+ *
+ * These are Aztec's protocol-wide defaults (DEFAULT_TEARDOWN_DA_GAS_LIMIT = 393,216;
+ * DEFAULT_TEARDOWN_L2_GAS_LIMIT = 1,000,000). They are NOT calibrated to the _refund
+ * teardown function, which only emits one note hash and costs roughly 40-50k L2 gas
+ * in practice (~20x cheaper than this limit).
+ *
+ * The protocol bills teardown gas at the limit (rather than actual usage), this
+ * overestimate inflates the cost of every pay_fee_exact transaction. Consider
+ * benchmarking _refund's actual gas consumption and replacing this with a tighter
+ * constant.
+ *
+ * NOTE: teardown gas is already included in the gas_limits fee calculation by the protocol,
+ * so this must NOT be passed to maxGasCostFor (that would double-count teardown cost).
+ */
+export const REASONABLE_TEARDOWN_GAS_LIMITS = Gas.from({
+    daGas: DEFAULT_TEARDOWN_DA_GAS_LIMIT,
+    l2Gas: DEFAULT_TEARDOWN_L2_GAS_LIMIT,
+});
+/**
+ * Calculate max fees per gas from base fees with a multiplier.
+ * @param baseFees - The current base fees from the node
+ * @param multiplier - Multiplier to apply (default: DEFAULT_FEE_MULTIPLIER)
+ * @returns GasFees object with calculated max fees
+ */
+export function maxFeesPerGasFromBaseFees(baseFees, multiplier = DEFAULT_FEE_MULTIPLIER) {
+    return new GasFees(BigInt(baseFees.feePerDaGas) * multiplier, BigInt(baseFees.feePerL2Gas) * multiplier);
+}
+/**
+ * Calculate the maximum gas cost for a transaction.
+ *
+ * Teardown gas is already accounted for inside gasLimits by the protocol
+ * (the kernel's gas_meter includes teardown in the overall fee computation),
+ * so teardownGasLimits must NOT be added again here — doing so would
+ * double-count the teardown cost.
+ *
+ * @param maxFeesPerGas - Maximum fees per gas unit
+ * @param gasLimits - Gas limits for the transaction (already covers teardown allocation)
+ * @returns Maximum possible gas cost in wei
+ */
+export function maxGasCostFor(maxFeesPerGas, gasLimits) {
+    return (BigInt(maxFeesPerGas.feePerDaGas) * BigInt(gasLimits.daGas) +
+        BigInt(maxFeesPerGas.feePerL2Gas) * BigInt(gasLimits.l2Gas));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2FzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RzL3V0aWxzL2dhcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsR0FBRyxFQUFFLE9BQU8sRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ2pELE9BQU8sRUFDTCxvQkFBb0IsRUFDcEIsb0JBQW9CLEVBQ3BCLDZCQUE2QixFQUM3Qiw2QkFBNkIsR0FDOUIsTUFBTSxrQkFBa0IsQ0FBQztBQUUxQjs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBRyxFQUFFLENBQUM7QUFFekM7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxHQUFHLENBQUMsSUFBSSxDQUFDO0lBQzVDLEtBQUssRUFBRSxvQkFBb0I7SUFDM0IsS0FBSyxFQUFFLG9CQUFvQjtDQUM1QixDQUFDLENBQUM7QUFFSDs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLENBQUMsTUFBTSw4QkFBOEIsR0FBRyxHQUFHLENBQUMsSUFBSSxDQUFDO0lBQ3JELEtBQUssRUFBRSw2QkFBNkI7SUFDcEMsS0FBSyxFQUFFLDZCQUE2QjtDQUNyQyxDQUFDLENBQUM7QUFFSDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSx5QkFBeUIsQ0FDdkMsUUFHQyxFQUNELGFBQXFCLHNCQUFzQjtJQUUzQyxPQUFPLElBQUksT0FBTyxDQUNoQixNQUFNLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBQyxHQUFHLFVBQVUsRUFDekMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQUMsR0FBRyxVQUFVLENBQzFDLENBQUM7QUFDSixDQUFDO0FBRUQ7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLFVBQVUsYUFBYSxDQUFDLGFBQXNCLEVBQUUsU0FBYztJQUNsRSxPQUFPLENBQ0wsTUFBTSxDQUFDLGFBQWEsQ0FBQyxXQUFXLENBQUMsR0FBRyxNQUFNLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQztRQUMzRCxNQUFNLENBQUMsYUFBYSxDQUFDLFdBQVcsQ0FBQyxHQUFHLE1BQU0sQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLENBQzVELENBQUM7QUFDSixDQUFDIn0=

package/dist/src/ts/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_FEE_MULTIPLIER, REASONABLE_GAS_LIMITS, REASONABLE_TEARDOWN_GAS_LIMITS, maxFeesPerGasFromBaseFees, maxGasCostFor, } from "./gas.js";
+export { registerBridgedContract } from "./deploy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/ts/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ts/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EACzB,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/ts/utils/index.js

@@ -0,0 +1,5 @@
+// Gas calculation utilities
+export { DEFAULT_FEE_MULTIPLIER, REASONABLE_GAS_LIMITS, REASONABLE_TEARDOWN_GAS_LIMITS, maxFeesPerGasFromBaseFees, maxGasCostFor, } from "./gas.js";
+// Deployment utilities
+export { registerBridgedContract } from "./deploy.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvdHMvdXRpbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsNEJBQTRCO0FBQzVCLE9BQU8sRUFDTCxzQkFBc0IsRUFDdEIscUJBQXFCLEVBQ3JCLDhCQUE4QixFQUM5Qix5QkFBeUIsRUFDekIsYUFBYSxHQUNkLE1BQU0sVUFBVSxDQUFDO0FBRWxCLHVCQUF1QjtBQUN2QixPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSxhQUFhLENBQUMifQ==