@polyester/sdk 0.0.0

package/dist/browser-client.js

@@ -0,0 +1,69 @@
+import { PolyesterClient } from "./core-client.js";
+import { AuthSessionStore } from "./services/auth/session.js";
+import { createMemoryAuthTokenStorage } from "./services/auth/token-storage.js";
+import { AccountSignerAuthService } from "./services/auth/account-signer-auth.js";
+//#region src/browser-client.ts
+/**
+* A client for interacting with the Polyester DEX in the browser.
+*/
+var PolyesterBrowserClient = class extends PolyesterClient {
+	get auth() {
+		return super.auth;
+	}
+	constructor(config) {
+		const tokenStorage = config.tokenStorage ?? createMemoryAuthTokenStorage();
+		const sessionStore = new AuthSessionStore({ environmentFingerprint: config.environment.fingerprint });
+		const getToken = () => sessionStore.getEnvironmentBoundToken(tokenStorage);
+		super({
+			environment: config.environment,
+			interceptors: config.interceptors,
+			auth: {
+				kind: "jwt",
+				getToken
+			},
+			wireFormat: config.wireFormat,
+			catalog: config.catalog,
+			catalogSnapshot: config.catalogSnapshot,
+			catalogCell: config.catalogCell,
+			transports: config.transports,
+			realtimeClient: config.realtimeClient,
+			realtime: {
+				hasAuth: () => !!getToken(),
+				...config.realtime
+			}
+		}, { createAuth: ({ transports, realtime, subaccounts, environment }) => new AccountSignerAuthService({
+			transports,
+			accountSignerConfig: config.accountSigner,
+			environment,
+			subaccounts,
+			realtime,
+			tokenStorage,
+			sessionStore
+		}) });
+	}
+	/**
+	* Creates a resolver that defaults subaccountId to the active subaccount.
+	* The getter is called lazily when service methods are invoked.
+	*/
+	createSubaccountResolver() {
+		return {
+			getDefaultSubaccountId: () => {
+				const state = this.auth.getState();
+				if (state.activeAccount && !state.activeAccount.isMain) return state.activeAccount.accountId;
+				return null;
+			},
+			getActiveAccountId: () => this.auth.getState().activeAccount?.accountId ?? null,
+			getMainAccountId: () => this.auth.getState().mainAccountId ?? null
+		};
+	}
+	/**
+	* Sets the account signer used for authenticated browser requests.
+	*/
+	setAccountSigner(accountSigner) {
+		this.auth.setAccountSigner(accountSigner);
+	}
+};
+//#endregion
+export { PolyesterBrowserClient };
+
+//# sourceMappingURL=browser-client.js.map

package/dist/browser-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-client.js","names":[],"sources":["../src/browser-client.ts"],"sourcesContent":["import { PolyesterClient, type PolyesterClientBaseConfig } from \"./core-client.js\";\nimport { AccountSignerAuthService } from \"./services/auth/account-signer-auth.js\";\nimport type { AccountSignerConfig, AccountSigner } from \"./account-signer/types.js\";\nimport type { SubaccountResolver } from \"./services/subaccount-resolver.js\";\nimport {\n    createMemoryAuthTokenStorage,\n    type AuthTokenStorage,\n} from \"./services/auth/token-storage.js\";\nimport { AuthSessionStore } from \"./services/auth/session.js\";\n\nexport interface PolyesterBrowserClientConfig extends Omit<PolyesterClientBaseConfig, \"auth\"> {\n    /**\n     * Account signer interface for authentication.\n     * Pass a signer object or a factory function for lazy initialization.\n     */\n    accountSigner?: AccountSignerConfig;\n    /**\n     * Storage for browser bearer tokens. Defaults to per-client memory storage.\n     * Use createCookieAuthTokenStorage() to opt into reload/SSR persistence.\n     */\n    tokenStorage?: AuthTokenStorage;\n}\n\n/**\n * A client for interacting with the Polyester DEX in the browser.\n */\nexport class PolyesterBrowserClient extends PolyesterClient {\n    // The base class builds `auth` through the `createAuth` runtime factory we\n    // pass below, so the lazily-constructed instance is always an\n    // AccountSignerAuthService — this override only narrows the type.\n    override get auth(): AccountSignerAuthService {\n        return super.auth as AccountSignerAuthService;\n    }\n\n    constructor(config: PolyesterBrowserClientConfig) {\n        const tokenStorage = config.tokenStorage ?? createMemoryAuthTokenStorage();\n        const sessionStore = new AuthSessionStore({\n            environmentFingerprint: config.environment.fingerprint,\n        });\n        const getToken = () => sessionStore.getEnvironmentBoundToken(tokenStorage);\n\n        super(\n            {\n                environment: config.environment,\n                interceptors: config.interceptors,\n                auth: { kind: \"jwt\", getToken },\n                wireFormat: config.wireFormat,\n                catalog: config.catalog,\n                catalogSnapshot: config.catalogSnapshot,\n                catalogCell: config.catalogCell,\n                transports: config.transports,\n                realtimeClient: config.realtimeClient,\n                realtime: {\n                    hasAuth: () => !!getToken(),\n                    ...config.realtime,\n                },\n            },\n            {\n                createAuth: ({ transports, realtime, subaccounts, environment }) =>\n                    new AccountSignerAuthService({\n                        transports,\n                        accountSignerConfig: config.accountSigner,\n                        environment,\n                        subaccounts,\n                        realtime,\n                        tokenStorage,\n                        sessionStore,\n                    }),\n            },\n        );\n    }\n\n    /**\n     * Creates a resolver that defaults subaccountId to the active subaccount.\n     * The getter is called lazily when service methods are invoked.\n     */\n    protected override createSubaccountResolver(): SubaccountResolver {\n        return {\n            getDefaultSubaccountId: () => {\n                const state = this.auth.getState();\n                if (state.activeAccount && !state.activeAccount.isMain) {\n                    return state.activeAccount.accountId;\n                }\n                return null;\n            },\n            getActiveAccountId: () => this.auth.getState().activeAccount?.accountId ?? null,\n            getMainAccountId: () => this.auth.getState().mainAccountId ?? null,\n        };\n    }\n\n    /**\n     * Sets the account signer used for authenticated browser requests.\n     */\n    setAccountSigner(accountSigner: AccountSigner | null): void {\n        this.auth.setAccountSigner(accountSigner);\n    }\n}\n"],"mappings":";;;;;;;;AA0BA,IAAa,yBAAb,cAA4C,gBAAgB;CAIxD,IAAa,OAAiC;EAC1C,OAAO,MAAM;CACjB;CAEA,YAAY,QAAsC;EAC9C,MAAM,eAAe,OAAO,gBAAgB,6BAA6B;EACzE,MAAM,eAAe,IAAI,iBAAiB,EACtC,wBAAwB,OAAO,YAAY,YAC/C,CAAC;EACD,MAAM,iBAAiB,aAAa,yBAAyB,YAAY;EAEzE,MACI;GACI,aAAa,OAAO;GACpB,cAAc,OAAO;GACrB,MAAM;IAAE,MAAM;IAAO;GAAS;GAC9B,YAAY,OAAO;GACnB,SAAS,OAAO;GAChB,iBAAiB,OAAO;GACxB,aAAa,OAAO;GACpB,YAAY,OAAO;GACnB,gBAAgB,OAAO;GACvB,UAAU;IACN,eAAe,CAAC,CAAC,SAAS;IAC1B,GAAG,OAAO;GACd;EACJ,GACA,EACI,aAAa,EAAE,YAAY,UAAU,aAAa,kBAC9C,IAAI,yBAAyB;GACzB;GACA,qBAAqB,OAAO;GAC5B;GACA;GACA;GACA;GACA;EACJ,CAAC,EACT,CACJ;CACJ;;;;;CAMA,2BAAkE;EAC9D,OAAO;GACH,8BAA8B;IAC1B,MAAM,QAAQ,KAAK,KAAK,SAAS;IACjC,IAAI,MAAM,iBAAiB,CAAC,MAAM,cAAc,QAC5C,OAAO,MAAM,cAAc;IAE/B,OAAO;GACX;GACA,0BAA0B,KAAK,KAAK,SAAS,CAAC,CAAC,eAAe,aAAa;GAC3E,wBAAwB,KAAK,KAAK,SAAS,CAAC,CAAC,iBAAiB;EAClE;CACJ;;;;CAKA,iBAAiB,eAA2C;EACxD,KAAK,KAAK,iBAAiB,aAAa;CAC5C;AACJ"}

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

