@polyester/sdk 0.0.0

package/dist/catalogs/snapshot.js.map

@@ -0,0 +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"}

package/dist/catalogs/types.d.ts

@@ -0,0 +1,268 @@
+import { AssetConfig, DepositWithdrawConfig, PairStatus, SpotConfig, ZipperChainConfig, ZipperChainContractConfig } from "../shared/catalog-config.js";
+import { EnrichedPairConfig, MarketCatalogData } from "./market-data-catalog.js";
+import { RequestError, ValidationError } from "../shared/errors.js";
+import { ZipperCatalogData, ZipperContractName, ZipperEnrichedAssetChain, ZipperEnrichedAssetConfig } from "./zipper-catalog.js";
+//#region src/catalogs/types.d.ts
+/** Pair lookup key: symbol, symbolId, or an explicit object form. */
+type PairCatalogKey = string | number | {
+  symbol: string;
+} | {
+  symbolId: number;
+};
+/** Asset lookup key: symbol, ledger id, or an explicit object form. */
+type AssetCatalogKey = string | number | {
+  symbol: string;
+} | {
+  ledgerId: number;
+};
+/** Chain lookup key: chain code, chain id, or an explicit object form. */
+type ChainCatalogKey = string | number | {
+  code: string;
+} | {
+  chainId: number;
+};
+/** Raw scaled integer accepted on the SDK side of catalog conversions. */
+type ScaledIntegerLike = bigint | number | string;
+type CatalogLookupDomain = "market" | "ledger" | "orders" | "zipper";
+type CatalogSnapshotSource = "api" | "snapshot";
+type CatalogStateSource = CatalogSnapshotSource | "empty";
+/** A catalog lookup key (pair, asset, chain, …) did not match any entry. */
+declare class CatalogLookupError extends RequestError {
+  readonly domain: CatalogLookupDomain;
+  readonly lookup: string;
+  readonly value: string | number;
+  readonly code = "CATALOG_LOOKUP_MISS";
+  constructor(domain: CatalogLookupDomain, lookup: string, value: string | number);
+}
+/** The catalog has no snapshot yet — call `catalog.ensureReady()` first. */
+declare class CatalogNotReadyError extends RequestError {
+  readonly code = "CATALOG_NOT_READY";
+  constructor();
+}
+/** A decimal/scaled conversion failed (bad input or excess precision). */
+declare class CatalogConversionError extends ValidationError {
+  readonly field: string;
+  readonly code = "CATALOG_CONVERSION_INVALID";
+  constructor(field: string, message: string);
+}
+/** Order input failed validation against pair constraints. */
+declare class CatalogValidationFailedError extends ValidationError {
+  readonly errors: readonly CatalogValidationError[];
+  readonly code = "CATALOG_VALIDATION_FAILED";
+  constructor(errors: readonly CatalogValidationError[]);
+}
+/**
+ * Result of a strict decimal-to-SDK conversion. `scaledValue` is the raw
+ * JSON-safe integer string for service calls; `decimal` is the exact decimal
+ * string; `display` is the display-normalized decimal string.
+ */
+interface ParsedCatalogAmount {
+  readonly scaledValue: string;
+  readonly decimal: string;
+  readonly display: string;
+  readonly scale: number;
+}
+interface CatalogValidationError {
+  readonly field: string;
+  readonly rule: string;
+  readonly message: string;
+  readonly expected?: string;
+  readonly actual?: string;
+}
+interface CatalogValidationResult {
+  readonly valid: boolean;
+  readonly errors: readonly CatalogValidationError[];
+}
+/** Trading constraints for a spot pair, for UI decisions and input validation. */
+interface SpotOrderConstraints {
+  readonly symbolId: number;
+  readonly symbol: string;
+  readonly status: PairStatus;
+  readonly tickSize: string;
+  readonly stepSize: string;
+  readonly minQtyBase: string;
+  readonly minNotionalQuote: string;
+  readonly priceScale: number;
+  readonly quantityScale: number;
+  readonly quoteAmountScale: number;
+  readonly priceDisplayDecimals: number;
+  readonly quantityDisplayDecimals: number;
+  readonly quoteAmountDisplayDecimals: number;
+}
+interface SpotOrderDecimalInput {
+  readonly pair: PairCatalogKey;
+  readonly quantity: string;
+  readonly price?: string;
+}
+interface ZipperAssetChainRoute {
+  readonly asset: ZipperEnrichedAssetConfig;
+  readonly chain: ZipperEnrichedAssetChain;
+}
+interface CatalogReader {
+  readonly market: MarketCatalogReader;
+  readonly ledger: LedgerCatalogReader;
+  readonly orders: OrdersCatalogReader;
+  readonly zipper: ZipperCatalogReader;
+  snapshot(): CatalogSnapshot;
+}
+interface ClientCatalog extends CatalogReader {
+  state(): CatalogState;
+  /** Passive: resolves the current snapshot or in-flight refresh; never starts one. */
+  ready(): Promise<CatalogSnapshot | null>;
+  /** Resolves the current snapshot, starting a refresh when the catalog is empty. */
+  ensureReady(): Promise<CatalogSnapshot>;
+  refresh(): Promise<CatalogSnapshot>;
+  setSnapshot(snapshot: CatalogSnapshot): void;
+}
+interface CatalogSnapshot {
+  readonly source: CatalogSnapshotSource;
+  readonly tsMs: number;
+  readonly version: number;
+  readonly market: MarketCatalogData;
+  readonly zipper: ZipperCatalogData;
+}
+type CatalogState = {
+  status: "empty";
+} | {
+  status: "refreshing";
+  previousSource: CatalogStateSource;
+} | {
+  status: "fresh";
+  source: CatalogSnapshotSource;
+} | {
+  status: "stale";
+  source: CatalogStateSource;
+  error: unknown;
+};
+interface CatalogRefreshSource {
+  market(): Promise<SpotConfig>;
+  zipper(): Promise<DepositWithdrawConfig>;
+}
+/**
+ * External storage for the catalog's current snapshot. Injecting a cell lets the host
+ * own where the snapshot lives (e.g. a reactive signal) while the catalog keeps owning
+ * all logic — refresh, dedup, state, readers. Every reader lookup goes through
+ * `get()`, so a host whose `get()` reads a reactive source makes every catalog read
+ * reactive by construction.
+ */
+interface CatalogSnapshotCell {
+  get(): CatalogSnapshot | undefined;
+  set(snapshot: CatalogSnapshot): void;
+}
+interface CreatePolyesterCatalogOptions {
+  snapshot?: CatalogSnapshot;
+  refresh?: false | CatalogRefreshSource;
+  /** When provided, the catalog reads/writes its snapshot through this cell. */
+  cell?: CatalogSnapshotCell;
+}
+interface MarketCatalogReader {
+  listAssets(): readonly AssetConfig[];
+  getAsset(asset: AssetCatalogKey): AssetConfig | null;
+  requireAsset(asset: AssetCatalogKey): AssetConfig;
+  getAssetBySymbol(assetSymbol: string): AssetConfig | null;
+  requireAssetBySymbol(assetSymbol: string): AssetConfig;
+  getAssetByLedgerId(ledgerAssetId: number): AssetConfig;
+  requireAssetByLedgerId(ledgerAssetId: number): AssetConfig;
+  listPairs(filter?: {
+    listed?: boolean;
+    everListed?: boolean;
+    atMs?: number;
+  }): readonly EnrichedPairConfig[];
+  getPair(pair: PairCatalogKey): EnrichedPairConfig | null;
+  requirePair(pair: PairCatalogKey): EnrichedPairConfig;
+  getPairBySymbol(pairSymbol: string): EnrichedPairConfig | null;
+  requirePairBySymbol(pairSymbol: string): EnrichedPairConfig;
+  getPairBySymbolId(pairSymbolId: number): EnrichedPairConfig | null;
+  requirePairBySymbolId(pairSymbolId: number): EnrichedPairConfig;
+  getSymbolIdByPairSymbol(pairSymbol: string): number | null;
+  requireSymbolIdByPairSymbol(pairSymbol: string): number;
+  getPairSymbolBySymbolId(pairSymbolId: number): string | null;
+  requirePairSymbolBySymbolId(pairSymbolId: number): string;
+  /** Strictly converts a decimal price into raw price ticks. */
+  decimalPriceToTicks(price: string, pair: PairCatalogKey): ParsedCatalogAmount;
+  /** Truncates a raw price input to the pair's price precision. */
+  normalizePriceInput(price: string, pair: PairCatalogKey): string;
+  priceTicksToDecimalString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string;
+  priceTicksToDisplayString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string;
+  /** Display-rounds a decimal price string (grouping-free) for UI rendering. */
+  formatPrice(price: string, pair: PairCatalogKey): string;
+  /** Strictly converts a decimal base quantity into the pair's scaled quantity. */
+  decimalQuantityToScaled(quantity: string, pair: PairCatalogKey): ParsedCatalogAmount;
+  /** Truncates a raw quantity input to the base asset's quantity scale. */
+  normalizeQuantityInput(quantity: string, pair: PairCatalogKey): string;
+  quantityScaledToDecimalString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string;
+  quantityScaledToDisplayString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string;
+  /** Display-rounds a decimal base-quantity string for UI rendering. */
+  formatQuantity(quantity: string, pair: PairCatalogKey): string;
+  /** Strictly converts a decimal quote amount into the quote asset's scaled amount. */
+  decimalQuoteAmountToScaled(amount: string, pair: PairCatalogKey): ParsedCatalogAmount;
+  /** Truncates a raw quote amount input to the quote asset's quantity scale. */
+  normalizeQuoteAmountInput(amount: string, pair: PairCatalogKey): string;
+  quoteAmountScaledToDecimalString(amountScaled: ScaledIntegerLike, pair: PairCatalogKey): string;
+  quoteAmountScaledToDisplayString(amountScaled: ScaledIntegerLike, pair: PairCatalogKey): string;
+  /** Display-rounds a decimal quote-amount string for UI rendering. */
+  formatQuoteAmount(amount: string, pair: PairCatalogKey): string;
+}
+interface LedgerCatalogReader {
+  getAssetByLedgerId(ledgerAssetId: number): AssetConfig;
+  requireAssetByLedgerId(ledgerAssetId: number): AssetConfig;
+  getAssetBySymbol(assetSymbol: string): AssetConfig | null;
+  requireAssetBySymbol(assetSymbol: string): AssetConfig;
+  getLedgerIdBySymbol(assetSymbol: string): number | null;
+  requireLedgerIdBySymbol(assetSymbol: string): number;
+  requireSymbolByLedgerId(ledgerAssetId: number): string;
+  isKnownAssetId(ledgerAssetId: number): boolean;
+  /** Strictly converts a decimal amount into the asset's scaled amount. */
+  decimalAmountToScaled(amount: string, asset: AssetCatalogKey): ParsedCatalogAmount;
+  /** Truncates a raw amount input to the asset's quantity scale. */
+  normalizeAmountInput(amount: string, asset: AssetCatalogKey): string;
+  amountScaledToDecimalString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string;
+  amountScaledToDisplayString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string;
+  /** Display-rounds a decimal ledger-amount string for UI rendering. */
+  formatAmount(amount: string, asset: AssetCatalogKey): string;
+}
+interface OrdersCatalogReader {
+  getSpotOrderConstraints(pair: PairCatalogKey): SpotOrderConstraints;
+  /**
+   * Validates decimal order input against pair constraints: parseability,
+   * tick size, step size, min quantity, and min notional when a price is
+   * present. Pair status is exposed via constraints, not enforced here.
+   */
+  validateSpotOrderDecimalInput(input: SpotOrderDecimalInput): CatalogValidationResult;
+  /** Like {@link validateSpotOrderDecimalInput} but throws {@link CatalogValidationFailedError}. */
+  assertSpotOrderDecimalInput(input: SpotOrderDecimalInput): void;
+}
+interface ZipperCatalogReader {
+  listChains(): readonly ZipperChainConfig[];
+  getChain(chain: ChainCatalogKey): ZipperChainConfig | null;
+  requireChain(chain: ChainCatalogKey): ZipperChainConfig;
+  getChainByCode(chainCode: string): ZipperChainConfig | null;
+  requireChainByCode(chainCode: string): ZipperChainConfig;
+  getChainById(chainId: number): ZipperChainConfig | null;
+  requireChainById(chainId: number): ZipperChainConfig;
+  getChainIdByCode(chainCode: string): number | null;
+  requireChainIdByCode(chainCode: string): number;
+  listAssets(): readonly ZipperEnrichedAssetConfig[];
+  getAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig | null;
+  requireAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig;
+  getAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig | null;
+  requireAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig;
+  getAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig;
+  requireAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig;
+  getAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig | null;
+  requireAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig;
+  getAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute | null;
+  requireAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute;
+  getAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute | null;
+  requireAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute;
+  getZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number | null;
+  requireZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number;
+  listContracts(): readonly ZipperChainContractConfig[];
+  getContract(contractName: ZipperContractName): ZipperChainContractConfig | null;
+  requireContract(contractName: ZipperContractName): ZipperChainContractConfig;
+  getContractByName(contractName: ZipperContractName): ZipperChainContractConfig | null;
+  requireContractByName(contractName: ZipperContractName): ZipperChainContractConfig;
+}
+//#endregion
+export { AssetCatalogKey, CatalogConversionError, CatalogLookupDomain, CatalogLookupError, CatalogNotReadyError, CatalogReader, CatalogRefreshSource, CatalogSnapshot, CatalogSnapshotCell, CatalogSnapshotSource, CatalogState, CatalogStateSource, CatalogValidationError, CatalogValidationFailedError, CatalogValidationResult, ChainCatalogKey, ClientCatalog, CreatePolyesterCatalogOptions, LedgerCatalogReader, MarketCatalogReader, OrdersCatalogReader, PairCatalogKey, ParsedCatalogAmount, ScaledIntegerLike, SpotOrderConstraints, SpotOrderDecimalInput, ZipperAssetChainRoute, ZipperCatalogReader };
+//# sourceMappingURL=types.d.ts.map

