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

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

@@ -1,10 +1,10 @@
-import { Fr } from "@aztec/foundation/curves/bn254";
+import { Fr } from "@aztec/aztec.js/fields";
 import { Wallet } from "@aztec/aztec.js/wallet";
-import { BridgedFPCContract } from "../../artifacts/BridgedFPC.js";
+import { PrivateFPCContract } from "../../artifacts/PrivateFPC.js";
 /**
- * Registers the BridgedFPC contract with the PXE without sending any deployment transaction.
+ * Registers the PrivateFPC contract with the PXE without sending any deployment transaction.
  *
- * BridgedFPC is a fully private contract (no public functions, no constructor, no initializer).
+ * PrivateFPC 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.
  *
@@ -15,8 +15,8 @@ import { BridgedFPCContract } from "../../artifacts/BridgedFPC.js";
  * 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
+ * @param salt   Salt used to derive the contract address
+ * @returns The registered PrivateFPC contract instance
  */
-export declare function registerBridgedContract(wallet: Wallet, salt?: Fr): Promise<BridgedFPCContract>;
+export declare function registerPrivateContract(wallet: Wallet, salt: Fr): Promise<PrivateFPCContract>;
 //# sourceMappingURL=deploy.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../../src/ts/utils/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAC5C,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,EAAE,EAAE,GACP,OAAO,CAAC,kBAAkB,CAAC,CAM7B"}

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

@@ -1,10 +1,9 @@
-import { Fr } from "@aztec/foundation/curves/bn254";
-import { AztecAddress } from "@aztec/aztec.js/addresses";
-import { BridgedFPCContract } from "../../artifacts/BridgedFPC.js";
+import { AztecAddress } from "@aztec/stdlib/aztec-address";
+import { PrivateFPCContract } from "../../artifacts/PrivateFPC.js";
 /**
- * Registers the BridgedFPC contract with the PXE without sending any deployment transaction.
+ * Registers the PrivateFPC contract with the PXE without sending any deployment transaction.
  *
- * BridgedFPC is a fully private contract (no public functions, no constructor, no initializer).
+ * PrivateFPC 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.
  *
@@ -15,14 +14,14 @@ import { BridgedFPCContract } from "../../artifacts/BridgedFPC.js";
  * 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
+ * @param salt   Salt used to derive the contract address
+ * @returns The registered PrivateFPC contract instance
  */
