@mixerx/oracles 1.0.0 → 2.0.0

package/dist/infrastructure/mixerx/MixerXFeeOracle.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MixerXFeeOracle = void 0;
+const ILogger_1 = require("../../application/ports/ILogger");
+const TokenDefaults_1 = require("../../domain/config/TokenDefaults");
+const exceptions_1 = require("../../domain/exceptions");
+const repositories_1 = require("../../domain/repositories");
+const GasPriceOracle_1 = require("../gas/GasPriceOracle");
+const TokenPriceOracle_1 = require("../token-price/TokenPriceOracle");
+const DEFAULT_MAX_PRICE_AGE_MS = 120_000;
+const DEFAULT_MAX_REFUND_WEI = 1000000000000000000n;
+const FEE_SCALE = 1000000n;
+class MixerXFeeOracle {
+    chainId;
+    relayerFeePartsPerMillion;
+    gasPriceOracle;
+    tokenPriceOracle;
+    priceRepository;
+    logger;
+    maxPriceAgeMs;
+    maxRefundWei;
+    supportedCurrencies;
+    constructor(options) {
+        if (!Number.isFinite(options.relayerFeePercent) || options.relayerFeePercent < 0 || options.relayerFeePercent > 0.1) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', 'relayerFeePercent must be between 0 and 0.1');
+        }
+        this.maxPriceAgeMs = options.maxPriceAgeMs ?? DEFAULT_MAX_PRICE_AGE_MS;
+        if (!Number.isInteger(this.maxPriceAgeMs) || this.maxPriceAgeMs < 1_000 || this.maxPriceAgeMs > 3_600_000) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', 'maxPriceAgeMs must be between 1000 and 3600000');
+        }
+        this.maxRefundWei = options.maxRefundWei ?? DEFAULT_MAX_REFUND_WEI;
+        if (this.maxRefundWei < 0n) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', 'maxRefundWei cannot be negative');
+        }
+        this.chainId = options.chainId;
+        this.relayerFeePartsPerMillion = BigInt(Math.round(options.relayerFeePercent * Number(FEE_SCALE)));
+        this.logger = options.logger ?? new ILogger_1.NullLogger();
+        this.gasPriceOracle = options.gasPriceOracle ?? new GasPriceOracle_1.GasPriceOracle({
+            chainId: options.chainId,
+            rpcUrl: options.rpcUrl,
+            logger: this.logger,
+            rpcTimeoutMs: options.rpcTimeoutMs,
+            maxGasPriceGwei: options.maxGasPriceGwei,
+        });
+        this.tokenPriceOracle = options.tokenPriceOracle ?? new TokenPriceOracle_1.TokenPriceOracle(options.rpcUrl, options.chainId, options.offchainOracleAddress, options.multicallAddress, undefined, this.logger, options.rpcTimeoutMs);
+        this.supportedCurrencies = new Set([
+            'eth',
+            ...this.tokenPriceOracle.getSupportedTokens().map((token) => token.symbol),
+        ]);
+        this.priceRepository = options.priceRepository;
+    }
+    async calculateWithdrawalFee(input) {
+        const currency = this.validateFeeInput(input);
+        const txType = input.txType ?? 'relayer_withdrawal';
+        const gasParams = await this.getGasParametersForTx({
+            txType,
+            purpose: this.normalizePurpose(input.purpose ?? 'fee'),
+            isLegacy: false,
+        });
+        const gasLimit = input.gasLimit;
+        const gasPriceWei = this.effectiveGasPrice(gasParams);
+        const gasCostWei = gasPriceWei * BigInt(gasLimit);
+        const relayerFee = (input.amount * this.relayerFeePartsPerMillion) / FEE_SCALE;
+        if (currency === 'eth') {
+            if (input.refund !== undefined && this.parseRefund(input.refund) !== 0n) {
+                throw new exceptions_1.OracleError('INVALID_INPUT', 'refund must be zero for native ETH withdrawals');
+            }
+            const totalFee = gasCostWei + relayerFee;
+            this.assertTotalFee(totalFee, input.amount);
+            return this.result({
+                gasCost: gasCostWei,
+                relayerFee,
+                refundAmount: 0n,
+                totalFee,
+                currency,
+                gasLimit,
+                gasPriceWei,
+                gasParams,
+                txType,
+                priceSource: 'native',
+            });
+        }
+        const quote = await this.getFreshPrice(currency);
+        const decimalsFactor = 10n ** BigInt(input.decimals);
+        const gasCost = (gasCostWei * decimalsFactor) / quote.priceInEthWei;
+        const refundWei = this.parseRefund(input.refund ?? '0');
+        const refundAmount = (refundWei * decimalsFactor) / quote.priceInEthWei;
+        const totalFee = gasCost + relayerFee + refundAmount;
+        this.assertTotalFee(totalFee, input.amount);
+        return this.result({
+            gasCost,
+            relayerFee,
+            refundAmount,
+            totalFee,
+            currency,
+            gasLimit,
+            gasPriceWei,
+            gasParams,
+            txType,
+            tokenPriceInEth: quote.priceInEthWei,
+            priceSource: quote.source,
+            priceObservedAtMs: quote.observedAtMs,
+        });
+    }
+    async getGasParametersForTx(input = {}) {
+        const txType = input.txType ?? 'relayer_withdrawal';
+        const purpose = this.normalizePurpose(input.purpose ?? 'send');
+        const bumpPercent = purpose === 'send' ? 0 : (0, TokenDefaults_1.getBumpPercent)(txType);
+        const gasParams = await this.gasPriceOracle.getTxGasParams({
+            isLegacy: input.isLegacy ?? false,
+            bumpPercent,
+            legacySpeed: 'fast',
+        });
+        return { ...gasParams, txType, purpose, bumpPercent };
+    }
+    async assertReady() {
+        await this.tokenPriceOracle.fetchPrices();
+    }
+    async getGasParameters(isLegacy = false) {
+        return this.gasPriceOracle.getTxGasParams({ isLegacy });
+    }
+    getChainId() {
+        return this.chainId;
+    }
+    validateFeeInput(input) {
+        const currency = input.currency.trim().toLowerCase();
+        if (!/^[a-z0-9]{2,16}$/.test(currency)) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', 'currency must be a valid protocol token symbol');
+        }
+        if (!this.supportedCurrencies.has(currency)) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', `Unsupported MixerX currency: ${currency}`);
+        }
+        if (input.amount <= 0n) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', 'amount must be greater than zero');
+        }
+        if (!Number.isInteger(input.decimals) || input.decimals < 0 || input.decimals > 255) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', 'decimals must be an integer between 0 and 255');
+        }
+        if (!Number.isInteger(input.gasLimit) || input.gasLimit < 21_000 || input.gasLimit > 5_000_000) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', 'gasLimit must be an integer between 21000 and 5000000');
+        }
+        return currency;
+    }
+    parseRefund(raw) {
+        if (!/^\d+$/.test(raw)) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', 'refund must be an unsigned base-10 integer string');
+        }
+        const refund = BigInt(raw);
+        if (refund > this.maxRefundWei) {
+            throw new exceptions_1.OracleError('ECONOMIC_LIMIT_EXCEEDED', 'refund exceeds maxRefundWei');
+        }
+        return refund;
+    }
+    async getFreshPrice(symbol) {
+        if (!this.priceRepository) {
+            throw new exceptions_1.OracleError('TOKEN_PRICE_UNAVAILABLE', `No fresh price repository configured for ${symbol}`);
+        }
+        const [price, observedAtMs] = await Promise.all([
+            this.priceRepository.getPrice(symbol),
+            this.priceRepository.getLastUpdateTimestamp(symbol),
+        ]);
+        const quote = (0, repositories_1.toPriceQuote)(price, observedAtMs);
+        if (!quote) {
+            throw new exceptions_1.OracleError('TOKEN_PRICE_UNAVAILABLE', `Price unavailable for ${symbol}`);
+        }
+        if (Date.now() - quote.observedAtMs > this.maxPriceAgeMs || quote.observedAtMs > Date.now() + 5_000) {
+            throw new exceptions_1.OracleError('TOKEN_PRICE_STALE', `Price is stale for ${symbol}`);
+        }
+        return quote;
+    }
+    effectiveGasPrice(params) {
+        if (params.gasPrice) {
+            return BigInt(params.gasPrice);
+        }
+        if (params.baseFeePerGas && params.maxFeePerGas && params.maxPriorityFeePerGas) {
+            const maxFee = BigInt(params.maxFeePerGas);
+            const likelyEffective = BigInt(params.baseFeePerGas) + BigInt(params.maxPriorityFeePerGas);
+            return likelyEffective < maxFee ? likelyEffective : maxFee;
+        }
+        throw new exceptions_1.OracleError('RPC_REQUEST_FAILED', 'Gas price response is incomplete');
+    }
+    assertTotalFee(totalFee, amount) {
+        if (totalFee < 0n || totalFee > amount) {
+            throw new exceptions_1.OracleError('ECONOMIC_LIMIT_EXCEEDED', 'Total fee must be between zero and withdrawal amount');
+        }
+    }
+    normalizePurpose(purpose) {
+        if (purpose === 'fee_quote' || purpose === 'fee_validation') {
+            return 'fee';
+        }
+        return purpose;
+    }
+    result(input) {
+        this.logger.debug('Withdrawal fee calculated', {
+            priceSource: input.priceSource,
+            gasPurpose: 'fee',
+        });
+        return {
+            gasCost: input.gasCost,
+            relayerFee: input.relayerFee,
+            refundAmount: input.refundAmount,
+            totalFee: input.totalFee,
+            currency: input.currency,
+            gasLimit: input.gasLimit,
+            gasPriceWei: input.gasPriceWei,
+            baseFeePerGas: input.gasParams.baseFeePerGas,
+            maxFeePerGas: input.gasParams.maxFeePerGas,
+            maxPriorityFeePerGas: input.gasParams.maxPriorityFeePerGas,
+            gasPrice: input.gasParams.gasPrice,
+            tokenPriceInEth: input.tokenPriceInEth,
+            priceSource: input.priceSource,
+            priceObservedAtMs: input.priceObservedAtMs,
+            bumpPercent: input.gasParams.bumpPercent,
+            txType: input.txType,
+            gasPurpose: 'fee',
+        };
+    }
+}
+exports.MixerXFeeOracle = MixerXFeeOracle;
+//# sourceMappingURL=MixerXFeeOracle.js.map

