npm - @polyester/sdk - Versions diffs - 0.3.1 → 0.4.0 - Mend

@polyester/sdk 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (311) hide show

package/dist/catalogs/readers.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"readers.js","names":[],"sources":["../../src/catalogs/readers.ts"],"sourcesContent":["import type {\n AssetConfig,\n ZipperChainConfig,\n ZipperChainContractConfig,\n} from \"../shared/catalog-config.js\";\nimport {\n scaledToDecimal,\n scaledToDisplay,\n significantDecimalPlaces,\n tryDecimalToScaled,\n tryNormalizeDecimalInput,\n tryToScaledBigInt,\n type DecimalToScaledFailure,\n type ScaledIntegerLike,\n} from \"./decimal.js\";\nimport { indexesFor } from \"./indexes.js\";\nimport type { EnrichedPairConfig } from \"./market-data-catalog.js\";\nimport {\n resolveLedgerAssetByLedgerId,\n resolveZipperAssetByLedgerId,\n UNKNOWN_LEDGER_ASSET_ID,\n} from \"./unknown-asset.js\";\nimport type { ZipperContractName, ZipperEnrichedAssetConfig } from \"./zipper-catalog.js\";\nimport {\n CatalogConversionError,\n CatalogLookupError,\n CatalogValidationFailedError,\n type AssetCatalogKey,\n type CatalogLookupDomain,\n type CatalogReader,\n type CatalogSnapshot,\n type CatalogValidationError,\n type CatalogValidationResult,\n type ChainCatalogKey,\n type LedgerCatalogReader,\n type MarketCatalogReader,\n type OrdersCatalogReader,\n type PairCatalogKey,\n type ParsedCatalogAmount,\n type SpotOrderConstraints,\n type SpotOrderDecimalInput,\n type ZipperAssetChainRoute,\n type ZipperCatalogReader,\n} from \"./types.js\";\n\n/** Price ticks are always quoted at 6 decimal places. /\nexport const PRICE_SCALE = 6;\n\ntype SnapshotGetter = () => CatalogSnapshot;\n\nfunction isListed(pair: EnrichedPairConfig, nowMs: number): boolean {\n if (pair.listingAt === null \|\| pair.listingAt > nowMs) return false;\n if (pair.status === \"disabled\") return false;\n if (pair.delistingAt !== null && pair.delistingAt < nowMs) return false;\n return true;\n}\n\nfunction isEverListed(pair: EnrichedPairConfig, nowMs: number): boolean {\n return pair.listingAt !== null && pair.listingAt < nowMs;\n}\n\nfunction requireFound<T>(\n domain: CatalogLookupDomain,\n lookup: string,\n value: string \| number,\n found: T \| null,\n): T {\n if (found === null) throw new CatalogLookupError(domain, lookup, value);\n return found;\n}\n\ntype ResolvedKey<TByName extends string, TById extends string> =\n \| { lookup: TByName; value: string }\n \| { lookup: TById; value: number };\n\nfunction resolvePairKey(key: PairCatalogKey): ResolvedKey<\"symbol\", \"symbolId\"> {\n if (typeof key === \"string\") return { lookup: \"symbol\", value: key };\n if (typeof key === \"number\") return { lookup: \"symbolId\", value: key };\n if (\"symbol\" in key) return { lookup: \"symbol\", value: key.symbol };\n return { lookup: \"symbolId\", value: key.symbolId };\n}\n\nfunction resolveAssetKey(key: AssetCatalogKey): ResolvedKey<\"symbol\", \"ledgerId\"> {\n if (typeof key === \"string\") return { lookup: \"symbol\", value: key };\n if (typeof key === \"number\") return { lookup: \"ledgerId\", value: key };\n if (\"symbol\" in key) return { lookup: \"symbol\", value: key.symbol };\n return { lookup: \"ledgerId\", value: key.ledgerId };\n}\n\nfunction resolveChainKey(key: ChainCatalogKey): ResolvedKey<\"chainCode\", \"chainId\"> {\n if (typeof key === \"string\") return { lookup: \"chainCode\", value: key };\n if (typeof key === \"number\") return { lookup: \"chainId\", value: key };\n if (\"code\" in key) return { lookup: \"chainCode\", value: key.code };\n return { lookup: \"chainId\", value: key.chainId };\n}\n\nfunction conversionFailureMessage(\n field: string,\n value: string,\n failure: DecimalToScaledFailure,\n): string {\n return failure.reason === \"precision\"\n ? `${field} supports at most ${failure.maxDecimals} decimal places: ${value}`\n : `${field} must be a non-negative decimal number: ${value}`;\n}\n\n/* Shared conversion core used by the market and ledger readers. /\nclass DecimalConverter {\n constructor(\n readonly field: string,\n readonly scale: number,\n readonly displayDecimals: number,\n ) {}\n\n parse(decimal: string): ParsedCatalogAmount {\n const result = tryDecimalToScaled(decimal, this.scale);\n if (!result.ok) {\n throw new CatalogConversionError(\n this.field,\n conversionFailureMessage(this.field, decimal, result.failure),\n );\n }\n return {\n scaledValue: result.scaled.toString(),\n decimal: scaledToDecimal(result.scaled, this.scale),\n display: scaledToDisplay(result.scaled, this.scale, this.displayDecimals),\n scale: this.scale,\n };\n }\n\n normalizeInput(raw: string): string {\n const normalized = tryNormalizeDecimalInput(raw, this.scale);\n if (normalized === null) {\n throw new CatalogConversionError(\n this.field,\n `${this.field} must be a non-negative decimal number: ${raw}`,\n );\n }\n return normalized;\n }\n\n toDecimalString(scaled: ScaledIntegerLike): string {\n return scaledToDecimal(this.toBigInt(scaled), this.scale);\n }\n\n toDisplayString(scaled: ScaledIntegerLike): string {\n return scaledToDisplay(this.toBigInt(scaled), this.scale, this.displayDecimals);\n }\n\n formatDecimal(decimal: string): string {\n const result = tryDecimalToScaled(decimal.trim(), this.scale);\n if (!result.ok) {\n throw new CatalogConversionError(\n this.field,\n conversionFailureMessage(this.field, decimal, result.failure),\n );\n }\n return scaledToDisplay(result.scaled, this.scale, this.displayDecimals);\n }\n\n private toBigInt(scaled: ScaledIntegerLike): bigint {\n const value = tryToScaledBigInt(scaled);\n if (value === null) {\n throw new CatalogConversionError(\n this.field,\n `${this.field} must be a raw scaled integer: ${String(scaled)}`,\n );\n }\n return value;\n }\n}\n\nfunction priceConverter(pair: EnrichedPairConfig): DecimalConverter {\n const tickDecimals = significantDecimalPlaces(pair.tickSize);\n const displayDecimals = tickDecimals > 0 ? tickDecimals : PRICE_SCALE;\n return new DecimalConverter(\"price\", PRICE_SCALE, displayDecimals);\n}\n\nfunction quantityConverter(pair: EnrichedPairConfig): DecimalConverter {\n return new DecimalConverter(\n \"quantity\",\n pair.baseAsset.quantityScale,\n pair.baseAsset.quantityDisplayDecimals,\n );\n}\n\nfunction quoteAmountConverter(pair: EnrichedPairConfig): DecimalConverter {\n return new DecimalConverter(\n \"quoteAmount\",\n pair.quoteAsset.quantityScale,\n pair.quoteAsset.quantityDisplayDecimals,\n );\n}\n\nfunction ledgerAmountConverter(asset: AssetConfig): DecimalConverter {\n return new DecimalConverter(\"amount\", asset.quantityScale, asset.quantityDisplayDecimals);\n}\n\nclass MarketReader implements MarketCatalogReader {\n constructor(private readonly getSnapshot: SnapshotGetter) {}\n\n listAssets(): readonly AssetConfig[] {\n return this.getSnapshot().market.assets;\n }\n\n getAsset(asset: AssetCatalogKey): AssetConfig \| null {\n const key = resolveAssetKey(asset);\n return key.lookup === \"symbol\"\n ? this.getAssetBySymbol(key.value)\n : this.getAssetByLedgerId(key.value);\n }\n\n requireAsset(asset: AssetCatalogKey): AssetConfig {\n const key = resolveAssetKey(asset);\n return requireFound(\"market\", key.lookup, key.value, this.getAsset(asset));\n }\n\n getAssetBySymbol(assetSymbol: string): AssetConfig \| null {\n return indexesFor(this.getSnapshot()).assetBySymbol.get(assetSymbol) ?? null;\n }\n\n requireAssetBySymbol(assetSymbol: string): AssetConfig {\n return requireFound(\"market\", \"symbol\", assetSymbol, this.getAssetBySymbol(assetSymbol));\n }\n\n getAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return resolveLedgerAssetByLedgerId(ledgerAssetId, (id) => this.lookupAssetByLedgerId(id));\n }\n\n lookupAssetByLedgerId(ledgerAssetId: number): AssetConfig \| null {\n return indexesFor(this.getSnapshot()).assetByLedgerId.get(ledgerAssetId) ?? null;\n }\n\n requireAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return this.getAssetByLedgerId(ledgerAssetId);\n }\n\n listPairs(filter?: {\n listed?: boolean;\n everListed?: boolean;\n atMs?: number;\n }): readonly EnrichedPairConfig[] {\n const pairs = this.getSnapshot().market.pairs;\n if (!filter) return pairs;\n const nowMs = filter.atMs ?? Date.now();\n return pairs.filter((pair) => {\n if (filter.listed !== undefined && isListed(pair, nowMs) !== filter.listed)\n return false;\n if (filter.everListed !== undefined && isEverListed(pair, nowMs) !== filter.everListed)\n return false;\n return true;\n });\n }\n\n getPair(pair: PairCatalogKey): EnrichedPairConfig \| null {\n const key = resolvePairKey(pair);\n return key.lookup === \"symbol\"\n ? this.getPairBySymbol(key.value)\n : this.getPairBySymbolId(key.value);\n }\n\n requirePair(pair: PairCatalogKey): EnrichedPairConfig {\n const key = resolvePairKey(pair);\n return requireFound(\"market\", key.lookup, key.value, this.getPair(pair));\n }\n\n getPairBySymbol(pairSymbol: string): EnrichedPairConfig \| null {\n return indexesFor(this.getSnapshot()).pairBySymbol.get(pairSymbol) ?? null;\n }\n\n requirePairBySymbol(pairSymbol: string): EnrichedPairConfig {\n return requireFound(\"market\", \"symbol\", pairSymbol, this.getPairBySymbol(pairSymbol));\n }\n\n getPairBySymbolId(pairSymbolId: number): EnrichedPairConfig \| null {\n return indexesFor(this.getSnapshot()).pairBySymbolId.get(pairSymbolId) ?? null;\n }\n\n requirePairBySymbolId(pairSymbolId: number): EnrichedPairConfig {\n return requireFound(\n \"market\",\n \"symbolId\",\n pairSymbolId,\n this.getPairBySymbolId(pairSymbolId),\n );\n }\n\n getSymbolIdByPairSymbol(pairSymbol: string): number \| null {\n return this.getPairBySymbol(pairSymbol)?.symbolId ?? null;\n }\n\n requireSymbolIdByPairSymbol(pairSymbol: string): number {\n return this.requirePairBySymbol(pairSymbol).symbolId;\n }\n\n getPairSymbolBySymbolId(pairSymbolId: number): string \| null {\n return this.getPairBySymbolId(pairSymbolId)?.symbol ?? null;\n }\n\n requirePairSymbolBySymbolId(pairSymbolId: number): string {\n return this.requirePairBySymbolId(pairSymbolId).symbol;\n }\n\n decimalPriceToTicks(price: string, pair: PairCatalogKey): ParsedCatalogAmount {\n return priceConverter(this.requirePair(pair)).parse(price);\n }\n\n normalizePriceInput(price: string, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).normalizeInput(price);\n }\n\n priceTicksToDecimalString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).toDecimalString(priceTicks);\n }\n\n priceTicksToDisplayString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).toDisplayString(priceTicks);\n }\n\n formatPrice(price: string, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).formatDecimal(price);\n }\n\n decimalQuantityToScaled(quantity: string, pair: PairCatalogKey): ParsedCatalogAmount {\n return quantityConverter(this.requirePair(pair)).parse(quantity);\n }\n\n normalizeQuantityInput(quantity: string, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).normalizeInput(quantity);\n }\n\n quantityScaledToDecimalString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).toDecimalString(quantityScaled);\n }\n\n quantityScaledToDisplayString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).toDisplayString(quantityScaled);\n }\n\n formatQuantity(quantity: string, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).formatDecimal(quantity);\n }\n\n decimalQuoteAmountToScaled(amount: string, pair: PairCatalogKey): ParsedCatalogAmount {\n return quoteAmountConverter(this.requirePair(pair)).parse(amount);\n }\n\n normalizeQuoteAmountInput(amount: string, pair: PairCatalogKey): string {\n return quoteAmountConverter(this.requirePair(pair)).normalizeInput(amount);\n }\n\n quoteAmountScaledToDecimalString(\n amountScaled: ScaledIntegerLike,\n pair: PairCatalogKey,\n ): string {\n return quoteAmountConverter(this.requirePair(pair)).toDecimalString(amountScaled);\n }\n\n quoteAmountScaledToDisplayString(\n amountScaled: ScaledIntegerLike,\n pair: PairCatalogKey,\n ): string {\n return quoteAmountConverter(this.requirePair(pair)).toDisplayString(amountScaled);\n }\n\n formatQuoteAmount(amount: string, pair: PairCatalogKey): string {\n return quoteAmountConverter(this.requirePair(pair)).formatDecimal(amount);\n }\n}\n\nclass LedgerReader implements LedgerCatalogReader {\n constructor(private readonly market: MarketReader) {}\n\n getAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return this.market.getAssetByLedgerId(ledgerAssetId);\n }\n\n requireAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return this.getAssetByLedgerId(ledgerAssetId);\n }\n\n getAssetBySymbol(assetSymbol: string): AssetConfig \| null {\n return this.market.getAssetBySymbol(assetSymbol);\n }\n\n requireAssetBySymbol(assetSymbol: string): AssetConfig {\n return requireFound(\"ledger\", \"symbol\", assetSymbol, this.getAssetBySymbol(assetSymbol));\n }\n\n getLedgerIdBySymbol(assetSymbol: string): number \| null {\n return this.getAssetBySymbol(assetSymbol)?.ledgerId ?? null;\n }\n\n requireLedgerIdBySymbol(assetSymbol: string): number {\n return this.requireAssetBySymbol(assetSymbol).ledgerId;\n }\n\n requireSymbolByLedgerId(ledgerAssetId: number): string {\n return this.requireAssetByLedgerId(ledgerAssetId).symbol;\n }\n\n isKnownAssetId(ledgerAssetId: number): boolean {\n if (!Number.isInteger(ledgerAssetId) \|\| ledgerAssetId <= 0) return false;\n if (ledgerAssetId === UNKNOWN_LEDGER_ASSET_ID) return false;\n return this.market.lookupAssetByLedgerId(ledgerAssetId) !== null;\n }\n\n decimalAmountToScaled(amount: string, asset: AssetCatalogKey): ParsedCatalogAmount {\n return ledgerAmountConverter(this.requireAsset(asset)).parse(amount);\n }\n\n normalizeAmountInput(amount: string, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).normalizeInput(amount);\n }\n\n amountScaledToDecimalString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).toDecimalString(amountScaled);\n }\n\n amountScaledToDisplayString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).toDisplayString(amountScaled);\n }\n\n formatAmount(amount: string, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).formatDecimal(amount);\n }\n\n private requireAsset(asset: AssetCatalogKey): AssetConfig {\n const key = resolveAssetKey(asset);\n const found =\n key.lookup === \"symbol\"\n ? this.getAssetBySymbol(key.value)\n : this.getAssetByLedgerId(key.value);\n return requireFound(\"ledger\", key.lookup, key.value, found);\n }\n}\n\nclass OrdersReader implements OrdersCatalogReader {\n constructor(private readonly market: MarketReader) {}\n\n getSpotOrderConstraints(pair: PairCatalogKey): SpotOrderConstraints {\n const config = this.market.requirePair(pair);\n return {\n symbolId: config.symbolId,\n symbol: config.symbol,\n status: config.status,\n tickSize: config.tickSize,\n stepSize: config.stepSize,\n minQtyBase: config.minQtyBase,\n minNotionalQuote: config.minNotionalQuote,\n priceScale: PRICE_SCALE,\n quantityScale: config.baseAsset.quantityScale,\n quoteAmountScale: config.quoteAsset.quantityScale,\n priceDisplayDecimals: priceConverter(config).displayDecimals,\n quantityDisplayDecimals: config.baseAsset.quantityDisplayDecimals,\n quoteAmountDisplayDecimals: config.quoteAsset.quantityDisplayDecimals,\n };\n }\n\n validateSpotOrderDecimalInput(input: SpotOrderDecimalInput): CatalogValidationResult {\n const pair = this.market.requirePair(input.pair);\n const errors: CatalogValidationError[] = [];\n\n const quantityScaled = this.validateQuantity(pair, input.quantity, errors);\n const priceTicks =\n input.price === undefined ? null : this.validatePrice(pair, input.price, errors);\n\n if (quantityScaled !== null && priceTicks !== null) {\n this.validateMinNotional(pair, quantityScaled, priceTicks, errors);\n }\n\n return { valid: errors.length === 0, errors };\n }\n\n assertSpotOrderDecimalInput(input: SpotOrderDecimalInput): void {\n const result = this.validateSpotOrderDecimalInput(input);\n if (!result.valid) throw new CatalogValidationFailedError(result.errors);\n }\n\n private validateQuantity(\n pair: EnrichedPairConfig,\n quantity: string,\n errors: CatalogValidationError[],\n ): bigint \| null {\n const scale = pair.baseAsset.quantityScale;\n const parsed = tryDecimalToScaled(quantity, scale);\n if (!parsed.ok) {\n errors.push({\n field: \"quantity\",\n rule: \"parse\",\n message: conversionFailureMessage(\"quantity\", quantity, parsed.failure),\n actual: quantity,\n });\n return null;\n }\n\n const step = this.requireConstraintScaled(pair.stepSize, scale, \"stepSize\");\n if (step > 0n && parsed.scaled % step !== 0n) {\n errors.push({\n field: \"quantity\",\n rule: \"stepSize\",\n message: `quantity must be a multiple of the pair step size ${pair.stepSize}`,\n expected: pair.stepSize,\n actual: quantity,\n });\n }\n\n const minQty = this.requireConstraintScaled(pair.minQtyBase, scale, \"minQtyBase\");\n if (parsed.scaled < minQty \|\| parsed.scaled === 0n) {\n errors.push({\n field: \"quantity\",\n rule: \"minQty\",\n message: `quantity is below the pair minimum of ${pair.minQtyBase}`,\n expected: pair.minQtyBase,\n actual: quantity,\n });\n }\n\n return parsed.scaled;\n }\n\n private validatePrice(\n pair: EnrichedPairConfig,\n price: string,\n errors: CatalogValidationError[],\n ): bigint \| null {\n const parsed = tryDecimalToScaled(price, PRICE_SCALE);\n if (!parsed.ok) {\n errors.push({\n field: \"price\",\n rule: \"parse\",\n message: conversionFailureMessage(\"price\", price, parsed.failure),\n actual: price,\n });\n return null;\n }\n\n const tick = this.requireConstraintScaled(pair.tickSize, PRICE_SCALE, \"tickSize\");\n if (tick > 0n && parsed.scaled % tick !== 0n) {\n errors.push({\n field: \"price\",\n rule: \"tickSize\",\n message: `price must be a multiple of the pair tick size ${pair.tickSize}`,\n expected: pair.tickSize,\n actual: price,\n });\n }\n\n return parsed.scaled;\n }\n\n private validateMinNotional(\n pair: EnrichedPairConfig,\n quantityScaled: bigint,\n priceTicks: bigint,\n errors: CatalogValidationError[],\n ): void {\n const notionalScale = pair.baseAsset.quantityScale + PRICE_SCALE;\n const minNotional = this.requireConstraintScaled(\n pair.minNotionalQuote,\n notionalScale,\n \"minNotionalQuote\",\n );\n const notional = quantityScaled priceTicks;\n if (notional < minNotional) {\n errors.push({\n field: \"notional\",\n rule: \"minNotional\",\n message: `order notional is below the pair minimum of ${pair.minNotionalQuote}`,\n expected: pair.minNotionalQuote,\n actual: scaledToDecimal(notional, notionalScale),\n });\n }\n }\n\n /** Pair constraint strings come from the catalog itself, so failures are data bugs. */\n private requireConstraintScaled(decimal: string, scale: number, field: string): bigint {\n const result = tryDecimalToScaled(decimal, scale);\n if (!result.ok) {\n throw new CatalogConversionError(\n field,\n conversionFailureMessage(field, decimal, result.failure),\n );\n }\n return result.scaled;\n }\n}\n\nclass ZipperReader implements ZipperCatalogReader {\n constructor(private readonly getSnapshot: SnapshotGetter) {}\n\n listChains(): readonly ZipperChainConfig[] {\n return this.getSnapshot().zipper.chains;\n }\n\n getChain(chain: ChainCatalogKey): ZipperChainConfig \| null {\n const key = resolveChainKey(chain);\n return key.lookup === \"chainCode\"\n ? this.getChainByCode(key.value)\n : this.getChainById(key.value);\n }\n\n requireChain(chain: ChainCatalogKey): ZipperChainConfig {\n const key = resolveChainKey(chain);\n return requireFound(\"zipper\", key.lookup, key.value, this.getChain(chain));\n }\n\n getChainByCode(chainCode: string): ZipperChainConfig \| null {\n return indexesFor(this.getSnapshot()).zipperChainByCode.get(chainCode) ?? null;\n }\n\n requireChainByCode(chainCode: string): ZipperChainConfig {\n return requireFound(\"zipper\", \"chainCode\", chainCode, this.getChainByCode(chainCode));\n }\n\n getChainById(chainId: number): ZipperChainConfig \| null {\n return indexesFor(this.getSnapshot()).zipperChainById.get(chainId) ?? null;\n }\n\n requireChainById(chainId: number): ZipperChainConfig {\n return requireFound(\"zipper\", \"chainId\", chainId, this.getChainById(chainId));\n }\n\n getChainIdByCode(chainCode: string): number \| null {\n return this.getChainByCode(chainCode)?.chainId ?? null;\n }\n\n requireChainIdByCode(chainCode: string): number {\n return this.requireChainByCode(chainCode).chainId;\n }\n\n listAssets(): readonly ZipperEnrichedAssetConfig[] {\n return this.getSnapshot().zipper.assets;\n }\n\n getAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig \| null {\n const key = resolveAssetKey(asset);\n return key.lookup === \"symbol\"\n ? this.getAssetBySymbol(key.value)\n : this.getAssetByLedgerId(key.value);\n }\n\n requireAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig {\n const key = resolveAssetKey(asset);\n return requireFound(\"zipper\", key.lookup, key.value, this.getAsset(asset));\n }\n\n getAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig \| null {\n return indexesFor(this.getSnapshot()).zipperAssetBySymbol.get(assetSymbol) ?? null;\n }\n\n requireAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig {\n return requireFound(\"zipper\", \"symbol\", assetSymbol, this.getAssetBySymbol(assetSymbol));\n }\n\n getAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig {\n return resolveZipperAssetByLedgerId(ledgerAssetId, (id) => this.lookupAssetByLedgerId(id));\n }\n\n lookupAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig \| null {\n return indexesFor(this.getSnapshot()).zipperAssetByLedgerId.get(ledgerAssetId) ?? null;\n }\n\n requireAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig {\n return this.getAssetByLedgerId(ledgerAssetId);\n }\n\n getAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig \| null {\n return indexesFor(this.getSnapshot()).zipperAssetByUAssetId.get(uAssetId) ?? null;\n }\n\n requireAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig {\n return requireFound(\"zipper\", \"uAssetId\", uAssetId, this.getAssetByUAssetId(uAssetId));\n }\n\n getAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute \| null {\n const zipperAsset = this.getAsset(asset);\n const zipperChain = this.getChain(chain);\n if (!zipperAsset \|\| !zipperChain) return null;\n const route = zipperAsset.chains.find(\n (candidate) => candidate.chainId === zipperChain.chainId,\n );\n return route ? { asset: zipperAsset, chain: route } : null;\n }\n\n requireAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute {\n const route = this.getAssetChain(asset, chain);\n if (!route) {\n throw new CatalogLookupError(\n \"zipper\",\n \"assetChain\",\n `${formatKey(resolveAssetKey(asset))}:${formatKey(resolveChainKey(chain))}`,\n );\n }\n return route;\n }\n\n getAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute \| null {\n return indexesFor(this.getSnapshot()).zipperRouteByZippedAssetId.get(zippedAssetId) ?? null;\n }\n\n requireAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute {\n return requireFound(\n \"zipper\",\n \"zippedAssetId\",\n zippedAssetId,\n this.getAssetChainByZippedAssetId(zippedAssetId),\n );\n }\n\n getZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number \| null {\n return this.getAssetChain(asset, chain)?.chain.zippedAssetId ?? null;\n }\n\n requireZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number {\n return this.requireAssetChain(asset, chain).chain.zippedAssetId;\n }\n\n listContracts(): readonly ZipperChainContractConfig[] {\n return this.getSnapshot().zipper.contracts;\n }\n\n getContract(contractName: ZipperContractName): ZipperChainContractConfig \| null {\n return this.getContractByName(contractName);\n }\n\n requireContract(contractName: ZipperContractName): ZipperChainContractConfig {\n return this.requireContractByName(contractName);\n }\n\n getContractByName(contractName: ZipperContractName): ZipperChainContractConfig \| null {\n return indexesFor(this.getSnapshot()).zipperContractByName.get(contractName) ?? null;\n }\n\n requireContractByName(contractName: ZipperContractName): ZipperChainContractConfig {\n return requireFound(\n \"zipper\",\n \"contractName\",\n contractName,\n this.getContractByName(contractName),\n );\n }\n}\n\nfunction formatKey(key: { lookup: string; value: string \| number }): string {\n return String(key.value);\n}\n\nclass SnapshotCatalogReader implements CatalogReader {\n readonly market: MarketCatalogReader;\n readonly ledger: LedgerCatalogReader;\n readonly orders: OrdersCatalogReader;\n readonly zipper: ZipperCatalogReader;\n readonly snapshot: () => CatalogSnapshot;\n\n constructor(getSnapshot: SnapshotGetter) {\n const market = new MarketReader(getSnapshot);\n this.market = market;\n this.ledger = new LedgerReader(market);\n this.orders = new OrdersReader(market);\n this.zipper = new ZipperReader(getSnapshot);\n this.snapshot = () => getSnapshot();\n }\n}\n\nexport function createReader(getSnapshot: () => CatalogSnapshot): CatalogReader {\n return new SnapshotCatalogReader(getSnapshot);\n}\n\nexport function createCatalogSnapshotReader(snapshot: CatalogSnapshot): CatalogReader {\n return createReader(() => snapshot);\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"readers.js","names":[],"sources":["../../src/catalogs/readers.ts"],"sourcesContent":["import type {\n AssetConfig,\n ZipperChainConfig,\n ZipperChainContractConfig,\n} from \"../shared/catalog-config.js\";\nimport {\n scaledToDecimal,\n scaledToDisplay,\n significantDecimalPlaces,\n tryDecimalToScaled,\n tryNormalizeDecimalInput,\n tryToScaledBigInt,\n type DecimalToScaledFailure,\n type ScaledIntegerLike,\n} from \"./decimal.js\";\nimport { indexesFor } from \"./indexes.js\";\nimport type { EnrichedPairConfig } from \"./market-data-catalog.js\";\nimport {\n resolveLedgerAssetByLedgerId,\n resolveZipperAssetByLedgerId,\n UNKNOWN_LEDGER_ASSET_ID,\n} from \"./unknown-asset.js\";\nimport type { ZipperContractName, ZipperEnrichedAssetConfig } from \"./zipper-catalog.js\";\nimport {\n CatalogConversionError,\n CatalogLookupError,\n CatalogValidationFailedError,\n type AssetCatalogKey,\n type CatalogLookupDomain,\n type CatalogReader,\n type CatalogSnapshot,\n type CatalogValidationError,\n type CatalogValidationResult,\n type ChainCatalogKey,\n type LedgerCatalogReader,\n type MarketCatalogReader,\n type OrdersCatalogReader,\n type PairCatalogKey,\n type ParsedCatalogAmount,\n type SpotOrderConstraints,\n type SpotOrderDecimalInput,\n type ZipperAssetChainRoute,\n type ZipperCatalogReader,\n} from \"./types.js\";\nimport { parseCatalogSnapshot } from \"./snapshot-validation.js\";\n\n/** Price ticks are always quoted at 6 decimal places. /\nexport const PRICE_SCALE = 6;\n\ntype SnapshotGetter = () => CatalogSnapshot;\n\nfunction isListed(pair: EnrichedPairConfig, nowMs: number): boolean {\n if (pair.listingAt === null \|\| pair.listingAt > nowMs) return false;\n if (pair.status === \"disabled\") return false;\n if (pair.delistingAt !== null && pair.delistingAt < nowMs) return false;\n return true;\n}\n\nfunction isEverListed(pair: EnrichedPairConfig, nowMs: number): boolean {\n return pair.listingAt !== null && pair.listingAt < nowMs;\n}\n\nfunction requireFound<T>(\n domain: CatalogLookupDomain,\n lookup: string,\n value: string \| number,\n found: T \| null,\n): T {\n if (found === null) throw new CatalogLookupError(domain, lookup, value);\n return found;\n}\n\ntype ResolvedKey<TByName extends string, TById extends string> =\n \| { lookup: TByName; value: string }\n \| { lookup: TById; value: number };\n\nfunction resolvePairKey(key: PairCatalogKey): ResolvedKey<\"symbol\", \"symbolId\"> {\n if (typeof key === \"string\") return { lookup: \"symbol\", value: key };\n if (typeof key === \"number\") return { lookup: \"symbolId\", value: key };\n if (\"symbol\" in key) return { lookup: \"symbol\", value: key.symbol };\n return { lookup: \"symbolId\", value: key.symbolId };\n}\n\nfunction resolveAssetKey(key: AssetCatalogKey): ResolvedKey<\"symbol\", \"ledgerId\"> {\n if (typeof key === \"string\") return { lookup: \"symbol\", value: key };\n if (typeof key === \"number\") return { lookup: \"ledgerId\", value: key };\n if (\"symbol\" in key) return { lookup: \"symbol\", value: key.symbol };\n return { lookup: \"ledgerId\", value: key.ledgerId };\n}\n\nfunction resolveChainKey(key: ChainCatalogKey): ResolvedKey<\"chainCode\", \"chainId\"> {\n if (typeof key === \"string\") return { lookup: \"chainCode\", value: key };\n if (typeof key === \"number\") return { lookup: \"chainId\", value: key };\n if (\"code\" in key) return { lookup: \"chainCode\", value: key.code };\n return { lookup: \"chainId\", value: key.chainId };\n}\n\nfunction conversionFailureMessage(\n field: string,\n value: string,\n failure: DecimalToScaledFailure,\n): string {\n return failure.reason === \"precision\"\n ? `${field} supports at most ${failure.maxDecimals} decimal places: ${value}`\n : `${field} must be a non-negative decimal number: ${value}`;\n}\n\n/* Shared conversion core used by the market and ledger readers. /\nclass DecimalConverter {\n constructor(\n readonly field: string,\n readonly scale: number,\n readonly displayDecimals: number,\n ) {}\n\n parse(decimal: string): ParsedCatalogAmount {\n const result = tryDecimalToScaled(decimal, this.scale);\n if (!result.ok) {\n throw new CatalogConversionError(\n this.field,\n conversionFailureMessage(this.field, decimal, result.failure),\n );\n }\n return {\n scaledValue: result.scaled.toString(),\n decimal: scaledToDecimal(result.scaled, this.scale),\n display: scaledToDisplay(result.scaled, this.scale, this.displayDecimals),\n scale: this.scale,\n };\n }\n\n normalizeInput(raw: string): string {\n const normalized = tryNormalizeDecimalInput(raw, this.scale);\n if (normalized === null) {\n throw new CatalogConversionError(\n this.field,\n `${this.field} must be a non-negative decimal number: ${raw}`,\n );\n }\n return normalized;\n }\n\n toDecimalString(scaled: ScaledIntegerLike): string {\n return scaledToDecimal(this.toBigInt(scaled), this.scale);\n }\n\n toDisplayString(scaled: ScaledIntegerLike): string {\n return scaledToDisplay(this.toBigInt(scaled), this.scale, this.displayDecimals);\n }\n\n formatDecimal(decimal: string): string {\n const result = tryDecimalToScaled(decimal.trim(), this.scale);\n if (!result.ok) {\n throw new CatalogConversionError(\n this.field,\n conversionFailureMessage(this.field, decimal, result.failure),\n );\n }\n return scaledToDisplay(result.scaled, this.scale, this.displayDecimals);\n }\n\n private toBigInt(scaled: ScaledIntegerLike): bigint {\n const value = tryToScaledBigInt(scaled);\n if (value === null) {\n throw new CatalogConversionError(\n this.field,\n `${this.field} must be a raw scaled integer: ${String(scaled)}`,\n );\n }\n return value;\n }\n}\n\nfunction priceConverter(pair: EnrichedPairConfig): DecimalConverter {\n const tickDecimals = significantDecimalPlaces(pair.tickSize);\n const displayDecimals = tickDecimals > 0 ? tickDecimals : PRICE_SCALE;\n return new DecimalConverter(\"price\", PRICE_SCALE, displayDecimals);\n}\n\nfunction quantityConverter(pair: EnrichedPairConfig): DecimalConverter {\n return new DecimalConverter(\n \"quantity\",\n pair.baseAsset.quantityScale,\n pair.baseAsset.quantityDisplayDecimals,\n );\n}\n\nfunction quoteAmountConverter(pair: EnrichedPairConfig): DecimalConverter {\n return new DecimalConverter(\n \"quoteAmount\",\n pair.quoteAsset.quantityScale,\n pair.quoteAsset.quantityDisplayDecimals,\n );\n}\n\nfunction ledgerAmountConverter(asset: AssetConfig): DecimalConverter {\n return new DecimalConverter(\"amount\", asset.quantityScale, asset.quantityDisplayDecimals);\n}\n\nclass MarketReader implements MarketCatalogReader {\n constructor(private readonly getSnapshot: SnapshotGetter) {}\n\n listAssets(): readonly AssetConfig[] {\n return this.getSnapshot().market.assets;\n }\n\n getAsset(asset: AssetCatalogKey): AssetConfig \| null {\n const key = resolveAssetKey(asset);\n return key.lookup === \"symbol\"\n ? this.getAssetBySymbol(key.value)\n : this.getAssetByLedgerId(key.value);\n }\n\n requireAsset(asset: AssetCatalogKey): AssetConfig {\n const key = resolveAssetKey(asset);\n return requireFound(\"market\", key.lookup, key.value, this.getAsset(asset));\n }\n\n getAssetBySymbol(assetSymbol: string): AssetConfig \| null {\n return indexesFor(this.getSnapshot()).assetBySymbol.get(assetSymbol) ?? null;\n }\n\n requireAssetBySymbol(assetSymbol: string): AssetConfig {\n return requireFound(\"market\", \"symbol\", assetSymbol, this.getAssetBySymbol(assetSymbol));\n }\n\n getAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return resolveLedgerAssetByLedgerId(ledgerAssetId, (id) => this.lookupAssetByLedgerId(id));\n }\n\n lookupAssetByLedgerId(ledgerAssetId: number): AssetConfig \| null {\n return indexesFor(this.getSnapshot()).assetByLedgerId.get(ledgerAssetId) ?? null;\n }\n\n requireAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return this.getAssetByLedgerId(ledgerAssetId);\n }\n\n listPairs(filter?: {\n listed?: boolean;\n everListed?: boolean;\n atMs?: number;\n }): readonly EnrichedPairConfig[] {\n const pairs = this.getSnapshot().market.pairs;\n if (!filter) return pairs;\n const nowMs = filter.atMs ?? Date.now();\n return pairs.filter((pair) => {\n if (filter.listed !== undefined && isListed(pair, nowMs) !== filter.listed)\n return false;\n if (filter.everListed !== undefined && isEverListed(pair, nowMs) !== filter.everListed)\n return false;\n return true;\n });\n }\n\n getPair(pair: PairCatalogKey): EnrichedPairConfig \| null {\n const key = resolvePairKey(pair);\n return key.lookup === \"symbol\"\n ? this.getPairBySymbol(key.value)\n : this.getPairBySymbolId(key.value);\n }\n\n requirePair(pair: PairCatalogKey): EnrichedPairConfig {\n const key = resolvePairKey(pair);\n return requireFound(\"market\", key.lookup, key.value, this.getPair(pair));\n }\n\n getPairBySymbol(pairSymbol: string): EnrichedPairConfig \| null {\n return indexesFor(this.getSnapshot()).pairBySymbol.get(pairSymbol) ?? null;\n }\n\n requirePairBySymbol(pairSymbol: string): EnrichedPairConfig {\n return requireFound(\"market\", \"symbol\", pairSymbol, this.getPairBySymbol(pairSymbol));\n }\n\n getPairBySymbolId(pairSymbolId: number): EnrichedPairConfig \| null {\n return indexesFor(this.getSnapshot()).pairBySymbolId.get(pairSymbolId) ?? null;\n }\n\n requirePairBySymbolId(pairSymbolId: number): EnrichedPairConfig {\n return requireFound(\n \"market\",\n \"symbolId\",\n pairSymbolId,\n this.getPairBySymbolId(pairSymbolId),\n );\n }\n\n getSymbolIdByPairSymbol(pairSymbol: string): number \| null {\n return this.getPairBySymbol(pairSymbol)?.symbolId ?? null;\n }\n\n requireSymbolIdByPairSymbol(pairSymbol: string): number {\n return this.requirePairBySymbol(pairSymbol).symbolId;\n }\n\n getPairSymbolBySymbolId(pairSymbolId: number): string \| null {\n return this.getPairBySymbolId(pairSymbolId)?.symbol ?? null;\n }\n\n requirePairSymbolBySymbolId(pairSymbolId: number): string {\n return this.requirePairBySymbolId(pairSymbolId).symbol;\n }\n\n decimalPriceToTicks(price: string, pair: PairCatalogKey): ParsedCatalogAmount {\n return priceConverter(this.requirePair(pair)).parse(price);\n }\n\n normalizePriceInput(price: string, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).normalizeInput(price);\n }\n\n priceTicksToDecimalString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).toDecimalString(priceTicks);\n }\n\n priceTicksToDisplayString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).toDisplayString(priceTicks);\n }\n\n formatPrice(price: string, pair: PairCatalogKey): string {\n return priceConverter(this.requirePair(pair)).formatDecimal(price);\n }\n\n decimalQuantityToScaled(quantity: string, pair: PairCatalogKey): ParsedCatalogAmount {\n return quantityConverter(this.requirePair(pair)).parse(quantity);\n }\n\n normalizeQuantityInput(quantity: string, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).normalizeInput(quantity);\n }\n\n quantityScaledToDecimalString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).toDecimalString(quantityScaled);\n }\n\n quantityScaledToDisplayString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).toDisplayString(quantityScaled);\n }\n\n formatQuantity(quantity: string, pair: PairCatalogKey): string {\n return quantityConverter(this.requirePair(pair)).formatDecimal(quantity);\n }\n\n decimalQuoteAmountToScaled(amount: string, pair: PairCatalogKey): ParsedCatalogAmount {\n return quoteAmountConverter(this.requirePair(pair)).parse(amount);\n }\n\n normalizeQuoteAmountInput(amount: string, pair: PairCatalogKey): string {\n return quoteAmountConverter(this.requirePair(pair)).normalizeInput(amount);\n }\n\n quoteAmountScaledToDecimalString(\n amountScaled: ScaledIntegerLike,\n pair: PairCatalogKey,\n ): string {\n return quoteAmountConverter(this.requirePair(pair)).toDecimalString(amountScaled);\n }\n\n quoteAmountScaledToDisplayString(\n amountScaled: ScaledIntegerLike,\n pair: PairCatalogKey,\n ): string {\n return quoteAmountConverter(this.requirePair(pair)).toDisplayString(amountScaled);\n }\n\n formatQuoteAmount(amount: string, pair: PairCatalogKey): string {\n return quoteAmountConverter(this.requirePair(pair)).formatDecimal(amount);\n }\n}\n\nclass LedgerReader implements LedgerCatalogReader {\n constructor(private readonly market: MarketReader) {}\n\n getAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return this.market.getAssetByLedgerId(ledgerAssetId);\n }\n\n requireAssetByLedgerId(ledgerAssetId: number): AssetConfig {\n return this.getAssetByLedgerId(ledgerAssetId);\n }\n\n getAssetBySymbol(assetSymbol: string): AssetConfig \| null {\n return this.market.getAssetBySymbol(assetSymbol);\n }\n\n requireAssetBySymbol(assetSymbol: string): AssetConfig {\n return requireFound(\"ledger\", \"symbol\", assetSymbol, this.getAssetBySymbol(assetSymbol));\n }\n\n getLedgerIdBySymbol(assetSymbol: string): number \| null {\n return this.getAssetBySymbol(assetSymbol)?.ledgerId ?? null;\n }\n\n requireLedgerIdBySymbol(assetSymbol: string): number {\n return this.requireAssetBySymbol(assetSymbol).ledgerId;\n }\n\n requireSymbolByLedgerId(ledgerAssetId: number): string {\n return this.requireAssetByLedgerId(ledgerAssetId).symbol;\n }\n\n isKnownAssetId(ledgerAssetId: number): boolean {\n if (!Number.isInteger(ledgerAssetId) \|\| ledgerAssetId <= 0) return false;\n if (ledgerAssetId === UNKNOWN_LEDGER_ASSET_ID) return false;\n return this.market.lookupAssetByLedgerId(ledgerAssetId) !== null;\n }\n\n decimalAmountToScaled(amount: string, asset: AssetCatalogKey): ParsedCatalogAmount {\n return ledgerAmountConverter(this.requireAsset(asset)).parse(amount);\n }\n\n normalizeAmountInput(amount: string, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).normalizeInput(amount);\n }\n\n amountScaledToDecimalString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).toDecimalString(amountScaled);\n }\n\n amountScaledToDisplayString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).toDisplayString(amountScaled);\n }\n\n formatAmount(amount: string, asset: AssetCatalogKey): string {\n return ledgerAmountConverter(this.requireAsset(asset)).formatDecimal(amount);\n }\n\n private requireAsset(asset: AssetCatalogKey): AssetConfig {\n const key = resolveAssetKey(asset);\n const found =\n key.lookup === \"symbol\"\n ? this.getAssetBySymbol(key.value)\n : this.getAssetByLedgerId(key.value);\n return requireFound(\"ledger\", key.lookup, key.value, found);\n }\n}\n\nclass OrdersReader implements OrdersCatalogReader {\n constructor(private readonly market: MarketReader) {}\n\n getSpotOrderConstraints(pair: PairCatalogKey): SpotOrderConstraints {\n const config = this.market.requirePair(pair);\n return {\n symbolId: config.symbolId,\n symbol: config.symbol,\n status: config.status,\n tickSize: config.tickSize,\n stepSize: config.stepSize,\n minQtyBase: config.minQtyBase,\n minNotionalQuote: config.minNotionalQuote,\n priceScale: PRICE_SCALE,\n quantityScale: config.baseAsset.quantityScale,\n quoteAmountScale: config.quoteAsset.quantityScale,\n priceDisplayDecimals: priceConverter(config).displayDecimals,\n quantityDisplayDecimals: config.baseAsset.quantityDisplayDecimals,\n quoteAmountDisplayDecimals: config.quoteAsset.quantityDisplayDecimals,\n };\n }\n\n validateSpotOrderDecimalInput(input: SpotOrderDecimalInput): CatalogValidationResult {\n const pair = this.market.requirePair(input.pair);\n const errors: CatalogValidationError[] = [];\n\n const quantityScaled = this.validateQuantity(pair, input.quantity, errors);\n const priceTicks =\n input.price === undefined ? null : this.validatePrice(pair, input.price, errors);\n\n if (quantityScaled !== null && priceTicks !== null) {\n this.validateMinNotional(pair, quantityScaled, priceTicks, errors);\n }\n\n return { valid: errors.length === 0, errors };\n }\n\n assertSpotOrderDecimalInput(input: SpotOrderDecimalInput): void {\n const result = this.validateSpotOrderDecimalInput(input);\n if (!result.valid) throw new CatalogValidationFailedError(result.errors);\n }\n\n private validateQuantity(\n pair: EnrichedPairConfig,\n quantity: string,\n errors: CatalogValidationError[],\n ): bigint \| null {\n const scale = pair.baseAsset.quantityScale;\n const parsed = tryDecimalToScaled(quantity, scale);\n if (!parsed.ok) {\n errors.push({\n field: \"quantity\",\n rule: \"parse\",\n message: conversionFailureMessage(\"quantity\", quantity, parsed.failure),\n actual: quantity,\n });\n return null;\n }\n\n const step = this.requireConstraintScaled(pair.stepSize, scale, \"stepSize\");\n if (step > 0n && parsed.scaled % step !== 0n) {\n errors.push({\n field: \"quantity\",\n rule: \"stepSize\",\n message: `quantity must be a multiple of the pair step size ${pair.stepSize}`,\n expected: pair.stepSize,\n actual: quantity,\n });\n }\n\n const minQty = this.requireConstraintScaled(pair.minQtyBase, scale, \"minQtyBase\");\n if (parsed.scaled < minQty \|\| parsed.scaled === 0n) {\n errors.push({\n field: \"quantity\",\n rule: \"minQty\",\n message: `quantity is below the pair minimum of ${pair.minQtyBase}`,\n expected: pair.minQtyBase,\n actual: quantity,\n });\n }\n\n return parsed.scaled;\n }\n\n private validatePrice(\n pair: EnrichedPairConfig,\n price: string,\n errors: CatalogValidationError[],\n ): bigint \| null {\n const parsed = tryDecimalToScaled(price, PRICE_SCALE);\n if (!parsed.ok) {\n errors.push({\n field: \"price\",\n rule: \"parse\",\n message: conversionFailureMessage(\"price\", price, parsed.failure),\n actual: price,\n });\n return null;\n }\n\n const tick = this.requireConstraintScaled(pair.tickSize, PRICE_SCALE, \"tickSize\");\n if (tick > 0n && parsed.scaled % tick !== 0n) {\n errors.push({\n field: \"price\",\n rule: \"tickSize\",\n message: `price must be a multiple of the pair tick size ${pair.tickSize}`,\n expected: pair.tickSize,\n actual: price,\n });\n }\n\n return parsed.scaled;\n }\n\n private validateMinNotional(\n pair: EnrichedPairConfig,\n quantityScaled: bigint,\n priceTicks: bigint,\n errors: CatalogValidationError[],\n ): void {\n const notionalScale = pair.baseAsset.quantityScale + PRICE_SCALE;\n const minNotional = this.requireConstraintScaled(\n pair.minNotionalQuote,\n notionalScale,\n \"minNotionalQuote\",\n );\n const notional = quantityScaled priceTicks;\n if (notional < minNotional) {\n errors.push({\n field: \"notional\",\n rule: \"minNotional\",\n message: `order notional is below the pair minimum of ${pair.minNotionalQuote}`,\n expected: pair.minNotionalQuote,\n actual: scaledToDecimal(notional, notionalScale),\n });\n }\n }\n\n /** Pair constraint strings come from the catalog itself, so failures are data bugs. */\n private requireConstraintScaled(decimal: string, scale: number, field: string): bigint {\n const result = tryDecimalToScaled(decimal, scale);\n if (!result.ok) {\n throw new CatalogConversionError(\n field,\n conversionFailureMessage(field, decimal, result.failure),\n );\n }\n return result.scaled;\n }\n}\n\nclass ZipperReader implements ZipperCatalogReader {\n constructor(private readonly getSnapshot: SnapshotGetter) {}\n\n listChains(): readonly ZipperChainConfig[] {\n return this.getSnapshot().zipper.chains;\n }\n\n getChain(chain: ChainCatalogKey): ZipperChainConfig \| null {\n const key = resolveChainKey(chain);\n return key.lookup === \"chainCode\"\n ? this.getChainByCode(key.value)\n : this.getChainById(key.value);\n }\n\n requireChain(chain: ChainCatalogKey): ZipperChainConfig {\n const key = resolveChainKey(chain);\n return requireFound(\"zipper\", key.lookup, key.value, this.getChain(chain));\n }\n\n getChainByCode(chainCode: string): ZipperChainConfig \| null {\n return indexesFor(this.getSnapshot()).zipperChainByCode.get(chainCode) ?? null;\n }\n\n requireChainByCode(chainCode: string): ZipperChainConfig {\n return requireFound(\"zipper\", \"chainCode\", chainCode, this.getChainByCode(chainCode));\n }\n\n getChainById(chainId: number): ZipperChainConfig \| null {\n return indexesFor(this.getSnapshot()).zipperChainById.get(chainId) ?? null;\n }\n\n requireChainById(chainId: number): ZipperChainConfig {\n return requireFound(\"zipper\", \"chainId\", chainId, this.getChainById(chainId));\n }\n\n getChainIdByCode(chainCode: string): number \| null {\n return this.getChainByCode(chainCode)?.chainId ?? null;\n }\n\n requireChainIdByCode(chainCode: string): number {\n return this.requireChainByCode(chainCode).chainId;\n }\n\n listAssets(): readonly ZipperEnrichedAssetConfig[] {\n return this.getSnapshot().zipper.assets;\n }\n\n getAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig \| null {\n const key = resolveAssetKey(asset);\n return key.lookup === \"symbol\"\n ? this.getAssetBySymbol(key.value)\n : this.getAssetByLedgerId(key.value);\n }\n\n requireAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig {\n const key = resolveAssetKey(asset);\n return requireFound(\"zipper\", key.lookup, key.value, this.getAsset(asset));\n }\n\n getAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig \| null {\n return indexesFor(this.getSnapshot()).zipperAssetBySymbol.get(assetSymbol) ?? null;\n }\n\n requireAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig {\n return requireFound(\"zipper\", \"symbol\", assetSymbol, this.getAssetBySymbol(assetSymbol));\n }\n\n getAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig {\n return resolveZipperAssetByLedgerId(ledgerAssetId, (id) => this.lookupAssetByLedgerId(id));\n }\n\n lookupAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig \| null {\n return indexesFor(this.getSnapshot()).zipperAssetByLedgerId.get(ledgerAssetId) ?? null;\n }\n\n requireAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig {\n return this.getAssetByLedgerId(ledgerAssetId);\n }\n\n getAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig \| null {\n return indexesFor(this.getSnapshot()).zipperAssetByUAssetId.get(uAssetId) ?? null;\n }\n\n requireAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig {\n return requireFound(\"zipper\", \"uAssetId\", uAssetId, this.getAssetByUAssetId(uAssetId));\n }\n\n getAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute \| null {\n const zipperAsset = this.getAsset(asset);\n const zipperChain = this.getChain(chain);\n if (!zipperAsset \|\| !zipperChain) return null;\n const route = zipperAsset.chains.find(\n (candidate) => candidate.chainId === zipperChain.chainId,\n );\n return route ? { asset: zipperAsset, chain: route } : null;\n }\n\n requireAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute {\n const route = this.getAssetChain(asset, chain);\n if (!route) {\n throw new CatalogLookupError(\n \"zipper\",\n \"assetChain\",\n `${formatKey(resolveAssetKey(asset))}:${formatKey(resolveChainKey(chain))}`,\n );\n }\n return route;\n }\n\n getAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute \| null {\n return indexesFor(this.getSnapshot()).zipperRouteByZippedAssetId.get(zippedAssetId) ?? null;\n }\n\n requireAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute {\n return requireFound(\n \"zipper\",\n \"zippedAssetId\",\n zippedAssetId,\n this.getAssetChainByZippedAssetId(zippedAssetId),\n );\n }\n\n getZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number \| null {\n return this.getAssetChain(asset, chain)?.chain.zippedAssetId ?? null;\n }\n\n requireZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number {\n return this.requireAssetChain(asset, chain).chain.zippedAssetId;\n }\n\n listContracts(): readonly ZipperChainContractConfig[] {\n return this.getSnapshot().zipper.contracts;\n }\n\n getContract(contractName: ZipperContractName): ZipperChainContractConfig \| null {\n return this.getContractByName(contractName);\n }\n\n requireContract(contractName: ZipperContractName): ZipperChainContractConfig {\n return this.requireContractByName(contractName);\n }\n\n getContractByName(contractName: ZipperContractName): ZipperChainContractConfig \| null {\n return indexesFor(this.getSnapshot()).zipperContractByName.get(contractName) ?? null;\n }\n\n requireContractByName(contractName: ZipperContractName): ZipperChainContractConfig {\n return requireFound(\n \"zipper\",\n \"contractName\",\n contractName,\n this.getContractByName(contractName),\n );\n }\n}\n\nfunction formatKey(key: { lookup: string; value: string \| number }): string {\n return String(key.value);\n}\n\nclass SnapshotCatalogReader implements CatalogReader {\n readonly market: MarketCatalogReader;\n readonly ledger: LedgerCatalogReader;\n readonly orders: OrdersCatalogReader;\n readonly zipper: ZipperCatalogReader;\n readonly snapshot: () => CatalogSnapshot;\n\n constructor(getSnapshot: SnapshotGetter) {\n const market = new MarketReader(getSnapshot);\n this.market = market;\n this.ledger = new LedgerReader(market);\n this.orders = new OrdersReader(market);\n this.zipper = new ZipperReader(getSnapshot);\n this.snapshot = () => getSnapshot();\n }\n}\n\nexport function createReader(getSnapshot: () => CatalogSnapshot): CatalogReader {\n return new SnapshotCatalogReader(getSnapshot);\n}\n\nexport function createCatalogSnapshotReader(snapshot: CatalogSnapshot): CatalogReader {\n const parsed = parseCatalogSnapshot(snapshot);\n return createReader(() => parsed);\n}\n"],"mappings":"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"}