package/dist/catalogs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/catalogs/types.ts"],"mappings":"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"}

package/dist/catalogs/types.js

@@ -0,0 +1,48 @@
+import { RequestError, ValidationError } from "../shared/errors.js";
+//#region src/catalogs/types.ts
+/** A catalog lookup key (pair, asset, chain, …) did not match any entry. */
+var CatalogLookupError = class extends RequestError {
+	domain;
+	lookup;
+	value;
+	code = "CATALOG_LOOKUP_MISS";
+	constructor(domain, lookup, value) {
+		super(`[catalog] ${domain} ${lookup} not found: ${String(value)}`);
+		this.domain = domain;
+		this.lookup = lookup;
+		this.value = value;
+		this.name = "CatalogLookupError";
+	}
+};
+/** The catalog has no snapshot yet — call `catalog.ensureReady()` first. */
+var CatalogNotReadyError = class extends RequestError {
+	code = "CATALOG_NOT_READY";
+	constructor() {
+		super("[catalog] no catalog snapshot has been loaded");
+		this.name = "CatalogNotReadyError";
+	}
+};
+/** A decimal/scaled conversion failed (bad input or excess precision). */
+var CatalogConversionError = class extends ValidationError {
+	field;
+	code = "CATALOG_CONVERSION_INVALID";
+	constructor(field, message) {
+		super(`[catalog] ${message}`);
+		this.field = field;
+		this.name = "CatalogConversionError";
+	}
+};
+/** Order input failed validation against pair constraints. */
+var CatalogValidationFailedError = class extends ValidationError {
+	errors;
+	code = "CATALOG_VALIDATION_FAILED";
+	constructor(errors) {
+		super(`[catalog] order input validation failed: ${errors.map((error) => error.message).join("; ")}`);
+		this.errors = errors;
+		this.name = "CatalogValidationFailedError";
+	}
+};
+//#endregion
+export { CatalogConversionError, CatalogLookupError, CatalogNotReadyError, CatalogValidationFailedError };
+
+//# sourceMappingURL=types.js.map