package/dist/infrastructure/mixerx/MixerXFeeOracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MixerXFeeOracle.js","sourceRoot":"","sources":["../../../src/infrastructure/mixerx/MixerXFeeOracle.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ILogger } from '../../application/ports/ILogger';\r\nimport { NullLogger } from '../../application/ports/ILogger';\r\nimport { getBumpPercent } from '../../domain/config/TokenDefaults';\r\nimport { OracleError } from '../../domain/exceptions';\r\nimport { toPriceQuote, type ITokenPriceRepository } from '../../domain/repositories';\r\nimport type { TokenPriceQuote } from '../../types';\r\nimport { GasPriceOracle, type GasPriceParams } from '../gas/GasPriceOracle';\r\nimport type { ChainId } from '../config/gasOracleConfigs';\r\nimport { TokenPriceOracle } from '../token-price/TokenPriceOracle';\r\n\r\nconst DEFAULT_MAX_PRICE_AGE_MS = 120_000;\r\nconst DEFAULT_MAX_REFUND_WEI = 1_000_000_000_000_000_000n;\r\nconst FEE_SCALE = 1_000_000n;\r\n\r\nexport type MixerXTxType = 'relayer_withdrawal' | 'user_withdrawal' | 'relayer_withdrawal_check_v4';\r\nexport type MixerXGasPurpose = 'fee' | 'send' | 'replacement';\r\nexport type LegacyFeePurpose = 'fee_quote' | 'fee_validation';\r\n\r\nexport interface MixerXFeeOracleOptions {\r\n  chainId: ChainId;\r\n  rpcUrl: string;\r\n  relayerFeePercent: number;\r\n  gasPriceOracle?: GasPriceOracle;\r\n  tokenPriceOracle?: TokenPriceOracle;\r\n  priceRepository?: ITokenPriceRepository;\r\n  logger?: ILogger;\r\n  multicallAddress?: string;\r\n  offchainOracleAddress?: string;\r\n  rpcTimeoutMs?: number;\r\n  maxGasPriceGwei?: number;\r\n  maxPriceAgeMs?: number;\r\n  maxRefundWei?: bigint;\r\n}\r\n\r\nexport interface MixerXWithdrawalFeeInput {\r\n  currency: string;\r\n  amount: bigint;\r\n  decimals: number;\r\n  /** Gas limit obtained from a simulation or eth_estimateGas for this exact transaction. */\r\n  gasLimit: number;\r\n  refund?: string;\r\n  txType?: MixerXTxType;\r\n  purpose?: 'fee' | LegacyFeePurpose;\r\n}\r\n\r\nexport interface MixerXGasParametersForTxInput {\r\n  txType?: MixerXTxType;\r\n  purpose?: MixerXGasPurpose | LegacyFeePurpose;\r\n  isLegacy?: boolean;\r\n}\r\n\r\nexport interface MixerXGasParametersForTxResult extends GasPriceParams {\r\n  txType: MixerXTxType;\r\n  purpose: MixerXGasPurpose;\r\n  bumpPercent: number;\r\n}\r\n\r\nexport interface MixerXFeeCalculationResult {\r\n  gasCost: bigint;\r\n  relayerFee: bigint;\r\n  refundAmount: bigint;\r\n  totalFee: bigint;\r\n  currency: string;\r\n  gasLimit: number;\r\n  gasPriceWei: bigint;\r\n  baseFeePerGas?: string;\r\n  maxFeePerGas?: string;\r\n  maxPriorityFeePerGas?: string;\r\n  gasPrice?: string;\r\n  tokenPriceInEth?: bigint;\r\n  priceSource: 'native' | 'repository';\r\n  priceObservedAtMs?: number;\r\n  bumpPercent: number;\r\n  txType: MixerXTxType;\r\n  gasPurpose: 'fee';\r\n}\r\n\r\nexport type WithdrawalFeeInput = MixerXWithdrawalFeeInput;\r\nexport type FeeCalculationResult = MixerXFeeCalculationResult;\r\n\r\nexport class MixerXFeeOracle {\r\n  private readonly chainId: ChainId;\r\n  private readonly relayerFeePartsPerMillion: bigint;\r\n  private readonly gasPriceOracle: GasPriceOracle;\r\n  private readonly tokenPriceOracle: TokenPriceOracle;\r\n  private readonly priceRepository?: ITokenPriceRepository;\r\n  private readonly logger: ILogger;\r\n  private readonly maxPriceAgeMs: number;\r\n  private readonly maxRefundWei: bigint;\r\n  private readonly supportedCurrencies: ReadonlySet<string>;\r\n\r\n  constructor(options: MixerXFeeOracleOptions) {\r\n    if (!Number.isFinite(options.relayerFeePercent) || options.relayerFeePercent < 0 || options.relayerFeePercent > 0.1) {\r\n      throw new OracleError('INVALID_CONFIG', 'relayerFeePercent must be between 0 and 0.1');\r\n    }\r\n    this.maxPriceAgeMs = options.maxPriceAgeMs ?? DEFAULT_MAX_PRICE_AGE_MS;\r\n    if (!Number.isInteger(this.maxPriceAgeMs) || this.maxPriceAgeMs < 1_000 || this.maxPriceAgeMs > 3_600_000) {\r\n      throw new OracleError('INVALID_CONFIG', 'maxPriceAgeMs must be between 1000 and 3600000');\r\n    }\r\n    this.maxRefundWei = options.maxRefundWei ?? DEFAULT_MAX_REFUND_WEI;\r\n    if (this.maxRefundWei < 0n) {\r\n      throw new OracleError('INVALID_CONFIG', 'maxRefundWei cannot be negative');\r\n    }\r\n\r\n    this.chainId = options.chainId;\r\n    this.relayerFeePartsPerMillion = BigInt(Math.round(options.relayerFeePercent * Number(FEE_SCALE)));\r\n    this.logger = options.logger ?? new NullLogger();\r\n    this.gasPriceOracle = options.gasPriceOracle ?? new GasPriceOracle({\r\n      chainId: options.chainId,\r\n      rpcUrl: options.rpcUrl,\r\n      logger: this.logger,\r\n      rpcTimeoutMs: options.rpcTimeoutMs,\r\n      maxGasPriceGwei: options.maxGasPriceGwei,\r\n    });\r\n    this.tokenPriceOracle = options.tokenPriceOracle ?? new TokenPriceOracle(\r\n      options.rpcUrl,\r\n      options.chainId,\r\n      options.offchainOracleAddress,\r\n      options.multicallAddress,\r\n      undefined,\r\n      this.logger,\r\n      options.rpcTimeoutMs,\r\n    );\r\n    this.supportedCurrencies = new Set([\r\n      'eth',\r\n      ...this.tokenPriceOracle.getSupportedTokens().map((token) => token.symbol),\r\n    ]);\r\n    this.priceRepository = options.priceRepository;\r\n  }\r\n\r\n  async calculateWithdrawalFee(input: MixerXWithdrawalFeeInput): Promise<MixerXFeeCalculationResult> {\r\n    const currency = this.validateFeeInput(input);\r\n    const txType = input.txType ?? 'relayer_withdrawal';\r\n    const gasParams = await this.getGasParametersForTx({\r\n      txType,\r\n      purpose: this.normalizePurpose(input.purpose ?? 'fee'),\r\n      isLegacy: false,\r\n    });\r\n    const gasLimit = input.gasLimit;\r\n    const gasPriceWei = this.effectiveGasPrice(gasParams);\r\n    const gasCostWei = gasPriceWei * BigInt(gasLimit);\r\n    const relayerFee = (input.amount * this.relayerFeePartsPerMillion) / FEE_SCALE;\r\n\r\n    if (currency === 'eth') {\r\n      if (input.refund !== undefined && this.parseRefund(input.refund) !== 0n) {\r\n        throw new OracleError('INVALID_INPUT', 'refund must be zero for native ETH withdrawals');\r\n      }\r\n      const totalFee = gasCostWei + relayerFee;\r\n      this.assertTotalFee(totalFee, input.amount);\r\n      return this.result({\r\n        gasCost: gasCostWei,\r\n        relayerFee,\r\n        refundAmount: 0n,\r\n        totalFee,\r\n        currency,\r\n        gasLimit,\r\n        gasPriceWei,\r\n        gasParams,\r\n        txType,\r\n        priceSource: 'native',\r\n      });\r\n    }\r\n\r\n    const quote = await this.getFreshPrice(currency);\r\n    const decimalsFactor = 10n ** BigInt(input.decimals);\r\n    const gasCost = (gasCostWei * decimalsFactor) / quote.priceInEthWei;\r\n    const refundWei = this.parseRefund(input.refund ?? '0');\r\n    const refundAmount = (refundWei * decimalsFactor) / quote.priceInEthWei;\r\n    const totalFee = gasCost + relayerFee + refundAmount;\r\n    this.assertTotalFee(totalFee, input.amount);\r\n\r\n    return this.result({\r\n      gasCost,\r\n      relayerFee,\r\n      refundAmount,\r\n      totalFee,\r\n      currency,\r\n      gasLimit,\r\n      gasPriceWei,\r\n      gasParams,\r\n      txType,\r\n      tokenPriceInEth: quote.priceInEthWei,\r\n      priceSource: quote.source,\r\n      priceObservedAtMs: quote.observedAtMs,\r\n    });\r\n  }\r\n\r\n  async getGasParametersForTx(\r\n    input: MixerXGasParametersForTxInput = {},\r\n  ): Promise<MixerXGasParametersForTxResult> {\r\n    const txType = input.txType ?? 'relayer_withdrawal';\r\n    const purpose = this.normalizePurpose(input.purpose ?? 'send');\r\n    const bumpPercent = purpose === 'send' ? 0 : getBumpPercent(txType);\r\n    const gasParams = await this.gasPriceOracle.getTxGasParams({\r\n      isLegacy: input.isLegacy ?? false,\r\n      bumpPercent,\r\n      legacySpeed: 'fast',\r\n    });\r\n    return { ...gasParams, txType, purpose, bumpPercent };\r\n  }\r\n\r\n  async assertReady(): Promise<void> {\r\n    await this.tokenPriceOracle.fetchPrices();\r\n  }\r\n\r\n  async getGasParameters(isLegacy: boolean = false): Promise<GasPriceParams> {\r\n    return this.gasPriceOracle.getTxGasParams({ isLegacy });\r\n  }\r\n\r\n  getChainId(): ChainId {\r\n    return this.chainId;\r\n  }\r\n\r\n  private validateFeeInput(input: MixerXWithdrawalFeeInput): string {\r\n    const currency = input.currency.trim().toLowerCase();\r\n    if (!/^[a-z0-9]{2,16}$/.test(currency)) {\r\n      throw new OracleError('INVALID_INPUT', 'currency must be a valid protocol token symbol');\r\n    }\r\n    if (!this.supportedCurrencies.has(currency)) {\r\n      throw new OracleError('INVALID_INPUT', `Unsupported MixerX currency: ${currency}`);\r\n    }\r\n    if (input.amount <= 0n) {\r\n      throw new OracleError('INVALID_INPUT', 'amount must be greater than zero');\r\n    }\r\n    if (!Number.isInteger(input.decimals) || input.decimals < 0 || input.decimals > 255) {\r\n      throw new OracleError('INVALID_INPUT', 'decimals must be an integer between 0 and 255');\r\n    }\r\n    if (!Number.isInteger(input.gasLimit) || input.gasLimit < 21_000 || input.gasLimit > 5_000_000) {\r\n      throw new OracleError('INVALID_INPUT', 'gasLimit must be an integer between 21000 and 5000000');\r\n    }\r\n    return currency;\r\n  }\r\n\r\n  private parseRefund(raw: string): bigint {\r\n    if (!/^\\d+$/.test(raw)) {\r\n      throw new OracleError('INVALID_INPUT', 'refund must be an unsigned base-10 integer string');\r\n    }\r\n    const refund = BigInt(raw);\r\n    if (refund > this.maxRefundWei) {\r\n      throw new OracleError('ECONOMIC_LIMIT_EXCEEDED', 'refund exceeds maxRefundWei');\r\n    }\r\n    return refund;\r\n  }\r\n\r\n  private async getFreshPrice(symbol: string): Promise<TokenPriceQuote> {\r\n    if (!this.priceRepository) {\r\n      throw new OracleError('TOKEN_PRICE_UNAVAILABLE', `No fresh price repository configured for ${symbol}`);\r\n    }\r\n    const [price, observedAtMs] = await Promise.all([\r\n      this.priceRepository.getPrice(symbol),\r\n      this.priceRepository.getLastUpdateTimestamp(symbol),\r\n    ]);\r\n    const quote = toPriceQuote(price, observedAtMs);\r\n    if (!quote) {\r\n      throw new OracleError('TOKEN_PRICE_UNAVAILABLE', `Price unavailable for ${symbol}`);\r\n    }\r\n    if (Date.now() - quote.observedAtMs > this.maxPriceAgeMs || quote.observedAtMs > Date.now() + 5_000) {\r\n      throw new OracleError('TOKEN_PRICE_STALE', `Price is stale for ${symbol}`);\r\n    }\r\n    return quote;\r\n  }\r\n\r\n  private effectiveGasPrice(params: GasPriceParams): bigint {\r\n    if (params.gasPrice) {\r\n      return BigInt(params.gasPrice);\r\n    }\r\n    if (params.baseFeePerGas && params.maxFeePerGas && params.maxPriorityFeePerGas) {\r\n      const maxFee = BigInt(params.maxFeePerGas);\r\n      const likelyEffective = BigInt(params.baseFeePerGas) + BigInt(params.maxPriorityFeePerGas);\r\n      return likelyEffective < maxFee ? likelyEffective : maxFee;\r\n    }\r\n    throw new OracleError('RPC_REQUEST_FAILED', 'Gas price response is incomplete');\r\n  }\r\n\r\n  private assertTotalFee(totalFee: bigint, amount: bigint): void {\r\n    if (totalFee < 0n || totalFee > amount) {\r\n      throw new OracleError('ECONOMIC_LIMIT_EXCEEDED', 'Total fee must be between zero and withdrawal amount');\r\n    }\r\n  }\r\n\r\n  private normalizePurpose(purpose: MixerXGasPurpose | LegacyFeePurpose): MixerXGasPurpose {\r\n    if (purpose === 'fee_quote' || purpose === 'fee_validation') {\r\n      return 'fee';\r\n    }\r\n    return purpose;\r\n  }\r\n\r\n  private result(input: {\r\n    gasCost: bigint;\r\n    relayerFee: bigint;\r\n    refundAmount: bigint;\r\n    totalFee: bigint;\r\n    currency: string;\r\n    gasLimit: number;\r\n    gasPriceWei: bigint;\r\n    gasParams: MixerXGasParametersForTxResult;\r\n    txType: MixerXTxType;\r\n    tokenPriceInEth?: bigint;\r\n    priceSource: 'native' | 'repository';\r\n    priceObservedAtMs?: number;\r\n  }): MixerXFeeCalculationResult {\r\n    this.logger.debug('Withdrawal fee calculated', {\r\n      priceSource: input.priceSource,\r\n      gasPurpose: 'fee',\r\n    });\r\n    return {\r\n      gasCost: input.gasCost,\r\n      relayerFee: input.relayerFee,\r\n      refundAmount: input.refundAmount,\r\n      totalFee: input.totalFee,\r\n      currency: input.currency,\r\n      gasLimit: input.gasLimit,\r\n      gasPriceWei: input.gasPriceWei,\r\n      baseFeePerGas: input.gasParams.baseFeePerGas,\r\n      maxFeePerGas: input.gasParams.maxFeePerGas,\r\n      maxPriorityFeePerGas: input.gasParams.maxPriorityFeePerGas,\r\n      gasPrice: input.gasParams.gasPrice,\r\n      tokenPriceInEth: input.tokenPriceInEth,\r\n      priceSource: input.priceSource,\r\n      priceObservedAtMs: input.priceObservedAtMs,\r\n      bumpPercent: input.gasParams.bumpPercent,\r\n      txType: input.txType,\r\n      gasPurpose: 'fee',\r\n    };\r\n  }\r\n}\r\n"]}