package/dist/catalogs/snapshot-validation.js ADDED Viewed

@@ -0,0 +1,132 @@
+import { ValidationError } from "../shared/errors.js";
+import { validation_exports } from "../shared/validation.js";
+import { PAIR_STATUSES } from "../shared/catalog-config.js";
+//#region src/catalogs/snapshot-validation.ts
+const FiniteNumberSchema = validation_exports.pipe(validation_exports.number(), validation_exports.finite());
+const IntegerSchema = validation_exports.pipe(FiniteNumberSchema, validation_exports.safeInteger());
+const AssetConfigSchema = validation_exports.object({
+	symbol: validation_exports.string(),
+	ledgerId: IntegerSchema,
+	name: validation_exports.string(),
+	quantityDisplayDecimals: IntegerSchema,
+	quantityScale: IntegerSchema
+});
+const PairMarketDataConfigSchema = validation_exports.object({ orderbookPriceBuckets: validation_exports.array(FiniteNumberSchema) });
+const EnrichedPairConfigSchema = validation_exports.object({
+	symbolId: IntegerSchema,
+	symbol: validation_exports.string(),
+	baseAsset: AssetConfigSchema,
+	quoteAsset: AssetConfigSchema,
+	tickSize: validation_exports.string(),
+	stepSize: validation_exports.string(),
+	minNotionalQuote: validation_exports.string(),
+	minQtyBase: validation_exports.string(),
+	allowBuyFeeFromBase: validation_exports.boolean(),
+	defaultMarketSlippagePctBuy: FiniteNumberSchema,
+	defaultMarketSlippagePctSell: FiniteNumberSchema,
+	maxClientRefDriftPct: FiniteNumberSchema,
+	marketdata: validation_exports.optional(PairMarketDataConfigSchema),
+	listingAt: validation_exports.nullable(FiniteNumberSchema),
+	delistingAt: validation_exports.nullable(FiniteNumberSchema),
+	status: validation_exports.picklist([...PAIR_STATUSES, "unknown"])
+});
+const ZipperChainConfigSchema = validation_exports.object({
+	chainId: IntegerSchema,
+	code: validation_exports.string(),
+	name: validation_exports.string(),
+	nativeChainId: validation_exports.string(),
+	nativeCurrencySymbol: validation_exports.string(),
+	explorerUrl: validation_exports.string(),
+	icon: validation_exports.string(),
+	requiredConfirmations: IntegerSchema,
+	confirmationTimeSeconds: IntegerSchema,
+	isCaseSensitive: validation_exports.boolean(),
+	minAddressLength: IntegerSchema,
+	maxAddressLength: IntegerSchema
+});
+const ZipperTokenConfigSchema = validation_exports.object({
+	address: validation_exports.string(),
+	decimals: IntegerSchema
+});
+const ZipperEnrichedAssetChainSchema = validation_exports.object({
+	...ZipperChainConfigSchema.entries,
+	zippedAssetId: IntegerSchema,
+	isNativeAsset: validation_exports.boolean(),
+	networkFee: validation_exports.optional(validation_exports.string()),
+	networkFeeTsSec: validation_exports.optional(FiniteNumberSchema),
+	depositMinAmount: validation_exports.optional(validation_exports.string()),
+	withdrawMinAmount: validation_exports.optional(validation_exports.string()),
+	supply: validation_exports.optional(validation_exports.string()),
+	sourceToken: ZipperTokenConfigSchema,
+	zToken: ZipperTokenConfigSchema
+});
+const ZipperEnrichedAssetConfigSchema = validation_exports.object({
+	asset: validation_exports.string(),
+	ledgerId: IntegerSchema,
+	name: validation_exports.string(),
+	icon: validation_exports.string(),
+	quantityScale: IntegerSchema,
+	quantityDisplayDecimals: IntegerSchema,
+	uAssetId: validation_exports.string(),
+	chains: validation_exports.array(ZipperEnrichedAssetChainSchema)
+});
+const ZipperChainContractConfigSchema = validation_exports.object({
+	name: validation_exports.string(),
+	address: validation_exports.string(),
+	type: validation_exports.string(),
+	description: validation_exports.string(),
+	version: IntegerSchema
+});
+const CatalogSnapshotShapeSchema = validation_exports.object({
+	source: validation_exports.picklist(["api", "snapshot"]),
+	tsMs: FiniteNumberSchema,
+	version: IntegerSchema,
+	market: validation_exports.object({
+		assets: validation_exports.array(AssetConfigSchema),
+		pairs: validation_exports.array(EnrichedPairConfigSchema),
+		tsSec: validation_exports.optional(FiniteNumberSchema)
+	}),
+	zipper: validation_exports.object({
+		chains: validation_exports.array(ZipperChainConfigSchema),
+		assets: validation_exports.array(ZipperEnrichedAssetConfigSchema),
+		contracts: validation_exports.array(ZipperChainContractConfigSchema),
+		tsMs: validation_exports.optional(FiniteNumberSchema)
+	})
+});
+const ZippedAssetSupplyCatalogUpdatesSchema = validation_exports.array(validation_exports.object({
+	zippedAssetId: IntegerSchema,
+	supply: validation_exports.string()
+}));
+const parsedSnapshots = /* @__PURE__ */ new WeakMap();
+function hasValidRelationships(snapshot) {
+	const assetSymbols = new Set(snapshot.market.assets.map((asset) => asset.symbol));
+	if (snapshot.market.pairs.some((pair) => !assetSymbols.has(pair.baseAsset.symbol) || !assetSymbols.has(pair.quoteAsset.symbol))) return false;
+	const chainIds = new Set(snapshot.zipper.chains.map((chain) => chain.chainId));
+	return snapshot.zipper.assets.every((asset) => asset.chains.every((chain) => chainIds.has(chain.chainId)));
+}
+const CatalogSnapshotSchema = validation_exports.custom((value) => {
+	const result = validation_exports.safeParse(CatalogSnapshotShapeSchema, value);
+	return result.success && hasValidRelationships(result.output);
+});
+/** Parses and caches untrusted SSR or JavaScript input as a catalog snapshot. */
+function parseCatalogSnapshot(value) {
+	if (typeof value !== "object" || value === null) throw new ValidationError("Catalog snapshot is malformed.");
+	const cached = parsedSnapshots.get(value);
+	if (cached) return cached;
+	const result = validation_exports.safeParse(CatalogSnapshotSchema, value);
+	if (!result.success) throw new ValidationError("Catalog snapshot is malformed.");
+	const snapshot = result.output;
+	parsedSnapshots.set(value, snapshot);
+	parsedSnapshots.set(snapshot, snapshot);
+	return snapshot;
+}
+/** Parses supply updates before they can advance a snapshot's version or timestamp. */
+function parseZippedAssetSupplyCatalogUpdates(value) {
+	const result = validation_exports.safeParse(ZippedAssetSupplyCatalogUpdatesSchema, value);
+	if (!result.success) throw new ValidationError("Zipper catalog supply updates are malformed.");
+	return result.output;
+}
+//#endregion
+export { parseCatalogSnapshot, parseZippedAssetSupplyCatalogUpdates };
+//# sourceMappingURL=snapshot-validation.js.map

