@panoptic-eng/sdk 1.0.37 → 1.0.39

package/dist/vault-transaction-fees.d.ts

@@ -0,0 +1,63 @@
+import { Chain, Client, Transport } from "viem";
+
+//#region src/hypoVault/transactionFees.d.ts
+declare const MIN_VAULT_PRIORITY_FEE_PER_GAS = 100000000n;
+declare const MAX_VAULT_PRIORITY_FEE_PER_GAS = 3000000000n;
+declare const MAX_VAULT_TRANSACTION_GAS_COST = 15000000000000000n;
+type VaultTransactionFeeQuote = {
+  maxFeePerGas: bigint;
+  maxPriorityFeePerGas: bigint;
+  minimumMaxFeePerGas: bigint;
+  source: 'fee_history' | 'viem_fallback';
+};
+type VaultSignedTransactionFeeCaps = {
+  gasLimit?: bigint | null;
+  maxFeePerGas: bigint | null;
+  maxPriorityFeePerGas: bigint | null;
+};
+type VaultSignedTransactionFeeValidationResult = {
+  valid: true;
+} | {
+  valid: false;
+  code: 'MissingEip1559Fees' | 'InvalidFeeCaps' | 'PriorityFeeTooLow' | 'PriorityFeeTooHigh' | 'MaxFeeTooLow' | 'GasCostTooHigh';
+  reason: string;
+};
+declare class VaultTransactionFeeEstimationError extends Error {
+  readonly feeHistoryError: unknown;
+  readonly fallbackError: unknown;
+  constructor({
+    feeHistoryError,
+    fallbackError
+  }: {
+    feeHistoryError: unknown;
+    fallbackError: unknown;
+  });
+}
+declare class VaultTransactionGasCostLimitError extends Error {
+  readonly gasLimit: bigint;
+  readonly maximumAffordableFeePerGas: bigint;
+  readonly minimumRequiredFeePerGas: bigint;
+  constructor({
+    gasLimit,
+    maximumAffordableFeePerGas,
+    minimumRequiredFeePerGas
+  }: {
+    gasLimit: bigint;
+    maximumAffordableFeePerGas: bigint;
+    minimumRequiredFeePerGas: bigint;
+  });
+}
+declare function applyVaultTransactionGasCostLimit(quote: VaultTransactionFeeQuote, gasLimit: bigint): VaultTransactionFeeQuote;
+declare function bufferVaultTransactionGasEstimate(gasEstimate: bigint): bigint;
+declare function validateVaultSignedTransactionFeeCaps(feeCaps: VaultSignedTransactionFeeCaps, quote?: VaultTransactionFeeQuote): VaultSignedTransactionFeeValidationResult;
+/**
+ * Resolve explicit EIP-1559 fees for operator-controlled vault transactions.
+ *
+ * The normal path follows the median p90 priority fee from the last 20 blocks,
+ * with a 0.1 gwei floor and 3 gwei ceiling. If fee history is unavailable,
+ * Viem's estimate is used while preserving those bounds and its original
+ * base-fee allowance.
+ */
+declare function getVaultTransactionFeeQuote<chain extends Chain | undefined>(client: Client<Transport, chain>): Promise<VaultTransactionFeeQuote>; //#endregion
+export { MAX_VAULT_PRIORITY_FEE_PER_GAS, MAX_VAULT_TRANSACTION_GAS_COST, MIN_VAULT_PRIORITY_FEE_PER_GAS, VaultSignedTransactionFeeCaps, VaultSignedTransactionFeeValidationResult, VaultTransactionFeeEstimationError, VaultTransactionFeeQuote, VaultTransactionGasCostLimitError, applyVaultTransactionGasCostLimit, bufferVaultTransactionGasEstimate, getVaultTransactionFeeQuote, validateVaultSignedTransactionFeeCaps };
+//# sourceMappingURL=vault-transaction-fees.d.ts.map

