@parity/product-sdk-chain-client 0.4.1 → 0.5.0

package/dist/index.d.ts

@@ -2,11 +2,8 @@ import { ChainDefinition, TypedApi, PolkadotClient } from 'polkadot-api';
 import { polkadot_asset_hub } from '@parity/product-sdk-descriptors/polkadot-asset-hub';
 import { kusama_asset_hub } from '@parity/product-sdk-descriptors/kusama-asset-hub';
 import { paseo_asset_hub } from '@parity/product-sdk-descriptors/paseo-asset-hub';
-import { previewnet_asset_hub } from '@parity/product-sdk-descriptors/previewnet-asset-hub';
 import { paseo_bulletin } from '@parity/product-sdk-descriptors/paseo-bulletin';
-import { previewnet_bulletin } from '@parity/product-sdk-descriptors/previewnet-bulletin';
 import { paseo_individuality } from '@parity/product-sdk-descriptors/paseo-individuality';
-import { previewnet_individuality } from '@parity/product-sdk-descriptors/previewnet-individuality';
 export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
 
 /**
@@ -142,7 +139,7 @@ declare function getClient(descriptor: ChainDefinition): PolkadotClient;
 declare function isConnected(descriptor: ChainDefinition): boolean;
 
 /** Known network environment with built-in descriptors and RPC endpoints. */
-type Environment = "polkadot" | "kusama" | "paseo" | "previewnet";
+type Environment = "polkadot" | "kusama" | "paseo";
 /** Per-environment descriptor types for each chain in the preset. */
 type PresetDescriptors = {
     polkadot: {
@@ -160,11 +157,6 @@ type PresetDescriptors = {
         bulletin: typeof paseo_bulletin;
         individuality: typeof paseo_individuality;
     };
-    previewnet: {
-        assetHub: typeof previewnet_asset_hub;
-        bulletin: typeof previewnet_bulletin;
-        individuality: typeof previewnet_individuality;
-    };
 };
 /** The chain shape returned by {@link getChainAPI} for a given environment. */
 type PresetChains<E extends Environment> = PresetDescriptors[E];
@@ -198,4 +190,23 @@ type PresetChains<E extends Environment> = PresetDescriptors[E];
  */
 declare function getChainAPI<E extends Environment>(env: E): Promise<ChainClient<PresetChains<E>>>;
 
-export { type ChainClient, type ChainClientConfig, type ChainEntry, type Environment, type PresetChains, createChainClient, destroyAll, getChainAPI, getClient, isConnected };
+/**
+ * Genesis hashes of well-known chains.
+ *
+ * Mirrors `WellKnownChain` from `@novasamatech/host-api-wrapper`. Hand-copied
+ * (not re-exported) so chain-client doesn't pick up a direct Novasama
+ * runtime dependency; genesis hashes are immutable so drift is impossible.
+ */
+declare const WellKnownChain: {
+    readonly polkadotRelay: "0x91b171bb158e2d3848fa23a9f1c25182fb8e20313b2c1eb49219da7a70ce90c3";
+    readonly polkadotAssetHub: "0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f";
+    readonly kusamaRelay: "0xb0a8d493285c2df73290dfb7e61f870f17b41801197a149ca93654499ea3dafe";
+    readonly kusamaAssetHub: "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a";
+    readonly westendRelay: "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e";
+    readonly westendAssetHub: "0x67f9723393ef76214df0118c34bbbd3dbebc8ed46a10973a8c969d48fe7598c9";
+    readonly rococo: "0x6408de7737c59c238890533af25896a2c20608d8b380bb01029acb392781063e";
+};
+/** Genesis hash of a well-known chain - the value type of {@link WellKnownChain}. */
+type WellKnownChainHash = (typeof WellKnownChain)[keyof typeof WellKnownChain];
+
+export { type ChainClient, type ChainClientConfig, type ChainEntry, type Environment, type PresetChains, WellKnownChain, type WellKnownChainHash, createChainClient, destroyAll, getChainAPI, getClient, isConnected };

package/dist/index.js

@@ -128,7 +128,7 @@ function isConnected(descriptor) {
   if (!genesis) return false;
   return findEntryByGenesis(genesis) !== void 0;
 }
-var AVAILABLE_ENVIRONMENTS = /* @__PURE__ */ new Set(["paseo", "previewnet"]);
+var AVAILABLE_ENVIRONMENTS = /* @__PURE__ */ new Set(["paseo"]);
 var rpcs = {
   polkadot: {
     assetHub: [
@@ -150,11 +150,6 @@ var rpcs = {
     assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
     bulletin: [...BULLETIN_RPCS.paseo],
     individuality: ["wss://paseo-people-next-system-rpc.polkadot.io"]
-  },
-  previewnet: {
-    assetHub: ["wss://previewnet.substrate.dev/asset-hub"],
-    bulletin: [...BULLETIN_RPCS.previewnet],
-    individuality: ["wss://previewnet.substrate.dev/people"]
   }
 };
 async function loadDescriptors(env) {
@@ -175,17 +170,12 @@ async function loadDescriptors(env) {
       import('@parity/product-sdk-descriptors/paseo-asset-hub'),
       import('@parity/product-sdk-descriptors/paseo-bulletin'),
       import('@parity/product-sdk-descriptors/paseo-individuality')
-    ]),
-    previewnet: () => Promise.all([
-      import('@parity/product-sdk-descriptors/previewnet-asset-hub'),
-      import('@parity/product-sdk-descriptors/previewnet-bulletin'),
-      import('@parity/product-sdk-descriptors/previewnet-individuality')
     ])
   };
   const [ahMod, bulletinMod, individualityMod] = await loaders[env]();
-  const assetHub = "polkadot_asset_hub" in ahMod ? ahMod.polkadot_asset_hub : "kusama_asset_hub" in ahMod ? ahMod.kusama_asset_hub : "paseo_asset_hub" in ahMod ? ahMod.paseo_asset_hub : ahMod.previewnet_asset_hub;
-  const bulletin = "paseo_bulletin" in bulletinMod ? bulletinMod.paseo_bulletin : bulletinMod.previewnet_bulletin;
-  const individuality = "paseo_individuality" in individualityMod ? individualityMod.paseo_individuality : individualityMod.previewnet_individuality;
+  const assetHub = "polkadot_asset_hub" in ahMod ? ahMod.polkadot_asset_hub : "kusama_asset_hub" in ahMod ? ahMod.kusama_asset_hub : ahMod.paseo_asset_hub;
+  const bulletin = bulletinMod.paseo_bulletin;
+  const individuality = individualityMod.paseo_individuality;
   return { assetHub, bulletin, individuality };
 }
 async function getChainAPI(env) {
@@ -208,6 +198,17 @@ async function getChainAPI(env) {
   });
 }
 