package/dist/catalogs/snapshot-validation.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"snapshot-validation.js","names":["v"],"sources":["../../src/catalogs/snapshot-validation.ts"],"sourcesContent":["import * as v from \"../shared/validation.js\";\nimport { ValidationError } from \"../shared/errors.js\";\nimport { PAIR_STATUSES } from \"../shared/catalog-config.js\";\nimport type { CatalogSnapshot } from \"./types.js\";\nimport type { ZippedAssetSupplyCatalogUpdate } from \"./zipper-supply.js\";\n\nconst FiniteNumberSchema = v.pipe(v.number(), v.finite());\nconst IntegerSchema = v.pipe(FiniteNumberSchema, v.safeInteger());\n\nconst AssetConfigSchema = v.object({\n symbol: v.string(),\n ledgerId: IntegerSchema,\n name: v.string(),\n quantityDisplayDecimals: IntegerSchema,\n quantityScale: IntegerSchema,\n});\n\nconst PairMarketDataConfigSchema = v.object({\n orderbookPriceBuckets: v.array(FiniteNumberSchema),\n});\n\nconst EnrichedPairConfigSchema = v.object({\n symbolId: IntegerSchema,\n symbol: v.string(),\n baseAsset: AssetConfigSchema,\n quoteAsset: AssetConfigSchema,\n tickSize: v.string(),\n stepSize: v.string(),\n minNotionalQuote: v.string(),\n minQtyBase: v.string(),\n allowBuyFeeFromBase: v.boolean(),\n defaultMarketSlippagePctBuy: FiniteNumberSchema,\n defaultMarketSlippagePctSell: FiniteNumberSchema,\n maxClientRefDriftPct: FiniteNumberSchema,\n marketdata: v.optional(PairMarketDataConfigSchema),\n listingAt: v.nullable(FiniteNumberSchema),\n delistingAt: v.nullable(FiniteNumberSchema),\n status: v.picklist([...PAIR_STATUSES, \"unknown\"]),\n});\n\nconst ZipperChainConfigSchema = v.object({\n chainId: IntegerSchema,\n code: v.string(),\n name: v.string(),\n nativeChainId: v.string(),\n nativeCurrencySymbol: v.string(),\n explorerUrl: v.string(),\n icon: v.string(),\n requiredConfirmations: IntegerSchema,\n confirmationTimeSeconds: IntegerSchema,\n isCaseSensitive: v.boolean(),\n minAddressLength: IntegerSchema,\n maxAddressLength: IntegerSchema,\n});\n\nconst ZipperTokenConfigSchema = v.object({\n address: v.string(),\n decimals: IntegerSchema,\n});\n\nconst ZipperEnrichedAssetChainSchema = v.object({\n ...ZipperChainConfigSchema.entries,\n zippedAssetId: IntegerSchema,\n isNativeAsset: v.boolean(),\n networkFee: v.optional(v.string()),\n networkFeeTsSec: v.optional(FiniteNumberSchema),\n depositMinAmount: v.optional(v.string()),\n withdrawMinAmount: v.optional(v.string()),\n supply: v.optional(v.string()),\n sourceToken: ZipperTokenConfigSchema,\n zToken: ZipperTokenConfigSchema,\n});\n\nconst ZipperEnrichedAssetConfigSchema = v.object({\n asset: v.string(),\n ledgerId: IntegerSchema,\n name: v.string(),\n icon: v.string(),\n quantityScale: IntegerSchema,\n quantityDisplayDecimals: IntegerSchema,\n uAssetId: v.string(),\n chains: v.array(ZipperEnrichedAssetChainSchema),\n});\n\nconst ZipperChainContractConfigSchema = v.object({\n name: v.string(),\n address: v.string(),\n type: v.string(),\n description: v.string(),\n version: IntegerSchema,\n});\n\nconst CatalogSnapshotShapeSchema = v.object({\n source: v.picklist([\"api\", \"snapshot\"]),\n tsMs: FiniteNumberSchema,\n version: IntegerSchema,\n market: v.object({\n assets: v.array(AssetConfigSchema),\n pairs: v.array(EnrichedPairConfigSchema),\n tsSec: v.optional(FiniteNumberSchema),\n }),\n zipper: v.object({\n chains: v.array(ZipperChainConfigSchema),\n assets: v.array(ZipperEnrichedAssetConfigSchema),\n contracts: v.array(ZipperChainContractConfigSchema),\n tsMs: v.optional(FiniteNumberSchema),\n }),\n});\n\nconst ZippedAssetSupplyCatalogUpdatesSchema = v.array(\n v.object({\n zippedAssetId: IntegerSchema,\n supply: v.string(),\n }),\n);\n\nconst parsedSnapshots = new WeakMap<object, CatalogSnapshot>();\n\nfunction hasValidRelationships(\n snapshot: v.InferOutput<typeof CatalogSnapshotShapeSchema>,\n): boolean {\n const assetSymbols = new Set(snapshot.market.assets.map((asset) => asset.symbol));\n if (\n snapshot.market.pairs.some(\n (pair) =>\n !assetSymbols.has(pair.baseAsset.symbol) ||\n !assetSymbols.has(pair.quoteAsset.symbol),\n )\n ) {\n return false;\n }\n\n const chainIds = new Set(snapshot.zipper.chains.map((chain) => chain.chainId));\n return snapshot.zipper.assets.every((asset) =>\n asset.chains.every((chain) => chainIds.has(chain.chainId)),\n );\n}\n\nconst CatalogSnapshotSchema = v.custom<CatalogSnapshot>((value) => {\n const result = v.safeParse(CatalogSnapshotShapeSchema, value);\n return result.success && hasValidRelationships(result.output);\n});\n\n/** Parses and caches untrusted SSR or JavaScript input as a catalog snapshot. */\nexport function parseCatalogSnapshot(value: unknown): CatalogSnapshot {\n if (typeof value !== \"object\" || value === null) {\n throw new ValidationError(\"Catalog snapshot is malformed.\");\n }\n\n const cached = parsedSnapshots.get(value);\n if (cached) return cached;\n\n const result = v.safeParse(CatalogSnapshotSchema, value);\n if (!result.success) {\n throw new ValidationError(\"Catalog snapshot is malformed.\");\n }\n\n const snapshot: CatalogSnapshot = result.output;\n parsedSnapshots.set(value, snapshot);\n parsedSnapshots.set(snapshot, snapshot);\n return snapshot;\n}\n\n/** Parses supply updates before they can advance a snapshot's version or timestamp. */\nexport function parseZippedAssetSupplyCatalogUpdates(\n value: unknown,\n): readonly ZippedAssetSupplyCatalogUpdate[] {\n const result = v.safeParse(ZippedAssetSupplyCatalogUpdatesSchema, value);\n if (!result.success) {\n throw new ValidationError(\"Zipper catalog supply updates are malformed.\");\n }\n return result.output;\n}\n"],"mappings":"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"}