package/dist/catalogs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/catalogs/types.ts"],"sourcesContent":["import type {\n    AssetConfig,\n    DepositWithdrawConfig,\n    PairStatus,\n    SpotConfig,\n    ZipperChainConfig,\n    ZipperChainContractConfig,\n} from \"../shared/catalog-config.js\";\nimport { RequestError, ValidationError } from \"../shared/errors.js\";\nimport type { EnrichedPairConfig, MarketCatalogData } from \"./market-data-catalog.js\";\nimport type {\n    ZipperCatalogData,\n    ZipperContractName,\n    ZipperEnrichedAssetChain,\n    ZipperEnrichedAssetConfig,\n} from \"./zipper-catalog.js\";\n\n/** Pair lookup key: symbol, symbolId, or an explicit object form. */\nexport type PairCatalogKey = string | number | { symbol: string } | { symbolId: number };\n/** Asset lookup key: symbol, ledger id, or an explicit object form. */\nexport type AssetCatalogKey = string | number | { symbol: string } | { ledgerId: number };\n/** Chain lookup key: chain code, chain id, or an explicit object form. */\nexport type ChainCatalogKey = string | number | { code: string } | { chainId: number };\n\n/** Raw scaled integer accepted on the SDK side of catalog conversions. */\nexport type ScaledIntegerLike = bigint | number | string;\n\nexport type CatalogLookupDomain = \"market\" | \"ledger\" | \"orders\" | \"zipper\";\nexport type CatalogSnapshotSource = \"api\" | \"snapshot\";\nexport type CatalogStateSource = CatalogSnapshotSource | \"empty\";\n\n/** A catalog lookup key (pair, asset, chain, …) did not match any entry. */\nexport class CatalogLookupError extends RequestError {\n    override readonly code = \"CATALOG_LOOKUP_MISS\";\n\n    constructor(\n        readonly domain: CatalogLookupDomain,\n        readonly lookup: string,\n        readonly value: string | number,\n    ) {\n        super(`[catalog] ${domain} ${lookup} not found: ${String(value)}`);\n        this.name = \"CatalogLookupError\";\n    }\n}\n\n/** The catalog has no snapshot yet — call `catalog.ensureReady()` first. */\nexport class CatalogNotReadyError extends RequestError {\n    override readonly code = \"CATALOG_NOT_READY\";\n\n    constructor() {\n        super(\"[catalog] no catalog snapshot has been loaded\");\n        this.name = \"CatalogNotReadyError\";\n    }\n}\n\n/** A decimal/scaled conversion failed (bad input or excess precision). */\nexport class CatalogConversionError extends ValidationError {\n    override readonly code = \"CATALOG_CONVERSION_INVALID\";\n\n    constructor(\n        readonly field: string,\n        message: string,\n    ) {\n        super(`[catalog] ${message}`);\n        this.name = \"CatalogConversionError\";\n    }\n}\n\n/** Order input failed validation against pair constraints. */\nexport class CatalogValidationFailedError extends ValidationError {\n    override readonly code = \"CATALOG_VALIDATION_FAILED\";\n\n    constructor(readonly errors: readonly CatalogValidationError[]) {\n        super(\n            `[catalog] order input validation failed: ${errors\n                .map((error) => error.message)\n                .join(\"; \")}`,\n        );\n        this.name = \"CatalogValidationFailedError\";\n    }\n}\n\n/**\n * Result of a strict decimal-to-SDK conversion. `scaledValue` is the raw\n * JSON-safe integer string for service calls; `decimal` is the exact decimal\n * string; `display` is the display-normalized decimal string.\n */\nexport interface ParsedCatalogAmount {\n    readonly scaledValue: string;\n    readonly decimal: string;\n    readonly display: string;\n    readonly scale: number;\n}\n\nexport interface CatalogValidationError {\n    readonly field: string;\n    readonly rule: string;\n    readonly message: string;\n    readonly expected?: string;\n    readonly actual?: string;\n}\n\nexport interface CatalogValidationResult {\n    readonly valid: boolean;\n    readonly errors: readonly CatalogValidationError[];\n}\n\n/** Trading constraints for a spot pair, for UI decisions and input validation. */\nexport interface SpotOrderConstraints {\n    readonly symbolId: number;\n    readonly symbol: string;\n    readonly status: PairStatus;\n    readonly tickSize: string;\n    readonly stepSize: string;\n    readonly minQtyBase: string;\n    readonly minNotionalQuote: string;\n    readonly priceScale: number;\n    readonly quantityScale: number;\n    readonly quoteAmountScale: number;\n    readonly priceDisplayDecimals: number;\n    readonly quantityDisplayDecimals: number;\n    readonly quoteAmountDisplayDecimals: number;\n}\n\nexport interface SpotOrderDecimalInput {\n    readonly pair: PairCatalogKey;\n    readonly quantity: string;\n    readonly price?: string;\n}\n\nexport interface ZipperAssetChainRoute {\n    readonly asset: ZipperEnrichedAssetConfig;\n    readonly chain: ZipperEnrichedAssetChain;\n}\n\nexport interface CatalogReader {\n    readonly market: MarketCatalogReader;\n    readonly ledger: LedgerCatalogReader;\n    readonly orders: OrdersCatalogReader;\n    readonly zipper: ZipperCatalogReader;\n    snapshot(): CatalogSnapshot;\n}\n\nexport interface ClientCatalog extends CatalogReader {\n    state(): CatalogState;\n    /** Passive: resolves the current snapshot or in-flight refresh; never starts one. */\n    ready(): Promise<CatalogSnapshot | null>;\n    /** Resolves the current snapshot, starting a refresh when the catalog is empty. */\n    ensureReady(): Promise<CatalogSnapshot>;\n    refresh(): Promise<CatalogSnapshot>;\n    setSnapshot(snapshot: CatalogSnapshot): void;\n}\n\nexport interface CatalogSnapshot {\n    readonly source: CatalogSnapshotSource;\n    readonly tsMs: number;\n    readonly version: number;\n    readonly market: MarketCatalogData;\n    readonly zipper: ZipperCatalogData;\n}\n\nexport type CatalogState =\n    | { status: \"empty\" }\n    | { status: \"refreshing\"; previousSource: CatalogStateSource }\n    | { status: \"fresh\"; source: CatalogSnapshotSource }\n    | { status: \"stale\"; source: CatalogStateSource; error: unknown };\n\nexport interface CatalogRefreshSource {\n    market(): Promise<SpotConfig>;\n    zipper(): Promise<DepositWithdrawConfig>;\n}\n\n/**\n * External storage for the catalog's current snapshot. Injecting a cell lets the host\n * own where the snapshot lives (e.g. a reactive signal) while the catalog keeps owning\n * all logic — refresh, dedup, state, readers. Every reader lookup goes through\n * `get()`, so a host whose `get()` reads a reactive source makes every catalog read\n * reactive by construction.\n */\nexport interface CatalogSnapshotCell {\n    get(): CatalogSnapshot | undefined;\n    set(snapshot: CatalogSnapshot): void;\n}\n\nexport interface CreatePolyesterCatalogOptions {\n    snapshot?: CatalogSnapshot;\n    refresh?: false | CatalogRefreshSource;\n    /** When provided, the catalog reads/writes its snapshot through this cell. */\n    cell?: CatalogSnapshotCell;\n}\n\nexport interface MarketCatalogReader {\n    listAssets(): readonly AssetConfig[];\n    getAsset(asset: AssetCatalogKey): AssetConfig | null;\n    requireAsset(asset: AssetCatalogKey): AssetConfig;\n    getAssetBySymbol(assetSymbol: string): AssetConfig | null;\n    requireAssetBySymbol(assetSymbol: string): AssetConfig;\n    getAssetByLedgerId(ledgerAssetId: number): AssetConfig;\n    requireAssetByLedgerId(ledgerAssetId: number): AssetConfig;\n\n    listPairs(filter?: {\n        listed?: boolean;\n        everListed?: boolean;\n        atMs?: number;\n    }): readonly EnrichedPairConfig[];\n    getPair(pair: PairCatalogKey): EnrichedPairConfig | null;\n    requirePair(pair: PairCatalogKey): EnrichedPairConfig;\n    getPairBySymbol(pairSymbol: string): EnrichedPairConfig | null;\n    requirePairBySymbol(pairSymbol: string): EnrichedPairConfig;\n    getPairBySymbolId(pairSymbolId: number): EnrichedPairConfig | null;\n    requirePairBySymbolId(pairSymbolId: number): EnrichedPairConfig;\n    getSymbolIdByPairSymbol(pairSymbol: string): number | null;\n    requireSymbolIdByPairSymbol(pairSymbol: string): number;\n    getPairSymbolBySymbolId(pairSymbolId: number): string | null;\n    requirePairSymbolBySymbolId(pairSymbolId: number): string;\n\n    /** Strictly converts a decimal price into raw price ticks. */\n    decimalPriceToTicks(price: string, pair: PairCatalogKey): ParsedCatalogAmount;\n    /** Truncates a raw price input to the pair's price precision. */\n    normalizePriceInput(price: string, pair: PairCatalogKey): string;\n    priceTicksToDecimalString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string;\n    priceTicksToDisplayString(priceTicks: ScaledIntegerLike, pair: PairCatalogKey): string;\n    /** Display-rounds a decimal price string (grouping-free) for UI rendering. */\n    formatPrice(price: string, pair: PairCatalogKey): string;\n\n    /** Strictly converts a decimal base quantity into the pair's scaled quantity. */\n    decimalQuantityToScaled(quantity: string, pair: PairCatalogKey): ParsedCatalogAmount;\n    /** Truncates a raw quantity input to the base asset's quantity scale. */\n    normalizeQuantityInput(quantity: string, pair: PairCatalogKey): string;\n    quantityScaledToDecimalString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string;\n    quantityScaledToDisplayString(quantityScaled: ScaledIntegerLike, pair: PairCatalogKey): string;\n    /** Display-rounds a decimal base-quantity string for UI rendering. */\n    formatQuantity(quantity: string, pair: PairCatalogKey): string;\n\n    /** Strictly converts a decimal quote amount into the quote asset's scaled amount. */\n    decimalQuoteAmountToScaled(amount: string, pair: PairCatalogKey): ParsedCatalogAmount;\n    /** Truncates a raw quote amount input to the quote asset's quantity scale. */\n    normalizeQuoteAmountInput(amount: string, pair: PairCatalogKey): string;\n    quoteAmountScaledToDecimalString(amountScaled: ScaledIntegerLike, pair: PairCatalogKey): string;\n    quoteAmountScaledToDisplayString(amountScaled: ScaledIntegerLike, pair: PairCatalogKey): string;\n    /** Display-rounds a decimal quote-amount string for UI rendering. */\n    formatQuoteAmount(amount: string, pair: PairCatalogKey): string;\n}\n\nexport interface LedgerCatalogReader {\n    getAssetByLedgerId(ledgerAssetId: number): AssetConfig;\n    requireAssetByLedgerId(ledgerAssetId: number): AssetConfig;\n    getAssetBySymbol(assetSymbol: string): AssetConfig | null;\n    requireAssetBySymbol(assetSymbol: string): AssetConfig;\n    getLedgerIdBySymbol(assetSymbol: string): number | null;\n    requireLedgerIdBySymbol(assetSymbol: string): number;\n    requireSymbolByLedgerId(ledgerAssetId: number): string;\n    isKnownAssetId(ledgerAssetId: number): boolean;\n\n    /** Strictly converts a decimal amount into the asset's scaled amount. */\n    decimalAmountToScaled(amount: string, asset: AssetCatalogKey): ParsedCatalogAmount;\n    /** Truncates a raw amount input to the asset's quantity scale. */\n    normalizeAmountInput(amount: string, asset: AssetCatalogKey): string;\n    amountScaledToDecimalString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string;\n    amountScaledToDisplayString(amountScaled: ScaledIntegerLike, asset: AssetCatalogKey): string;\n    /** Display-rounds a decimal ledger-amount string for UI rendering. */\n    formatAmount(amount: string, asset: AssetCatalogKey): string;\n}\n\nexport interface OrdersCatalogReader {\n    getSpotOrderConstraints(pair: PairCatalogKey): SpotOrderConstraints;\n    /**\n     * Validates decimal order input against pair constraints: parseability,\n     * tick size, step size, min quantity, and min notional when a price is\n     * present. Pair status is exposed via constraints, not enforced here.\n     */\n    validateSpotOrderDecimalInput(input: SpotOrderDecimalInput): CatalogValidationResult;\n    /** Like {@link validateSpotOrderDecimalInput} but throws {@link CatalogValidationFailedError}. */\n    assertSpotOrderDecimalInput(input: SpotOrderDecimalInput): void;\n}\n\nexport interface ZipperCatalogReader {\n    listChains(): readonly ZipperChainConfig[];\n    getChain(chain: ChainCatalogKey): ZipperChainConfig | null;\n    requireChain(chain: ChainCatalogKey): ZipperChainConfig;\n    getChainByCode(chainCode: string): ZipperChainConfig | null;\n    requireChainByCode(chainCode: string): ZipperChainConfig;\n    getChainById(chainId: number): ZipperChainConfig | null;\n    requireChainById(chainId: number): ZipperChainConfig;\n    getChainIdByCode(chainCode: string): number | null;\n    requireChainIdByCode(chainCode: string): number;\n\n    listAssets(): readonly ZipperEnrichedAssetConfig[];\n    getAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig | null;\n    requireAsset(asset: AssetCatalogKey): ZipperEnrichedAssetConfig;\n    getAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig | null;\n    requireAssetBySymbol(assetSymbol: string): ZipperEnrichedAssetConfig;\n    getAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig;\n    requireAssetByLedgerId(ledgerAssetId: number): ZipperEnrichedAssetConfig;\n    getAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig | null;\n    requireAssetByUAssetId(uAssetId: string): ZipperEnrichedAssetConfig;\n\n    getAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute | null;\n    requireAssetChain(asset: AssetCatalogKey, chain: ChainCatalogKey): ZipperAssetChainRoute;\n    getAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute | null;\n    requireAssetChainByZippedAssetId(zippedAssetId: number): ZipperAssetChainRoute;\n    getZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number | null;\n    requireZippedAssetId(asset: AssetCatalogKey, chain: ChainCatalogKey): number;\n\n    listContracts(): readonly ZipperChainContractConfig[];\n    getContract(contractName: ZipperContractName): ZipperChainContractConfig | null;\n    requireContract(contractName: ZipperContractName): ZipperChainContractConfig;\n    getContractByName(contractName: ZipperContractName): ZipperChainContractConfig | null;\n    requireContractByName(contractName: ZipperContractName): ZipperChainContractConfig;\n}\n"],"mappings":";;;AAgCA,IAAa,qBAAb,cAAwC,aAAa;CAIpC;CACA;CACA;CALb,OAAyB;CAEzB,YACI,QACA,QACA,OACF;EACE,MAAM,aAAa,OAAO,GAAG,OAAO,cAAc,OAAO,KAAK,GAAG;EAJxD,KAAA,SAAA;EACA,KAAA,SAAA;EACA,KAAA,QAAA;EAGT,KAAK,OAAO;CAChB;AACJ;;AAGA,IAAa,uBAAb,cAA0C,aAAa;CACnD,OAAyB;CAEzB,cAAc;EACV,MAAM,+CAA+C;EACrD,KAAK,OAAO;CAChB;AACJ;;AAGA,IAAa,yBAAb,cAA4C,gBAAgB;CAI3C;CAHb,OAAyB;CAEzB,YACI,OACA,SACF;EACE,MAAM,aAAa,SAAS;EAHnB,KAAA,QAAA;EAIT,KAAK,OAAO;CAChB;AACJ;;AAGA,IAAa,+BAAb,cAAkD,gBAAgB;CAGzC;CAFrB,OAAyB;CAEzB,YAAY,QAAoD;EAC5D,MACI,4CAA4C,OACvC,KAAK,UAAU,MAAM,OAAO,CAAC,CAC7B,KAAK,IAAI,GAClB;EALiB,KAAA,SAAA;EAMjB,KAAK,OAAO;CAChB;AACJ"}