package/dist/infrastructure/multicall/MulticallProvider.d.ts

@@ -1,3 +1,4 @@
+import type { ChainId } from '../../types';
 export interface Call {
     target: string;
     callData: string;
@@ -8,7 +9,8 @@ export interface CallResult {
 }
 export declare class MulticallProvider {
     private readonly provider;
-    constructor(rpcUrl: string, _multicallAddress?: string);
-    aggregate(calls: Call[]): Promise<CallResult[]>;
+    private readonly multicall;
+    private readonly chainId;
+    constructor(rpcUrl: string, multicallAddress: string | undefined, chainId: ChainId | number, rpcTimeoutMs?: number);
+    aggregate(calls: readonly Call[]): Promise<CallResult[]>;
 }
-//# sourceMappingURL=MulticallProvider.d.ts.map

package/dist/infrastructure/multicall/MulticallProvider.js

@@ -2,21 +2,56 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MulticallProvider = void 0;
 const ethers_1 = require("ethers");
+const exceptions_1 = require("../../domain/exceptions");
+const staticProvider_1 = require("../blockchain/staticProvider");
+const gasOracleConfigs_1 = require("../config/gasOracleConfigs");
+const MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
+const MAX_CALLS = 64;
+const MULTICALL3_ABI = [
+    'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable returns (tuple(bool success, bytes returnData)[] returnData)',
+];
 class MulticallProvider {
     provider;
-    constructor(rpcUrl, _multicallAddress) {
-        this.provider = new ethers_1.ethers.JsonRpcProvider(rpcUrl);
+    multicall;
+    chainId;
+    constructor(rpcUrl, multicallAddress = MULTICALL3_ADDRESS, chainId, rpcTimeoutMs) {
+        (0, gasOracleConfigs_1.assertSepoliaChainId)(chainId);
+        if (!ethers_1.ethers.isAddress(multicallAddress)) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', 'multicallAddress must be a valid EVM address');
+        }
+        this.chainId = chainId;
+        this.provider = (0, staticProvider_1.createVerifiedJsonRpcProvider)(rpcUrl, chainId, { batchMaxCount: 1 }, rpcTimeoutMs);
+        this.multicall = new ethers_1.ethers.Contract(multicallAddress, MULTICALL3_ABI, this.provider);
     }
     async aggregate(calls) {
-        return Promise.all(calls.map(async ({ target, callData }) => {
-            try {
-                const returnData = await this.provider.call({ to: target, data: callData });
-                return { success: true, returnData };
+        if (calls.length > MAX_CALLS) {
+            throw new exceptions_1.OracleError('INVALID_INPUT', `Multicall supports at most ${String(MAX_CALLS)} calls`);
+        }
+        if (calls.length === 0) {
+            return [];
+        }
+        for (const call of calls) {
+            if (!ethers_1.ethers.isAddress(call.target) || !ethers_1.ethers.isHexString(call.callData)) {
+                throw new exceptions_1.OracleError('INVALID_INPUT', 'Every multicall target and calldata value must be valid');
             }
-            catch {
-                return { success: false, returnData: '0x' };
+        }
+        try {
+            await (0, staticProvider_1.assertProviderNetwork)(this.provider, this.chainId);
+            const rawResults = (await this.multicall.aggregate3.staticCall(calls.map((call) => ({ ...call, allowFailure: true }))));
+            if (rawResults.length !== calls.length) {
+                throw new exceptions_1.OracleError('RPC_REQUEST_FAILED', 'Multicall returned an unexpected number of results');
             }
-        }));
+            return rawResults.map((result) => ({
+                success: result.success,
+                returnData: result.returnData,
+            }));
+        }
+        catch (error) {
+            if (error instanceof exceptions_1.OracleError) {
+                throw error;
+            }
+            throw new exceptions_1.OracleError('RPC_REQUEST_FAILED', 'Multicall RPC request failed');
+        }
     }
 }
 exports.MulticallProvider = MulticallProvider;

package/dist/infrastructure/multicall/MulticallProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"MulticallProvider.js","sourceRoot":"","sources":["../../../src/infrastructure/multicall/MulticallProvider.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAYhC,MAAa,iBAAiB;IACX,QAAQ,CAAyB;IAElD,YAAY,MAAc,EAAE,iBAA0B;QACpD,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;YACvC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC5E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AAnBD,8CAmBC"}
+{"version":3,"file":"MulticallProvider.js","sourceRoot":"","sources":["../../../src/infrastructure/multicall/MulticallProvider.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAChC,wDAAsD;AAEtD,iEAGsC;AACtC,iEAAkE;AAElE,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AACxE,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,cAAc,GAAG;IACrB,4JAA4J;CACpJ,CAAC;AAYX,MAAa,iBAAiB;IACX,QAAQ,CAAyB;IACjC,SAAS,CAAkB;IAC3B,OAAO,CAAS;IAEjC,YACE,MAAc,EACd,mBAA2B,kBAAkB,EAC7C,OAAyB,EACzB,YAAqB;QAErB,IAAA,uCAAoB,EAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,eAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,wBAAW,CAAC,gBAAgB,EAAE,8CAA8C,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAA,8CAA6B,EAAC,MAAM,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACnG,IAAI,CAAC,SAAS,GAAG,IAAI,eAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAsB;QACpC,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,wBAAW,CAAC,eAAe,EAAE,8BAA8B,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,eAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzE,MAAM,IAAI,wBAAW,CAAC,eAAe,EAAE,yDAAyD,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAA,sCAAqB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACzD,MAAM,UAAU,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAC5D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CACvD,CAAwD,CAAC;YAE1D,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBACvC,MAAM,IAAI,wBAAW,CAAC,oBAAoB,EAAE,oDAAoD,CAAC,CAAC;YACpG,CAAC;YAED,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACjC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,wBAAW,EAAE,CAAC;gBACjC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,wBAAW,CAAC,oBAAoB,EAAE,8BAA8B,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;CACF;AAxDD,8CAwDC","sourcesContent":["import { ethers } from 'ethers';\r\nimport { OracleError } from '../../domain/exceptions';\r\nimport type { ChainId } from '../../types';\r\nimport {\r\n  assertProviderNetwork,\r\n  createVerifiedJsonRpcProvider,\r\n} from '../blockchain/staticProvider';\r\nimport { assertSepoliaChainId } from '../config/gasOracleConfigs';\r\n\r\nconst MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';\r\nconst MAX_CALLS = 64;\r\nconst MULTICALL3_ABI = [\r\n  'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable returns (tuple(bool success, bytes returnData)[] returnData)',\r\n] as const;\r\n\r\nexport interface Call {\r\n  target: string;\r\n  callData: string;\r\n}\r\n\r\nexport interface CallResult {\r\n  success: boolean;\r\n  returnData: string;\r\n}\r\n\r\nexport class MulticallProvider {\r\n  private readonly provider: ethers.JsonRpcProvider;\r\n  private readonly multicall: ethers.Contract;\r\n  private readonly chainId: number;\r\n\r\n  constructor(\r\n    rpcUrl: string,\r\n    multicallAddress: string = MULTICALL3_ADDRESS,\r\n    chainId: ChainId | number,\r\n    rpcTimeoutMs?: number,\r\n  ) {\r\n    assertSepoliaChainId(chainId);\r\n    if (!ethers.isAddress(multicallAddress)) {\r\n      throw new OracleError('INVALID_CONFIG', 'multicallAddress must be a valid EVM address');\r\n    }\r\n\r\n    this.chainId = chainId;\r\n    this.provider = createVerifiedJsonRpcProvider(rpcUrl, chainId, { batchMaxCount: 1 }, rpcTimeoutMs);\r\n    this.multicall = new ethers.Contract(multicallAddress, MULTICALL3_ABI, this.provider);\r\n  }\r\n\r\n  async aggregate(calls: readonly Call[]): Promise<CallResult[]> {\r\n    if (calls.length > MAX_CALLS) {\r\n      throw new OracleError('INVALID_INPUT', `Multicall supports at most ${String(MAX_CALLS)} calls`);\r\n    }\r\n    if (calls.length === 0) {\r\n      return [];\r\n    }\r\n\r\n    for (const call of calls) {\r\n      if (!ethers.isAddress(call.target) || !ethers.isHexString(call.callData)) {\r\n        throw new OracleError('INVALID_INPUT', 'Every multicall target and calldata value must be valid');\r\n      }\r\n    }\r\n\r\n    try {\r\n      await assertProviderNetwork(this.provider, this.chainId);\r\n      const rawResults = (await this.multicall.aggregate3.staticCall(\r\n        calls.map((call) => ({ ...call, allowFailure: true })),\r\n      )) as readonly { success: boolean; returnData: string }[];\r\n\r\n      if (rawResults.length !== calls.length) {\r\n        throw new OracleError('RPC_REQUEST_FAILED', 'Multicall returned an unexpected number of results');\r\n      }\r\n\r\n      return rawResults.map((result) => ({\r\n        success: result.success,\r\n        returnData: result.returnData,\r\n      }));\r\n    } catch (error) {\r\n      if (error instanceof OracleError) {\r\n        throw error;\r\n      }\r\n      throw new OracleError('RPC_REQUEST_FAILED', 'Multicall RPC request failed');\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/infrastructure/token-price/TokenPriceOracle.d.ts

@@ -1,50 +1,15 @@
-import { ILogger } from '../../application/ports/ILogger';
-import { ChainId, Token } from '../../types';
-export interface TokenPrices {
-    [symbol: string]: string;
-}
-/**
- * TokenPriceOracle
- * Fetches token prices from OffchainOracle using Multicall
- * Based on @tornado/tornado-oracles TokenPriceOracle
- *
- * Uses protocol-configured OffchainOracle from @mixerx/config
- * Returns price rate to ETH in wei (how much ETH 1 token = X wei)
- *
- * NOTE: Uses centralized TokenDefaults to avoid duplication
- */
+import type { ILogger } from '../../application/ports/ILogger';
+import type { ChainId, Token, TokenPrices } from '../../types';
 export declare class TokenPriceOracle {
-    private multicall;
-    private offchainOracleAddress;
-    private offchainOracleAbi;
+    private readonly multicall;
+    private readonly offchainOracleAddress;
+    private readonly interface;
+    private readonly logger;
     private defaultTokens;
-    private defaultPrices;
-    private logger;
-    constructor(rpcUrl: string, chainId: ChainId | number, offchainOracleAddress?: string, multicallAddress?: string, tokens?: Token[], logger?: ILogger);
-    /**
-     * Fetch prices for tokens
-     * Uses multicall to batch requests
-     */
-    fetchPrices(tokens?: Token[]): Promise<TokenPrices>;
-    /**
-     * Fetch price for single token
-     */
-    fetchPrice(token: Token): Promise<string | null>;
-    /**
-     * Get default prices
-     */
-    getDefaultPrices(): TokenPrices;
-    /**
-     * Get supported tokens
-     */
+    constructor(rpcUrl: string, chainId: ChainId | number, offchainOracleAddress?: string, multicallAddress?: string, tokens?: Token[], logger?: ILogger, rpcTimeoutMs?: number);
+    fetchPrices(tokens?: readonly Token[]): Promise<TokenPrices>;
+    fetchPrice(token: Token): Promise<string>;
     getSupportedTokens(): Token[];
-    /**
-     * Add custom tokens
-     */
-    addTokens(tokens: Token[]): void;
-    /**
-     * Encode getRateToEth call
-     */
-    private encodeGetRateToEth;
+    addTokens(tokens: readonly Token[]): void;
+    private normalizeTokens;
 }
-//# sourceMappingURL=TokenPriceOracle.d.ts.map

package/dist/infrastructure/token-price/TokenPriceOracle.js

@@ -2,131 +2,98 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenPriceOracle = void 0;
 const ethers_1 = require("ethers");
-const MulticallProvider_1 = require("../multicall/MulticallProvider");
-const TokenDefaults_1 = require("../../domain/config/TokenDefaults");
 const ILogger_1 = require("../../application/ports/ILogger");
+const exceptions_1 = require("../../domain/exceptions");
 const ProtocolTokenConfig_1 = require("../config/ProtocolTokenConfig");
-/**
- * TokenPriceOracle
- * Fetches token prices from OffchainOracle using Multicall
- * Based on @tornado/tornado-oracles TokenPriceOracle
- *
- * Uses protocol-configured OffchainOracle from @mixerx/config
- * Returns price rate to ETH in wei (how much ETH 1 token = X wei)
- *
- * NOTE: Uses centralized TokenDefaults to avoid duplication
- */
+const MulticallProvider_1 = require("../multicall/MulticallProvider");
+const MAX_TOKENS = 32;
+const OFFCHAIN_ORACLE_ABI = [
+    'function getRateToEth(address srcToken, bool useSrcWrappers) external view returns (uint256 weightedRate)',
+];
 class TokenPriceOracle {
     multicall;
     offchainOracleAddress;
-    offchainOracleAbi = [
-        'function getRateToEth(address srcToken, bool useSrcWrappers) external view returns (uint256 weightedRate)',
-    ];
-    // Default tokens from @mixerx/config by chain
-    defaultTokens;
-    // Default prices as fallback (in wei) - from TokenDefaults
-    defaultPrices = TokenDefaults_1.DEFAULT_TOKEN_PRICES;
+    interface = new ethers_1.ethers.Interface(OFFCHAIN_ORACLE_ABI);
     logger;
-    constructor(rpcUrl, chainId, offchainOracleAddress, multicallAddress, tokens, logger) {
-        this.multicall = new MulticallProvider_1.MulticallProvider(rpcUrl, multicallAddress);
+    defaultTokens;
+    constructor(rpcUrl, chainId, offchainOracleAddress, multicallAddress, tokens, logger, rpcTimeoutMs) {
         this.offchainOracleAddress = offchainOracleAddress ?? (0, ProtocolTokenConfig_1.resolveOffchainOracleAddress)(chainId);
-        this.defaultTokens = tokens ?? (0, ProtocolTokenConfig_1.resolveDefaultTokens)(chainId);
+        if (!ethers_1.ethers.isAddress(this.offchainOracleAddress)) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', 'offchainOracleAddress must be a valid EVM address');
+        }
+        this.defaultTokens = this.normalizeTokens(tokens ?? (0, ProtocolTokenConfig_1.resolveDefaultTokens)(chainId));
+        this.multicall = new MulticallProvider_1.MulticallProvider(rpcUrl, multicallAddress, chainId, rpcTimeoutMs);
         this.logger = logger ?? new ILogger_1.NullLogger();
     }
-    /**
-     * Fetch prices for tokens
-     * Uses multicall to batch requests
-     */
     async fetchPrices(tokens = this.defaultTokens) {
-        try {
-            if (tokens.length === 0) {
-                return {};
+        const normalizedTokens = this.normalizeTokens(tokens);
+        const calls = normalizedTokens.map((token) => ({
+            target: this.offchainOracleAddress,
+            callData: this.interface.encodeFunctionData('getRateToEth', [token.address, true]),
+        }));
+        const results = await this.multicall.aggregate(calls);
+        const prices = Object.create(null);
+        const failedSymbols = [];
+        for (const [index, result] of results.entries()) {
+            const token = normalizedTokens[index];
+            if (!result.success) {
+                failedSymbols.push(token.symbol);
+                continue;
             }
-            // Prepare multicall data
-            const calls = tokens.map(token => ({
-                target: this.offchainOracleAddress,
-                callData: this.encodeGetRateToEth(token.address),
-            }));
-            // Execute multicall
-            const results = await this.multicall.aggregate(calls);
-            const prices = {};
-            for (let i = 0; i < results.length; i++) {
-                const token = tokens[i];
-                const result = results[i];
-                if (!result.success) {
-                    // Use default price if available
-                    const defaultPrice = this.defaultPrices[token.symbol.toLowerCase()];
-                    if (defaultPrice) {
-                        prices[token.symbol.toLowerCase()] = defaultPrice;
-                        this.logger.warn('TokenPriceOracle default price used (call failed)', {
-                            symbol: token.symbol,
-                            address: token.address,
-                        });
-                    }
+            try {
+                const rateWei = this.interface.decodeFunctionResult('getRateToEth', result.returnData)[0];
+                const price = (rateWei * 10n ** BigInt(token.decimals)) / 10n ** 18n;
+                if (price <= 0n) {
+                    failedSymbols.push(token.symbol);
                     continue;
                 }
-                try {
-                    // Decode result
-                    const rateWei = ethers_1.ethers.AbiCoder.defaultAbiCoder().decode(['uint256'], result.returnData)[0];
-                    // Convert rate to proper decimals
-                    // Formula: (rate * 10^tokenDecimals) / 10^18
-                    const tokenDecimals = 10n ** BigInt(token.decimals);
-                    const ethDecimals = 10n ** 18n;
-                    const price = (rateWei * tokenDecimals) / ethDecimals;
-                    prices[token.symbol.toLowerCase()] = price.toString();
-                }
-                catch (decodeError) {
-                    // Use default if decoding fails
-                    const defaultPrice = this.defaultPrices[token.symbol.toLowerCase()];
-                    if (defaultPrice) {
-                        prices[token.symbol.toLowerCase()] = defaultPrice;
-                        this.logger.warn('TokenPriceOracle default price used (decode failed)', {
-                            symbol: token.symbol,
-                            address: token.address,
-                        });
-                    }
-                }
+                prices[token.symbol] = price.toString();
+            }
+            catch {
+                failedSymbols.push(token.symbol);
             }
-            return prices;
         }
-        catch (error) {
-            this.logger.error('Failed to fetch token prices:', error);
-            // Return defaults on complete failure
-            this.logger.warn('TokenPriceOracle using default prices (fetch failed)');
-            return this.defaultPrices;
+        if (failedSymbols.length > 0) {
+            this.logger.warn('Token price batch rejected', { failedSymbols: [...failedSymbols] });
+            throw new exceptions_1.TokenPriceError('One or more on-chain token prices are unavailable', failedSymbols);
         }
+        return { ...prices };
     }
-    /**
-     * Fetch price for single token
-     */
     async fetchPrice(token) {
         const prices = await this.fetchPrices([token]);
-        return prices[token.symbol.toLowerCase()] || null;
+        return prices[token.symbol.trim().toLowerCase()];
     }
-    /**
-     * Get default prices
-     */
-    getDefaultPrices() {
-        return { ...this.defaultPrices };
-    }
-    /**
-     * Get supported tokens
-     */
     getSupportedTokens() {
-        return [...this.defaultTokens];
+        return this.defaultTokens.map((token) => ({ ...token }));
     }
-    /**
-     * Add custom tokens
-     */
     addTokens(tokens) {
-        this.defaultTokens = [...this.defaultTokens, ...tokens];
+        this.defaultTokens = this.normalizeTokens([...this.defaultTokens, ...tokens]);
     }
-    /**
-     * Encode getRateToEth call
-     */
-    encodeGetRateToEth(tokenAddress) {
-        const iface = new ethers_1.ethers.Interface(this.offchainOracleAbi);
-        return iface.encodeFunctionData('getRateToEth', [tokenAddress, true]);
+    normalizeTokens(tokens) {
+        if (tokens.length === 0) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', `Token list must contain between 1 and ${String(MAX_TOKENS)} items`);
+        }
+        const byAddress = new Map();
+        const symbols = new Set();
+        for (const token of tokens) {
+            const address = token.address.trim().toLowerCase();
+            const symbol = token.symbol.trim().toLowerCase();
+            if (!ethers_1.ethers.isAddress(address) || !/^[a-z0-9]{2,16}$/.test(symbol)) {
+                throw new exceptions_1.OracleError('INVALID_CONFIG', 'Token address or symbol is invalid');
+            }
+            if (!Number.isInteger(token.decimals) || token.decimals < 0 || token.decimals > 255) {
+                throw new exceptions_1.OracleError('INVALID_CONFIG', `Invalid decimals for token ${symbol}`);
+            }
+            if (symbols.has(symbol) && byAddress.get(address)?.symbol !== symbol) {
+                throw new exceptions_1.OracleError('INVALID_CONFIG', `Duplicate token symbol: ${symbol}`);
+            }
+            symbols.add(symbol);
+            byAddress.set(address, { address, symbol, decimals: token.decimals });
+        }
+        if (byAddress.size > MAX_TOKENS) {
+            throw new exceptions_1.OracleError('INVALID_CONFIG', `Token list exceeds ${String(MAX_TOKENS)} unique addresses`);
+        }
+        return [...byAddress.values()];
     }
 }
 exports.TokenPriceOracle = TokenPriceOracle;