package/dist/catalogs/snapshot.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"snapshot.d.ts","names":[],"sources":["../../src/catalogs/snapshot.ts"],"mappings":";;;;~~KAIY~~;WACC,QAAQ;WACR,QAAQ;;iBAGL,qBAAqB;EACjC,QAAQ;EACR,QAAQ;EACR,SAAS;EACT;EACA;IACA"}
1	+ {"version":3,"file":"snapshot.d.ts","names":[],"sources":["../../src/catalogs/snapshot.ts"],"mappings":";;;;KAMY;WACC,QAAQ;WACR,QAAQ;;iBAGL,qBAAqB;EACjC,QAAQ;EACR,QAAQ;EACR,SAAS;EACT;EACA;IACA"}

package/dist/catalogs/snapshot.js CHANGED Viewed

@@ -1,14 +1,23 @@
+import { ValidationError } from "../shared/errors.js";
+import { parseCatalogSnapshot } from "./snapshot-validation.js";
 import { buildMarketCatalogData } from "./market-data-catalog.js";
 import { buildZipperCatalogData } from "./zipper-catalog.js";
 //#region src/catalogs/snapshot.ts
 function buildCatalogSnapshot(params) {
-	return Object.freeze({
-		source: params.source ?? "snapshot",
-		tsMs: params.tsMs ?? Date.now(),
-		version: params.version ?? 1,
-		market: buildMarketCatalogData(params.market),
-		zipper: buildZipperCatalogData(params.zipper)
-	});
+	if (typeof params !== "object" || params === null || Array.isArray(params)) throw new ValidationError("Catalog snapshot input must be an object.");
+	if (typeof params.market !== "object" || params.market === null || !Array.isArray(params.market.assets) || !Array.isArray(params.market.pairs) || typeof params.zipper !== "object" || params.zipper === null || !Array.isArray(params.zipper.chains) || !Array.isArray(params.zipper.assets)) throw new ValidationError("Catalog snapshot input requires valid market and zipper seeds.");
+	try {
+		return parseCatalogSnapshot(Object.freeze({
+			source: params.source ?? "snapshot",
+			tsMs: params.tsMs ?? Date.now(),
+			version: params.version ?? 1,
+			market: buildMarketCatalogData(params.market),
+			zipper: buildZipperCatalogData(params.zipper)
+		}));
+	} catch (error) {
+		if (error instanceof ValidationError) throw error;
+		throw new ValidationError("Catalog snapshot input is malformed.", { cause: error });
+	}
 }
 //#endregion
 export { buildCatalogSnapshot };