package/dist/catalogs/unknown-asset.d.ts

@@ -0,0 +1,27 @@
+import { AssetConfig } from "../shared/catalog-config.js";
+import { ZipperEnrichedAssetConfig } from "./zipper-catalog.js";
+//#region src/catalogs/unknown-asset.d.ts
+declare const UNKNOWN_ASSET_LABEL = "Unknown asset";
+declare const UNKNOWN_LEDGER_ASSET_ID = 9999;
+declare const unknownLedgerAsset: Readonly<{
+  symbol: string;
+  ledgerId: number;
+  name: string;
+  quantityDisplayDecimals: number;
+  quantityScale: number;
+}>;
+declare const unknownZipperAsset: Readonly<{
+  asset: string;
+  ledgerId: number;
+  name: string;
+  icon: string;
+  quantityScale: number;
+  quantityDisplayDecimals: number;
+  uAssetId: string;
+  chains: never[];
+}>;
+declare function isUnknownLedgerAsset(asset: AssetConfig): boolean;
+declare function isUnknownZipperAsset(asset: ZipperEnrichedAssetConfig): boolean;
+//#endregion
+export { UNKNOWN_ASSET_LABEL, UNKNOWN_LEDGER_ASSET_ID, isUnknownLedgerAsset, isUnknownZipperAsset, unknownLedgerAsset, unknownZipperAsset };
+//# sourceMappingURL=unknown-asset.d.ts.map