package/dist/vault-transaction-fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-transaction-fees.d.ts","names":["Chain","Client","Transport","MIN_VAULT_PRIORITY_FEE_PER_GAS","MAX_VAULT_PRIORITY_FEE_PER_GAS","MAX_VAULT_TRANSACTION_GAS_COST","VaultTransactionFeeQuote","VaultSignedTransactionFeeCaps","VaultSignedTransactionFeeValidationResult","VaultTransactionFeeEstimationError","feeHistoryError","fallbackError","Error","VaultTransactionGasCostLimitError","gasLimit","maximumAffordableFeePerGas","minimumRequiredFeePerGas","FeeHistorySnapshot","FallbackFeeEstimate","resolveFeeHistoryQuote","baseFeePerGas","reward","resolveFallbackQuote","estimatedMaxFeePerGas","estimatedPriorityFeePerGas","applyVaultTransactionGasCostLimit","bufferVaultTransactionGasEstimate","validateVaultSignedTransactionFeeCaps","resolveVaultTransactionFeeQuote","readFeeHistory","readFallbackEstimate","Promise","getVaultTransactionFeeQuote","chain","__transactionFeeTestUtils"],"sources":["../src/hypoVault/transactionFees.d.ts"],"sourcesContent":null,"mappings":";;;cACqBG,8BAAAA;cACAC,8BAAAA;AADAD,cAEAE,8BAAAA,GAF8B,kBAAA;AAC9BD,KAETE,wBAAAA,GAFuC;EAC9BD,YAAAA,EAAAA,MAAAA;EACTC,oBAAAA,EAAAA,MAAwB;EAMxBC,mBAAAA,EAAAA,MAAAA;EAKAC,MAAAA,EAAAA,aAAAA,GAAAA,eAAAA;AAOZ,CAAA;AAAuD,KAZ3CD,6BAAAA,GAY2C;EAAA,QAGrCG,CAAAA,EAAAA,MAAAA,GAAAA,IAAAA;EAAe,YAAEC,EAAAA,MAAAA,GAAAA,IAAAA;EAAa,oBAHgBC,EAAAA,MAAAA,GAAAA,IAAAA;AAAK,CAAA;AAQhDC,KAfTL,yCAAAA,GAe0C;EAAA,KAAA,EAAA,IAAA;CAAA,GAAA;EAI5B,KAAEO,EAAAA,KAAAA;EAA0B,IAAEC,EAAAA,oBAAAA,GAAAA,gBAAAA,GAAAA,mBAAAA,GAAAA,oBAAAA,GAAAA,cAAAA,GAAAA,gBAAAA;EAAwB,MAJjBJ,EAAAA,MAAAA;AAAK,CAAA;AA0B5Ca,cAlCHhB,kCAAAA,SAA2CG,KAAAA,CAkCP;EAAA,SAAA,eAAA,EAAA,OAAA;EAAA,SAAQN,aAAAA,EAAAA,OAAAA;EAAwB,WAAqBA,CAAAA;IAAAA,eAAAA;IAAAA;EAEtFqB,CAFsFrB,EAAAA;IAAwB,eAAA,EAAA,OAAA;IAC9GoB,aAAAA,EAAAA,OAAAA;EACAC,CAAAA;;AAA+CpB,cA5BlDM,iCAAAA,SAA0CD,KAAAA,CA4BQL;EAA6B,SAAUD,QAAAA,EAAAA,MAAAA;EAAwB,SAAGE,0BAAAA,EAAAA,MAAAA;EAAyC,SAAA,wBAAA,EAAA,MAAA;;;;;;;;;;;iBAF1JiB,iCAAAA,QAAyCnB,6CAA6CA;iBACtFoB,iCAAAA;iBACAC,qCAAAA,UAA+CpB,uCAAuCD,2BAA2BE;;;;;;;;;iBAajHwB,0CAA0ChC,2BAA2BC,OAAOC,WAAW+B,SAASF,QAAQzB"}

package/dist/vault-transaction-fees.js