@@ -0,0 +1,6 @@
+import { ClientCatalog, CreatePolyesterCatalogOptions } from "./types.js";
+//#region src/catalogs/client-catalog.d.ts
+declare function createPolyesterCatalog(options?: CreatePolyesterCatalogOptions): ClientCatalog;
+//#endregion
+export { createPolyesterCatalog };
+//# sourceMappingURL=client-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-catalog.d.ts","names":[],"sources":["../../src/catalogs/client-catalog.ts"],"mappings":";;iBAWgB,uBAAuB,UAAS,gCAAqC"}

package/dist/catalogs/client-catalog.js

@@ -0,0 +1,88 @@
+import { CatalogNotReadyError } from "./types.js";
+import { createReader } from "./readers.js";
+import { buildCatalogSnapshot } from "./snapshot.js";
+//#region src/catalogs/client-catalog.ts
+function createPolyesterCatalog(options = {}) {
+	const cell = options.cell;
+	let local = void 0;
+	const getCurrent = () => cell ? cell.get() : local;
+	const setCurrent = (snapshot) => {
+		if (cell) cell.set(snapshot);
+		else local = snapshot;
+	};
+	if (options.snapshot && !getCurrent()) setCurrent(options.snapshot);
+	const initial = getCurrent();
+	let stateValue = initial ? {
+		status: "fresh",
+		source: initial.source
+	} : { status: "empty" };
+	let refreshInFlight;
+	const reader = createReader(() => {
+		const current = getCurrent();
+		if (!current) throw new CatalogNotReadyError();
+		return current;
+	});
+	const currentSource = () => getCurrent()?.source ?? "empty";
+	function setSnapshot(snapshot) {
+		setCurrent(snapshot);
+		stateValue = {
+			status: "fresh",
+			source: snapshot.source
+		};
+	}
+	function refresh() {
+		if (options.refresh === false || options.refresh === void 0) {
+			const current = getCurrent();
+			if (!current) return Promise.reject(new CatalogNotReadyError());
+			return Promise.resolve(current);
+		}
+		if (refreshInFlight) return refreshInFlight;
+		stateValue = {
+			status: "refreshing",
+			previousSource: currentSource()
+		};
+		refreshInFlight = Promise.all([options.refresh.market(), options.refresh.zipper()]).then(([marketSeed, zipperSeed]) => {
+			const snapshot = buildCatalogSnapshot({
+				market: marketSeed,
+				zipper: zipperSeed,
+				source: "api",
+				version: (getCurrent()?.version ?? 0) + 1
+			});
+			setSnapshot(snapshot);
+			return snapshot;
+		}).catch((error) => {
+			stateValue = {
+				status: "stale",
+				source: currentSource(),
+				error
+			};
+			throw error;
+		}).finally(() => {
+			refreshInFlight = void 0;
+		});
+		return refreshInFlight;
+	}
+	function ready() {
+		const current = getCurrent();
+		if (current) return Promise.resolve(current);
+		if (refreshInFlight) return refreshInFlight.catch(() => getCurrent() ?? null);
+		return Promise.resolve(null);
+	}
+	function ensureReady() {
+		const current = getCurrent();
+		if (current) return Promise.resolve(current);
+		return refreshInFlight ?? refresh();
+	}
+	return {
+		...reader,
+		state: () => stateValue,
+		ready,
+		ensureReady,
+		refresh,
+		setSnapshot
+	};
+}
+//#endregion
+export { createPolyesterCatalog };
+
+//# sourceMappingURL=client-catalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-catalog.js","names":[],"sources":["../../src/catalogs/client-catalog.ts"],"sourcesContent":["import { createReader } from \"./readers.js\";\nimport { buildCatalogSnapshot } from \"./snapshot.js\";\nimport type {\n    CatalogSnapshot,\n    CatalogState,\n    CatalogStateSource,\n    ClientCatalog,\n    CreatePolyesterCatalogOptions,\n} from \"./types.js\";\nimport { CatalogNotReadyError } from \"./types.js\";\n\nexport function createPolyesterCatalog(options: CreatePolyesterCatalogOptions = {}): ClientCatalog {\n    const cell = options.cell;\n    let local: CatalogSnapshot | undefined = undefined;\n    const getCurrent = (): CatalogSnapshot | undefined => (cell ? cell.get() : local);\n    const setCurrent = (snapshot: CatalogSnapshot): void => {\n        if (cell) cell.set(snapshot);\n        else local = snapshot;\n    };\n    if (options.snapshot && !getCurrent()) setCurrent(options.snapshot);\n\n    const initial = getCurrent();\n    let stateValue: CatalogState = initial\n        ? { status: \"fresh\", source: initial.source }\n        : { status: \"empty\" };\n    let refreshInFlight: Promise<CatalogSnapshot> | undefined;\n\n    const reader = createReader(() => {\n        const current = getCurrent();\n        if (!current) throw new CatalogNotReadyError();\n        return current;\n    });\n\n    const currentSource = (): CatalogStateSource => getCurrent()?.source ?? \"empty\";\n\n    function setSnapshot(snapshot: CatalogSnapshot): void {\n        setCurrent(snapshot);\n        stateValue = { status: \"fresh\", source: snapshot.source };\n    }\n\n    function refresh(): Promise<CatalogSnapshot> {\n        if (options.refresh === false || options.refresh === undefined) {\n            const current = getCurrent();\n            if (!current) return Promise.reject(new CatalogNotReadyError());\n            return Promise.resolve(current);\n        }\n        if (refreshInFlight) return refreshInFlight;\n\n        stateValue = { status: \"refreshing\", previousSource: currentSource() };\n        refreshInFlight = Promise.all([options.refresh.market(), options.refresh.zipper()])\n            .then(([marketSeed, zipperSeed]) => {\n                const snapshot = buildCatalogSnapshot({\n                    market: marketSeed,\n                    zipper: zipperSeed,\n                    source: \"api\",\n                    version: (getCurrent()?.version ?? 0) + 1,\n                });\n                setSnapshot(snapshot);\n                return snapshot;\n            })\n            .catch((error) => {\n                stateValue = { status: \"stale\", source: currentSource(), error };\n                throw error;\n            })\n            .finally(() => {\n                refreshInFlight = undefined;\n            });\n\n        return refreshInFlight;\n    }\n\n    function ready(): Promise<CatalogSnapshot | null> {\n        const current = getCurrent();\n        if (current) return Promise.resolve(current);\n        if (refreshInFlight) return refreshInFlight.catch(() => getCurrent() ?? null);\n        return Promise.resolve(null);\n    }\n\n    function ensureReady(): Promise<CatalogSnapshot> {\n        const current = getCurrent();\n        if (current) return Promise.resolve(current);\n        return refreshInFlight ?? refresh();\n    }\n\n    return {\n        ...reader,\n        state: () => stateValue,\n        ready,\n        ensureReady,\n        refresh,\n        setSnapshot,\n    };\n}\n"],"mappings":";;;;AAWA,SAAgB,uBAAuB,UAAyC,CAAC,GAAkB;CAC/F,MAAM,OAAO,QAAQ;CACrB,IAAI,QAAqC,KAAA;CACzC,MAAM,mBAAiD,OAAO,KAAK,IAAI,IAAI;CAC3E,MAAM,cAAc,aAAoC;EACpD,IAAI,MAAM,KAAK,IAAI,QAAQ;OACtB,QAAQ;CACjB;CACA,IAAI,QAAQ,YAAY,CAAC,WAAW,GAAG,WAAW,QAAQ,QAAQ;CAElE,MAAM,UAAU,WAAW;CAC3B,IAAI,aAA2B,UACzB;EAAE,QAAQ;EAAS,QAAQ,QAAQ;CAAO,IAC1C,EAAE,QAAQ,QAAQ;CACxB,IAAI;CAEJ,MAAM,SAAS,mBAAmB;EAC9B,MAAM,UAAU,WAAW;EAC3B,IAAI,CAAC,SAAS,MAAM,IAAI,qBAAqB;EAC7C,OAAO;CACX,CAAC;CAED,MAAM,sBAA0C,WAAW,CAAC,EAAE,UAAU;CAExE,SAAS,YAAY,UAAiC;EAClD,WAAW,QAAQ;EACnB,aAAa;GAAE,QAAQ;GAAS,QAAQ,SAAS;EAAO;CAC5D;CAEA,SAAS,UAAoC;EACzC,IAAI,QAAQ,YAAY,SAAS,QAAQ,YAAY,KAAA,GAAW;GAC5D,MAAM,UAAU,WAAW;GAC3B,IAAI,CAAC,SAAS,OAAO,QAAQ,OAAO,IAAI,qBAAqB,CAAC;GAC9D,OAAO,QAAQ,QAAQ,OAAO;EAClC;EACA,IAAI,iBAAiB,OAAO;EAE5B,aAAa;GAAE,QAAQ;GAAc,gBAAgB,cAAc;EAAE;EACrE,kBAAkB,QAAQ,IAAI,CAAC,QAAQ,QAAQ,OAAO,GAAG,QAAQ,QAAQ,OAAO,CAAC,CAAC,CAAC,CAC9E,MAAM,CAAC,YAAY,gBAAgB;GAChC,MAAM,WAAW,qBAAqB;IAClC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU,WAAW,CAAC,EAAE,WAAW,KAAK;GAC5C,CAAC;GACD,YAAY,QAAQ;GACpB,OAAO;EACX,CAAC,CAAC,CACD,OAAO,UAAU;GACd,aAAa;IAAE,QAAQ;IAAS,QAAQ,cAAc;IAAG;GAAM;GAC/D,MAAM;EACV,CAAC,CAAC,CACD,cAAc;GACX,kBAAkB,KAAA;EACtB,CAAC;EAEL,OAAO;CACX;CAEA,SAAS,QAAyC;EAC9C,MAAM,UAAU,WAAW;EAC3B,IAAI,SAAS,OAAO,QAAQ,QAAQ,OAAO;EAC3C,IAAI,iBAAiB,OAAO,gBAAgB,YAAY,WAAW,KAAK,IAAI;EAC5E,OAAO,QAAQ,QAAQ,IAAI;CAC/B;CAEA,SAAS,cAAwC;EAC7C,MAAM,UAAU,WAAW;EAC3B,IAAI,SAAS,OAAO,QAAQ,QAAQ,OAAO;EAC3C,OAAO,mBAAmB,QAAQ;CACtC;CAEA,OAAO;EACH,GAAG;EACH,aAAa;EACb;EACA;EACA;EACA;CACJ;AACJ"}

