@parity/product-sdk-chain-client 0.5.2 → 0.6.0

package/dist/index.d.ts

@@ -4,16 +4,13 @@ import { kusama_asset_hub } from '@parity/product-sdk-descriptors/kusama-asset-h
 import { paseo_asset_hub } from '@parity/product-sdk-descriptors/paseo-asset-hub';
 import { paseo_bulletin } from '@parity/product-sdk-descriptors/paseo-bulletin';
 import { paseo_individuality } from '@parity/product-sdk-descriptors/paseo-individuality';
-export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
+export { ChainNotSupportedError, isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
 
 /**
  * Configuration for {@link createChainClient}.
  *
- * Provide named chain descriptors and their RPC endpoints.
- * TypeScript enforces that `rpcs` has the same keys as `chains`.
- *
- * Note: The SDK routes all connections through the host provider. The `rpcs`
- * field is currently unused but kept for API compatibility.
+ * Provide named chain descriptors. The SDK routes all connections through the
+ * host provider, so no RPC endpoints are required.
  *
  * @typeParam TChains - Record mapping user-chosen chain names to PAPI descriptors.
  *
@@ -25,20 +22,12 @@ export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-ho
  *
  * const client = await createChainClient({
  *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
- *     rpcs: {
- *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
- *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
- *     },
  * });
  * ```
  */
 interface ChainClientConfig<TChains extends Record<string, ChainDefinition> = Record<string, ChainDefinition>> {
     /** Named chain descriptors (PAPI `ChainDefinition` objects). */
     chains: TChains;
-    /** RPC endpoints per chain name (currently unused - connections route through host). */
-    rpcs: {
-        [K in keyof TChains]: readonly string[];
-    };
 }
 /**
  * A connected chain client returned by {@link createChainClient}.
@@ -83,9 +72,6 @@ interface ChainEntry {
  * is designed to run exclusively inside a host container (Polkadot Browser / Desktop).
  * Throws if no host provider is available; there is no direct-WebSocket fallback.
  *
- * The `config.rpcs` field is currently unused at runtime (kept for API compatibility
- * and BYOD documentation), since the host owns the chain connection.
- *
  * Results are cached by genesis-hash fingerprint — calling with the same descriptors
  * returns the same instance.
  *
@@ -97,10 +83,6 @@ interface ChainEntry {
  *
  * const client = await createChainClient({
  *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
- *     rpcs: {
- *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
- *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
- *     },
  * });
  *
  * // Fully typed from your descriptors
@@ -138,7 +120,7 @@ declare function getClient(descriptor: ChainDefinition): PolkadotClient;
  */
 declare function isConnected(descriptor: ChainDefinition): boolean;
 
-/** Known network environment with built-in descriptors and RPC endpoints. */
+/** Known network environment with built-in descriptors. */
 type Environment = "polkadot" | "kusama" | "paseo";
 /** Per-environment descriptor types for each chain in the preset. */
 type PresetDescriptors = {
@@ -161,7 +143,7 @@ type PresetDescriptors = {
 /** The chain shape returned by {@link getChainAPI} for a given environment. */
 type PresetChains<E extends Environment> = PresetDescriptors[E];
 /**
- * Get a chain client for a known environment with built-in descriptors and RPCs.
+ * Get a chain client for a known environment with built-in descriptors.
  *
  * This is the **zero-config** path — no need to import descriptors or specify
  * endpoints. For custom chains or BYOD descriptors, use

package/dist/index.js

@@ -1,6 +1,7 @@
 import { createClient } from 'polkadot-api';
-import { BULLETIN_RPCS, getHostProvider } from '@parity/product-sdk-host';
-export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
+import { createLogger } from '@parity/product-sdk-logger';
+import { ChainNotSupportedError, getHostProvider } from '@parity/product-sdk-host';
+export { ChainNotSupportedError, isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
 
 // src/clients.ts
 async function createProvider(genesisHash) {
@@ -30,6 +31,19 @@ function clearClientCache() {
 }
 
 // src/clients.ts
+var log = createLogger("chain-client");
+function unsupportedChainApi(error) {
+  const handler = {
+    get: () => {
+      throw error;
+    },
+    apply: () => {
+      throw error;
+    }
+  };
+  return new Proxy((() => {
+  }), handler);
+}
 var cacheKey = (fingerprint, genesis) => `${fingerprint}:${genesis}`;
 function findEntryByGenesis(genesis) {
   for (const [key, entry] of getClientCache()) {
@@ -71,23 +85,40 @@ async function initChainClient(config, fingerprint) {
       if (!genesis) {
         throw new Error(`Descriptor for chain "${name}" has no genesis hash.`);
       }
-      const provider = await createProvider(genesis);
-      const client = createClient(provider);
-      const key = cacheKey(fingerprint, genesis);
-      if (!clientCache.has(key)) {
-        clientCache.set(key, {
-          client,
-          api: /* @__PURE__ */ new Map()
-        });
+      try {
+        const provider = await createProvider(genesis);
+        const client = createClient(provider);
+        const key = cacheKey(fingerprint, genesis);
+        if (!clientCache.has(key)) {
+          clientCache.set(key, {
+            client,
+            api: /* @__PURE__ */ new Map()
+          });
+        }
+        return { name, descriptor, client, genesis, error: void 0 };
+      } catch (err) {
+        if (err instanceof ChainNotSupportedError) {
+          log.warn(
+            `Chain "${name}" is not supported by the host; its API will throw on use.`,
+            { genesis }
+          );
+          return { name, descriptor, client: null, genesis, error: err };
+        }
+        throw err;
       }
-      return { name, descriptor, client, genesis };
     })
   );
   const apis = {};
   const raw = {};
