@avalabs/fusion-sdk 0.23.1 → 0.24.0

package/dist/quoter/quoter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"quoter.cjs","names":["sortQuotes","pruneExpiredQuotes","isQuoteExpired","upsertQuote","QUOTER_EMPTY_RETRY_MAX_DELAY_MS","QUOTER_EMPTY_RETRY_BASE_DELAY_MS","earliestExpirationForService","z","isNativeAsset","TokenType"],"sources":["../../src/quoter/quoter.ts"],"sourcesContent":["import { z } from 'zod';\nimport type {\n  Quote,\n  QuoterDonePayload,\n  QuoterDoneReason,\n  QuoterEventHandler,\n  QuoterInterface,\n  QuoterProps,\n  ServiceQuoteEventArgs,\n  QuotesTuple,\n  ServiceQuoteEventHandler,\n} from '../types/quote';\nimport type { ServiceQuoteOptions, TransferService } from '../types/service';\nimport { earliestExpirationForService, isQuoteExpired, pruneExpiredQuotes, sortQuotes, upsertQuote } from './_utils';\nimport {\n  QUOTER_DEFAULT_PRUNE_INTERVAL_MS,\n  QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS,\n  QUOTER_EMPTY_RETRY_BASE_DELAY_MS,\n  QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n} from './constants';\nimport { ServiceType, TokenType } from '../constants';\nimport { isNativeAsset } from '../type-guards';\nimport { isAddressEqual } from 'viem';\n\n/**\n * Function that returns the current UNIX time in seconds.\n * Injected for deterministic testing.\n */\nexport type Clock = () => number;\n\n/**\n * Options for constructing a Quoter instance.\n *\n * These options tune how often quote state is maintained and when services are\n * proactively restarted before quote expiry.\n */\nexport interface QuoterOptions {\n  /**\n   * Dangerously allows cross-chain quotes where fromAddress and toAddress differ\n   * even when a service would otherwise require them to match.\n   *\n   * This is intended for explicit proxy-recipient funding flows. By default,\n   * services preserve their existing address safety checks.\n   */\n  readonly dangerouslyAllowAddressMismatch?: boolean;\n  /** Clock function returning current time in seconds (defaults to Date.now()/1000). */\n  readonly clock?: Clock;\n  /** Interval for pruning expired quotes (milliseconds).\n   *\n   * @default 1_000\n   */\n  readonly pruneIntervalMs?: number;\n  /**\n   * Amount of seconds to pre-buffer a stream restart before the earliest service quote\n   * expiration. Helps ensure continuity before actual expiry is reached.\n   *\n   * @default 5\n   */\n  readonly refreshBufferSeconds?: number;\n}\n\n/**\n * Quoter orchestrates quote streaming across multiple transfer services and emits a unified event stream.\n *\n * High-level lifecycle:\n * - Idle until first subscriber.\n * - On first subscribe, starts all eligible services.\n * - Collects and ranks active quotes, pruning expired ones over time.\n * - Completes when explicitly unsubscribed (last subscriber), when no service is eligible,\n *   or when all eligible services finish without producing any quote (`no-quotes`).\n *\n * Event model:\n * - Service `quote` -> Quoter upserts quote, recomputes best quote, emits `quote`.\n * - Service `error` -> Quoter emits `error` (non-terminal by itself).\n * - Service `done` -> Quoter marks that service attempt as completed and evaluates retry/complete rules.\n *\n * Retry/refresh behavior:\n * - Refresh: services that have active quotes are restarted shortly before the earliest quote expires.\n * - Retry: services that complete with no quote and no error are only retried after the quoter has\n *   already observed at least one quote from any service in this session.\n *\n * This design keeps first-pass \"no quotes anywhere\" terminal and fast, while still allowing services\n * like Markr to be retried in sessions where other providers are returning quotes.\n */\nexport class Quoter implements QuoterInterface {\n  private readonly clock: Clock;\n  private readonly props: QuoterProps;\n  private readonly pruneIntervalMs: number;\n  private readonly serviceQuoteOptions: ServiceQuoteOptions;\n  private readonly transferServices: readonly TransferService[];\n  private readonly refreshBufferSeconds: number;\n\n  private quotes: Quote[] = [];\n  private subscribers: Set<QuoterEventHandler> = new Set();\n  private started = false;\n  private done = false;\n  private isStartingFromSubscribe = false;\n  private pruneTimerId: ReturnType<typeof setInterval> | null = null;\n  private lastBestId: string | null = null;\n  private hasReceivedAnyQuote = false;\n\n  public readonly id: string = crypto.randomUUID();\n\n  /**\n   * Per-service runtime state for the active quote session.\n   *\n   * This tracks whether a service has completed, errored, produced quotes,\n   * and any pending timers used for retry/refresh orchestration.\n   */\n  private serviceState: Map<\n    TransferService['type'],\n    {\n      cancel: () => void;\n      done: boolean;\n      hasErrored: boolean;\n      hasReturnedQuote: boolean;\n      retryAttempt: number;\n      retryTimer: ReturnType<typeof setTimeout> | null;\n      refreshTimer: ReturnType<typeof setTimeout> | null;\n      refreshAtSeconds: number | null;\n    }\n  > = new Map();\n\n  /**\n   * Create a new Quoter instance.\n   *\n   * @param props Quoting request parameters shared across all services.\n   * @param transferServices Candidate services; eligibility is resolved at `start()` time.\n   * @param options Optional runtime tuning for pruning and refresh behavior.\n   */\n  constructor(props: QuoterProps, transferServices: readonly TransferService[], options: QuoterOptions = {}) {\n    this.clock = options.clock ?? (() => Math.floor(Date.now() / 1_000));\n    this.props = props;\n    this.pruneIntervalMs = options.pruneIntervalMs ?? QUOTER_DEFAULT_PRUNE_INTERVAL_MS;\n    this.serviceQuoteOptions = {\n      dangerouslyAllowAddressMismatch: options.dangerouslyAllowAddressMismatch,\n    };\n    this.transferServices = transferServices;\n    this.refreshBufferSeconds = options.refreshBufferSeconds ?? QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS;\n  }\n\n  /**\n   * Get the current best quote and all active quotes (sorted by desirability).\n   */\n  public getQuotes(): QuotesTuple {\n    const now = this.clock();\n    const active = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n    const sorted = sortQuotes(active);\n    const best = sorted[0] ?? null;\n\n    return [best, sorted];\n  }\n\n  /**\n   * Subscribe for quoter events.\n   *\n   * First subscriber lazily starts orchestration.\n   * Last subscriber triggers terminal completion with reason `unsubscribed`.\n   *\n   * @returns Unsubscribe function (idempotent).\n   */\n  public subscribe(handler: QuoterEventHandler): () => void {\n    this.subscribers.add(handler);\n    let unsubscribed = false;\n\n    if (!this.started) {\n      this.isStartingFromSubscribe = true;\n      try {\n        this.start();\n      } finally {\n        this.isStartingFromSubscribe = false;\n      }\n    }\n\n    return () => {\n      if (unsubscribed) {\n        return;\n      }\n      unsubscribed = true;\n\n      if (this.done) {\n        this.subscribers.delete(handler);\n        return;\n      }\n\n      const wasLastSubscriber = this.subscribers.size === 1 && this.subscribers.has(handler);\n      if (wasLastSubscriber) {\n        this.complete('unsubscribed');\n        return;\n      }\n\n      this.subscribers.delete(handler);\n    };\n  }\n\n  // ----- Internal orchestration -----\n\n  /**\n   * Start a fresh quote session.\n   *\n   * Resets session-local state, validates basic request viability,\n   * starts streams for eligible services, and begins prune ticks.\n   */\n  private start(): void {\n    this.started = true;\n    this.done = false;\n    this.quotes = [];\n    this.lastBestId = null;\n    this.hasReceivedAnyQuote = false;\n\n    // Same-chain quotes for the *same* asset are not a valid transfer scenario.\n    if (isInvalidSameChainQuoteRequest(this.props)) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    let hasEligibleService = false;\n\n    // Start streams for eligible services\n    for (const svc of this.transferServices) {\n      const eligible = svc.analyzeSupport({\n        sourceAsset: this.props.sourceAsset,\n        sourceChainId: this.props.sourceChain.chainId,\n        targetAsset: this.props.targetAsset,\n        targetChainId: this.props.targetChain.chainId,\n      });\n\n      if (!eligible) continue;\n      hasEligibleService = true;\n\n      this.startStreamForService(svc);\n    }\n\n    if (!hasEligibleService) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    // Start periodic prune\n    this.pruneTimerId = setInterval(() => this.onPruneTick(), this.pruneIntervalMs);\n  }\n\n  /**\n   * Stop all streams and timers.\n   * Quotes are retained for snapshot access via getQuotes(), though they\n   * can still be pruned due to expiration.\n   */\n  private stop(): void {\n    this.started = false;\n\n    if (this.pruneTimerId) {\n      clearInterval(this.pruneTimerId);\n      this.pruneTimerId = null;\n    }\n\n    for (const [type, state] of this.serviceState) {\n      try {\n        state.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n      }\n\n      if (state.retryTimer) {\n        clearTimeout(state.retryTimer);\n      }\n\n      this.serviceState.set(type, {\n        cancel: () => {},\n        done: false,\n        hasErrored: false,\n        hasReturnedQuote: false,\n        retryAttempt: 0,\n        retryTimer: null,\n        refreshTimer: null,\n        refreshAtSeconds: null,\n      });\n    }\n  }\n\n  /**\n   * Begin or restart streaming for a specific service.\n   *\n   * Any previous stream/timers for that service are canceled before starting a new attempt.\n   */\n  private startStreamForService(svc: TransferService): void {\n    // Clean up any existing stream and refresh timer\n    const existing = this.serviceState.get(svc.type);\n\n    if (existing) {\n      try {\n        existing.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (existing.refreshTimer) clearTimeout(existing.refreshTimer);\n      if (existing.retryTimer) clearTimeout(existing.retryTimer);\n    }\n\n    const handler = this.makeServiceHandler(svc.type);\n    const bufferedEvents: ServiceQuoteEventArgs[] = [];\n    let isStartingStream = true;\n\n    // Some services emit quote/done synchronously inside streamQuotes().\n    // If those events run before subscribe() returns, consumers can hit TDZ\n    // when they reference the returned unsubscribe function in their callback.\n    // Buffer startup emissions and flush them after stream initialization.\n    const guardedHandler: ServiceQuoteEventHandler = (...eventArgs) => {\n      if (isStartingStream) {\n        bufferedEvents.push(eventArgs);\n        return;\n      }\n\n      handler(...eventArgs);\n    };\n\n    const { cancel } = svc.streamQuotes(this.props, guardedHandler, this.serviceQuoteOptions);\n    isStartingStream = false;\n\n    if (bufferedEvents.length > 0) {\n      // Use a microtask so subscribe() can return before the first callback fires.\n      // This preserves event order while avoiding re-entrancy during subscription.\n      queueMicrotask(() => {\n        for (const bufferedEvent of bufferedEvents) {\n          handler(...bufferedEvent);\n        }\n      });\n    }\n\n    this.serviceState.set(svc.type, {\n      cancel,\n      done: false,\n      hasErrored: false,\n      hasReturnedQuote: false,\n      retryAttempt: existing?.retryAttempt ?? 0,\n      retryTimer: null,\n      refreshTimer: null,\n      refreshAtSeconds: null,\n    });\n  }\n\n  /**\n   * Create the service-scoped event handler consumed by `TransferService.streamQuotes`.\n   *\n   * The handler enforces service/quote consistency and translates service events into\n   * quoter state transitions.\n   */\n  private makeServiceHandler(serviceType: TransferService['type']): ServiceQuoteEventHandler {\n    return (event, ...args) => {\n      // Ignore any service events once stopped to prevent post-stop mutations.\n      if (!this.started) {\n        return;\n      }\n      if (event === 'quote') {\n        const maybeQuote = args[0];\n        if (isQuoteValue(maybeQuote)) {\n          // Enforce the quote belongs to the emitting service\n          if (maybeQuote.serviceType !== serviceType) {\n            // Ignore quotes mismatched to service; defensive\n            return;\n          }\n          const state = this.serviceState.get(serviceType);\n          if (state) {\n            state.hasReturnedQuote = true;\n          }\n          this.onIncomingQuote(maybeQuote);\n          this.scheduleServiceRefresh(serviceType);\n        }\n\n        return;\n      }\n      if (event === 'done') {\n        this.onServiceDone(serviceType);\n\n        return;\n      }\n      if (event === 'error') {\n        const state = this.serviceState.get(serviceType);\n        if (state) {\n          state.hasErrored = true;\n        }\n        const maybeErr = args[0];\n        if (maybeErr instanceof Error) {\n          this.emitError(maybeErr);\n        }\n      }\n    };\n  }\n\n  /**\n   * Handle an incoming quote event.\n   *\n   * Expired quotes are ignored. Valid quotes are upserted into active state,\n   * then sorted/pruned and emitted to subscribers.\n   */\n  private onIncomingQuote(quote: Quote): void {\n    const now = this.clock();\n\n    if (isQuoteExpired({ quote, nowSeconds: now })) {\n      return;\n    }\n\n    this.hasReceivedAnyQuote = true;\n\n    this.resetRetryForService(quote.serviceType);\n\n    this.quotes = sortQuotes(pruneExpiredQuotes({ quotes: upsertQuote(this.quotes, quote), nowSeconds: now }));\n\n    // Always emit on every incoming quote\n    const best = this.quotes[0];\n    if (best) {\n      this.lastBestId = best.id;\n      this.emitQuote({ bestQuote: best, quote, quotes: this.quotes });\n    }\n  }\n\n  private resetRetryForService(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.retryAttempt = 0;\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n  }\n\n  /**\n   * Schedule a retry attempt for a service using exponential backoff.\n   *\n   * This is used only for quote-less successful completions once the overall session\n   * has already produced at least one quote from some service.\n   */\n  private scheduleServiceRetry(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n\n    const delayMs = Math.min(\n      QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n      QUOTER_EMPTY_RETRY_BASE_DELAY_MS * 2 ** state.retryAttempt,\n    );\n    state.retryAttempt += 1;\n\n    state.retryTimer = setTimeout(\n      () => {\n        const current = this.serviceState.get(serviceType);\n        if (current) {\n          current.retryTimer = null;\n        }\n\n        if (!this.started) {\n          return;\n        }\n\n        const svc = this.transferServices.find((s) => s.type === serviceType);\n        if (svc) {\n          this.startStreamForService(svc);\n        }\n      },\n      Math.max(0, delayMs),\n    );\n  }\n\n  /**\n   * Handle service completion (`done`).\n   *\n   * A completion may schedule:\n   * - refresh (if the service has active quotes), and/or\n   * - retry (quote-less/non-error completion, but only after any quote has existed in session).\n   *\n   * Then evaluates whether the full quoter can complete with `no-quotes`.\n   */\n  private onServiceDone(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.done = true;\n    this.scheduleServiceRefresh(serviceType);\n\n    if (this.hasReceivedAnyQuote && !state.hasErrored && !state.hasReturnedQuote) {\n      this.scheduleServiceRetry(serviceType);\n    }\n\n    this.maybeCompleteNoQuotes();\n  }\n\n  /**\n   * Complete with `no-quotes` when every eligible service has finished and\n   * no quote was ever observed during this session.\n   */\n  private maybeCompleteNoQuotes(): void {\n    if (!this.started || this.done || this.hasReceivedAnyQuote || this.serviceState.size === 0) {\n      return;\n    }\n\n    const allServicesDone = [...this.serviceState.values()].every((state) => state.done);\n\n    if (allServicesDone) {\n      this.complete('no-quotes');\n    }\n  }\n\n  /**\n   * Finalize the quoter session and broadcast terminal reason exactly once.\n   */\n  private complete(reason: QuoterDoneReason): void {\n    if (this.done) {\n      return;\n    }\n\n    const payload = this.makeDonePayload(reason);\n\n    this.done = true;\n    this.stop();\n\n    // When complete() happens during subscribe()->start(), emit done on a microtask\n    // so callers can safely reference the returned unsubscribe in their handler.\n    if (this.isStartingFromSubscribe) {\n      queueMicrotask(() => {\n        const handlers = [...this.subscribers];\n        this.subscribers.clear();\n\n        for (const handler of handlers) {\n          handler('done', payload);\n        }\n      });\n      return;\n    }\n\n    const handlers = [...this.subscribers];\n    this.subscribers.clear();\n\n    for (const handler of handlers) {\n      handler('done', payload);\n    }\n  }\n\n  private getInitializedServices(): ServiceType[] {\n    return [...new Set(this.transferServices.map((service) => service.type))];\n  }\n\n  private getEligibleServices(): ServiceType[] {\n    return [...this.serviceState.keys()];\n  }\n\n  private makeDonePayload(reason: QuoterDoneReason): QuoterDonePayload {\n    if (reason === 'unsubscribed') {\n      return { reason, data: undefined };\n    }\n\n    const initializedServices = this.getInitializedServices();\n\n    if (reason === 'no-eligible-services') {\n      return {\n        reason,\n        data: {\n          initializedServices,\n          quoterProps: this.props,\n        },\n      };\n    }\n\n    return {\n      reason,\n      data: {\n        eligibleServices: this.getEligibleServices(),\n        initializedServices,\n        quoterProps: this.props,\n      },\n    };\n  }\n\n  /** Periodic prune tick to evict expired quotes and emit best changes. */\n  private onPruneTick(): void {\n    const now = this.clock();\n    const pruned = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n\n    if (pruned.length !== this.quotes.length) {\n      this.quotes = sortQuotes(pruned);\n      const best = this.quotes[0] ?? null;\n      const bestId = best ? best.id : null;\n\n      if (best && bestId !== this.lastBestId) {\n        this.lastBestId = bestId;\n        this.emitQuote({ bestQuote: best, quote: best, quotes: this.quotes });\n      } else if (!best) {\n        this.lastBestId = null;\n      }\n    }\n\n    // Re-evaluate refresh scheduling for all services on prune tick\n    for (const svc of this.transferServices) {\n      if (this.serviceState.has(svc.type)) {\n        this.scheduleServiceRefresh(svc.type);\n      }\n    }\n  }\n\n  /** Schedule a refresh (restart) of streaming for the service at its earliest quote expiration. */\n  private scheduleServiceRefresh(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) return;\n\n    const now = this.clock();\n    const earliest = earliestExpirationForService({ quotes: this.quotes, serviceType, nowSeconds: now });\n\n    if (earliest === null) {\n      // No quotes -> clear any pending refresh\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n        state.refreshTimer = null;\n      }\n      state.refreshAtSeconds = null;\n      return;\n    }\n\n    // Only reschedule if earlier than currently scheduled or no timer\n    const targetAt = Math.max(0, earliest - this.refreshBufferSeconds);\n\n    // If target time has already passed, do not schedule another refresh here.\n    if (targetAt <= now) {\n      return;\n    }\n\n    // Reschedule only when the desired refresh time changes (earlier OR later).\n    // We key refresh off the soonest-expiring active quote for this service.\n    if (state.refreshAtSeconds === targetAt && state.refreshTimer) {\n      return;\n    }\n\n    if (state.refreshTimer) {\n      clearTimeout(state.refreshTimer);\n    }\n\n    const delayMs = Math.max(0, (targetAt - now) * 1_000);\n    state.refreshAtSeconds = targetAt;\n    state.refreshTimer = setTimeout(() => {\n      // Clear timer/marker before restarting to avoid stale state if restart fails.\n      const current = this.serviceState.get(serviceType);\n      if (current) {\n        current.refreshTimer = null;\n        current.refreshAtSeconds = null;\n      }\n\n      // Restart stream and clear timer/marker\n      const svc = this.transferServices.find((s) => s.type === serviceType);\n\n      if (svc) {\n        this.startStreamForService(svc);\n      }\n    }, delayMs);\n  }\n\n  // ----- Emission helpers -----\n  /** Emit a quote event to all subscribers. */\n  private emitQuote(payload: { bestQuote: Quote; quote: Quote; quotes: readonly Quote[] }): void {\n    for (const handler of this.subscribers) {\n      handler('quote', payload);\n    }\n  }\n\n  /** Emit an error event to all subscribers. */\n  private emitError(error: Error): void {\n    for (const handler of this.subscribers) {\n      handler('error', error);\n    }\n  }\n}\n\n/**\n * Zod schema to validate the minimal Quote fields used for runtime gating.\n *\n * This is a simple schema, and is not a fully safe runtime validate for Quote.\n * That isn't necessary here since we only need to verify basic structure before\n * using the quote in internal logic.\n *\n * @internal\n */\nconst QuoteSchema = z.object({\n  id: z.string(),\n  expiresAt: z.number().int().nonnegative(),\n  amountOut: z.bigint().nonnegative(),\n  amountIn: z.bigint().nonnegative(),\n  serviceType: z.string(),\n});\n\nfunction isInvalidSameChainQuoteRequest(props: QuoterProps): boolean {\n  const { sourceAsset, sourceChain, targetAsset, targetChain } = props;\n\n  if (sourceChain.chainId !== targetChain.chainId) {\n    return false;\n  }\n\n  // Native -> native on the same chain is a no-op.\n  if (isNativeAsset(sourceAsset) && isNativeAsset(targetAsset)) {\n    return true;\n  }\n\n  // If token types differ, it's potentially a swap on the same chain.\n  if (sourceAsset.type !== targetAsset.type) {\n    return false;\n  }\n\n  // Same token type and address on the same chain is a no-op.\n  if (sourceAsset.type === TokenType.ERC20 && targetAsset.type === TokenType.ERC20) {\n    return isAddressEqual(sourceAsset.address, targetAsset.address);\n  }\n\n  if (sourceAsset.type === TokenType.SPL && targetAsset.type === TokenType.SPL) {\n    return sourceAsset.address === targetAsset.address;\n  }\n\n  return false;\n}\n\nfunction isQuoteValue(value: unknown): value is Quote {\n  const result = QuoteSchema.safeParse(value);\n\n  return result.success;\n}\n"],"mappings":"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"}
+{"version":3,"file":"quoter.cjs","names":["sortQuotes","pruneExpiredQuotes","isQuoteExpired","upsertQuote","QUOTER_EMPTY_RETRY_MAX_DELAY_MS","QUOTER_EMPTY_RETRY_BASE_DELAY_MS","earliestExpirationForService","z","isNativeAsset","TokenType"],"sources":["../../src/quoter/quoter.ts"],"sourcesContent":["import { z } from 'zod';\nimport type {\n  Quote,\n  QuoterDonePayload,\n  QuoterDoneReason,\n  QuoterEventHandler,\n  QuoterInterface,\n  QuoterProps,\n  ServiceQuoteEventArgs,\n  QuotesTuple,\n  ServiceQuoteEventHandler,\n} from '../types/quote';\nimport type { ServiceQuoteOptions, TransferService } from '../types/service';\nimport { earliestExpirationForService, isQuoteExpired, pruneExpiredQuotes, sortQuotes, upsertQuote } from './_utils';\nimport {\n  QUOTER_DEFAULT_PRUNE_INTERVAL_MS,\n  QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS,\n  QUOTER_EMPTY_RETRY_BASE_DELAY_MS,\n  QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n} from './constants';\nimport { ServiceType, TokenType } from '../constants';\nimport { isNativeAsset } from '../type-guards';\nimport { isAddressEqual } from 'viem';\n\n/**\n * Function that returns the current UNIX time in seconds.\n * Injected for deterministic testing.\n */\nexport type Clock = () => number;\n\n/**\n * Options for constructing a Quoter instance.\n *\n * These options tune how often quote state is maintained and when services are\n * proactively restarted before quote expiry.\n */\nexport interface QuoterOptions {\n  /**\n   * Dangerously allows quotes where fromAddress and toAddress differ\n   * even when a service would otherwise require them to match.\n   *\n   * This applies to both same-chain and cross-chain quotes.\n   *\n   * This is intended for explicit proxy-recipient funding flows. By default,\n   * services preserve their existing address safety checks.\n   */\n  readonly dangerouslyAllowAddressMismatch?: boolean;\n  /** Clock function returning current time in seconds (defaults to Date.now()/1000). */\n  readonly clock?: Clock;\n  /** Interval for pruning expired quotes (milliseconds).\n   *\n   * @default 1_000\n   */\n  readonly pruneIntervalMs?: number;\n  /**\n   * Amount of seconds to pre-buffer a stream restart before the earliest service quote\n   * expiration. Helps ensure continuity before actual expiry is reached.\n   *\n   * @default 5\n   */\n  readonly refreshBufferSeconds?: number;\n}\n\n/**\n * Quoter orchestrates quote streaming across multiple transfer services and emits a unified event stream.\n *\n * High-level lifecycle:\n * - Idle until first subscriber.\n * - On first subscribe, starts all eligible services.\n * - Collects and ranks active quotes, pruning expired ones over time.\n * - Completes when explicitly unsubscribed (last subscriber), when no service is eligible,\n *   or when all eligible services finish without producing any quote (`no-quotes`).\n *\n * Event model:\n * - Service `quote` -> Quoter upserts quote, recomputes best quote, emits `quote`.\n * - Service `error` -> Quoter emits `error` (non-terminal by itself).\n * - Service `done` -> Quoter marks that service attempt as completed and evaluates retry/complete rules.\n *\n * Retry/refresh behavior:\n * - Refresh: services that have active quotes are restarted shortly before the earliest quote expires.\n * - Retry: services that complete with no quote and no error are only retried after the quoter has\n *   already observed at least one quote from any service in this session.\n *\n * This design keeps first-pass \"no quotes anywhere\" terminal and fast, while still allowing services\n * like Markr to be retried in sessions where other providers are returning quotes.\n */\nexport class Quoter implements QuoterInterface {\n  private readonly clock: Clock;\n  private readonly props: QuoterProps;\n  private readonly pruneIntervalMs: number;\n  private readonly serviceQuoteOptions: ServiceQuoteOptions;\n  private readonly transferServices: readonly TransferService[];\n  private readonly refreshBufferSeconds: number;\n\n  private quotes: Quote[] = [];\n  private subscribers: Set<QuoterEventHandler> = new Set();\n  private started = false;\n  private done = false;\n  private isStartingFromSubscribe = false;\n  private pruneTimerId: ReturnType<typeof setInterval> | null = null;\n  private lastBestId: string | null = null;\n  private hasReceivedAnyQuote = false;\n\n  public readonly id: string = crypto.randomUUID();\n\n  /**\n   * Per-service runtime state for the active quote session.\n   *\n   * This tracks whether a service has completed, errored, produced quotes,\n   * and any pending timers used for retry/refresh orchestration.\n   */\n  private serviceState: Map<\n    TransferService['type'],\n    {\n      cancel: () => void;\n      done: boolean;\n      hasErrored: boolean;\n      hasReturnedQuote: boolean;\n      retryAttempt: number;\n      retryTimer: ReturnType<typeof setTimeout> | null;\n      refreshTimer: ReturnType<typeof setTimeout> | null;\n      refreshAtSeconds: number | null;\n    }\n  > = new Map();\n\n  /**\n   * Create a new Quoter instance.\n   *\n   * @param props Quoting request parameters shared across all services.\n   * @param transferServices Candidate services; eligibility is resolved at `start()` time.\n   * @param options Optional runtime tuning for pruning and refresh behavior.\n   */\n  constructor(props: QuoterProps, transferServices: readonly TransferService[], options: QuoterOptions = {}) {\n    this.clock = options.clock ?? (() => Math.floor(Date.now() / 1_000));\n    this.props = props;\n    this.pruneIntervalMs = options.pruneIntervalMs ?? QUOTER_DEFAULT_PRUNE_INTERVAL_MS;\n    this.serviceQuoteOptions = {\n      dangerouslyAllowAddressMismatch: options.dangerouslyAllowAddressMismatch,\n    };\n    this.transferServices = transferServices;\n    this.refreshBufferSeconds = options.refreshBufferSeconds ?? QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS;\n  }\n\n  /**\n   * Get the current best quote and all active quotes (sorted by desirability).\n   */\n  public getQuotes(): QuotesTuple {\n    const now = this.clock();\n    const active = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n    const sorted = sortQuotes(active);\n    const best = sorted[0] ?? null;\n\n    return [best, sorted];\n  }\n\n  /**\n   * Subscribe for quoter events.\n   *\n   * First subscriber lazily starts orchestration.\n   * Last subscriber triggers terminal completion with reason `unsubscribed`.\n   *\n   * @returns Unsubscribe function (idempotent).\n   */\n  public subscribe(handler: QuoterEventHandler): () => void {\n    this.subscribers.add(handler);\n    let unsubscribed = false;\n\n    if (!this.started) {\n      this.isStartingFromSubscribe = true;\n      try {\n        this.start();\n      } finally {\n        this.isStartingFromSubscribe = false;\n      }\n    }\n\n    return () => {\n      if (unsubscribed) {\n        return;\n      }\n      unsubscribed = true;\n\n      if (this.done) {\n        this.subscribers.delete(handler);\n        return;\n      }\n\n      const wasLastSubscriber = this.subscribers.size === 1 && this.subscribers.has(handler);\n      if (wasLastSubscriber) {\n        this.complete('unsubscribed');\n        return;\n      }\n\n      this.subscribers.delete(handler);\n    };\n  }\n\n  // ----- Internal orchestration -----\n\n  /**\n   * Start a fresh quote session.\n   *\n   * Resets session-local state, validates basic request viability,\n   * starts streams for eligible services, and begins prune ticks.\n   */\n  private start(): void {\n    this.started = true;\n    this.done = false;\n    this.quotes = [];\n    this.lastBestId = null;\n    this.hasReceivedAnyQuote = false;\n\n    // Same-chain quotes for the *same* asset are not a valid transfer scenario.\n    if (isInvalidSameChainQuoteRequest(this.props)) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    let hasEligibleService = false;\n\n    // Start streams for eligible services\n    for (const svc of this.transferServices) {\n      const eligible = svc.analyzeSupport({\n        sourceAsset: this.props.sourceAsset,\n        sourceChainId: this.props.sourceChain.chainId,\n        targetAsset: this.props.targetAsset,\n        targetChainId: this.props.targetChain.chainId,\n      });\n\n      if (!eligible) continue;\n      hasEligibleService = true;\n\n      this.startStreamForService(svc);\n    }\n\n    if (!hasEligibleService) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    // Start periodic prune\n    this.pruneTimerId = setInterval(() => this.onPruneTick(), this.pruneIntervalMs);\n  }\n\n  /**\n   * Stop all streams and timers.\n   * Quotes are retained for snapshot access via getQuotes(), though they\n   * can still be pruned due to expiration.\n   */\n  private stop(): void {\n    this.started = false;\n\n    if (this.pruneTimerId) {\n      clearInterval(this.pruneTimerId);\n      this.pruneTimerId = null;\n    }\n\n    for (const [type, state] of this.serviceState) {\n      try {\n        state.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n      }\n\n      if (state.retryTimer) {\n        clearTimeout(state.retryTimer);\n      }\n\n      this.serviceState.set(type, {\n        cancel: () => {},\n        done: false,\n        hasErrored: false,\n        hasReturnedQuote: false,\n        retryAttempt: 0,\n        retryTimer: null,\n        refreshTimer: null,\n        refreshAtSeconds: null,\n      });\n    }\n  }\n\n  /**\n   * Begin or restart streaming for a specific service.\n   *\n   * Any previous stream/timers for that service are canceled before starting a new attempt.\n   */\n  private startStreamForService(svc: TransferService): void {\n    // Clean up any existing stream and refresh timer\n    const existing = this.serviceState.get(svc.type);\n\n    if (existing) {\n      try {\n        existing.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (existing.refreshTimer) clearTimeout(existing.refreshTimer);\n      if (existing.retryTimer) clearTimeout(existing.retryTimer);\n    }\n\n    const handler = this.makeServiceHandler(svc.type);\n    const bufferedEvents: ServiceQuoteEventArgs[] = [];\n    let isStartingStream = true;\n\n    // Some services emit quote/done synchronously inside streamQuotes().\n    // If those events run before subscribe() returns, consumers can hit TDZ\n    // when they reference the returned unsubscribe function in their callback.\n    // Buffer startup emissions and flush them after stream initialization.\n    const guardedHandler: ServiceQuoteEventHandler = (...eventArgs) => {\n      if (isStartingStream) {\n        bufferedEvents.push(eventArgs);\n        return;\n      }\n\n      handler(...eventArgs);\n    };\n\n    const { cancel } = svc.streamQuotes(this.props, guardedHandler, this.serviceQuoteOptions);\n    isStartingStream = false;\n\n    if (bufferedEvents.length > 0) {\n      // Use a microtask so subscribe() can return before the first callback fires.\n      // This preserves event order while avoiding re-entrancy during subscription.\n      queueMicrotask(() => {\n        for (const bufferedEvent of bufferedEvents) {\n          handler(...bufferedEvent);\n        }\n      });\n    }\n\n    this.serviceState.set(svc.type, {\n      cancel,\n      done: false,\n      hasErrored: false,\n      hasReturnedQuote: false,\n      retryAttempt: existing?.retryAttempt ?? 0,\n      retryTimer: null,\n      refreshTimer: null,\n      refreshAtSeconds: null,\n    });\n  }\n\n  /**\n   * Create the service-scoped event handler consumed by `TransferService.streamQuotes`.\n   *\n   * The handler enforces service/quote consistency and translates service events into\n   * quoter state transitions.\n   */\n  private makeServiceHandler(serviceType: TransferService['type']): ServiceQuoteEventHandler {\n    return (event, ...args) => {\n      // Ignore any service events once stopped to prevent post-stop mutations.\n      if (!this.started) {\n        return;\n      }\n      if (event === 'quote') {\n        const maybeQuote = args[0];\n        if (isQuoteValue(maybeQuote)) {\n          // Enforce the quote belongs to the emitting service\n          if (maybeQuote.serviceType !== serviceType) {\n            // Ignore quotes mismatched to service; defensive\n            return;\n          }\n          const state = this.serviceState.get(serviceType);\n          if (state) {\n            state.hasReturnedQuote = true;\n          }\n          this.onIncomingQuote(maybeQuote);\n          this.scheduleServiceRefresh(serviceType);\n        }\n\n        return;\n      }\n      if (event === 'done') {\n        this.onServiceDone(serviceType);\n\n        return;\n      }\n      if (event === 'error') {\n        const state = this.serviceState.get(serviceType);\n        if (state) {\n          state.hasErrored = true;\n        }\n        const maybeErr = args[0];\n        if (maybeErr instanceof Error) {\n          this.emitError(maybeErr);\n        }\n      }\n    };\n  }\n\n  /**\n   * Handle an incoming quote event.\n   *\n   * Expired quotes are ignored. Valid quotes are upserted into active state,\n   * then sorted/pruned and emitted to subscribers.\n   */\n  private onIncomingQuote(quote: Quote): void {\n    const now = this.clock();\n\n    if (isQuoteExpired({ quote, nowSeconds: now })) {\n      return;\n    }\n\n    this.hasReceivedAnyQuote = true;\n\n    this.resetRetryForService(quote.serviceType);\n\n    this.quotes = sortQuotes(pruneExpiredQuotes({ quotes: upsertQuote(this.quotes, quote), nowSeconds: now }));\n\n    // Always emit on every incoming quote\n    const best = this.quotes[0];\n    if (best) {\n      this.lastBestId = best.id;\n      this.emitQuote({ bestQuote: best, quote, quotes: this.quotes });\n    }\n  }\n\n  private resetRetryForService(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.retryAttempt = 0;\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n  }\n\n  /**\n   * Schedule a retry attempt for a service using exponential backoff.\n   *\n   * This is used only for quote-less successful completions once the overall session\n   * has already produced at least one quote from some service.\n   */\n  private scheduleServiceRetry(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n\n    const delayMs = Math.min(\n      QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n      QUOTER_EMPTY_RETRY_BASE_DELAY_MS * 2 ** state.retryAttempt,\n    );\n    state.retryAttempt += 1;\n\n    state.retryTimer = setTimeout(\n      () => {\n        const current = this.serviceState.get(serviceType);\n        if (current) {\n          current.retryTimer = null;\n        }\n\n        if (!this.started) {\n          return;\n        }\n\n        const svc = this.transferServices.find((s) => s.type === serviceType);\n        if (svc) {\n          this.startStreamForService(svc);\n        }\n      },\n      Math.max(0, delayMs),\n    );\n  }\n\n  /**\n   * Handle service completion (`done`).\n   *\n   * A completion may schedule:\n   * - refresh (if the service has active quotes), and/or\n   * - retry (quote-less/non-error completion, but only after any quote has existed in session).\n   *\n   * Then evaluates whether the full quoter can complete with `no-quotes`.\n   */\n  private onServiceDone(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.done = true;\n    this.scheduleServiceRefresh(serviceType);\n\n    if (this.hasReceivedAnyQuote && !state.hasErrored && !state.hasReturnedQuote) {\n      this.scheduleServiceRetry(serviceType);\n    }\n\n    this.maybeCompleteNoQuotes();\n  }\n\n  /**\n   * Complete with `no-quotes` when every eligible service has finished and\n   * no quote was ever observed during this session.\n   */\n  private maybeCompleteNoQuotes(): void {\n    if (!this.started || this.done || this.hasReceivedAnyQuote || this.serviceState.size === 0) {\n      return;\n    }\n\n    const allServicesDone = [...this.serviceState.values()].every((state) => state.done);\n\n    if (allServicesDone) {\n      this.complete('no-quotes');\n    }\n  }\n\n  /**\n   * Finalize the quoter session and broadcast terminal reason exactly once.\n   */\n  private complete(reason: QuoterDoneReason): void {\n    if (this.done) {\n      return;\n    }\n\n    const payload = this.makeDonePayload(reason);\n\n    this.done = true;\n    this.stop();\n\n    // When complete() happens during subscribe()->start(), emit done on a microtask\n    // so callers can safely reference the returned unsubscribe in their handler.\n    if (this.isStartingFromSubscribe) {\n      queueMicrotask(() => {\n        const handlers = [...this.subscribers];\n        this.subscribers.clear();\n\n        for (const handler of handlers) {\n          handler('done', payload);\n        }\n      });\n      return;\n    }\n\n    const handlers = [...this.subscribers];\n    this.subscribers.clear();\n\n    for (const handler of handlers) {\n      handler('done', payload);\n    }\n  }\n\n  private getInitializedServices(): ServiceType[] {\n    return [...new Set(this.transferServices.map((service) => service.type))];\n  }\n\n  private getEligibleServices(): ServiceType[] {\n    return [...this.serviceState.keys()];\n  }\n\n  private makeDonePayload(reason: QuoterDoneReason): QuoterDonePayload {\n    if (reason === 'unsubscribed') {\n      return { reason, data: undefined };\n    }\n\n    const initializedServices = this.getInitializedServices();\n\n    if (reason === 'no-eligible-services') {\n      return {\n        reason,\n        data: {\n          initializedServices,\n          quoterProps: this.props,\n        },\n      };\n    }\n\n    return {\n      reason,\n      data: {\n        eligibleServices: this.getEligibleServices(),\n        initializedServices,\n        quoterProps: this.props,\n      },\n    };\n  }\n\n  /** Periodic prune tick to evict expired quotes and emit best changes. */\n  private onPruneTick(): void {\n    const now = this.clock();\n    const pruned = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n\n    if (pruned.length !== this.quotes.length) {\n      this.quotes = sortQuotes(pruned);\n      const best = this.quotes[0] ?? null;\n      const bestId = best ? best.id : null;\n\n      if (best && bestId !== this.lastBestId) {\n        this.lastBestId = bestId;\n        this.emitQuote({ bestQuote: best, quote: best, quotes: this.quotes });\n      } else if (!best) {\n        this.lastBestId = null;\n      }\n    }\n\n    // Re-evaluate refresh scheduling for all services on prune tick\n    for (const svc of this.transferServices) {\n      if (this.serviceState.has(svc.type)) {\n        this.scheduleServiceRefresh(svc.type);\n      }\n    }\n  }\n\n  /** Schedule a refresh (restart) of streaming for the service at its earliest quote expiration. */\n  private scheduleServiceRefresh(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) return;\n\n    const now = this.clock();\n    const earliest = earliestExpirationForService({ quotes: this.quotes, serviceType, nowSeconds: now });\n\n    if (earliest === null) {\n      // No quotes -> clear any pending refresh\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n        state.refreshTimer = null;\n      }\n      state.refreshAtSeconds = null;\n      return;\n    }\n\n    // Only reschedule if earlier than currently scheduled or no timer\n    const targetAt = Math.max(0, earliest - this.refreshBufferSeconds);\n\n    // If target time has already passed, do not schedule another refresh here.\n    if (targetAt <= now) {\n      return;\n    }\n\n    // Reschedule only when the desired refresh time changes (earlier OR later).\n    // We key refresh off the soonest-expiring active quote for this service.\n    if (state.refreshAtSeconds === targetAt && state.refreshTimer) {\n      return;\n    }\n\n    if (state.refreshTimer) {\n      clearTimeout(state.refreshTimer);\n    }\n\n    const delayMs = Math.max(0, (targetAt - now) * 1_000);\n    state.refreshAtSeconds = targetAt;\n    state.refreshTimer = setTimeout(() => {\n      // Clear timer/marker before restarting to avoid stale state if restart fails.\n      const current = this.serviceState.get(serviceType);\n      if (current) {\n        current.refreshTimer = null;\n        current.refreshAtSeconds = null;\n      }\n\n      // Restart stream and clear timer/marker\n      const svc = this.transferServices.find((s) => s.type === serviceType);\n\n      if (svc) {\n        this.startStreamForService(svc);\n      }\n    }, delayMs);\n  }\n\n  // ----- Emission helpers -----\n  /** Emit a quote event to all subscribers. */\n  private emitQuote(payload: { bestQuote: Quote; quote: Quote; quotes: readonly Quote[] }): void {\n    for (const handler of this.subscribers) {\n      handler('quote', payload);\n    }\n  }\n\n  /** Emit an error event to all subscribers. */\n  private emitError(error: Error): void {\n    for (const handler of this.subscribers) {\n      handler('error', error);\n    }\n  }\n}\n\n/**\n * Zod schema to validate the minimal Quote fields used for runtime gating.\n *\n * This is a simple schema, and is not a fully safe runtime validate for Quote.\n * That isn't necessary here since we only need to verify basic structure before\n * using the quote in internal logic.\n *\n * @internal\n */\nconst QuoteSchema = z.object({\n  id: z.string(),\n  expiresAt: z.number().int().nonnegative(),\n  amountOut: z.bigint().nonnegative(),\n  amountIn: z.bigint().nonnegative(),\n  serviceType: z.string(),\n});\n\nfunction isInvalidSameChainQuoteRequest(props: QuoterProps): boolean {\n  const { sourceAsset, sourceChain, targetAsset, targetChain } = props;\n\n  if (sourceChain.chainId !== targetChain.chainId) {\n    return false;\n  }\n\n  // Native -> native on the same chain is a no-op.\n  if (isNativeAsset(sourceAsset) && isNativeAsset(targetAsset)) {\n    return true;\n  }\n\n  // If token types differ, it's potentially a swap on the same chain.\n  if (sourceAsset.type !== targetAsset.type) {\n    return false;\n  }\n\n  // Same token type and address on the same chain is a no-op.\n  if (sourceAsset.type === TokenType.ERC20 && targetAsset.type === TokenType.ERC20) {\n    return isAddressEqual(sourceAsset.address, targetAsset.address);\n  }\n\n  if (sourceAsset.type === TokenType.SPL && targetAsset.type === TokenType.SPL) {\n    return sourceAsset.address === targetAsset.address;\n  }\n\n  return false;\n}\n\nfunction isQuoteValue(value: unknown): value is Quote {\n  const result = QuoteSchema.safeParse(value);\n\n  return result.success;\n}\n"],"mappings":"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"}