package/dist/catalogs/decimal.js

@@ -0,0 +1,92 @@
+//#region src/catalogs/decimal.ts
+const STRICT_DECIMAL_PATTERN = /^\d+(?:\.\d+)?$/;
+const INPUT_DECIMAL_PATTERN = /^(?:\d+(?:\.\d*)?|\.\d+)$/;
+const SCALED_INTEGER_PATTERN = /^-?\d+$/;
+/**
+* Strictly converts a non-negative decimal string into a scaled bigint.
+* Fails on anything that is not a plain decimal number or that carries more
+* fractional digits than the scale can represent. Never rounds.
+*/
+function tryDecimalToScaled(decimal, scale) {
+	const raw = decimal.trim();
+	if (!STRICT_DECIMAL_PATTERN.test(raw)) return {
+		ok: false,
+		failure: { reason: "invalid" }
+	};
+	const [intPart = "0", fracPart = ""] = raw.split(".");
+	if (fracPart.length > scale) return {
+		ok: false,
+		failure: {
+			reason: "precision",
+			maxDecimals: scale
+		}
+	};
+	return {
+		ok: true,
+		scaled: BigInt(intPart + fracPart.padEnd(scale, "0"))
+	};
+}
+/**
+* Coerces a raw scaled integer (bigint, safe integer number, or base-10
+* integer string) into a bigint. Returns null for anything else — including
+* decimal strings, which indicate the caller is holding an unscaled value.
+*/
+function tryToScaledBigInt(value) {
+	if (typeof value === "bigint") return value;
+	if (typeof value === "number") return Number.isSafeInteger(value) ? BigInt(value) : null;
+	const raw = value.trim();
+	return SCALED_INTEGER_PATTERN.test(raw) ? BigInt(raw) : null;
+}
+/**
+* Renders a scaled bigint as an exact decimal string with trailing zeros
+* trimmed (`1500000n` at scale 6 → `"1.5"`).
+*/
+function scaledToDecimal(scaled, scale) {
+	const negative = scaled < 0n;
+	const digits = (negative ? -scaled : scaled).toString();
+	if (scale <= 0) return negative && digits !== "0" ? `-${digits}` : digits;
+	const padded = digits.padStart(scale + 1, "0");
+	const intPart = padded.slice(0, -scale);
+	const fracPart = padded.slice(-scale).replace(/0+$/, "");
+	const body = fracPart ? `${intPart}.${fracPart}` : intPart;
+	return negative && body !== "0" ? `-${body}` : body;
+}
+/**
+* Renders a scaled bigint as a display-normalized decimal string: rounded
+* half-up (away from zero) to `displayDecimals` and trailing zeros trimmed.
+* Not locale-aware — display strings stay plain decimal strings.
+*/
+function scaledToDisplay(scaled, scale, displayDecimals) {
+	const decimals = Math.max(0, Math.trunc(displayDecimals));
+	if (decimals >= scale) return scaledToDecimal(scaled, scale);
+	const negative = scaled < 0n;
+	const abs = negative ? -scaled : scaled;
+	const divisor = 10n ** BigInt(scale - decimals);
+	const body = scaledToDecimal((abs + divisor / 2n) / divisor, decimals);
+	return negative && body !== "0" ? `-${body}` : body;
+}
+/**
+* Normalizes raw user input into a canonical decimal string, truncating (not
+* rounding) fractional digits beyond `maxDecimals`. Tolerates partial input
+* forms like `".5"` and `"5."`. Returns null when the input is not a decimal.
+*/
+function tryNormalizeDecimalInput(raw, maxDecimals) {
+	const trimmed = raw.trim();
+	if (!INPUT_DECIMAL_PATTERN.test(trimmed)) return null;
+	const [intRaw = "", fracRaw = ""] = trimmed.split(".");
+	const intPart = intRaw.replace(/^0+(?=\d)/, "") || "0";
+	const fracPart = fracRaw.slice(0, Math.max(0, maxDecimals)).replace(/0+$/, "");
+	return fracPart ? `${intPart}.${fracPart}` : intPart;
+}
+/**
+* Counts the significant fractional digits of a decimal string
+* (`"0.010"` → 2). Used to derive display precision from tick sizes.
+*/
+function significantDecimalPlaces(decimal) {
+	const fracPart = decimal.split(".")[1];
+	return fracPart ? fracPart.replace(/0+$/, "").length : 0;
+}
+//#endregion
+export { scaledToDecimal, scaledToDisplay, significantDecimalPlaces, tryDecimalToScaled, tryNormalizeDecimalInput, tryToScaledBigInt };
+
+//# sourceMappingURL=decimal.js.map