package/dist/catalogs/unknown-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-asset.d.ts","names":[],"sources":["../../src/catalogs/unknown-asset.ts"],"mappings":";;;cAGa;cACA;cAEA,oBAAkB;;;;;;;cAQlB,oBAAkB;;;;;;;;;;iBAWf,qBAAqB,OAAO;iBAI5B,qBAAqB,OAAO"}

package/dist/catalogs/unknown-asset.js

@@ -0,0 +1,38 @@
+//#region src/catalogs/unknown-asset.ts
+const UNKNOWN_ASSET_LABEL = "Unknown asset";
+const UNKNOWN_LEDGER_ASSET_ID = 9999;
+const unknownLedgerAsset = Object.freeze({
+	symbol: UNKNOWN_ASSET_LABEL,
+	ledgerId: UNKNOWN_LEDGER_ASSET_ID,
+	name: UNKNOWN_ASSET_LABEL,
+	quantityDisplayDecimals: 6,
+	quantityScale: 6
+});
+const unknownZipperAsset = Object.freeze({
+	asset: UNKNOWN_ASSET_LABEL,
+	ledgerId: UNKNOWN_LEDGER_ASSET_ID,
+	name: UNKNOWN_ASSET_LABEL,
+	icon: "",
+	quantityScale: 6,
+	quantityDisplayDecimals: 6,
+	uAssetId: "",
+	chains: []
+});
+function isUnknownLedgerAsset(asset) {
+	return asset.ledgerId === UNKNOWN_LEDGER_ASSET_ID;
+}
+function isUnknownZipperAsset(asset) {
+	return asset.ledgerId === UNKNOWN_LEDGER_ASSET_ID;
+}
+function resolveLedgerAssetByLedgerId(ledgerAssetId, lookup) {
+	if (!Number.isInteger(ledgerAssetId) || ledgerAssetId <= 0) return unknownLedgerAsset;
+	return lookup(ledgerAssetId) ?? unknownLedgerAsset;
+}
+function resolveZipperAssetByLedgerId(ledgerAssetId, lookup) {
+	if (!Number.isInteger(ledgerAssetId) || ledgerAssetId <= 0) return unknownZipperAsset;
+	return lookup(ledgerAssetId) ?? unknownZipperAsset;
+}
+//#endregion
+export { UNKNOWN_ASSET_LABEL, UNKNOWN_LEDGER_ASSET_ID, isUnknownLedgerAsset, isUnknownZipperAsset, resolveLedgerAssetByLedgerId, resolveZipperAssetByLedgerId, unknownLedgerAsset, unknownZipperAsset };
+
+//# sourceMappingURL=unknown-asset.js.map

