@mixerx/oracles 0.5.4 → 2.0.0

package/dist/index.d.ts

@@ -1,3 +1,6 @@
 export * from './factory';
-export { MIXERX_GAS_LIMITS, getMixerXGasLimit } from './domain/config';
-//# sourceMappingURL=index.d.ts.map
+export { OracleError, TokenPriceError } from './domain/exceptions';
+export type { OracleErrorCode } from './domain/exceptions';
+export type { ILogger } from './application/ports/ILogger';
+export type { ITokenPriceRepository } from './domain/repositories';
+export type { FeeCalculationResult, MixerXGasPurpose, MixerXFeeCalculationResult, MixerXGasParametersForTxResult, MixerXTxType, WithdrawalFeeInput, } from './infrastructure/mixerx/MixerXFeeOracle';

package/dist/index.js

@@ -14,9 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMixerXGasLimit = exports.MIXERX_GAS_LIMITS = void 0;
+exports.TokenPriceError = exports.OracleError = void 0;
 __exportStar(require("./factory"), exports);
-var config_1 = require("./domain/config");
-Object.defineProperty(exports, "MIXERX_GAS_LIMITS", { enumerable: true, get: function () { return config_1.MIXERX_GAS_LIMITS; } });
-Object.defineProperty(exports, "getMixerXGasLimit", { enumerable: true, get: function () { return config_1.getMixerXGasLimit; } });
+var exceptions_1 = require("./domain/exceptions");
+Object.defineProperty(exports, "OracleError", { enumerable: true, get: function () { return exceptions_1.OracleError; } });
+Object.defineProperty(exports, "TokenPriceError", { enumerable: true, get: function () { return exceptions_1.TokenPriceError; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,0CAAuE;AAA9D,2GAAA,iBAAiB,OAAA;AAAE,2GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,kDAAmE;AAA1D,yGAAA,WAAW,OAAA;AAAE,6GAAA,eAAe,OAAA","sourcesContent":["export * from './factory';\r\nexport { OracleError, TokenPriceError } from './domain/exceptions';\r\nexport type { OracleErrorCode } from './domain/exceptions';\r\nexport type { ILogger } from './application/ports/ILogger';\r\nexport type { ITokenPriceRepository } from './domain/repositories';\r\nexport type {\r\n  FeeCalculationResult,\r\n  MixerXGasPurpose,\r\n  MixerXFeeCalculationResult,\r\n  MixerXGasParametersForTxResult,\r\n  MixerXTxType,\r\n  WithdrawalFeeInput,\r\n} from './infrastructure/mixerx/MixerXFeeOracle';\r\n"]}

package/dist/infrastructure/blockchain/staticProvider.d.ts

@@ -1,4 +1,3 @@
 import { ethers, type JsonRpcApiProviderOptions } from 'ethers';
-import type { ChainId } from '../../types';
-export declare const createStaticJsonRpcProvider: (rpcUrl: string, chainId: ChainId | number, options?: JsonRpcApiProviderOptions) => ethers.JsonRpcProvider;
-//# sourceMappingURL=staticProvider.d.ts.map
+export declare function createVerifiedJsonRpcProvider(rpcUrl: string, chainId: number, options?: JsonRpcApiProviderOptions, timeoutMs?: number): ethers.JsonRpcProvider;
+export declare function assertProviderNetwork(provider: ethers.JsonRpcProvider, expectedChainId: number): Promise<void>;

package/dist/infrastructure/blockchain/staticProvider.js

@@ -1,12 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createStaticJsonRpcProvider = void 0;
+exports.createVerifiedJsonRpcProvider = createVerifiedJsonRpcProvider;
+exports.assertProviderNetwork = assertProviderNetwork;
 const ethers_1 = require("ethers");
-const createStaticJsonRpcProvider = (rpcUrl, chainId, options = {}) => {
-    return new ethers_1.ethers.JsonRpcProvider(rpcUrl, Number(chainId), {
-        ...options,
-        staticNetwork: true,
-    });
-};
-exports.createStaticJsonRpcProvider = createStaticJsonRpcProvider;
+const exceptions_1 = require("../../domain/exceptions");
+const gasOracleConfigs_1 = require("../config/gasOracleConfigs");
+const DEFAULT_RPC_TIMEOUT_MS = 10_000;
+function createVerifiedJsonRpcProvider(rpcUrl, chainId, options, timeoutMs = DEFAULT_RPC_TIMEOUT_MS) {
+    (0, gasOracleConfigs_1.assertSepoliaChainId)(chainId);
+    validateRpcUrl(rpcUrl);
+    if (!Number.isInteger(timeoutMs) || timeoutMs < 1_000 || timeoutMs > 60_000) {
+        throw new exceptions_1.OracleError('INVALID_CONFIG', 'rpcTimeoutMs must be an integer between 1000 and 60000');
+    }
+    const request = new ethers_1.FetchRequest(rpcUrl);
+    request.timeout = timeoutMs;
+    return new ethers_1.ethers.JsonRpcProvider(request, undefined, options);
+}
+async function assertProviderNetwork(provider, expectedChainId) {
+    const network = await provider.getNetwork();
+    if (network.chainId !== BigInt(expectedChainId)) {
+        throw new exceptions_1.OracleError('NETWORK_MISMATCH', `RPC network mismatch: expected ${String(expectedChainId)}, received ${network.chainId.toString()}`);
+    }
+}
+function validateRpcUrl(rawUrl) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        throw new exceptions_1.OracleError('INVALID_CONFIG', 'rpcUrl must be a valid HTTPS URL');
+    }
+    if (url.protocol !== 'https:' || url.username || url.password) {
+        throw new exceptions_1.OracleError('INVALID_CONFIG', 'rpcUrl must use HTTPS and must not contain user-info credentials');
+    }
+}
 //# sourceMappingURL=staticProvider.js.map

package/dist/infrastructure/blockchain/staticProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"staticProvider.js","sourceRoot":"","sources":["../../../src/infrastructure/blockchain/staticProvider.ts"],"names":[],"mappings":";;;AAAA,mCAAgE;AAGzD,MAAM,2BAA2B,GAAG,CACzC,MAAc,EACd,OAAyB,EACzB,UAAqC,EAAE,EACf,EAAE;IAC1B,OAAO,IAAI,eAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;QACzD,GAAG,OAAO;QACV,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;AACL,CAAC,CAAC;AATW,QAAA,2BAA2B,+BAStC"}
+{"version":3,"file":"staticProvider.js","sourceRoot":"","sources":["../../../src/infrastructure/blockchain/staticProvider.ts"],"names":[],"mappings":";;AAMA,sEAeC;AAED,sDAWC;AAlCD,mCAA8E;AAC9E,wDAAsD;AACtD,iEAAkE;AAElE,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,SAAgB,6BAA6B,CAC3C,MAAc,EACd,OAAe,EACf,OAAmC,EACnC,YAAoB,sBAAsB;IAE1C,IAAA,uCAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,KAAK,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;QAC5E,MAAM,IAAI,wBAAW,CAAC,gBAAgB,EAAE,wDAAwD,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,qBAAY,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAC5B,OAAO,IAAI,eAAM,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAEM,KAAK,UAAU,qBAAqB,CACzC,QAAgC,EAChC,eAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC5C,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,wBAAW,CACnB,kBAAkB,EAClB,kCAAkC,MAAM,CAAC,eAAe,CAAC,cAAc,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CACpG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,wBAAW,CAAC,gBAAgB,EAAE,kCAAkC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9D,MAAM,IAAI,wBAAW,CAAC,gBAAgB,EAAE,kEAAkE,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC","sourcesContent":["import { ethers, FetchRequest, type JsonRpcApiProviderOptions } from 'ethers';\r\nimport { OracleError } from '../../domain/exceptions';\r\nimport { assertSepoliaChainId } from '../config/gasOracleConfigs';\r\n\r\nconst DEFAULT_RPC_TIMEOUT_MS = 10_000;\r\n\r\nexport function createVerifiedJsonRpcProvider(\r\n  rpcUrl: string,\r\n  chainId: number,\r\n  options?: JsonRpcApiProviderOptions,\r\n  timeoutMs: number = DEFAULT_RPC_TIMEOUT_MS,\r\n): ethers.JsonRpcProvider {\r\n  assertSepoliaChainId(chainId);\r\n  validateRpcUrl(rpcUrl);\r\n  if (!Number.isInteger(timeoutMs) || timeoutMs < 1_000 || timeoutMs > 60_000) {\r\n    throw new OracleError('INVALID_CONFIG', 'rpcTimeoutMs must be an integer between 1000 and 60000');\r\n  }\r\n\r\n  const request = new FetchRequest(rpcUrl);\r\n  request.timeout = timeoutMs;\r\n  return new ethers.JsonRpcProvider(request, undefined, options);\r\n}\r\n\r\nexport async function assertProviderNetwork(\r\n  provider: ethers.JsonRpcProvider,\r\n  expectedChainId: number,\r\n): Promise<void> {\r\n  const network = await provider.getNetwork();\r\n  if (network.chainId !== BigInt(expectedChainId)) {\r\n    throw new OracleError(\r\n      'NETWORK_MISMATCH',\r\n      `RPC network mismatch: expected ${String(expectedChainId)}, received ${network.chainId.toString()}`,\r\n    );\r\n  }\r\n}\r\n\r\nfunction validateRpcUrl(rawUrl: string): void {\r\n  let url: URL;\r\n  try {\r\n    url = new URL(rawUrl);\r\n  } catch {\r\n    throw new OracleError('INVALID_CONFIG', 'rpcUrl must be a valid HTTPS URL');\r\n  }\r\n\r\n  if (url.protocol !== 'https:' || url.username || url.password) {\r\n    throw new OracleError('INVALID_CONFIG', 'rpcUrl must use HTTPS and must not contain user-info credentials');\r\n  }\r\n}\r\n"]}