package/dist/catalogs/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","names":[],"sources":["../../src/catalogs/decimal.ts"],"sourcesContent":["/**\n * Internal decimal-string math backing catalog conversions.\n *\n * Catalog conversions operate on JSON-safe strings only: human decimal strings\n * on one side and scaled integer strings on the SDK/API side. BigInt is an\n * implementation detail of this module and never crosses the public surface.\n */\n\n/** Raw scaled integer accepted on the SDK side of a conversion. */\nexport type ScaledIntegerLike = bigint | number | string;\n\nconst STRICT_DECIMAL_PATTERN = /^\\d+(?:\\.\\d+)?$/;\nconst INPUT_DECIMAL_PATTERN = /^(?:\\d+(?:\\.\\d*)?|\\.\\d+)$/;\nconst SCALED_INTEGER_PATTERN = /^-?\\d+$/;\n\nexport type DecimalToScaledFailure =\n    | { reason: \"invalid\" }\n    | { reason: \"precision\"; maxDecimals: number };\n\nexport type DecimalToScaledResult =\n    | { ok: true; scaled: bigint }\n    | { ok: false; failure: DecimalToScaledFailure };\n\n/**\n * Strictly converts a non-negative decimal string into a scaled bigint.\n * Fails on anything that is not a plain decimal number or that carries more\n * fractional digits than the scale can represent. Never rounds.\n */\nexport function tryDecimalToScaled(decimal: string, scale: number): DecimalToScaledResult {\n    const raw = decimal.trim();\n    if (!STRICT_DECIMAL_PATTERN.test(raw)) return { ok: false, failure: { reason: \"invalid\" } };\n    const [intPart = \"0\", fracPart = \"\"] = raw.split(\".\");\n    if (fracPart.length > scale) {\n        return { ok: false, failure: { reason: \"precision\", maxDecimals: scale } };\n    }\n    return { ok: true, scaled: BigInt(intPart + fracPart.padEnd(scale, \"0\")) };\n}\n\n/**\n * Coerces a raw scaled integer (bigint, safe integer number, or base-10\n * integer string) into a bigint. Returns null for anything else — including\n * decimal strings, which indicate the caller is holding an unscaled value.\n */\nexport function tryToScaledBigInt(value: ScaledIntegerLike): bigint | null {\n    if (typeof value === \"bigint\") return value;\n    if (typeof value === \"number\") {\n        return Number.isSafeInteger(value) ? BigInt(value) : null;\n    }\n    const raw = value.trim();\n    return SCALED_INTEGER_PATTERN.test(raw) ? BigInt(raw) : null;\n}\n\n/**\n * Renders a scaled bigint as an exact decimal string with trailing zeros\n * trimmed (`1500000n` at scale 6 → `\"1.5\"`).\n */\nexport function scaledToDecimal(scaled: bigint, scale: number): string {\n    const negative = scaled < 0n;\n    const digits = (negative ? -scaled : scaled).toString();\n    if (scale <= 0) return negative && digits !== \"0\" ? `-${digits}` : digits;\n    const padded = digits.padStart(scale + 1, \"0\");\n    const intPart = padded.slice(0, -scale);\n    const fracPart = padded.slice(-scale).replace(/0+$/, \"\");\n    const body = fracPart ? `${intPart}.${fracPart}` : intPart;\n    return negative && body !== \"0\" ? `-${body}` : body;\n}\n\n/**\n * Renders a scaled bigint as a display-normalized decimal string: rounded\n * half-up (away from zero) to `displayDecimals` and trailing zeros trimmed.\n * Not locale-aware — display strings stay plain decimal strings.\n */\nexport function scaledToDisplay(scaled: bigint, scale: number, displayDecimals: number): string {\n    const decimals = Math.max(0, Math.trunc(displayDecimals));\n    if (decimals >= scale) return scaledToDecimal(scaled, scale);\n    const negative = scaled < 0n;\n    const abs = negative ? -scaled : scaled;\n    const divisor = 10n ** BigInt(scale - decimals);\n    const rounded = (abs + divisor / 2n) / divisor;\n    const body = scaledToDecimal(rounded, decimals);\n    return negative && body !== \"0\" ? `-${body}` : body;\n}\n\n/**\n * Normalizes raw user input into a canonical decimal string, truncating (not\n * rounding) fractional digits beyond `maxDecimals`. Tolerates partial input\n * forms like `\".5\"` and `\"5.\"`. Returns null when the input is not a decimal.\n */\nexport function tryNormalizeDecimalInput(raw: string, maxDecimals: number): string | null {\n    const trimmed = raw.trim();\n    if (!INPUT_DECIMAL_PATTERN.test(trimmed)) return null;\n    const [intRaw = \"\", fracRaw = \"\"] = trimmed.split(\".\");\n    const intPart = intRaw.replace(/^0+(?=\\d)/, \"\") || \"0\";\n    const fracPart = fracRaw.slice(0, Math.max(0, maxDecimals)).replace(/0+$/, \"\");\n    return fracPart ? `${intPart}.${fracPart}` : intPart;\n}\n\n/**\n * Counts the significant fractional digits of a decimal string\n * (`\"0.010\"` → 2). Used to derive display precision from tick sizes.\n */\nexport function significantDecimalPlaces(decimal: string): number {\n    const fracPart = decimal.split(\".\")[1];\n    return fracPart ? fracPart.replace(/0+$/, \"\").length : 0;\n}\n"],"mappings":";AAWA,MAAM,yBAAyB;AAC/B,MAAM,wBAAwB;AAC9B,MAAM,yBAAyB;;;;;;AAe/B,SAAgB,mBAAmB,SAAiB,OAAsC;CACtF,MAAM,MAAM,QAAQ,KAAK;CACzB,IAAI,CAAC,uBAAuB,KAAK,GAAG,GAAG,OAAO;EAAE,IAAI;EAAO,SAAS,EAAE,QAAQ,UAAU;CAAE;CAC1F,MAAM,CAAC,UAAU,KAAK,WAAW,MAAM,IAAI,MAAM,GAAG;CACpD,IAAI,SAAS,SAAS,OAClB,OAAO;EAAE,IAAI;EAAO,SAAS;GAAE,QAAQ;GAAa,aAAa;EAAM;CAAE;CAE7E,OAAO;EAAE,IAAI;EAAM,QAAQ,OAAO,UAAU,SAAS,OAAO,OAAO,GAAG,CAAC;CAAE;AAC7E;;;;;;AAOA,SAAgB,kBAAkB,OAAyC;CACvE,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,OAAO,UAAU,UACjB,OAAO,OAAO,cAAc,KAAK,IAAI,OAAO,KAAK,IAAI;CAEzD,MAAM,MAAM,MAAM,KAAK;CACvB,OAAO,uBAAuB,KAAK,GAAG,IAAI,OAAO,GAAG,IAAI;AAC5D;;;;;AAMA,SAAgB,gBAAgB,QAAgB,OAAuB;CACnE,MAAM,WAAW,SAAS;CAC1B,MAAM,UAAU,WAAW,CAAC,SAAS,OAAA,CAAQ,SAAS;CACtD,IAAI,SAAS,GAAG,OAAO,YAAY,WAAW,MAAM,IAAI,WAAW;CACnE,MAAM,SAAS,OAAO,SAAS,QAAQ,GAAG,GAAG;CAC7C,MAAM,UAAU,OAAO,MAAM,GAAG,CAAC,KAAK;CACtC,MAAM,WAAW,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,OAAO,EAAE;CACvD,MAAM,OAAO,WAAW,GAAG,QAAQ,GAAG,aAAa;CACnD,OAAO,YAAY,SAAS,MAAM,IAAI,SAAS;AACnD;;;;;;AAOA,SAAgB,gBAAgB,QAAgB,OAAe,iBAAiC;CAC5F,MAAM,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,eAAe,CAAC;CACxD,IAAI,YAAY,OAAO,OAAO,gBAAgB,QAAQ,KAAK;CAC3D,MAAM,WAAW,SAAS;CAC1B,MAAM,MAAM,WAAW,CAAC,SAAS;CACjC,MAAM,UAAU,OAAO,OAAO,QAAQ,QAAQ;CAE9C,MAAM,OAAO,iBADI,MAAM,UAAU,MAAM,SACD,QAAQ;CAC9C,OAAO,YAAY,SAAS,MAAM,IAAI,SAAS;AACnD;;;;;;AAOA,SAAgB,yBAAyB,KAAa,aAAoC;CACtF,MAAM,UAAU,IAAI,KAAK;CACzB,IAAI,CAAC,sBAAsB,KAAK,OAAO,GAAG,OAAO;CACjD,MAAM,CAAC,SAAS,IAAI,UAAU,MAAM,QAAQ,MAAM,GAAG;CACrD,MAAM,UAAU,OAAO,QAAQ,aAAa,EAAE,KAAK;CACnD,MAAM,WAAW,QAAQ,MAAM,GAAG,KAAK,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE;CAC7E,OAAO,WAAW,GAAG,QAAQ,GAAG,aAAa;AACjD;;;;;AAMA,SAAgB,yBAAyB,SAAyB;CAC9D,MAAM,WAAW,QAAQ,MAAM,GAAG,CAAC,CAAC;CACpC,OAAO,WAAW,SAAS,QAAQ,OAAO,EAAE,CAAC,CAAC,SAAS;AAC3D"}