package/dist/catalogs/unknown-asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-asset.js","names":[],"sources":["../../src/catalogs/unknown-asset.ts"],"sourcesContent":["import type { AssetConfig } from \"../shared/catalog-config.js\";\nimport type { ZipperEnrichedAssetConfig } from \"./zipper-catalog.js\";\n\nexport const UNKNOWN_ASSET_LABEL = \"Unknown asset\";\nexport const UNKNOWN_LEDGER_ASSET_ID = 9999;\n\nexport const unknownLedgerAsset = Object.freeze({\n    symbol: UNKNOWN_ASSET_LABEL,\n    ledgerId: UNKNOWN_LEDGER_ASSET_ID,\n    name: UNKNOWN_ASSET_LABEL,\n    quantityDisplayDecimals: 6,\n    quantityScale: 6,\n} satisfies AssetConfig);\n\nexport const unknownZipperAsset = Object.freeze({\n    asset: UNKNOWN_ASSET_LABEL,\n    ledgerId: UNKNOWN_LEDGER_ASSET_ID,\n    name: UNKNOWN_ASSET_LABEL,\n    icon: \"\",\n    quantityScale: 6,\n    quantityDisplayDecimals: 6,\n    uAssetId: \"\",\n    chains: [],\n} satisfies ZipperEnrichedAssetConfig);\n\nexport function isUnknownLedgerAsset(asset: AssetConfig): boolean {\n    return asset.ledgerId === UNKNOWN_LEDGER_ASSET_ID;\n}\n\nexport function isUnknownZipperAsset(asset: ZipperEnrichedAssetConfig): boolean {\n    return asset.ledgerId === UNKNOWN_LEDGER_ASSET_ID;\n}\n\nexport function resolveLedgerAssetByLedgerId(\n    ledgerAssetId: number,\n    lookup: (ledgerAssetId: number) => AssetConfig | null,\n): AssetConfig {\n    if (!Number.isInteger(ledgerAssetId) || ledgerAssetId <= 0) return unknownLedgerAsset;\n    return lookup(ledgerAssetId) ?? unknownLedgerAsset;\n}\n\nexport function resolveZipperAssetByLedgerId(\n    ledgerAssetId: number,\n    lookup: (ledgerAssetId: number) => ZipperEnrichedAssetConfig | null,\n): ZipperEnrichedAssetConfig {\n    if (!Number.isInteger(ledgerAssetId) || ledgerAssetId <= 0) return unknownZipperAsset;\n    return lookup(ledgerAssetId) ?? unknownZipperAsset;\n}\n"],"mappings":";AAGA,MAAa,sBAAsB;AACnC,MAAa,0BAA0B;AAEvC,MAAa,qBAAqB,OAAO,OAAO;CAC5C,QAAQ;CACR,UAAU;CACV,MAAM;CACN,yBAAyB;CACzB,eAAe;AACnB,CAAuB;AAEvB,MAAa,qBAAqB,OAAO,OAAO;CAC5C,OAAO;CACP,UAAU;CACV,MAAM;CACN,MAAM;CACN,eAAe;CACf,yBAAyB;CACzB,UAAU;CACV,QAAQ,CAAC;AACb,CAAqC;AAErC,SAAgB,qBAAqB,OAA6B;CAC9D,OAAO,MAAM,aAAa;AAC9B;AAEA,SAAgB,qBAAqB,OAA2C;CAC5E,OAAO,MAAM,aAAa;AAC9B;AAEA,SAAgB,6BACZ,eACA,QACW;CACX,IAAI,CAAC,OAAO,UAAU,aAAa,KAAK,iBAAiB,GAAG,OAAO;CACnE,OAAO,OAAO,aAAa,KAAK;AACpC;AAEA,SAAgB,6BACZ,eACA,QACyB;CACzB,IAAI,CAAC,OAAO,UAAU,aAAa,KAAK,iBAAiB,GAAG,OAAO;CACnE,OAAO,OAAO,aAAa,KAAK;AACpC"}

package/dist/catalogs/zipper-catalog.d.ts