-export async function registerBridgedContract(wallet, salt = Fr.ZERO) {
-    return BridgedFPCContract.deploy(wallet).register({
+export async function registerPrivateContract(wallet, salt) {
+    return PrivateFPCContract.deploy(wallet).register({
         contractAddressSalt: salt,
         skipInitialization: true,
         deployer: AztecAddress.ZERO,
     });
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVwbG95LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RzL3V0aWxzL2RlcGxveS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFcEQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXpELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRW5FOzs7Ozs7Ozs7Ozs7Ozs7O0dBZ0JHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSx1QkFBdUIsQ0FDM0MsTUFBYyxFQUNkLE9BQVcsRUFBRSxDQUFDLElBQUk7SUFFbEIsT0FBTyxrQkFBa0IsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUMsUUFBUSxDQUFDO1FBQ2hELG1CQUFtQixFQUFFLElBQUk7UUFDekIsa0JBQWtCLEVBQUUsSUFBSTtRQUN4QixRQUFRLEVBQUUsWUFBWSxDQUFDLElBQUk7S0FDNUIsQ0FBQyxDQUFDO0FBQ0wsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVwbG95LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RzL3V0aWxzL2RlcGxveS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFM0QsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFbkU7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLHVCQUF1QixDQUMzQyxNQUFjLEVBQ2QsSUFBUTtJQUVSLE9BQU8sa0JBQWtCLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDLFFBQVEsQ0FBQztRQUNoRCxtQkFBbUIsRUFBRSxJQUFJO1FBQ3pCLGtCQUFrQixFQUFFLElBQUk7UUFDeEIsUUFBUSxFQUFFLFlBQVksQ0FBQyxJQUFJO0tBQzVCLENBQUMsQ0FBQztBQUNMLENBQUMifQ==

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

@@ -1,32 +1,48 @@
-import { Gas, GasFees } from "@aztec/stdlib/gas";
+import type { FeePaymentMethod } from "@aztec/aztec.js/fee";
+import { AztecAddress } from "@aztec/stdlib/aztec-address";
+import { Gas, GasFees, GasSettings } from "@aztec/stdlib/gas";
+type BaseFeesProvider = {
+    getCurrentMinFees(): Promise<GasFees>;
+};
+type SimulatedGasEstimate = Pick<GasSettings, "gasLimits" | "teardownGasLimits">;
+type SimulatableInteraction = {
+    simulate(options: {
+        from: AztecAddress;
+        additionalScopes?: AztecAddress[];
+        includeMetadata?: boolean;
+        fee?: {
+            paymentMethod?: FeePaymentMethod;
+            estimatedGasPadding?: number;
+            gasSettings?: {
+                gasLimits?: Gas;
+                teardownGasLimits?: Gas;
+                maxFeesPerGas?: GasFees;
+                maxPriorityFeesPerGas?: GasFees;
+            };
+        };
+    }): Promise<{
+        estimatedGas?: SimulatedGasEstimate;
+    }>;
+};
+export type FeeMultiplier = number | {
+    numerator: bigint;
+    denominator: bigint;
+};
 /**
- * Default safety multiplier applied to base fees.
- * Provides headroom above the current minimum to avoid rejection under fee spikes.
+ * Default max fee multiplier applied to the node's current minimum fees.
+ * Represented as an exact 6/5 fraction so bigint fee values never depend on
+ * floating-point multiplication.
  */
-export declare const DEFAULT_FEE_MULTIPLIER = 3n;
+export declare const DEFAULT_FEE_MULTIPLIER: {
+    readonly numerator: 6n;
+    readonly denominator: 5n;
+};
 /**
- * Reasonable default gas limits for most transactions.
+ * Default padding applied to simulated gas usage when turning it into limits.
  */
-export declare const REASONABLE_GAS_LIMITS: Gas;
+export declare const DEFAULT_GAS_ESTIMATE_PADDING = 0.1;
 /**
- * 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.
+ * Calculate max fees per gas from the node's minimum 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
@@ -34,7 +50,12 @@ export declare const REASONABLE_TEARDOWN_GAS_LIMITS: Gas;
 export declare function maxFeesPerGasFromBaseFees(baseFees: {
     feePerDaGas: string | number | bigint;
     feePerL2Gas: string | number | bigint;
-}, multiplier?: bigint): GasFees;
+}, multiplier?: FeeMultiplier): GasFees;
+/**
+ * Mirror max fees into priority fees.
+ * Aztec models both fee caps independently, but this SDK currently keeps them equal.
+ */
+export declare function maxPriorityFeesPerGasFromMaxFees(maxFeesPerGas: GasFees): GasFees;
 /**
  * Calculate the maximum gas cost for a transaction.
  *
@@ -48,4 +69,19 @@ export declare function maxFeesPerGasFromBaseFees(baseFees: {
  * @returns Maximum possible gas cost in wei
  */
 export declare function maxGasCostFor(maxFeesPerGas: GasFees, gasLimits: Gas): bigint;
+/**
+ * Simulate an interaction to derive tighter gas limits, then combine them with
+ * fee caps based on the node's current minimum fees.
+ */
+export declare function estimateGasSettings(interaction: SimulatableInteraction, { aztecNode, from, paymentMethod, additionalScopes, maxFeeMultiplier, estimatedGasPadding, gasLimits, teardownGasLimits, }: {
+    aztecNode: BaseFeesProvider;
+    from: AztecAddress;
+    paymentMethod?: FeePaymentMethod;
+    additionalScopes?: AztecAddress[];
+    maxFeeMultiplier?: FeeMultiplier;
+    estimatedGasPadding?: number;
+    gasLimits?: Gas;
+    teardownGasLimits?: Gas;
+}): Promise<GasSettings>;
+export {};
 //# sourceMappingURL=gas.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../../../../src/ts/utils/gas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,GAAG,EACH,OAAO,EACP,WAAW,EAIZ,MAAM,mBAAmB,CAAC;AAG3B,KAAK,gBAAgB,GAAG;IACtB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,oBAAoB,GAAG,IAAI,CAC9B,WAAW,EACX,WAAW,GAAG,mBAAmB,CAClC,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAChB,IAAI,EAAE,YAAY,CAAC;QACnB,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;QAClC,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,GAAG,CAAC,EAAE;YACJ,aAAa,CAAC,EAAE,gBAAgB,CAAC;YACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAC7B,WAAW,CAAC,EAAE;gBACZ,SAAS,CAAC,EAAE,GAAG,CAAC;gBAChB,iBAAiB,CAAC,EAAE,GAAG,CAAC;gBACxB,aAAa,CAAC,EAAE,OAAO,CAAC;gBACxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;aACjC,CAAC;SACH,CAAC;KACH,GAAG,OAAO,CAAC;QAAE,YAAY,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC,CAAC;CACtD,CAAC;AAMF,MAAM,MAAM,aAAa,GACrB,MAAM,GACN;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAgCN;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAwBhD;;;;;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,aAAsC,GACjD,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,aAAa,EAAE,OAAO,GACrB,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM,CAK5E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,sBAAsB,EACnC,EACE,SAAS,EACT,IAAI,EACJ,aAAa,EACb,gBAAgB,EAChB,gBAAyC,EACzC,mBAAkD,EAClD,SAA0B,EAC1B,iBAAgD,GACjD,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACzB,GACA,OAAO,CAAC,WAAW,CAAC,CAiCtB"}

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

@@ -1,45 +1,75 @@
-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";
+import { Gas, GasFees, GasSettings, APPROXIMATE_MAX_DA_GAS_PER_BLOCK, FALLBACK_TEARDOWN_DA_GAS_LIMIT, FALLBACK_TEARDOWN_L2_GAS_LIMIT, } from "@aztec/stdlib/gas";
+import { MAX_PROCESSABLE_L2_GAS } from "@aztec/constants";
+const FEE_MULTIPLIER_SCALE = 10000n;
+const DEFAULT_FEE_MULTIPLIER_NUMERATOR = 6n;
+const DEFAULT_FEE_MULTIPLIER_DENOMINATOR = 5n;
+function ceilDiv(numerator, denominator) {
+    return (numerator + denominator - 1n) / denominator;
+}
+function normalizeMultiplier(multiplier) {
+    if (typeof multiplier === "number") {
+        if (!Number.isFinite(multiplier) || multiplier <= 0) {
+            throw new Error(`Fee multiplier must be a positive finite number, got ${multiplier}`);
+        }
+        return {
+            numerator: BigInt(Math.ceil(multiplier * Number(FEE_MULTIPLIER_SCALE))),
+            denominator: FEE_MULTIPLIER_SCALE,
+        };
+    }
+    if (multiplier.denominator <= 0n || multiplier.numerator <= 0n) {
+        throw new Error(`Fee multiplier must be a positive fraction, got ${multiplier.numerator}/${multiplier.denominator}`);
+    }
+    return multiplier;
+}
+/**
+ * Default max fee multiplier applied to the node's current minimum fees.
+ * Represented as an exact 6/5 fraction so bigint fee values never depend on
+ * floating-point multiplication.
+ */
+export const DEFAULT_FEE_MULTIPLIER = {
+    numerator: DEFAULT_FEE_MULTIPLIER_NUMERATOR,
+    denominator: DEFAULT_FEE_MULTIPLIER_DENOMINATOR,
+};
 /**
- * Default safety multiplier applied to base fees.
- * Provides headroom above the current minimum to avoid rejection under fee spikes.
+ * Default padding applied to simulated gas usage when turning it into limits.
  */
-export const DEFAULT_FEE_MULTIPLIER = 3n;
+export const DEFAULT_GAS_ESTIMATE_PADDING = 0.1;
 /**
- * Reasonable default gas limits for most transactions.
+ * Protocol-maximum gas limits, used as the initial ceiling for
+ * estimateGasSettings — the simulation replaces them with tighter values.
  */
-export const REASONABLE_GAS_LIMITS = Gas.from({
-    daGas: DEFAULT_DA_GAS_LIMIT,
-    l2Gas: DEFAULT_L2_GAS_LIMIT,
+const MAX_GAS_LIMITS = Gas.from({
+    daGas: APPROXIMATE_MAX_DA_GAS_PER_BLOCK,
+    l2Gas: MAX_PROCESSABLE_L2_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.
+ * Protocol-default teardown gas limits. The protocol bills teardown gas at the
+ * limit (not actual usage), so these overestimate. estimateGasSettings replaces
+ * them with simulation output.
  *
- * 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).
+ * Teardown gas is already included in gasLimits by the protocol, so these 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,
+const FALLBACK_TEARDOWN_GAS_LIMITS = Gas.from({
+    daGas: FALLBACK_TEARDOWN_DA_GAS_LIMIT,
+    l2Gas: FALLBACK_TEARDOWN_L2_GAS_LIMIT,
 });
 /**
- * Calculate max fees per gas from base fees with a multiplier.
+ * Calculate max fees per gas from the node's minimum 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);
+    const normalizedMultiplier = normalizeMultiplier(multiplier);
+    return new GasFees(ceilDiv(BigInt(baseFees.feePerDaGas) * normalizedMultiplier.numerator, normalizedMultiplier.denominator), ceilDiv(BigInt(baseFees.feePerL2Gas) * normalizedMultiplier.numerator, normalizedMultiplier.denominator));
+}
+/**
+ * Mirror max fees into priority fees.
+ * Aztec models both fee caps independently, but this SDK currently keeps them equal.
+ */
+export function maxPriorityFeesPerGasFromMaxFees(maxFeesPerGas) {
+    return maxFeesPerGas.clone();
 }
 /**
  * Calculate the maximum gas cost for a transaction.
@@ -57,4 +87,31 @@ export function maxGasCostFor(maxFeesPerGas, gasLimits) {
     return (BigInt(maxFeesPerGas.feePerDaGas) * BigInt(gasLimits.daGas) +
         BigInt(maxFeesPerGas.feePerL2Gas) * BigInt(gasLimits.l2Gas));
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2FzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RzL3V0aWxzL2dhcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsR0FBRyxFQUFFLE9BQU8sRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ2pELE9BQU8sRUFDTCxvQkFBb0IsRUFDcEIsb0JBQW9CLEVBQ3BCLDZCQUE2QixFQUM3Qiw2QkFBNkIsR0FDOUIsTUFBTSxrQkFBa0IsQ0FBQztBQUUxQjs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBRyxFQUFFLENBQUM7QUFFekM7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxHQUFHLENBQUMsSUFBSSxDQUFDO0lBQzVDLEtBQUssRUFBRSxvQkFBb0I7SUFDM0IsS0FBSyxFQUFFLG9CQUFvQjtDQUM1QixDQUFDLENBQUM7QUFFSDs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLENBQUMsTUFBTSw4QkFBOEIsR0FBRyxHQUFHLENBQUMsSUFBSSxDQUFDO0lBQ3JELEtBQUssRUFBRSw2QkFBNkI7SUFDcEMsS0FBSyxFQUFFLDZCQUE2QjtDQUNyQyxDQUFDLENBQUM7QUFFSDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSx5QkFBeUIsQ0FDdkMsUUFHQyxFQUNELGFBQXFCLHNCQUFzQjtJQUUzQyxPQUFPLElBQUksT0FBTyxDQUNoQixNQUFNLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBQyxHQUFHLFVBQVUsRUFDekMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQUMsR0FBRyxVQUFVLENBQzFDLENBQUM7QUFDSixDQUFDO0FBRUQ7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLFVBQVUsYUFBYSxDQUFDLGFBQXNCLEVBQUUsU0FBYztJQUNsRSxPQUFPLENBQ0wsTUFBTSxDQUFDLGFBQWEsQ0FBQyxXQUFXLENBQUMsR0FBRyxNQUFNLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQztRQUMzRCxNQUFNLENBQUMsYUFBYSxDQUFDLFdBQVcsQ0FBQyxHQUFHLE1BQU0sQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLENBQzVELENBQUM7QUFDSixDQUFDIn0=
+/**
+ * Simulate an interaction to derive tighter gas limits, then combine them with
+ * fee caps based on the node's current minimum fees.
+ */
+export async function estimateGasSettings(interaction, { aztecNode, from, paymentMethod, additionalScopes, maxFeeMultiplier = DEFAULT_FEE_MULTIPLIER, estimatedGasPadding = DEFAULT_GAS_ESTIMATE_PADDING, gasLimits = MAX_GAS_LIMITS, teardownGasLimits = FALLBACK_TEARDOWN_GAS_LIMITS, }) {
+    const maxFeesPerGas = maxFeesPerGasFromBaseFees(await aztecNode.getCurrentMinFees(), maxFeeMultiplier);
+    const maxPriorityFeesPerGas = maxPriorityFeesPerGasFromMaxFees(maxFeesPerGas);
+    const simulation = await interaction.simulate({
+        from,
+        additionalScopes,
+        includeMetadata: true,
+        fee: {
+            paymentMethod,
+            estimatedGasPadding,
+            gasSettings: {
+                gasLimits,
+                teardownGasLimits,
+                maxFeesPerGas,
+                maxPriorityFeesPerGas,
+            },
+        },
+    });
+    if (!simulation.estimatedGas) {
+        throw new Error("Gas estimation metadata was not returned by simulation.");
+    }
+    return new GasSettings(simulation.estimatedGas.gasLimits, simulation.estimatedGas.teardownGasLimits, maxFeesPerGas, maxPriorityFeesPerGas);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2FzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RzL3V0aWxzL2dhcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQ0wsR0FBRyxFQUNILE9BQU8sRUFDUCxXQUFXLEVBQ1gsZ0NBQWdDLEVBQ2hDLDhCQUE4QixFQUM5Qiw4QkFBOEIsR0FDL0IsTUFBTSxtQkFBbUIsQ0FBQztBQUMzQixPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQTZCMUQsTUFBTSxvQkFBb0IsR0FBRyxNQUFPLENBQUM7QUFDckMsTUFBTSxnQ0FBZ0MsR0FBRyxFQUFFLENBQUM7QUFDNUMsTUFBTSxrQ0FBa0MsR0FBRyxFQUFFLENBQUM7QUFTOUMsU0FBUyxPQUFPLENBQUMsU0FBaUIsRUFBRSxXQUFtQjtJQUNyRCxPQUFPLENBQUMsU0FBUyxHQUFHLFdBQVcsR0FBRyxFQUFFLENBQUMsR0FBRyxXQUFXLENBQUM7QUFDdEQsQ0FBQztBQUVELFNBQVMsbUJBQW1CLENBQUMsVUFBeUI7SUFJcEQsSUFBSSxPQUFPLFVBQVUsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUNuQyxJQUFJLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsSUFBSSxVQUFVLElBQUksQ0FBQyxFQUFFLENBQUM7WUFDcEQsTUFBTSxJQUFJLEtBQUssQ0FDYix3REFBd0QsVUFBVSxFQUFFLENBQ3JFLENBQUM7UUFDSixDQUFDO1FBRUQsT0FBTztZQUNMLFNBQVMsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLEdBQUcsTUFBTSxDQUFDLG9CQUFvQixDQUFDLENBQUMsQ0FBQztZQUN2RSxXQUFXLEVBQUUsb0JBQW9CO1NBQ2xDLENBQUM7SUFDSixDQUFDO0lBRUQsSUFBSSxVQUFVLENBQUMsV0FBVyxJQUFJLEVBQUUsSUFBSSxVQUFVLENBQUMsU0FBUyxJQUFJLEVBQUUsRUFBRSxDQUFDO1FBQy9E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

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

@@ -1,3 +1,4 @@
-export { DEFAULT_FEE_MULTIPLIER, REASONABLE_GAS_LIMITS, REASONABLE_TEARDOWN_GAS_LIMITS, maxFeesPerGasFromBaseFees, maxGasCostFor, } from "./gas.js";
-export { registerBridgedContract } from "./deploy.js";
+export type { FeeMultiplier } from "./gas.js";
+export { DEFAULT_FEE_MULTIPLIER, DEFAULT_GAS_ESTIMATE_PADDING, estimateGasSettings, maxFeesPerGasFromBaseFees, maxPriorityFeesPerGasFromMaxFees, maxGasCostFor, } from "./gas.js";
+export { registerPrivateContract } from "./deploy.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ts/utils/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,mBAAmB,EACnB,yBAAyB,EACzB,gCAAgC,EAChC,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

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

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