package/dist/catalogs/index.d.ts

@@ -0,0 +1,10 @@
+import { AssetConfig, DepositWithdrawConfig, PAIR_STATUSES, PairConfig, PairMarketDataConfig, PairStatus, SpotConfig, ZipperAssetChainVariant, ZipperAssetConfig, ZipperChainConfig, ZipperChainContractConfig } from "../shared/catalog-config.js";
+import { EnrichedPairConfig, MarketCatalogData, MarketCatalogSeed } from "./market-data-catalog.js";
+import { ZipperCatalogData, ZipperCatalogSeed, ZipperContractName, ZipperEnrichedAssetChain, ZipperEnrichedAssetConfig } from "./zipper-catalog.js";
+import { 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 } from "./types.js";
+import { createPolyesterCatalog } from "./client-catalog.js";
+import { createCatalogSnapshotReader } from "./readers.js";
+import { CatalogSnapshotInput, buildCatalogSnapshot } from "./snapshot.js";
+import { ZippedAssetSupplyCatalogUpdate, patchZipperCatalogSupply } from "./zipper-supply.js";
+import { UNKNOWN_ASSET_LABEL, UNKNOWN_LEDGER_ASSET_ID, isUnknownLedgerAsset, isUnknownZipperAsset, unknownLedgerAsset, unknownZipperAsset } from "./unknown-asset.js";
+export { type AssetCatalogKey, type AssetConfig, CatalogConversionError, type CatalogLookupDomain, CatalogLookupError, CatalogNotReadyError, type CatalogReader, type CatalogRefreshSource, type CatalogSnapshot, type CatalogSnapshotCell, type CatalogSnapshotInput, type CatalogSnapshotSource, type CatalogState, type CatalogStateSource, type CatalogValidationError, CatalogValidationFailedError, type CatalogValidationResult, type ChainCatalogKey, type ClientCatalog, type CreatePolyesterCatalogOptions, type DepositWithdrawConfig, type EnrichedPairConfig, type LedgerCatalogReader, type MarketCatalogData, type MarketCatalogReader, type MarketCatalogSeed, type OrdersCatalogReader, PAIR_STATUSES, type PairCatalogKey, type PairConfig, type PairMarketDataConfig, type PairStatus, type ParsedCatalogAmount, type ScaledIntegerLike, type SpotConfig, type SpotOrderConstraints, type SpotOrderDecimalInput, UNKNOWN_ASSET_LABEL, UNKNOWN_LEDGER_ASSET_ID, type ZippedAssetSupplyCatalogUpdate, type ZipperAssetChainRoute, type ZipperAssetChainVariant, type ZipperAssetConfig, type ZipperCatalogData, type ZipperCatalogReader, type ZipperCatalogSeed, type ZipperChainConfig, type ZipperChainContractConfig, type ZipperContractName, type ZipperEnrichedAssetChain, type ZipperEnrichedAssetConfig, buildCatalogSnapshot, createCatalogSnapshotReader, createPolyesterCatalog, isUnknownLedgerAsset, isUnknownZipperAsset, patchZipperCatalogSupply, unknownLedgerAsset, unknownZipperAsset };

