@polyester/sdk 0.3.1 → 0.4.1

package/dist/catalogs/snapshot-validation.js

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

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

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

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

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

package/dist/catalogs/snapshot.js

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

package/dist/catalogs/snapshot.js.map

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

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

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

package/dist/catalogs/zipper-supply.js

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

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

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

package/dist/core-client.d.ts

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

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

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

package/dist/core-client.js

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

package/dist/core-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"core-client.js","names":["#environment","#authProvider","#realtimeConfig","#configRealtimeClient","#configCatalog","#configCatalogSnapshot","#configCatalogCell","#createAuth","#realtime","#catalog","#getScales","#scales","#resolverInitialized","#resolver","#auth","#accounts","#apiKeys","#getResolver","#subaccounts","#candles","#chainAnalytics","#marketData","#marketOverview","#orderbook","#heatmap","#lifecycle","#trades","#orders","#triggers","#balances","#transfers","#internalTransfers","#tradingWithdraws","#deposit","#addressBook","#guardSigner","#socialVerification","#whiteboard","#zipper","#mfa"],"sources":["../src/core-client.ts"],"sourcesContent":["import type { Interceptor } from \"@connectrpc/connect\";\nimport { ConfigurationError } from \"./shared/errors.js\";\nimport {\n    createApiKeyEd25519AuthHeaders,\n    createTransports,\n    type Transports,\n    type JwtAuthProvider,\n    type ApiKeyEd25519AuthProvider,\n} from \"./shared/transports.js\";\nimport type { PolyesterEnvironment } from \"./environment.js\";\nimport { AccountsService } from \"./services/accounts/index.js\";\nimport { ApiKeysService } from \"./services/api-keys/index.js\";\nimport { AuthService, type AuthServiceTransports } from \"./services/auth/auth.js\";\nimport { SubaccountsService } from \"./services/subaccounts/index.js\";\nimport { CandlesService } from \"./services/candles/index.js\";\nimport { ChainAnalyticsService } from \"./services/chain-analytics/index.js\";\nimport { MarketDataService } from \"./services/market-data/index.js\";\nimport { MarketOverviewService } from \"./services/market-overview/index.js\";\nimport { OrderbookService } from \"./services/orderbook/index.js\";\nimport { HeatmapService } from \"./services/heatmap/index.js\";\nimport { LifecycleService } from \"./services/lifecycle/index.js\";\nimport { TradesService } from \"./services/trades/index.js\";\nimport { OrdersService } from \"./services/orders/index.js\";\nimport { TriggersService } from \"./services/triggers/index.js\";\nimport { BalancesService } from \"./services/balances/index.js\";\nimport { TransfersService } from \"./services/transfers/index.js\";\nimport { InternalTransfersService } from \"./services/internal-transfers/index.js\";\nimport { TradingWithdrawsService } from \"./services/trading-withdraws/index.js\";\nimport { DepositService } from \"./services/deposit/index.js\";\nimport { AddressBookService } from \"./services/address-book/index.js\";\nimport { GuardSignerService } from \"./services/guard-signer/index.js\";\nimport { SocialVerificationService } from \"./services/social-verification/index.js\";\nimport { WhiteboardService } from \"./services/whiteboard/index.js\";\nimport { ZipperService } from \"./services/zipper/index.js\";\nimport { MfaService } from \"./services/mfa/index.js\";\nimport type { SubaccountResolver } from \"./services/subaccount-resolver.js\";\nimport {\n    createPolyesterCatalog,\n    type CatalogSnapshot,\n    type CatalogSnapshotCell,\n    type ClientCatalog,\n} from \"./catalogs/index.js\";\nimport { createCatalogSdkScales, type SdkScales } from \"./shared/decimal-surface.js\";\nimport { RealtimeClient, type PolyesterRealtime, type RealtimeConfig } from \"./realtime/index.js\";\n\nfunction realtimeAuthFromProvider(\n    auth: JwtAuthProvider | ApiKeyEd25519AuthProvider | undefined,\n): Pick<RealtimeConfig, \"getAuthHeaders\" | \"hasAuth\"> {\n    if (!auth) return {};\n    if (auth.kind === \"jwt\") {\n        return {\n            getAuthHeaders: async () => {\n                const token = await auth.getToken();\n                const headers: Record<string, string> = {};\n                if (token) headers.authorization = `Bearer ${token}`;\n                return headers;\n            },\n            hasAuth: () => {\n                // Only token getters that resolve synchronously can be checked here;\n                // async getters are assumed authenticated and fail at token fetch.\n                const token = auth.getToken();\n                if (token instanceof Promise) return true;\n                return typeof token === \"string\" && token.length > 0;\n            },\n        };\n    }\n    return {\n        getAuthHeaders: (request) =>\n            createApiKeyEd25519AuthHeaders(auth, {\n                url: request.url,\n                method: request.method,\n            }),\n        hasAuth: () => true,\n    };\n}\n\nexport type PolyesterRealtimeAuthConfig = Pick<RealtimeConfig, \"getAuthHeaders\" | \"hasAuth\">;\n\nexport interface PolyesterClientBaseConfig {\n    environment: PolyesterEnvironment;\n    interceptors?: Interceptor[];\n    auth?: JwtAuthProvider | ApiKeyEd25519AuthProvider;\n    realtime?: PolyesterRealtimeAuthConfig;\n    /**\n     * Connect wire format. Defaults to binary for production performance.\n     * Use `json` for human-readable debugging.\n     */\n    wireFormat?: \"binary\" | \"json\";\n    /**\n     * Client-owned catalog store. Advanced callers can inject a fully managed catalog instance.\n     */\n    catalog?: ClientCatalog;\n    /**\n     * Explicit initial catalog snapshot, commonly hydrated from server-rendered data.\n     * Combines with `catalogCell` as the cell's initial value (never clobbers a\n     * pre-populated cell).\n     */\n    catalogSnapshot?: CatalogSnapshot;\n    /**\n     * External snapshot storage for the client-built catalog (mutually exclusive with\n     * `catalog`). A cell backed by a reactive source makes every catalog read reactive.\n     */\n    catalogCell?: CatalogSnapshotCell;\n    /**\n     * Advanced: inject pre-built Connect transports (in-memory mocks, custom\n     * stacks). When provided, the SDK does not build its own transports and the\n     * built-in auth/error-mapping interceptors are NOT applied — the injected\n     * transports own their full interceptor chain.\n     */\n    transports?: Transports;\n    /**\n     * Advanced: inject a realtime implementation (in-memory mocks, custom\n     * stacks). When provided, the SDK skips constructing its Centrifuge-backed\n     * realtime client and the `realtime` auth config is ignored.\n     */\n    realtimeClient?: PolyesterRealtime;\n}\n\nexport interface PolyesterClientConfig extends PolyesterClientBaseConfig {}\n\ninterface AuthServiceFactoryContext {\n    transports: AuthServiceTransports;\n    realtime: PolyesterRealtime;\n    subaccounts: SubaccountsService;\n    environment: PolyesterEnvironment;\n}\n\ninterface PolyesterClientRuntimeConfig {\n    createAuth?: (context: AuthServiceFactoryContext) => AuthService;\n}\n\n/**\n * Base SDK client that wires transports, realtime, catalogs, and all public service clients for a Polyester environment.\n *\n * Services are constructed lazily on first property access (and memoized) so\n * that creating a client — which happens for every SSR request in server\n * hooks — only pays for the services the caller actually touches.\n */\nexport class PolyesterClient {\n    protected readonly transports: Transports;\n\n    readonly #environment: PolyesterEnvironment;\n    readonly #authProvider: JwtAuthProvider | ApiKeyEd25519AuthProvider | undefined;\n    readonly #realtimeConfig: PolyesterRealtimeAuthConfig | undefined;\n    readonly #configRealtimeClient: PolyesterRealtime | undefined;\n    readonly #configCatalog: ClientCatalog | undefined;\n    readonly #configCatalogSnapshot: CatalogSnapshot | undefined;\n    readonly #configCatalogCell: CatalogSnapshotCell | undefined;\n    readonly #createAuth: PolyesterClientRuntimeConfig[\"createAuth\"];\n\n    #realtime: PolyesterRealtime | undefined;\n    #catalog: ClientCatalog | undefined;\n    #scales: SdkScales | undefined;\n    #resolver: SubaccountResolver | undefined;\n    #resolverInitialized = false;\n\n    #auth: AuthService | undefined;\n    #accounts: AccountsService | undefined;\n    #apiKeys: ApiKeysService | undefined;\n    #subaccounts: SubaccountsService | undefined;\n    #candles: CandlesService | undefined;\n    #chainAnalytics: ChainAnalyticsService | undefined;\n    #marketData: MarketDataService | undefined;\n    #marketOverview: MarketOverviewService | undefined;\n    #orderbook: OrderbookService | undefined;\n    #heatmap: HeatmapService | undefined;\n    #lifecycle: LifecycleService | undefined;\n    #trades: TradesService | undefined;\n    #orders: OrdersService | undefined;\n    #triggers: TriggersService | undefined;\n    #balances: BalancesService | undefined;\n    #transfers: TransfersService | undefined;\n    #internalTransfers: InternalTransfersService | undefined;\n    #tradingWithdraws: TradingWithdrawsService | undefined;\n    #deposit: DepositService | undefined;\n    #addressBook: AddressBookService | undefined;\n    #guardSigner: GuardSignerService | undefined;\n    #socialVerification: SocialVerificationService | undefined;\n    #whiteboard: WhiteboardService | undefined;\n    #zipper: ZipperService | undefined;\n    #mfa: MfaService | undefined;\n\n    constructor(config: PolyesterClientConfig, runtime: PolyesterClientRuntimeConfig = {}) {\n        const interceptors = config.interceptors ?? [];\n        const { environment } = config;\n        if (config.catalog && config.catalogSnapshot) {\n            throw new ConfigurationError(\"Provide either catalog or catalogSnapshot, not both.\");\n        }\n        if (config.catalog && config.catalogCell) {\n            throw new ConfigurationError(\"Provide either catalog or catalogCell, not both.\");\n        }\n\n        this.transports =\n            config.transports ??\n            createTransports({\n                apiUrl: environment.apiUrl,\n                interceptors,\n                auth: config.auth,\n                wireFormat: config.wireFormat,\n            });\n\n        this.#environment = environment;\n        this.#authProvider = config.auth;\n        this.#realtimeConfig = config.realtime;\n        this.#configRealtimeClient = config.realtimeClient;\n        this.#configCatalog = config.catalog;\n        this.#configCatalogSnapshot = config.catalogSnapshot;\n        this.#configCatalogCell = config.catalogCell;\n        this.#createAuth = runtime.createAuth;\n    }\n\n    get realtime(): PolyesterRealtime {\n        if (!this.#realtime) {\n            if (this.#configRealtimeClient) {\n                this.#realtime = this.#configRealtimeClient;\n            } else {\n                const environment = this.#environment;\n                const realtimeAuth = realtimeAuthFromProvider(this.#authProvider);\n                this.#realtime = new RealtimeClient({\n                    wsUrl: environment.websocketUrl,\n                    tokenEndpoint: `${environment.apiUrl}/v1/rt/token`,\n                    subscribeEndpoint: `${environment.apiUrl}/v1/rt/subscribe`,\n                    getAuthHeaders:\n                        this.#realtimeConfig?.getAuthHeaders ?? realtimeAuth.getAuthHeaders,\n                    hasAuth: this.#realtimeConfig?.hasAuth ?? realtimeAuth.hasAuth,\n                });\n            }\n        }\n        return this.#realtime;\n    }\n\n    get catalog(): ClientCatalog {\n        if (!this.#catalog) {\n            if (this.#configCatalog) {\n                this.#catalog = this.#configCatalog;\n            } else {\n                const catalogRefreshMarketData = new MarketDataService(\n                    this.transports.publicApi,\n                    this.realtime,\n                    this.#getScales(),\n                );\n                const catalogRefreshZipper = new ZipperService(this.transports.publicApi);\n                this.#catalog = createPolyesterCatalog({\n                    snapshot: this.#configCatalogSnapshot,\n                    cell: this.#configCatalogCell,\n                    refresh: {\n                        market: () => catalogRefreshMarketData.getSpotConfig(),\n                        zipper: () => catalogRefreshZipper.getDepositWithdrawConfig(),\n                    },\n                });\n            }\n        }\n        return this.#catalog;\n    }\n\n    #getScales(): SdkScales {\n        // Lazy catalog binding: the resolver only dereferences `this.catalog` at\n        // call time. getSpotConfig() (the catalog's own refresh source) never\n        // awaits scale readiness.\n        this.#scales ??= createCatalogSdkScales(() => this.catalog);\n        return this.#scales;\n    }\n\n    #getResolver(): SubaccountResolver | undefined {\n        if (!this.#resolverInitialized) {\n            this.#resolverInitialized = true;\n            this.#resolver = this.createSubaccountResolver();\n        }\n        return this.#resolver;\n    }\n\n    get auth(): AuthService {\n        if (!this.#auth) {\n            const { authApi, publicApi } = this.transports;\n            this.#auth =\n                this.#createAuth?.({\n                    transports: { publicApi, authApi },\n                    realtime: this.realtime,\n                    subaccounts: this.subaccounts,\n                    environment: this.#environment,\n                }) ?? new AuthService({ publicApi, authApi }, this.realtime);\n        }\n        return this.#auth;\n    }\n\n    get accounts(): AccountsService {\n        return (this.#accounts ??= new AccountsService(this.transports.authApi));\n    }\n\n    get apiKeys(): ApiKeysService {\n        return (this.#apiKeys ??= new ApiKeysService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n        ));\n    }\n\n    get subaccounts(): SubaccountsService {\n        return (this.#subaccounts ??= new SubaccountsService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n        ));\n    }\n\n    get candles(): CandlesService {\n        return (this.#candles ??= new CandlesService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get chainAnalytics(): ChainAnalyticsService {\n        return (this.#chainAnalytics ??= new ChainAnalyticsService(\n            this.transports.publicApi,\n            this.#getScales(),\n        ));\n    }\n\n    get marketData(): MarketDataService {\n        return (this.#marketData ??= new MarketDataService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get marketOverview(): MarketOverviewService {\n        return (this.#marketOverview ??= new MarketOverviewService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get orderbook(): OrderbookService {\n        return (this.#orderbook ??= new OrderbookService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get heatmap(): HeatmapService {\n        return (this.#heatmap ??= new HeatmapService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get lifecycle(): LifecycleService {\n        return (this.#lifecycle ??= new LifecycleService(this.transports.publicApi, this.realtime));\n    }\n\n    get trades(): TradesService {\n        return (this.#trades ??= new TradesService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get orders(): OrdersService {\n        return (this.#orders ??= new OrdersService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get triggers(): TriggersService {\n        return (this.#triggers ??= new TriggersService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get balances(): BalancesService {\n        return (this.#balances ??= new BalancesService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get transfers(): TransfersService {\n        return (this.#transfers ??= new TransfersService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get internalTransfers(): InternalTransfersService {\n        return (this.#internalTransfers ??= new InternalTransfersService(\n            this.transports.authApi,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get tradingWithdraws(): TradingWithdrawsService {\n        return (this.#tradingWithdraws ??= new TradingWithdrawsService(\n            this.transports.authApi,\n            this.#getResolver(),\n            {\n                chainId: this.#environment.chain.id,\n                tradingGatewayAddress: this.#environment.contracts.tradingGatewayAddress,\n            },\n            this.#getScales(),\n            this.catalog,\n        ));\n    }\n\n    get deposit(): DepositService {\n        return (this.#deposit ??= new DepositService(this.transports.authApi, this.#getResolver()));\n    }\n\n    get addressBook(): AddressBookService {\n        return (this.#addressBook ??= new AddressBookService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n        ));\n    }\n\n    get guardSigner(): GuardSignerService {\n        return (this.#guardSigner ??= new GuardSignerService(\n            this.transports.authApi,\n            this.#getResolver(),\n        ));\n    }\n\n    get socialVerification(): SocialVerificationService {\n        return (this.#socialVerification ??= new SocialVerificationService(\n            this.transports.authApi,\n        ));\n    }\n\n    get whiteboard(): WhiteboardService {\n        return (this.#whiteboard ??= new WhiteboardService(this.transports.authApi));\n    }\n\n    get zipper(): ZipperService {\n        return (this.#zipper ??= new ZipperService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get mfa(): MfaService {\n        return (this.#mfa ??= new MfaService(this.transports.authApi));\n    }\n\n    /**\n     * Override in subclasses to provide a subaccount resolver.\n     * The resolver is called lazily when service methods are invoked.\n     */\n    protected createSubaccountResolver(): SubaccountResolver | undefined {\n        return undefined;\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"core-client.js","names":["#environment","#authProvider","#realtimeConfig","#configRealtimeClient","#configCatalog","#configCatalogSnapshot","#configCatalogCell","#createAuth","#realtime","#catalog","#getScales","#scales","#resolverInitialized","#resolver","#auth","#accounts","#apiKeys","#getResolver","#subaccounts","#candles","#chainAnalytics","#marketData","#marketOverview","#orderbook","#heatmap","#lifecycle","#trades","#orders","#triggers","#balances","#transfers","#internalTransfers","#tradingWithdraws","#deposit","#addressBook","#guardSigner","#socialVerification","#whiteboard","#zipper","#mfa"],"sources":["../src/core-client.ts"],"sourcesContent":["import type { Interceptor } from \"@connectrpc/connect\";\nimport { ConfigurationError } from \"./shared/errors.js\";\nimport {\n    createApiKeyEd25519AuthHeaders,\n    createTransports,\n    type Transports,\n    type JwtAuthProvider,\n    type ApiKeyEd25519AuthProvider,\n} from \"./shared/transports.js\";\nimport { parsePolyesterEnvironment, type PolyesterEnvironment } from \"./environment.js\";\nimport { AccountsService } from \"./services/accounts/index.js\";\nimport { ApiKeysService } from \"./services/api-keys/index.js\";\nimport { AuthService, type AuthServiceTransports } from \"./services/auth/auth.js\";\nimport { SubaccountsService } from \"./services/subaccounts/index.js\";\nimport { CandlesService } from \"./services/candles/index.js\";\nimport { ChainAnalyticsService } from \"./services/chain-analytics/index.js\";\nimport { MarketDataService } from \"./services/market-data/index.js\";\nimport { MarketOverviewService } from \"./services/market-overview/index.js\";\nimport { OrderbookService } from \"./services/orderbook/index.js\";\nimport { HeatmapService } from \"./services/heatmap/index.js\";\nimport { LifecycleService } from \"./services/lifecycle/index.js\";\nimport { TradesService } from \"./services/trades/index.js\";\nimport { OrdersService } from \"./services/orders/index.js\";\nimport { TriggersService } from \"./services/triggers/index.js\";\nimport { BalancesService } from \"./services/balances/index.js\";\nimport { TransfersService } from \"./services/transfers/index.js\";\nimport { InternalTransfersService } from \"./services/internal-transfers/index.js\";\nimport { TradingWithdrawsService } from \"./services/trading-withdraws/index.js\";\nimport { DepositService } from \"./services/deposit/index.js\";\nimport { AddressBookService } from \"./services/address-book/index.js\";\nimport { GuardSignerService } from \"./services/guard-signer/index.js\";\nimport { SocialVerificationService } from \"./services/social-verification/index.js\";\nimport { WhiteboardService } from \"./services/whiteboard/index.js\";\nimport { ZipperService } from \"./services/zipper/index.js\";\nimport { MfaService } from \"./services/mfa/index.js\";\nimport type { SubaccountResolver } from \"./services/subaccount-resolver.js\";\nimport {\n    createPolyesterCatalog,\n    type CatalogSnapshot,\n    type CatalogSnapshotCell,\n    type ClientCatalog,\n} from \"./catalogs/index.js\";\nimport { createCatalogSdkScales, type SdkScales } from \"./shared/decimal-surface.js\";\nimport { RealtimeClient, type PolyesterRealtime, type RealtimeConfig } from \"./realtime/index.js\";\n\nfunction realtimeAuthFromProvider(\n    auth: JwtAuthProvider | ApiKeyEd25519AuthProvider | undefined,\n): Pick<RealtimeConfig, \"getAuthHeaders\" | \"hasAuth\"> {\n    if (!auth) return {};\n    if (auth.kind === \"jwt\") {\n        return {\n            getAuthHeaders: async () => {\n                const token = await auth.getToken();\n                const headers: Record<string, string> = {};\n                if (token) headers.authorization = `Bearer ${token}`;\n                return headers;\n            },\n            hasAuth: () => {\n                // Only token getters that resolve synchronously can be checked here;\n                // async getters are assumed authenticated and fail at token fetch.\n                const token = auth.getToken();\n                if (token instanceof Promise) return true;\n                return typeof token === \"string\" && token.length > 0;\n            },\n        };\n    }\n    return {\n        getAuthHeaders: (request) =>\n            createApiKeyEd25519AuthHeaders(auth, {\n                url: request.url,\n                method: request.method,\n            }),\n        hasAuth: () => true,\n    };\n}\n\nexport type PolyesterRealtimeAuthConfig = Pick<RealtimeConfig, \"getAuthHeaders\" | \"hasAuth\">;\n\ninterface PolyesterClientCommonConfig {\n    environment: PolyesterEnvironment;\n    interceptors?: Interceptor[];\n    auth?: JwtAuthProvider | ApiKeyEd25519AuthProvider;\n    realtime?: PolyesterRealtimeAuthConfig;\n    /**\n     * Connect wire format. Defaults to binary for production performance.\n     * Use `json` for human-readable debugging.\n     */\n    wireFormat?: \"binary\" | \"json\";\n    /**\n     * Advanced: inject pre-built Connect transports (in-memory mocks, custom\n     * stacks). When provided, the SDK does not build its own transports and the\n     * built-in auth/error-mapping interceptors are NOT applied — the injected\n     * transports own their full interceptor chain.\n     */\n    transports?: Transports;\n    /**\n     * Advanced: inject a realtime implementation (in-memory mocks, custom\n     * stacks). When provided, the SDK skips constructing its Centrifuge-backed\n     * realtime client and the `realtime` auth config is ignored.\n     */\n    realtimeClient?: PolyesterRealtime;\n}\n\ntype PolyesterCatalogConfig =\n    | {\n          /** Client-owned catalog store. */\n          catalog: ClientCatalog;\n          catalogSnapshot?: never;\n          catalogCell?: never;\n      }\n    | {\n          catalog?: never;\n          /**\n           * Explicit initial catalog snapshot, commonly hydrated from server-rendered data.\n           * Combines with `catalogCell` as the cell's initial value without clobbering a\n           * pre-populated cell.\n           */\n          catalogSnapshot?: CatalogSnapshot;\n          /**\n           * External snapshot storage for the client-built catalog. A cell backed by a\n           * reactive source makes every catalog read reactive.\n           */\n          catalogCell?: CatalogSnapshotCell;\n      };\n\n/** Configuration shared by every Polyester client. */\nexport type PolyesterClientBaseConfig = PolyesterClientCommonConfig & PolyesterCatalogConfig;\n\n/** Configuration for the base Polyester client. */\nexport type PolyesterClientConfig = PolyesterClientBaseConfig;\n\n/** Preserves the exclusive catalog configuration while projecting client config fields. */\nexport function pickPolyesterCatalogConfig(\n    config: PolyesterClientBaseConfig,\n): PolyesterCatalogConfig {\n    return config.catalog === undefined\n        ? {\n              catalogSnapshot: config.catalogSnapshot,\n              catalogCell: config.catalogCell,\n          }\n        : { catalog: config.catalog };\n}\n\ninterface AuthServiceFactoryContext {\n    transports: AuthServiceTransports;\n    realtime: PolyesterRealtime;\n    subaccounts: SubaccountsService;\n    environment: PolyesterEnvironment;\n}\n\ninterface PolyesterClientRuntimeConfig {\n    createAuth?: (context: AuthServiceFactoryContext) => AuthService;\n}\n\n/**\n * Parses the configuration shared by every public client constructor.\n */\nexport function parsePolyesterClientConfig<TConfig extends PolyesterClientBaseConfig>(\n    config: TConfig,\n): TConfig {\n    if (typeof config !== \"object\" || config === null || Array.isArray(config)) {\n        throw new ConfigurationError(\"Client configuration must be an object.\");\n    }\n    const environment = parsePolyesterEnvironment(config.environment);\n    if (\n        config.wireFormat !== undefined &&\n        config.wireFormat !== \"binary\" &&\n        config.wireFormat !== \"json\"\n    ) {\n        throw new ConfigurationError('wireFormat must be either \"binary\" or \"json\".');\n    }\n    if (config.catalog && config.catalogSnapshot) {\n        throw new ConfigurationError(\"Provide either catalog or catalogSnapshot, not both.\");\n    }\n    if (config.catalog && config.catalogCell) {\n        throw new ConfigurationError(\"Provide either catalog or catalogCell, not both.\");\n    }\n\n    return Object.assign({}, config, { environment });\n}\n\n/**\n * Base SDK client that wires transports, realtime, catalogs, and all public service clients for a Polyester environment.\n *\n * Services are constructed lazily on first property access (and memoized) so\n * that creating a client — which happens for every SSR request in server\n * hooks — only pays for the services the caller actually touches.\n */\nexport class PolyesterClient {\n    protected readonly transports: Transports;\n\n    readonly #environment: PolyesterEnvironment;\n    readonly #authProvider: JwtAuthProvider | ApiKeyEd25519AuthProvider | undefined;\n    readonly #realtimeConfig: PolyesterRealtimeAuthConfig | undefined;\n    readonly #configRealtimeClient: PolyesterRealtime | undefined;\n    readonly #configCatalog: ClientCatalog | undefined;\n    readonly #configCatalogSnapshot: CatalogSnapshot | undefined;\n    readonly #configCatalogCell: CatalogSnapshotCell | undefined;\n    readonly #createAuth: PolyesterClientRuntimeConfig[\"createAuth\"];\n\n    #realtime: PolyesterRealtime | undefined;\n    #catalog: ClientCatalog | undefined;\n    #scales: SdkScales | undefined;\n    #resolver: SubaccountResolver | undefined;\n    #resolverInitialized = false;\n\n    #auth: AuthService | undefined;\n    #accounts: AccountsService | undefined;\n    #apiKeys: ApiKeysService | undefined;\n    #subaccounts: SubaccountsService | undefined;\n    #candles: CandlesService | undefined;\n    #chainAnalytics: ChainAnalyticsService | undefined;\n    #marketData: MarketDataService | undefined;\n    #marketOverview: MarketOverviewService | undefined;\n    #orderbook: OrderbookService | undefined;\n    #heatmap: HeatmapService | undefined;\n    #lifecycle: LifecycleService | undefined;\n    #trades: TradesService | undefined;\n    #orders: OrdersService | undefined;\n    #triggers: TriggersService | undefined;\n    #balances: BalancesService | undefined;\n    #transfers: TransfersService | undefined;\n    #internalTransfers: InternalTransfersService | undefined;\n    #tradingWithdraws: TradingWithdrawsService | undefined;\n    #deposit: DepositService | undefined;\n    #addressBook: AddressBookService | undefined;\n    #guardSigner: GuardSignerService | undefined;\n    #socialVerification: SocialVerificationService | undefined;\n    #whiteboard: WhiteboardService | undefined;\n    #zipper: ZipperService | undefined;\n    #mfa: MfaService | undefined;\n\n    constructor(config: PolyesterClientConfig, runtime: PolyesterClientRuntimeConfig = {}) {\n        const parsedConfig = parsePolyesterClientConfig(config);\n        config = parsedConfig;\n        const interceptors = config.interceptors ?? [];\n        const { environment } = config;\n\n        this.transports =\n            config.transports ??\n            createTransports({\n                apiUrl: environment.apiUrl,\n                interceptors,\n                auth: config.auth,\n                wireFormat: config.wireFormat,\n            });\n\n        this.#environment = environment;\n        this.#authProvider = config.auth;\n        this.#realtimeConfig = config.realtime;\n        this.#configRealtimeClient = config.realtimeClient;\n        this.#configCatalog = config.catalog;\n        this.#configCatalogSnapshot = config.catalogSnapshot;\n        this.#configCatalogCell = config.catalogCell;\n        this.#createAuth = runtime.createAuth;\n    }\n\n    get realtime(): PolyesterRealtime {\n        if (!this.#realtime) {\n            if (this.#configRealtimeClient) {\n                this.#realtime = this.#configRealtimeClient;\n            } else {\n                const environment = this.#environment;\n                const realtimeAuth = realtimeAuthFromProvider(this.#authProvider);\n                this.#realtime = new RealtimeClient({\n                    wsUrl: environment.websocketUrl,\n                    tokenEndpoint: `${environment.apiUrl}/v1/rt/token`,\n                    subscribeEndpoint: `${environment.apiUrl}/v1/rt/subscribe`,\n                    getAuthHeaders:\n                        this.#realtimeConfig?.getAuthHeaders ?? realtimeAuth.getAuthHeaders,\n                    hasAuth: this.#realtimeConfig?.hasAuth ?? realtimeAuth.hasAuth,\n                });\n            }\n        }\n        return this.#realtime;\n    }\n\n    get catalog(): ClientCatalog {\n        if (!this.#catalog) {\n            if (this.#configCatalog) {\n                this.#catalog = this.#configCatalog;\n            } else {\n                const catalogRefreshMarketData = new MarketDataService(\n                    this.transports.publicApi,\n                    this.realtime,\n                    this.#getScales(),\n                );\n                const catalogRefreshZipper = new ZipperService(this.transports.publicApi);\n                this.#catalog = createPolyesterCatalog({\n                    snapshot: this.#configCatalogSnapshot,\n                    cell: this.#configCatalogCell,\n                    refresh: {\n                        market: () => catalogRefreshMarketData.getSpotConfig(),\n                        zipper: () => catalogRefreshZipper.getDepositWithdrawConfig(),\n                    },\n                });\n            }\n        }\n        return this.#catalog;\n    }\n\n    #getScales(): SdkScales {\n        // Lazy catalog binding: the resolver only dereferences `this.catalog` at\n        // call time. getSpotConfig() (the catalog's own refresh source) never\n        // awaits scale readiness.\n        this.#scales ??= createCatalogSdkScales(() => this.catalog);\n        return this.#scales;\n    }\n\n    #getResolver(): SubaccountResolver | undefined {\n        if (!this.#resolverInitialized) {\n            this.#resolverInitialized = true;\n            this.#resolver = this.createSubaccountResolver();\n        }\n        return this.#resolver;\n    }\n\n    get auth(): AuthService {\n        if (!this.#auth) {\n            const { authApi, publicApi } = this.transports;\n            this.#auth =\n                this.#createAuth?.({\n                    transports: { publicApi, authApi },\n                    realtime: this.realtime,\n                    subaccounts: this.subaccounts,\n                    environment: this.#environment,\n                }) ?? new AuthService({ publicApi, authApi }, this.realtime);\n        }\n        return this.#auth;\n    }\n\n    get accounts(): AccountsService {\n        return (this.#accounts ??= new AccountsService(this.transports.authApi));\n    }\n\n    get apiKeys(): ApiKeysService {\n        return (this.#apiKeys ??= new ApiKeysService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n        ));\n    }\n\n    get subaccounts(): SubaccountsService {\n        return (this.#subaccounts ??= new SubaccountsService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n        ));\n    }\n\n    get candles(): CandlesService {\n        return (this.#candles ??= new CandlesService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get chainAnalytics(): ChainAnalyticsService {\n        return (this.#chainAnalytics ??= new ChainAnalyticsService(\n            this.transports.publicApi,\n            this.#getScales(),\n        ));\n    }\n\n    get marketData(): MarketDataService {\n        return (this.#marketData ??= new MarketDataService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get marketOverview(): MarketOverviewService {\n        return (this.#marketOverview ??= new MarketOverviewService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get orderbook(): OrderbookService {\n        return (this.#orderbook ??= new OrderbookService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get heatmap(): HeatmapService {\n        return (this.#heatmap ??= new HeatmapService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get lifecycle(): LifecycleService {\n        return (this.#lifecycle ??= new LifecycleService(this.transports.publicApi, this.realtime));\n    }\n\n    get trades(): TradesService {\n        return (this.#trades ??= new TradesService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get orders(): OrdersService {\n        return (this.#orders ??= new OrdersService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get triggers(): TriggersService {\n        return (this.#triggers ??= new TriggersService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get balances(): BalancesService {\n        return (this.#balances ??= new BalancesService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get transfers(): TransfersService {\n        return (this.#transfers ??= new TransfersService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get internalTransfers(): InternalTransfersService {\n        return (this.#internalTransfers ??= new InternalTransfersService(\n            this.transports.authApi,\n            this.#getResolver(),\n            this.#getScales(),\n        ));\n    }\n\n    get tradingWithdraws(): TradingWithdrawsService {\n        return (this.#tradingWithdraws ??= new TradingWithdrawsService(\n            this.transports.authApi,\n            this.#getResolver(),\n            {\n                chainId: this.#environment.chain.id,\n                tradingGatewayAddress: this.#environment.contracts.tradingGatewayAddress,\n            },\n            this.#getScales(),\n            this.catalog,\n        ));\n    }\n\n    get deposit(): DepositService {\n        return (this.#deposit ??= new DepositService(this.transports.authApi, this.#getResolver()));\n    }\n\n    get addressBook(): AddressBookService {\n        return (this.#addressBook ??= new AddressBookService(\n            this.transports.authApi,\n            this.realtime,\n            this.#getResolver(),\n        ));\n    }\n\n    get guardSigner(): GuardSignerService {\n        return (this.#guardSigner ??= new GuardSignerService(\n            this.transports.authApi,\n            this.#getResolver(),\n        ));\n    }\n\n    get socialVerification(): SocialVerificationService {\n        return (this.#socialVerification ??= new SocialVerificationService(\n            this.transports.authApi,\n        ));\n    }\n\n    get whiteboard(): WhiteboardService {\n        return (this.#whiteboard ??= new WhiteboardService(this.transports.authApi));\n    }\n\n    get zipper(): ZipperService {\n        return (this.#zipper ??= new ZipperService(\n            this.transports.publicApi,\n            this.realtime,\n            this.#getScales(),\n        ));\n    }\n\n    get mfa(): MfaService {\n        return (this.#mfa ??= new MfaService(this.transports.authApi));\n    }\n\n    /**\n     * Override in subclasses to provide a subaccount resolver.\n     * The resolver is called lazily when service methods are invoked.\n     */\n    protected createSubaccountResolver(): SubaccountResolver | undefined {\n        return undefined;\n    }\n}\n"],"mappings":"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"}

package/dist/environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","names":[],"sources":["../src/environment.ts"],"mappings":";;;UAKiB;WACJ,SAAS;WACT;;UAGI;WACJ,SAAS;WACT,wBAAwB;WACxB,uBAAuB;WACvB,yBAAyB;WACzB,sBAAsB;WACtB,kBAAkB;WAClB,2BAA2B;;UAGvB;WACJ;WACA;WACA,YAAY;WACZ,MAAM;;UAGF;WACJ,uBAAuB;;UAGnB;WACJ;WACA;WACA;WACA;WACA;WACA,OAAO;WACP,oBAAoB;WACpB,WAAW;;UAGP;WACJ;WACA;WACA;WACA;WACA,OAAO;WACP;aACI;aACA;aACA,YAAY;aACZ,MAAM;;WAEV,WAAW;;;;;iBAiIR,2BACZ,QAAQ,mCACT;cA8CU,+BAA6B"}
+{"version":3,"file":"environment.d.ts","names":[],"sources":["../src/environment.ts"],"mappings":";;;UAKiB;WACJ,SAAS;WACT;;UAGI;WACJ,SAAS;WACT,wBAAwB;WACxB,uBAAuB;WACvB,yBAAyB;WACzB,sBAAsB;WACtB,kBAAkB;WAClB,2BAA2B;;UAGvB;WACJ;WACA;WACA,YAAY;WACZ,MAAM;;UAGF;WACJ,uBAAuB;;UAGnB;WACJ;WACA;WACA;WACA;WACA;WACA,OAAO;WACP,oBAAoB;WACpB,WAAW;;UAGP;WACJ;WACA;WACA;WACA;WACA,OAAO;WACP;aACI;aACA;aACA,YAAY;aACZ,MAAM;;WAEV,WAAW;;;;;iBAmKR,2BACZ,QAAQ,mCACT;cAgEU,+BAA6B"}

package/dist/environment.js

@@ -7,6 +7,12 @@ const LOCAL_HOSTS = /* @__PURE__ */ new Set([
 	"::1",
 	"[::1]"
 ]);
+function requireObject(value, label) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new ConfigurationError(`${label} must be an object.`);
+}
+function requireNonEmptyString(value, label) {
+	if (typeof value !== "string" || value.trim().length === 0) throw new ConfigurationError(`${label} must be a non-empty string.`);
+}
 function isLocalHost(hostname) {
 	return LOCAL_HOSTS.has(hostname);
 }