@@ -0,0 +1,33 @@
+import { DepositWithdrawConfig, ZipperAssetChainVariant, ZipperAssetConfig, ZipperChainConfig, ZipperChainContractConfig } from "../shared/catalog-config.js";
+//#region src/catalogs/zipper-catalog.d.ts
+/** Known stable contract names plus a string escape hatch for new contracts. */
+type ZipperContractName = "fundingAccount" | "guardRegistry" | "tradingGateway" | (string & {});
+type ZipperEnrichedAssetChain = ZipperChainConfig & {
+  zippedAssetId: ZipperAssetChainVariant["zippedAssetId"];
+  isNativeAsset: ZipperAssetChainVariant["isNativeAsset"];
+  networkFee?: ZipperAssetChainVariant["networkFee"];
+  networkFeeTsSec?: ZipperAssetChainVariant["networkFeeTsSec"];
+  depositMinAmount?: ZipperAssetChainVariant["depositMinAmount"];
+  withdrawMinAmount?: ZipperAssetChainVariant["withdrawMinAmount"];
+  supply?: ZipperAssetChainVariant["supply"];
+  sourceToken: ZipperAssetChainVariant["sourceToken"];
+  zToken: ZipperAssetChainVariant["zToken"];
+};
+type ZipperEnrichedAssetConfig = Omit<ZipperAssetConfig, "variants"> & {
+  chains: ZipperEnrichedAssetChain[];
+};
+interface ZipperCatalogData {
+  readonly chains: readonly ZipperChainConfig[];
+  readonly assets: readonly ZipperEnrichedAssetConfig[];
+  readonly contracts: readonly ZipperChainContractConfig[];
+  readonly tsMs?: number;
+}
+type ZipperCatalogSeed = DepositWithdrawConfig | {
+  readonly chains: readonly ZipperChainConfig[];
+  readonly assets: readonly (ZipperAssetConfig | ZipperEnrichedAssetConfig)[];
+  readonly contracts?: readonly ZipperChainContractConfig[];
+  readonly tsMs?: number;
+};
+//#endregion
+export { type DepositWithdrawConfig, type ZipperAssetConfig, ZipperCatalogData, ZipperCatalogSeed, type ZipperChainConfig, type ZipperChainContractConfig, ZipperContractName, ZipperEnrichedAssetChain, ZipperEnrichedAssetConfig };
+//# sourceMappingURL=zipper-catalog.d.ts.map

package/dist/catalogs/zipper-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipper-catalog.d.ts","names":[],"sources":["../../src/catalogs/zipper-catalog.ts"],"mappings":";;;KASY;KAaA,2BAA2B;EACnC,eAAe;EACf,eAAe;EACf,aAAa;EACb,kBAAkB;EAClB,mBAAmB;EACnB,oBAAoB;EACpB,SAAS;EACT,aAAa;EACb,QAAQ;;KAGA,4BAA4B,KAAK;EACzC,QAAQ;;UAGK;WACJ,iBAAiB;WACjB,iBAAiB;WACjB,oBAAoB;WACpB;;KAGD,oBACN;WAEa,iBAAiB;WACjB,kBAAkB,oBAAoB;WACtC,qBAAqB;WACrB"}

package/dist/catalogs/zipper-catalog.js

@@ -0,0 +1,54 @@
+//#region src/catalogs/zipper-catalog.ts
+function isEnrichedZipperAsset(asset) {
+	return "chains" in asset;
+}
+/**
+* Adds derived display metadata to Zipper asset records.
+*/
+function enrichZipperAssets(assets, chains) {
+	const chainById = new Map(chains.map((chain) => [chain.chainId, chain]));
+	const enrichedAssets = [];
+	for (const asset of assets) {
+		if (isEnrichedZipperAsset(asset)) {
+			enrichedAssets.push(asset);
+			continue;
+		}
+		const { variants, ...rest } = asset;
+		const enrichedChains = [];
+		for (const variant of variants) {
+			const chain = chainById.get(variant.chainId);
+			if (!chain) throw new Error(`[catalog] zipper asset ${asset.asset} references unknown chainId: ${variant.chainId}`);
+			enrichedChains.push({
+				...chain,
+				zippedAssetId: variant.zippedAssetId,
+				isNativeAsset: variant.isNativeAsset,
+				networkFee: variant.networkFee,
+				networkFeeTsSec: variant.networkFeeTsSec,
+				depositMinAmount: variant.depositMinAmount,
+				withdrawMinAmount: variant.withdrawMinAmount,
+				supply: variant.supply,
+				sourceToken: variant.sourceToken,
+				zToken: variant.zToken
+			});
+		}
+		enrichedAssets.push({
+			...rest,
+			chains: enrichedChains
+		});
+	}
+	return enrichedAssets;
+}
+function buildZipperCatalogData(seed) {
+	const chains = [...seed.chains];
+	const assets = enrichZipperAssets(seed.assets, chains);
+	return Object.freeze({
+		chains: Object.freeze(chains),
+		assets: Object.freeze([...assets]),
+		contracts: Object.freeze([...seed.contracts ?? []]),
+		tsMs: seed.tsMs
+	});
+}
+//#endregion
+export { buildZipperCatalogData, enrichZipperAssets };
+
+//# sourceMappingURL=zipper-catalog.js.map