package/dist/infrastructure/config/ProtocolTokenConfig.d.ts

@@ -1,4 +1,3 @@
 import type { ChainId, Token } from '../../types';
 export declare function resolveOffchainOracleAddress(chainId: ChainId | number): string;
 export declare function resolveDefaultTokens(chainId: ChainId | number): Token[];
-//# sourceMappingURL=ProtocolTokenConfig.d.ts.map

package/dist/infrastructure/config/ProtocolTokenConfig.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveOffchainOracleAddress = resolveOffchainOracleAddress;
 exports.resolveDefaultTokens = resolveDefaultTokens;
 const config_1 = require("@mixerx/config");
+const gasOracleConfigs_1 = require("./gasOracleConfigs");
 function toSupportedChainId(chainId) {
     const numericChainId = Number(chainId);
+    (0, gasOracleConfigs_1.assertSepoliaChainId)(numericChainId);
     if (!(0, config_1.isSupportedNetId)(numericChainId)) {
         throw new Error(`Unsupported chainId ${chainId} for @mixerx/config`);
     }

package/dist/infrastructure/config/ProtocolTokenConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProtocolTokenConfig.js","sourceRoot":"","sources":["../../../src/infrastructure/config/ProtocolTokenConfig.ts"],"names":[],"mappings":";;AAcA,oEAQC;AAED,oDAoCC;AA5DD,2CAA+E;AAK/E,SAAS,kBAAkB,CAAC,OAAyB;IACnD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,IAAA,yBAAgB,EAAC,cAAc,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,qBAAqB,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,SAAgB,4BAA4B,CAAC,OAAyB;IACpE,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAA,yBAAgB,EAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,EAAE,SAAS,CAAC,qBAAqB,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+DAA+D,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAyB;IAC5D,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,gBAAgB,GAAG,kBAAS,CAAC,KAAK,CAA+C,CAAC;IACxF,MAAM,aAAa,GAAG,IAAA,yBAAgB,EAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE1C,IAAI,aAAa,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC7C,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC;QACjF,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE;YAC/B,OAAO,EAAE,kBAAkB;YAC3B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE;YAC5D,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,mBAAmB;SACnD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YAC7D,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE;gBACzB,OAAO,EAAE,YAAY;gBACrB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE;gBACzC,QAAQ,EAAE,YAAY,CAAC,QAAQ;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8DAA8D,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"ProtocolTokenConfig.js","sourceRoot":"","sources":["../../../src/infrastructure/config/ProtocolTokenConfig.ts"],"names":[],"mappings":";;AAgBA,oEAQC;AAED,oDAoCC;AA9DD,2CAA+E;AAI/E,yDAA0D;AAE1D,SAAS,kBAAkB,CAAC,OAAyB;IACnD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,IAAA,uCAAoB,EAAC,cAAc,CAAC,CAAC;IACrC,IAAI,CAAC,IAAA,yBAAgB,EAAC,cAAc,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,qBAAqB,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,SAAgB,4BAA4B,CAAC,OAAyB;IACpE,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAA,yBAAgB,EAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,EAAE,SAAS,CAAC,qBAAqB,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+DAA+D,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAyB;IAC5D,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,gBAAgB,GAAG,kBAAS,CAAC,KAAK,CAA+C,CAAC;IACxF,MAAM,aAAa,GAAG,IAAA,yBAAgB,EAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE1C,IAAI,aAAa,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC7C,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC;QACjF,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE;YAC/B,OAAO,EAAE,kBAAkB;YAC3B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE;YAC5D,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,mBAAmB;SACnD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YAC7D,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE;gBACzB,OAAO,EAAE,YAAY;gBACrB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE;gBACzC,QAAQ,EAAE,YAAY,CAAC,QAAQ;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8DAA8D,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { getNetworkConfig, instances, isSupportedNetId } from '@mixerx/config';\r\nimport type { availableIds } from '@mixerx/config';\r\nimport type { CurrencyConfig } from '@mixerx/config';\r\nimport type { ChainId, Token } from '../../types';\r\nimport { assertSepoliaChainId } from './gasOracleConfigs';\r\n\r\nfunction toSupportedChainId(chainId: ChainId | number): availableIds {\r\n  const numericChainId = Number(chainId);\r\n  assertSepoliaChainId(numericChainId);\r\n  if (!isSupportedNetId(numericChainId)) {\r\n    throw new Error(`Unsupported chainId ${chainId} for @mixerx/config`);\r\n  }\r\n\r\n  return numericChainId;\r\n}\r\n\r\nexport function resolveOffchainOracleAddress(chainId: ChainId | number): string {\r\n  const validatedChainId = toSupportedChainId(chainId);\r\n  const network = getNetworkConfig(validatedChainId);\r\n  const address = network?.contracts.offchainOracleAddress;\r\n  if (!address) {\r\n    throw new Error(`Missing offchainOracleAddress in @mixerx/config for chainId ${chainId}`);\r\n  }\r\n  return address;\r\n}\r\n\r\nexport function resolveDefaultTokens(chainId: ChainId | number): Token[] {\r\n  const netId = toSupportedChainId(chainId);\r\n  const networkInstances = instances[netId] as Record<string, CurrencyConfig> | undefined;\r\n  const networkConfig = getNetworkConfig(netId);\r\n\r\n  const tokenMap = new Map<string, Token>();\r\n\r\n  if (networkConfig?.tokens.mixerXTokenAddress) {\r\n    const mixerXTokenAddress = networkConfig.tokens.mixerXTokenAddress.toLowerCase();\r\n    tokenMap.set(mixerXTokenAddress, {\r\n      address: mixerXTokenAddress,\r\n      symbol: networkConfig.tokens.mixerXTokenSymbol.toLowerCase(),\r\n      decimals: networkConfig.tokens.mixerXTokenDecimals,\r\n    });\r\n  }\r\n\r\n  if (networkInstances) {\r\n    for (const currencyData of Object.values(networkInstances)) {\r\n      if (!currencyData.tokenAddress) {\r\n        continue;\r\n      }\r\n      const tokenAddress = currencyData.tokenAddress.toLowerCase();\r\n      tokenMap.set(tokenAddress, {\r\n        address: tokenAddress,\r\n        symbol: currencyData.symbol.toLowerCase(),\r\n        decimals: currencyData.decimals,\r\n      });\r\n    }\r\n  }\r\n\r\n  const tokens = Array.from(tokenMap.values());\r\n  if (tokens.length === 0) {\r\n    throw new Error(`No default tokens resolved from @mixerx/config for chainId ${chainId}`);\r\n  }\r\n\r\n  return tokens;\r\n}\r\n"]}