package/dist/catalogs/index.js

@@ -0,0 +1,8 @@
+import { CatalogConversionError, CatalogLookupError, CatalogNotReadyError, CatalogValidationFailedError } from "./types.js";
+import { UNKNOWN_ASSET_LABEL, UNKNOWN_LEDGER_ASSET_ID, isUnknownLedgerAsset, isUnknownZipperAsset, unknownLedgerAsset, unknownZipperAsset } from "./unknown-asset.js";
+import { createCatalogSnapshotReader } from "./readers.js";
+import { PAIR_STATUSES } from "../shared/catalog-config.js";
+import { buildCatalogSnapshot } from "./snapshot.js";
+import { createPolyesterCatalog } from "./client-catalog.js";
+import { patchZipperCatalogSupply } from "./zipper-supply.js";
+export { CatalogConversionError, CatalogLookupError, CatalogNotReadyError, CatalogValidationFailedError, PAIR_STATUSES, UNKNOWN_ASSET_LABEL, UNKNOWN_LEDGER_ASSET_ID, buildCatalogSnapshot, createCatalogSnapshotReader, createPolyesterCatalog, isUnknownLedgerAsset, isUnknownZipperAsset, patchZipperCatalogSupply, unknownLedgerAsset, unknownZipperAsset };

package/dist/catalogs/indexes.js

@@ -0,0 +1,36 @@
+//#region src/catalogs/indexes.ts
+const indexesBySnapshot = /* @__PURE__ */ new WeakMap();
+function buildZipperRoutesByZippedAssetId(assets) {
+	const routes = /* @__PURE__ */ new Map();
+	for (const asset of assets) for (const chain of asset.chains) routes.set(chain.zippedAssetId, {
+		asset,
+		chain
+	});
+	return routes;
+}
+function indexesFor(snapshot) {
+	const existing = indexesBySnapshot.get(snapshot);
+	if (existing?.version === snapshot.version) return existing.indexes;
+	const indexes = {
+		assetBySymbol: new Map(snapshot.market.assets.map((asset) => [asset.symbol, asset])),
+		assetByLedgerId: new Map(snapshot.market.assets.map((asset) => [asset.ledgerId, asset])),
+		pairBySymbol: new Map(snapshot.market.pairs.map((pair) => [pair.symbol, pair])),
+		pairBySymbolId: new Map(snapshot.market.pairs.map((pair) => [pair.symbolId, pair])),
+		zipperChainByCode: new Map(snapshot.zipper.chains.map((chain) => [chain.code, chain])),
+		zipperChainById: new Map(snapshot.zipper.chains.map((chain) => [chain.chainId, chain])),
+		zipperAssetBySymbol: new Map(snapshot.zipper.assets.map((asset) => [asset.asset, asset])),
+		zipperAssetByLedgerId: new Map(snapshot.zipper.assets.map((asset) => [asset.ledgerId, asset])),
+		zipperAssetByUAssetId: new Map(snapshot.zipper.assets.filter((asset) => asset.uAssetId !== "").map((asset) => [asset.uAssetId, asset])),
+		zipperRouteByZippedAssetId: buildZipperRoutesByZippedAssetId(snapshot.zipper.assets),
+		zipperContractByName: new Map(snapshot.zipper.contracts.map((contract) => [contract.name, contract]))
+	};
+	indexesBySnapshot.set(snapshot, {
+		version: snapshot.version,
+		indexes
+	});
+	return indexes;
+}
+//#endregion
+export { indexesFor };
+
+//# sourceMappingURL=indexes.js.map

package/dist/catalogs/indexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.js","names":[],"sources":["../../src/catalogs/indexes.ts"],"sourcesContent":["import type {\n    AssetConfig,\n    ZipperChainConfig,\n    ZipperChainContractConfig,\n} from \"../shared/catalog-config.js\";\nimport type { EnrichedPairConfig } from \"./market-data-catalog.js\";\nimport type { CatalogSnapshot, ZipperAssetChainRoute } from \"./types.js\";\nimport type { ZipperEnrichedAssetConfig } from \"./zipper-catalog.js\";\n\nexport interface CatalogIndexes {\n    readonly assetBySymbol: Map<string, AssetConfig>;\n    readonly assetByLedgerId: Map<number, AssetConfig>;\n    readonly pairBySymbol: Map<string, EnrichedPairConfig>;\n    readonly pairBySymbolId: Map<number, EnrichedPairConfig>;\n    readonly zipperChainByCode: Map<string, ZipperChainConfig>;\n    readonly zipperChainById: Map<number, ZipperChainConfig>;\n    readonly zipperAssetBySymbol: Map<string, ZipperEnrichedAssetConfig>;\n    readonly zipperAssetByLedgerId: Map<number, ZipperEnrichedAssetConfig>;\n    readonly zipperAssetByUAssetId: Map<string, ZipperEnrichedAssetConfig>;\n    readonly zipperRouteByZippedAssetId: Map<number, ZipperAssetChainRoute>;\n    readonly zipperContractByName: Map<string, ZipperChainContractConfig>;\n}\n\ntype CatalogIndexCacheEntry = {\n    readonly version: number;\n    readonly indexes: CatalogIndexes;\n};\n\nconst indexesBySnapshot = new WeakMap<CatalogSnapshot, CatalogIndexCacheEntry>();\n\nfunction buildZipperRoutesByZippedAssetId(\n    assets: readonly ZipperEnrichedAssetConfig[],\n): Map<number, ZipperAssetChainRoute> {\n    const routes = new Map<number, ZipperAssetChainRoute>();\n    for (const asset of assets) {\n        for (const chain of asset.chains) {\n            routes.set(chain.zippedAssetId, { asset, chain });\n        }\n    }\n    return routes;\n}\n\nexport function indexesFor(snapshot: CatalogSnapshot): CatalogIndexes {\n    const existing = indexesBySnapshot.get(snapshot);\n    if (existing?.version === snapshot.version) return existing.indexes;\n\n    const indexes: CatalogIndexes = {\n        assetBySymbol: new Map(snapshot.market.assets.map((asset) => [asset.symbol, asset])),\n        assetByLedgerId: new Map(snapshot.market.assets.map((asset) => [asset.ledgerId, asset])),\n        pairBySymbol: new Map(snapshot.market.pairs.map((pair) => [pair.symbol, pair])),\n        pairBySymbolId: new Map(snapshot.market.pairs.map((pair) => [pair.symbolId, pair])),\n        zipperChainByCode: new Map(snapshot.zipper.chains.map((chain) => [chain.code, chain])),\n        zipperChainById: new Map(snapshot.zipper.chains.map((chain) => [chain.chainId, chain])),\n        zipperAssetBySymbol: new Map(snapshot.zipper.assets.map((asset) => [asset.asset, asset])),\n        zipperAssetByLedgerId: new Map(\n            snapshot.zipper.assets.map((asset) => [asset.ledgerId, asset]),\n        ),\n        zipperAssetByUAssetId: new Map(\n            snapshot.zipper.assets\n                .filter((asset) => asset.uAssetId !== \"\")\n                .map((asset) => [asset.uAssetId, asset]),\n        ),\n        zipperRouteByZippedAssetId: buildZipperRoutesByZippedAssetId(snapshot.zipper.assets),\n        zipperContractByName: new Map(\n            snapshot.zipper.contracts.map((contract) => [contract.name, contract]),\n        ),\n    };\n    indexesBySnapshot.set(snapshot, { version: snapshot.version, indexes });\n    return indexes;\n}\n"],"mappings":";AA4BA,MAAM,oCAAoB,IAAI,QAAiD;AAE/E,SAAS,iCACL,QACkC;CAClC,MAAM,yBAAS,IAAI,IAAmC;CACtD,KAAK,MAAM,SAAS,QAChB,KAAK,MAAM,SAAS,MAAM,QACtB,OAAO,IAAI,MAAM,eAAe;EAAE;EAAO;CAAM,CAAC;CAGxD,OAAO;AACX;AAEA,SAAgB,WAAW,UAA2C;CAClE,MAAM,WAAW,kBAAkB,IAAI,QAAQ;CAC/C,IAAI,UAAU,YAAY,SAAS,SAAS,OAAO,SAAS;CAE5D,MAAM,UAA0B;EAC5B,eAAe,IAAI,IAAI,SAAS,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC;EACnF,iBAAiB,IAAI,IAAI,SAAS,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,UAAU,KAAK,CAAC,CAAC;EACvF,cAAc,IAAI,IAAI,SAAS,OAAO,MAAM,KAAK,SAAS,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;EAC9E,gBAAgB,IAAI,IAAI,SAAS,OAAO,MAAM,KAAK,SAAS,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC;EAClF,mBAAmB,IAAI,IAAI,SAAS,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;EACrF,iBAAiB,IAAI,IAAI,SAAS,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,SAAS,KAAK,CAAC,CAAC;EACtF,qBAAqB,IAAI,IAAI,SAAS,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;EACxF,uBAAuB,IAAI,IACvB,SAAS,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,UAAU,KAAK,CAAC,CACjE;EACA,uBAAuB,IAAI,IACvB,SAAS,OAAO,OACX,QAAQ,UAAU,MAAM,aAAa,EAAE,CAAC,CACxC,KAAK,UAAU,CAAC,MAAM,UAAU,KAAK,CAAC,CAC/C;EACA,4BAA4B,iCAAiC,SAAS,OAAO,MAAM;EACnF,sBAAsB,IAAI,IACtB,SAAS,OAAO,UAAU,KAAK,aAAa,CAAC,SAAS,MAAM,QAAQ,CAAC,CACzE;CACJ;CACA,kBAAkB,IAAI,UAAU;EAAE,SAAS,SAAS;EAAS;CAAQ,CAAC;CACtE,OAAO;AACX"}