package/dist/catalogs/snapshot.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"snapshot.js","names":[],"sources":["../../src/catalogs/snapshot.ts"],"sourcesContent":["import { buildMarketCatalogData, type MarketCatalogSeed } from \"./market-data-catalog.js\";\nimport type { CatalogSnapshot } from \"./types.js\";\nimport { buildZipperCatalogData, type ZipperCatalogSeed } from \"./zipper-catalog.js\";\n\nexport type CatalogSnapshotInput = {\n readonly market: MarketCatalogSeed;\n readonly zipper: ZipperCatalogSeed;\n};\n\nexport function buildCatalogSnapshot(params: {\n market: MarketCatalogSeed;\n zipper: ZipperCatalogSeed;\n source?: CatalogSnapshot[\"source\"];\n version?: number;\n tsMs?: number;\n}): CatalogSnapshot {\n return Object.freeze({\n source: params.source ?? \"snapshot\",\n tsMs: params.tsMs ?? Date.now(),\n version: params.version ?? 1,\n market: buildMarketCatalogData(params.market),\n zipper: buildZipperCatalogData(params.zipper),\n });\n}\n"],"mappings":"~~;;;AASA~~,SAAgB,qBAAqB,QAMjB;CAChB,OAAO,OAAO,OAAO;~~EACjB~~,QAAQ,OAAO,UAAU;~~EACzB~~,MAAM,OAAO,QAAQ,KAAK,IAAI;~~EAC9B~~,SAAS,OAAO,WAAW;~~EAC3B~~,QAAQ,uBAAuB,OAAO,MAAM;~~EAC5C~~,QAAQ,uBAAuB,OAAO,MAAM;~~CAChD~~,CAAC;~~AACL~~"}
1	+ {"version":3,"file":"snapshot.js","names":[],"sources":["../../src/catalogs/snapshot.ts"],"sourcesContent":["import { buildMarketCatalogData, type MarketCatalogSeed } from \"./market-data-catalog.js\";\nimport type { CatalogSnapshot } from \"./types.js\";\nimport { buildZipperCatalogData, type ZipperCatalogSeed } from \"./zipper-catalog.js\";\nimport { ValidationError } from \"../shared/errors.js\";\nimport { parseCatalogSnapshot } from \"./snapshot-validation.js\";\n\nexport type CatalogSnapshotInput = {\n readonly market: MarketCatalogSeed;\n readonly zipper: ZipperCatalogSeed;\n};\n\nexport function buildCatalogSnapshot(params: {\n market: MarketCatalogSeed;\n zipper: ZipperCatalogSeed;\n source?: CatalogSnapshot[\"source\"];\n version?: number;\n tsMs?: number;\n}): CatalogSnapshot {\n if (typeof params !== \"object\" \|\| params === null \|\| Array.isArray(params)) {\n throw new ValidationError(\"Catalog snapshot input must be an object.\");\n }\n if (\n typeof params.market !== \"object\" \|\|\n params.market === null \|\|\n !Array.isArray(params.market.assets) \|\|\n !Array.isArray(params.market.pairs) \|\|\n typeof params.zipper !== \"object\" \|\|\n params.zipper === null \|\|\n !Array.isArray(params.zipper.chains) \|\|\n !Array.isArray(params.zipper.assets)\n ) {\n throw new ValidationError(\"Catalog snapshot input requires valid market and zipper seeds.\");\n }\n\n try {\n return parseCatalogSnapshot(\n Object.freeze({\n source: params.source ?? \"snapshot\",\n tsMs: params.tsMs ?? Date.now(),\n version: params.version ?? 1,\n market: buildMarketCatalogData(params.market),\n zipper: buildZipperCatalogData(params.zipper),\n }),\n );\n } catch (error) {\n if (error instanceof ValidationError) throw error;\n throw new ValidationError(\"Catalog snapshot input is malformed.\", { cause: error });\n }\n}\n"],"mappings":";;;;;AAWA,SAAgB,qBAAqB,QAMjB;CAChB,IAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,MAAM,QAAQ,MAAM,GACrE,MAAM,IAAI,gBAAgB,2CAA2C;CAEzE,IACI,OAAO,OAAO,WAAW,YACzB,OAAO,WAAW,QAClB,CAAC,MAAM,QAAQ,OAAO,OAAO,MAAM,KACnC,CAAC,MAAM,QAAQ,OAAO,OAAO,KAAK,KAClC,OAAO,OAAO,WAAW,YACzB,OAAO,WAAW,QAClB,CAAC,MAAM,QAAQ,OAAO,OAAO,MAAM,KACnC,CAAC,MAAM,QAAQ,OAAO,OAAO,MAAM,GAEnC,MAAM,IAAI,gBAAgB,gEAAgE;CAG9F,IAAI;EACA,OAAO,qBACH,OAAO,OAAO;GACV,QAAQ,OAAO,UAAU;GACzB,MAAM,OAAO,QAAQ,KAAK,IAAI;GAC9B,SAAS,OAAO,WAAW;GAC3B,QAAQ,uBAAuB,OAAO,MAAM;GAC5C,QAAQ,uBAAuB,OAAO,MAAM;EAChD,CAAC,CACL;CACJ,SAAS,OAAO;EACZ,IAAI,iBAAiB,iBAAiB,MAAM;EAC5C,MAAM,IAAI,gBAAgB,wCAAwC,EAAE,OAAO,MAAM,CAAC;CACtF;AACJ"}