package/dist/infrastructure/config/gasOracleConfigs.d.ts

@@ -1,14 +1,3 @@
-import { getNetworkConfig as getProtocolNetworkConfig } from '@mixerx/config';
 export type ChainId = number;
-export interface NetworkConfig {
-    chainId: number;
-    rpcUrl?: string;
-}
-export declare const NETWORKS: Record<number, NetworkConfig>;
-export declare function getNetworkConfig(chainId: ChainId): ReturnType<typeof getProtocolNetworkConfig>;
-export declare function isSupportedChain(chainId: number): boolean;
-export declare function getSupportedChainIds(): number[];
-export declare function getDefaultGasPrice(): number;
-export declare function getMaxGasPrice(): number;
-export declare function getRpcUrl(chainId: number): string | undefined;
-//# sourceMappingURL=gasOracleConfigs.d.ts.map
+export declare const SEPOLIA_CHAIN_ID = 11155111;
+export declare function assertSepoliaChainId(chainId: number): void;

package/dist/infrastructure/config/gasOracleConfigs.js

@@ -1,38 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NETWORKS = void 0;
-exports.getNetworkConfig = getNetworkConfig;
-exports.isSupportedChain = isSupportedChain;
-exports.getSupportedChainIds = getSupportedChainIds;
-exports.getDefaultGasPrice = getDefaultGasPrice;
-exports.getMaxGasPrice = getMaxGasPrice;
-exports.getRpcUrl = getRpcUrl;
-const config_1 = require("@mixerx/config");
-const SUPPORTED_CHAIN_IDS = [...config_1.SUPPORTED_NET_IDS];
-exports.NETWORKS = Object.fromEntries(SUPPORTED_CHAIN_IDS.map((chainId) => [chainId, { chainId }]));
-function getNetworkConfig(chainId) {
-    if (!(0, config_1.isSupportedNetId)(chainId)) {
-        return undefined;
+exports.SEPOLIA_CHAIN_ID = void 0;
+exports.assertSepoliaChainId = assertSepoliaChainId;
+const exceptions_1 = require("../../domain/exceptions");
+exports.SEPOLIA_CHAIN_ID = 11_155_111;
+function assertSepoliaChainId(chainId) {
+    if (chainId !== exports.SEPOLIA_CHAIN_ID) {
+        throw new exceptions_1.OracleError('INVALID_CONFIG', `Unsupported chainId ${String(chainId)}; @mixerx/oracles is Sepolia-only`);
     }
-    return (0, config_1.getNetworkConfig)(chainId);
-}
-function isSupportedChain(chainId) {
-    return (0, config_1.isSupportedNetId)(chainId);
-}
-function getSupportedChainIds() {
-    return [...SUPPORTED_CHAIN_IDS];
-}
-function getDefaultGasPrice() {
-    return 20;
-}
-function getMaxGasPrice() {
-    return 500;
-}
-function getRpcUrl(chainId) {
-    const network = getNetworkConfig(chainId);
-    if (!network || !('rpcUrl' in network) || typeof network.rpcUrl !== 'string') {
-        return undefined;
-    }
-    return network.rpcUrl;
 }
 //# sourceMappingURL=gasOracleConfigs.js.map

package/dist/infrastructure/config/gasOracleConfigs.js.map

@@ -1 +1 @@
-{"version":3,"file":"gasOracleConfigs.js","sourceRoot":"","sources":["../../../src/infrastructure/config/gasOracleConfigs.ts"],"names":[],"mappings":";;;AAoBA,4CAMC;AAED,4CAEC;AAED,oDAEC;AAED,gDAEC;AAED,wCAEC;AAED,8BAOC;AAnDD,2CAIwB;AAUxB,MAAM,mBAAmB,GAAG,CAAC,GAAG,0BAAiB,CAAa,CAAC;AAElD,QAAA,QAAQ,GAAkC,MAAM,CAAC,WAAW,CACvE,mBAAmB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAC7D,CAAC;AAEF,SAAgB,gBAAgB,CAAC,OAAgB;IAC/C,IAAI,CAAC,IAAA,yBAAgB,EAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAA,yBAAwB,EAAC,OAAuB,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAA,yBAAgB,EAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,oBAAoB;IAClC,OAAO,CAAC,GAAG,mBAAmB,CAAC,CAAC;AAClC,CAAC;AAED,SAAgB,kBAAkB;IAChC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,cAAc;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,SAAS,CAAC,OAAe;IACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}
+{"version":3,"file":"gasOracleConfigs.js","sourceRoot":"","sources":["../../../src/infrastructure/config/gasOracleConfigs.ts"],"names":[],"mappings":";;;AAKA,oDAOC;AAZD,wDAAsD;AAGzC,QAAA,gBAAgB,GAAG,UAAU,CAAC;AAE3C,SAAgB,oBAAoB,CAAC,OAAe;IAClD,IAAI,OAAO,KAAK,wBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,wBAAW,CACnB,gBAAgB,EAChB,uBAAuB,MAAM,CAAC,OAAO,CAAC,mCAAmC,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { OracleError } from '../../domain/exceptions';\r\n\r\nexport type ChainId = number;\r\nexport const SEPOLIA_CHAIN_ID = 11_155_111;\r\n\r\nexport function assertSepoliaChainId(chainId: number): void {\r\n  if (chainId !== SEPOLIA_CHAIN_ID) {\r\n    throw new OracleError(\r\n      'INVALID_CONFIG',\r\n      `Unsupported chainId ${String(chainId)}; @mixerx/oracles is Sepolia-only`,\r\n    );\r\n  }\r\n}\r\n"]}

package/dist/infrastructure/config/index.d.ts

@@ -2,4 +2,3 @@
  * Infrastructure configuration exports
  */
 export { resolveDefaultTokens, resolveOffchainOracleAddress } from './ProtocolTokenConfig';
-//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/config/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAAiC;AACjC,6DAA2F;AAAlF,2HAAA,oBAAoB,OAAA;AAAE,mIAAA,4BAA4B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/config/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAAiC;AACjC,6DAA2F;AAAlF,2HAAA,oBAAoB,OAAA;AAAE,mIAAA,4BAA4B,OAAA","sourcesContent":["/**\r\n * Infrastructure configuration exports\r\n */\r\n\r\n// Protocol-derived configuration\r\nexport { resolveDefaultTokens, resolveOffchainOracleAddress } from './ProtocolTokenConfig';\r\n"]}

package/dist/infrastructure/gas/GasPriceOracle.d.ts

@@ -2,6 +2,7 @@ import type { ILogger } from '../../application/ports/ILogger';
 import type { ChainId } from '../config/gasOracleConfigs';
 export interface GasPriceParams {
     gasPrice?: string;
+    baseFeePerGas?: string;
     maxFeePerGas?: string;
     maxPriorityFeePerGas?: string;
 }
@@ -14,6 +15,8 @@ export interface GasPriceOracleOptions {
     chainId: ChainId;
     rpcUrl: string;
     logger?: ILogger;
+    rpcTimeoutMs?: number;
+    maxGasPriceGwei?: number;
     fallbackGasPrices?: {
         legacy?: {
             instant: number;
@@ -31,11 +34,18 @@ export interface GasPriceOracleOptions {
 export declare class GasPriceOracle {
     private readonly provider;
     private readonly logger;
+    private readonly chainId;
+    private readonly maxGasPriceWei;
     private readonly fallback;
     constructor(options: GasPriceOracleOptions);
     getTxGasParams(input?: GetTxGasParamsInput): Promise<GasPriceParams>;
+    private fallbackParams;
+    private validateFallback;
+    private validateGwei;
+    private validateBump;
     private bump;
-    private toWeiGwei;
     private bumpGwei;
+    private toWeiGwei;
+    private cap;
+    private min;
 }
-//# sourceMappingURL=GasPriceOracle.d.ts.map

package/dist/infrastructure/gas/GasPriceOracle.js

@@ -2,75 +2,114 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GasPriceOracle = void 0;
 const ILogger_1 = require("../../application/ports/ILogger");
+const exceptions_1 = require("../../domain/exceptions");
 const staticProvider_1 = require("../blockchain/staticProvider");
+const DEFAULT_MAX_GAS_PRICE_GWEI = 500;
 class GasPriceOracle {
     provider;
     logger;
+    chainId;
+    maxGasPriceWei;
     fallback;
     constructor(options) {
-        this.provider = (0, staticProvider_1.createStaticJsonRpcProvider)(options.rpcUrl, options.chainId, { batchMaxCount: 1 });
+        this.chainId = options.chainId;
+        this.provider = (0, staticProvider_1.createVerifiedJsonRpcProvider)(options.rpcUrl, options.chainId, { batchMaxCount: 1 }, options.rpcTimeoutMs);
         this.logger = options.logger ?? new ILogger_1.NullLogger();
+        const maxGasPriceGwei = options.maxGasPriceGwei ?? DEFAULT_MAX_GAS_PRICE_GWEI;
+        const validatedMaxGasPriceGwei = this.validateGwei(maxGasPriceGwei, 'maxGasPriceGwei');
+        if (validatedMaxGasPriceGwei === 0) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', 'maxGasPriceGwei must be greater than 0');
+        }
+        this.maxGasPriceWei = this.toWeiGwei(validatedMaxGasPriceGwei);
         this.fallback = {
             legacy: options.fallbackGasPrices?.legacy ?? { instant: 35, fast: 25, standard: 20, low: 15 },
-            eip1559: options.fallbackGasPrices?.eip1559 ?? { baseFee: 15, maxFeePerGas: 30, maxPriorityFeePerGas: 2 },
+            eip1559: options.fallbackGasPrices?.eip1559 ?? {
+                baseFee: 15,
+                maxFeePerGas: 30,
+                maxPriorityFeePerGas: 2,
+            },
         };
+        this.validateFallback();
     }
     async getTxGasParams(input = {}) {
-        const rawBumpPercent = Number(input.bumpPercent);
-        const bumpPercent = Number.isFinite(rawBumpPercent)
-            ? Math.max(0, Math.floor(rawBumpPercent))
-            : 0;
+        const bumpPercent = this.validateBump(input.bumpPercent ?? 0);
         try {
-            const feeData = await this.provider.getFeeData();
-            if (!input.isLegacy && feeData.maxFeePerGas && feeData.maxPriorityFeePerGas) {
-                const maxFeePerGas = this.bump(feeData.maxFeePerGas, bumpPercent);
-                const maxPriorityFeePerGas = this.bump(feeData.maxPriorityFeePerGas, bumpPercent);
+            await (0, staticProvider_1.assertProviderNetwork)(this.provider, this.chainId);
+            const [feeData, block] = await Promise.all([
+                this.provider.getFeeData(),
+                this.provider.getBlock('latest'),
+            ]);
+            if (!input.isLegacy && feeData.maxFeePerGas && feeData.maxPriorityFeePerGas && block?.baseFeePerGas) {
+                const baseFeePerGas = this.cap(block.baseFeePerGas);
+                const maxPriorityFeePerGas = this.cap(this.bump(feeData.maxPriorityFeePerGas, bumpPercent));
+                const maxFeePerGas = this.cap(this.bump(feeData.maxFeePerGas, bumpPercent));
                 return {
+                    baseFeePerGas: baseFeePerGas.toString(),
                     maxFeePerGas: maxFeePerGas.toString(),
-                    maxPriorityFeePerGas: maxPriorityFeePerGas.toString(),
+                    maxPriorityFeePerGas: this.min(maxPriorityFeePerGas, maxFeePerGas).toString(),
                 };
             }
             if (feeData.gasPrice) {
-                return {
-                    gasPrice: this.bump(feeData.gasPrice, bumpPercent).toString(),
-                };
+                return { gasPrice: this.cap(this.bump(feeData.gasPrice, bumpPercent)).toString() };
             }
         }
         catch (error) {
-            this.logger.warn('GasPriceOracle failed to fetch gas price; using fallback', error);
+            if (error instanceof exceptions_1.OracleError && error.code === 'NETWORK_MISMATCH') {
+                throw error;
+            }
+            this.logger.warn('Gas RPC request failed; bounded fallback selected', { code: 'RPC_REQUEST_FAILED' });
         }
+        return this.fallbackParams(input, bumpPercent);
+    }
+    fallbackParams(input, bumpPercent) {
         if (input.isLegacy) {
-            const requestedSpeed = input.legacySpeed;
-            const speed = requestedSpeed && Object.prototype.hasOwnProperty.call(this.fallback.legacy, requestedSpeed)
-                ? requestedSpeed
-                : 'fast';
-            const bumpedLegacyGwei = this.bumpGwei(this.fallback.legacy[speed], bumpPercent);
-            return { gasPrice: this.toWeiGwei(bumpedLegacyGwei).toString() };
+            const speed = input.legacySpeed ?? 'fast';
+            const gasPrice = this.cap(this.toWeiGwei(this.bumpGwei(this.fallback.legacy[speed], bumpPercent)));
+            return { gasPrice: gasPrice.toString() };
         }
-        const bumpedMaxFeePerGasGwei = this.bumpGwei(this.fallback.eip1559.maxFeePerGas, bumpPercent);
-        const bumpedMaxPriorityFeePerGasGwei = this.bumpGwei(this.fallback.eip1559.maxPriorityFeePerGas, bumpPercent);
+        const baseFeePerGas = this.cap(this.toWeiGwei(this.fallback.eip1559.baseFee));
+        const maxFeePerGas = this.cap(this.toWeiGwei(this.bumpGwei(this.fallback.eip1559.maxFeePerGas, bumpPercent)));
+        const priority = this.cap(this.toWeiGwei(this.bumpGwei(this.fallback.eip1559.maxPriorityFeePerGas, bumpPercent)));
         return {
-            maxFeePerGas: this.toWeiGwei(bumpedMaxFeePerGasGwei).toString(),
-            maxPriorityFeePerGas: this.toWeiGwei(bumpedMaxPriorityFeePerGasGwei).toString(),
+            baseFeePerGas: baseFeePerGas.toString(),
+            maxFeePerGas: maxFeePerGas.toString(),
+            maxPriorityFeePerGas: this.min(priority, maxFeePerGas).toString(),
         };
     }
-    bump(value, percent) {
-        if (!percent) {
-            return value;
+    validateFallback() {
+        for (const [name, value] of Object.entries(this.fallback.legacy)) {
+            this.validateGwei(value, `fallbackGasPrices.legacy.${name}`);
+        }
+        for (const [name, value] of Object.entries(this.fallback.eip1559)) {
+            this.validateGwei(value, `fallbackGasPrices.eip1559.${name}`);
         }
-        return (value * BigInt(100 + percent)) / 100n;
     }
-    toWeiGwei(gwei) {
-        if (!Number.isFinite(gwei) || gwei < 0) {
-            throw new Error(`Invalid fallbackGasPrices gwei value: ${String(gwei)}. Expected a finite non-negative number.`);
+    validateGwei(value, name) {
+        if (!Number.isFinite(value) || value < 0 || value > DEFAULT_MAX_GAS_PRICE_GWEI) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', `${name} must be a finite number between 0 and ${String(DEFAULT_MAX_GAS_PRICE_GWEI)} gwei`);
         }
-        return BigInt(Math.round(gwei * 1e9));
+        return value;
     }
-    bumpGwei(gwei, percent) {
-        if (!percent) {
-            return gwei;
+    validateBump(value) {
+        if (!Number.isFinite(value) || value < 0 || value > 100) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', 'bumpPercent must be a finite number between 0 and 100');
         }
-        return (gwei * (100 + percent)) / 100;
+        return Math.floor(value);
+    }
+    bump(value, percent) {
+        return percent === 0 ? value : (value * BigInt(100 + percent)) / 100n;
+    }
+    bumpGwei(gwei, percent) {
+        return percent === 0 ? gwei : (gwei * (100 + percent)) / 100;
+    }
+    toWeiGwei(gwei) {
+        return BigInt(Math.round(gwei * 1e9));
+    }
+    cap(value) {
+        return this.min(value, this.maxGasPriceWei);
+    }
+    min(left, right) {
+        return left < right ? left : right;
     }
 }
 exports.GasPriceOracle = GasPriceOracle;

package/dist/infrastructure/gas/GasPriceOracle.js.map

@@ -1 +1 @@
-{"version":3,"file":"GasPriceOracle.js","sourceRoot":"","sources":["../../../src/infrastructure/gas/GasPriceOracle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GasPriceOracle.js","sourceRoot":"","sources":["../../../src/infrastructure/gas/GasPriceOracle.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonRpcProvider } from 'ethers';\r\nimport type { ILogger } from '../../application/ports/ILogger';\r\nimport { NullLogger } from '../../application/ports/ILogger';\r\nimport { OracleError } from '../../domain/exceptions';\r\nimport { assertProviderNetwork, createVerifiedJsonRpcProvider } from '../blockchain/staticProvider';\r\nimport type { ChainId } from '../config/gasOracleConfigs';\r\n\r\nconst DEFAULT_MAX_GAS_PRICE_GWEI = 500;\r\n\r\nexport interface GasPriceParams {\r\n  gasPrice?: string;\r\n  baseFeePerGas?: string;\r\n  maxFeePerGas?: string;\r\n  maxPriorityFeePerGas?: string;\r\n}\r\n\r\nexport interface GetTxGasParamsInput {\r\n  isLegacy?: boolean;\r\n  bumpPercent?: number;\r\n  legacySpeed?: 'instant' | 'fast' | 'standard' | 'low';\r\n}\r\n\r\nexport interface GasPriceOracleOptions {\r\n  chainId: ChainId;\r\n  rpcUrl: string;\r\n  logger?: ILogger;\r\n  rpcTimeoutMs?: number;\r\n  maxGasPriceGwei?: number;\r\n  fallbackGasPrices?: {\r\n    legacy?: { instant: number; fast: number; standard: number; low: number };\r\n    eip1559?: { baseFee: number; maxFeePerGas: number; maxPriorityFeePerGas: number };\r\n  };\r\n}\r\n\r\nexport class GasPriceOracle {\r\n  private readonly provider: JsonRpcProvider;\r\n  private readonly logger: ILogger;\r\n  private readonly chainId: number;\r\n  private readonly maxGasPriceWei: bigint;\r\n  private readonly fallback: Required<NonNullable<GasPriceOracleOptions['fallbackGasPrices']>>;\r\n\r\n  constructor(options: GasPriceOracleOptions) {\r\n    this.chainId = options.chainId;\r\n    this.provider = createVerifiedJsonRpcProvider(\r\n      options.rpcUrl,\r\n      options.chainId,\r\n      { batchMaxCount: 1 },\r\n      options.rpcTimeoutMs,\r\n    );\r\n    this.logger = options.logger ?? new NullLogger();\r\n    const maxGasPriceGwei = options.maxGasPriceGwei ?? DEFAULT_MAX_GAS_PRICE_GWEI;\r\n    const validatedMaxGasPriceGwei = this.validateGwei(maxGasPriceGwei, 'maxGasPriceGwei');\r\n    if (validatedMaxGasPriceGwei === 0) {\r\n      throw new OracleError('INVALID_CONFIG', 'maxGasPriceGwei must be greater than 0');\r\n    }\r\n    this.maxGasPriceWei = this.toWeiGwei(validatedMaxGasPriceGwei);\r\n    this.fallback = {\r\n      legacy: options.fallbackGasPrices?.legacy ?? { instant: 35, fast: 25, standard: 20, low: 15 },\r\n      eip1559: options.fallbackGasPrices?.eip1559 ?? {\r\n        baseFee: 15,\r\n        maxFeePerGas: 30,\r\n        maxPriorityFeePerGas: 2,\r\n      },\r\n    };\r\n    this.validateFallback();\r\n  }\r\n\r\n  async getTxGasParams(input: GetTxGasParamsInput = {}): Promise<GasPriceParams> {\r\n    const bumpPercent = this.validateBump(input.bumpPercent ?? 0);\r\n\r\n    try {\r\n      await assertProviderNetwork(this.provider, this.chainId);\r\n      const [feeData, block] = await Promise.all([\r\n        this.provider.getFeeData(),\r\n        this.provider.getBlock('latest'),\r\n      ]);\r\n\r\n      if (!input.isLegacy && feeData.maxFeePerGas && feeData.maxPriorityFeePerGas && block?.baseFeePerGas) {\r\n        const baseFeePerGas = this.cap(block.baseFeePerGas);\r\n        const maxPriorityFeePerGas = this.cap(this.bump(feeData.maxPriorityFeePerGas, bumpPercent));\r\n        const maxFeePerGas = this.cap(this.bump(feeData.maxFeePerGas, bumpPercent));\r\n        return {\r\n          baseFeePerGas: baseFeePerGas.toString(),\r\n          maxFeePerGas: maxFeePerGas.toString(),\r\n          maxPriorityFeePerGas: this.min(maxPriorityFeePerGas, maxFeePerGas).toString(),\r\n        };\r\n      }\r\n\r\n      if (feeData.gasPrice) {\r\n        return { gasPrice: this.cap(this.bump(feeData.gasPrice, bumpPercent)).toString() };\r\n      }\r\n    } catch (error) {\r\n      if (error instanceof OracleError && error.code === 'NETWORK_MISMATCH') {\r\n        throw error;\r\n      }\r\n      this.logger.warn('Gas RPC request failed; bounded fallback selected', { code: 'RPC_REQUEST_FAILED' });\r\n    }\r\n\r\n    return this.fallbackParams(input, bumpPercent);\r\n  }\r\n\r\n  private fallbackParams(input: GetTxGasParamsInput, bumpPercent: number): GasPriceParams {\r\n    if (input.isLegacy) {\r\n      const speed = input.legacySpeed ?? 'fast';\r\n      const gasPrice = this.cap(this.toWeiGwei(this.bumpGwei(this.fallback.legacy[speed], bumpPercent)));\r\n      return { gasPrice: gasPrice.toString() };\r\n    }\r\n\r\n    const baseFeePerGas = this.cap(this.toWeiGwei(this.fallback.eip1559.baseFee));\r\n    const maxFeePerGas = this.cap(\r\n      this.toWeiGwei(this.bumpGwei(this.fallback.eip1559.maxFeePerGas, bumpPercent)),\r\n    );\r\n    const priority = this.cap(\r\n      this.toWeiGwei(this.bumpGwei(this.fallback.eip1559.maxPriorityFeePerGas, bumpPercent)),\r\n    );\r\n    return {\r\n      baseFeePerGas: baseFeePerGas.toString(),\r\n      maxFeePerGas: maxFeePerGas.toString(),\r\n      maxPriorityFeePerGas: this.min(priority, maxFeePerGas).toString(),\r\n    };\r\n  }\r\n\r\n  private validateFallback(): void {\r\n    for (const [name, value] of Object.entries(this.fallback.legacy)) {\r\n      this.validateGwei(value, `fallbackGasPrices.legacy.${name}`);\r\n    }\r\n    for (const [name, value] of Object.entries(this.fallback.eip1559)) {\r\n      this.validateGwei(value, `fallbackGasPrices.eip1559.${name}`);\r\n    }\r\n  }\r\n\r\n  private validateGwei(value: number, name: string): number {\r\n    if (!Number.isFinite(value) || value < 0 || value > DEFAULT_MAX_GAS_PRICE_GWEI) {\r\n      throw new OracleError(\r\n        'INVALID_CONFIG',\r\n        `${name} must be a finite number between 0 and ${String(DEFAULT_MAX_GAS_PRICE_GWEI)} gwei`,\r\n      );\r\n    }\r\n    return value;\r\n  }\r\n\r\n  private validateBump(value: number): number {\r\n    if (!Number.isFinite(value) || value < 0 || value > 100) {\r\n      throw new OracleError('INVALID_INPUT', 'bumpPercent must be a finite number between 0 and 100');\r\n    }\r\n    return Math.floor(value);\r\n  }\r\n\r\n  private bump(value: bigint, percent: number): bigint {\r\n    return percent === 0 ? value : (value * BigInt(100 + percent)) / 100n;\r\n  }\r\n\r\n  private bumpGwei(gwei: number, percent: number): number {\r\n    return percent === 0 ? gwei : (gwei * (100 + percent)) / 100;\r\n  }\r\n\r\n  private toWeiGwei(gwei: number): bigint {\r\n    return BigInt(Math.round(gwei * 1e9));\r\n  }\r\n\r\n  private cap(value: bigint): bigint {\r\n    return this.min(value, this.maxGasPriceWei);\r\n  }\r\n\r\n  private min(left: bigint, right: bigint): bigint {\r\n    return left < right ? left : right;\r\n  }\r\n}\r\n"]}

package/dist/infrastructure/mixerx/MixerXFeeOracle.d.ts

@@ -1,10 +1,11 @@
-import { GasPriceOracle, GasPriceParams } from '../gas/GasPriceOracle';
+import type { ILogger } from '../../application/ports/ILogger';
+import { type ITokenPriceRepository } from '../../domain/repositories';
+import { GasPriceOracle, type GasPriceParams } from '../gas/GasPriceOracle';
+import type { ChainId } from '../config/gasOracleConfigs';
 import { TokenPriceOracle } from '../token-price/TokenPriceOracle';
-import { ITokenPriceRepository } from '../../domain/repositories';
-import { ChainId } from '../config/gasOracleConfigs';
-import { ILogger } from '../../application/ports/ILogger';
 export type MixerXTxType = 'relayer_withdrawal' | 'user_withdrawal' | 'relayer_withdrawal_check_v4';
-export type MixerXGasPurpose = 'fee_quote' | 'fee_validation' | 'send' | 'replacement';
+export type MixerXGasPurpose = 'fee' | 'send' | 'replacement';
+export type LegacyFeePurpose = 'fee_quote' | 'fee_validation';
 export interface MixerXFeeOracleOptions {
     chainId: ChainId;
     rpcUrl: string;
@@ -15,18 +16,24 @@ export interface MixerXFeeOracleOptions {
     logger?: ILogger;
     multicallAddress?: string;
     offchainOracleAddress?: string;
+    rpcTimeoutMs?: number;
+    maxGasPriceGwei?: number;
+    maxPriceAgeMs?: number;
+    maxRefundWei?: bigint;
 }
 export interface MixerXWithdrawalFeeInput {
     currency: string;
     amount: bigint;
     decimals: number;
+    /** Gas limit obtained from a simulation or eth_estimateGas for this exact transaction. */
+    gasLimit: number;
     refund?: string;
     txType?: MixerXTxType;
-    purpose?: Extract<MixerXGasPurpose, 'fee_quote' | 'fee_validation'>;
+    purpose?: 'fee' | LegacyFeePurpose;
 }
 export interface MixerXGasParametersForTxInput {
     txType?: MixerXTxType;
-    purpose?: MixerXGasPurpose;
+    purpose?: MixerXGasPurpose | LegacyFeePurpose;
     isLegacy?: boolean;
 }
 export interface MixerXGasParametersForTxResult extends GasPriceParams {
@@ -42,52 +49,40 @@ export interface MixerXFeeCalculationResult {
     currency: string;
     gasLimit: number;
     gasPriceWei: bigint;
+    baseFeePerGas?: string;
     maxFeePerGas?: string;
     maxPriorityFeePerGas?: string;
     gasPrice?: string;
+    tokenPriceInEth?: bigint;
+    priceSource: 'native' | 'repository';
+    priceObservedAtMs?: number;
     bumpPercent: number;
     txType: MixerXTxType;
-    gasPurpose: Extract<MixerXGasPurpose, 'fee_quote' | 'fee_validation'>;
+    gasPurpose: 'fee';
 }
 export type WithdrawalFeeInput = MixerXWithdrawalFeeInput;
 export type FeeCalculationResult = MixerXFeeCalculationResult;
-/**
- * MixerXFeeOracle
- * Calculates protocol withdrawal fees and transaction gas parameters.
- *
- * Features:
- * - Explicit gas policy by purpose (quote/validation/send/replacement)
- * - Token price conversion (ETH <-> Token)
- * - Refund calculation for non-ETH tokens
- * - EIP-1559 and legacy support
- */
 export declare class MixerXFeeOracle {
-    private chainId;
-    private relayerFeePercent;
-    private gasPriceOracle;
-    private tokenPriceOracle?;
-    private priceRepository?;
-    private logger;
+    private readonly chainId;
+    private readonly relayerFeePartsPerMillion;
+    private readonly gasPriceOracle;
+    private readonly tokenPriceOracle;
+    private readonly priceRepository?;
+    private readonly logger;
+    private readonly maxPriceAgeMs;
+    private readonly maxRefundWei;
+    private readonly supportedCurrencies;
     constructor(options: MixerXFeeOracleOptions);
-    /**
-     * Calculate withdrawal fee using the fee quote/validation gas policy.
-     */
     calculateWithdrawalFee(input: MixerXWithdrawalFeeInput): Promise<MixerXFeeCalculationResult>;
-    /**
-     * Get gas parameters for a protocol transaction and purpose.
-     */
     getGasParametersForTx(input?: MixerXGasParametersForTxInput): Promise<MixerXGasParametersForTxResult>;
-    private calculateGasCost;
-    private calculateRelayerFee;
-    private getGasLimit;
-    private getBumpPercent;
-    private extractGasPriceWei;
-    private getTokenPrice;
-    private withGasDetails;
-    /**
-     * Get gas parameters without protocol policy. Prefer getGasParametersForTx for relayer operations.
-     */
+    assertReady(): Promise<void>;
     getGasParameters(isLegacy?: boolean): Promise<GasPriceParams>;
     getChainId(): ChainId;
+    private validateFeeInput;
+    private parseRefund;
+    private getFreshPrice;
+    private effectiveGasPrice;
+    private assertTotalFee;
+    private normalizePurpose;
+    private result;
 }
-//# sourceMappingURL=MixerXFeeOracle.d.ts.map