package/dist/catalogs/market-data-catalog.d.ts

@@ -0,0 +1,37 @@
+import { AssetConfig, PairConfig, PairMarketDataConfig, PairStatus, SpotConfig } from "../shared/catalog-config.js";
+//#region src/catalogs/market-data-catalog.d.ts
+/**
+ * Enriched pair config where baseAsset/quoteAsset are full AssetConfig objects
+ * instead of just string identifiers.
+ */
+interface EnrichedPairConfig {
+  symbolId: number;
+  symbol: string;
+  baseAsset: AssetConfig;
+  quoteAsset: AssetConfig;
+  tickSize: string;
+  stepSize: string;
+  minNotionalQuote: string;
+  minQtyBase: string;
+  allowBuyFeeFromBase: boolean;
+  defaultMarketSlippagePctBuy: number;
+  defaultMarketSlippagePctSell: number;
+  maxClientRefDriftPct: number;
+  marketdata?: PairMarketDataConfig;
+  listingAt: number | null;
+  delistingAt: number | null;
+  status: PairStatus;
+}
+interface MarketCatalogData {
+  readonly assets: readonly AssetConfig[];
+  readonly pairs: readonly EnrichedPairConfig[];
+  readonly tsSec?: number;
+}
+type MarketCatalogSeed = SpotConfig | {
+  readonly assets: readonly AssetConfig[];
+  readonly pairs: readonly (PairConfig | EnrichedPairConfig)[];
+  readonly tsSec?: number;
+};
+//#endregion
+export { EnrichedPairConfig, MarketCatalogData, MarketCatalogSeed };
+//# sourceMappingURL=market-data-catalog.d.ts.map

package/dist/catalogs/market-data-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-data-catalog.d.ts","names":[],"sources":["../../src/catalogs/market-data-catalog.ts"],"mappings":";;;;;;UAciB;EACb;EACA;EACA,WAAW;EACX,YAAY;EACZ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,aAAa;EACb;EACA;EACA,QAAQ;;UAGK;WACJ,iBAAiB;WACjB,gBAAgB;WAChB;;KAGD,oBACN;WAEa,iBAAiB;WACjB,iBAAiB,aAAa;WAC9B"}

package/dist/catalogs/market-data-catalog.js

@@ -0,0 +1,49 @@
+//#region src/catalogs/market-data-catalog.ts
+function isEnrichedPair(pair) {
+	return typeof pair.baseAsset === "object" && typeof pair.quoteAsset === "object";
+}
+function enrichMarketPairs(pairs, assets) {
+	const assetBySymbol = new Map(assets.map((asset) => [asset.symbol, asset]));
+	const enrichedPairs = [];
+	for (const pair of pairs) {
+		if (isEnrichedPair(pair)) {
+			enrichedPairs.push(pair);
+			continue;
+		}
+		const baseAsset = assetBySymbol.get(pair.baseAsset);
+		const quoteAsset = assetBySymbol.get(pair.quoteAsset);
+		if (!baseAsset || !quoteAsset) throw new Error(`[catalog] market pair ${pair.symbol} references unknown asset: base=${pair.baseAsset}, quote=${pair.quoteAsset}`);
+		enrichedPairs.push({
+			symbolId: pair.symbolId,
+			symbol: pair.symbol,
+			baseAsset,
+			quoteAsset,
+			tickSize: pair.tickSize,
+			stepSize: pair.stepSize,
+			minNotionalQuote: pair.minNotionalQuote,
+			minQtyBase: pair.minQtyBase,
+			allowBuyFeeFromBase: pair.allowBuyFeeFromBase,
+			defaultMarketSlippagePctBuy: pair.defaultMarketSlippagePctBuy,
+			defaultMarketSlippagePctSell: pair.defaultMarketSlippagePctSell,
+			maxClientRefDriftPct: pair.maxClientRefDriftPct,
+			marketdata: pair.marketdata,
+			listingAt: pair.listingAt ?? null,
+			delistingAt: pair.delistingAt ?? null,
+			status: pair.status
+		});
+	}
+	return enrichedPairs;
+}
+function buildMarketCatalogData(seed) {
+	const assets = [...seed.assets];
+	const pairs = enrichMarketPairs(seed.pairs, assets);
+	return Object.freeze({
+		assets: Object.freeze(assets),
+		pairs: Object.freeze([...pairs]),
+		tsSec: seed.tsSec
+	});
+}
+//#endregion
+export { buildMarketCatalogData, enrichMarketPairs };
+
+//# sourceMappingURL=market-data-catalog.js.map