-export { createChainClient, destroyAll, getChainAPI, getClient, isConnected };
+// src/well-known-chain.ts
+var WellKnownChain = {
+  polkadotRelay: "0x91b171bb158e2d3848fa23a9f1c25182fb8e20313b2c1eb49219da7a70ce90c3",
+  polkadotAssetHub: "0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f",
+  kusamaRelay: "0xb0a8d493285c2df73290dfb7e61f870f17b41801197a149ca93654499ea3dafe",
+  kusamaAssetHub: "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a",
+  westendRelay: "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
+  westendAssetHub: "0x67f9723393ef76214df0118c34bbbd3dbebc8ed46a10973a8c969d48fe7598c9",
+  rococo: "0x6408de7737c59c238890533af25896a2c20608d8b380bb01029acb392781063e"
+};
+
+export { WellKnownChain, createChainClient, destroyAll, getChainAPI, getClient, isConnected };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/providers.ts","../src/hmr.ts","../src/clients.ts","../src/presets.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { getHostProvider } from \"@parity/product-sdk-host\";\nimport type { JsonRpcProvider } from \"polkadot-api\";\n\n/**\n * Create a PAPI-compatible JSON-RPC provider for a chain.\n *\n * Routes connections through the host provider (`@parity/product-sdk-host`).\n * The SDK is designed to run exclusively inside a host container.\n *\n * @throws {Error} If the host provider is unavailable (not inside a container).\n */\nexport async function createProvider(genesisHash: string): Promise<JsonRpcProvider> {\n    const hostProvider = await getHostProvider(genesisHash as `0x${string}`);\n    if (!hostProvider) {\n        throw new Error(\n            `Host provider unavailable for chain ${genesisHash}. Ensure you are running inside a host container (Polkadot Browser / Desktop).`,\n        );\n    }\n    return hostProvider;\n}\n\nif (import.meta.vitest) {\n    const { test, expect, vi, beforeEach } = import.meta.vitest;\n\n    // Shared state between hoisted mocks and tests\n    const state = vi.hoisted(() => ({\n        fakeProvider: (() => {}) as unknown as JsonRpcProvider,\n        hostProviderCalls: [] as unknown[][],\n        hostProviderAvailable: true,\n    }));\n\n    vi.mock(\"@parity/product-sdk-host\", async (importOriginal) => ({\n        ...(await importOriginal<typeof import(\"@parity/product-sdk-host\")>()),\n        getHostProvider: async (...args: unknown[]) => {\n            state.hostProviderCalls.push(args);\n            if (!state.hostProviderAvailable) return null;\n            return state.fakeProvider;\n        },\n    }));\n\n    beforeEach(() => {\n        state.hostProviderCalls = [];\n        state.hostProviderAvailable = true;\n    });\n\n    test(\"returns host provider when available\", async () => {\n        const result = await createProvider(\"0xabc\");\n        expect(result).toBe(state.fakeProvider);\n        expect(state.hostProviderCalls.length).toBe(1);\n        expect(state.hostProviderCalls[0][0]).toBe(\"0xabc\");\n    });\n\n    test(\"throws when host provider unavailable\", async () => {\n        state.hostProviderAvailable = false;\n        await expect(createProvider(\"0xabc\")).rejects.toThrow(/Host provider unavailable/);\n    });\n}\n","import type { ChainEntry } from \"./types.js\";\n\ndeclare global {\n    var __chainClientCache: Map<string, ChainEntry> | undefined;\n}\n\n/** Get the HMR-safe client cache, keyed by genesis hash. */\nexport function getClientCache(): Map<string, ChainEntry> {\n    globalThis.__chainClientCache ??= new Map();\n    return globalThis.__chainClientCache;\n}\n\n/** Clear all entries from the client cache. Destroys active clients. */\nexport function clearClientCache(): void {\n    const cache = getClientCache();\n    for (const entry of cache.values()) {\n        try {\n            entry.client.destroy();\n        } catch {\n            // client may already be destroyed\n        }\n    }\n    cache.clear();\n}\n\nif (import.meta.vitest) {\n    const { test, expect } = import.meta.vitest;\n\n    test(\"getClientCache returns a Map\", () => {\n        const cache = getClientCache();\n        expect(cache).toBeInstanceOf(Map);\n    });\n\n    test(\"getClientCache returns the same instance on repeated calls\", () => {\n        const a = getClientCache();\n        const b = getClientCache();\n        expect(a).toBe(b);\n    });\n}\n","import type { ChainDefinition, PolkadotClient } from \"polkadot-api\";\nimport { createClient } from \"polkadot-api\";\nimport { createProvider } from \"./providers.js\";\nimport { getClientCache, clearClientCache } from \"./hmr.js\";\nimport type { ChainEntry, ChainClientConfig, ChainClient } from \"./types.js\";\n\n// Cache keys are scoped by a fingerprint of the config so that two\n// `createChainClient` calls with different chain sets don't collide.\nconst cacheKey = (fingerprint: string, genesis: string) => `${fingerprint}:${genesis}`;\n\nfunction findEntryByGenesis(genesis: string): ChainEntry | undefined {\n    for (const [key, entry] of getClientCache()) {\n        if (key.endsWith(`:${genesis}`)) return entry;\n    }\n}\n\nconst clientInstances = new Map<string, Promise<ChainClient<any>>>();\n\n/** Build a stable fingerprint from sorted chain names + genesis hashes. */\nfunction configFingerprint(chains: Record<string, ChainDefinition>): string {\n    return Object.entries(chains)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([name, desc]) => `${name}:${desc.genesis ?? \"unknown\"}`)\n        .join(\"|\");\n}\n\n/**\n * Create a multi-chain client with user-provided descriptors and RPC endpoints.\n *\n * Returns fully-typed APIs for each chain plus raw `PolkadotClient` access via `.raw`.\n * Connections route through the host provider (`@parity/product-sdk-host`) — the SDK\n * is designed to run exclusively inside a host container (Polkadot Browser / Desktop).\n * Throws if no host provider is available; there is no direct-WebSocket fallback.\n *\n * The `config.rpcs` field is currently unused at runtime (kept for API compatibility\n * and BYOD documentation), since the host owns the chain connection.\n *\n * Results are cached by genesis-hash fingerprint — calling with the same descriptors\n * returns the same instance.\n *\n * @example\n * ```ts\n * import { createChainClient } from \"@parity/product-sdk-chain-client\";\n * import { paseo_asset_hub } from \"@parity/product-sdk-descriptors/paseo-asset-hub\";\n * import { paseo_bulletin } from \"@parity/product-sdk-descriptors/paseo-bulletin\";\n *\n * const client = await createChainClient({\n *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },\n *     rpcs: {\n *         assetHub: [\"wss://paseo-asset-hub-next-rpc.polkadot.io\"],\n *         bulletin: [\"wss://paseo-bulletin-next-rpc.polkadot.io\"],\n *     },\n * });\n *\n * // Fully typed from your descriptors\n * const account = await client.assetHub.query.System.Account.getValue(addr);\n * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();\n *\n * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)\n * import { createContractRuntimeFromClient } from \"@parity/product-sdk-contracts\";\n * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);\n *\n * // Cleanup\n * client.destroy();\n * ```\n */\nexport async function createChainClient<const TChains extends Record<string, ChainDefinition>>(\n    config: ChainClientConfig<TChains>,\n): Promise<ChainClient<TChains>> {\n    const fingerprint = configFingerprint(config.chains);\n\n    const existing = clientInstances.get(fingerprint);\n    if (existing) return existing as Promise<ChainClient<TChains>>;\n\n    const promise = initChainClient(config, fingerprint).catch((err) => {\n        // Clean up any clients created before the failure to avoid leaking\n        // WebSocket connections that are unreachable except via destroyAll().\n        const cache = getClientCache();\n        for (const [key, entry] of cache) {\n            if (key.startsWith(`${fingerprint}:`)) {\n                try {\n                    entry.client.destroy();\n                } catch {\n                    /* already destroyed */\n                }\n                cache.delete(key);\n            }\n        }\n        clientInstances.delete(fingerprint);\n        throw err;\n    });\n    clientInstances.set(fingerprint, promise);\n    return promise;\n}\n\n/* @integration */\nasync function initChainClient<const TChains extends Record<string, ChainDefinition>>(\n    config: ChainClientConfig<TChains>,\n    fingerprint: string,\n): Promise<ChainClient<TChains>> {\n    const names = Object.keys(config.chains) as (string & keyof TChains)[];\n    const clientCache = getClientCache();\n\n    // Create providers and clients in parallel\n    const entries = await Promise.all(\n        names.map(async (name) => {\n            const descriptor = config.chains[name] as ChainDefinition;\n            const genesis = descriptor.genesis;\n            if (!genesis) {\n                throw new Error(`Descriptor for chain \"${name}\" has no genesis hash.`);\n            }\n            const provider = await createProvider(genesis);\n            const client = createClient(provider);\n\n            // Populate HMR cache so getClient() and isConnected() work\n            const key = cacheKey(fingerprint, genesis);\n            if (!clientCache.has(key)) {\n                clientCache.set(key, {\n                    client,\n                    api: new Map(),\n                } satisfies ChainEntry);\n            }\n\n            return { name, descriptor, client, genesis };\n        }),\n    );\n\n    // Build typed APIs and raw client map\n    const apis = {} as Record<string, unknown>;\n    const raw = {} as Record<string, PolkadotClient>;\n\n    for (const { name, descriptor, client } of entries) {\n        apis[name] = client.getTypedApi(descriptor);\n        raw[name] = client;\n    }\n\n    return {\n        ...apis,\n        raw,\n        destroy() {\n            for (const { genesis } of entries) {\n                const key = cacheKey(fingerprint, genesis);\n                const entry = clientCache.get(key);\n                if (entry) {\n                    try {\n                        entry.client.destroy();\n                    } catch {\n                        /* already destroyed */\n                    }\n                    clientCache.delete(key);\n                }\n            }\n            clientInstances.delete(fingerprint);\n        },\n    } as ChainClient<TChains>;\n}\n\n/**\n * Destroy all chain client instances and reset internal caches.\n *\n * Tears down every connection created by {@link createChainClient}.\n */\nexport function destroyAll(): void {\n    clearClientCache();\n    clientInstances.clear();\n}\n\n/**\n * Get the raw `PolkadotClient` for a connected chain by its descriptor.\n *\n * The chain must have been initialized via {@link createChainClient} first.\n * Alternatively, use `client.raw.<name>` on the returned {@link ChainClient}.\n *\n * @throws If the chain has not been connected yet.\n */\nexport function getClient(descriptor: ChainDefinition): PolkadotClient {\n    const genesis = descriptor.genesis;\n    if (!genesis) throw new Error(\"Descriptor has no genesis hash.\");\n    const entry = findEntryByGenesis(genesis);\n    if (!entry?.client) {\n        throw new Error(\n            `Chain not connected (genesis: ${genesis}). Call createChainClient() first to establish connections.`,\n        );\n    }\n    return entry.client;\n}\n\n/**\n * Check if a chain is currently connected.\n *\n * Synchronous — no side effects, no initialization.\n */\nexport function isConnected(descriptor: ChainDefinition): boolean {\n    const genesis = descriptor.genesis;\n    if (!genesis) return false;\n    return findEntryByGenesis(genesis) !== undefined;\n}\n\nif (import.meta.vitest) {\n    const { test, expect, beforeEach } = import.meta.vitest;\n\n    const fakeDescriptor = { genesis: \"0xtest\" } as ChainDefinition;\n    const fakeClient = {\n        destroy: () => {},\n        getTypedApi: () => ({}),\n    } as unknown as PolkadotClient;\n\n    function seedCache(genesis: string, client: PolkadotClient, fp = \"test\") {\n        getClientCache().set(cacheKey(fp, genesis), {\n            client,\n            api: new Map(),\n        });\n    }\n\n    beforeEach(() => {\n        clearClientCache();\n        clientInstances.clear();\n    });\n\n    // --- isConnected ---\n\n    test(\"isConnected returns false for unknown chain\", () => {\n        expect(isConnected(fakeDescriptor)).toBe(false);\n    });\n\n    test(\"isConnected returns true after cache is populated\", () => {\n        seedCache(\"0xtest\", fakeClient);\n        expect(isConnected(fakeDescriptor)).toBe(true);\n    });\n\n    test(\"isConnected returns false for descriptor without genesis\", () => {\n        expect(isConnected({} as ChainDefinition)).toBe(false);\n    });\n\n    // --- getClient ---\n\n    test(\"getClient returns client from cache\", () => {\n        seedCache(\"0xtest\", fakeClient);\n        expect(getClient(fakeDescriptor)).toBe(fakeClient);\n    });\n\n    test(\"getClient throws for unconnected chain\", () => {\n        expect(() => getClient(fakeDescriptor)).toThrow(/Chain not connected/);\n    });\n\n    test(\"getClient throws for descriptor without genesis\", () => {\n        expect(() => getClient({} as ChainDefinition)).toThrow(/no genesis hash/);\n    });\n\n    // --- destroyAll ---\n\n    test(\"destroyAll calls client.destroy() and clears caches\", () => {\n        let destroyed = false;\n        const trackableClient = {\n            destroy: () => {\n                destroyed = true;\n            },\n            getTypedApi: () => ({}),\n        } as unknown as PolkadotClient;\n        seedCache(\"0xtest\", trackableClient);\n        clientInstances.set(\"test\", Promise.resolve({} as ChainClient<any>));\n        destroyAll();\n        expect(destroyed).toBe(true);\n        expect(isConnected(fakeDescriptor)).toBe(false);\n        expect(clientInstances.size).toBe(0);\n    });\n\n    // --- createChainClient ---\n\n    test(\"createChainClient returns same promise for identical config\", async () => {\n        const fakeResult = {} as ChainClient<any>;\n        const fp = configFingerprint({ a: fakeDescriptor });\n        clientInstances.set(fp, Promise.resolve(fakeResult));\n        const result = await createChainClient({\n            chains: { a: fakeDescriptor },\n            rpcs: { a: [] },\n        });\n        expect(result).toBe(fakeResult);\n    });\n\n    test(\"createChainClient deduplicates concurrent calls\", async () => {\n        const fakeResult = {} as ChainClient<any>;\n        const fp = configFingerprint({ x: fakeDescriptor });\n        clientInstances.set(fp, Promise.resolve(fakeResult));\n        const [a, b] = await Promise.all([\n            createChainClient({ chains: { x: fakeDescriptor }, rpcs: { x: [] } }),\n            createChainClient({ chains: { x: fakeDescriptor }, rpcs: { x: [] } }),\n        ]);\n        expect(a).toBe(b);\n    });\n\n    test(\"createChainClient returns different results for different configs\", async () => {\n        const descA = { genesis: \"0xaaa\" } as ChainDefinition;\n        const descB = { genesis: \"0xbbb\" } as ChainDefinition;\n        const resultA = {} as ChainClient<any>;\n        const resultB = {} as ChainClient<any>;\n        clientInstances.set(configFingerprint({ a: descA }), Promise.resolve(resultA));\n        clientInstances.set(configFingerprint({ b: descB }), Promise.resolve(resultB));\n        const a = await createChainClient({ chains: { a: descA }, rpcs: { a: [] } });\n        const b = await createChainClient({ chains: { b: descB }, rpcs: { b: [] } });\n        expect(a).not.toBe(b);\n    });\n\n    // --- configFingerprint ---\n\n    test(\"configFingerprint is stable regardless of key order\", () => {\n        const d1 = { genesis: \"0x1\" } as ChainDefinition;\n        const d2 = { genesis: \"0x2\" } as ChainDefinition;\n        expect(configFingerprint({ a: d1, b: d2 })).toBe(configFingerprint({ b: d2, a: d1 }));\n    });\n\n    // --- findEntryByGenesis ---\n\n    test(\"findEntryByGenesis returns undefined for missing genesis\", () => {\n        expect(findEntryByGenesis(\"0xnonexistent\")).toBeUndefined();\n    });\n\n    // --- full lifecycle ---\n\n    test(\"full lifecycle: seed, verify connected, destroy, verify disconnected\", () => {\n        seedCache(\"0xtest\", fakeClient);\n        expect(isConnected(fakeDescriptor)).toBe(true);\n        expect(getClient(fakeDescriptor)).toBe(fakeClient);\n        destroyAll();\n        expect(isConnected(fakeDescriptor)).toBe(false);\n        expect(() => getClient(fakeDescriptor)).toThrow(/Chain not connected/);\n    });\n\n    test(\"two fingerprints cached independently, destroy one leaves other intact\", () => {\n        const sharedGenesis = \"0xshared\";\n        const clientA = { destroy: () => {} } as PolkadotClient;\n        const clientB = { destroy: () => {} } as PolkadotClient;\n        const descriptorShared = { genesis: sharedGenesis } as ChainDefinition;\n\n        seedCache(sharedGenesis, clientA, \"fpA\");\n        seedCache(sharedGenesis, clientB, \"fpB\");\n\n        expect(isConnected(descriptorShared)).toBe(true);\n\n        // Destroy only fpA's entry\n        const cache = getClientCache();\n        const keyA = cacheKey(\"fpA\", sharedGenesis);\n        cache.get(keyA)?.client.destroy();\n        cache.delete(keyA);\n\n        // fpB's entry still alive\n        expect(isConnected(descriptorShared)).toBe(true);\n        expect(getClient(descriptorShared)).toBe(clientB);\n    });\n}\n","import type { ChainDefinition } from \"polkadot-api\";\nimport { BULLETIN_RPCS } from \"@parity/product-sdk-host\";\nimport { createChainClient } from \"./clients.js\";\nimport type { ChainClient } from \"./types.js\";\n\n// Type-only imports — erased at compile time, zero bundle cost.\n// These give us per-chain TypedApi types without importing runtime descriptor data.\n// Every environment ships its own descriptor for each chain (asset hub, bulletin,\n// individuality) so that genesis hashes and metadata reflect the live chain\n// instance the consumer connects to.\nimport type { polkadot_asset_hub as PolkadotAssetHubDef } from \"@parity/product-sdk-descriptors/polkadot-asset-hub\";\nimport type { kusama_asset_hub as KusamaAssetHubDef } from \"@parity/product-sdk-descriptors/kusama-asset-hub\";\nimport type { paseo_asset_hub as PaseoAssetHubDef } from \"@parity/product-sdk-descriptors/paseo-asset-hub\";\nimport type { previewnet_asset_hub as PreviewnetAssetHubDef } from \"@parity/product-sdk-descriptors/previewnet-asset-hub\";\nimport type { paseo_bulletin as PaseoBulletinDef } from \"@parity/product-sdk-descriptors/paseo-bulletin\";\nimport type { previewnet_bulletin as PreviewnetBulletinDef } from \"@parity/product-sdk-descriptors/previewnet-bulletin\";\nimport type { paseo_individuality as PaseoIndividualityDef } from \"@parity/product-sdk-descriptors/paseo-individuality\";\nimport type { previewnet_individuality as PreviewnetIndividualityDef } from \"@parity/product-sdk-descriptors/previewnet-individuality\";\n\n/** Known network environment with built-in descriptors and RPC endpoints. */\nexport type Environment = \"polkadot\" | \"kusama\" | \"paseo\" | \"previewnet\";\n\n/** Environments where all chains (asset hub, bulletin, individuality) are live. */\nconst AVAILABLE_ENVIRONMENTS: Set<Environment> = new Set([\"paseo\", \"previewnet\"]);\n\nconst rpcs = {\n    polkadot: {\n        assetHub: [\n            \"wss://polkadot-asset-hub-rpc.polkadot.io\",\n            \"wss://sys.ibp.network/asset-hub-polkadot\",\n        ],\n        bulletin: [...BULLETIN_RPCS.polkadot],\n        individuality: [] as string[],\n    },\n    kusama: {\n        assetHub: [\n            \"wss://kusama-asset-hub-rpc.polkadot.io\",\n            \"wss://sys.ibp.network/asset-hub-kusama\",\n        ],\n        bulletin: [...BULLETIN_RPCS.kusama],\n        individuality: [] as string[],\n    },\n    paseo: {\n        assetHub: [\"wss://paseo-asset-hub-next-rpc.polkadot.io\"],\n        bulletin: [...BULLETIN_RPCS.paseo],\n        individuality: [\"wss://paseo-people-next-system-rpc.polkadot.io\"],\n    },\n    previewnet: {\n        assetHub: [\"wss://previewnet.substrate.dev/asset-hub\"],\n        bulletin: [...BULLETIN_RPCS.previewnet],\n        individuality: [\"wss://previewnet.substrate.dev/people\"],\n    },\n} as const;\n\n/**\n * Lazy-load descriptors for a specific environment.\n *\n * Every chain (asset hub, bulletin, individuality) ships a per-environment\n * descriptor so that genesis hashes and metadata reflect the live chain\n * instance the consumer connects to. Dynamic imports are code-split per\n * environment, so a consumer using one environment doesn't bundle the others.\n */\nasync function loadDescriptors(env: Environment) {\n    const loaders = {\n        polkadot: () =>\n            Promise.all([\n                import(\"@parity/product-sdk-descriptors/polkadot-asset-hub\"),\n                // Polkadot bulletin/individuality are not yet live; gated by\n                // AVAILABLE_ENVIRONMENTS so this branch is unreachable today.\n                Promise.reject(new Error(\"polkadot bulletin descriptor not yet available\")),\n                Promise.reject(new Error(\"polkadot individuality descriptor not yet available\")),\n            ]),\n        kusama: () =>\n            Promise.all([\n                import(\"@parity/product-sdk-descriptors/kusama-asset-hub\"),\n                Promise.reject(new Error(\"kusama bulletin descriptor not yet available\")),\n                Promise.reject(new Error(\"kusama individuality descriptor not yet available\")),\n            ]),\n        paseo: () =>\n            Promise.all([\n                import(\"@parity/product-sdk-descriptors/paseo-asset-hub\"),\n                import(\"@parity/product-sdk-descriptors/paseo-bulletin\"),\n                import(\"@parity/product-sdk-descriptors/paseo-individuality\"),\n            ]),\n        previewnet: () =>\n            Promise.all([\n                import(\"@parity/product-sdk-descriptors/previewnet-asset-hub\"),\n                import(\"@parity/product-sdk-descriptors/previewnet-bulletin\"),\n                import(\"@parity/product-sdk-descriptors/previewnet-individuality\"),\n            ]),\n    };\n\n    const [ahMod, bulletinMod, individualityMod] = await loaders[env]();\n\n    // Extract the named exports — varies per environment. The fallback casts use\n    // narrow shape types (not the full `typeof import(...)`) to keep formatter\n    // wrap behavior compatible with esbuild's parser.\n    const assetHub =\n        \"polkadot_asset_hub\" in ahMod\n            ? ahMod.polkadot_asset_hub\n            : \"kusama_asset_hub\" in ahMod\n              ? ahMod.kusama_asset_hub\n              : \"paseo_asset_hub\" in ahMod\n                ? ahMod.paseo_asset_hub\n                : (ahMod as { previewnet_asset_hub: typeof PreviewnetAssetHubDef })\n                      .previewnet_asset_hub;\n\n    const bulletin =\n        \"paseo_bulletin\" in bulletinMod\n            ? bulletinMod.paseo_bulletin\n            : (bulletinMod as { previewnet_bulletin: typeof PreviewnetBulletinDef })\n                  .previewnet_bulletin;\n\n    const individuality =\n        \"paseo_individuality\" in individualityMod\n            ? individualityMod.paseo_individuality\n            : (individualityMod as { previewnet_individuality: typeof PreviewnetIndividualityDef })\n                  .previewnet_individuality;\n\n    return { assetHub, bulletin, individuality };\n}\n\n/** Per-environment descriptor types for each chain in the preset. */\ntype PresetDescriptors = {\n    polkadot: {\n        assetHub: typeof PolkadotAssetHubDef;\n        // Bulletin/individuality not yet live on polkadot — types reuse paseo\n        // shape so the API surface stays consistent; runtime path is gated.\n        bulletin: typeof PaseoBulletinDef;\n        individuality: typeof PaseoIndividualityDef;\n    };\n    kusama: {\n        assetHub: typeof KusamaAssetHubDef;\n        bulletin: typeof PaseoBulletinDef;\n        individuality: typeof PaseoIndividualityDef;\n    };\n    paseo: {\n        assetHub: typeof PaseoAssetHubDef;\n        bulletin: typeof PaseoBulletinDef;\n        individuality: typeof PaseoIndividualityDef;\n    };\n    previewnet: {\n        assetHub: typeof PreviewnetAssetHubDef;\n        bulletin: typeof PreviewnetBulletinDef;\n        individuality: typeof PreviewnetIndividualityDef;\n    };\n};\n\n/** The chain shape returned by {@link getChainAPI} for a given environment. */\nexport type PresetChains<E extends Environment> = PresetDescriptors[E];\n\n/**\n * Get a chain client for a known environment with built-in descriptors and RPCs.\n *\n * This is the **zero-config** path — no need to import descriptors or specify\n * endpoints. For custom chains or BYOD descriptors, use\n * {@link createChainClient} instead.\n *\n * Returns the same {@link ChainClient} type as `createChainClient`, with\n * `assetHub`, `bulletin`, and `individuality` chain keys.\n *\n * @example\n * ```ts\n * import { getChainAPI } from \"@parity/product-sdk-chain-client\";\n *\n * const client = await getChainAPI(\"paseo\");\n *\n * // Fully typed — no descriptor imports needed\n * const account = await client.assetHub.query.System.Account.getValue(addr);\n * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();\n *\n * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)\n * import { createContractRuntimeFromClient } from \"@parity/product-sdk-contracts\";\n * import { paseo_asset_hub } from \"@parity/product-sdk-descriptors/paseo-asset-hub\";\n * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);\n *\n * client.destroy();\n * ```\n */\nexport async function getChainAPI<E extends Environment>(\n    env: E,\n): Promise<ChainClient<PresetChains<E>>> {\n    if (!AVAILABLE_ENVIRONMENTS.has(env)) {\n        throw new Error(`Chain API for \"${env}\" is not yet available`);\n    }\n\n    const descriptors = await loadDescriptors(env);\n    const envRpcs = rpcs[env];\n\n    return createChainClient({\n        chains: {\n            assetHub: descriptors.assetHub,\n            bulletin: descriptors.bulletin,\n            individuality: descriptors.individuality,\n        },\n        rpcs: {\n            assetHub: [...envRpcs.assetHub],\n            bulletin: [...envRpcs.bulletin],\n            individuality: [...envRpcs.individuality],\n        },\n    }) as Promise<ChainClient<PresetChains<E>>>;\n}\n\nif (import.meta.vitest) {\n    const { test, expect, beforeEach } = import.meta.vitest;\n    const { destroyAll } = await import(\"./clients.js\");\n\n    // Test-only genesis hashes for assertion — not used in production code.\n    // Each chain has a per-environment genesis: bulletin and individuality\n    // are distinct chain instances across paseo and previewnet (same runtime,\n    // separate deployments).\n    const GENESIS = {\n        polkadot_asset_hub: \"0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f\",\n        kusama_asset_hub: \"0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a\",\n        paseo_asset_hub: \"0x173cea9df45656cf612c8b8ece56e04e9a693c69cfaac47d3628dae735067af8\",\n        previewnet_asset_hub: \"0x860d75a890388e2ad02c54aa451264d04af89765773a51cd56868b4293c7867c\",\n        paseo_bulletin: \"0x8cfe6717dc4becfda2e13c488a1e2061ff2dfee96e7d031157f72d36716c0a22\",\n        previewnet_bulletin: \"0xf37fa1f1450ea120edbf64c3fc447f671a00e1f1095a698f42eeec073c7ee487\",\n        paseo_individuality: \"0x053e1a785bb0990b98768124d9609e963d9ca3558f5ac6e90a4297aaa0a0bd4b\",\n        previewnet_individuality:\n            \"0xbf3a38ecba96d2f647bc12198011b9e4f0ba3a7e2a190597205cbe238f5c125d\",\n    } as const;\n\n    beforeEach(() => {\n        destroyAll();\n    });\n\n    // --- GENESIS constants ---\n\n    test(\"genesis constants are valid hex hashes\", () => {\n        for (const hash of Object.values(GENESIS)) {\n            expect(hash).toMatch(/^0x[a-f0-9]{64}$/);\n        }\n    });\n\n    // --- RPC config ---\n\n    test(\"rpcs defined for all environments\", () => {\n        for (const env of [\"polkadot\", \"kusama\", \"paseo\", \"previewnet\"] as const) {\n            const envRpcs = rpcs[env];\n            expect(envRpcs.assetHub.length).toBeGreaterThan(0);\n        }\n    });\n\n    test(\"paseo has RPCs for all chains\", () => {\n        const envRpcs = rpcs.paseo;\n        expect(envRpcs.bulletin.length).toBeGreaterThan(0);\n        expect(envRpcs.individuality.length).toBeGreaterThan(0);\n    });\n\n    test(\"previewnet has RPCs for all chains\", () => {\n        const envRpcs = rpcs.previewnet;\n        expect(envRpcs.bulletin.length).toBeGreaterThan(0);\n        expect(envRpcs.individuality.length).toBeGreaterThan(0);\n    });\n\n    // --- getChainAPI ---\n\n    test(\"polkadot and kusama throw as not yet available\", async () => {\n        await expect(getChainAPI(\"polkadot\")).rejects.toThrow(\"not yet available\");\n        await expect(getChainAPI(\"kusama\")).rejects.toThrow(\"not yet available\");\n    });\n\n    // --- loadDescriptors ---\n\n    test(\"loadDescriptors returns descriptors with genesis hashes for paseo\", async () => {\n        const descriptors = await loadDescriptors(\"paseo\");\n        expect(descriptors).toBeDefined();\n        expect(descriptors.assetHub).toBeDefined();\n        expect(descriptors.bulletin).toBeDefined();\n        expect(descriptors.individuality).toBeDefined();\n        expect(descriptors.assetHub.genesis).toBe(GENESIS.paseo_asset_hub);\n        expect(descriptors.bulletin.genesis).toBe(GENESIS.paseo_bulletin);\n        expect(descriptors.individuality.genesis).toBe(GENESIS.paseo_individuality);\n    });\n\n    test(\"loadDescriptors returns descriptors with genesis hashes for previewnet\", async () => {\n        const descriptors = await loadDescriptors(\"previewnet\");\n        expect(descriptors).toBeDefined();\n        expect(descriptors.assetHub).toBeDefined();\n        expect(descriptors.bulletin).toBeDefined();\n        expect(descriptors.individuality).toBeDefined();\n        expect(descriptors.assetHub.genesis).toBe(GENESIS.previewnet_asset_hub);\n        expect(descriptors.bulletin.genesis).toBe(GENESIS.previewnet_bulletin);\n        expect(descriptors.individuality.genesis).toBe(GENESIS.previewnet_individuality);\n    });\n\n    test(\"loadDescriptors returns environment-specific descriptors for every chain\", async () => {\n        const paseo = await loadDescriptors(\"paseo\");\n        const previewnet = await loadDescriptors(\"previewnet\");\n        // asset-hub: paseo and previewnet are different runtimes (different chains)\n        expect(paseo.assetHub.genesis).toBe(GENESIS.paseo_asset_hub);\n        expect(previewnet.assetHub.genesis).toBe(GENESIS.previewnet_asset_hub);\n        // bulletin: same runtime, different chain instances → distinct genesis\n        expect(paseo.bulletin.genesis).toBe(GENESIS.paseo_bulletin);\n        expect(previewnet.bulletin.genesis).toBe(GENESIS.previewnet_bulletin);\n        expect(paseo.bulletin.genesis).not.toBe(previewnet.bulletin.genesis);\n        // individuality: same runtime, different chain instances → distinct genesis\n        expect(paseo.individuality.genesis).toBe(GENESIS.paseo_individuality);\n        expect(previewnet.individuality.genesis).toBe(GENESIS.previewnet_individuality);\n        expect(paseo.individuality.genesis).not.toBe(previewnet.individuality.genesis);\n    });\n\n    // --- AVAILABLE_ENVIRONMENTS ---\n\n    test(\"paseo and previewnet are currently available\", () => {\n        expect(AVAILABLE_ENVIRONMENTS.has(\"paseo\")).toBe(true);\n        expect(AVAILABLE_ENVIRONMENTS.has(\"previewnet\")).toBe(true);\n        expect(AVAILABLE_ENVIRONMENTS.has(\"polkadot\")).toBe(false);\n        expect(AVAILABLE_ENVIRONMENTS.has(\"kusama\")).toBe(false);\n    });\n}\n"]}
+{"version":3,"sources":["../src/providers.ts","../src/hmr.ts","../src/clients.ts","../src/presets.ts","../src/well-known-chain.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { getHostProvider } from \"@parity/product-sdk-host\";\nimport type { JsonRpcProvider } from \"polkadot-api\";\n\n/**\n * Create a PAPI-compatible JSON-RPC provider for a chain.\n *\n * Routes connections through the host provider (`@parity/product-sdk-host`).\n * The SDK is designed to run exclusively inside a host container.\n *\n * @throws {Error} If the host provider is unavailable (not inside a container).\n */\nexport async function createProvider(genesisHash: string): Promise<JsonRpcProvider> {\n    const hostProvider = await getHostProvider(genesisHash as `0x${string}`);\n    if (!hostProvider) {\n        throw new Error(\n            `Host provider unavailable for chain ${genesisHash}. Ensure you are running inside a host container (Polkadot Browser / Desktop).`,\n        );\n    }\n    return hostProvider;\n}\n\nif (import.meta.vitest) {\n    const { test, expect, vi, beforeEach } = import.meta.vitest;\n\n    // Shared state between hoisted mocks and tests\n    const state = vi.hoisted(() => ({\n        fakeProvider: (() => {}) as unknown as JsonRpcProvider,\n        hostProviderCalls: [] as unknown[][],\n        hostProviderAvailable: true,\n    }));\n\n    vi.mock(\"@parity/product-sdk-host\", async (importOriginal) => ({\n        ...(await importOriginal<typeof import(\"@parity/product-sdk-host\")>()),\n        getHostProvider: async (...args: unknown[]) => {\n            state.hostProviderCalls.push(args);\n            if (!state.hostProviderAvailable) return null;\n            return state.fakeProvider;\n        },\n    }));\n\n    beforeEach(() => {\n        state.hostProviderCalls = [];\n        state.hostProviderAvailable = true;\n    });\n\n    test(\"returns host provider when available\", async () => {\n        const result = await createProvider(\"0xabc\");\n        expect(result).toBe(state.fakeProvider);\n        expect(state.hostProviderCalls.length).toBe(1);\n        expect(state.hostProviderCalls[0][0]).toBe(\"0xabc\");\n    });\n\n    test(\"throws when host provider unavailable\", async () => {\n        state.hostProviderAvailable = false;\n        await expect(createProvider(\"0xabc\")).rejects.toThrow(/Host provider unavailable/);\n    });\n}\n","import type { ChainEntry } from \"./types.js\";\n\ndeclare global {\n    var __chainClientCache: Map<string, ChainEntry> | undefined;\n}\n\n/** Get the HMR-safe client cache, keyed by genesis hash. */\nexport function getClientCache(): Map<string, ChainEntry> {\n    globalThis.__chainClientCache ??= new Map();\n    return globalThis.__chainClientCache;\n}\n\n/** Clear all entries from the client cache. Destroys active clients. */\nexport function clearClientCache(): void {\n    const cache = getClientCache();\n    for (const entry of cache.values()) {\n        try {\n            entry.client.destroy();\n        } catch {\n            // client may already be destroyed\n        }\n    }\n    cache.clear();\n}\n\nif (import.meta.vitest) {\n    const { test, expect } = import.meta.vitest;\n\n    test(\"getClientCache returns a Map\", () => {\n        const cache = getClientCache();\n        expect(cache).toBeInstanceOf(Map);\n    });\n\n    test(\"getClientCache returns the same instance on repeated calls\", () => {\n        const a = getClientCache();\n        const b = getClientCache();\n        expect(a).toBe(b);\n    });\n}\n","import type { ChainDefinition, PolkadotClient } from \"polkadot-api\";\nimport { createClient } from \"polkadot-api\";\nimport { createProvider } from \"./providers.js\";\nimport { getClientCache, clearClientCache } from \"./hmr.js\";\nimport type { ChainEntry, ChainClientConfig, ChainClient } from \"./types.js\";\n\n// Cache keys are scoped by a fingerprint of the config so that two\n// `createChainClient` calls with different chain sets don't collide.\nconst cacheKey = (fingerprint: string, genesis: string) => `${fingerprint}:${genesis}`;\n\nfunction findEntryByGenesis(genesis: string): ChainEntry | undefined {\n    for (const [key, entry] of getClientCache()) {\n        if (key.endsWith(`:${genesis}`)) return entry;\n    }\n}\n\nconst clientInstances = new Map<string, Promise<ChainClient<any>>>();\n\n/** Build a stable fingerprint from sorted chain names + genesis hashes. */\nfunction configFingerprint(chains: Record<string, ChainDefinition>): string {\n    return Object.entries(chains)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([name, desc]) => `${name}:${desc.genesis ?? \"unknown\"}`)\n        .join(\"|\");\n}\n\n/**\n * Create a multi-chain client with user-provided descriptors and RPC endpoints.\n *\n * Returns fully-typed APIs for each chain plus raw `PolkadotClient` access via `.raw`.\n * Connections route through the host provider (`@parity/product-sdk-host`) — the SDK\n * is designed to run exclusively inside a host container (Polkadot Browser / Desktop).\n * Throws if no host provider is available; there is no direct-WebSocket fallback.\n *\n * The `config.rpcs` field is currently unused at runtime (kept for API compatibility\n * and BYOD documentation), since the host owns the chain connection.\n *\n * Results are cached by genesis-hash fingerprint — calling with the same descriptors\n * returns the same instance.\n *\n * @example\n * ```ts\n * import { createChainClient } from \"@parity/product-sdk-chain-client\";\n * import { paseo_asset_hub } from \"@parity/product-sdk-descriptors/paseo-asset-hub\";\n * import { paseo_bulletin } from \"@parity/product-sdk-descriptors/paseo-bulletin\";\n *\n * const client = await createChainClient({\n *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },\n *     rpcs: {\n *         assetHub: [\"wss://paseo-asset-hub-next-rpc.polkadot.io\"],\n *         bulletin: [\"wss://paseo-bulletin-next-rpc.polkadot.io\"],\n *     },\n * });\n *\n * // Fully typed from your descriptors\n * const account = await client.assetHub.query.System.Account.getValue(addr);\n * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();\n *\n * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)\n * import { createContractRuntimeFromClient } from \"@parity/product-sdk-contracts\";\n * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);\n *\n * // Cleanup\n * client.destroy();\n * ```\n */\nexport async function createChainClient<const TChains extends Record<string, ChainDefinition>>(\n    config: ChainClientConfig<TChains>,\n): Promise<ChainClient<TChains>> {\n    const fingerprint = configFingerprint(config.chains);\n\n    const existing = clientInstances.get(fingerprint);\n    if (existing) return existing as Promise<ChainClient<TChains>>;\n\n    const promise = initChainClient(config, fingerprint).catch((err) => {\n        // Clean up any clients created before the failure to avoid leaking\n        // WebSocket connections that are unreachable except via destroyAll().\n        const cache = getClientCache();\n        for (const [key, entry] of cache) {\n            if (key.startsWith(`${fingerprint}:`)) {\n                try {\n                    entry.client.destroy();\n                } catch {\n                    /* already destroyed */\n                }\n                cache.delete(key);\n            }\n        }\n        clientInstances.delete(fingerprint);\n        throw err;\n    });\n    clientInstances.set(fingerprint, promise);\n    return promise;\n}\n\n/* @integration */\nasync function initChainClient<const TChains extends Record<string, ChainDefinition>>(\n    config: ChainClientConfig<TChains>,\n    fingerprint: string,\n): Promise<ChainClient<TChains>> {\n    const names = Object.keys(config.chains) as (string & keyof TChains)[];\n    const clientCache = getClientCache();\n\n    // Create providers and clients in parallel\n    const entries = await Promise.all(\n        names.map(async (name) => {\n            const descriptor = config.chains[name] as ChainDefinition;\n            const genesis = descriptor.genesis;\n            if (!genesis) {\n                throw new Error(`Descriptor for chain \"${name}\" has no genesis hash.`);\n            }\n            const provider = await createProvider(genesis);\n            const client = createClient(provider);\n\n            // Populate HMR cache so getClient() and isConnected() work\n            const key = cacheKey(fingerprint, genesis);\n            if (!clientCache.has(key)) {\n                clientCache.set(key, {\n                    client,\n                    api: new Map(),\n                } satisfies ChainEntry);\n            }\n\n            return { name, descriptor, client, genesis };\n        }),\n    );\n\n    // Build typed APIs and raw client map\n    const apis = {} as Record<string, unknown>;\n    const raw = {} as Record<string, PolkadotClient>;\n\n    for (const { name, descriptor, client } of entries) {\n        apis[name] = client.getTypedApi(descriptor);\n        raw[name] = client;\n    }\n\n    return {\n        ...apis,\n        raw,\n        destroy() {\n            for (const { genesis } of entries) {\n                const key = cacheKey(fingerprint, genesis);\n                const entry = clientCache.get(key);\n                if (entry) {\n                    try {\n                        entry.client.destroy();\n                    } catch {\n                        /* already destroyed */\n                    }\n                    clientCache.delete(key);\n                }\n            }\n            clientInstances.delete(fingerprint);\n        },\n    } as ChainClient<TChains>;\n}\n\n/**\n * Destroy all chain client instances and reset internal caches.\n *\n * Tears down every connection created by {@link createChainClient}.\n */\nexport function destroyAll(): void {\n    clearClientCache();\n    clientInstances.clear();\n}\n\n/**\n * Get the raw `PolkadotClient` for a connected chain by its descriptor.\n *\n * The chain must have been initialized via {@link createChainClient} first.\n * Alternatively, use `client.raw.<name>` on the returned {@link ChainClient}.\n *\n * @throws If the chain has not been connected yet.\n */\nexport function getClient(descriptor: ChainDefinition): PolkadotClient {\n    const genesis = descriptor.genesis;\n    if (!genesis) throw new Error(\"Descriptor has no genesis hash.\");\n    const entry = findEntryByGenesis(genesis);\n    if (!entry?.client) {\n        throw new Error(\n            `Chain not connected (genesis: ${genesis}). Call createChainClient() first to establish connections.`,\n        );\n    }\n    return entry.client;\n}\n\n/**\n * Check if a chain is currently connected.\n *\n * Synchronous — no side effects, no initialization.\n */\nexport function isConnected(descriptor: ChainDefinition): boolean {\n    const genesis = descriptor.genesis;\n    if (!genesis) return false;\n    return findEntryByGenesis(genesis) !== undefined;\n}\n\nif (import.meta.vitest) {\n    const { test, expect, beforeEach } = import.meta.vitest;\n\n    const fakeDescriptor = { genesis: \"0xtest\" } as ChainDefinition;\n    const fakeClient = {\n        destroy: () => {},\n        getTypedApi: () => ({}),\n    } as unknown as PolkadotClient;\n\n    function seedCache(genesis: string, client: PolkadotClient, fp = \"test\") {\n        getClientCache().set(cacheKey(fp, genesis), {\n            client,\n            api: new Map(),\n        });\n    }\n\n    beforeEach(() => {\n        clearClientCache();\n        clientInstances.clear();\n    });\n\n    // --- isConnected ---\n\n    test(\"isConnected returns false for unknown chain\", () => {\n        expect(isConnected(fakeDescriptor)).toBe(false);\n    });\n\n    test(\"isConnected returns true after cache is populated\", () => {\n        seedCache(\"0xtest\", fakeClient);\n        expect(isConnected(fakeDescriptor)).toBe(true);\n    });\n\n    test(\"isConnected returns false for descriptor without genesis\", () => {\n        expect(isConnected({} as ChainDefinition)).toBe(false);\n    });\n\n    // --- getClient ---\n\n    test(\"getClient returns client from cache\", () => {\n        seedCache(\"0xtest\", fakeClient);\n        expect(getClient(fakeDescriptor)).toBe(fakeClient);\n    });\n\n    test(\"getClient throws for unconnected chain\", () => {\n        expect(() => getClient(fakeDescriptor)).toThrow(/Chain not connected/);\n    });\n\n    test(\"getClient throws for descriptor without genesis\", () => {\n        expect(() => getClient({} as ChainDefinition)).toThrow(/no genesis hash/);\n    });\n\n    // --- destroyAll ---\n\n    test(\"destroyAll calls client.destroy() and clears caches\", () => {\n        let destroyed = false;\n        const trackableClient = {\n            destroy: () => {\n                destroyed = true;\n            },\n            getTypedApi: () => ({}),\n        } as unknown as PolkadotClient;\n        seedCache(\"0xtest\", trackableClient);\n        clientInstances.set(\"test\", Promise.resolve({} as ChainClient<any>));\n        destroyAll();\n        expect(destroyed).toBe(true);\n        expect(isConnected(fakeDescriptor)).toBe(false);\n        expect(clientInstances.size).toBe(0);\n    });\n\n    // --- createChainClient ---\n\n    test(\"createChainClient returns same promise for identical config\", async () => {\n        const fakeResult = {} as ChainClient<any>;\n        const fp = configFingerprint({ a: fakeDescriptor });\n        clientInstances.set(fp, Promise.resolve(fakeResult));\n        const result = await createChainClient({\n            chains: { a: fakeDescriptor },\n            rpcs: { a: [] },\n        });\n        expect(result).toBe(fakeResult);\n    });\n\n    test(\"createChainClient deduplicates concurrent calls\", async () => {\n        const fakeResult = {} as ChainClient<any>;\n        const fp = configFingerprint({ x: fakeDescriptor });\n        clientInstances.set(fp, Promise.resolve(fakeResult));\n        const [a, b] = await Promise.all([\n            createChainClient({ chains: { x: fakeDescriptor }, rpcs: { x: [] } }),\n            createChainClient({ chains: { x: fakeDescriptor }, rpcs: { x: [] } }),\n        ]);\n        expect(a).toBe(b);\n    });\n\n    test(\"createChainClient returns different results for different configs\", async () => {\n        const descA = { genesis: \"0xaaa\" } as ChainDefinition;\n        const descB = { genesis: \"0xbbb\" } as ChainDefinition;\n        const resultA = {} as ChainClient<any>;\n        const resultB = {} as ChainClient<any>;\n        clientInstances.set(configFingerprint({ a: descA }), Promise.resolve(resultA));\n        clientInstances.set(configFingerprint({ b: descB }), Promise.resolve(resultB));\n        const a = await createChainClient({ chains: { a: descA }, rpcs: { a: [] } });\n        const b = await createChainClient({ chains: { b: descB }, rpcs: { b: [] } });\n        expect(a).not.toBe(b);\n    });\n\n    // --- configFingerprint ---\n\n    test(\"configFingerprint is stable regardless of key order\", () => {\n        const d1 = { genesis: \"0x1\" } as ChainDefinition;\n        const d2 = { genesis: \"0x2\" } as ChainDefinition;\n        expect(configFingerprint({ a: d1, b: d2 })).toBe(configFingerprint({ b: d2, a: d1 }));\n    });\n\n    // --- findEntryByGenesis ---\n\n    test(\"findEntryByGenesis returns undefined for missing genesis\", () => {\n        expect(findEntryByGenesis(\"0xnonexistent\")).toBeUndefined();\n    });\n\n    // --- full lifecycle ---\n\n    test(\"full lifecycle: seed, verify connected, destroy, verify disconnected\", () => {\n        seedCache(\"0xtest\", fakeClient);\n        expect(isConnected(fakeDescriptor)).toBe(true);\n        expect(getClient(fakeDescriptor)).toBe(fakeClient);\n        destroyAll();\n        expect(isConnected(fakeDescriptor)).toBe(false);\n        expect(() => getClient(fakeDescriptor)).toThrow(/Chain not connected/);\n    });\n\n    test(\"two fingerprints cached independently, destroy one leaves other intact\", () => {\n        const sharedGenesis = \"0xshared\";\n        const clientA = { destroy: () => {} } as PolkadotClient;\n        const clientB = { destroy: () => {} } as PolkadotClient;\n        const descriptorShared = { genesis: sharedGenesis } as ChainDefinition;\n\n        seedCache(sharedGenesis, clientA, \"fpA\");\n        seedCache(sharedGenesis, clientB, \"fpB\");\n\n        expect(isConnected(descriptorShared)).toBe(true);\n\n        // Destroy only fpA's entry\n        const cache = getClientCache();\n        const keyA = cacheKey(\"fpA\", sharedGenesis);\n        cache.get(keyA)?.client.destroy();\n        cache.delete(keyA);\n\n        // fpB's entry still alive\n        expect(isConnected(descriptorShared)).toBe(true);\n        expect(getClient(descriptorShared)).toBe(clientB);\n    });\n}\n","import type { ChainDefinition } from \"polkadot-api\";\nimport { BULLETIN_RPCS } from \"@parity/product-sdk-host\";\nimport { createChainClient } from \"./clients.js\";\nimport type { ChainClient } from \"./types.js\";\n\n// Type-only imports — erased at compile time, zero bundle cost.\n// These give us per-chain TypedApi types without importing runtime descriptor data.\n// Every environment ships its own descriptor for each chain (asset hub, bulletin,\n// individuality) so that genesis hashes and metadata reflect the live chain\n// instance the consumer connects to.\nimport type { polkadot_asset_hub as PolkadotAssetHubDef } from \"@parity/product-sdk-descriptors/polkadot-asset-hub\";\nimport type { kusama_asset_hub as KusamaAssetHubDef } from \"@parity/product-sdk-descriptors/kusama-asset-hub\";\nimport type { paseo_asset_hub as PaseoAssetHubDef } from \"@parity/product-sdk-descriptors/paseo-asset-hub\";\nimport type { paseo_bulletin as PaseoBulletinDef } from \"@parity/product-sdk-descriptors/paseo-bulletin\";\nimport type { paseo_individuality as PaseoIndividualityDef } from \"@parity/product-sdk-descriptors/paseo-individuality\";\n\n/** Known network environment with built-in descriptors and RPC endpoints. */\nexport type Environment = \"polkadot\" | \"kusama\" | \"paseo\";\n\n/** Environments where all chains (asset hub, bulletin, individuality) are live. */\nconst AVAILABLE_ENVIRONMENTS: Set<Environment> = new Set([\"paseo\"]);\n\nconst rpcs = {\n    polkadot: {\n        assetHub: [\n            \"wss://polkadot-asset-hub-rpc.polkadot.io\",\n            \"wss://sys.ibp.network/asset-hub-polkadot\",\n        ],\n        bulletin: [...BULLETIN_RPCS.polkadot],\n        individuality: [] as string[],\n    },\n    kusama: {\n        assetHub: [\n            \"wss://kusama-asset-hub-rpc.polkadot.io\",\n            \"wss://sys.ibp.network/asset-hub-kusama\",\n        ],\n        bulletin: [...BULLETIN_RPCS.kusama],\n        individuality: [] as string[],\n    },\n    paseo: {\n        assetHub: [\"wss://paseo-asset-hub-next-rpc.polkadot.io\"],\n        bulletin: [...BULLETIN_RPCS.paseo],\n        individuality: [\"wss://paseo-people-next-system-rpc.polkadot.io\"],\n    },\n} as const;\n\n/**\n * Lazy-load descriptors for a specific environment.\n *\n * Every chain (asset hub, bulletin, individuality) ships a per-environment\n * descriptor so that genesis hashes and metadata reflect the live chain\n * instance the consumer connects to. Dynamic imports are code-split per\n * environment, so a consumer using one environment doesn't bundle the others.\n */\nasync function loadDescriptors(env: Environment) {\n    const loaders = {\n        polkadot: () =>\n            Promise.all([\n                import(\"@parity/product-sdk-descriptors/polkadot-asset-hub\"),\n                // Polkadot bulletin/individuality are not yet live; gated by\n                // AVAILABLE_ENVIRONMENTS so this branch is unreachable today.\n                Promise.reject(new Error(\"polkadot bulletin descriptor not yet available\")),\n                Promise.reject(new Error(\"polkadot individuality descriptor not yet available\")),\n            ]),\n        kusama: () =>\n            Promise.all([\n                import(\"@parity/product-sdk-descriptors/kusama-asset-hub\"),\n                Promise.reject(new Error(\"kusama bulletin descriptor not yet available\")),\n                Promise.reject(new Error(\"kusama individuality descriptor not yet available\")),\n            ]),\n        paseo: () =>\n            Promise.all([\n                import(\"@parity/product-sdk-descriptors/paseo-asset-hub\"),\n                import(\"@parity/product-sdk-descriptors/paseo-bulletin\"),\n                import(\"@parity/product-sdk-descriptors/paseo-individuality\"),\n            ]),\n    };\n\n    const [ahMod, bulletinMod, individualityMod] = await loaders[env]();\n\n    const assetHub =\n        \"polkadot_asset_hub\" in ahMod\n            ? ahMod.polkadot_asset_hub\n            : \"kusama_asset_hub\" in ahMod\n              ? ahMod.kusama_asset_hub\n              : (ahMod as { paseo_asset_hub: typeof PaseoAssetHubDef }).paseo_asset_hub;\n\n    const bulletin = (bulletinMod as { paseo_bulletin: typeof PaseoBulletinDef }).paseo_bulletin;\n\n    const individuality = (\n        individualityMod as { paseo_individuality: typeof PaseoIndividualityDef }\n    ).paseo_individuality;\n\n    return { assetHub, bulletin, individuality };\n}\n\n/** Per-environment descriptor types for each chain in the preset. */\ntype PresetDescriptors = {\n    polkadot: {\n        assetHub: typeof PolkadotAssetHubDef;\n        // Bulletin/individuality not yet live on polkadot — types reuse paseo\n        // shape so the API surface stays consistent; runtime path is gated.\n        bulletin: typeof PaseoBulletinDef;\n        individuality: typeof PaseoIndividualityDef;\n    };\n    kusama: {\n        assetHub: typeof KusamaAssetHubDef;\n        bulletin: typeof PaseoBulletinDef;\n        individuality: typeof PaseoIndividualityDef;\n    };\n    paseo: {\n        assetHub: typeof PaseoAssetHubDef;\n        bulletin: typeof PaseoBulletinDef;\n        individuality: typeof PaseoIndividualityDef;\n    };\n};\n\n/** The chain shape returned by {@link getChainAPI} for a given environment. */\nexport type PresetChains<E extends Environment> = PresetDescriptors[E];\n\n/**\n * Get a chain client for a known environment with built-in descriptors and RPCs.\n *\n * This is the **zero-config** path — no need to import descriptors or specify\n * endpoints. For custom chains or BYOD descriptors, use\n * {@link createChainClient} instead.\n *\n * Returns the same {@link ChainClient} type as `createChainClient`, with\n * `assetHub`, `bulletin`, and `individuality` chain keys.\n *\n * @example\n * ```ts\n * import { getChainAPI } from \"@parity/product-sdk-chain-client\";\n *\n * const client = await getChainAPI(\"paseo\");\n *\n * // Fully typed — no descriptor imports needed\n * const account = await client.assetHub.query.System.Account.getValue(addr);\n * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();\n *\n * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)\n * import { createContractRuntimeFromClient } from \"@parity/product-sdk-contracts\";\n * import { paseo_asset_hub } from \"@parity/product-sdk-descriptors/paseo-asset-hub\";\n * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);\n *\n * client.destroy();\n * ```\n */\nexport async function getChainAPI<E extends Environment>(\n    env: E,\n): Promise<ChainClient<PresetChains<E>>> {\n    if (!AVAILABLE_ENVIRONMENTS.has(env)) {\n        throw new Error(`Chain API for \"${env}\" is not yet available`);\n    }\n\n    const descriptors = await loadDescriptors(env);\n    const envRpcs = rpcs[env];\n\n    return createChainClient({\n        chains: {\n            assetHub: descriptors.assetHub,\n            bulletin: descriptors.bulletin,\n            individuality: descriptors.individuality,\n        },\n        rpcs: {\n            assetHub: [...envRpcs.assetHub],\n            bulletin: [...envRpcs.bulletin],\n            individuality: [...envRpcs.individuality],\n        },\n    }) as Promise<ChainClient<PresetChains<E>>>;\n}\n\nif (import.meta.vitest) {\n    const { test, expect, beforeEach } = import.meta.vitest;\n    const { destroyAll } = await import(\"./clients.js\");\n\n    // Test-only genesis hashes for assertion — not used in production code.\n    const GENESIS = {\n        polkadot_asset_hub: \"0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f\",\n        kusama_asset_hub: \"0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a\",\n        paseo_asset_hub: \"0x173cea9df45656cf612c8b8ece56e04e9a693c69cfaac47d3628dae735067af8\",\n        paseo_bulletin: \"0x8cfe6717dc4becfda2e13c488a1e2061ff2dfee96e7d031157f72d36716c0a22\",\n        paseo_individuality: \"0x053e1a785bb0990b98768124d9609e963d9ca3558f5ac6e90a4297aaa0a0bd4b\",\n    } as const;\n\n    beforeEach(() => {\n        destroyAll();\n    });\n\n    // --- GENESIS constants ---\n\n    test(\"genesis constants are valid hex hashes\", () => {\n        for (const hash of Object.values(GENESIS)) {\n            expect(hash).toMatch(/^0x[a-f0-9]{64}$/);\n        }\n    });\n\n    // --- RPC config ---\n\n    test(\"rpcs defined for all environments\", () => {\n        for (const env of [\"polkadot\", \"kusama\", \"paseo\"] as const) {\n            const envRpcs = rpcs[env];\n            expect(envRpcs.assetHub.length).toBeGreaterThan(0);\n        }\n    });\n\n    test(\"paseo has RPCs for all chains\", () => {\n        const envRpcs = rpcs.paseo;\n        expect(envRpcs.bulletin.length).toBeGreaterThan(0);\n        expect(envRpcs.individuality.length).toBeGreaterThan(0);\n    });\n\n    // --- getChainAPI ---\n\n    test(\"polkadot and kusama throw as not yet available\", async () => {\n        await expect(getChainAPI(\"polkadot\")).rejects.toThrow(\"not yet available\");\n        await expect(getChainAPI(\"kusama\")).rejects.toThrow(\"not yet available\");\n    });\n\n    // --- loadDescriptors ---\n\n    test(\"loadDescriptors returns descriptors with genesis hashes for paseo\", async () => {\n        const descriptors = await loadDescriptors(\"paseo\");\n        expect(descriptors).toBeDefined();\n        expect(descriptors.assetHub).toBeDefined();\n        expect(descriptors.bulletin).toBeDefined();\n        expect(descriptors.individuality).toBeDefined();\n        expect(descriptors.assetHub.genesis).toBe(GENESIS.paseo_asset_hub);\n        expect(descriptors.bulletin.genesis).toBe(GENESIS.paseo_bulletin);\n        expect(descriptors.individuality.genesis).toBe(GENESIS.paseo_individuality);\n    });\n\n    // --- AVAILABLE_ENVIRONMENTS ---\n\n    test(\"paseo is currently available\", () => {\n        expect(AVAILABLE_ENVIRONMENTS.has(\"paseo\")).toBe(true);\n        expect(AVAILABLE_ENVIRONMENTS.has(\"polkadot\")).toBe(false);\n        expect(AVAILABLE_ENVIRONMENTS.has(\"kusama\")).toBe(false);\n    });\n}\n","/**\n * Genesis hashes of well-known chains.\n *\n * Mirrors `WellKnownChain` from `@novasamatech/host-api-wrapper`. Hand-copied\n * (not re-exported) so chain-client doesn't pick up a direct Novasama\n * runtime dependency; genesis hashes are immutable so drift is impossible.\n */\nexport const WellKnownChain = {\n    polkadotRelay: \"0x91b171bb158e2d3848fa23a9f1c25182fb8e20313b2c1eb49219da7a70ce90c3\",\n    polkadotAssetHub: \"0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f\",\n    kusamaRelay: \"0xb0a8d493285c2df73290dfb7e61f870f17b41801197a149ca93654499ea3dafe\",\n    kusamaAssetHub: \"0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a\",\n    westendRelay: \"0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e\",\n    westendAssetHub: \"0x67f9723393ef76214df0118c34bbbd3dbebc8ed46a10973a8c969d48fe7598c9\",\n    rococo: \"0x6408de7737c59c238890533af25896a2c20608d8b380bb01029acb392781063e\",\n} as const;\n\n/** Genesis hash of a well-known chain - the value type of {@link WellKnownChain}. */\nexport type WellKnownChainHash = (typeof WellKnownChain)[keyof typeof WellKnownChain];\n\nif (import.meta.vitest) {\n    const { test, expect } = import.meta.vitest;\n\n    test(\"WellKnownChain entries are 0x-prefixed 32-byte hex strings\", () => {\n        for (const hash of Object.values(WellKnownChain)) {\n            expect(hash).toMatch(/^0x[0-9a-f]{64}$/);\n        }\n    });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-sdk-chain-client",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Multi-chain Polkadot API client with typed access to Asset Hub, Bulletin, and other chains",
   "type": "module",
   "sideEffects": false,
@@ -19,9 +19,9 @@
   ],
   "dependencies": {
     "polkadot-api": "^2.1.2",
+    "@parity/product-sdk-descriptors": "0.5.0",
     "@parity/product-sdk-logger": "0.1.1",
-    "@parity/product-sdk-descriptors": "0.4.0",
-    "@parity/product-sdk-host": "0.3.0"
+    "@parity/product-sdk-host": "0.5.0"
   },
   "devDependencies": {
     "tsup": "^8.4.0",

package/src/index.ts

@@ -20,5 +20,9 @@ export type { Environment, PresetChains } from "./presets.js";
 // Types
 export type { ChainClient, ChainClientConfig, ChainEntry } from "./types.js";
 
+// Well-known chain genesis hashes
+export { WellKnownChain } from "./well-known-chain.js";
+export type { WellKnownChainHash } from "./well-known-chain.js";
+
 // Re-export from host
 export { isInsideContainer, isInsideContainerSync } from "@parity/product-sdk-host";

package/src/presets.ts

@@ -11,17 +11,14 @@ import type { ChainClient } from "./types.js";
 import type { polkadot_asset_hub as PolkadotAssetHubDef } from "@parity/product-sdk-descriptors/polkadot-asset-hub";
 import type { kusama_asset_hub as KusamaAssetHubDef } from "@parity/product-sdk-descriptors/kusama-asset-hub";
 import type { paseo_asset_hub as PaseoAssetHubDef } from "@parity/product-sdk-descriptors/paseo-asset-hub";
-import type { previewnet_asset_hub as PreviewnetAssetHubDef } from "@parity/product-sdk-descriptors/previewnet-asset-hub";
 import type { paseo_bulletin as PaseoBulletinDef } from "@parity/product-sdk-descriptors/paseo-bulletin";
-import type { previewnet_bulletin as PreviewnetBulletinDef } from "@parity/product-sdk-descriptors/previewnet-bulletin";
 import type { paseo_individuality as PaseoIndividualityDef } from "@parity/product-sdk-descriptors/paseo-individuality";
-import type { previewnet_individuality as PreviewnetIndividualityDef } from "@parity/product-sdk-descriptors/previewnet-individuality";
 
 /** Known network environment with built-in descriptors and RPC endpoints. */
-export type Environment = "polkadot" | "kusama" | "paseo" | "previewnet";
+export type Environment = "polkadot" | "kusama" | "paseo";
 
 /** Environments where all chains (asset hub, bulletin, individuality) are live. */
-const AVAILABLE_ENVIRONMENTS: Set<Environment> = new Set(["paseo", "previewnet"]);
+const AVAILABLE_ENVIRONMENTS: Set<Environment> = new Set(["paseo"]);
 
 const rpcs = {
     polkadot: {
@@ -45,11 +42,6 @@ const rpcs = {
         bulletin: [...BULLETIN_RPCS.paseo],
         individuality: ["wss://paseo-people-next-system-rpc.polkadot.io"],
     },
-    previewnet: {
-        assetHub: ["wss://previewnet.substrate.dev/asset-hub"],
-        bulletin: [...BULLETIN_RPCS.previewnet],
-        individuality: ["wss://previewnet.substrate.dev/people"],
-    },
 } as const;
 
 /**
@@ -82,40 +74,22 @@ async function loadDescriptors(env: Environment) {
                 import("@parity/product-sdk-descriptors/paseo-bulletin"),
                 import("@parity/product-sdk-descriptors/paseo-individuality"),
             ]),
-        previewnet: () =>
-            Promise.all([
-                import("@parity/product-sdk-descriptors/previewnet-asset-hub"),
-                import("@parity/product-sdk-descriptors/previewnet-bulletin"),
-                import("@parity/product-sdk-descriptors/previewnet-individuality"),
-            ]),
     };
 
     const [ahMod, bulletinMod, individualityMod] = await loaders[env]();
 
-    // Extract the named exports — varies per environment. The fallback casts use
-    // narrow shape types (not the full `typeof import(...)`) to keep formatter
-    // wrap behavior compatible with esbuild's parser.
     const assetHub =
         "polkadot_asset_hub" in ahMod
             ? ahMod.polkadot_asset_hub
             : "kusama_asset_hub" in ahMod
               ? ahMod.kusama_asset_hub
-              : "paseo_asset_hub" in ahMod
-                ? ahMod.paseo_asset_hub
-                : (ahMod as { previewnet_asset_hub: typeof PreviewnetAssetHubDef })
-                      .previewnet_asset_hub;
+              : (ahMod as { paseo_asset_hub: typeof PaseoAssetHubDef }).paseo_asset_hub;
 
-    const bulletin =
-        "paseo_bulletin" in bulletinMod
-            ? bulletinMod.paseo_bulletin
-            : (bulletinMod as { previewnet_bulletin: typeof PreviewnetBulletinDef })
-                  .previewnet_bulletin;
+    const bulletin = (bulletinMod as { paseo_bulletin: typeof PaseoBulletinDef }).paseo_bulletin;
 
-    const individuality =
-        "paseo_individuality" in individualityMod
-            ? individualityMod.paseo_individuality
-            : (individualityMod as { previewnet_individuality: typeof PreviewnetIndividualityDef })
-                  .previewnet_individuality;
+    const individuality = (
+        individualityMod as { paseo_individuality: typeof PaseoIndividualityDef }
+    ).paseo_individuality;
 
     return { assetHub, bulletin, individuality };
 }
@@ -139,11 +113,6 @@ type PresetDescriptors = {
         bulletin: typeof PaseoBulletinDef;
         individuality: typeof PaseoIndividualityDef;
     };
-    previewnet: {
-        assetHub: typeof PreviewnetAssetHubDef;
-        bulletin: typeof PreviewnetBulletinDef;
-        individuality: typeof PreviewnetIndividualityDef;
-    };
 };
 
 /** The chain shape returned by {@link getChainAPI} for a given environment. */
@@ -206,19 +175,12 @@ if (import.meta.vitest) {
     const { destroyAll } = await import("./clients.js");
 
     // Test-only genesis hashes for assertion — not used in production code.
-    // Each chain has a per-environment genesis: bulletin and individuality
-    // are distinct chain instances across paseo and previewnet (same runtime,
-    // separate deployments).
     const GENESIS = {
         polkadot_asset_hub: "0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f",
         kusama_asset_hub: "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a",
         paseo_asset_hub: "0x173cea9df45656cf612c8b8ece56e04e9a693c69cfaac47d3628dae735067af8",
-        previewnet_asset_hub: "0x860d75a890388e2ad02c54aa451264d04af89765773a51cd56868b4293c7867c",
         paseo_bulletin: "0x8cfe6717dc4becfda2e13c488a1e2061ff2dfee96e7d031157f72d36716c0a22",
-        previewnet_bulletin: "0xf37fa1f1450ea120edbf64c3fc447f671a00e1f1095a698f42eeec073c7ee487",
         paseo_individuality: "0x053e1a785bb0990b98768124d9609e963d9ca3558f5ac6e90a4297aaa0a0bd4b",
-        previewnet_individuality:
-            "0xbf3a38ecba96d2f647bc12198011b9e4f0ba3a7e2a190597205cbe238f5c125d",
     } as const;
 
     beforeEach(() => {
@@ -236,7 +198,7 @@ if (import.meta.vitest) {
     // --- RPC config ---
 
     test("rpcs defined for all environments", () => {
-        for (const env of ["polkadot", "kusama", "paseo", "previewnet"] as const) {
+        for (const env of ["polkadot", "kusama", "paseo"] as const) {
             const envRpcs = rpcs[env];
             expect(envRpcs.assetHub.length).toBeGreaterThan(0);
         }
@@ -248,12 +210,6 @@ if (import.meta.vitest) {
         expect(envRpcs.individuality.length).toBeGreaterThan(0);
     });
 
-    test("previewnet has RPCs for all chains", () => {
-        const envRpcs = rpcs.previewnet;
-        expect(envRpcs.bulletin.length).toBeGreaterThan(0);
-        expect(envRpcs.individuality.length).toBeGreaterThan(0);
-    });
-
     // --- getChainAPI ---
 
     test("polkadot and kusama throw as not yet available", async () => {
@@ -274,38 +230,10 @@ if (import.meta.vitest) {
         expect(descriptors.individuality.genesis).toBe(GENESIS.paseo_individuality);
     });
 
-    test("loadDescriptors returns descriptors with genesis hashes for previewnet", async () => {
-        const descriptors = await loadDescriptors("previewnet");
-        expect(descriptors).toBeDefined();
-        expect(descriptors.assetHub).toBeDefined();
-        expect(descriptors.bulletin).toBeDefined();
-        expect(descriptors.individuality).toBeDefined();
-        expect(descriptors.assetHub.genesis).toBe(GENESIS.previewnet_asset_hub);
-        expect(descriptors.bulletin.genesis).toBe(GENESIS.previewnet_bulletin);
-        expect(descriptors.individuality.genesis).toBe(GENESIS.previewnet_individuality);
-    });
-
-    test("loadDescriptors returns environment-specific descriptors for every chain", async () => {
-        const paseo = await loadDescriptors("paseo");
-        const previewnet = await loadDescriptors("previewnet");
-        // asset-hub: paseo and previewnet are different runtimes (different chains)
-        expect(paseo.assetHub.genesis).toBe(GENESIS.paseo_asset_hub);
-        expect(previewnet.assetHub.genesis).toBe(GENESIS.previewnet_asset_hub);
-        // bulletin: same runtime, different chain instances → distinct genesis
-        expect(paseo.bulletin.genesis).toBe(GENESIS.paseo_bulletin);
-        expect(previewnet.bulletin.genesis).toBe(GENESIS.previewnet_bulletin);
-        expect(paseo.bulletin.genesis).not.toBe(previewnet.bulletin.genesis);
-        // individuality: same runtime, different chain instances → distinct genesis
-        expect(paseo.individuality.genesis).toBe(GENESIS.paseo_individuality);
-        expect(previewnet.individuality.genesis).toBe(GENESIS.previewnet_individuality);
-        expect(paseo.individuality.genesis).not.toBe(previewnet.individuality.genesis);
-    });
-
     // --- AVAILABLE_ENVIRONMENTS ---
 
-    test("paseo and previewnet are currently available", () => {
+    test("paseo is currently available", () => {
         expect(AVAILABLE_ENVIRONMENTS.has("paseo")).toBe(true);
-        expect(AVAILABLE_ENVIRONMENTS.has("previewnet")).toBe(true);
         expect(AVAILABLE_ENVIRONMENTS.has("polkadot")).toBe(false);
         expect(AVAILABLE_ENVIRONMENTS.has("kusama")).toBe(false);
     });

package/src/types.ts

@@ -1,7 +1,7 @@
 import type { ChainDefinition, PolkadotClient, TypedApi } from "polkadot-api";
 
 /** Supported chain environments for the Polkadot ecosystem. */
-export type Environment = "polkadot" | "kusama" | "paseo" | "previewnet" | "local" | "westend";
+export type Environment = "polkadot" | "kusama" | "paseo" | "local" | "westend";
 
 /**
  * Configuration for {@link createChainClient}.

package/src/well-known-chain.ts

@@ -0,0 +1,29 @@
+/**
+ * Genesis hashes of well-known chains.
+ *
+ * Mirrors `WellKnownChain` from `@novasamatech/host-api-wrapper`. Hand-copied
+ * (not re-exported) so chain-client doesn't pick up a direct Novasama
+ * runtime dependency; genesis hashes are immutable so drift is impossible.
+ */
+export const WellKnownChain = {
+    polkadotRelay: "0x91b171bb158e2d3848fa23a9f1c25182fb8e20313b2c1eb49219da7a70ce90c3",
+    polkadotAssetHub: "0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f",
+    kusamaRelay: "0xb0a8d493285c2df73290dfb7e61f870f17b41801197a149ca93654499ea3dafe",
+    kusamaAssetHub: "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a",
+    westendRelay: "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
+    westendAssetHub: "0x67f9723393ef76214df0118c34bbbd3dbebc8ed46a10973a8c969d48fe7598c9",
+    rococo: "0x6408de7737c59c238890533af25896a2c20608d8b380bb01029acb392781063e",
+} as const;
+
+/** Genesis hash of a well-known chain - the value type of {@link WellKnownChain}. */
+export type WellKnownChainHash = (typeof WellKnownChain)[keyof typeof WellKnownChain];
+
+if (import.meta.vitest) {
+    const { test, expect } = import.meta.vitest;
+
+    test("WellKnownChain entries are 0x-prefixed 32-byte hex strings", () => {
+        for (const hash of Object.values(WellKnownChain)) {
+            expect(hash).toMatch(/^0x[0-9a-f]{64}$/);
+        }
+    });
+}