@@ -0,0 +1,175 @@
+import { estimateFeesPerGas, getFeeHistory } from "viem/actions";
+
+//#region src/hypoVault/transactionFees.ts
+const MIN_VAULT_PRIORITY_FEE_PER_GAS = 100000000n;
+const MAX_VAULT_PRIORITY_FEE_PER_GAS = 3000000000n;
+const MAX_VAULT_TRANSACTION_GAS_COST = 15000000000000000n;
+const FEE_HISTORY_BLOCK_COUNT = 20;
+const FEE_HISTORY_REWARD_PERCENTILES = [90];
+const BASE_FEE_BUFFER_NUMERATOR = 1125n;
+const BASE_FEE_BUFFER_DENOMINATOR = 1000n;
+const GAS_ESTIMATE_BUFFER_NUMERATOR = 3n;
+const GAS_ESTIMATE_BUFFER_DENOMINATOR = 2n;
+var VaultTransactionFeeEstimationError = class extends Error {
+	feeHistoryError;
+	fallbackError;
+	constructor({ feeHistoryError, fallbackError }) {
+		super("Unable to estimate EIP-1559 fees for vault transaction");
+		this.name = "VaultTransactionFeeEstimationError";
+		this.feeHistoryError = feeHistoryError;
+		this.fallbackError = fallbackError;
+	}
+};
+var VaultTransactionGasCostLimitError = class extends Error {
+	gasLimit;
+	maximumAffordableFeePerGas;
+	minimumRequiredFeePerGas;
+	constructor({ gasLimit, maximumAffordableFeePerGas, minimumRequiredFeePerGas }) {
+		super(`Vault transaction cannot fit the ${MAX_VAULT_TRANSACTION_GAS_COST.toString()} wei gas-cost limit: gasLimit=${gasLimit.toString()}, maximumAffordableFeePerGas=${maximumAffordableFeePerGas.toString()}, minimumRequiredFeePerGas=${minimumRequiredFeePerGas.toString()}`);
+		this.name = "VaultTransactionGasCostLimitError";
+		this.gasLimit = gasLimit;
+		this.maximumAffordableFeePerGas = maximumAffordableFeePerGas;
+		this.minimumRequiredFeePerGas = minimumRequiredFeePerGas;
+	}
+};
+function ceilMultiplyFraction(value, numerator, denominator) {
+	return (value * numerator + denominator - 1n) / denominator;
+}
+function medianBigInt(values) {
+	if (values.length === 0) return void 0;
+	const sorted = [...values].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+	const upperMiddleIndex = Math.floor(sorted.length / 2);
+	const upperMiddle = sorted[upperMiddleIndex];
+	if (upperMiddle === void 0) return void 0;
+	if (sorted.length % 2 === 1) return upperMiddle;
+	const lowerMiddle = sorted[upperMiddleIndex - 1];
+	return lowerMiddle === void 0 ? void 0 : (lowerMiddle + upperMiddle) / 2n;
+}
+function clampPriorityFee(priorityFee) {
+	if (priorityFee < MIN_VAULT_PRIORITY_FEE_PER_GAS) return MIN_VAULT_PRIORITY_FEE_PER_GAS;
+	if (priorityFee > MAX_VAULT_PRIORITY_FEE_PER_GAS) return MAX_VAULT_PRIORITY_FEE_PER_GAS;
+	return priorityFee;
+}
+function resolveFeeHistoryQuote({ baseFeePerGas, reward }) {
+	const latestBaseFeeIndex = baseFeePerGas.length - 2;
+	if (latestBaseFeeIndex < 0 || reward === void 0 || reward.length === 0) return null;
+	const p90Rewards = reward.flatMap((blockRewards) => {
+		const p90 = blockRewards[0];
+		return p90 === void 0 ? [] : [p90];
+	});
+	const sampledPriorityFee = medianBigInt(p90Rewards);
+	if (sampledPriorityFee === void 0) return null;
+	const maxPriorityFeePerGas = clampPriorityFee(sampledPriorityFee);
+	const bufferedBaseFee = ceilMultiplyFraction(baseFeePerGas[latestBaseFeeIndex], BASE_FEE_BUFFER_NUMERATOR, BASE_FEE_BUFFER_DENOMINATOR);
+	return {
+		maxFeePerGas: bufferedBaseFee + maxPriorityFeePerGas,
+		maxPriorityFeePerGas,
+		minimumMaxFeePerGas: bufferedBaseFee + MIN_VAULT_PRIORITY_FEE_PER_GAS,
+		source: "fee_history"
+	};
+}
+function resolveFallbackQuote({ maxFeePerGas: estimatedMaxFeePerGas, maxPriorityFeePerGas: estimatedPriorityFeePerGas }) {
+	const maxPriorityFeePerGas = clampPriorityFee(estimatedPriorityFeePerGas);
+	const estimatedBaseFeeAllowance = estimatedMaxFeePerGas > estimatedPriorityFeePerGas ? estimatedMaxFeePerGas - estimatedPriorityFeePerGas : 0n;
+	return {
+		maxFeePerGas: estimatedBaseFeeAllowance + maxPriorityFeePerGas,
+		maxPriorityFeePerGas,
+		minimumMaxFeePerGas: estimatedBaseFeeAllowance + MIN_VAULT_PRIORITY_FEE_PER_GAS,
+		source: "viem_fallback"
+	};
+}
+function applyVaultTransactionGasCostLimit(quote, gasLimit) {
+	if (gasLimit <= 0n) throw new Error(`Vault transaction gas limit must be positive, received ${gasLimit.toString()}`);
+	const maximumAffordableFeePerGas = MAX_VAULT_TRANSACTION_GAS_COST / gasLimit;
+	if (maximumAffordableFeePerGas < quote.minimumMaxFeePerGas) throw new VaultTransactionGasCostLimitError({
+		gasLimit,
+		maximumAffordableFeePerGas,
+		minimumRequiredFeePerGas: quote.minimumMaxFeePerGas
+	});
+	if (quote.maxFeePerGas <= maximumAffordableFeePerGas) return quote;
+	const bufferedBaseFee = quote.minimumMaxFeePerGas - MIN_VAULT_PRIORITY_FEE_PER_GAS;
+	const affordablePriorityFee = maximumAffordableFeePerGas - bufferedBaseFee;
+	return {
+		...quote,
+		maxFeePerGas: maximumAffordableFeePerGas,
+		maxPriorityFeePerGas: quote.maxPriorityFeePerGas < affordablePriorityFee ? quote.maxPriorityFeePerGas : affordablePriorityFee
+	};
+}
+function bufferVaultTransactionGasEstimate(gasEstimate) {
+	if (gasEstimate <= 0n) throw new Error(`Vault transaction gas estimate must be positive, received ${gasEstimate.toString()}`);
+	return ceilMultiplyFraction(gasEstimate, GAS_ESTIMATE_BUFFER_NUMERATOR, GAS_ESTIMATE_BUFFER_DENOMINATOR);
+}
+function validateVaultSignedTransactionFeeCaps(feeCaps, quote) {
+	const { gasLimit, maxFeePerGas, maxPriorityFeePerGas } = feeCaps;
+	if (maxFeePerGas === null || maxPriorityFeePerGas === null) return {
+		valid: false,
+		code: "MissingEip1559Fees",
+		reason: "Signed transaction must include EIP-1559 max fee and priority fee caps."
+	};
+	if (maxPriorityFeePerGas > maxFeePerGas) return {
+		valid: false,
+		code: "InvalidFeeCaps",
+		reason: `Signed transaction maxPriorityFeePerGas (${maxPriorityFeePerGas.toString()} wei) cannot exceed maxFeePerGas (${maxFeePerGas.toString()} wei).`
+	};
+	if (maxPriorityFeePerGas < MIN_VAULT_PRIORITY_FEE_PER_GAS) return {
+		valid: false,
+		code: "PriorityFeeTooLow",
+		reason: `Signed transaction maxPriorityFeePerGas (${maxPriorityFeePerGas.toString()} wei) must be at least ${MIN_VAULT_PRIORITY_FEE_PER_GAS.toString()} wei (0.1 gwei).`
+	};
+	if (maxPriorityFeePerGas > MAX_VAULT_PRIORITY_FEE_PER_GAS) return {
+		valid: false,
+		code: "PriorityFeeTooHigh",
+		reason: `Signed transaction maxPriorityFeePerGas (${maxPriorityFeePerGas.toString()} wei) must not exceed ${MAX_VAULT_PRIORITY_FEE_PER_GAS.toString()} wei (3 gwei).`
+	};
+	if (gasLimit !== void 0 && gasLimit !== null && gasLimit * maxFeePerGas > MAX_VAULT_TRANSACTION_GAS_COST) return {
+		valid: false,
+		code: "GasCostTooHigh",
+		reason: `Signed transaction maximum gas cost (${(gasLimit * maxFeePerGas).toString()} wei) must not exceed ${MAX_VAULT_TRANSACTION_GAS_COST.toString()} wei (0.015 ETH).`
+	};
+	if (quote !== void 0 && maxFeePerGas < quote.minimumMaxFeePerGas) return {
+		valid: false,
+		code: "MaxFeeTooLow",
+		reason: `Signed transaction maxFeePerGas (${maxFeePerGas.toString()} wei) must be at least ${quote.minimumMaxFeePerGas.toString()} wei for the buffered next-block base fee and 0.1 gwei minimum priority fee.`
+	};
+	return { valid: true };
+}
+async function resolveVaultTransactionFeeQuote({ readFeeHistory, readFallbackEstimate }) {
+	let feeHistoryError;
+	try {
+		const quote = resolveFeeHistoryQuote(await readFeeHistory());
+		if (quote !== null) return quote;
+		feeHistoryError = new Error("eth_feeHistory returned incomplete base fee or reward data");
+	} catch (error) {
+		feeHistoryError = error;
+	}
+	try {
+		return resolveFallbackQuote(await readFallbackEstimate());
+	} catch (fallbackError) {
+		throw new VaultTransactionFeeEstimationError({
+			feeHistoryError,
+			fallbackError
+		});
+	}
+}
+/**
+* Resolve explicit EIP-1559 fees for operator-controlled vault transactions.
+*
+* The normal path follows the median p90 priority fee from the last 20 blocks,
+* with a 0.1 gwei floor and 3 gwei ceiling. If fee history is unavailable,
+* Viem's estimate is used while preserving those bounds and its original
+* base-fee allowance.
+*/
+async function getVaultTransactionFeeQuote(client) {
+	return resolveVaultTransactionFeeQuote({
+		readFeeHistory: () => getFeeHistory(client, {
+			blockCount: FEE_HISTORY_BLOCK_COUNT,
+			blockTag: "latest",
+			rewardPercentiles: FEE_HISTORY_REWARD_PERCENTILES
+		}),
+		readFallbackEstimate: () => estimateFeesPerGas(client)
+	});
+}
+
+//#endregion
+export { MAX_VAULT_PRIORITY_FEE_PER_GAS, MAX_VAULT_TRANSACTION_GAS_COST, MIN_VAULT_PRIORITY_FEE_PER_GAS, VaultTransactionFeeEstimationError, VaultTransactionGasCostLimitError, applyVaultTransactionGasCostLimit, bufferVaultTransactionGasEstimate, getVaultTransactionFeeQuote, validateVaultSignedTransactionFeeCaps };
+//# sourceMappingURL=vault-transaction-fees.js.map