package/dist/quoter/quoter.d.cts

@@ -12,9 +12,11 @@ type Clock = () => number;
 */
 interface QuoterOptions {
   /**
-  * Dangerously allows cross-chain quotes where fromAddress and toAddress differ
+  * Dangerously allows quotes where fromAddress and toAddress differ
   * even when a service would otherwise require them to match.
   *
+  * This applies to both same-chain and cross-chain quotes.
+  *
   * This is intended for explicit proxy-recipient funding flows. By default,
   * services preserve their existing address safety checks.
   */

package/dist/quoter/quoter.d.ts

@@ -12,9 +12,11 @@ type Clock = () => number;
 */
 interface QuoterOptions {
   /**
-  * Dangerously allows cross-chain quotes where fromAddress and toAddress differ
+  * Dangerously allows quotes where fromAddress and toAddress differ
   * even when a service would otherwise require them to match.
   *
+  * This applies to both same-chain and cross-chain quotes.
+  *
   * This is intended for explicit proxy-recipient funding flows. By default,
   * services preserve their existing address safety checks.
   */

package/dist/quoter/quoter.js.map

@@ -1 +1 @@
-{"version":3,"file":"quoter.js","names":[],"sources":["../../src/quoter/quoter.ts"],"sourcesContent":["import { z } from 'zod';\nimport type {\n  Quote,\n  QuoterDonePayload,\n  QuoterDoneReason,\n  QuoterEventHandler,\n  QuoterInterface,\n  QuoterProps,\n  ServiceQuoteEventArgs,\n  QuotesTuple,\n  ServiceQuoteEventHandler,\n} from '../types/quote';\nimport type { ServiceQuoteOptions, TransferService } from '../types/service';\nimport { earliestExpirationForService, isQuoteExpired, pruneExpiredQuotes, sortQuotes, upsertQuote } from './_utils';\nimport {\n  QUOTER_DEFAULT_PRUNE_INTERVAL_MS,\n  QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS,\n  QUOTER_EMPTY_RETRY_BASE_DELAY_MS,\n  QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n} from './constants';\nimport { ServiceType, TokenType } from '../constants';\nimport { isNativeAsset } from '../type-guards';\nimport { isAddressEqual } from 'viem';\n\n/**\n * Function that returns the current UNIX time in seconds.\n * Injected for deterministic testing.\n */\nexport type Clock = () => number;\n\n/**\n * Options for constructing a Quoter instance.\n *\n * These options tune how often quote state is maintained and when services are\n * proactively restarted before quote expiry.\n */\nexport interface QuoterOptions {\n  /**\n   * Dangerously allows cross-chain quotes where fromAddress and toAddress differ\n   * even when a service would otherwise require them to match.\n   *\n   * This is intended for explicit proxy-recipient funding flows. By default,\n   * services preserve their existing address safety checks.\n   */\n  readonly dangerouslyAllowAddressMismatch?: boolean;\n  /** Clock function returning current time in seconds (defaults to Date.now()/1000). */\n  readonly clock?: Clock;\n  /** Interval for pruning expired quotes (milliseconds).\n   *\n   * @default 1_000\n   */\n  readonly pruneIntervalMs?: number;\n  /**\n   * Amount of seconds to pre-buffer a stream restart before the earliest service quote\n   * expiration. Helps ensure continuity before actual expiry is reached.\n   *\n   * @default 5\n   */\n  readonly refreshBufferSeconds?: number;\n}\n\n/**\n * Quoter orchestrates quote streaming across multiple transfer services and emits a unified event stream.\n *\n * High-level lifecycle:\n * - Idle until first subscriber.\n * - On first subscribe, starts all eligible services.\n * - Collects and ranks active quotes, pruning expired ones over time.\n * - Completes when explicitly unsubscribed (last subscriber), when no service is eligible,\n *   or when all eligible services finish without producing any quote (`no-quotes`).\n *\n * Event model:\n * - Service `quote` -> Quoter upserts quote, recomputes best quote, emits `quote`.\n * - Service `error` -> Quoter emits `error` (non-terminal by itself).\n * - Service `done` -> Quoter marks that service attempt as completed and evaluates retry/complete rules.\n *\n * Retry/refresh behavior:\n * - Refresh: services that have active quotes are restarted shortly before the earliest quote expires.\n * - Retry: services that complete with no quote and no error are only retried after the quoter has\n *   already observed at least one quote from any service in this session.\n *\n * This design keeps first-pass \"no quotes anywhere\" terminal and fast, while still allowing services\n * like Markr to be retried in sessions where other providers are returning quotes.\n */\nexport class Quoter implements QuoterInterface {\n  private readonly clock: Clock;\n  private readonly props: QuoterProps;\n  private readonly pruneIntervalMs: number;\n  private readonly serviceQuoteOptions: ServiceQuoteOptions;\n  private readonly transferServices: readonly TransferService[];\n  private readonly refreshBufferSeconds: number;\n\n  private quotes: Quote[] = [];\n  private subscribers: Set<QuoterEventHandler> = new Set();\n  private started = false;\n  private done = false;\n  private isStartingFromSubscribe = false;\n  private pruneTimerId: ReturnType<typeof setInterval> | null = null;\n  private lastBestId: string | null = null;\n  private hasReceivedAnyQuote = false;\n\n  public readonly id: string = crypto.randomUUID();\n\n  /**\n   * Per-service runtime state for the active quote session.\n   *\n   * This tracks whether a service has completed, errored, produced quotes,\n   * and any pending timers used for retry/refresh orchestration.\n   */\n  private serviceState: Map<\n    TransferService['type'],\n    {\n      cancel: () => void;\n      done: boolean;\n      hasErrored: boolean;\n      hasReturnedQuote: boolean;\n      retryAttempt: number;\n      retryTimer: ReturnType<typeof setTimeout> | null;\n      refreshTimer: ReturnType<typeof setTimeout> | null;\n      refreshAtSeconds: number | null;\n    }\n  > = new Map();\n\n  /**\n   * Create a new Quoter instance.\n   *\n   * @param props Quoting request parameters shared across all services.\n   * @param transferServices Candidate services; eligibility is resolved at `start()` time.\n   * @param options Optional runtime tuning for pruning and refresh behavior.\n   */\n  constructor(props: QuoterProps, transferServices: readonly TransferService[], options: QuoterOptions = {}) {\n    this.clock = options.clock ?? (() => Math.floor(Date.now() / 1_000));\n    this.props = props;\n    this.pruneIntervalMs = options.pruneIntervalMs ?? QUOTER_DEFAULT_PRUNE_INTERVAL_MS;\n    this.serviceQuoteOptions = {\n      dangerouslyAllowAddressMismatch: options.dangerouslyAllowAddressMismatch,\n    };\n    this.transferServices = transferServices;\n    this.refreshBufferSeconds = options.refreshBufferSeconds ?? QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS;\n  }\n\n  /**\n   * Get the current best quote and all active quotes (sorted by desirability).\n   */\n  public getQuotes(): QuotesTuple {\n    const now = this.clock();\n    const active = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n    const sorted = sortQuotes(active);\n    const best = sorted[0] ?? null;\n\n    return [best, sorted];\n  }\n\n  /**\n   * Subscribe for quoter events.\n   *\n   * First subscriber lazily starts orchestration.\n   * Last subscriber triggers terminal completion with reason `unsubscribed`.\n   *\n   * @returns Unsubscribe function (idempotent).\n   */\n  public subscribe(handler: QuoterEventHandler): () => void {\n    this.subscribers.add(handler);\n    let unsubscribed = false;\n\n    if (!this.started) {\n      this.isStartingFromSubscribe = true;\n      try {\n        this.start();\n      } finally {\n        this.isStartingFromSubscribe = false;\n      }\n    }\n\n    return () => {\n      if (unsubscribed) {\n        return;\n      }\n      unsubscribed = true;\n\n      if (this.done) {\n        this.subscribers.delete(handler);\n        return;\n      }\n\n      const wasLastSubscriber = this.subscribers.size === 1 && this.subscribers.has(handler);\n      if (wasLastSubscriber) {\n        this.complete('unsubscribed');\n        return;\n      }\n\n      this.subscribers.delete(handler);\n    };\n  }\n\n  // ----- Internal orchestration -----\n\n  /**\n   * Start a fresh quote session.\n   *\n   * Resets session-local state, validates basic request viability,\n   * starts streams for eligible services, and begins prune ticks.\n   */\n  private start(): void {\n    this.started = true;\n    this.done = false;\n    this.quotes = [];\n    this.lastBestId = null;\n    this.hasReceivedAnyQuote = false;\n\n    // Same-chain quotes for the *same* asset are not a valid transfer scenario.\n    if (isInvalidSameChainQuoteRequest(this.props)) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    let hasEligibleService = false;\n\n    // Start streams for eligible services\n    for (const svc of this.transferServices) {\n      const eligible = svc.analyzeSupport({\n        sourceAsset: this.props.sourceAsset,\n        sourceChainId: this.props.sourceChain.chainId,\n        targetAsset: this.props.targetAsset,\n        targetChainId: this.props.targetChain.chainId,\n      });\n\n      if (!eligible) continue;\n      hasEligibleService = true;\n\n      this.startStreamForService(svc);\n    }\n\n    if (!hasEligibleService) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    // Start periodic prune\n    this.pruneTimerId = setInterval(() => this.onPruneTick(), this.pruneIntervalMs);\n  }\n\n  /**\n   * Stop all streams and timers.\n   * Quotes are retained for snapshot access via getQuotes(), though they\n   * can still be pruned due to expiration.\n   */\n  private stop(): void {\n    this.started = false;\n\n    if (this.pruneTimerId) {\n      clearInterval(this.pruneTimerId);\n      this.pruneTimerId = null;\n    }\n\n    for (const [type, state] of this.serviceState) {\n      try {\n        state.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n      }\n\n      if (state.retryTimer) {\n        clearTimeout(state.retryTimer);\n      }\n\n      this.serviceState.set(type, {\n        cancel: () => {},\n        done: false,\n        hasErrored: false,\n        hasReturnedQuote: false,\n        retryAttempt: 0,\n        retryTimer: null,\n        refreshTimer: null,\n        refreshAtSeconds: null,\n      });\n    }\n  }\n\n  /**\n   * Begin or restart streaming for a specific service.\n   *\n   * Any previous stream/timers for that service are canceled before starting a new attempt.\n   */\n  private startStreamForService(svc: TransferService): void {\n    // Clean up any existing stream and refresh timer\n    const existing = this.serviceState.get(svc.type);\n\n    if (existing) {\n      try {\n        existing.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (existing.refreshTimer) clearTimeout(existing.refreshTimer);\n      if (existing.retryTimer) clearTimeout(existing.retryTimer);\n    }\n\n    const handler = this.makeServiceHandler(svc.type);\n    const bufferedEvents: ServiceQuoteEventArgs[] = [];\n    let isStartingStream = true;\n\n    // Some services emit quote/done synchronously inside streamQuotes().\n    // If those events run before subscribe() returns, consumers can hit TDZ\n    // when they reference the returned unsubscribe function in their callback.\n    // Buffer startup emissions and flush them after stream initialization.\n    const guardedHandler: ServiceQuoteEventHandler = (...eventArgs) => {\n      if (isStartingStream) {\n        bufferedEvents.push(eventArgs);\n        return;\n      }\n\n      handler(...eventArgs);\n    };\n\n    const { cancel } = svc.streamQuotes(this.props, guardedHandler, this.serviceQuoteOptions);\n    isStartingStream = false;\n\n    if (bufferedEvents.length > 0) {\n      // Use a microtask so subscribe() can return before the first callback fires.\n      // This preserves event order while avoiding re-entrancy during subscription.\n      queueMicrotask(() => {\n        for (const bufferedEvent of bufferedEvents) {\n          handler(...bufferedEvent);\n        }\n      });\n    }\n\n    this.serviceState.set(svc.type, {\n      cancel,\n      done: false,\n      hasErrored: false,\n      hasReturnedQuote: false,\n      retryAttempt: existing?.retryAttempt ?? 0,\n      retryTimer: null,\n      refreshTimer: null,\n      refreshAtSeconds: null,\n    });\n  }\n\n  /**\n   * Create the service-scoped event handler consumed by `TransferService.streamQuotes`.\n   *\n   * The handler enforces service/quote consistency and translates service events into\n   * quoter state transitions.\n   */\n  private makeServiceHandler(serviceType: TransferService['type']): ServiceQuoteEventHandler {\n    return (event, ...args) => {\n      // Ignore any service events once stopped to prevent post-stop mutations.\n      if (!this.started) {\n        return;\n      }\n      if (event === 'quote') {\n        const maybeQuote = args[0];\n        if (isQuoteValue(maybeQuote)) {\n          // Enforce the quote belongs to the emitting service\n          if (maybeQuote.serviceType !== serviceType) {\n            // Ignore quotes mismatched to service; defensive\n            return;\n          }\n          const state = this.serviceState.get(serviceType);\n          if (state) {\n            state.hasReturnedQuote = true;\n          }\n          this.onIncomingQuote(maybeQuote);\n          this.scheduleServiceRefresh(serviceType);\n        }\n\n        return;\n      }\n      if (event === 'done') {\n        this.onServiceDone(serviceType);\n\n        return;\n      }\n      if (event === 'error') {\n        const state = this.serviceState.get(serviceType);\n        if (state) {\n          state.hasErrored = true;\n        }\n        const maybeErr = args[0];\n        if (maybeErr instanceof Error) {\n          this.emitError(maybeErr);\n        }\n      }\n    };\n  }\n\n  /**\n   * Handle an incoming quote event.\n   *\n   * Expired quotes are ignored. Valid quotes are upserted into active state,\n   * then sorted/pruned and emitted to subscribers.\n   */\n  private onIncomingQuote(quote: Quote): void {\n    const now = this.clock();\n\n    if (isQuoteExpired({ quote, nowSeconds: now })) {\n      return;\n    }\n\n    this.hasReceivedAnyQuote = true;\n\n    this.resetRetryForService(quote.serviceType);\n\n    this.quotes = sortQuotes(pruneExpiredQuotes({ quotes: upsertQuote(this.quotes, quote), nowSeconds: now }));\n\n    // Always emit on every incoming quote\n    const best = this.quotes[0];\n    if (best) {\n      this.lastBestId = best.id;\n      this.emitQuote({ bestQuote: best, quote, quotes: this.quotes });\n    }\n  }\n\n  private resetRetryForService(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.retryAttempt = 0;\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n  }\n\n  /**\n   * Schedule a retry attempt for a service using exponential backoff.\n   *\n   * This is used only for quote-less successful completions once the overall session\n   * has already produced at least one quote from some service.\n   */\n  private scheduleServiceRetry(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n\n    const delayMs = Math.min(\n      QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n      QUOTER_EMPTY_RETRY_BASE_DELAY_MS * 2 ** state.retryAttempt,\n    );\n    state.retryAttempt += 1;\n\n    state.retryTimer = setTimeout(\n      () => {\n        const current = this.serviceState.get(serviceType);\n        if (current) {\n          current.retryTimer = null;\n        }\n\n        if (!this.started) {\n          return;\n        }\n\n        const svc = this.transferServices.find((s) => s.type === serviceType);\n        if (svc) {\n          this.startStreamForService(svc);\n        }\n      },\n      Math.max(0, delayMs),\n    );\n  }\n\n  /**\n   * Handle service completion (`done`).\n   *\n   * A completion may schedule:\n   * - refresh (if the service has active quotes), and/or\n   * - retry (quote-less/non-error completion, but only after any quote has existed in session).\n   *\n   * Then evaluates whether the full quoter can complete with `no-quotes`.\n   */\n  private onServiceDone(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.done = true;\n    this.scheduleServiceRefresh(serviceType);\n\n    if (this.hasReceivedAnyQuote && !state.hasErrored && !state.hasReturnedQuote) {\n      this.scheduleServiceRetry(serviceType);\n    }\n\n    this.maybeCompleteNoQuotes();\n  }\n\n  /**\n   * Complete with `no-quotes` when every eligible service has finished and\n   * no quote was ever observed during this session.\n   */\n  private maybeCompleteNoQuotes(): void {\n    if (!this.started || this.done || this.hasReceivedAnyQuote || this.serviceState.size === 0) {\n      return;\n    }\n\n    const allServicesDone = [...this.serviceState.values()].every((state) => state.done);\n\n    if (allServicesDone) {\n      this.complete('no-quotes');\n    }\n  }\n\n  /**\n   * Finalize the quoter session and broadcast terminal reason exactly once.\n   */\n  private complete(reason: QuoterDoneReason): void {\n    if (this.done) {\n      return;\n    }\n\n    const payload = this.makeDonePayload(reason);\n\n    this.done = true;\n    this.stop();\n\n    // When complete() happens during subscribe()->start(), emit done on a microtask\n    // so callers can safely reference the returned unsubscribe in their handler.\n    if (this.isStartingFromSubscribe) {\n      queueMicrotask(() => {\n        const handlers = [...this.subscribers];\n        this.subscribers.clear();\n\n        for (const handler of handlers) {\n          handler('done', payload);\n        }\n      });\n      return;\n    }\n\n    const handlers = [...this.subscribers];\n    this.subscribers.clear();\n\n    for (const handler of handlers) {\n      handler('done', payload);\n    }\n  }\n\n  private getInitializedServices(): ServiceType[] {\n    return [...new Set(this.transferServices.map((service) => service.type))];\n  }\n\n  private getEligibleServices(): ServiceType[] {\n    return [...this.serviceState.keys()];\n  }\n\n  private makeDonePayload(reason: QuoterDoneReason): QuoterDonePayload {\n    if (reason === 'unsubscribed') {\n      return { reason, data: undefined };\n    }\n\n    const initializedServices = this.getInitializedServices();\n\n    if (reason === 'no-eligible-services') {\n      return {\n        reason,\n        data: {\n          initializedServices,\n          quoterProps: this.props,\n        },\n      };\n    }\n\n    return {\n      reason,\n      data: {\n        eligibleServices: this.getEligibleServices(),\n        initializedServices,\n        quoterProps: this.props,\n      },\n    };\n  }\n\n  /** Periodic prune tick to evict expired quotes and emit best changes. */\n  private onPruneTick(): void {\n    const now = this.clock();\n    const pruned = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n\n    if (pruned.length !== this.quotes.length) {\n      this.quotes = sortQuotes(pruned);\n      const best = this.quotes[0] ?? null;\n      const bestId = best ? best.id : null;\n\n      if (best && bestId !== this.lastBestId) {\n        this.lastBestId = bestId;\n        this.emitQuote({ bestQuote: best, quote: best, quotes: this.quotes });\n      } else if (!best) {\n        this.lastBestId = null;\n      }\n    }\n\n    // Re-evaluate refresh scheduling for all services on prune tick\n    for (const svc of this.transferServices) {\n      if (this.serviceState.has(svc.type)) {\n        this.scheduleServiceRefresh(svc.type);\n      }\n    }\n  }\n\n  /** Schedule a refresh (restart) of streaming for the service at its earliest quote expiration. */\n  private scheduleServiceRefresh(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) return;\n\n    const now = this.clock();\n    const earliest = earliestExpirationForService({ quotes: this.quotes, serviceType, nowSeconds: now });\n\n    if (earliest === null) {\n      // No quotes -> clear any pending refresh\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n        state.refreshTimer = null;\n      }\n      state.refreshAtSeconds = null;\n      return;\n    }\n\n    // Only reschedule if earlier than currently scheduled or no timer\n    const targetAt = Math.max(0, earliest - this.refreshBufferSeconds);\n\n    // If target time has already passed, do not schedule another refresh here.\n    if (targetAt <= now) {\n      return;\n    }\n\n    // Reschedule only when the desired refresh time changes (earlier OR later).\n    // We key refresh off the soonest-expiring active quote for this service.\n    if (state.refreshAtSeconds === targetAt && state.refreshTimer) {\n      return;\n    }\n\n    if (state.refreshTimer) {\n      clearTimeout(state.refreshTimer);\n    }\n\n    const delayMs = Math.max(0, (targetAt - now) * 1_000);\n    state.refreshAtSeconds = targetAt;\n    state.refreshTimer = setTimeout(() => {\n      // Clear timer/marker before restarting to avoid stale state if restart fails.\n      const current = this.serviceState.get(serviceType);\n      if (current) {\n        current.refreshTimer = null;\n        current.refreshAtSeconds = null;\n      }\n\n      // Restart stream and clear timer/marker\n      const svc = this.transferServices.find((s) => s.type === serviceType);\n\n      if (svc) {\n        this.startStreamForService(svc);\n      }\n    }, delayMs);\n  }\n\n  // ----- Emission helpers -----\n  /** Emit a quote event to all subscribers. */\n  private emitQuote(payload: { bestQuote: Quote; quote: Quote; quotes: readonly Quote[] }): void {\n    for (const handler of this.subscribers) {\n      handler('quote', payload);\n    }\n  }\n\n  /** Emit an error event to all subscribers. */\n  private emitError(error: Error): void {\n    for (const handler of this.subscribers) {\n      handler('error', error);\n    }\n  }\n}\n\n/**\n * Zod schema to validate the minimal Quote fields used for runtime gating.\n *\n * This is a simple schema, and is not a fully safe runtime validate for Quote.\n * That isn't necessary here since we only need to verify basic structure before\n * using the quote in internal logic.\n *\n * @internal\n */\nconst QuoteSchema = z.object({\n  id: z.string(),\n  expiresAt: z.number().int().nonnegative(),\n  amountOut: z.bigint().nonnegative(),\n  amountIn: z.bigint().nonnegative(),\n  serviceType: z.string(),\n});\n\nfunction isInvalidSameChainQuoteRequest(props: QuoterProps): boolean {\n  const { sourceAsset, sourceChain, targetAsset, targetChain } = props;\n\n  if (sourceChain.chainId !== targetChain.chainId) {\n    return false;\n  }\n\n  // Native -> native on the same chain is a no-op.\n  if (isNativeAsset(sourceAsset) && isNativeAsset(targetAsset)) {\n    return true;\n  }\n\n  // If token types differ, it's potentially a swap on the same chain.\n  if (sourceAsset.type !== targetAsset.type) {\n    return false;\n  }\n\n  // Same token type and address on the same chain is a no-op.\n  if (sourceAsset.type === TokenType.ERC20 && targetAsset.type === TokenType.ERC20) {\n    return isAddressEqual(sourceAsset.address, targetAsset.address);\n  }\n\n  if (sourceAsset.type === TokenType.SPL && targetAsset.type === TokenType.SPL) {\n    return sourceAsset.address === targetAsset.address;\n  }\n\n  return false;\n}\n\nfunction isQuoteValue(value: unknown): value is Quote {\n  const result = QuoteSchema.safeParse(value);\n\n  return result.success;\n}\n"],"mappings":"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"}
+{"version":3,"file":"quoter.js","names":[],"sources":["../../src/quoter/quoter.ts"],"sourcesContent":["import { z } from 'zod';\nimport type {\n  Quote,\n  QuoterDonePayload,\n  QuoterDoneReason,\n  QuoterEventHandler,\n  QuoterInterface,\n  QuoterProps,\n  ServiceQuoteEventArgs,\n  QuotesTuple,\n  ServiceQuoteEventHandler,\n} from '../types/quote';\nimport type { ServiceQuoteOptions, TransferService } from '../types/service';\nimport { earliestExpirationForService, isQuoteExpired, pruneExpiredQuotes, sortQuotes, upsertQuote } from './_utils';\nimport {\n  QUOTER_DEFAULT_PRUNE_INTERVAL_MS,\n  QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS,\n  QUOTER_EMPTY_RETRY_BASE_DELAY_MS,\n  QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n} from './constants';\nimport { ServiceType, TokenType } from '../constants';\nimport { isNativeAsset } from '../type-guards';\nimport { isAddressEqual } from 'viem';\n\n/**\n * Function that returns the current UNIX time in seconds.\n * Injected for deterministic testing.\n */\nexport type Clock = () => number;\n\n/**\n * Options for constructing a Quoter instance.\n *\n * These options tune how often quote state is maintained and when services are\n * proactively restarted before quote expiry.\n */\nexport interface QuoterOptions {\n  /**\n   * Dangerously allows quotes where fromAddress and toAddress differ\n   * even when a service would otherwise require them to match.\n   *\n   * This applies to both same-chain and cross-chain quotes.\n   *\n   * This is intended for explicit proxy-recipient funding flows. By default,\n   * services preserve their existing address safety checks.\n   */\n  readonly dangerouslyAllowAddressMismatch?: boolean;\n  /** Clock function returning current time in seconds (defaults to Date.now()/1000). */\n  readonly clock?: Clock;\n  /** Interval for pruning expired quotes (milliseconds).\n   *\n   * @default 1_000\n   */\n  readonly pruneIntervalMs?: number;\n  /**\n   * Amount of seconds to pre-buffer a stream restart before the earliest service quote\n   * expiration. Helps ensure continuity before actual expiry is reached.\n   *\n   * @default 5\n   */\n  readonly refreshBufferSeconds?: number;\n}\n\n/**\n * Quoter orchestrates quote streaming across multiple transfer services and emits a unified event stream.\n *\n * High-level lifecycle:\n * - Idle until first subscriber.\n * - On first subscribe, starts all eligible services.\n * - Collects and ranks active quotes, pruning expired ones over time.\n * - Completes when explicitly unsubscribed (last subscriber), when no service is eligible,\n *   or when all eligible services finish without producing any quote (`no-quotes`).\n *\n * Event model:\n * - Service `quote` -> Quoter upserts quote, recomputes best quote, emits `quote`.\n * - Service `error` -> Quoter emits `error` (non-terminal by itself).\n * - Service `done` -> Quoter marks that service attempt as completed and evaluates retry/complete rules.\n *\n * Retry/refresh behavior:\n * - Refresh: services that have active quotes are restarted shortly before the earliest quote expires.\n * - Retry: services that complete with no quote and no error are only retried after the quoter has\n *   already observed at least one quote from any service in this session.\n *\n * This design keeps first-pass \"no quotes anywhere\" terminal and fast, while still allowing services\n * like Markr to be retried in sessions where other providers are returning quotes.\n */\nexport class Quoter implements QuoterInterface {\n  private readonly clock: Clock;\n  private readonly props: QuoterProps;\n  private readonly pruneIntervalMs: number;\n  private readonly serviceQuoteOptions: ServiceQuoteOptions;\n  private readonly transferServices: readonly TransferService[];\n  private readonly refreshBufferSeconds: number;\n\n  private quotes: Quote[] = [];\n  private subscribers: Set<QuoterEventHandler> = new Set();\n  private started = false;\n  private done = false;\n  private isStartingFromSubscribe = false;\n  private pruneTimerId: ReturnType<typeof setInterval> | null = null;\n  private lastBestId: string | null = null;\n  private hasReceivedAnyQuote = false;\n\n  public readonly id: string = crypto.randomUUID();\n\n  /**\n   * Per-service runtime state for the active quote session.\n   *\n   * This tracks whether a service has completed, errored, produced quotes,\n   * and any pending timers used for retry/refresh orchestration.\n   */\n  private serviceState: Map<\n    TransferService['type'],\n    {\n      cancel: () => void;\n      done: boolean;\n      hasErrored: boolean;\n      hasReturnedQuote: boolean;\n      retryAttempt: number;\n      retryTimer: ReturnType<typeof setTimeout> | null;\n      refreshTimer: ReturnType<typeof setTimeout> | null;\n      refreshAtSeconds: number | null;\n    }\n  > = new Map();\n\n  /**\n   * Create a new Quoter instance.\n   *\n   * @param props Quoting request parameters shared across all services.\n   * @param transferServices Candidate services; eligibility is resolved at `start()` time.\n   * @param options Optional runtime tuning for pruning and refresh behavior.\n   */\n  constructor(props: QuoterProps, transferServices: readonly TransferService[], options: QuoterOptions = {}) {\n    this.clock = options.clock ?? (() => Math.floor(Date.now() / 1_000));\n    this.props = props;\n    this.pruneIntervalMs = options.pruneIntervalMs ?? QUOTER_DEFAULT_PRUNE_INTERVAL_MS;\n    this.serviceQuoteOptions = {\n      dangerouslyAllowAddressMismatch: options.dangerouslyAllowAddressMismatch,\n    };\n    this.transferServices = transferServices;\n    this.refreshBufferSeconds = options.refreshBufferSeconds ?? QUOTER_DEFAULT_REFRESH_BUFFER_SECONDS;\n  }\n\n  /**\n   * Get the current best quote and all active quotes (sorted by desirability).\n   */\n  public getQuotes(): QuotesTuple {\n    const now = this.clock();\n    const active = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n    const sorted = sortQuotes(active);\n    const best = sorted[0] ?? null;\n\n    return [best, sorted];\n  }\n\n  /**\n   * Subscribe for quoter events.\n   *\n   * First subscriber lazily starts orchestration.\n   * Last subscriber triggers terminal completion with reason `unsubscribed`.\n   *\n   * @returns Unsubscribe function (idempotent).\n   */\n  public subscribe(handler: QuoterEventHandler): () => void {\n    this.subscribers.add(handler);\n    let unsubscribed = false;\n\n    if (!this.started) {\n      this.isStartingFromSubscribe = true;\n      try {\n        this.start();\n      } finally {\n        this.isStartingFromSubscribe = false;\n      }\n    }\n\n    return () => {\n      if (unsubscribed) {\n        return;\n      }\n      unsubscribed = true;\n\n      if (this.done) {\n        this.subscribers.delete(handler);\n        return;\n      }\n\n      const wasLastSubscriber = this.subscribers.size === 1 && this.subscribers.has(handler);\n      if (wasLastSubscriber) {\n        this.complete('unsubscribed');\n        return;\n      }\n\n      this.subscribers.delete(handler);\n    };\n  }\n\n  // ----- Internal orchestration -----\n\n  /**\n   * Start a fresh quote session.\n   *\n   * Resets session-local state, validates basic request viability,\n   * starts streams for eligible services, and begins prune ticks.\n   */\n  private start(): void {\n    this.started = true;\n    this.done = false;\n    this.quotes = [];\n    this.lastBestId = null;\n    this.hasReceivedAnyQuote = false;\n\n    // Same-chain quotes for the *same* asset are not a valid transfer scenario.\n    if (isInvalidSameChainQuoteRequest(this.props)) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    let hasEligibleService = false;\n\n    // Start streams for eligible services\n    for (const svc of this.transferServices) {\n      const eligible = svc.analyzeSupport({\n        sourceAsset: this.props.sourceAsset,\n        sourceChainId: this.props.sourceChain.chainId,\n        targetAsset: this.props.targetAsset,\n        targetChainId: this.props.targetChain.chainId,\n      });\n\n      if (!eligible) continue;\n      hasEligibleService = true;\n\n      this.startStreamForService(svc);\n    }\n\n    if (!hasEligibleService) {\n      this.complete('no-eligible-services');\n      return;\n    }\n\n    // Start periodic prune\n    this.pruneTimerId = setInterval(() => this.onPruneTick(), this.pruneIntervalMs);\n  }\n\n  /**\n   * Stop all streams and timers.\n   * Quotes are retained for snapshot access via getQuotes(), though they\n   * can still be pruned due to expiration.\n   */\n  private stop(): void {\n    this.started = false;\n\n    if (this.pruneTimerId) {\n      clearInterval(this.pruneTimerId);\n      this.pruneTimerId = null;\n    }\n\n    for (const [type, state] of this.serviceState) {\n      try {\n        state.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n      }\n\n      if (state.retryTimer) {\n        clearTimeout(state.retryTimer);\n      }\n\n      this.serviceState.set(type, {\n        cancel: () => {},\n        done: false,\n        hasErrored: false,\n        hasReturnedQuote: false,\n        retryAttempt: 0,\n        retryTimer: null,\n        refreshTimer: null,\n        refreshAtSeconds: null,\n      });\n    }\n  }\n\n  /**\n   * Begin or restart streaming for a specific service.\n   *\n   * Any previous stream/timers for that service are canceled before starting a new attempt.\n   */\n  private startStreamForService(svc: TransferService): void {\n    // Clean up any existing stream and refresh timer\n    const existing = this.serviceState.get(svc.type);\n\n    if (existing) {\n      try {\n        existing.cancel();\n      } catch {\n        /* ignore */\n      }\n\n      if (existing.refreshTimer) clearTimeout(existing.refreshTimer);\n      if (existing.retryTimer) clearTimeout(existing.retryTimer);\n    }\n\n    const handler = this.makeServiceHandler(svc.type);\n    const bufferedEvents: ServiceQuoteEventArgs[] = [];\n    let isStartingStream = true;\n\n    // Some services emit quote/done synchronously inside streamQuotes().\n    // If those events run before subscribe() returns, consumers can hit TDZ\n    // when they reference the returned unsubscribe function in their callback.\n    // Buffer startup emissions and flush them after stream initialization.\n    const guardedHandler: ServiceQuoteEventHandler = (...eventArgs) => {\n      if (isStartingStream) {\n        bufferedEvents.push(eventArgs);\n        return;\n      }\n\n      handler(...eventArgs);\n    };\n\n    const { cancel } = svc.streamQuotes(this.props, guardedHandler, this.serviceQuoteOptions);\n    isStartingStream = false;\n\n    if (bufferedEvents.length > 0) {\n      // Use a microtask so subscribe() can return before the first callback fires.\n      // This preserves event order while avoiding re-entrancy during subscription.\n      queueMicrotask(() => {\n        for (const bufferedEvent of bufferedEvents) {\n          handler(...bufferedEvent);\n        }\n      });\n    }\n\n    this.serviceState.set(svc.type, {\n      cancel,\n      done: false,\n      hasErrored: false,\n      hasReturnedQuote: false,\n      retryAttempt: existing?.retryAttempt ?? 0,\n      retryTimer: null,\n      refreshTimer: null,\n      refreshAtSeconds: null,\n    });\n  }\n\n  /**\n   * Create the service-scoped event handler consumed by `TransferService.streamQuotes`.\n   *\n   * The handler enforces service/quote consistency and translates service events into\n   * quoter state transitions.\n   */\n  private makeServiceHandler(serviceType: TransferService['type']): ServiceQuoteEventHandler {\n    return (event, ...args) => {\n      // Ignore any service events once stopped to prevent post-stop mutations.\n      if (!this.started) {\n        return;\n      }\n      if (event === 'quote') {\n        const maybeQuote = args[0];\n        if (isQuoteValue(maybeQuote)) {\n          // Enforce the quote belongs to the emitting service\n          if (maybeQuote.serviceType !== serviceType) {\n            // Ignore quotes mismatched to service; defensive\n            return;\n          }\n          const state = this.serviceState.get(serviceType);\n          if (state) {\n            state.hasReturnedQuote = true;\n          }\n          this.onIncomingQuote(maybeQuote);\n          this.scheduleServiceRefresh(serviceType);\n        }\n\n        return;\n      }\n      if (event === 'done') {\n        this.onServiceDone(serviceType);\n\n        return;\n      }\n      if (event === 'error') {\n        const state = this.serviceState.get(serviceType);\n        if (state) {\n          state.hasErrored = true;\n        }\n        const maybeErr = args[0];\n        if (maybeErr instanceof Error) {\n          this.emitError(maybeErr);\n        }\n      }\n    };\n  }\n\n  /**\n   * Handle an incoming quote event.\n   *\n   * Expired quotes are ignored. Valid quotes are upserted into active state,\n   * then sorted/pruned and emitted to subscribers.\n   */\n  private onIncomingQuote(quote: Quote): void {\n    const now = this.clock();\n\n    if (isQuoteExpired({ quote, nowSeconds: now })) {\n      return;\n    }\n\n    this.hasReceivedAnyQuote = true;\n\n    this.resetRetryForService(quote.serviceType);\n\n    this.quotes = sortQuotes(pruneExpiredQuotes({ quotes: upsertQuote(this.quotes, quote), nowSeconds: now }));\n\n    // Always emit on every incoming quote\n    const best = this.quotes[0];\n    if (best) {\n      this.lastBestId = best.id;\n      this.emitQuote({ bestQuote: best, quote, quotes: this.quotes });\n    }\n  }\n\n  private resetRetryForService(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.retryAttempt = 0;\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n  }\n\n  /**\n   * Schedule a retry attempt for a service using exponential backoff.\n   *\n   * This is used only for quote-less successful completions once the overall session\n   * has already produced at least one quote from some service.\n   */\n  private scheduleServiceRetry(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    if (state.retryTimer) {\n      clearTimeout(state.retryTimer);\n      state.retryTimer = null;\n    }\n\n    const delayMs = Math.min(\n      QUOTER_EMPTY_RETRY_MAX_DELAY_MS,\n      QUOTER_EMPTY_RETRY_BASE_DELAY_MS * 2 ** state.retryAttempt,\n    );\n    state.retryAttempt += 1;\n\n    state.retryTimer = setTimeout(\n      () => {\n        const current = this.serviceState.get(serviceType);\n        if (current) {\n          current.retryTimer = null;\n        }\n\n        if (!this.started) {\n          return;\n        }\n\n        const svc = this.transferServices.find((s) => s.type === serviceType);\n        if (svc) {\n          this.startStreamForService(svc);\n        }\n      },\n      Math.max(0, delayMs),\n    );\n  }\n\n  /**\n   * Handle service completion (`done`).\n   *\n   * A completion may schedule:\n   * - refresh (if the service has active quotes), and/or\n   * - retry (quote-less/non-error completion, but only after any quote has existed in session).\n   *\n   * Then evaluates whether the full quoter can complete with `no-quotes`.\n   */\n  private onServiceDone(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) {\n      return;\n    }\n\n    state.done = true;\n    this.scheduleServiceRefresh(serviceType);\n\n    if (this.hasReceivedAnyQuote && !state.hasErrored && !state.hasReturnedQuote) {\n      this.scheduleServiceRetry(serviceType);\n    }\n\n    this.maybeCompleteNoQuotes();\n  }\n\n  /**\n   * Complete with `no-quotes` when every eligible service has finished and\n   * no quote was ever observed during this session.\n   */\n  private maybeCompleteNoQuotes(): void {\n    if (!this.started || this.done || this.hasReceivedAnyQuote || this.serviceState.size === 0) {\n      return;\n    }\n\n    const allServicesDone = [...this.serviceState.values()].every((state) => state.done);\n\n    if (allServicesDone) {\n      this.complete('no-quotes');\n    }\n  }\n\n  /**\n   * Finalize the quoter session and broadcast terminal reason exactly once.\n   */\n  private complete(reason: QuoterDoneReason): void {\n    if (this.done) {\n      return;\n    }\n\n    const payload = this.makeDonePayload(reason);\n\n    this.done = true;\n    this.stop();\n\n    // When complete() happens during subscribe()->start(), emit done on a microtask\n    // so callers can safely reference the returned unsubscribe in their handler.\n    if (this.isStartingFromSubscribe) {\n      queueMicrotask(() => {\n        const handlers = [...this.subscribers];\n        this.subscribers.clear();\n\n        for (const handler of handlers) {\n          handler('done', payload);\n        }\n      });\n      return;\n    }\n\n    const handlers = [...this.subscribers];\n    this.subscribers.clear();\n\n    for (const handler of handlers) {\n      handler('done', payload);\n    }\n  }\n\n  private getInitializedServices(): ServiceType[] {\n    return [...new Set(this.transferServices.map((service) => service.type))];\n  }\n\n  private getEligibleServices(): ServiceType[] {\n    return [...this.serviceState.keys()];\n  }\n\n  private makeDonePayload(reason: QuoterDoneReason): QuoterDonePayload {\n    if (reason === 'unsubscribed') {\n      return { reason, data: undefined };\n    }\n\n    const initializedServices = this.getInitializedServices();\n\n    if (reason === 'no-eligible-services') {\n      return {\n        reason,\n        data: {\n          initializedServices,\n          quoterProps: this.props,\n        },\n      };\n    }\n\n    return {\n      reason,\n      data: {\n        eligibleServices: this.getEligibleServices(),\n        initializedServices,\n        quoterProps: this.props,\n      },\n    };\n  }\n\n  /** Periodic prune tick to evict expired quotes and emit best changes. */\n  private onPruneTick(): void {\n    const now = this.clock();\n    const pruned = pruneExpiredQuotes({ quotes: this.quotes, nowSeconds: now });\n\n    if (pruned.length !== this.quotes.length) {\n      this.quotes = sortQuotes(pruned);\n      const best = this.quotes[0] ?? null;\n      const bestId = best ? best.id : null;\n\n      if (best && bestId !== this.lastBestId) {\n        this.lastBestId = bestId;\n        this.emitQuote({ bestQuote: best, quote: best, quotes: this.quotes });\n      } else if (!best) {\n        this.lastBestId = null;\n      }\n    }\n\n    // Re-evaluate refresh scheduling for all services on prune tick\n    for (const svc of this.transferServices) {\n      if (this.serviceState.has(svc.type)) {\n        this.scheduleServiceRefresh(svc.type);\n      }\n    }\n  }\n\n  /** Schedule a refresh (restart) of streaming for the service at its earliest quote expiration. */\n  private scheduleServiceRefresh(serviceType: TransferService['type']): void {\n    const state = this.serviceState.get(serviceType);\n\n    if (!state) return;\n\n    const now = this.clock();\n    const earliest = earliestExpirationForService({ quotes: this.quotes, serviceType, nowSeconds: now });\n\n    if (earliest === null) {\n      // No quotes -> clear any pending refresh\n      if (state.refreshTimer) {\n        clearTimeout(state.refreshTimer);\n        state.refreshTimer = null;\n      }\n      state.refreshAtSeconds = null;\n      return;\n    }\n\n    // Only reschedule if earlier than currently scheduled or no timer\n    const targetAt = Math.max(0, earliest - this.refreshBufferSeconds);\n\n    // If target time has already passed, do not schedule another refresh here.\n    if (targetAt <= now) {\n      return;\n    }\n\n    // Reschedule only when the desired refresh time changes (earlier OR later).\n    // We key refresh off the soonest-expiring active quote for this service.\n    if (state.refreshAtSeconds === targetAt && state.refreshTimer) {\n      return;\n    }\n\n    if (state.refreshTimer) {\n      clearTimeout(state.refreshTimer);\n    }\n\n    const delayMs = Math.max(0, (targetAt - now) * 1_000);\n    state.refreshAtSeconds = targetAt;\n    state.refreshTimer = setTimeout(() => {\n      // Clear timer/marker before restarting to avoid stale state if restart fails.\n      const current = this.serviceState.get(serviceType);\n      if (current) {\n        current.refreshTimer = null;\n        current.refreshAtSeconds = null;\n      }\n\n      // Restart stream and clear timer/marker\n      const svc = this.transferServices.find((s) => s.type === serviceType);\n\n      if (svc) {\n        this.startStreamForService(svc);\n      }\n    }, delayMs);\n  }\n\n  // ----- Emission helpers -----\n  /** Emit a quote event to all subscribers. */\n  private emitQuote(payload: { bestQuote: Quote; quote: Quote; quotes: readonly Quote[] }): void {\n    for (const handler of this.subscribers) {\n      handler('quote', payload);\n    }\n  }\n\n  /** Emit an error event to all subscribers. */\n  private emitError(error: Error): void {\n    for (const handler of this.subscribers) {\n      handler('error', error);\n    }\n  }\n}\n\n/**\n * Zod schema to validate the minimal Quote fields used for runtime gating.\n *\n * This is a simple schema, and is not a fully safe runtime validate for Quote.\n * That isn't necessary here since we only need to verify basic structure before\n * using the quote in internal logic.\n *\n * @internal\n */\nconst QuoteSchema = z.object({\n  id: z.string(),\n  expiresAt: z.number().int().nonnegative(),\n  amountOut: z.bigint().nonnegative(),\n  amountIn: z.bigint().nonnegative(),\n  serviceType: z.string(),\n});\n\nfunction isInvalidSameChainQuoteRequest(props: QuoterProps): boolean {\n  const { sourceAsset, sourceChain, targetAsset, targetChain } = props;\n\n  if (sourceChain.chainId !== targetChain.chainId) {\n    return false;\n  }\n\n  // Native -> native on the same chain is a no-op.\n  if (isNativeAsset(sourceAsset) && isNativeAsset(targetAsset)) {\n    return true;\n  }\n\n  // If token types differ, it's potentially a swap on the same chain.\n  if (sourceAsset.type !== targetAsset.type) {\n    return false;\n  }\n\n  // Same token type and address on the same chain is a no-op.\n  if (sourceAsset.type === TokenType.ERC20 && targetAsset.type === TokenType.ERC20) {\n    return isAddressEqual(sourceAsset.address, targetAsset.address);\n  }\n\n  if (sourceAsset.type === TokenType.SPL && targetAsset.type === TokenType.SPL) {\n    return sourceAsset.address === targetAsset.address;\n  }\n\n  return false;\n}\n\nfunction isQuoteValue(value: unknown): value is Quote {\n  const result = QuoteSchema.safeParse(value);\n\n  return result.success;\n}\n"],"mappings":"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"}

package/dist/transfer-service/markr/_handlers/stream-quotes.cjs

@@ -1,2 +1,2 @@
-const e=require(`../../../errors.cjs`),t=require(`../../../utils/caip.cjs`),n=require(`../../../_utils/chain.cjs`),r=require(`../../../utils/evm-address.cjs`),i=require(`../_api.cjs`),a=require(`../../../utils/sol-address.cjs`),o=require(`../_utils.cjs`);function s({apiOptions:e,appId:r,partnerFeeBps:a}){return(s,l,u)=>{let d=new AbortController,{userEvmAddress:f,userSolanaAddress:p,validationError:m}=c(s,u);return m?(l(`error`,m),l(`done`),{cancel:()=>{}}):(i.markrStreamQuote(e,{amount:s.amount.toString(),aggregator:s.aggregator,appId:r,chainId:n.isEvmNamespace(s.sourceChain.chainId)?t.caip2ToEip155ChainId(s.sourceChain.chainId):s.sourceChain.chainId,destinationChainId:s.sourceChain.chainId===s.targetChain.chainId?void 0:n.isEvmNamespace(s.targetChain.chainId)?t.caip2ToEip155ChainId(s.targetChain.chainId):s.targetChain.chainId,slippage:s.slippageBps,tokenIn:o.assetToAddressString(s.sourceAsset,s.sourceChain.chainId),tokenInDecimals:s.sourceAsset.decimals,tokenOut:o.assetToAddressString(s.targetAsset,s.targetChain.chainId),tokenOutDecimals:s.targetAsset.decimals,userEvmAddress:f,userSolanaAddress:p},{onDone:()=>{d.signal.aborted||l(`done`)},onError:e=>{d.signal.aborted||(l(`error`,e),l(`done`))},onQuote:e=>{d.signal.aborted||l(`quote`,o.quoteFromMarkrQuoteResponseData(e,s,a))},signal:d.signal}),{cancel:()=>{d.abort()}})}}function c(t,i){let o=t.sourceChain.chainId!==t.targetChain.chainId,s=n.isEvmNamespace(t.sourceChain.chainId),c=n.isEvmNamespace(t.targetChain.chainId),l=n.isSolanaNamespace(t.sourceChain.chainId),u=n.isSolanaNamespace(t.targetChain.chainId);return s&&!r.isEvmAddress(t.fromAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new e.InvalidParamsError(e.ErrorReason.INVALID_PARAMS,`Invalid fromAddress for EVM source chain.`)}:c&&!r.isEvmAddress(t.toAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new e.InvalidParamsError(e.ErrorReason.INVALID_PARAMS,`Invalid toAddress for EVM target chain.`)}:l&&!a.isSolAddress(t.fromAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new e.InvalidParamsError(e.ErrorReason.INVALID_PARAMS,`Invalid fromAddress for Solana source chain.`)}:u&&!a.isSolAddress(t.toAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new e.InvalidParamsError(e.ErrorReason.INVALID_PARAMS,`Invalid toAddress for Solana target chain.`)}:o&&(s&&c||l&&u)&&!i?.dangerouslyAllowAddressMismatch&&t.fromAddress!==t.toAddress?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new e.InvalidParamsError(e.ErrorReason.INVALID_PARAMS,`fromAddress and toAddress must match for same-namespace cross-chain swaps.`)}:o?{userEvmAddress:c&&r.isEvmAddress(t.toAddress)?t.toAddress:s&&r.isEvmAddress(t.fromAddress)?t.fromAddress:void 0,userSolanaAddress:u&&a.isSolAddress(t.toAddress)?t.toAddress:l&&a.isSolAddress(t.fromAddress)?t.fromAddress:void 0}:t.fromAddress===t.toAddress?{userEvmAddress:void 0,userSolanaAddress:void 0}:{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new e.InvalidParamsError(e.ErrorReason.INVALID_PARAMS,`fromAddress and toAddress must match for same-chain swaps.`)}}exports.streamQuotesFactory=s;
+const e=require(`../../../errors.cjs`),t=require(`../../../utils/caip.cjs`),n=require(`../../../_utils/chain.cjs`),r=require(`../../../utils/evm-address.cjs`),i=require(`../_api.cjs`),a=require(`../../../utils/sol-address.cjs`),o=require(`../_utils.cjs`);function s({apiOptions:e,appId:r,partnerFeeBps:a}){return(s,l,u)=>{let d=new AbortController,{userEvmAddress:f,userSolanaAddress:p,validationError:m}=c(s,u);return m?(l(`error`,m),l(`done`),{cancel:()=>{}}):(i.markrStreamQuote(e,{amount:s.amount.toString(),aggregator:s.aggregator,appId:r,chainId:n.isEvmNamespace(s.sourceChain.chainId)?t.caip2ToEip155ChainId(s.sourceChain.chainId):s.sourceChain.chainId,destinationChainId:s.sourceChain.chainId===s.targetChain.chainId?void 0:n.isEvmNamespace(s.targetChain.chainId)?t.caip2ToEip155ChainId(s.targetChain.chainId):s.targetChain.chainId,slippage:s.slippageBps,tokenIn:o.assetToAddressString(s.sourceAsset,s.sourceChain.chainId),tokenInDecimals:s.sourceAsset.decimals,tokenOut:o.assetToAddressString(s.targetAsset,s.targetChain.chainId),tokenOutDecimals:s.targetAsset.decimals,userEvmAddress:f,userSolanaAddress:p},{onDone:()=>{d.signal.aborted||l(`done`)},onError:e=>{d.signal.aborted||(l(`error`,e),l(`done`))},onQuote:e=>{d.signal.aborted||l(`quote`,o.quoteFromMarkrQuoteResponseData(e,s,a))},signal:d.signal}),{cancel:()=>{d.abort()}})}}function c(t,i){let o=t.sourceChain.chainId!==t.targetChain.chainId,s=!o,c=n.isEvmNamespace(t.sourceChain.chainId),l=n.isEvmNamespace(t.targetChain.chainId),u=n.isSolanaNamespace(t.sourceChain.chainId),d=n.isSolanaNamespace(t.targetChain.chainId),f=i?.dangerouslyAllowAddressMismatch===!0,p=t.fromAddress!==t.toAddress,m=t=>({userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new e.InvalidParamsError(e.ErrorReason.INVALID_PARAMS,t)});if(c&&!r.isEvmAddress(t.fromAddress))return m(`Invalid fromAddress for EVM source chain.`);if(l&&!r.isEvmAddress(t.toAddress))return m(`Invalid toAddress for EVM target chain.`);if(u&&!a.isSolAddress(t.fromAddress))return m(`Invalid fromAddress for Solana source chain.`);if(d&&!a.isSolAddress(t.toAddress))return m(`Invalid toAddress for Solana target chain.`);if(o&&(c&&l||u&&d)&&p&&!f)return m(`fromAddress and toAddress must match for same-namespace cross-chain swaps.`);if(s){if(p&&!f)return m(`fromAddress and toAddress must match for same-chain swaps.`);if(!f)return{userEvmAddress:void 0,userSolanaAddress:void 0}}return{userEvmAddress:l&&r.isEvmAddress(t.toAddress)?t.toAddress:c&&r.isEvmAddress(t.fromAddress)?t.fromAddress:void 0,userSolanaAddress:d&&a.isSolAddress(t.toAddress)?t.toAddress:u&&a.isSolAddress(t.fromAddress)?t.fromAddress:void 0}}exports.streamQuotesFactory=s;
 //# sourceMappingURL=stream-quotes.cjs.map

package/dist/transfer-service/markr/_handlers/stream-quotes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"stream-quotes.cjs","names":["markrStreamQuote","isEvmNamespace","caip2ToEip155ChainId","assetToAddressString","quoteFromMarkrQuoteResponseData","isSolanaNamespace","isEvmAddress","InvalidParamsError","ErrorReason","isSolAddress"],"sources":["../../../../src/transfer-service/markr/_handlers/stream-quotes.ts"],"sourcesContent":["import { caip2ToEip155ChainId } from '../../../utils/caip';\nimport type { ServiceQuoteOptions, TransferService } from '../../../types/service';\nimport { markrStreamQuote, type ApiOptions, type MarkrStreamQuoteParams } from '../_api';\nimport { assetToAddressString, quoteFromMarkrQuoteResponseData } from '../_utils';\nimport { isEvmNamespace, isSolanaNamespace } from '../../../_utils/chain';\nimport { isEvmAddress } from '../../../utils/evm-address';\nimport { isSolAddress } from '../../../utils/sol-address';\nimport { ErrorReason, InvalidParamsError } from '../../../errors';\n\nexport interface StreamQuotesFactoryConfig {\n  apiOptions: ApiOptions;\n  appId: string;\n  partnerFeeBps: number;\n}\n\nexport function streamQuotesFactory({\n  apiOptions,\n  appId,\n  partnerFeeBps,\n}: StreamQuotesFactoryConfig): TransferService['streamQuotes'] {\n  return (props, handler, options) => {\n    const ac = new AbortController();\n    const { userEvmAddress, userSolanaAddress, validationError } = _validateAndGetUserAddresses(props, options);\n\n    if (validationError) {\n      handler('error', validationError);\n      handler('done');\n\n      return {\n        cancel: () => {},\n      };\n    }\n\n    void markrStreamQuote(\n      apiOptions,\n      {\n        amount: props.amount.toString(),\n        // Forwarded only when the caller pins one; otherwise Markr races every aggregator.\n        aggregator: props.aggregator,\n        appId,\n        chainId: isEvmNamespace(props.sourceChain.chainId)\n          ? caip2ToEip155ChainId(props.sourceChain.chainId)\n          : props.sourceChain.chainId,\n        // For cross-chain requests, destinationChainId is required.\n        // Use EVM numeric chain IDs for EVM targets and CAIP-2 IDs for non-EVM targets.\n        destinationChainId:\n          props.sourceChain.chainId !== props.targetChain.chainId\n            ? isEvmNamespace(props.targetChain.chainId)\n              ? caip2ToEip155ChainId(props.targetChain.chainId)\n              : props.targetChain.chainId\n            : undefined,\n        slippage: props.slippageBps,\n        tokenIn: assetToAddressString(props.sourceAsset, props.sourceChain.chainId),\n        tokenInDecimals: props.sourceAsset.decimals,\n        tokenOut: assetToAddressString(props.targetAsset, props.targetChain.chainId),\n        tokenOutDecimals: props.targetAsset.decimals,\n        userEvmAddress,\n        userSolanaAddress,\n      },\n      {\n        onDone: () => {\n          if (!ac.signal.aborted) {\n            handler('done');\n          }\n        },\n        onError: (error) => {\n          if (!ac.signal.aborted) {\n            handler('error', error);\n            handler('done');\n          }\n        },\n        onQuote: (data) => {\n          if (!ac.signal.aborted) {\n            handler('quote', quoteFromMarkrQuoteResponseData(data, props, partnerFeeBps));\n          }\n        },\n        signal: ac.signal,\n      },\n    );\n\n    return {\n      cancel: () => {\n        ac.abort();\n      },\n    };\n  };\n}\n\nexport function _validateAndGetUserAddresses(\n  props: Parameters<TransferService['streamQuotes']>[0],\n  options?: ServiceQuoteOptions,\n): Pick<MarkrStreamQuoteParams, 'userEvmAddress' | 'userSolanaAddress'> & { validationError?: InvalidParamsError } {\n  const isCrossChainSwap = props.sourceChain.chainId !== props.targetChain.chainId;\n  const sourceIsEvm = isEvmNamespace(props.sourceChain.chainId);\n  const targetIsEvm = isEvmNamespace(props.targetChain.chainId);\n  const sourceIsSolana = isSolanaNamespace(props.sourceChain.chainId);\n  const targetIsSolana = isSolanaNamespace(props.targetChain.chainId);\n\n  if (sourceIsEvm && !isEvmAddress(props.fromAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, 'Invalid fromAddress for EVM source chain.'),\n    };\n  }\n\n  if (targetIsEvm && !isEvmAddress(props.toAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, 'Invalid toAddress for EVM target chain.'),\n    };\n  }\n\n  if (sourceIsSolana && !isSolAddress(props.fromAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(\n        ErrorReason.INVALID_PARAMS,\n        'Invalid fromAddress for Solana source chain.',\n      ),\n    };\n  }\n\n  if (targetIsSolana && !isSolAddress(props.toAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, 'Invalid toAddress for Solana target chain.'),\n    };\n  }\n\n  if (\n    isCrossChainSwap &&\n    ((sourceIsEvm && targetIsEvm) || (sourceIsSolana && targetIsSolana)) &&\n    !options?.dangerouslyAllowAddressMismatch\n  ) {\n    if (props.fromAddress !== props.toAddress) {\n      return {\n        userEvmAddress: undefined,\n        userSolanaAddress: undefined,\n        validationError: new InvalidParamsError(\n          ErrorReason.INVALID_PARAMS,\n          'fromAddress and toAddress must match for same-namespace cross-chain swaps.',\n        ),\n      };\n    }\n  }\n\n  if (!isCrossChainSwap) {\n    if (props.fromAddress !== props.toAddress) {\n      return {\n        userEvmAddress: undefined,\n        userSolanaAddress: undefined,\n        validationError: new InvalidParamsError(\n          ErrorReason.INVALID_PARAMS,\n          'fromAddress and toAddress must match for same-chain swaps.',\n        ),\n      };\n    }\n\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n    };\n  }\n\n  const userEvmAddress =\n    targetIsEvm && isEvmAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsEvm && isEvmAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  const userSolanaAddress =\n    targetIsSolana && isSolAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsSolana && isSolAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  return {\n    userEvmAddress,\n    userSolanaAddress,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"stream-quotes.cjs","names":["markrStreamQuote","isEvmNamespace","caip2ToEip155ChainId","assetToAddressString","quoteFromMarkrQuoteResponseData","isSolanaNamespace","InvalidParamsError","ErrorReason","isEvmAddress","isSolAddress"],"sources":["../../../../src/transfer-service/markr/_handlers/stream-quotes.ts"],"sourcesContent":["import { caip2ToEip155ChainId } from '../../../utils/caip';\nimport type { ServiceQuoteOptions, TransferService } from '../../../types/service';\nimport { markrStreamQuote, type ApiOptions, type MarkrStreamQuoteParams } from '../_api';\nimport { assetToAddressString, quoteFromMarkrQuoteResponseData } from '../_utils';\nimport { isEvmNamespace, isSolanaNamespace } from '../../../_utils/chain';\nimport { isEvmAddress } from '../../../utils/evm-address';\nimport { isSolAddress } from '../../../utils/sol-address';\nimport { ErrorReason, InvalidParamsError } from '../../../errors';\n\nexport interface StreamQuotesFactoryConfig {\n  apiOptions: ApiOptions;\n  appId: string;\n  partnerFeeBps: number;\n}\n\nexport function streamQuotesFactory({\n  apiOptions,\n  appId,\n  partnerFeeBps,\n}: StreamQuotesFactoryConfig): TransferService['streamQuotes'] {\n  return (props, handler, options) => {\n    const ac = new AbortController();\n    const { userEvmAddress, userSolanaAddress, validationError } = _validateAndGetUserAddresses(props, options);\n\n    if (validationError) {\n      handler('error', validationError);\n      handler('done');\n\n      return {\n        cancel: () => {},\n      };\n    }\n\n    void markrStreamQuote(\n      apiOptions,\n      {\n        amount: props.amount.toString(),\n        // Forwarded only when the caller pins one; otherwise Markr races every aggregator.\n        aggregator: props.aggregator,\n        appId,\n        chainId: isEvmNamespace(props.sourceChain.chainId)\n          ? caip2ToEip155ChainId(props.sourceChain.chainId)\n          : props.sourceChain.chainId,\n        // For cross-chain requests, destinationChainId is required.\n        // Use EVM numeric chain IDs for EVM targets and CAIP-2 IDs for non-EVM targets.\n        destinationChainId:\n          props.sourceChain.chainId !== props.targetChain.chainId\n            ? isEvmNamespace(props.targetChain.chainId)\n              ? caip2ToEip155ChainId(props.targetChain.chainId)\n              : props.targetChain.chainId\n            : undefined,\n        slippage: props.slippageBps,\n        tokenIn: assetToAddressString(props.sourceAsset, props.sourceChain.chainId),\n        tokenInDecimals: props.sourceAsset.decimals,\n        tokenOut: assetToAddressString(props.targetAsset, props.targetChain.chainId),\n        tokenOutDecimals: props.targetAsset.decimals,\n        userEvmAddress,\n        userSolanaAddress,\n      },\n      {\n        onDone: () => {\n          if (!ac.signal.aborted) {\n            handler('done');\n          }\n        },\n        onError: (error) => {\n          if (!ac.signal.aborted) {\n            handler('error', error);\n            handler('done');\n          }\n        },\n        onQuote: (data) => {\n          if (!ac.signal.aborted) {\n            handler('quote', quoteFromMarkrQuoteResponseData(data, props, partnerFeeBps));\n          }\n        },\n        signal: ac.signal,\n      },\n    );\n\n    return {\n      cancel: () => {\n        ac.abort();\n      },\n    };\n  };\n}\n\nexport function _validateAndGetUserAddresses(\n  props: Parameters<TransferService['streamQuotes']>[0],\n  options?: ServiceQuoteOptions,\n): Pick<MarkrStreamQuoteParams, 'userEvmAddress' | 'userSolanaAddress'> & { validationError?: InvalidParamsError } {\n  const isCrossChainSwap = props.sourceChain.chainId !== props.targetChain.chainId;\n  const isSameChainSwap = !isCrossChainSwap;\n  const sourceIsEvm = isEvmNamespace(props.sourceChain.chainId);\n  const targetIsEvm = isEvmNamespace(props.targetChain.chainId);\n  const sourceIsSolana = isSolanaNamespace(props.sourceChain.chainId);\n  const targetIsSolana = isSolanaNamespace(props.targetChain.chainId);\n  const dangerouslyAllowAddressMismatch = options?.dangerouslyAllowAddressMismatch === true;\n  const addressesMismatch = props.fromAddress !== props.toAddress;\n\n  const invalidParams = (details: string) => ({\n    userEvmAddress: undefined,\n    userSolanaAddress: undefined,\n    validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, details),\n  });\n\n  if (sourceIsEvm && !isEvmAddress(props.fromAddress)) {\n    return invalidParams('Invalid fromAddress for EVM source chain.');\n  }\n\n  if (targetIsEvm && !isEvmAddress(props.toAddress)) {\n    return invalidParams('Invalid toAddress for EVM target chain.');\n  }\n\n  if (sourceIsSolana && !isSolAddress(props.fromAddress)) {\n    return invalidParams('Invalid fromAddress for Solana source chain.');\n  }\n\n  if (targetIsSolana && !isSolAddress(props.toAddress)) {\n    return invalidParams('Invalid toAddress for Solana target chain.');\n  }\n\n  const isSameNamespaceCrossChainSwap =\n    isCrossChainSwap && ((sourceIsEvm && targetIsEvm) || (sourceIsSolana && targetIsSolana));\n\n  if (isSameNamespaceCrossChainSwap && addressesMismatch && !dangerouslyAllowAddressMismatch) {\n    return invalidParams('fromAddress and toAddress must match for same-namespace cross-chain swaps.');\n  }\n\n  if (isSameChainSwap) {\n    if (addressesMismatch && !dangerouslyAllowAddressMismatch) {\n      return invalidParams('fromAddress and toAddress must match for same-chain swaps.');\n    }\n\n    if (!dangerouslyAllowAddressMismatch) {\n      return {\n        userEvmAddress: undefined,\n        userSolanaAddress: undefined,\n      };\n    }\n  }\n\n  const userEvmAddress =\n    targetIsEvm && isEvmAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsEvm && isEvmAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  const userSolanaAddress =\n    targetIsSolana && isSolAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsSolana && isSolAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  return {\n    userEvmAddress,\n    userSolanaAddress,\n  };\n}\n"],"mappings":"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"}

package/dist/transfer-service/markr/_handlers/stream-quotes.js

@@ -1,2 +1,2 @@
-import{ErrorReason as e,InvalidParamsError as t}from"../../../errors.js";import{caip2ToEip155ChainId as n}from"../../../utils/caip.js";import{isEvmNamespace as r,isSolanaNamespace as i}from"../../../_utils/chain.js";import{isEvmAddress as a}from"../../../utils/evm-address.js";import{markrStreamQuote as o}from"../_api.js";import{isSolAddress as s}from"../../../utils/sol-address.js";import{assetToAddressString as c,quoteFromMarkrQuoteResponseData as l}from"../_utils.js";function u({apiOptions:e,appId:t,partnerFeeBps:i}){return(a,s,u)=>{let f=new AbortController,{userEvmAddress:p,userSolanaAddress:m,validationError:h}=d(a,u);return h?(s(`error`,h),s(`done`),{cancel:()=>{}}):(o(e,{amount:a.amount.toString(),aggregator:a.aggregator,appId:t,chainId:r(a.sourceChain.chainId)?n(a.sourceChain.chainId):a.sourceChain.chainId,destinationChainId:a.sourceChain.chainId===a.targetChain.chainId?void 0:r(a.targetChain.chainId)?n(a.targetChain.chainId):a.targetChain.chainId,slippage:a.slippageBps,tokenIn:c(a.sourceAsset,a.sourceChain.chainId),tokenInDecimals:a.sourceAsset.decimals,tokenOut:c(a.targetAsset,a.targetChain.chainId),tokenOutDecimals:a.targetAsset.decimals,userEvmAddress:p,userSolanaAddress:m},{onDone:()=>{f.signal.aborted||s(`done`)},onError:e=>{f.signal.aborted||(s(`error`,e),s(`done`))},onQuote:e=>{f.signal.aborted||s(`quote`,l(e,a,i))},signal:f.signal}),{cancel:()=>{f.abort()}})}}function d(n,o){let c=n.sourceChain.chainId!==n.targetChain.chainId,l=r(n.sourceChain.chainId),u=r(n.targetChain.chainId),d=i(n.sourceChain.chainId),f=i(n.targetChain.chainId);return l&&!a(n.fromAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new t(e.INVALID_PARAMS,`Invalid fromAddress for EVM source chain.`)}:u&&!a(n.toAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new t(e.INVALID_PARAMS,`Invalid toAddress for EVM target chain.`)}:d&&!s(n.fromAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new t(e.INVALID_PARAMS,`Invalid fromAddress for Solana source chain.`)}:f&&!s(n.toAddress)?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new t(e.INVALID_PARAMS,`Invalid toAddress for Solana target chain.`)}:c&&(l&&u||d&&f)&&!o?.dangerouslyAllowAddressMismatch&&n.fromAddress!==n.toAddress?{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new t(e.INVALID_PARAMS,`fromAddress and toAddress must match for same-namespace cross-chain swaps.`)}:c?{userEvmAddress:u&&a(n.toAddress)?n.toAddress:l&&a(n.fromAddress)?n.fromAddress:void 0,userSolanaAddress:f&&s(n.toAddress)?n.toAddress:d&&s(n.fromAddress)?n.fromAddress:void 0}:n.fromAddress===n.toAddress?{userEvmAddress:void 0,userSolanaAddress:void 0}:{userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new t(e.INVALID_PARAMS,`fromAddress and toAddress must match for same-chain swaps.`)}}export{u as streamQuotesFactory};
+import{ErrorReason as e,InvalidParamsError as t}from"../../../errors.js";import{caip2ToEip155ChainId as n}from"../../../utils/caip.js";import{isEvmNamespace as r,isSolanaNamespace as i}from"../../../_utils/chain.js";import{isEvmAddress as a}from"../../../utils/evm-address.js";import{markrStreamQuote as o}from"../_api.js";import{isSolAddress as s}from"../../../utils/sol-address.js";import{assetToAddressString as c,quoteFromMarkrQuoteResponseData as l}from"../_utils.js";function u({apiOptions:e,appId:t,partnerFeeBps:i}){return(a,s,u)=>{let f=new AbortController,{userEvmAddress:p,userSolanaAddress:m,validationError:h}=d(a,u);return h?(s(`error`,h),s(`done`),{cancel:()=>{}}):(o(e,{amount:a.amount.toString(),aggregator:a.aggregator,appId:t,chainId:r(a.sourceChain.chainId)?n(a.sourceChain.chainId):a.sourceChain.chainId,destinationChainId:a.sourceChain.chainId===a.targetChain.chainId?void 0:r(a.targetChain.chainId)?n(a.targetChain.chainId):a.targetChain.chainId,slippage:a.slippageBps,tokenIn:c(a.sourceAsset,a.sourceChain.chainId),tokenInDecimals:a.sourceAsset.decimals,tokenOut:c(a.targetAsset,a.targetChain.chainId),tokenOutDecimals:a.targetAsset.decimals,userEvmAddress:p,userSolanaAddress:m},{onDone:()=>{f.signal.aborted||s(`done`)},onError:e=>{f.signal.aborted||(s(`error`,e),s(`done`))},onQuote:e=>{f.signal.aborted||s(`quote`,l(e,a,i))},signal:f.signal}),{cancel:()=>{f.abort()}})}}function d(n,o){let c=n.sourceChain.chainId!==n.targetChain.chainId,l=!c,u=r(n.sourceChain.chainId),d=r(n.targetChain.chainId),f=i(n.sourceChain.chainId),p=i(n.targetChain.chainId),m=o?.dangerouslyAllowAddressMismatch===!0,h=n.fromAddress!==n.toAddress,g=n=>({userEvmAddress:void 0,userSolanaAddress:void 0,validationError:new t(e.INVALID_PARAMS,n)});if(u&&!a(n.fromAddress))return g(`Invalid fromAddress for EVM source chain.`);if(d&&!a(n.toAddress))return g(`Invalid toAddress for EVM target chain.`);if(f&&!s(n.fromAddress))return g(`Invalid fromAddress for Solana source chain.`);if(p&&!s(n.toAddress))return g(`Invalid toAddress for Solana target chain.`);if(c&&(u&&d||f&&p)&&h&&!m)return g(`fromAddress and toAddress must match for same-namespace cross-chain swaps.`);if(l){if(h&&!m)return g(`fromAddress and toAddress must match for same-chain swaps.`);if(!m)return{userEvmAddress:void 0,userSolanaAddress:void 0}}return{userEvmAddress:d&&a(n.toAddress)?n.toAddress:u&&a(n.fromAddress)?n.fromAddress:void 0,userSolanaAddress:p&&s(n.toAddress)?n.toAddress:f&&s(n.fromAddress)?n.fromAddress:void 0}}export{u as streamQuotesFactory};
 //# sourceMappingURL=stream-quotes.js.map

package/dist/transfer-service/markr/_handlers/stream-quotes.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-quotes.js","names":[],"sources":["../../../../src/transfer-service/markr/_handlers/stream-quotes.ts"],"sourcesContent":["import { caip2ToEip155ChainId } from '../../../utils/caip';\nimport type { ServiceQuoteOptions, TransferService } from '../../../types/service';\nimport { markrStreamQuote, type ApiOptions, type MarkrStreamQuoteParams } from '../_api';\nimport { assetToAddressString, quoteFromMarkrQuoteResponseData } from '../_utils';\nimport { isEvmNamespace, isSolanaNamespace } from '../../../_utils/chain';\nimport { isEvmAddress } from '../../../utils/evm-address';\nimport { isSolAddress } from '../../../utils/sol-address';\nimport { ErrorReason, InvalidParamsError } from '../../../errors';\n\nexport interface StreamQuotesFactoryConfig {\n  apiOptions: ApiOptions;\n  appId: string;\n  partnerFeeBps: number;\n}\n\nexport function streamQuotesFactory({\n  apiOptions,\n  appId,\n  partnerFeeBps,\n}: StreamQuotesFactoryConfig): TransferService['streamQuotes'] {\n  return (props, handler, options) => {\n    const ac = new AbortController();\n    const { userEvmAddress, userSolanaAddress, validationError } = _validateAndGetUserAddresses(props, options);\n\n    if (validationError) {\n      handler('error', validationError);\n      handler('done');\n\n      return {\n        cancel: () => {},\n      };\n    }\n\n    void markrStreamQuote(\n      apiOptions,\n      {\n        amount: props.amount.toString(),\n        // Forwarded only when the caller pins one; otherwise Markr races every aggregator.\n        aggregator: props.aggregator,\n        appId,\n        chainId: isEvmNamespace(props.sourceChain.chainId)\n          ? caip2ToEip155ChainId(props.sourceChain.chainId)\n          : props.sourceChain.chainId,\n        // For cross-chain requests, destinationChainId is required.\n        // Use EVM numeric chain IDs for EVM targets and CAIP-2 IDs for non-EVM targets.\n        destinationChainId:\n          props.sourceChain.chainId !== props.targetChain.chainId\n            ? isEvmNamespace(props.targetChain.chainId)\n              ? caip2ToEip155ChainId(props.targetChain.chainId)\n              : props.targetChain.chainId\n            : undefined,\n        slippage: props.slippageBps,\n        tokenIn: assetToAddressString(props.sourceAsset, props.sourceChain.chainId),\n        tokenInDecimals: props.sourceAsset.decimals,\n        tokenOut: assetToAddressString(props.targetAsset, props.targetChain.chainId),\n        tokenOutDecimals: props.targetAsset.decimals,\n        userEvmAddress,\n        userSolanaAddress,\n      },\n      {\n        onDone: () => {\n          if (!ac.signal.aborted) {\n            handler('done');\n          }\n        },\n        onError: (error) => {\n          if (!ac.signal.aborted) {\n            handler('error', error);\n            handler('done');\n          }\n        },\n        onQuote: (data) => {\n          if (!ac.signal.aborted) {\n            handler('quote', quoteFromMarkrQuoteResponseData(data, props, partnerFeeBps));\n          }\n        },\n        signal: ac.signal,\n      },\n    );\n\n    return {\n      cancel: () => {\n        ac.abort();\n      },\n    };\n  };\n}\n\nexport function _validateAndGetUserAddresses(\n  props: Parameters<TransferService['streamQuotes']>[0],\n  options?: ServiceQuoteOptions,\n): Pick<MarkrStreamQuoteParams, 'userEvmAddress' | 'userSolanaAddress'> & { validationError?: InvalidParamsError } {\n  const isCrossChainSwap = props.sourceChain.chainId !== props.targetChain.chainId;\n  const sourceIsEvm = isEvmNamespace(props.sourceChain.chainId);\n  const targetIsEvm = isEvmNamespace(props.targetChain.chainId);\n  const sourceIsSolana = isSolanaNamespace(props.sourceChain.chainId);\n  const targetIsSolana = isSolanaNamespace(props.targetChain.chainId);\n\n  if (sourceIsEvm && !isEvmAddress(props.fromAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, 'Invalid fromAddress for EVM source chain.'),\n    };\n  }\n\n  if (targetIsEvm && !isEvmAddress(props.toAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, 'Invalid toAddress for EVM target chain.'),\n    };\n  }\n\n  if (sourceIsSolana && !isSolAddress(props.fromAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(\n        ErrorReason.INVALID_PARAMS,\n        'Invalid fromAddress for Solana source chain.',\n      ),\n    };\n  }\n\n  if (targetIsSolana && !isSolAddress(props.toAddress)) {\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n      validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, 'Invalid toAddress for Solana target chain.'),\n    };\n  }\n\n  if (\n    isCrossChainSwap &&\n    ((sourceIsEvm && targetIsEvm) || (sourceIsSolana && targetIsSolana)) &&\n    !options?.dangerouslyAllowAddressMismatch\n  ) {\n    if (props.fromAddress !== props.toAddress) {\n      return {\n        userEvmAddress: undefined,\n        userSolanaAddress: undefined,\n        validationError: new InvalidParamsError(\n          ErrorReason.INVALID_PARAMS,\n          'fromAddress and toAddress must match for same-namespace cross-chain swaps.',\n        ),\n      };\n    }\n  }\n\n  if (!isCrossChainSwap) {\n    if (props.fromAddress !== props.toAddress) {\n      return {\n        userEvmAddress: undefined,\n        userSolanaAddress: undefined,\n        validationError: new InvalidParamsError(\n          ErrorReason.INVALID_PARAMS,\n          'fromAddress and toAddress must match for same-chain swaps.',\n        ),\n      };\n    }\n\n    return {\n      userEvmAddress: undefined,\n      userSolanaAddress: undefined,\n    };\n  }\n\n  const userEvmAddress =\n    targetIsEvm && isEvmAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsEvm && isEvmAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  const userSolanaAddress =\n    targetIsSolana && isSolAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsSolana && isSolAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  return {\n    userEvmAddress,\n    userSolanaAddress,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"stream-quotes.js","names":[],"sources":["../../../../src/transfer-service/markr/_handlers/stream-quotes.ts"],"sourcesContent":["import { caip2ToEip155ChainId } from '../../../utils/caip';\nimport type { ServiceQuoteOptions, TransferService } from '../../../types/service';\nimport { markrStreamQuote, type ApiOptions, type MarkrStreamQuoteParams } from '../_api';\nimport { assetToAddressString, quoteFromMarkrQuoteResponseData } from '../_utils';\nimport { isEvmNamespace, isSolanaNamespace } from '../../../_utils/chain';\nimport { isEvmAddress } from '../../../utils/evm-address';\nimport { isSolAddress } from '../../../utils/sol-address';\nimport { ErrorReason, InvalidParamsError } from '../../../errors';\n\nexport interface StreamQuotesFactoryConfig {\n  apiOptions: ApiOptions;\n  appId: string;\n  partnerFeeBps: number;\n}\n\nexport function streamQuotesFactory({\n  apiOptions,\n  appId,\n  partnerFeeBps,\n}: StreamQuotesFactoryConfig): TransferService['streamQuotes'] {\n  return (props, handler, options) => {\n    const ac = new AbortController();\n    const { userEvmAddress, userSolanaAddress, validationError } = _validateAndGetUserAddresses(props, options);\n\n    if (validationError) {\n      handler('error', validationError);\n      handler('done');\n\n      return {\n        cancel: () => {},\n      };\n    }\n\n    void markrStreamQuote(\n      apiOptions,\n      {\n        amount: props.amount.toString(),\n        // Forwarded only when the caller pins one; otherwise Markr races every aggregator.\n        aggregator: props.aggregator,\n        appId,\n        chainId: isEvmNamespace(props.sourceChain.chainId)\n          ? caip2ToEip155ChainId(props.sourceChain.chainId)\n          : props.sourceChain.chainId,\n        // For cross-chain requests, destinationChainId is required.\n        // Use EVM numeric chain IDs for EVM targets and CAIP-2 IDs for non-EVM targets.\n        destinationChainId:\n          props.sourceChain.chainId !== props.targetChain.chainId\n            ? isEvmNamespace(props.targetChain.chainId)\n              ? caip2ToEip155ChainId(props.targetChain.chainId)\n              : props.targetChain.chainId\n            : undefined,\n        slippage: props.slippageBps,\n        tokenIn: assetToAddressString(props.sourceAsset, props.sourceChain.chainId),\n        tokenInDecimals: props.sourceAsset.decimals,\n        tokenOut: assetToAddressString(props.targetAsset, props.targetChain.chainId),\n        tokenOutDecimals: props.targetAsset.decimals,\n        userEvmAddress,\n        userSolanaAddress,\n      },\n      {\n        onDone: () => {\n          if (!ac.signal.aborted) {\n            handler('done');\n          }\n        },\n        onError: (error) => {\n          if (!ac.signal.aborted) {\n            handler('error', error);\n            handler('done');\n          }\n        },\n        onQuote: (data) => {\n          if (!ac.signal.aborted) {\n            handler('quote', quoteFromMarkrQuoteResponseData(data, props, partnerFeeBps));\n          }\n        },\n        signal: ac.signal,\n      },\n    );\n\n    return {\n      cancel: () => {\n        ac.abort();\n      },\n    };\n  };\n}\n\nexport function _validateAndGetUserAddresses(\n  props: Parameters<TransferService['streamQuotes']>[0],\n  options?: ServiceQuoteOptions,\n): Pick<MarkrStreamQuoteParams, 'userEvmAddress' | 'userSolanaAddress'> & { validationError?: InvalidParamsError } {\n  const isCrossChainSwap = props.sourceChain.chainId !== props.targetChain.chainId;\n  const isSameChainSwap = !isCrossChainSwap;\n  const sourceIsEvm = isEvmNamespace(props.sourceChain.chainId);\n  const targetIsEvm = isEvmNamespace(props.targetChain.chainId);\n  const sourceIsSolana = isSolanaNamespace(props.sourceChain.chainId);\n  const targetIsSolana = isSolanaNamespace(props.targetChain.chainId);\n  const dangerouslyAllowAddressMismatch = options?.dangerouslyAllowAddressMismatch === true;\n  const addressesMismatch = props.fromAddress !== props.toAddress;\n\n  const invalidParams = (details: string) => ({\n    userEvmAddress: undefined,\n    userSolanaAddress: undefined,\n    validationError: new InvalidParamsError(ErrorReason.INVALID_PARAMS, details),\n  });\n\n  if (sourceIsEvm && !isEvmAddress(props.fromAddress)) {\n    return invalidParams('Invalid fromAddress for EVM source chain.');\n  }\n\n  if (targetIsEvm && !isEvmAddress(props.toAddress)) {\n    return invalidParams('Invalid toAddress for EVM target chain.');\n  }\n\n  if (sourceIsSolana && !isSolAddress(props.fromAddress)) {\n    return invalidParams('Invalid fromAddress for Solana source chain.');\n  }\n\n  if (targetIsSolana && !isSolAddress(props.toAddress)) {\n    return invalidParams('Invalid toAddress for Solana target chain.');\n  }\n\n  const isSameNamespaceCrossChainSwap =\n    isCrossChainSwap && ((sourceIsEvm && targetIsEvm) || (sourceIsSolana && targetIsSolana));\n\n  if (isSameNamespaceCrossChainSwap && addressesMismatch && !dangerouslyAllowAddressMismatch) {\n    return invalidParams('fromAddress and toAddress must match for same-namespace cross-chain swaps.');\n  }\n\n  if (isSameChainSwap) {\n    if (addressesMismatch && !dangerouslyAllowAddressMismatch) {\n      return invalidParams('fromAddress and toAddress must match for same-chain swaps.');\n    }\n\n    if (!dangerouslyAllowAddressMismatch) {\n      return {\n        userEvmAddress: undefined,\n        userSolanaAddress: undefined,\n      };\n    }\n  }\n\n  const userEvmAddress =\n    targetIsEvm && isEvmAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsEvm && isEvmAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  const userSolanaAddress =\n    targetIsSolana && isSolAddress(props.toAddress)\n      ? props.toAddress\n      : sourceIsSolana && isSolAddress(props.fromAddress)\n      ? props.fromAddress\n      : undefined;\n\n  return {\n    userEvmAddress,\n    userSolanaAddress,\n  };\n}\n"],"mappings":"ydAeA,SAAgB,EAAoB,CAClC,aACA,QACA,iBAC6D,CAC7D,OAAQ,EAAO,EAAS,IAAY,CAClC,IAAM,EAAK,IAAI,gBACT,CAAE,iBAAgB,oBAAmB,mBAAoB,EAA6B,EAAO,EAAQ,CA0D3G,OAxDI,GACF,EAAQ,QAAS,EAAgB,CACjC,EAAQ,OAAO,CAER,CACL,WAAc,GACf,GAGE,EACH,EACA,CACE,OAAQ,EAAM,OAAO,UAAU,CAE/B,WAAY,EAAM,WAClB,QACA,QAAS,EAAe,EAAM,YAAY,QAAQ,CAC9C,EAAqB,EAAM,YAAY,QAAQ,CAC/C,EAAM,YAAY,QAGtB,mBACE,EAAM,YAAY,UAAY,EAAM,YAAY,QAI5C,IAAA,GAHA,EAAe,EAAM,YAAY,QAAQ,CACvC,EAAqB,EAAM,YAAY,QAAQ,CAC/C,EAAM,YAAY,QAE1B,SAAU,EAAM,YAChB,QAAS,EAAqB,EAAM,YAAa,EAAM,YAAY,QAAQ,CAC3E,gBAAiB,EAAM,YAAY,SACnC,SAAU,EAAqB,EAAM,YAAa,EAAM,YAAY,QAAQ,CAC5E,iBAAkB,EAAM,YAAY,SACpC,iBACA,oBACD,CACD,CACE,WAAc,CACP,EAAG,OAAO,SACb,EAAQ,OAAO,EAGnB,QAAU,GAAU,CACb,EAAG,OAAO,UACb,EAAQ,QAAS,EAAM,CACvB,EAAQ,OAAO,GAGnB,QAAU,GAAS,CACZ,EAAG,OAAO,SACb,EAAQ,QAAS,EAAgC,EAAM,EAAO,EAAc,CAAC,EAGjF,OAAQ,EAAG,OACZ,CACF,CAEM,CACL,WAAc,CACZ,EAAG,OAAO,EAEb,GAIL,SAAgB,EACd,EACA,EACiH,CACjH,IAAM,EAAmB,EAAM,YAAY,UAAY,EAAM,YAAY,QACnE,EAAkB,CAAC,EACnB,EAAc,EAAe,EAAM,YAAY,QAAQ,CACvD,EAAc,EAAe,EAAM,YAAY,QAAQ,CACvD,EAAiB,EAAkB,EAAM,YAAY,QAAQ,CAC7D,EAAiB,EAAkB,EAAM,YAAY,QAAQ,CAC7D,EAAkC,GAAS,kCAAoC,GAC/E,EAAoB,EAAM,cAAgB,EAAM,UAEhD,EAAiB,IAAqB,CAC1C,eAAgB,IAAA,GAChB,kBAAmB,IAAA,GACnB,gBAAiB,IAAI,EAAmB,EAAY,eAAgB,EAAQ,CAC7E,EAED,GAAI,GAAe,CAAC,EAAa,EAAM,YAAY,CACjD,OAAO,EAAc,4CAA4C,CAGnE,GAAI,GAAe,CAAC,EAAa,EAAM,UAAU,CAC/C,OAAO,EAAc,0CAA0C,CAGjE,GAAI,GAAkB,CAAC,EAAa,EAAM,YAAY,CACpD,OAAO,EAAc,+CAA+C,CAGtE,GAAI,GAAkB,CAAC,EAAa,EAAM,UAAU,CAClD,OAAO,EAAc,6CAA6C,CAMpE,GAFE,IAAsB,GAAe,GAAiB,GAAkB,IAErC,GAAqB,CAAC,EACzD,OAAO,EAAc,6EAA6E,CAGpG,GAAI,EAAiB,CACnB,GAAI,GAAqB,CAAC,EACxB,OAAO,EAAc,6DAA6D,CAGpF,GAAI,CAAC,EACH,MAAO,CACL,eAAgB,IAAA,GAChB,kBAAmB,IAAA,GACpB,CAkBL,MAAO,CACL,eAdA,GAAe,EAAa,EAAM,UAAU,CACxC,EAAM,UACN,GAAe,EAAa,EAAM,YAAY,CAC9C,EAAM,YACN,IAAA,GAWJ,kBARA,GAAkB,EAAa,EAAM,UAAU,CAC3C,EAAM,UACN,GAAkB,EAAa,EAAM,YAAY,CACjD,EAAM,YACN,IAAA,GAKL"}

package/dist/types/service.d.cts

@@ -125,9 +125,11 @@ interface EstimateNativeFeeOptions {
 }
 interface ServiceQuoteOptions {
   /**
-  * Dangerously allows cross-chain quotes where fromAddress and toAddress differ
+  * Dangerously allows quotes where fromAddress and toAddress differ,
   * even when a service would otherwise require them to match.
   *
+  * This applies to both same-chain and cross-chain quotes.
+  *
   * This is intended for explicit proxy-recipient funding flows. Services should
   * preserve their default address safety checks unless this is set.
   */

package/dist/types/service.d.ts

@@ -125,9 +125,11 @@ interface EstimateNativeFeeOptions {
 }
 interface ServiceQuoteOptions {
   /**
-  * Dangerously allows cross-chain quotes where fromAddress and toAddress differ
+  * Dangerously allows quotes where fromAddress and toAddress differ,
   * even when a service would otherwise require them to match.
   *
+  * This applies to both same-chain and cross-chain quotes.
+  *
   * This is intended for explicit proxy-recipient funding flows. Services should
   * preserve their default address safety checks unless this is set.
   */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@avalabs/fusion-sdk",
   "license": "Limited Ecosystem License",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "type": "module",
   "main": "./dist/mod.cjs",
   "module": "./dist/mod.js",