package/dist/catalogs/zipper-supply.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"zipper-supply.d.ts","names":[],"sources":["../../src/catalogs/zipper-supply.ts"],"mappings":";;~~KAEY~~;EACR;EACA;;iBAGY,yBACZ,UAAU,iBACV,kBAAkB,mCACnB"}
1	+ {"version":3,"file":"zipper-supply.d.ts","names":[],"sources":["../../src/catalogs/zipper-supply.ts"],"mappings":";;KAMY;EACR;EACA;;iBAGY,yBACZ,UAAU,iBACV,kBAAkB,mCACnB"}

package/dist/catalogs/zipper-supply.js CHANGED Viewed

@@ -1,10 +1,13 @@
+import { parseCatalogSnapshot, parseZippedAssetSupplyCatalogUpdates } from "./snapshot-validation.js";
 //#region src/catalogs/zipper-supply.ts
 function patchZipperCatalogSupply(snapshot, updates) {
-	if (updates.length === 0) return snapshot;
+	const parsedSnapshot = parseCatalogSnapshot(snapshot);
+	const parsedUpdates = parseZippedAssetSupplyCatalogUpdates(updates);
+	if (parsedUpdates.length === 0) return parsedSnapshot;
 	const supplyByZippedAssetId = /* @__PURE__ */ new Map();
-	for (const update of updates) supplyByZippedAssetId.set(update.zippedAssetId, update.supply);
+	for (const update of parsedUpdates) supplyByZippedAssetId.set(update.zippedAssetId, update.supply);
 	let changed = false;
-	const assets = snapshot.zipper.assets.map((asset) => {
+	const assets = parsedSnapshot.zipper.assets.map((asset) => {
 		let assetChanged = false;
 		const chains = asset.chains.map((chain) => {
 			const supply = supplyByZippedAssetId.get(chain.zippedAssetId);
@@ -21,14 +24,14 @@ function patchZipperCatalogSupply(snapshot, updates) {
 			chains
 		} : asset;
 	});
-	if (!changed) return snapshot;
+	if (!changed) return parsedSnapshot;
 	const nowMs = Date.now();
 	return {
-		...snapshot,
+		...parsedSnapshot,
 		tsMs: nowMs,
-		version: snapshot.version + 1,
+		version: parsedSnapshot.version + 1,
 		zipper: {
-			...snapshot.zipper,
+			...parsedSnapshot.zipper,
 			tsMs: nowMs,
 			assets
 		}

package/dist/catalogs/zipper-supply.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"zipper-supply.js","names":[],"sources":["../../src/catalogs/zipper-supply.ts"],"sourcesContent":["import type { CatalogSnapshot } from \"./types.js\";\n\nexport type ZippedAssetSupplyCatalogUpdate = {\n zippedAssetId: number;\n supply: string;\n};\n\nexport function patchZipperCatalogSupply(\n snapshot: CatalogSnapshot,\n updates: readonly ZippedAssetSupplyCatalogUpdate[],\n): CatalogSnapshot {\n if (~~updates~~.length === 0) return ~~snapshot~~;\n\n const supplyByZippedAssetId = new Map<number, string>();\n for (const update of ~~updates~~) {\n supplyByZippedAssetId.set(update.zippedAssetId, update.supply);\n }\n\n let changed = false;\n const assets = ~~snapshot~~.zipper.assets.map((asset) => {\n let assetChanged = false;\n const chains = asset.chains.map((chain) => {\n const supply = supplyByZippedAssetId.get(chain.zippedAssetId);\n if (supply === undefined \|\| supply === chain.supply) return chain;\n assetChanged = true;\n changed = true;\n return { ...chain, supply };\n });\n\n return assetChanged ? { ...asset, chains } : asset;\n });\n\n if (!changed) return ~~snapshot~~;\n const nowMs = Date.now();\n\n return {\n ...~~snapshot~~,\n tsMs: nowMs,\n version: ~~snapshot~~.version + 1,\n zipper: {\n ...~~snapshot~~.zipper,\n tsMs: nowMs,\n assets,\n },\n };\n}\n"],"mappings":"~~;AAOA~~,SAAgB,yBACZ,UACA,SACe;CACf,~~IAAI~~,QAAQ,WAAW,GAAG,OAAO;~~CAEjC~~,MAAM,wCAAwB,IAAI,IAAoB;CACtD,KAAK,MAAM,UAAU,~~SACjB~~,sBAAsB,IAAI,OAAO,eAAe,OAAO,MAAM;CAGjE,IAAI,UAAU;CACd,MAAM,SAAS,~~SAAS~~,OAAO,OAAO,KAAK,UAAU;~~EACjD~~,IAAI,eAAe;EACnB,MAAM,SAAS,MAAM,OAAO,KAAK,UAAU;GACvC,MAAM,SAAS,sBAAsB,IAAI,MAAM,aAAa;GAC5D,IAAI,WAAW,KAAA,KAAa,WAAW,MAAM,QAAQ,OAAO;GAC5D,eAAe;GACf,UAAU;GACV,OAAO;IAAE,GAAG;IAAO;GAAO;EAC9B,CAAC;EAED,OAAO,eAAe;GAAE,GAAG;GAAO;EAAO,IAAI;CACjD,CAAC;CAED,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,QAAQ,KAAK,IAAI;CAEvB,OAAO;EACH,GAAG;EACH,MAAM;EACN,SAAS,~~SAAS~~,UAAU;~~EAC5B~~,QAAQ;GACJ,GAAG,~~SAAS~~;~~GACZ~~,MAAM;GACN;EACJ;CACJ;AACJ"}
1	+ {"version":3,"file":"zipper-supply.js","names":[],"sources":["../../src/catalogs/zipper-supply.ts"],"sourcesContent":["import type { CatalogSnapshot } from \"./types.js\";\nimport {\n parseCatalogSnapshot,\n parseZippedAssetSupplyCatalogUpdates,\n} from \"./snapshot-validation.js\";\n\nexport type ZippedAssetSupplyCatalogUpdate = {\n zippedAssetId: number;\n supply: string;\n};\n\nexport function patchZipperCatalogSupply(\n snapshot: CatalogSnapshot,\n updates: readonly ZippedAssetSupplyCatalogUpdate[],\n): CatalogSnapshot {\n const parsedSnapshot = parseCatalogSnapshot(snapshot);\n const parsedUpdates = parseZippedAssetSupplyCatalogUpdates(updates);\n if (parsedUpdates.length === 0) return parsedSnapshot;\n\n const supplyByZippedAssetId = new Map<number, string>();\n for (const update of parsedUpdates) {\n supplyByZippedAssetId.set(update.zippedAssetId, update.supply);\n }\n\n let changed = false;\n const assets = parsedSnapshot.zipper.assets.map((asset) => {\n let assetChanged = false;\n const chains = asset.chains.map((chain) => {\n const supply = supplyByZippedAssetId.get(chain.zippedAssetId);\n if (supply === undefined \|\| supply === chain.supply) return chain;\n assetChanged = true;\n changed = true;\n return { ...chain, supply };\n });\n\n return assetChanged ? { ...asset, chains } : asset;\n });\n\n if (!changed) return parsedSnapshot;\n const nowMs = Date.now();\n\n return {\n ...parsedSnapshot,\n tsMs: nowMs,\n version: parsedSnapshot.version + 1,\n zipper: {\n ...parsedSnapshot.zipper,\n tsMs: nowMs,\n assets,\n },\n };\n}\n"],"mappings":";;AAWA,SAAgB,yBACZ,UACA,SACe;CACf,MAAM,iBAAiB,qBAAqB,QAAQ;CACpD,MAAM,gBAAgB,qCAAqC,OAAO;CAClE,IAAI,cAAc,WAAW,GAAG,OAAO;CAEvC,MAAM,wCAAwB,IAAI,IAAoB;CACtD,KAAK,MAAM,UAAU,eACjB,sBAAsB,IAAI,OAAO,eAAe,OAAO,MAAM;CAGjE,IAAI,UAAU;CACd,MAAM,SAAS,eAAe,OAAO,OAAO,KAAK,UAAU;EACvD,IAAI,eAAe;EACnB,MAAM,SAAS,MAAM,OAAO,KAAK,UAAU;GACvC,MAAM,SAAS,sBAAsB,IAAI,MAAM,aAAa;GAC5D,IAAI,WAAW,KAAA,KAAa,WAAW,MAAM,QAAQ,OAAO;GAC5D,eAAe;GACf,UAAU;GACV,OAAO;IAAE,GAAG;IAAO;GAAO;EAC9B,CAAC;EAED,OAAO,eAAe;GAAE,GAAG;GAAO;EAAO,IAAI;CACjD,CAAC;CAED,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,QAAQ,KAAK,IAAI;CAEvB,OAAO;EACH,GAAG;EACH,MAAM;EACN,SAAS,eAAe,UAAU;EAClC,QAAQ;GACJ,GAAG,eAAe;GAClB,MAAM;GACN;EACJ;CACJ;AACJ"}

package/dist/core-client.d.ts CHANGED Viewed

@@ -58,7 +58,7 @@ import "./services/mfa/index.js";
 import { Interceptor } from "@connectrpc/connect";
 //#region src/core-client.d.ts
 type PolyesterRealtimeAuthConfig = Pick<RealtimeConfig, "getAuthHeaders" | "hasAuth">;
-interface PolyesterClientBaseConfig {
+interface PolyesterClientCommonConfig {
   environment: PolyesterEnvironment;
   interceptors?: Interceptor[];
   auth?: JwtAuthProvider | ApiKeyEd25519AuthProvider;
@@ -68,21 +68,6 @@ interface PolyesterClientBaseConfig {
    * Use `json` for human-readable debugging.
    */
   wireFormat?: "binary" | "json";
-  /**
-   * Client-owned catalog store. Advanced callers can inject a fully managed catalog instance.
-   */
-  catalog?: ClientCatalog;
-  /**
-   * Explicit initial catalog snapshot, commonly hydrated from server-rendered data.
-   * Combines with `catalogCell` as the cell's initial value (never clobbers a
-   * pre-populated cell).
-   */
-  catalogSnapshot?: CatalogSnapshot;
-  /**
-   * External snapshot storage for the client-built catalog (mutually exclusive with
-   * `catalog`). A cell backed by a reactive source makes every catalog read reactive.
-   */
-  catalogCell?: CatalogSnapshotCell;
   /**
    * Advanced: inject pre-built Connect transports (in-memory mocks, custom
    * stacks). When provided, the SDK does not build its own transports and the
@@ -97,7 +82,29 @@ interface PolyesterClientBaseConfig {
    */
   realtimeClient?: PolyesterRealtime;
 }
-interface PolyesterClientConfig extends PolyesterClientBaseConfig {}
+type PolyesterCatalogConfig = {
+  /** Client-owned catalog store. */
+  catalog: ClientCatalog;
+  catalogSnapshot?: never;
+  catalogCell?: never;
+} | {
+  catalog?: never;
+  /**
+   * Explicit initial catalog snapshot, commonly hydrated from server-rendered data.
+   * Combines with `catalogCell` as the cell's initial value without clobbering a
+   * pre-populated cell.
+   */
+  catalogSnapshot?: CatalogSnapshot;
+  /**
+   * External snapshot storage for the client-built catalog. A cell backed by a
+   * reactive source makes every catalog read reactive.
+   */
+  catalogCell?: CatalogSnapshotCell;
+};
+/** Configuration shared by every Polyester client. */
+type PolyesterClientBaseConfig = PolyesterClientCommonConfig & PolyesterCatalogConfig;
+/** Configuration for the base Polyester client. */
+type PolyesterClientConfig = PolyesterClientBaseConfig;
 interface AuthServiceFactoryContext {
   transports: AuthServiceTransports;
   realtime: PolyesterRealtime;

package/dist/core-client.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"core-client.d.ts","names":[],"sources":["../src/core-client.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4EY,8BAA8B,KAAK;~~UAE9B~~;~~EACb~~,aAAa;EACb,eAAe;EACf,OAAO,kBAAkB;EACzB,WAAW;;;;;EAKX~~;;;;EAIA~~,~~UAAU~~;;;;;;~~EAMV~~,kBAAkB;;;;;EAKlB,cAAc~~;;;;;;;EAOd~~,~~aAAa;;;;;;EAMb~~,~~iBAAiB~~;;~~UAGJ~~,~~8BAA8B~~;~~UAErC~~;EACN,YAAY;EACZ,UAAU;EACV,aAAa;EACb,aAAa;;UAGP;EACN,cAAc,SAAS,8BAA8B;;;;;;;;;~~cAU5C~~;;qBACU,YAAY;EA2CnB,YAAA,QAAQ,uBAAuB,UAAS;~~MA6BhD~~,YAAY;MAoBZ,WAAW;MAwCX,QAAQ;MAcR,YAAY;MAIZ,WAAW;MAQX,eAAe;MAQf,WAAW;MAQX,kBAAkB;MAOlB,cAAc;MAQd,kBAAkB;MAQlB,aAAa;MAQb,WAAW;MAQX,aAAa;MAIb,UAAU;MASV,UAAU;MASV,YAAY;MASZ,YAAY;MASZ,aAAa;MASb,qBAAqB;MAQrB,oBAAoB;MAapB,WAAW;MAIX,eAAe;MAQf,eAAe;MAOf,sBAAsB;MAMtB,cAAc;MAId,UAAU;MAQV,OAAO;;;;;YAQD,4BAA4B"}
1	+ {"version":3,"file":"core-client.d.ts","names":[],"sources":["../src/core-client.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4EY,8BAA8B,KAAK;UAErC;EACN,aAAa;EACb,eAAe;EACf,OAAO,kBAAkB;EACzB,WAAW;;;;;EAKX;;;;;;;EAOA,aAAa;;;;;;EAMb,iBAAiB;;KAGhB;;EAGK,SAAS;EACT;EACA;;EAGA;;;;;;EAMA,kBAAkB;;;;;EAKlB,cAAc;;;KAIZ,4BAA4B,8BAA8B;;KAG1D,wBAAwB;UAc1B;EACN,YAAY;EACZ,UAAU;EACV,aAAa;EACb,aAAa;;UAGP;EACN,cAAc,SAAS,8BAA8B;;;;;;;;;cAqC5C;;qBACU,YAAY;EA2CnB,YAAA,QAAQ,uBAAuB,UAAS;MAyBhD,YAAY;MAoBZ,WAAW;MAwCX,QAAQ;MAcR,YAAY;MAIZ,WAAW;MAQX,eAAe;MAQf,WAAW;MAQX,kBAAkB;MAOlB,cAAc;MAQd,kBAAkB;MAQlB,aAAa;MAQb,WAAW;MAQX,aAAa;MAIb,UAAU;MASV,UAAU;MASV,YAAY;MASZ,YAAY;MASZ,aAAa;MASb,qBAAqB;MAQrB,oBAAoB;MAapB,WAAW;MAIX,eAAe;MAQf,eAAe;MAOf,sBAAsB;MAMtB,cAAc;MAId,UAAU;MAQV,OAAO;;;;;YAQD,4BAA4B"}

package/dist/core-client.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import { ConfigurationError } from "./shared/errors.js";
 import { createApiKeyEd25519AuthHeaders, createTransports } from "./shared/transports.js";
+import { parsePolyesterEnvironment } from "./environment.js";
 import { AccountsService } from "./services/accounts/accounts.js";
 import { ApiKeysService } from "./services/api-keys/api-keys.js";
 import { AuthService } from "./services/auth/auth.js";
@@ -52,6 +53,24 @@ function realtimeAuthFromProvider(auth) {
 		hasAuth: () => true
 	};
 }
+/** Preserves the exclusive catalog configuration while projecting client config fields. */
+function pickPolyesterCatalogConfig(config) {
+	return config.catalog === void 0 ? {
+		catalogSnapshot: config.catalogSnapshot,
+		catalogCell: config.catalogCell
+	} : { catalog: config.catalog };
+}
+/**
+* Parses the configuration shared by every public client constructor.
+*/
+function parsePolyesterClientConfig(config) {
+	if (typeof config !== "object" || config === null || Array.isArray(config)) throw new ConfigurationError("Client configuration must be an object.");
+	const environment = parsePolyesterEnvironment(config.environment);
+	if (config.wireFormat !== void 0 && config.wireFormat !== "binary" && config.wireFormat !== "json") throw new ConfigurationError("wireFormat must be either \"binary\" or \"json\".");
+	if (config.catalog && config.catalogSnapshot) throw new ConfigurationError("Provide either catalog or catalogSnapshot, not both.");
+	if (config.catalog && config.catalogCell) throw new ConfigurationError("Provide either catalog or catalogCell, not both.");
+	return Object.assign({}, config, { environment });
+}
 /**
 * Base SDK client that wires transports, realtime, catalogs, and all public service clients for a Polyester environment.
 *
@@ -100,10 +119,9 @@ var PolyesterClient = class {
 	#zipper;
 	#mfa;
 	constructor(config, runtime = {}) {
+		config = parsePolyesterClientConfig(config);
 		const interceptors = config.interceptors ?? [];
 		const { environment } = config;
-		if (config.catalog && config.catalogSnapshot) throw new ConfigurationError("Provide either catalog or catalogSnapshot, not both.");
-		if (config.catalog && config.catalogCell) throw new ConfigurationError("Provide either catalog or catalogCell, not both.");
 		this.transports = config.transports ?? createTransports({
 			apiUrl: environment.apiUrl,
 			interceptors,
@@ -261,6 +279,6 @@ var PolyesterClient = class {
 	createSubaccountResolver() {}
 };
 //#endregion
-export { PolyesterClient };
+export { PolyesterClient, parsePolyesterClientConfig, pickPolyesterCatalogConfig };
 //# sourceMappingURL=core-client.js.map