@panoptic-eng/sdk 1.0.49 → 1.0.51

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

@@ -3,6 +3,7 @@ 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_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS = 8000000000n;
 declare const MAX_VAULT_TRANSACTION_GAS_COST = 15000000000000000n;
 type VaultTransactionFeeQuote = {
   maxFeePerGas: bigint;
@@ -51,7 +52,7 @@ declare class VaultTransactionGasCostLimitError extends Error {
   });
 }
 declare class VaultTransactionReplacementLimitError extends Error {
-  readonly code: 'GasCostCapExceeded';
+  readonly code: 'GasCostCapExceeded' | 'PriorityFeeCapExceeded';
   readonly requiredMaxFeePerGas: bigint;
   readonly requiredMaxPriorityFeePerGas: bigint;
   readonly maximumAffordableFeePerGas: bigint;
@@ -62,7 +63,7 @@ declare class VaultTransactionReplacementLimitError extends Error {
     requiredMaxPriorityFeePerGas,
     maximumAffordableFeePerGas
   }: {
-    code: 'GasCostCapExceeded';
+    code: 'GasCostCapExceeded' | 'PriorityFeeCapExceeded';
     gasLimit: bigint;
     requiredMaxFeePerGas: bigint;
     requiredMaxPriorityFeePerGas: bigint;
@@ -72,11 +73,15 @@ declare class VaultTransactionReplacementLimitError extends Error {
 declare function getVaultTransactionReplacementFeeQuote({
   originalQuote,
   historicalQuote,
-  gasLimit
+  gasLimit,
+  finalReplacement,
+  staleBoundsReplacement
 }: {
   originalQuote: Pick<VaultTransactionFeeQuote, 'maxFeePerGas' | 'maxPriorityFeePerGas'>;
   historicalQuote: VaultDeltaHedgeFeeQuote;
   gasLimit: bigint;
+  finalReplacement?: boolean;
+  staleBoundsReplacement?: boolean;
 }): VaultDeltaHedgeFeeQuote;
 declare function applyVaultTransactionGasCostLimit(quote: VaultTransactionFeeQuote, gasLimit: bigint): VaultTransactionFeeQuote;
 declare function bufferVaultTransactionGasEstimate(gasEstimate: bigint): bigint;
@@ -97,5 +102,5 @@ declare function getVaultDeltaHedgeHistoricalFeeQuote<chain extends Chain | unde
  * back immediately to the rolling historical p25 quote.
  */
 declare function getVaultDeltaHedgeInitialFeeQuote<chain extends Chain | undefined>(client: Client<Transport, chain>): Promise<VaultDeltaHedgeFeeQuote>; //#endregion
-export { MAX_VAULT_PRIORITY_FEE_PER_GAS, MAX_VAULT_TRANSACTION_GAS_COST, MIN_VAULT_PRIORITY_FEE_PER_GAS, VaultDeltaHedgeFeeQuote, VaultSignedTransactionFeeCaps, VaultSignedTransactionFeeValidationResult, VaultTransactionFeeEstimationError, VaultTransactionFeeQuote, VaultTransactionGasCostLimitError, VaultTransactionReplacementLimitError, applyVaultTransactionGasCostLimit, bufferVaultTransactionGasEstimate, getVaultDeltaHedgeHistoricalFeeQuote, getVaultDeltaHedgeInitialFeeQuote, getVaultTransactionFeeQuote, getVaultTransactionReplacementFeeQuote, validateVaultSignedTransactionFeeCaps };
+export { MAX_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS, MAX_VAULT_PRIORITY_FEE_PER_GAS, MAX_VAULT_TRANSACTION_GAS_COST, MIN_VAULT_PRIORITY_FEE_PER_GAS, VaultDeltaHedgeFeeQuote, VaultSignedTransactionFeeCaps, VaultSignedTransactionFeeValidationResult, VaultTransactionFeeEstimationError, VaultTransactionFeeQuote, VaultTransactionGasCostLimitError, VaultTransactionReplacementLimitError, applyVaultTransactionGasCostLimit, bufferVaultTransactionGasEstimate, getVaultDeltaHedgeHistoricalFeeQuote, getVaultDeltaHedgeInitialFeeQuote, getVaultTransactionFeeQuote, getVaultTransactionReplacementFeeQuote, validateVaultSignedTransactionFeeCaps };
 //# sourceMappingURL=vault-transaction-fees.d.ts.map

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

@@ -1 +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","VaultDeltaHedgeFeeQuote","VaultSignedTransactionFeeCaps","VaultSignedTransactionFeeValidationResult","VaultTransactionFeeEstimationError","feeHistoryError","fallbackError","Error","VaultTransactionGasCostLimitError","gasLimit","maximumAffordableFeePerGas","minimumRequiredFeePerGas","VaultTransactionReplacementLimitError","code","requiredMaxFeePerGas","requiredMaxPriorityFeePerGas","FeeHistorySnapshot","FallbackFeeEstimate","clampPriorityFee","resolveFeeHistoryQuote","baseFeePerGas","reward","resolveDeltaHedgeFeeHistoryQuote","resolveRpcPriorityFeeQuote","rawPriorityFeePerGas","getVaultTransactionReplacementFeeQuote","originalQuote","historicalQuote","Pick","resolveFallbackQuote","estimatedMaxFeePerGas","estimatedPriorityFeePerGas","applyVaultTransactionGasCostLimit","bufferVaultTransactionGasEstimate","validateVaultSignedTransactionFeeCaps","resolveVaultTransactionFeeQuote","readFeeHistory","readFallbackEstimate","Promise","getVaultTransactionFeeQuote","chain","getVaultDeltaHedgeHistoricalFeeQuote","resolveVaultDeltaHedgeInitialFeeQuote","readRpcQuote","readHistoricalQuote","getVaultDeltaHedgeInitialFeeQuote","__transactionFeeTestUtils"],"sources":["../src/hypoVault/transactionFees.d.ts"],"sourcesContent":null,"mappings":"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"}
+{"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_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS","MAX_VAULT_TRANSACTION_GAS_COST","VaultTransactionFeeQuote","VaultDeltaHedgeFeeQuote","VaultSignedTransactionFeeCaps","VaultSignedTransactionFeeValidationResult","VaultTransactionFeeEstimationError","feeHistoryError","fallbackError","Error","VaultTransactionGasCostLimitError","gasLimit","maximumAffordableFeePerGas","minimumRequiredFeePerGas","VaultTransactionReplacementLimitError","code","requiredMaxFeePerGas","requiredMaxPriorityFeePerGas","FeeHistorySnapshot","FallbackFeeEstimate","clampPriorityFee","resolveFeeHistoryQuote","baseFeePerGas","reward","resolveDeltaHedgeFeeHistoryQuote","resolveRpcPriorityFeeQuote","rawPriorityFeePerGas","getVaultTransactionReplacementFeeQuote","originalQuote","historicalQuote","finalReplacement","staleBoundsReplacement","Pick","resolveFallbackQuote","estimatedMaxFeePerGas","estimatedPriorityFeePerGas","applyVaultTransactionGasCostLimit","bufferVaultTransactionGasEstimate","validateVaultSignedTransactionFeeCaps","resolveVaultTransactionFeeQuote","readFeeHistory","readFallbackEstimate","Promise","getVaultTransactionFeeQuote","chain","getVaultDeltaHedgeHistoricalFeeQuote","resolveVaultDeltaHedgeInitialFeeQuote","readRpcQuote","readHistoricalQuote","getVaultDeltaHedgeInitialFeeQuote","__transactionFeeTestUtils"],"sources":["../src/hypoVault/transactionFees.d.ts"],"sourcesContent":null,"mappings":"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"}

package/dist/vault-transaction-fees.js

@@ -4,6 +4,7 @@ import { estimateFeesPerGas, getBlock, 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_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS = 8000000000n;
 const MAX_VAULT_TRANSACTION_GAS_COST = 15000000000000000n;
 const FEE_HISTORY_BLOCK_COUNT = 20;
 const FEE_HISTORY_REWARD_PERCENTILES = [90];
@@ -12,6 +13,9 @@ const BASE_FEE_BUFFER_NUMERATOR = 1125n;
 const BASE_FEE_BUFFER_DENOMINATOR = 1000n;
 const REPLACEMENT_FEE_BUMP_NUMERATOR = 1125n;
 const REPLACEMENT_FEE_BUMP_DENOMINATOR = 1000n;
+const DELTA_HEDGE_PRIORITY_FEE_BUMP_NUMERATOR = 1300n;
+const DELTA_HEDGE_PRIORITY_FEE_BUMP_DENOMINATOR = 1000n;
+const MAX_DELTA_HEDGE_PRIORITY_FEE_PER_GAS = MAX_VAULT_PRIORITY_FEE_PER_GAS * REPLACEMENT_FEE_BUMP_DENOMINATOR / REPLACEMENT_FEE_BUMP_NUMERATOR;
 const GAS_ESTIMATE_BUFFER_NUMERATOR = 3n;
 const GAS_ESTIMATE_BUFFER_DENOMINATOR = 2n;
 var VaultTransactionFeeEstimationError = class extends Error {
@@ -115,25 +119,37 @@ function resolveRpcPriorityFeeQuote({ baseFeePerGas, rawPriorityFeePerGas }) {
 		source: "rpc_priority_fee"
 	};
 }
-function getVaultTransactionReplacementFeeQuote({ originalQuote, historicalQuote, gasLimit }) {
+function getVaultTransactionReplacementFeeQuote({ originalQuote, historicalQuote, gasLimit, finalReplacement = false, staleBoundsReplacement = false }) {
 	if (gasLimit <= 0n) throw new Error(`Vault transaction gas limit must be positive, received ${gasLimit.toString()}`);
-	const bumpedPriorityFee = ceilMultiplyFraction(originalQuote.maxPriorityFeePerGas, REPLACEMENT_FEE_BUMP_NUMERATOR, REPLACEMENT_FEE_BUMP_DENOMINATOR);
+	const bumpedPriorityFee = staleBoundsReplacement ? ceilMultiplyFraction(originalQuote.maxPriorityFeePerGas, REPLACEMENT_FEE_BUMP_NUMERATOR, REPLACEMENT_FEE_BUMP_DENOMINATOR) : ceilMultiplyFraction(originalQuote.maxPriorityFeePerGas, DELTA_HEDGE_PRIORITY_FEE_BUMP_NUMERATOR, DELTA_HEDGE_PRIORITY_FEE_BUMP_DENOMINATOR);
 	const bumpedMaxFee = ceilMultiplyFraction(originalQuote.maxFeePerGas, REPLACEMENT_FEE_BUMP_NUMERATOR, REPLACEMENT_FEE_BUMP_DENOMINATOR);
-	const requiredMaxPriorityFeePerGas = historicalQuote.maxPriorityFeePerGas > bumpedPriorityFee ? historicalQuote.maxPriorityFeePerGas : bumpedPriorityFee;
+	const escalatingPriorityFee = historicalQuote.maxPriorityFeePerGas > bumpedPriorityFee ? historicalQuote.maxPriorityFeePerGas : bumpedPriorityFee;
+	const priorityFeeLimit = staleBoundsReplacement ? MAX_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS : finalReplacement ? MAX_VAULT_PRIORITY_FEE_PER_GAS : MAX_DELTA_HEDGE_PRIORITY_FEE_PER_GAS;
+	const desiredMaxPriorityFeePerGas = finalReplacement ? MAX_VAULT_PRIORITY_FEE_PER_GAS : staleBoundsReplacement ? bumpedPriorityFee : escalatingPriorityFee;
+	const requiredReplacementPriorityFee = ceilMultiplyFraction(originalQuote.maxPriorityFeePerGas, REPLACEMENT_FEE_BUMP_NUMERATOR, REPLACEMENT_FEE_BUMP_DENOMINATOR);
+	const requiredMaxPriorityFeePerGas = desiredMaxPriorityFeePerGas < priorityFeeLimit ? desiredMaxPriorityFeePerGas : priorityFeeLimit;
+	if (requiredMaxPriorityFeePerGas < requiredReplacementPriorityFee) throw new VaultTransactionReplacementLimitError({
+		code: "PriorityFeeCapExceeded",
+		gasLimit,
+		requiredMaxFeePerGas: originalQuote.maxFeePerGas,
+		requiredMaxPriorityFeePerGas: requiredReplacementPriorityFee,
+		maximumAffordableFeePerGas: MAX_VAULT_TRANSACTION_GAS_COST / gasLimit
+	});
 	const bufferedBaseFee = historicalQuote.minimumMaxFeePerGas - MIN_VAULT_PRIORITY_FEE_PER_GAS;
 	const currentMarketMaxFee = bufferedBaseFee + requiredMaxPriorityFeePerGas;
-	const requiredMaxFeePerGas = currentMarketMaxFee > bumpedMaxFee ? currentMarketMaxFee : bumpedMaxFee;
+	const desiredMaxFeePerGas = currentMarketMaxFee > bumpedMaxFee ? currentMarketMaxFee : bumpedMaxFee;
 	const maximumAffordableFeePerGas = MAX_VAULT_TRANSACTION_GAS_COST / gasLimit;
-	if (requiredMaxFeePerGas > maximumAffordableFeePerGas) throw new VaultTransactionReplacementLimitError({
+	if (bumpedMaxFee > maximumAffordableFeePerGas || requiredMaxPriorityFeePerGas > maximumAffordableFeePerGas) throw new VaultTransactionReplacementLimitError({
 		code: "GasCostCapExceeded",
 		gasLimit,
-		requiredMaxFeePerGas,
+		requiredMaxFeePerGas: bumpedMaxFee,
 		requiredMaxPriorityFeePerGas,
 		maximumAffordableFeePerGas
 	});
+	const maxFeePerGas = desiredMaxFeePerGas < maximumAffordableFeePerGas ? desiredMaxFeePerGas : maximumAffordableFeePerGas;
 	return {
 		...historicalQuote,
-		maxFeePerGas: requiredMaxFeePerGas,
+		maxFeePerGas,
 		maxPriorityFeePerGas: requiredMaxPriorityFeePerGas
 	};
 }
@@ -275,5 +291,5 @@ async function getVaultDeltaHedgeInitialFeeQuote(client) {
 }
 
 //#endregion
-export { MAX_VAULT_PRIORITY_FEE_PER_GAS, MAX_VAULT_TRANSACTION_GAS_COST, MIN_VAULT_PRIORITY_FEE_PER_GAS, VaultTransactionFeeEstimationError, VaultTransactionGasCostLimitError, VaultTransactionReplacementLimitError, applyVaultTransactionGasCostLimit, bufferVaultTransactionGasEstimate, getVaultDeltaHedgeHistoricalFeeQuote, getVaultDeltaHedgeInitialFeeQuote, getVaultTransactionFeeQuote, getVaultTransactionReplacementFeeQuote, validateVaultSignedTransactionFeeCaps };
+export { MAX_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS, MAX_VAULT_PRIORITY_FEE_PER_GAS, MAX_VAULT_TRANSACTION_GAS_COST, MIN_VAULT_PRIORITY_FEE_PER_GAS, VaultTransactionFeeEstimationError, VaultTransactionGasCostLimitError, VaultTransactionReplacementLimitError, applyVaultTransactionGasCostLimit, bufferVaultTransactionGasEstimate, getVaultDeltaHedgeHistoricalFeeQuote, getVaultDeltaHedgeInitialFeeQuote, getVaultTransactionFeeQuote, getVaultTransactionReplacementFeeQuote, validateVaultSignedTransactionFeeCaps };
 //# sourceMappingURL=vault-transaction-fees.js.map

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

@@ -1 +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 { hexToBigInt } from 'viem'\nimport { estimateFeesPerGas, getBlock, 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 DELTA_HEDGE_FEE_HISTORY_REWARD_PERCENTILES = [25]\nconst BASE_FEE_BUFFER_NUMERATOR = 1_125n\nconst BASE_FEE_BUFFER_DENOMINATOR = 1_000n\nconst REPLACEMENT_FEE_BUMP_NUMERATOR = 1_125n\nconst REPLACEMENT_FEE_BUMP_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' | 'rpc_priority_fee' | 'fee_history_p25'\n}\n\nexport type VaultDeltaHedgeFeeQuote = VaultTransactionFeeQuote & {\n  rawPriorityFeePerGas: bigint\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\nexport class VaultTransactionReplacementLimitError extends Error {\n  readonly code: 'GasCostCapExceeded'\n  readonly requiredMaxFeePerGas: bigint\n  readonly requiredMaxPriorityFeePerGas: bigint\n  readonly maximumAffordableFeePerGas: bigint\n\n  constructor({\n    code,\n    gasLimit,\n    requiredMaxFeePerGas,\n    requiredMaxPriorityFeePerGas,\n    maximumAffordableFeePerGas,\n  }: {\n    code: 'GasCostCapExceeded'\n    gasLimit: bigint\n    requiredMaxFeePerGas: bigint\n    requiredMaxPriorityFeePerGas: bigint\n    maximumAffordableFeePerGas: bigint\n  }) {\n    super(\n      `Vault transaction replacement blocked by ${code}: gasLimit=${gasLimit.toString()}, ` +\n        `requiredMaxFeePerGas=${requiredMaxFeePerGas.toString()}, ` +\n        `requiredMaxPriorityFeePerGas=${requiredMaxPriorityFeePerGas.toString()}, ` +\n        `maximumAffordableFeePerGas=${maximumAffordableFeePerGas.toString()}`,\n    )\n    this.name = 'VaultTransactionReplacementLimitError'\n    this.code = code\n    this.requiredMaxFeePerGas = requiredMaxFeePerGas\n    this.requiredMaxPriorityFeePerGas = requiredMaxPriorityFeePerGas\n    this.maximumAffordableFeePerGas = maximumAffordableFeePerGas\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 resolveDeltaHedgeFeeHistoryQuote({\n  baseFeePerGas,\n  reward,\n}: FeeHistorySnapshot): VaultDeltaHedgeFeeQuote | null {\n  const latestBaseFeeIndex = baseFeePerGas.length - 2\n  if (latestBaseFeeIndex < 0 || reward === undefined || reward.length === 0) return null\n\n  const p25Rewards = reward.flatMap((blockRewards) => {\n    const p25 = blockRewards[0]\n    return p25 === undefined ? [] : [p25]\n  })\n  const rawPriorityFeePerGas = medianBigInt(p25Rewards)\n  if (rawPriorityFeePerGas === undefined) return null\n\n  const maxPriorityFeePerGas = clampPriorityFee(rawPriorityFeePerGas)\n  const bufferedBaseFee = ceilMultiplyFraction(\n    baseFeePerGas[latestBaseFeeIndex],\n    BASE_FEE_BUFFER_NUMERATOR,\n    BASE_FEE_BUFFER_DENOMINATOR,\n  )\n  return {\n    maxFeePerGas: bufferedBaseFee + maxPriorityFeePerGas,\n    maxPriorityFeePerGas,\n    minimumMaxFeePerGas: bufferedBaseFee + MIN_VAULT_PRIORITY_FEE_PER_GAS,\n    rawPriorityFeePerGas,\n    source: 'fee_history_p25',\n  }\n}\n\nfunction resolveRpcPriorityFeeQuote({\n  baseFeePerGas,\n  rawPriorityFeePerGas,\n}: {\n  baseFeePerGas: bigint\n  rawPriorityFeePerGas: bigint\n}): VaultDeltaHedgeFeeQuote {\n  const bufferedBaseFee = ceilMultiplyFraction(\n    baseFeePerGas,\n    BASE_FEE_BUFFER_NUMERATOR,\n    BASE_FEE_BUFFER_DENOMINATOR,\n  )\n  return {\n    maxFeePerGas: bufferedBaseFee + rawPriorityFeePerGas,\n    maxPriorityFeePerGas: rawPriorityFeePerGas,\n    minimumMaxFeePerGas: bufferedBaseFee + rawPriorityFeePerGas,\n    rawPriorityFeePerGas,\n    source: 'rpc_priority_fee',\n  }\n}\n\nexport function getVaultTransactionReplacementFeeQuote({\n  originalQuote,\n  historicalQuote,\n  gasLimit,\n}: {\n  originalQuote: Pick<VaultTransactionFeeQuote, 'maxFeePerGas' | 'maxPriorityFeePerGas'>\n  historicalQuote: VaultDeltaHedgeFeeQuote\n  gasLimit: bigint\n}): VaultDeltaHedgeFeeQuote {\n  if (gasLimit <= 0n) {\n    throw new Error(`Vault transaction gas limit must be positive, received ${gasLimit.toString()}`)\n  }\n\n  const bumpedPriorityFee = ceilMultiplyFraction(\n    originalQuote.maxPriorityFeePerGas,\n    REPLACEMENT_FEE_BUMP_NUMERATOR,\n    REPLACEMENT_FEE_BUMP_DENOMINATOR,\n  )\n  const bumpedMaxFee = ceilMultiplyFraction(\n    originalQuote.maxFeePerGas,\n    REPLACEMENT_FEE_BUMP_NUMERATOR,\n    REPLACEMENT_FEE_BUMP_DENOMINATOR,\n  )\n  // The historical p25 quote is already clamped to 3 gwei. A same-nonce\n  // replacement may exceed that estimate cap when the required bump does.\n  const requiredMaxPriorityFeePerGas =\n    historicalQuote.maxPriorityFeePerGas > bumpedPriorityFee\n      ? historicalQuote.maxPriorityFeePerGas\n      : bumpedPriorityFee\n  const bufferedBaseFee = historicalQuote.minimumMaxFeePerGas - MIN_VAULT_PRIORITY_FEE_PER_GAS\n  const currentMarketMaxFee = bufferedBaseFee + requiredMaxPriorityFeePerGas\n  const requiredMaxFeePerGas =\n    currentMarketMaxFee > bumpedMaxFee ? currentMarketMaxFee : bumpedMaxFee\n  const maximumAffordableFeePerGas = MAX_VAULT_TRANSACTION_GAS_COST / gasLimit\n\n  if (requiredMaxFeePerGas > maximumAffordableFeePerGas) {\n    throw new VaultTransactionReplacementLimitError({\n      code: 'GasCostCapExceeded',\n      gasLimit,\n      requiredMaxFeePerGas,\n      requiredMaxPriorityFeePerGas,\n      maximumAffordableFeePerGas,\n    })\n  }\n\n  return {\n    ...historicalQuote,\n    maxFeePerGas: requiredMaxFeePerGas,\n    maxPriorityFeePerGas: requiredMaxPriorityFeePerGas,\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 async function getVaultDeltaHedgeHistoricalFeeQuote<chain extends Chain | undefined>(\n  client: Client<Transport, chain>,\n): Promise<VaultDeltaHedgeFeeQuote> {\n  const feeHistory = await getFeeHistory(client, {\n    blockCount: FEE_HISTORY_BLOCK_COUNT,\n    blockTag: 'latest',\n    rewardPercentiles: DELTA_HEDGE_FEE_HISTORY_REWARD_PERCENTILES,\n  })\n  const quote = resolveDeltaHedgeFeeHistoryQuote(feeHistory)\n  if (quote === null) {\n    throw new Error('eth_feeHistory returned incomplete p25 base fee or reward data')\n  }\n  return quote\n}\n\nasync function resolveVaultDeltaHedgeInitialFeeQuote({\n  readRpcQuote,\n  readHistoricalQuote,\n}: {\n  readRpcQuote: () => Promise<{ baseFeePerGas: bigint; rawPriorityFeePerGas: bigint }>\n  readHistoricalQuote: () => Promise<VaultDeltaHedgeFeeQuote>\n}): Promise<VaultDeltaHedgeFeeQuote> {\n  try {\n    return resolveRpcPriorityFeeQuote(await readRpcQuote())\n  } catch {\n    return readHistoricalQuote()\n  }\n}\n\n/**\n * Resolve the first fee quote for a delta hedge from the connected RPC's\n * eth_maxPriorityFeePerGas recommendation. A failed RPC recommendation falls\n * back immediately to the rolling historical p25 quote.\n */\nexport async function getVaultDeltaHedgeInitialFeeQuote<chain extends Chain | undefined>(\n  client: Client<Transport, chain>,\n): Promise<VaultDeltaHedgeFeeQuote> {\n  return resolveVaultDeltaHedgeInitialFeeQuote({\n    readRpcQuote: async () => {\n      const [rawPriorityFee, latestBlock] = await Promise.all([\n        client.request({ method: 'eth_maxPriorityFeePerGas' }),\n        getBlock(client, { blockTag: 'latest' }),\n      ])\n      if (latestBlock.baseFeePerGas === null) {\n        throw new Error('Latest block does not include an EIP-1559 base fee')\n      }\n      return {\n        baseFeePerGas: latestBlock.baseFeePerGas,\n        rawPriorityFeePerGas: hexToBigInt(rawPriorityFee),\n      }\n    },\n    readHistoricalQuote: () => getVaultDeltaHedgeHistoricalFeeQuote(client),\n  })\n}\n\nexport const __transactionFeeTestUtils = {\n  clampPriorityFee,\n  resolveDeltaHedgeFeeHistoryQuote,\n  resolveFallbackQuote,\n  resolveFeeHistoryQuote,\n  resolveRpcPriorityFeeQuote,\n  resolveVaultDeltaHedgeInitialFeeQuote,\n  resolveVaultTransactionFeeQuote,\n}\n"],"mappings":"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"}
+{"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 { hexToBigInt } from 'viem'\nimport { estimateFeesPerGas, getBlock, 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_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS = 8_000_000_000n // 8 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 DELTA_HEDGE_FEE_HISTORY_REWARD_PERCENTILES = [25]\nconst BASE_FEE_BUFFER_NUMERATOR = 1_125n\nconst BASE_FEE_BUFFER_DENOMINATOR = 1_000n\nconst REPLACEMENT_FEE_BUMP_NUMERATOR = 1_125n\nconst REPLACEMENT_FEE_BUMP_DENOMINATOR = 1_000n\nconst DELTA_HEDGE_PRIORITY_FEE_BUMP_NUMERATOR = 1_300n\nconst DELTA_HEDGE_PRIORITY_FEE_BUMP_DENOMINATOR = 1_000n\n// Leave the mandatory 12.5% replacement headroom for a final 3 gwei replacement.\nconst MAX_DELTA_HEDGE_PRIORITY_FEE_PER_GAS =\n  (MAX_VAULT_PRIORITY_FEE_PER_GAS * REPLACEMENT_FEE_BUMP_DENOMINATOR) /\n  REPLACEMENT_FEE_BUMP_NUMERATOR\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' | 'rpc_priority_fee' | 'fee_history_p25'\n}\n\nexport type VaultDeltaHedgeFeeQuote = VaultTransactionFeeQuote & {\n  rawPriorityFeePerGas: bigint\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\nexport class VaultTransactionReplacementLimitError extends Error {\n  readonly code: 'GasCostCapExceeded' | 'PriorityFeeCapExceeded'\n  readonly requiredMaxFeePerGas: bigint\n  readonly requiredMaxPriorityFeePerGas: bigint\n  readonly maximumAffordableFeePerGas: bigint\n\n  constructor({\n    code,\n    gasLimit,\n    requiredMaxFeePerGas,\n    requiredMaxPriorityFeePerGas,\n    maximumAffordableFeePerGas,\n  }: {\n    code: 'GasCostCapExceeded' | 'PriorityFeeCapExceeded'\n    gasLimit: bigint\n    requiredMaxFeePerGas: bigint\n    requiredMaxPriorityFeePerGas: bigint\n    maximumAffordableFeePerGas: bigint\n  }) {\n    super(\n      `Vault transaction replacement blocked by ${code}: gasLimit=${gasLimit.toString()}, ` +\n        `requiredMaxFeePerGas=${requiredMaxFeePerGas.toString()}, ` +\n        `requiredMaxPriorityFeePerGas=${requiredMaxPriorityFeePerGas.toString()}, ` +\n        `maximumAffordableFeePerGas=${maximumAffordableFeePerGas.toString()}`,\n    )\n    this.name = 'VaultTransactionReplacementLimitError'\n    this.code = code\n    this.requiredMaxFeePerGas = requiredMaxFeePerGas\n    this.requiredMaxPriorityFeePerGas = requiredMaxPriorityFeePerGas\n    this.maximumAffordableFeePerGas = maximumAffordableFeePerGas\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 resolveDeltaHedgeFeeHistoryQuote({\n  baseFeePerGas,\n  reward,\n}: FeeHistorySnapshot): VaultDeltaHedgeFeeQuote | null {\n  const latestBaseFeeIndex = baseFeePerGas.length - 2\n  if (latestBaseFeeIndex < 0 || reward === undefined || reward.length === 0) return null\n\n  const p25Rewards = reward.flatMap((blockRewards) => {\n    const p25 = blockRewards[0]\n    return p25 === undefined ? [] : [p25]\n  })\n  const rawPriorityFeePerGas = medianBigInt(p25Rewards)\n  if (rawPriorityFeePerGas === undefined) return null\n\n  const maxPriorityFeePerGas = clampPriorityFee(rawPriorityFeePerGas)\n  const bufferedBaseFee = ceilMultiplyFraction(\n    baseFeePerGas[latestBaseFeeIndex],\n    BASE_FEE_BUFFER_NUMERATOR,\n    BASE_FEE_BUFFER_DENOMINATOR,\n  )\n  return {\n    maxFeePerGas: bufferedBaseFee + maxPriorityFeePerGas,\n    maxPriorityFeePerGas,\n    minimumMaxFeePerGas: bufferedBaseFee + MIN_VAULT_PRIORITY_FEE_PER_GAS,\n    rawPriorityFeePerGas,\n    source: 'fee_history_p25',\n  }\n}\n\nfunction resolveRpcPriorityFeeQuote({\n  baseFeePerGas,\n  rawPriorityFeePerGas,\n}: {\n  baseFeePerGas: bigint\n  rawPriorityFeePerGas: bigint\n}): VaultDeltaHedgeFeeQuote {\n  const bufferedBaseFee = ceilMultiplyFraction(\n    baseFeePerGas,\n    BASE_FEE_BUFFER_NUMERATOR,\n    BASE_FEE_BUFFER_DENOMINATOR,\n  )\n  return {\n    maxFeePerGas: bufferedBaseFee + rawPriorityFeePerGas,\n    maxPriorityFeePerGas: rawPriorityFeePerGas,\n    minimumMaxFeePerGas: bufferedBaseFee + rawPriorityFeePerGas,\n    rawPriorityFeePerGas,\n    source: 'rpc_priority_fee',\n  }\n}\n\nexport function getVaultTransactionReplacementFeeQuote({\n  originalQuote,\n  historicalQuote,\n  gasLimit,\n  finalReplacement = false,\n  staleBoundsReplacement = false,\n}: {\n  originalQuote: Pick<VaultTransactionFeeQuote, 'maxFeePerGas' | 'maxPriorityFeePerGas'>\n  historicalQuote: VaultDeltaHedgeFeeQuote\n  gasLimit: bigint\n  finalReplacement?: boolean\n  staleBoundsReplacement?: boolean\n}): VaultDeltaHedgeFeeQuote {\n  if (gasLimit <= 0n) {\n    throw new Error(`Vault transaction gas limit must be positive, received ${gasLimit.toString()}`)\n  }\n\n  const bumpedPriorityFee = staleBoundsReplacement\n    ? ceilMultiplyFraction(\n        originalQuote.maxPriorityFeePerGas,\n        REPLACEMENT_FEE_BUMP_NUMERATOR,\n        REPLACEMENT_FEE_BUMP_DENOMINATOR,\n      )\n    : ceilMultiplyFraction(\n        originalQuote.maxPriorityFeePerGas,\n        DELTA_HEDGE_PRIORITY_FEE_BUMP_NUMERATOR,\n        DELTA_HEDGE_PRIORITY_FEE_BUMP_DENOMINATOR,\n      )\n  const bumpedMaxFee = ceilMultiplyFraction(\n    originalQuote.maxFeePerGas,\n    REPLACEMENT_FEE_BUMP_NUMERATOR,\n    REPLACEMENT_FEE_BUMP_DENOMINATOR,\n  )\n  const escalatingPriorityFee =\n    historicalQuote.maxPriorityFeePerGas > bumpedPriorityFee\n      ? historicalQuote.maxPriorityFeePerGas\n      : bumpedPriorityFee\n  const priorityFeeLimit = staleBoundsReplacement\n    ? MAX_STALE_DELTA_HEDGE_PRIORITY_FEE_PER_GAS\n    : finalReplacement\n      ? MAX_VAULT_PRIORITY_FEE_PER_GAS\n      : MAX_DELTA_HEDGE_PRIORITY_FEE_PER_GAS\n  const desiredMaxPriorityFeePerGas = finalReplacement\n    ? MAX_VAULT_PRIORITY_FEE_PER_GAS\n    : staleBoundsReplacement\n      ? bumpedPriorityFee\n      : escalatingPriorityFee\n  const requiredReplacementPriorityFee = ceilMultiplyFraction(\n    originalQuote.maxPriorityFeePerGas,\n    REPLACEMENT_FEE_BUMP_NUMERATOR,\n    REPLACEMENT_FEE_BUMP_DENOMINATOR,\n  )\n  const requiredMaxPriorityFeePerGas =\n    desiredMaxPriorityFeePerGas < priorityFeeLimit ? desiredMaxPriorityFeePerGas : priorityFeeLimit\n  if (requiredMaxPriorityFeePerGas < requiredReplacementPriorityFee) {\n    throw new VaultTransactionReplacementLimitError({\n      code: 'PriorityFeeCapExceeded',\n      gasLimit,\n      requiredMaxFeePerGas: originalQuote.maxFeePerGas,\n      requiredMaxPriorityFeePerGas: requiredReplacementPriorityFee,\n      maximumAffordableFeePerGas: MAX_VAULT_TRANSACTION_GAS_COST / gasLimit,\n    })\n  }\n  const bufferedBaseFee = historicalQuote.minimumMaxFeePerGas - MIN_VAULT_PRIORITY_FEE_PER_GAS\n  const currentMarketMaxFee = bufferedBaseFee + requiredMaxPriorityFeePerGas\n  const desiredMaxFeePerGas =\n    currentMarketMaxFee > bumpedMaxFee ? currentMarketMaxFee : bumpedMaxFee\n  const maximumAffordableFeePerGas = MAX_VAULT_TRANSACTION_GAS_COST / gasLimit\n\n  if (\n    bumpedMaxFee > maximumAffordableFeePerGas ||\n    requiredMaxPriorityFeePerGas > maximumAffordableFeePerGas\n  ) {\n    throw new VaultTransactionReplacementLimitError({\n      code: 'GasCostCapExceeded',\n      gasLimit,\n      requiredMaxFeePerGas: bumpedMaxFee,\n      requiredMaxPriorityFeePerGas,\n      maximumAffordableFeePerGas,\n    })\n  }\n  const maxFeePerGas =\n    desiredMaxFeePerGas < maximumAffordableFeePerGas\n      ? desiredMaxFeePerGas\n      : maximumAffordableFeePerGas\n\n  return {\n    ...historicalQuote,\n    maxFeePerGas,\n    maxPriorityFeePerGas: requiredMaxPriorityFeePerGas,\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 async function getVaultDeltaHedgeHistoricalFeeQuote<chain extends Chain | undefined>(\n  client: Client<Transport, chain>,\n): Promise<VaultDeltaHedgeFeeQuote> {\n  const feeHistory = await getFeeHistory(client, {\n    blockCount: FEE_HISTORY_BLOCK_COUNT,\n    blockTag: 'latest',\n    rewardPercentiles: DELTA_HEDGE_FEE_HISTORY_REWARD_PERCENTILES,\n  })\n  const quote = resolveDeltaHedgeFeeHistoryQuote(feeHistory)\n  if (quote === null) {\n    throw new Error('eth_feeHistory returned incomplete p25 base fee or reward data')\n  }\n  return quote\n}\n\nasync function resolveVaultDeltaHedgeInitialFeeQuote({\n  readRpcQuote,\n  readHistoricalQuote,\n}: {\n  readRpcQuote: () => Promise<{ baseFeePerGas: bigint; rawPriorityFeePerGas: bigint }>\n  readHistoricalQuote: () => Promise<VaultDeltaHedgeFeeQuote>\n}): Promise<VaultDeltaHedgeFeeQuote> {\n  try {\n    return resolveRpcPriorityFeeQuote(await readRpcQuote())\n  } catch {\n    return readHistoricalQuote()\n  }\n}\n\n/**\n * Resolve the first fee quote for a delta hedge from the connected RPC's\n * eth_maxPriorityFeePerGas recommendation. A failed RPC recommendation falls\n * back immediately to the rolling historical p25 quote.\n */\nexport async function getVaultDeltaHedgeInitialFeeQuote<chain extends Chain | undefined>(\n  client: Client<Transport, chain>,\n): Promise<VaultDeltaHedgeFeeQuote> {\n  return resolveVaultDeltaHedgeInitialFeeQuote({\n    readRpcQuote: async () => {\n      const [rawPriorityFee, latestBlock] = await Promise.all([\n        client.request({ method: 'eth_maxPriorityFeePerGas' }),\n        getBlock(client, { blockTag: 'latest' }),\n      ])\n      if (latestBlock.baseFeePerGas === null) {\n        throw new Error('Latest block does not include an EIP-1559 base fee')\n      }\n      return {\n        baseFeePerGas: latestBlock.baseFeePerGas,\n        rawPriorityFeePerGas: hexToBigInt(rawPriorityFee),\n      }\n    },\n    readHistoricalQuote: () => getVaultDeltaHedgeHistoricalFeeQuote(client),\n  })\n}\n\nexport const __transactionFeeTestUtils = {\n  clampPriorityFee,\n  resolveDeltaHedgeFeeHistoryQuote,\n  resolveFallbackQuote,\n  resolveFeeHistoryQuote,\n  resolveRpcPriorityFeeQuote,\n  resolveVaultDeltaHedgeInitialFeeQuote,\n  resolveVaultTransactionFeeQuote,\n}\n"],"mappings":"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"}

package/dist/{writes-2reV_omF.js → writes-D1zN0v9x.js}

@@ -1,5 +1,5 @@
-import { BatchValidationError, DEFAULT_VEGOID, InputListFailError, InvalidTickLimitsError, InvalidTokenIdParameterError, LEG_BITS, LEG_LIMITS, LEG_MASKS, LoanSlotExhaustedError, MaxRetriesExceededError, MissingPositionIdsError, NoLoanPositionsError, OracleRateLimitedError, PanopticError, PanopticValidationError, PositionSnapshotNotFoundError, ProviderLagError, STANDARD_TICK_WIDTHS, STRIKE_CONVERSION_FACTOR, SwapTokenMismatchError, SyncTimeoutError, TOKEN_ID_BITS, UnsafePremiumSettlementError, collateralTrackerV2Abi, createTxResult, decodeLeftRightUnsigned, decodeOracleTiming, decodePosition, decodeTickSpacing, formatTokenAmount, getBlockMeta, getOpenPositionIds, getPool, getPoolMetaKey, getPoolMetadata, getPositionMetaKey, getPositions, getPositionsKey, getSyncCheckpointKey, getTrackedPositionIds, jsonSerializer, oracleEpochAt, panopticErrorsAbi, panopticFactoryV3Abi, panopticFactoryV4Abi, panopticPoolV2Abi, parsePanopticError, parseTokenAmount, submitWrite } from "./rates-CDLIUGDz.js";
-import { MAX_TICK, MIN_TICK, REORG_DEPTH, calculatePositionGreeks, priceToTick, roundToTickSpacing, sqrtPriceX96ToTick, tickLimits, tickToPrice, tickToPriceDecimalScaled, tickToSqrtPriceX96 } from "./greeks-9aTE-DwO.js";
+import { BatchValidationError, DEFAULT_VEGOID, InputListFailError, InvalidTickLimitsError, InvalidTokenIdParameterError, LEG_BITS, LEG_LIMITS, LEG_MASKS, LoanSlotExhaustedError, MaxRetriesExceededError, MissingPositionIdsError, NoLoanPositionsError, OracleRateLimitedError, PanopticError, PanopticValidationError, PositionSnapshotNotFoundError, ProviderLagError, STANDARD_TICK_WIDTHS, STRIKE_CONVERSION_FACTOR, SwapTokenMismatchError, SyncTimeoutError, TOKEN_ID_BITS, UnsafePremiumSettlementError, collateralTrackerV2Abi, createTxResult, decodeLeftRightUnsigned, decodeOracleTiming, decodePosition, decodeTickSpacing, formatTokenAmount, getBlockMeta, getOpenPositionIds, getPool, getPoolMetaKey, getPoolMetadata, getPositionMetaKey, getPositions, getPositionsKey, getSyncCheckpointKey, getTrackedPositionIds, jsonSerializer, oracleEpochAt, panopticErrorsAbi, panopticFactoryV3Abi, panopticFactoryV4Abi, panopticPoolV2Abi, parsePanopticError, parseTokenAmount, submitWrite } from "./rates-COAJpKRd.js";
+import { MAX_TICK, MIN_TICK, REORG_DEPTH, calculatePositionGreeks, priceToTick, roundToTickSpacing, sqrtPriceX96ToTick, tickLimits, tickToPrice, tickToPriceDecimalScaled, tickToSqrtPriceX96 } from "./greeks-CNi1-cnp.js";
 import { decodeFunctionResult, encodeFunctionData, erc20Abi, getAbiItem } from "viem";
 
 //#region src/panoptic/v2/writes/broadcaster.ts
@@ -3595,7 +3595,7 @@ async function simulateWithTokenFlow(params) {
 		const delta1 = assetsAfter.assets1 - assetsBefore.assets1;
 		let gasEstimate = 0n;
 		try {
-			gasEstimate = await client.estimateGas({
+			if (params.estimateGas !== false) gasEstimate = await client.estimateGas({
 				account: user,
 				to: poolAddress,
 				data: callData,
@@ -5122,6 +5122,7 @@ async function simulateOpenPosition(params) {
 			]
 		});
 		const flowResult = await simulateWithTokenFlow({
+			estimateGas: params.estimateGas,
 			client,
 			poolAddress,
 			user: account,

package/dist/zodiac/index.d.ts

@@ -1,4 +1,4 @@
-import { Hex } from "viem";
+import { Address, ContractFunctionArgs, ContractFunctionName, Hex } from "viem";
 
 //#region src/zodiac/rolesAbi.d.ts
 /** Minimal Zodiac Roles v2 modifier ABI used by the scoping/apply flows. */
@@ -99,12 +99,13 @@ declare const rolesV2Abi: readonly [{
   readonly outputs: readonly [];
 }]; //#endregion
 //#region src/zodiac/applySteps.d.ts
-/** One idempotent Roles-modifier configuration call. */
-interface ScopeStep {
+type ScopeFunctionName = ContractFunctionName<typeof rolesV2Abi, 'nonpayable'>;
+/** One idempotent Roles-modifier configuration call, paired with its ABI arguments. */
+type ScopeStep = { [Name in ScopeFunctionName]: {
   name: string;
-  functionName: 'assignRoles' | 'scopeTarget' | 'scopeFunction' | 'allowFunction' | 'setTransactionUnwrapper';
-  args: unknown[];
-}
+  functionName: Name;
+  args: ContractFunctionArgs<typeof rolesV2Abi, 'nonpayable', Name>;
+} }[ScopeFunctionName];
 /**
  * Minimal structural client shapes (instead of viem's `PublicClient` /
  * `WalletClient`) so any viem 2.x instance is accepted — pnpm peer-keying can
@@ -285,6 +286,49 @@ declare function buildDispatchCustomRoleSteps(params: {
   extra?: Hex;
 }): ScopeStep[];
 
+//#endregion
+//#region src/zodiac/roles/liquidator.d.ts
+/**
+ * Liquidator role: scopes ONLY `PanopticLiquidator.liquidate(LiquidateParams)`
+ * on the helper. `initializePool`, `execute`, `multicall`, `sweep`, and
+ * `quoteLiquidation` are never scoped.
+ *
+ * Split of enforcement (must match the LiquidatorCondition contract and the
+ * hand-encoded tree in zodiac-modules/test/LiquidatorRolesFork.t.sol, which is
+ * the golden spec for this builder):
+ *  - THIS TREE pins the static fields: pool ∈ allowlist, account ∉ {safe,
+ *    helper}, swap targets ∈ {router, 0}, premia flags = 0, and — via
+ *    ExecutionOptions.None — zero outer msg.value (attached value is excluded
+ *    from the helper's minDelta floors, so it must never flow through the
+ *    role; native shortfalls are funded via nativeFundingAmount instead).
+ *  - THE ADAPTER (Custom node on positionIdListTo; Roles hands it full
+ *    calldata) enforces the cross-field invariants: flash/swap tokens ∈ pool
+ *    underlyings, swap groups zeroed together or exact nonzero amounts,
+ *    nativeFundingAmount only on native pools, floors ≥ 0 with one positive.
+ */
+declare const LIQUIDATE_SELECTOR: `0x${string}`;
+interface LiquidatorConditionsParams {
+  /** Deployed LiquidatorCondition adapter. */
+  adapter: Address;
+  /** The Safe (avatar) — excluded as a liquidation target. */
+  safe: Address;
+  /** The PanopticLiquidator helper — also excluded as a target. */
+  helper: Address;
+  /** Pinned swap router (Uniswap Universal Router). */
+  router: Address;
+  /** PanopticPool allowlist (at least one). */
+  pools: readonly Address[];
+  /** Trailing 12 bytes of the Custom compValue (unused by the adapter). */
+  extra?: Hex;
+}
+/** BFS ConditionFlat tree over liquidate's single LiquidateParams tuple. */
+declare function buildLiquidatorConditions(params: LiquidatorConditionsParams): ConditionFlat[];
+/** assignRoles → scopeTarget → scopeFunction for the liquidator role. */
+declare function buildLiquidatorRoleSteps(params: LiquidatorConditionsParams & {
+  roleKey: Hex;
+  member: Address;
+}): ScopeStep[];
+
 //#endregion
 //#region src/zodiac/roles/loanHedger.d.ts
 /**
@@ -508,5 +552,5 @@ declare function loanBitmaskCondition(): {
 };
 
 //#endregion
-export { CANONICAL_ADAPTERS, ConditionFlat, DELEVERAGER_ROLE_KEY, DEPOSIT_SELECTOR, DISPATCH_FROM_SELECTOR, DISPATCH_SELECTOR, EXECUTE_SELECTOR, ExecutionOptions, LOAN_BITMASK_WINDOW_SHIFTS, MAINTENANCE_ROLE_KEY, MULTICALL_SELECTOR, MULTISEND_SELECTOR, Operator, ParameterType, ROLLER_ROLE_KEY, SIZE_ADJUSTER_ROLE_KEY, ScopeStep, WETH_DEPOSIT_SELECTOR, WETH_WITHDRAW_SELECTOR, WITHDRAW_SELECTOR, WITHDRAW_WITH_POSITIONS_SELECTOR, addressEqualCompValue, applyScopeSteps, buildDeleveragerDispatchConditions, buildDeleveragerRoleSteps, buildDepositConditions, buildDispatchCustomConditions, buildDispatchCustomRoleSteps, buildDispatchFromConditions, buildLoanOnlyDispatchConditions, buildMaintenanceRoleSteps, buildRollerRoleSteps, buildSfpmSwapConditions, buildSfpmSwapVenueSteps, buildSizeAdjusterRoleSteps, buildWithdrawConditions, buildWithdrawWithPositionsConditions, customCompValue, isPureLoanTokenId, legFieldMask, loanBitmaskCompValueAt, loanBitmaskCondition, loanWidthFieldsMask, optionRatioFieldsMask, roleKey, rolesV2Abi, sfpmPoolIdPinExtra, sizeCapExtra, strikeFieldsMask };
+export { CANONICAL_ADAPTERS, ConditionFlat, DELEVERAGER_ROLE_KEY, DEPOSIT_SELECTOR, DISPATCH_FROM_SELECTOR, DISPATCH_SELECTOR, EXECUTE_SELECTOR, ExecutionOptions, LIQUIDATE_SELECTOR, LOAN_BITMASK_WINDOW_SHIFTS, LiquidatorConditionsParams, MAINTENANCE_ROLE_KEY, MULTICALL_SELECTOR, MULTISEND_SELECTOR, Operator, ParameterType, ROLLER_ROLE_KEY, SIZE_ADJUSTER_ROLE_KEY, ScopeStep, WETH_DEPOSIT_SELECTOR, WETH_WITHDRAW_SELECTOR, WITHDRAW_SELECTOR, WITHDRAW_WITH_POSITIONS_SELECTOR, addressEqualCompValue, applyScopeSteps, buildDeleveragerDispatchConditions, buildDeleveragerRoleSteps, buildDepositConditions, buildDispatchCustomConditions, buildDispatchCustomRoleSteps, buildDispatchFromConditions, buildLiquidatorConditions, buildLiquidatorRoleSteps, buildLoanOnlyDispatchConditions, buildMaintenanceRoleSteps, buildRollerRoleSteps, buildSfpmSwapConditions, buildSfpmSwapVenueSteps, buildSizeAdjusterRoleSteps, buildWithdrawConditions, buildWithdrawWithPositionsConditions, customCompValue, isPureLoanTokenId, legFieldMask, loanBitmaskCompValueAt, loanBitmaskCondition, loanWidthFieldsMask, optionRatioFieldsMask, roleKey, rolesV2Abi, sfpmPoolIdPinExtra, sizeCapExtra, strikeFieldsMask };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["rolesV2Abi","rolesV2Abi","ScopeStep","ScopeStepsPublicClient","Promise","ScopeStepsWalletClient","applyScopeSteps","Hex","ConditionFlat","addressEqualCompValue","customCompValue","sizeCapExtra","ParameterType","Operator","CANONICAL_ADAPTERS","ExecutionOptions","Hex","ScopeStep","ConditionFlat","DELEVERAGER_ROLE_KEY","buildDeleveragerDispatchConditions","buildDeleveragerRoleSteps","Hex","ScopeStep","ConditionFlat","DISPATCH_SELECTOR","roleKey","buildDispatchCustomConditions","buildDispatchCustomRoleSteps","Hex","ConditionFlat","LOAN_BITMASK_WINDOW_SHIFTS","loanBitmaskCompValueAt","buildLoanOnlyDispatchConditions","WITHDRAW_SELECTOR","DEPOSIT_SELECTOR","EXECUTE_SELECTOR","buildWithdrawConditions","buildDepositConditions","Hex","ScopeStep","ConditionFlat","MAINTENANCE_ROLE_KEY","DISPATCH_FROM_SELECTOR","buildDispatchFromConditions","buildMaintenanceRoleSteps","Hex","ScopeStep","ROLLER_ROLE_KEY","buildRollerRoleSteps","Hex","ScopeStep","ConditionFlat","MULTICALL_SELECTOR","MULTISEND_SELECTOR","WETH_DEPOSIT_SELECTOR","WETH_WITHDRAW_SELECTOR","WITHDRAW_WITH_POSITIONS_SELECTOR","buildWithdrawWithPositionsConditions","sfpmPoolIdPinExtra","buildSfpmSwapConditions","buildSfpmSwapVenueSteps","Hex","ScopeStep","SIZE_ADJUSTER_ROLE_KEY","buildSizeAdjusterRoleSteps","legFieldMask","loanWidthFieldsMask","strikeFieldsMask","optionRatioFieldsMask","isPureLoanTokenId","loanBitmaskCondition"],"sources":["../../src/zodiac/rolesAbi.d.ts","../../src/zodiac/applySteps.d.ts","../../src/zodiac/conditions.d.ts","../../src/zodiac/constants.d.ts","../../src/zodiac/roles/deleverager.d.ts","../../src/zodiac/roles/dispatchCustomRole.d.ts","../../src/zodiac/roles/loanHedger.d.ts","../../src/zodiac/roles/maintenance.d.ts","../../src/zodiac/roles/roller.d.ts","../../src/zodiac/roles/sfpmSwap.d.ts","../../src/zodiac/roles/sizeAdjuster.d.ts","../../src/zodiac/tokenIdMask.d.ts"],"sourcesContent":null,"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["rolesV2Abi","ContractFunctionArgs","ContractFunctionName","rolesV2Abi","ScopeFunctionName","ScopeStep","Name","ScopeStepsPublicClient","Promise","ScopeStepsWalletClient","applyScopeSteps","Hex","ConditionFlat","addressEqualCompValue","customCompValue","sizeCapExtra","ParameterType","Operator","CANONICAL_ADAPTERS","ExecutionOptions","Hex","ScopeStep","ConditionFlat","DELEVERAGER_ROLE_KEY","buildDeleveragerDispatchConditions","buildDeleveragerRoleSteps","Hex","ScopeStep","ConditionFlat","DISPATCH_SELECTOR","roleKey","buildDispatchCustomConditions","buildDispatchCustomRoleSteps","Address","Hex","ScopeStep","ConditionFlat","LIQUIDATE_SELECTOR","LiquidatorConditionsParams","buildLiquidatorConditions","buildLiquidatorRoleSteps","Hex","ConditionFlat","LOAN_BITMASK_WINDOW_SHIFTS","loanBitmaskCompValueAt","buildLoanOnlyDispatchConditions","WITHDRAW_SELECTOR","DEPOSIT_SELECTOR","EXECUTE_SELECTOR","buildWithdrawConditions","buildDepositConditions","Hex","ScopeStep","ConditionFlat","MAINTENANCE_ROLE_KEY","DISPATCH_FROM_SELECTOR","buildDispatchFromConditions","buildMaintenanceRoleSteps","Hex","ScopeStep","ROLLER_ROLE_KEY","buildRollerRoleSteps","Hex","ScopeStep","ConditionFlat","MULTICALL_SELECTOR","MULTISEND_SELECTOR","WETH_DEPOSIT_SELECTOR","WETH_WITHDRAW_SELECTOR","WITHDRAW_WITH_POSITIONS_SELECTOR","buildWithdrawWithPositionsConditions","sfpmPoolIdPinExtra","buildSfpmSwapConditions","buildSfpmSwapVenueSteps","Hex","ScopeStep","SIZE_ADJUSTER_ROLE_KEY","buildSizeAdjusterRoleSteps","legFieldMask","loanWidthFieldsMask","strikeFieldsMask","optionRatioFieldsMask","isPureLoanTokenId","loanBitmaskCondition"],"sources":["../../src/zodiac/rolesAbi.d.ts","../../src/zodiac/applySteps.d.ts","../../src/zodiac/conditions.d.ts","../../src/zodiac/constants.d.ts","../../src/zodiac/roles/deleverager.d.ts","../../src/zodiac/roles/dispatchCustomRole.d.ts","../../src/zodiac/roles/liquidator.d.ts","../../src/zodiac/roles/loanHedger.d.ts","../../src/zodiac/roles/maintenance.d.ts","../../src/zodiac/roles/roller.d.ts","../../src/zodiac/roles/sfpmSwap.d.ts","../../src/zodiac/roles/sizeAdjuster.d.ts","../../src/zodiac/tokenIdMask.d.ts"],"sourcesContent":null,"mappings":"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"}

package/dist/zodiac/index.js

@@ -1,4 +1,4 @@
-import { keccak256, toBytes, toFunctionSelector, zeroHash } from "viem";
+import { keccak256, toBytes, toFunctionSelector, zeroAddress, zeroHash } from "viem";
 
 //#region src/zodiac/rolesAbi.ts
 /** Minimal Zodiac Roles v2 modifier ABI used by the scoping/apply flows. */
@@ -523,6 +523,158 @@ function buildDeleveragerRoleSteps(params) {
 	];
 }
 
+//#endregion
+//#region src/zodiac/roles/liquidator.ts
+/**
+* Liquidator role: scopes ONLY `PanopticLiquidator.liquidate(LiquidateParams)`
+* on the helper. `initializePool`, `execute`, `multicall`, `sweep`, and
+* `quoteLiquidation` are never scoped.
+*
+* Split of enforcement (must match the LiquidatorCondition contract and the
+* hand-encoded tree in zodiac-modules/test/LiquidatorRolesFork.t.sol, which is
+* the golden spec for this builder):
+*  - THIS TREE pins the static fields: pool ∈ allowlist, account ∉ {safe,
+*    helper}, swap targets ∈ {router, 0}, premia flags = 0, and — via
+*    ExecutionOptions.None — zero outer msg.value (attached value is excluded
+*    from the helper's minDelta floors, so it must never flow through the
+*    role; native shortfalls are funded via nativeFundingAmount instead).
+*  - THE ADAPTER (Custom node on positionIdListTo; Roles hands it full
+*    calldata) enforces the cross-field invariants: flash/swap tokens ∈ pool
+*    underlyings, swap groups zeroed together or exact nonzero amounts,
+*    nativeFundingAmount only on native pools, floors ≥ 0 with one positive.
+*/
+const LIQUIDATE_SELECTOR = toFunctionSelector("liquidate((address,address,uint256[],uint256,address,uint256,uint256,address,bytes,address,uint256,address,bytes,address,uint256,int256,int256))");
+/** BFS ConditionFlat tree over liquidate's single LiquidateParams tuple. */
+function buildLiquidatorConditions(params) {
+	const { adapter, safe, helper, router, pools, extra = "0x" } = params;
+	if (pools.length === 0) throw new Error("liquidator role needs at least one pool");
+	const pass = (parent, paramType) => ({
+		parent,
+		paramType,
+		operator: Operator.Pass,
+		compValue: "0x"
+	});
+	const conditions = [
+		{
+			parent: 0,
+			paramType: ParameterType.Calldata,
+			operator: Operator.Matches,
+			compValue: "0x"
+		},
+		{
+			parent: 0,
+			paramType: ParameterType.Tuple,
+			operator: Operator.Matches,
+			compValue: "0x"
+		},
+		{
+			parent: 1,
+			paramType: ParameterType.None,
+			operator: Operator.Or,
+			compValue: "0x"
+		},
+		{
+			parent: 1,
+			paramType: ParameterType.None,
+			operator: Operator.Nor,
+			compValue: "0x"
+		},
+		{
+			parent: 1,
+			paramType: ParameterType.Array,
+			operator: Operator.Custom,
+			compValue: customCompValue(adapter, extra)
+		},
+		{
+			parent: 1,
+			paramType: ParameterType.Static,
+			operator: Operator.EqualTo,
+			compValue: "0x0000000000000000000000000000000000000000000000000000000000000000"
+		},
+		pass(1, ParameterType.Static),
+		pass(1, ParameterType.Static),
+		pass(1, ParameterType.Static),
+		{
+			parent: 1,
+			paramType: ParameterType.None,
+			operator: Operator.Or,
+			compValue: "0x"
+		},
+		pass(1, ParameterType.Dynamic),
+		pass(1, ParameterType.Static),
+		pass(1, ParameterType.Static),
+		{
+			parent: 1,
+			paramType: ParameterType.None,
+			operator: Operator.Or,
+			compValue: "0x"
+		},
+		pass(1, ParameterType.Dynamic),
+		pass(1, ParameterType.Static),
+		pass(1, ParameterType.Static),
+		pass(1, ParameterType.Static),
+		pass(1, ParameterType.Static)
+	];
+	for (const pool of pools) conditions.push({
+		parent: 2,
+		paramType: ParameterType.Static,
+		operator: Operator.EqualTo,
+		compValue: addressEqualCompValue(pool)
+	});
+	for (const excluded of [safe, helper]) conditions.push({
+		parent: 3,
+		paramType: ParameterType.Static,
+		operator: Operator.EqualTo,
+		compValue: addressEqualCompValue(excluded)
+	});
+	conditions.push(pass(4, ParameterType.Static));
+	for (const parent of [9, 13]) {
+		conditions.push({
+			parent,
+			paramType: ParameterType.Static,
+			operator: Operator.EqualTo,
+			compValue: addressEqualCompValue(router)
+		});
+		conditions.push({
+			parent,
+			paramType: ParameterType.Static,
+			operator: Operator.EqualTo,
+			compValue: addressEqualCompValue(zeroAddress)
+		});
+	}
+	return conditions;
+}
+/** assignRoles → scopeTarget → scopeFunction for the liquidator role. */
+function buildLiquidatorRoleSteps(params) {
+	return [
+		{
+			name: "assignRoles(liquidator member)",
+			functionName: "assignRoles",
+			args: [
+				params.member,
+				[params.roleKey],
+				[true]
+			]
+		},
+		{
+			name: "scopeTarget(helper)",
+			functionName: "scopeTarget",
+			args: [params.roleKey, params.helper]
+		},
+		{
+			name: "scopeFunction(liquidate, liquidator conditions)",
+			functionName: "scopeFunction",
+			args: [
+				params.roleKey,
+				params.helper,
+				LIQUIDATE_SELECTOR,
+				buildLiquidatorConditions(params),
+				ExecutionOptions.None
+			]
+		}
+	];
+}
+
 //#endregion
 //#region src/zodiac/tokenIdMask.ts
 /**
@@ -1150,5 +1302,5 @@ function buildSizeAdjusterRoleSteps(params) {
 }
 
 //#endregion
-export { CANONICAL_ADAPTERS, DELEVERAGER_ROLE_KEY, DEPOSIT_SELECTOR, DISPATCH_FROM_SELECTOR, DISPATCH_SELECTOR, EXECUTE_SELECTOR, ExecutionOptions, LOAN_BITMASK_WINDOW_SHIFTS, MAINTENANCE_ROLE_KEY, MULTICALL_SELECTOR, MULTISEND_SELECTOR, Operator, ParameterType, ROLLER_ROLE_KEY, SIZE_ADJUSTER_ROLE_KEY, WETH_DEPOSIT_SELECTOR, WETH_WITHDRAW_SELECTOR, WITHDRAW_SELECTOR, WITHDRAW_WITH_POSITIONS_SELECTOR, addressEqualCompValue, applyScopeSteps, buildDeleveragerDispatchConditions, buildDeleveragerRoleSteps, buildDepositConditions, buildDispatchCustomConditions, buildDispatchCustomRoleSteps, buildDispatchFromConditions, buildLoanOnlyDispatchConditions, buildMaintenanceRoleSteps, buildRollerRoleSteps, buildSfpmSwapConditions, buildSfpmSwapVenueSteps, buildSizeAdjusterRoleSteps, buildWithdrawConditions, buildWithdrawWithPositionsConditions, customCompValue, isPureLoanTokenId, legFieldMask, loanBitmaskCompValueAt, loanBitmaskCondition, loanWidthFieldsMask, optionRatioFieldsMask, roleKey, rolesV2Abi, sfpmPoolIdPinExtra, sizeCapExtra, strikeFieldsMask };
+export { CANONICAL_ADAPTERS, DELEVERAGER_ROLE_KEY, DEPOSIT_SELECTOR, DISPATCH_FROM_SELECTOR, DISPATCH_SELECTOR, EXECUTE_SELECTOR, ExecutionOptions, LIQUIDATE_SELECTOR, LOAN_BITMASK_WINDOW_SHIFTS, MAINTENANCE_ROLE_KEY, MULTICALL_SELECTOR, MULTISEND_SELECTOR, Operator, ParameterType, ROLLER_ROLE_KEY, SIZE_ADJUSTER_ROLE_KEY, WETH_DEPOSIT_SELECTOR, WETH_WITHDRAW_SELECTOR, WITHDRAW_SELECTOR, WITHDRAW_WITH_POSITIONS_SELECTOR, addressEqualCompValue, applyScopeSteps, buildDeleveragerDispatchConditions, buildDeleveragerRoleSteps, buildDepositConditions, buildDispatchCustomConditions, buildDispatchCustomRoleSteps, buildDispatchFromConditions, buildLiquidatorConditions, buildLiquidatorRoleSteps, buildLoanOnlyDispatchConditions, buildMaintenanceRoleSteps, buildRollerRoleSteps, buildSfpmSwapConditions, buildSfpmSwapVenueSteps, buildSizeAdjusterRoleSteps, buildWithdrawConditions, buildWithdrawWithPositionsConditions, customCompValue, isPureLoanTokenId, legFieldMask, loanBitmaskCompValueAt, loanBitmaskCondition, loanWidthFieldsMask, optionRatioFieldsMask, roleKey, rolesV2Abi, sfpmPoolIdPinExtra, sizeCapExtra, strikeFieldsMask };
 //# sourceMappingURL=index.js.map