-  for (const { name, descriptor, client } of entries) {
-    apis[name] = client.getTypedApi(descriptor);
-    raw[name] = client;
+  for (const { name, descriptor, client, error } of entries) {
+    if (client) {
+      apis[name] = client.getTypedApi(descriptor);
+      raw[name] = client;
+    } else {
+      const api = unsupportedChainApi(error);
+      apis[name] = api;
+      raw[name] = api;
+    }
   }
   return {
     ...apis,
@@ -128,30 +159,9 @@ function isConnected(descriptor) {
   if (!genesis) return false;
   return findEntryByGenesis(genesis) !== void 0;
 }
+
+// src/presets.ts
 var AVAILABLE_ENVIRONMENTS = /* @__PURE__ */ new Set(["paseo"]);
-var rpcs = {
-  polkadot: {
-    assetHub: [
-      "wss://polkadot-asset-hub-rpc.polkadot.io",
-      "wss://sys.ibp.network/asset-hub-polkadot"
-    ],
-    bulletin: [...BULLETIN_RPCS.polkadot],
-    individuality: []
-  },
-  kusama: {
-    assetHub: [
-      "wss://kusama-asset-hub-rpc.polkadot.io",
-      "wss://sys.ibp.network/asset-hub-kusama"
-    ],
-    bulletin: [...BULLETIN_RPCS.kusama],
-    individuality: []
-  },
-  paseo: {
-    assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
-    bulletin: [...BULLETIN_RPCS.paseo],
-    individuality: ["wss://paseo-people-next-system-rpc.polkadot.io"]
-  }
-};
 async function loadDescriptors(env) {
   const loaders = {
     polkadot: () => Promise.all([
@@ -183,17 +193,11 @@ async function getChainAPI(env) {
     throw new Error(`Chain API for "${env}" is not yet available`);
   }
   const descriptors = await loadDescriptors(env);
-  const envRpcs = rpcs[env];
   return createChainClient({
     chains: {
       assetHub: descriptors.assetHub,
       bulletin: descriptors.bulletin,
       individuality: descriptors.individuality
-    },
-    rpcs: {
-      assetHub: [...envRpcs.assetHub],
-      bulletin: [...envRpcs.bulletin],
-      individuality: [...envRpcs.individuality]
     }
   });
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"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":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport { 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","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport 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","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport 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","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport 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: \"0xbf0488dbe9daa1de1c08c5f743e26fdc2a4ecd74cf87dd1b4b1eeb99ae4ef19f\",\n        paseo_bulletin: \"0x8cfe6717dc4becfda2e13c488a1e2061ff2dfee96e7d031157f72d36716c0a22\",\n        paseo_individuality: \"0xc5af1826b31493f08b7e2a823842f98575b806a784126f28da9608c68665afa5\",\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","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\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"]}
+{"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":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport { 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        hostProviderError: null as Error | null,\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.hostProviderError) throw state.hostProviderError;\n            if (!state.hostProviderAvailable) return null;\n            return state.fakeProvider;\n        },\n    }));\n\n    beforeEach(() => {\n        state.hostProviderCalls = [];\n        state.hostProviderAvailable = true;\n        state.hostProviderError = null;\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    test(\"propagates ChainNotSupportedError from the host provider\", async () => {\n        const { ChainNotSupportedError } = await import(\"@parity/product-sdk-host\");\n        state.hostProviderError = new ChainNotSupportedError(\"0xabc\");\n        // The unsupported-chain error must surface to the caller rather than being\n        // collapsed into the generic \"unavailable\" path or swallowed.\n        await expect(createProvider(\"0xabc\")).rejects.toBeInstanceOf(ChainNotSupportedError);\n    });\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport 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","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport type { ChainDefinition, PolkadotClient } from \"polkadot-api\";\nimport { createClient } from \"polkadot-api\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport { ChainNotSupportedError } from \"@parity/product-sdk-host\";\nimport { createProvider } from \"./providers.js\";\nimport { getClientCache, clearClientCache } from \"./hmr.js\";\nimport type { ChainEntry, ChainClientConfig, ChainClient } from \"./types.js\";\n\nconst log = createLogger(\"chain-client\");\n\n/**\n * Build a stand-in for a chain the host can't serve. Any property access (e.g.\n * `.query`, `.tx`) or call throws the original {@link ChainNotSupportedError},\n * so touching an unsupported chain surfaces a clear, detectable error rather\n * than hanging — without tanking the supported chains in the same client.\n */\nfunction unsupportedChainApi(error: ChainNotSupportedError): never {\n    const handler: ProxyHandler<() => void> = {\n        get: () => {\n            throw error;\n        },\n        apply: () => {\n            throw error;\n        },\n    };\n    return new Proxy((() => {}) as () => void, handler) as never;\n}\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 * 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 * });\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            try {\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, error: undefined };\n            } catch (err) {\n                // A chain the host can't serve must not tank the whole multi-chain\n                // client — the supported chains stay usable, and this one surfaces a\n                // clear error on first use instead of hanging. Any other failure\n                // (e.g. not inside a container) is a hard error and still rejects.\n                if (err instanceof ChainNotSupportedError) {\n                    log.warn(\n                        `Chain \"${name}\" is not supported by the host; its API will throw on use.`,\n                        { genesis },\n                    );\n                    return { name, descriptor, client: null, genesis, error: err };\n                }\n                throw err;\n            }\n        }),\n    );\n\n    // Build typed APIs and raw client map. Unsupported chains get a stand-in\n    // whose access throws the original ChainNotSupportedError.\n    const apis = {} as Record<string, unknown>;\n    const raw = {} as Record<string, PolkadotClient>;\n\n    for (const { name, descriptor, client, error } of entries) {\n        if (client) {\n            apis[name] = client.getTypedApi(descriptor);\n            raw[name] = client;\n        } else {\n            const api = unsupportedChainApi(error as ChainNotSupportedError);\n            apis[name] = api;\n            raw[name] = api as unknown as PolkadotClient;\n        }\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, vi } = import.meta.vitest;\n\n    // Mock the provider + PAPI client factories so initChainClient can run without\n    // a real host. Tests that pre-seed clientInstances short-circuit before these.\n    vi.mock(\"./providers.js\", () => ({ createProvider: vi.fn() }));\n    vi.mock(\"polkadot-api\", async (importOriginal) => ({\n        ...(await importOriginal<typeof import(\"polkadot-api\")>()),\n        createClient: vi.fn(),\n    }));\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        });\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 } }),\n            createChainClient({ chains: { x: fakeDescriptor } }),\n        ]);\n        expect(a).toBe(b);\n    });\n\n    test(\"createChainClient keeps supported chains usable and defers unsupported-chain errors\", async () => {\n        // initChainClient runs for real here — drive the mocked factories.\n        const { createProvider } = await import(\"./providers.js\");\n        const { createClient } = await import(\"polkadot-api\");\n        const fakeTyped = { query: {} };\n        vi.mocked(createClient).mockReturnValue({\n            getTypedApi: () => fakeTyped,\n            destroy: () => {},\n        } as unknown as PolkadotClient);\n        vi.mocked(createProvider).mockImplementation(async (genesis: string) => {\n            if (genesis === \"0xbad\") throw new ChainNotSupportedError(genesis);\n            return (() => {}) as never;\n        });\n\n        const good = { genesis: \"0xgood\" } as ChainDefinition;\n        const bad = { genesis: \"0xbad\" } as ChainDefinition;\n        const client = (await createChainClient({\n            chains: { good, bad },\n        })) as any;\n\n        // The whole client still resolves; the supported chain is fully usable.\n        expect(client.good).toBe(fakeTyped);\n        // The unsupported chain surfaces the original error on use — no hang.\n        expect(() => client.bad.query).toThrow(ChainNotSupportedError);\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 } });\n        const b = await createChainClient({ chains: { b: descB } });\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","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport type { ChainDefinition } from \"polkadot-api\";\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. */\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\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.\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\n    return createChainClient({\n        chains: {\n            assetHub: descriptors.assetHub,\n            bulletin: descriptors.bulletin,\n            individuality: descriptors.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: \"0xbf0488dbe9daa1de1c08c5f743e26fdc2a4ecd74cf87dd1b4b1eeb99ae4ef19f\",\n        paseo_bulletin: \"0x8cfe6717dc4becfda2e13c488a1e2061ff2dfee96e7d031157f72d36716c0a22\",\n        paseo_individuality: \"0xc5af1826b31493f08b7e2a823842f98575b806a784126f28da9608c68665afa5\",\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    // --- 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","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\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.5.2",
+  "version": "0.6.0",
   "description": "Multi-chain Polkadot API client with typed access to Asset Hub, Bulletin, and other chains",
   "type": "module",
   "sideEffects": false,
@@ -18,13 +18,13 @@
     "src"
   ],
   "dependencies": {
-    "polkadot-api": "^2.1.2",
-    "@parity/product-sdk-descriptors": "0.5.1",
+    "polkadot-api": "^2.1.5",
+    "@parity/product-sdk-host": "0.7.0",
     "@parity/product-sdk-logger": "0.1.1",
-    "@parity/product-sdk-host": "0.6.0"
+    "@parity/product-sdk-descriptors": "0.5.2"
   },
   "devDependencies": {
-    "tsup": "^8.4.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^3.1.4"
   },

package/src/clients.ts

@@ -2,10 +2,32 @@
 // SPDX-License-Identifier: Apache-2.0
 import type { ChainDefinition, PolkadotClient } from "polkadot-api";
 import { createClient } from "polkadot-api";
+import { createLogger } from "@parity/product-sdk-logger";
+import { ChainNotSupportedError } from "@parity/product-sdk-host";
 import { createProvider } from "./providers.js";
 import { getClientCache, clearClientCache } from "./hmr.js";
 import type { ChainEntry, ChainClientConfig, ChainClient } from "./types.js";
 
+const log = createLogger("chain-client");
+
+/**
+ * Build a stand-in for a chain the host can't serve. Any property access (e.g.
+ * `.query`, `.tx`) or call throws the original {@link ChainNotSupportedError},
+ * so touching an unsupported chain surfaces a clear, detectable error rather
+ * than hanging — without tanking the supported chains in the same client.
+ */
+function unsupportedChainApi(error: ChainNotSupportedError): never {
+    const handler: ProxyHandler<() => void> = {
+        get: () => {
+            throw error;
+        },
+        apply: () => {
+            throw error;
+        },
+    };
+    return new Proxy((() => {}) as () => void, handler) as never;
+}
+
 // Cache keys are scoped by a fingerprint of the config so that two
 // `createChainClient` calls with different chain sets don't collide.
 const cacheKey = (fingerprint: string, genesis: string) => `${fingerprint}:${genesis}`;
@@ -34,9 +56,6 @@ function configFingerprint(chains: Record<string, ChainDefinition>): string {
  * is designed to run exclusively inside a host container (Polkadot Browser / Desktop).
  * Throws if no host provider is available; there is no direct-WebSocket fallback.
  *
- * The `config.rpcs` field is currently unused at runtime (kept for API compatibility
- * and BYOD documentation), since the host owns the chain connection.
- *
  * Results are cached by genesis-hash fingerprint — calling with the same descriptors
  * returns the same instance.
  *
@@ -48,10 +67,6 @@ function configFingerprint(chains: Record<string, ChainDefinition>): string {
  *
  * const client = await createChainClient({
  *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
- *     rpcs: {
- *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
- *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
- *     },
  * });
  *
  * // Fully typed from your descriptors
@@ -111,29 +126,51 @@ async function initChainClient<const TChains extends Record<string, ChainDefinit
             if (!genesis) {
                 throw new Error(`Descriptor for chain "${name}" has no genesis hash.`);
             }
-            const provider = await createProvider(genesis);
-            const client = createClient(provider);
-
-            // Populate HMR cache so getClient() and isConnected() work
-            const key = cacheKey(fingerprint, genesis);
-            if (!clientCache.has(key)) {
-                clientCache.set(key, {
-                    client,
-                    api: new Map(),
-                } satisfies ChainEntry);
-            }
+            try {
+                const provider = await createProvider(genesis);
+                const client = createClient(provider);
 
-            return { name, descriptor, client, genesis };
+                // Populate HMR cache so getClient() and isConnected() work
+                const key = cacheKey(fingerprint, genesis);
+                if (!clientCache.has(key)) {
+                    clientCache.set(key, {
+                        client,
+                        api: new Map(),
+                    } satisfies ChainEntry);
+                }
+
+                return { name, descriptor, client, genesis, error: undefined };
+            } catch (err) {
+                // A chain the host can't serve must not tank the whole multi-chain
+                // client — the supported chains stay usable, and this one surfaces a
+                // clear error on first use instead of hanging. Any other failure
+                // (e.g. not inside a container) is a hard error and still rejects.
+                if (err instanceof ChainNotSupportedError) {
+                    log.warn(
+                        `Chain "${name}" is not supported by the host; its API will throw on use.`,
+                        { genesis },
+                    );
+                    return { name, descriptor, client: null, genesis, error: err };
+                }
+                throw err;
+            }
         }),
     );
 
-    // Build typed APIs and raw client map
+    // Build typed APIs and raw client map. Unsupported chains get a stand-in
+    // whose access throws the original ChainNotSupportedError.
     const apis = {} as Record<string, unknown>;
     const raw = {} as Record<string, PolkadotClient>;
 
-    for (const { name, descriptor, client } of entries) {
-        apis[name] = client.getTypedApi(descriptor);
-        raw[name] = client;
+    for (const { name, descriptor, client, error } of entries) {
+        if (client) {
+            apis[name] = client.getTypedApi(descriptor);
+            raw[name] = client;
+        } else {
+            const api = unsupportedChainApi(error as ChainNotSupportedError);
+            apis[name] = api;
+            raw[name] = api as unknown as PolkadotClient;
+        }
     }
 
     return {
@@ -199,7 +236,15 @@ export function isConnected(descriptor: ChainDefinition): boolean {
 }
 
 if (import.meta.vitest) {
-    const { test, expect, beforeEach } = import.meta.vitest;
+    const { test, expect, beforeEach, vi } = import.meta.vitest;
+
+    // Mock the provider + PAPI client factories so initChainClient can run without
+    // a real host. Tests that pre-seed clientInstances short-circuit before these.
+    vi.mock("./providers.js", () => ({ createProvider: vi.fn() }));
+    vi.mock("polkadot-api", async (importOriginal) => ({
+        ...(await importOriginal<typeof import("polkadot-api")>()),
+        createClient: vi.fn(),
+    }));
 
     const fakeDescriptor = { genesis: "0xtest" } as ChainDefinition;
     const fakeClient = {
@@ -275,7 +320,6 @@ if (import.meta.vitest) {
         clientInstances.set(fp, Promise.resolve(fakeResult));
         const result = await createChainClient({
             chains: { a: fakeDescriptor },
-            rpcs: { a: [] },
         });
         expect(result).toBe(fakeResult);
     });
@@ -285,12 +329,38 @@ if (import.meta.vitest) {
         const fp = configFingerprint({ x: fakeDescriptor });
         clientInstances.set(fp, Promise.resolve(fakeResult));
         const [a, b] = await Promise.all([
-            createChainClient({ chains: { x: fakeDescriptor }, rpcs: { x: [] } }),
-            createChainClient({ chains: { x: fakeDescriptor }, rpcs: { x: [] } }),
+            createChainClient({ chains: { x: fakeDescriptor } }),
+            createChainClient({ chains: { x: fakeDescriptor } }),
         ]);
         expect(a).toBe(b);
     });
 
+    test("createChainClient keeps supported chains usable and defers unsupported-chain errors", async () => {
+        // initChainClient runs for real here — drive the mocked factories.
+        const { createProvider } = await import("./providers.js");
+        const { createClient } = await import("polkadot-api");
+        const fakeTyped = { query: {} };
+        vi.mocked(createClient).mockReturnValue({
+            getTypedApi: () => fakeTyped,
+            destroy: () => {},
+        } as unknown as PolkadotClient);
+        vi.mocked(createProvider).mockImplementation(async (genesis: string) => {
+            if (genesis === "0xbad") throw new ChainNotSupportedError(genesis);
+            return (() => {}) as never;
+        });
+
+        const good = { genesis: "0xgood" } as ChainDefinition;
+        const bad = { genesis: "0xbad" } as ChainDefinition;
+        const client = (await createChainClient({
+            chains: { good, bad },
+        })) as any;
+
+        // The whole client still resolves; the supported chain is fully usable.
+        expect(client.good).toBe(fakeTyped);
+        // The unsupported chain surfaces the original error on use — no hang.
+        expect(() => client.bad.query).toThrow(ChainNotSupportedError);
+    });
+
     test("createChainClient returns different results for different configs", async () => {
         const descA = { genesis: "0xaaa" } as ChainDefinition;
         const descB = { genesis: "0xbbb" } as ChainDefinition;
@@ -298,8 +368,8 @@ if (import.meta.vitest) {
         const resultB = {} as ChainClient<any>;
         clientInstances.set(configFingerprint({ a: descA }), Promise.resolve(resultA));
         clientInstances.set(configFingerprint({ b: descB }), Promise.resolve(resultB));
-        const a = await createChainClient({ chains: { a: descA }, rpcs: { a: [] } });
-        const b = await createChainClient({ chains: { b: descB }, rpcs: { b: [] } });
+        const a = await createChainClient({ chains: { a: descA } });
+        const b = await createChainClient({ chains: { b: descB } });
         expect(a).not.toBe(b);
     });
 

package/src/index.ts

@@ -27,4 +27,8 @@ 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";
+export {
+    isInsideContainer,
+    isInsideContainerSync,
+    ChainNotSupportedError,
+} from "@parity/product-sdk-host";

package/src/presets.ts

@@ -1,7 +1,6 @@
 // Copyright 2026 Parity Technologies (UK) Ltd.
 // SPDX-License-Identifier: Apache-2.0
 import type { ChainDefinition } from "polkadot-api";
-import { BULLETIN_RPCS } from "@parity/product-sdk-host";
 import { createChainClient } from "./clients.js";
 import type { ChainClient } from "./types.js";
 
@@ -16,36 +15,12 @@ import type { paseo_asset_hub as PaseoAssetHubDef } from "@parity/product-sdk-de
 import type { paseo_bulletin as PaseoBulletinDef } from "@parity/product-sdk-descriptors/paseo-bulletin";
 import type { paseo_individuality as PaseoIndividualityDef } from "@parity/product-sdk-descriptors/paseo-individuality";
 
-/** Known network environment with built-in descriptors and RPC endpoints. */
+/** Known network environment with built-in descriptors. */
 export type Environment = "polkadot" | "kusama" | "paseo";
 
 /** Environments where all chains (asset hub, bulletin, individuality) are live. */
 const AVAILABLE_ENVIRONMENTS: Set<Environment> = new Set(["paseo"]);
 
-const rpcs = {
-    polkadot: {
-        assetHub: [
-            "wss://polkadot-asset-hub-rpc.polkadot.io",
-            "wss://sys.ibp.network/asset-hub-polkadot",
-        ],
-        bulletin: [...BULLETIN_RPCS.polkadot],
-        individuality: [] as string[],
-    },
-    kusama: {
-        assetHub: [
-            "wss://kusama-asset-hub-rpc.polkadot.io",
-            "wss://sys.ibp.network/asset-hub-kusama",
-        ],
-        bulletin: [...BULLETIN_RPCS.kusama],
-        individuality: [] as string[],
-    },
-    paseo: {
-        assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
-        bulletin: [...BULLETIN_RPCS.paseo],
-        individuality: ["wss://paseo-people-next-system-rpc.polkadot.io"],
-    },
-} as const;
-
 /**
  * Lazy-load descriptors for a specific environment.
  *
@@ -121,7 +96,7 @@ type PresetDescriptors = {
 export type PresetChains<E extends Environment> = PresetDescriptors[E];
 
 /**
- * Get a chain client for a known environment with built-in descriptors and RPCs.
+ * Get a chain client for a known environment with built-in descriptors.
  *
  * This is the **zero-config** path — no need to import descriptors or specify
  * endpoints. For custom chains or BYOD descriptors, use
@@ -156,7 +131,6 @@ export async function getChainAPI<E extends Environment>(
     }
 
     const descriptors = await loadDescriptors(env);
-    const envRpcs = rpcs[env];
 
     return createChainClient({
         chains: {
@@ -164,11 +138,6 @@ export async function getChainAPI<E extends Environment>(
             bulletin: descriptors.bulletin,
             individuality: descriptors.individuality,
         },
-        rpcs: {
-            assetHub: [...envRpcs.assetHub],
-            bulletin: [...envRpcs.bulletin],
-            individuality: [...envRpcs.individuality],
-        },
     }) as Promise<ChainClient<PresetChains<E>>>;
 }
 
@@ -197,21 +166,6 @@ if (import.meta.vitest) {
         }
     });
 
-    // --- RPC config ---
-
-    test("rpcs defined for all environments", () => {
-        for (const env of ["polkadot", "kusama", "paseo"] as const) {
-            const envRpcs = rpcs[env];
-            expect(envRpcs.assetHub.length).toBeGreaterThan(0);
-        }
-    });
-
-    test("paseo has RPCs for all chains", () => {
-        const envRpcs = rpcs.paseo;
-        expect(envRpcs.bulletin.length).toBeGreaterThan(0);
-        expect(envRpcs.individuality.length).toBeGreaterThan(0);
-    });
-
     // --- getChainAPI ---
 
     test("polkadot and kusama throw as not yet available", async () => {

package/src/providers.ts

@@ -29,12 +29,14 @@ if (import.meta.vitest) {
         fakeProvider: (() => {}) as unknown as JsonRpcProvider,
         hostProviderCalls: [] as unknown[][],
         hostProviderAvailable: true,
+        hostProviderError: null as Error | null,
     }));
 
     vi.mock("@parity/product-sdk-host", async (importOriginal) => ({
         ...(await importOriginal<typeof import("@parity/product-sdk-host")>()),
         getHostProvider: async (...args: unknown[]) => {
             state.hostProviderCalls.push(args);
+            if (state.hostProviderError) throw state.hostProviderError;
             if (!state.hostProviderAvailable) return null;
             return state.fakeProvider;
         },
@@ -43,6 +45,7 @@ if (import.meta.vitest) {
     beforeEach(() => {
         state.hostProviderCalls = [];
         state.hostProviderAvailable = true;
+        state.hostProviderError = null;
     });
 
     test("returns host provider when available", async () => {
@@ -56,4 +59,12 @@ if (import.meta.vitest) {
         state.hostProviderAvailable = false;
         await expect(createProvider("0xabc")).rejects.toThrow(/Host provider unavailable/);
     });
+
+    test("propagates ChainNotSupportedError from the host provider", async () => {
+        const { ChainNotSupportedError } = await import("@parity/product-sdk-host");
+        state.hostProviderError = new ChainNotSupportedError("0xabc");
+        // The unsupported-chain error must surface to the caller rather than being
+        // collapsed into the generic "unavailable" path or swallowed.
+        await expect(createProvider("0xabc")).rejects.toBeInstanceOf(ChainNotSupportedError);
+    });
 }

package/src/types.ts

@@ -8,11 +8,8 @@ export type Environment = "polkadot" | "kusama" | "paseo" | "local" | "westend";
 /**
  * Configuration for {@link createChainClient}.
  *
- * Provide named chain descriptors and their RPC endpoints.
- * TypeScript enforces that `rpcs` has the same keys as `chains`.
- *
- * Note: The SDK routes all connections through the host provider. The `rpcs`
- * field is currently unused but kept for API compatibility.
+ * Provide named chain descriptors. The SDK routes all connections through the
+ * host provider, so no RPC endpoints are required.
  *
  * @typeParam TChains - Record mapping user-chosen chain names to PAPI descriptors.
  *
@@ -24,10 +21,6 @@ export type Environment = "polkadot" | "kusama" | "paseo" | "local" | "westend";
  *
  * const client = await createChainClient({
  *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
- *     rpcs: {
- *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
- *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
- *     },
  * });
  * ```
  */
@@ -36,8 +29,6 @@ export interface ChainClientConfig<
 > {
     /** Named chain descriptors (PAPI `ChainDefinition` objects). */
     chains: TChains;
-    /** RPC endpoints per chain name (currently unused - connections route through host). */
-    rpcs: { [K in keyof TChains]: readonly string[] };
 }
 
 /**