package/dist/catalogs/market-data-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-data-catalog.js","names":[],"sources":["../../src/catalogs/market-data-catalog.ts"],"sourcesContent":["import type {\n    AssetConfig,\n    PairConfig,\n    PairMarketDataConfig,\n    PairStatus,\n    SpotConfig,\n} from \"../shared/catalog-config.js\";\n\nexport type { PairMarketDataConfig } from \"../shared/catalog-config.js\";\n\n/**\n * Enriched pair config where baseAsset/quoteAsset are full AssetConfig objects\n * instead of just string identifiers.\n */\nexport interface EnrichedPairConfig {\n    symbolId: number;\n    symbol: string;\n    baseAsset: AssetConfig;\n    quoteAsset: AssetConfig;\n    tickSize: string;\n    stepSize: string;\n    minNotionalQuote: string;\n    minQtyBase: string;\n    allowBuyFeeFromBase: boolean;\n    defaultMarketSlippagePctBuy: number;\n    defaultMarketSlippagePctSell: number;\n    maxClientRefDriftPct: number;\n    marketdata?: PairMarketDataConfig;\n    listingAt: number | null;\n    delistingAt: number | null;\n    status: PairStatus;\n}\n\nexport interface MarketCatalogData {\n    readonly assets: readonly AssetConfig[];\n    readonly pairs: readonly EnrichedPairConfig[];\n    readonly tsSec?: number;\n}\n\nexport type MarketCatalogSeed =\n    | SpotConfig\n    | {\n          readonly assets: readonly AssetConfig[];\n          readonly pairs: readonly (PairConfig | EnrichedPairConfig)[];\n          readonly tsSec?: number;\n      };\n\nfunction isEnrichedPair(pair: PairConfig | EnrichedPairConfig): pair is EnrichedPairConfig {\n    return typeof pair.baseAsset === \"object\" && typeof pair.quoteAsset === \"object\";\n}\n\nexport function enrichMarketPairs(\n    pairs: readonly (PairConfig | EnrichedPairConfig)[],\n    assets: readonly AssetConfig[],\n): readonly EnrichedPairConfig[] {\n    const assetBySymbol = new Map(assets.map((asset) => [asset.symbol, asset]));\n    const enrichedPairs: EnrichedPairConfig[] = [];\n\n    for (const pair of pairs) {\n        if (isEnrichedPair(pair)) {\n            enrichedPairs.push(pair);\n            continue;\n        }\n\n        const baseAsset = assetBySymbol.get(pair.baseAsset);\n        const quoteAsset = assetBySymbol.get(pair.quoteAsset);\n        if (!baseAsset || !quoteAsset) {\n            throw new Error(\n                `[catalog] market pair ${pair.symbol} references unknown asset: base=${pair.baseAsset}, quote=${pair.quoteAsset}`,\n            );\n        }\n\n        enrichedPairs.push({\n            symbolId: pair.symbolId,\n            symbol: pair.symbol,\n            baseAsset,\n            quoteAsset,\n            tickSize: pair.tickSize,\n            stepSize: pair.stepSize,\n            minNotionalQuote: pair.minNotionalQuote,\n            minQtyBase: pair.minQtyBase,\n            allowBuyFeeFromBase: pair.allowBuyFeeFromBase,\n            defaultMarketSlippagePctBuy: pair.defaultMarketSlippagePctBuy,\n            defaultMarketSlippagePctSell: pair.defaultMarketSlippagePctSell,\n            maxClientRefDriftPct: pair.maxClientRefDriftPct,\n            marketdata: pair.marketdata,\n            listingAt: pair.listingAt ?? null,\n            delistingAt: pair.delistingAt ?? null,\n            status: pair.status,\n        });\n    }\n\n    return enrichedPairs;\n}\n\nexport function buildMarketCatalogData(seed: MarketCatalogSeed): MarketCatalogData {\n    const assets = [...seed.assets];\n    const pairs = enrichMarketPairs(seed.pairs, assets);\n    return Object.freeze({\n        assets: Object.freeze(assets),\n        pairs: Object.freeze([...pairs]),\n        tsSec: seed.tsSec,\n    });\n}\n"],"mappings":";AA+CA,SAAS,eAAe,MAAmE;CACvF,OAAO,OAAO,KAAK,cAAc,YAAY,OAAO,KAAK,eAAe;AAC5E;AAEA,SAAgB,kBACZ,OACA,QAC6B;CAC7B,MAAM,gBAAgB,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC;CAC1E,MAAM,gBAAsC,CAAC;CAE7C,KAAK,MAAM,QAAQ,OAAO;EACtB,IAAI,eAAe,IAAI,GAAG;GACtB,cAAc,KAAK,IAAI;GACvB;EACJ;EAEA,MAAM,YAAY,cAAc,IAAI,KAAK,SAAS;EAClD,MAAM,aAAa,cAAc,IAAI,KAAK,UAAU;EACpD,IAAI,CAAC,aAAa,CAAC,YACf,MAAM,IAAI,MACN,yBAAyB,KAAK,OAAO,kCAAkC,KAAK,UAAU,UAAU,KAAK,YACzG;EAGJ,cAAc,KAAK;GACf,UAAU,KAAK;GACf,QAAQ,KAAK;GACb;GACA;GACA,UAAU,KAAK;GACf,UAAU,KAAK;GACf,kBAAkB,KAAK;GACvB,YAAY,KAAK;GACjB,qBAAqB,KAAK;GAC1B,6BAA6B,KAAK;GAClC,8BAA8B,KAAK;GACnC,sBAAsB,KAAK;GAC3B,YAAY,KAAK;GACjB,WAAW,KAAK,aAAa;GAC7B,aAAa,KAAK,eAAe;GACjC,QAAQ,KAAK;EACjB,CAAC;CACL;CAEA,OAAO;AACX;AAEA,SAAgB,uBAAuB,MAA4C;CAC/E,MAAM,SAAS,CAAC,GAAG,KAAK,MAAM;CAC9B,MAAM,QAAQ,kBAAkB,KAAK,OAAO,MAAM;CAClD,OAAO,OAAO,OAAO;EACjB,QAAQ,OAAO,OAAO,MAAM;EAC5B,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,CAAC;EAC/B,OAAO,KAAK;CAChB,CAAC;AACL"}

package/dist/catalogs/readers.d.ts

@@ -0,0 +1,6 @@
+import { CatalogReader, CatalogSnapshot } from "./types.js";
+//#region src/catalogs/readers.d.ts
+declare function createCatalogSnapshotReader(snapshot: CatalogSnapshot): CatalogReader;
+//#endregion
+export { createCatalogSnapshotReader };
+//# sourceMappingURL=readers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readers.d.ts","names":[],"sources":["../../src/catalogs/readers.ts"],"mappings":";;iBAiwBgB,4BAA4B,UAAU,kBAAkB"}