package/dist/catalogs/zipper-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipper-catalog.js","names":[],"sources":["../../src/catalogs/zipper-catalog.ts"],"sourcesContent":["import type {\n    DepositWithdrawConfig,\n    ZipperAssetChainVariant,\n    ZipperAssetConfig,\n    ZipperChainConfig,\n    ZipperChainContractConfig,\n} from \"../shared/catalog-config.js\";\n\n/** Known stable contract names plus a string escape hatch for new contracts. */\nexport type ZipperContractName =\n    | \"fundingAccount\"\n    | \"guardRegistry\"\n    | \"tradingGateway\"\n    | (string & {});\n\nexport type {\n    DepositWithdrawConfig,\n    ZipperAssetConfig,\n    ZipperChainConfig,\n    ZipperChainContractConfig,\n};\n\nexport type ZipperEnrichedAssetChain = ZipperChainConfig & {\n    zippedAssetId: ZipperAssetChainVariant[\"zippedAssetId\"];\n    isNativeAsset: ZipperAssetChainVariant[\"isNativeAsset\"];\n    networkFee?: ZipperAssetChainVariant[\"networkFee\"];\n    networkFeeTsSec?: ZipperAssetChainVariant[\"networkFeeTsSec\"];\n    depositMinAmount?: ZipperAssetChainVariant[\"depositMinAmount\"];\n    withdrawMinAmount?: ZipperAssetChainVariant[\"withdrawMinAmount\"];\n    supply?: ZipperAssetChainVariant[\"supply\"];\n    sourceToken: ZipperAssetChainVariant[\"sourceToken\"];\n    zToken: ZipperAssetChainVariant[\"zToken\"];\n};\n\nexport type ZipperEnrichedAssetConfig = Omit<ZipperAssetConfig, \"variants\"> & {\n    chains: ZipperEnrichedAssetChain[];\n};\n\nexport interface ZipperCatalogData {\n    readonly chains: readonly ZipperChainConfig[];\n    readonly assets: readonly ZipperEnrichedAssetConfig[];\n    readonly contracts: readonly ZipperChainContractConfig[];\n    readonly tsMs?: number;\n}\n\nexport type ZipperCatalogSeed =\n    | DepositWithdrawConfig\n    | {\n          readonly chains: readonly ZipperChainConfig[];\n          readonly assets: readonly (ZipperAssetConfig | ZipperEnrichedAssetConfig)[];\n          readonly contracts?: readonly ZipperChainContractConfig[];\n          readonly tsMs?: number;\n      };\n\nfunction isEnrichedZipperAsset(\n    asset: ZipperAssetConfig | ZipperEnrichedAssetConfig,\n): asset is ZipperEnrichedAssetConfig {\n    return \"chains\" in asset;\n}\n\n/**\n * Adds derived display metadata to Zipper asset records.\n */\nexport function enrichZipperAssets(\n    assets: readonly (ZipperAssetConfig | ZipperEnrichedAssetConfig)[],\n    chains: readonly ZipperChainConfig[],\n): readonly ZipperEnrichedAssetConfig[] {\n    const chainById = new Map(chains.map((chain) => [chain.chainId, chain]));\n    const enrichedAssets: ZipperEnrichedAssetConfig[] = [];\n\n    for (const asset of assets) {\n        if (isEnrichedZipperAsset(asset)) {\n            enrichedAssets.push(asset);\n            continue;\n        }\n\n        const { variants, ...rest } = asset;\n        const enrichedChains: ZipperEnrichedAssetChain[] = [];\n\n        for (const variant of variants) {\n            const chain = chainById.get(variant.chainId);\n            if (!chain) {\n                throw new Error(\n                    `[catalog] zipper asset ${asset.asset} references unknown chainId: ${variant.chainId}`,\n                );\n            }\n\n            enrichedChains.push({\n                ...chain,\n                zippedAssetId: variant.zippedAssetId,\n                isNativeAsset: variant.isNativeAsset,\n                networkFee: variant.networkFee,\n                networkFeeTsSec: variant.networkFeeTsSec,\n                depositMinAmount: variant.depositMinAmount,\n                withdrawMinAmount: variant.withdrawMinAmount,\n                supply: variant.supply,\n                sourceToken: variant.sourceToken,\n                zToken: variant.zToken,\n            });\n        }\n\n        enrichedAssets.push({\n            ...rest,\n            chains: enrichedChains,\n        });\n    }\n\n    return enrichedAssets;\n}\n\nexport function buildZipperCatalogData(seed: ZipperCatalogSeed): ZipperCatalogData {\n    const chains = [...seed.chains];\n    const assets = enrichZipperAssets(seed.assets, chains);\n    return Object.freeze({\n        chains: Object.freeze(chains),\n        assets: Object.freeze([...assets]),\n        contracts: Object.freeze([...(seed.contracts ?? [])]),\n        tsMs: seed.tsMs,\n    });\n}\n"],"mappings":";AAsDA,SAAS,sBACL,OACkC;CAClC,OAAO,YAAY;AACvB;;;;AAKA,SAAgB,mBACZ,QACA,QACoC;CACpC,MAAM,YAAY,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,MAAM,SAAS,KAAK,CAAC,CAAC;CACvE,MAAM,iBAA8C,CAAC;CAErD,KAAK,MAAM,SAAS,QAAQ;EACxB,IAAI,sBAAsB,KAAK,GAAG;GAC9B,eAAe,KAAK,KAAK;GACzB;EACJ;EAEA,MAAM,EAAE,UAAU,GAAG,SAAS;EAC9B,MAAM,iBAA6C,CAAC;EAEpD,KAAK,MAAM,WAAW,UAAU;GAC5B,MAAM,QAAQ,UAAU,IAAI,QAAQ,OAAO;GAC3C,IAAI,CAAC,OACD,MAAM,IAAI,MACN,0BAA0B,MAAM,MAAM,+BAA+B,QAAQ,SACjF;GAGJ,eAAe,KAAK;IAChB,GAAG;IACH,eAAe,QAAQ;IACvB,eAAe,QAAQ;IACvB,YAAY,QAAQ;IACpB,iBAAiB,QAAQ;IACzB,kBAAkB,QAAQ;IAC1B,mBAAmB,QAAQ;IAC3B,QAAQ,QAAQ;IAChB,aAAa,QAAQ;IACrB,QAAQ,QAAQ;GACpB,CAAC;EACL;EAEA,eAAe,KAAK;GAChB,GAAG;GACH,QAAQ;EACZ,CAAC;CACL;CAEA,OAAO;AACX;AAEA,SAAgB,uBAAuB,MAA4C;CAC/E,MAAM,SAAS,CAAC,GAAG,KAAK,MAAM;CAC9B,MAAM,SAAS,mBAAmB,KAAK,QAAQ,MAAM;CACrD,OAAO,OAAO,OAAO;EACjB,QAAQ,OAAO,OAAO,MAAM;EAC5B,QAAQ,OAAO,OAAO,CAAC,GAAG,MAAM,CAAC;EACjC,WAAW,OAAO,OAAO,CAAC,GAAI,KAAK,aAAa,CAAC,CAAE,CAAC;EACpD,MAAM,KAAK;CACf,CAAC;AACL"}

package/dist/catalogs/zipper-supply.d.ts

@@ -0,0 +1,10 @@
+import { CatalogSnapshot } from "./types.js";
+//#region src/catalogs/zipper-supply.d.ts
+type ZippedAssetSupplyCatalogUpdate = {
+  zippedAssetId: number;
+  supply: string;
+};
+declare function patchZipperCatalogSupply(snapshot: CatalogSnapshot, updates: readonly ZippedAssetSupplyCatalogUpdate[]): CatalogSnapshot;
+//#endregion
+export { ZippedAssetSupplyCatalogUpdate, patchZipperCatalogSupply };
+//# sourceMappingURL=zipper-supply.d.ts.map

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

@@ -0,0 +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"}

package/dist/catalogs/zipper-supply.js

@@ -0,0 +1,40 @@
+//#region src/catalogs/zipper-supply.ts
+function patchZipperCatalogSupply(snapshot, updates) {
+	if (updates.length === 0) return snapshot;
+	const supplyByZippedAssetId = /* @__PURE__ */ new Map();
+	for (const update of updates) supplyByZippedAssetId.set(update.zippedAssetId, update.supply);
+	let changed = false;
+	const assets = snapshot.zipper.assets.map((asset) => {
+		let assetChanged = false;
+		const chains = asset.chains.map((chain) => {
+			const supply = supplyByZippedAssetId.get(chain.zippedAssetId);
+			if (supply === void 0 || supply === chain.supply) return chain;
+			assetChanged = true;
+			changed = true;
+			return {
+				...chain,
+				supply
+			};
+		});
+		return assetChanged ? {
+			...asset,
+			chains
+		} : asset;
+	});
+	if (!changed) return snapshot;
+	const nowMs = Date.now();
+	return {
+		...snapshot,
+		tsMs: nowMs,
+		version: snapshot.version + 1,
+		zipper: {
+			...snapshot.zipper,
+			tsMs: nowMs,
+			assets
+		}
+	};
+}
+//#endregion
+export { patchZipperCatalogSupply };
+
+//# sourceMappingURL=zipper-supply.js.map

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

@@ -0,0 +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"}