@@ -27,6 +33,7 @@ function normalizeAddress(value, label) {
 	return checksumEvmAddress(value);
 }
 function normalizeEntryPoint(entryPoint) {
+	requireObject(entryPoint, "accountAbstraction.entryPoint");
 	if (entryPoint.version !== "0.7") throw new ConfigurationError("accountAbstraction.entryPoint.version must be 0.7.");
 	return Object.freeze({
 		address: normalizeAddress(entryPoint.address, "accountAbstraction.entryPoint.address"),
@@ -34,6 +41,8 @@ function normalizeEntryPoint(entryPoint) {
 	});
 }
 function normalizeSafeConfig(safe) {
+	requireObject(safe, "accountAbstraction.safe");
+	if (safe.version !== "1.4.1" && safe.version !== "1.5.0") throw new ConfigurationError("accountAbstraction.safe.version must be either \"1.4.1\" or \"1.5.0\".");
 	return Object.freeze({
 		version: safe.version,
 		safeModuleSetupAddress: normalizeAddress(safe.safeModuleSetupAddress, "accountAbstraction.safe.safeModuleSetupAddress"),
@@ -45,7 +54,16 @@ function normalizeSafeConfig(safe) {
 	});
 }
 function normalizeChain(chain, rpcUrl) {
+	requireObject(chain, "chain");
 	if (!Number.isInteger(chain.id) || chain.id <= 0) throw new ConfigurationError("chain.id must be a positive integer.");
+	requireNonEmptyString(chain.name, "chain.name");
+	requireObject(chain.nativeCurrency, "chain.nativeCurrency");
+	if (!Number.isInteger(chain.nativeCurrency.decimals) || chain.nativeCurrency.decimals < 0) throw new ConfigurationError("chain.nativeCurrency.decimals must be a non-negative integer.");
+	requireNonEmptyString(chain.nativeCurrency.name, "chain.nativeCurrency.name");
+	requireNonEmptyString(chain.nativeCurrency.symbol, "chain.nativeCurrency.symbol");
+	requireObject(chain.rpcUrls, "chain.rpcUrls");
+	requireObject(chain.rpcUrls.default, "chain.rpcUrls.default");
+	if (!Array.isArray(chain.rpcUrls.default.http)) throw new ConfigurationError("chain.rpcUrls.default.http must be an array.");
 	return Object.freeze({
 		formatters: void 0,
 		fees: void 0,
@@ -77,6 +95,10 @@ function environmentFingerprint(input) {
 * Creates a complete SDK environment configuration from entrypoint and contract settings.
 */
 function createPolyesterEnvironment(params) {
+	requireObject(params, "Environment configuration");
+	requireNonEmptyString(params.name, "name");
+	requireObject(params.accountAbstraction, "accountAbstraction");
+	requireObject(params.contracts, "contracts");
 	const apiUrl = normalizeUrl(params.apiUrl, "apiUrl", ["https:", "http:"]);
 	const websocketUrl = normalizeUrl(params.websocketUrl, "websocketUrl", ["wss:", "ws:"]);
 	const rpcUrl = normalizeUrl(params.rpcUrl, "rpcUrl", ["https:", "http:"]);
@@ -109,6 +131,15 @@ function createPolyesterEnvironment(params) {
 		contracts
 	});
 }
+/**
+* Parses a complete environment supplied to a public SDK client constructor.
+*/
+function parsePolyesterEnvironment(environment) {
+	requireObject(environment, "environment");
+	const parsed = createPolyesterEnvironment(environment);
+	if (environment.fingerprint !== parsed.fingerprint) throw new ConfigurationError("environment.fingerprint must match the environment configuration.");
+	return parsed;
+}
 const POLYESTER_TESTNET_ENVIRONMENT = createPolyesterEnvironment({
 	name: "polyester-testnet",
 	apiUrl: "https://api-devnet.polyester.ai",
@@ -148,6 +179,6 @@ const POLYESTER_TESTNET_ENVIRONMENT = createPolyesterEnvironment({
 	contracts: { tradingGatewayAddress: "0xD3fecf5D39131e23b6B0f872cA0a21c8A5a30932" }
 });
 //#endregion
-export { POLYESTER_TESTNET_ENVIRONMENT, createPolyesterEnvironment };
+export { POLYESTER_TESTNET_ENVIRONMENT, createPolyesterEnvironment, parsePolyesterEnvironment };
 
 //# sourceMappingURL=environment.js.map