package/dist/vault-transaction-fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-transaction-fees.js","names":["value: bigint","numerator: bigint","denominator: bigint","values: readonly bigint[]","priorityFee: bigint","quote: VaultTransactionFeeQuote","gasLimit: bigint","gasEstimate: bigint","feeCaps: VaultSignedTransactionFeeCaps","quote?: VaultTransactionFeeQuote","feeHistoryError: unknown","client: Client<Transport, chain>"],"sources":["../src/hypoVault/transactionFees.ts"],"sourcesContent":["import type { Chain, Client, Transport } from 'viem'\nimport { estimateFeesPerGas, getFeeHistory } from 'viem/actions'\n\nexport const MIN_VAULT_PRIORITY_FEE_PER_GAS = 100_000_000n // 0.1 gwei\nexport const MAX_VAULT_PRIORITY_FEE_PER_GAS = 3_000_000_000n // 3 gwei\nexport const MAX_VAULT_TRANSACTION_GAS_COST = 15_000_000_000_000_000n // 0.015 ETH\n\nconst FEE_HISTORY_BLOCK_COUNT = 20\nconst FEE_HISTORY_REWARD_PERCENTILES = [90]\nconst BASE_FEE_BUFFER_NUMERATOR = 1_125n\nconst BASE_FEE_BUFFER_DENOMINATOR = 1_000n\nconst GAS_ESTIMATE_BUFFER_NUMERATOR = 3n\nconst GAS_ESTIMATE_BUFFER_DENOMINATOR = 2n\n\nexport type VaultTransactionFeeQuote = {\n  maxFeePerGas: bigint\n  maxPriorityFeePerGas: bigint\n  minimumMaxFeePerGas: bigint\n  source: 'fee_history' | 'viem_fallback'\n}\n\nexport type VaultSignedTransactionFeeCaps = {\n  gasLimit?: bigint | null\n  maxFeePerGas: bigint | null\n  maxPriorityFeePerGas: bigint | null\n}\n\nexport type VaultSignedTransactionFeeValidationResult =\n  | { valid: true }\n  | {\n      valid: false\n      code:\n        | 'MissingEip1559Fees'\n        | 'InvalidFeeCaps'\n        | 'PriorityFeeTooLow'\n        | 'PriorityFeeTooHigh'\n        | 'MaxFeeTooLow'\n        | 'GasCostTooHigh'\n      reason: string\n    }\n\nexport class VaultTransactionFeeEstimationError extends Error {\n  readonly feeHistoryError: unknown\n  readonly fallbackError: unknown\n\n  constructor({\n    feeHistoryError,\n    fallbackError,\n  }: {\n    feeHistoryError: unknown\n    fallbackError: unknown\n  }) {\n    super('Unable to estimate EIP-1559 fees for vault transaction')\n    this.name = 'VaultTransactionFeeEstimationError'\n    this.feeHistoryError = feeHistoryError\n    this.fallbackError = fallbackError\n  }\n}\n\nexport class VaultTransactionGasCostLimitError extends Error {\n  readonly gasLimit: bigint\n  readonly maximumAffordableFeePerGas: bigint\n  readonly minimumRequiredFeePerGas: bigint\n\n  constructor({\n    gasLimit,\n    maximumAffordableFeePerGas,\n    minimumRequiredFeePerGas,\n  }: {\n    gasLimit: bigint\n    maximumAffordableFeePerGas: bigint\n    minimumRequiredFeePerGas: bigint\n  }) {\n    super(\n      `Vault transaction cannot fit the ${MAX_VAULT_TRANSACTION_GAS_COST.toString()} wei gas-cost limit: ` +\n        `gasLimit=${gasLimit.toString()}, maximumAffordableFeePerGas=${maximumAffordableFeePerGas.toString()}, ` +\n        `minimumRequiredFeePerGas=${minimumRequiredFeePerGas.toString()}`,\n    )\n    this.name = 'VaultTransactionGasCostLimitError'\n    this.gasLimit = gasLimit\n    this.maximumAffordableFeePerGas = maximumAffordableFeePerGas\n    this.minimumRequiredFeePerGas = minimumRequiredFeePerGas\n  }\n}\n\ntype FeeHistorySnapshot = {\n  baseFeePerGas: readonly bigint[]\n  reward?: readonly (readonly bigint[])[] | undefined\n}\n\ntype FallbackFeeEstimate = {\n  maxFeePerGas: bigint\n  maxPriorityFeePerGas: bigint\n}\n\nfunction ceilMultiplyFraction(value: bigint, numerator: bigint, denominator: bigint): bigint {\n  return (value * numerator + denominator - 1n) / denominator\n}\n\nfunction medianBigInt(values: readonly bigint[]): bigint | undefined {\n  if (values.length === 0) return undefined\n  const sorted = [...values].sort((left, right) => (left < right ? -1 : left > right ? 1 : 0))\n  const upperMiddleIndex = Math.floor(sorted.length / 2)\n  const upperMiddle = sorted[upperMiddleIndex]\n  if (upperMiddle === undefined) return undefined\n  if (sorted.length % 2 === 1) return upperMiddle\n  const lowerMiddle = sorted[upperMiddleIndex - 1]\n  return lowerMiddle === undefined ? undefined : (lowerMiddle + upperMiddle) / 2n\n}\n\nfunction clampPriorityFee(priorityFee: bigint): bigint {\n  if (priorityFee < MIN_VAULT_PRIORITY_FEE_PER_GAS) return MIN_VAULT_PRIORITY_FEE_PER_GAS\n  if (priorityFee > MAX_VAULT_PRIORITY_FEE_PER_GAS) return MAX_VAULT_PRIORITY_FEE_PER_GAS\n  return priorityFee\n}\n\nfunction resolveFeeHistoryQuote({\n  baseFeePerGas,\n  reward,\n}: {\n  baseFeePerGas: readonly bigint[]\n  reward?: readonly (readonly bigint[])[] | undefined\n}): VaultTransactionFeeQuote | null {\n  // feeHistory includes one additional base fee for the next block. The\n  // second-to-last entry is therefore the latest mined block's base fee.\n  const latestBaseFeeIndex = baseFeePerGas.length - 2\n  if (latestBaseFeeIndex < 0 || reward === undefined || reward.length === 0) return null\n\n  const p90Rewards = reward.flatMap((blockRewards) => {\n    const p90 = blockRewards[0]\n    return p90 === undefined ? [] : [p90]\n  })\n  const sampledPriorityFee = medianBigInt(p90Rewards)\n  if (sampledPriorityFee === undefined) return null\n\n  const maxPriorityFeePerGas = clampPriorityFee(sampledPriorityFee)\n  const bufferedBaseFee = ceilMultiplyFraction(\n    baseFeePerGas[latestBaseFeeIndex],\n    BASE_FEE_BUFFER_NUMERATOR,\n    BASE_FEE_BUFFER_DENOMINATOR,\n  )\n\n  return {\n    maxFeePerGas: bufferedBaseFee + maxPriorityFeePerGas,\n    maxPriorityFeePerGas,\n    minimumMaxFeePerGas: bufferedBaseFee + MIN_VAULT_PRIORITY_FEE_PER_GAS,\n    source: 'fee_history',\n  }\n}\n\nfunction resolveFallbackQuote({\n  maxFeePerGas: estimatedMaxFeePerGas,\n  maxPriorityFeePerGas: estimatedPriorityFeePerGas,\n}: {\n  maxFeePerGas: bigint\n  maxPriorityFeePerGas: bigint\n}): VaultTransactionFeeQuote {\n  const maxPriorityFeePerGas = clampPriorityFee(estimatedPriorityFeePerGas)\n  const estimatedBaseFeeAllowance =\n    estimatedMaxFeePerGas > estimatedPriorityFeePerGas\n      ? estimatedMaxFeePerGas - estimatedPriorityFeePerGas\n      : 0n\n\n  return {\n    maxFeePerGas: estimatedBaseFeeAllowance + maxPriorityFeePerGas,\n    maxPriorityFeePerGas,\n    minimumMaxFeePerGas: estimatedBaseFeeAllowance + MIN_VAULT_PRIORITY_FEE_PER_GAS,\n    source: 'viem_fallback',\n  }\n}\n\nexport function applyVaultTransactionGasCostLimit(\n  quote: VaultTransactionFeeQuote,\n  gasLimit: bigint,\n): VaultTransactionFeeQuote {\n  if (gasLimit <= 0n) {\n    throw new Error(`Vault transaction gas limit must be positive, received ${gasLimit.toString()}`)\n  }\n\n  const maximumAffordableFeePerGas = MAX_VAULT_TRANSACTION_GAS_COST / gasLimit\n  if (maximumAffordableFeePerGas < quote.minimumMaxFeePerGas) {\n    throw new VaultTransactionGasCostLimitError({\n      gasLimit,\n      maximumAffordableFeePerGas,\n      minimumRequiredFeePerGas: quote.minimumMaxFeePerGas,\n    })\n  }\n\n  if (quote.maxFeePerGas <= maximumAffordableFeePerGas) return quote\n\n  const bufferedBaseFee = quote.minimumMaxFeePerGas - MIN_VAULT_PRIORITY_FEE_PER_GAS\n  const affordablePriorityFee = maximumAffordableFeePerGas - bufferedBaseFee\n  return {\n    ...quote,\n    maxFeePerGas: maximumAffordableFeePerGas,\n    maxPriorityFeePerGas:\n      quote.maxPriorityFeePerGas < affordablePriorityFee\n        ? quote.maxPriorityFeePerGas\n        : affordablePriorityFee,\n  }\n}\n\nexport function bufferVaultTransactionGasEstimate(gasEstimate: bigint): bigint {\n  if (gasEstimate <= 0n) {\n    throw new Error(\n      `Vault transaction gas estimate must be positive, received ${gasEstimate.toString()}`,\n    )\n  }\n  return ceilMultiplyFraction(\n    gasEstimate,\n    GAS_ESTIMATE_BUFFER_NUMERATOR,\n    GAS_ESTIMATE_BUFFER_DENOMINATOR,\n  )\n}\n\nexport function validateVaultSignedTransactionFeeCaps(\n  feeCaps: VaultSignedTransactionFeeCaps,\n  quote?: VaultTransactionFeeQuote,\n): VaultSignedTransactionFeeValidationResult {\n  const { gasLimit, maxFeePerGas, maxPriorityFeePerGas } = feeCaps\n  if (maxFeePerGas === null || maxPriorityFeePerGas === null) {\n    return {\n      valid: false,\n      code: 'MissingEip1559Fees',\n      reason: 'Signed transaction must include EIP-1559 max fee and priority fee caps.',\n    }\n  }\n  if (maxPriorityFeePerGas > maxFeePerGas) {\n    return {\n      valid: false,\n      code: 'InvalidFeeCaps',\n      reason:\n        `Signed transaction maxPriorityFeePerGas (${maxPriorityFeePerGas.toString()} wei) ` +\n        `cannot exceed maxFeePerGas (${maxFeePerGas.toString()} wei).`,\n    }\n  }\n  if (maxPriorityFeePerGas < MIN_VAULT_PRIORITY_FEE_PER_GAS) {\n    return {\n      valid: false,\n      code: 'PriorityFeeTooLow',\n      reason:\n        `Signed transaction maxPriorityFeePerGas (${maxPriorityFeePerGas.toString()} wei) ` +\n        `must be at least ${MIN_VAULT_PRIORITY_FEE_PER_GAS.toString()} wei (0.1 gwei).`,\n    }\n  }\n  if (maxPriorityFeePerGas > MAX_VAULT_PRIORITY_FEE_PER_GAS) {\n    return {\n      valid: false,\n      code: 'PriorityFeeTooHigh',\n      reason:\n        `Signed transaction maxPriorityFeePerGas (${maxPriorityFeePerGas.toString()} wei) ` +\n        `must not exceed ${MAX_VAULT_PRIORITY_FEE_PER_GAS.toString()} wei (3 gwei).`,\n    }\n  }\n  if (\n    gasLimit !== undefined &&\n    gasLimit !== null &&\n    gasLimit * maxFeePerGas > MAX_VAULT_TRANSACTION_GAS_COST\n  ) {\n    return {\n      valid: false,\n      code: 'GasCostTooHigh',\n      reason:\n        `Signed transaction maximum gas cost (${(gasLimit * maxFeePerGas).toString()} wei) ` +\n        `must not exceed ${MAX_VAULT_TRANSACTION_GAS_COST.toString()} wei (0.015 ETH).`,\n    }\n  }\n  if (quote !== undefined && maxFeePerGas < quote.minimumMaxFeePerGas) {\n    return {\n      valid: false,\n      code: 'MaxFeeTooLow',\n      reason:\n        `Signed transaction maxFeePerGas (${maxFeePerGas.toString()} wei) must be at least ` +\n        `${quote.minimumMaxFeePerGas.toString()} wei for the buffered next-block base fee ` +\n        'and 0.1 gwei minimum priority fee.',\n    }\n  }\n  return { valid: true }\n}\n\nasync function resolveVaultTransactionFeeQuote({\n  readFeeHistory,\n  readFallbackEstimate,\n}: {\n  readFeeHistory: () => Promise<FeeHistorySnapshot>\n  readFallbackEstimate: () => Promise<FallbackFeeEstimate>\n}): Promise<VaultTransactionFeeQuote> {\n  let feeHistoryError: unknown\n  try {\n    const quote = resolveFeeHistoryQuote(await readFeeHistory())\n    if (quote !== null) return quote\n    feeHistoryError = new Error('eth_feeHistory returned incomplete base fee or reward data')\n  } catch (error) {\n    feeHistoryError = error\n  }\n\n  try {\n    return resolveFallbackQuote(await readFallbackEstimate())\n  } catch (fallbackError) {\n    throw new VaultTransactionFeeEstimationError({ feeHistoryError, fallbackError })\n  }\n}\n\n/**\n * Resolve explicit EIP-1559 fees for operator-controlled vault transactions.\n *\n * The normal path follows the median p90 priority fee from the last 20 blocks,\n * with a 0.1 gwei floor and 3 gwei ceiling. If fee history is unavailable,\n * Viem's estimate is used while preserving those bounds and its original\n * base-fee allowance.\n */\nexport async function getVaultTransactionFeeQuote<chain extends Chain | undefined>(\n  client: Client<Transport, chain>,\n): Promise<VaultTransactionFeeQuote> {\n  return resolveVaultTransactionFeeQuote({\n    readFeeHistory: () =>\n      getFeeHistory(client, {\n        blockCount: FEE_HISTORY_BLOCK_COUNT,\n        blockTag: 'latest',\n        rewardPercentiles: FEE_HISTORY_REWARD_PERCENTILES,\n      }),\n    readFallbackEstimate: () => estimateFeesPerGas(client),\n  })\n}\n\nexport const __transactionFeeTestUtils = {\n  resolveFallbackQuote,\n  resolveFeeHistoryQuote,\n  resolveVaultTransactionFeeQuote,\n}\n"],"mappings":"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"}