@parity/product-sdk-chain-client 0.2.1 → 0.4.0

package/dist/index.d.ts

@@ -2,8 +2,11 @@ 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 { bulletin } from '@parity/product-sdk-descriptors/bulletin';
-import { individuality } from '@parity/product-sdk-descriptors/individuality';
+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';
 
 /**
@@ -20,14 +23,14 @@ export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-ho
  * @example
  * ```ts
  * import { createChainClient } from "@parity/product-sdk-chain-client";
- * import { paseo_asset_hub } from "./descriptors/paseo-asset-hub";
- * import { bulletin } from "./descriptors/bulletin";
+ * import { paseo_asset_hub } from "@parity/product-sdk-descriptors/paseo-asset-hub";
+ * import { paseo_bulletin } from "@parity/product-sdk-descriptors/paseo-bulletin";
  *
  * const client = await createChainClient({
- *     chains: { assetHub: paseo_asset_hub, bulletin },
+ *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
  *     rpcs: {
- *         assetHub: ["wss://sys.ibp.network/asset-hub-paseo"],
- *         bulletin: ["wss://paseo-bulletin-rpc.polkadot.io"],
+ *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
+ *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
  *     },
  * });
  * ```
@@ -45,7 +48,7 @@ interface ChainClientConfig<TChains extends Record<string, ChainDefinition> = Re
  *
  * Each key from your config maps to a fully-typed PAPI {@link TypedApi}.
  * Access raw `PolkadotClient` instances via `.raw` for advanced use cases
- * like creating an `InkSdk` for contract interactions.
+ * like creating a `ContractRuntime` for pallet-revive contract interactions.
  *
  * @typeParam TChains - The chain descriptor record used to create this client.
  *
@@ -54,15 +57,15 @@ interface ChainClientConfig<TChains extends Record<string, ChainDefinition> = Re
  * // Typed API access — fully typed from your descriptors
  * const account = await client.assetHub.query.System.Account.getValue(addr);
  *
- * // Raw client for advanced use (e.g., InkSdk for contracts)
- * import { createInkSdk } from "@polkadot-api/sdk-ink";
- * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });
+ * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)
+ * import { createContractRuntimeFromClient } from "@parity/product-sdk-contracts";
+ * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);
  * ```
  */
 type ChainClient<TChains extends Record<string, ChainDefinition>> = {
     [K in string & keyof TChains]: TypedApi<TChains[K]>;
 } & {
-    /** Raw `PolkadotClient` instances, keyed by chain name. Use for advanced APIs like `createInkSdk`. */
+    /** Raw `PolkadotClient` instances, keyed by chain name. Use for advanced APIs like `createContractRuntime`. */
     raw: {
         [K in string & keyof TChains]: PolkadotClient;
     };
@@ -79,8 +82,12 @@ interface ChainEntry {
  * Create a multi-chain client with user-provided descriptors and RPC endpoints.
  *
  * Returns fully-typed APIs for each chain plus raw `PolkadotClient` access via `.raw`.
- * Connections use host routing (via `@parity/product-sdk-host`) when inside a container,
- * falling back to direct WebSocket RPC.
+ * Connections route through the host provider (`@parity/product-sdk-host`) — the SDK
+ * 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.
@@ -88,14 +95,14 @@ interface ChainEntry {
  * @example
  * ```ts
  * import { createChainClient } from "@parity/product-sdk-chain-client";
- * import { paseo_asset_hub } from "./descriptors/paseo-asset-hub";
- * import { bulletin } from "./descriptors/bulletin";
+ * import { paseo_asset_hub } from "@parity/product-sdk-descriptors/paseo-asset-hub";
+ * import { paseo_bulletin } from "@parity/product-sdk-descriptors/paseo-bulletin";
  *
  * const client = await createChainClient({
- *     chains: { assetHub: paseo_asset_hub, bulletin },
+ *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
  *     rpcs: {
- *         assetHub: ["wss://sys.ibp.network/asset-hub-paseo"],
- *         bulletin: ["wss://paseo-bulletin-rpc.polkadot.io"],
+ *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
+ *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
  *     },
  * });
  *
@@ -103,9 +110,9 @@ interface ChainEntry {
  * const account = await client.assetHub.query.System.Account.getValue(addr);
  * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();
  *
- * // Raw client for advanced use (e.g., InkSdk for contracts)
- * import { createInkSdk } from "@polkadot-api/sdk-ink";
- * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });
+ * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)
+ * import { createContractRuntimeFromClient } from "@parity/product-sdk-contracts";
+ * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);
  *
  * // Cleanup
  * client.destroy();
@@ -135,19 +142,32 @@ 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";
-/** Maps each environment to its asset hub descriptor type. */
-type AssetHubDescriptors = {
-    polkadot: typeof polkadot_asset_hub;
-    kusama: typeof kusama_asset_hub;
-    paseo: typeof paseo_asset_hub;
+type Environment = "polkadot" | "kusama" | "paseo" | "previewnet";
+/** Per-environment descriptor types for each chain in the preset. */
+type PresetDescriptors = {
+    polkadot: {
+        assetHub: typeof polkadot_asset_hub;
+        bulletin: typeof paseo_bulletin;
+        individuality: typeof paseo_individuality;
+    };
+    kusama: {
+        assetHub: typeof kusama_asset_hub;
+        bulletin: typeof paseo_bulletin;
+        individuality: typeof paseo_individuality;
+    };
+    paseo: {
+        assetHub: typeof paseo_asset_hub;
+        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> = {
-    assetHub: AssetHubDescriptors[E];
-    bulletin: typeof bulletin;
-    individuality: typeof individuality;
-};
+type PresetChains<E extends Environment> = PresetDescriptors[E];
 /**
  * Get a chain client for a known environment with built-in descriptors and RPCs.
  *
@@ -168,9 +188,10 @@ type PresetChains<E extends Environment> = {
  * const account = await client.assetHub.query.System.Account.getValue(addr);
  * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();
  *
- * // Raw client for advanced use (e.g., InkSdk for contracts)
- * import { createInkSdk } from "@polkadot-api/sdk-ink";
- * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });
+ * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)
+ * import { createContractRuntimeFromClient } from "@parity/product-sdk-contracts";
+ * import { paseo_asset_hub } from "@parity/product-sdk-descriptors/paseo-asset-hub";
+ * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);
  *
  * client.destroy();
  * ```

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"]);
+var AVAILABLE_ENVIRONMENTS = /* @__PURE__ */ new Set(["paseo", "previewnet"]);
 var rpcs = {
   polkadot: {
     assetHub: [
@@ -147,26 +147,45 @@ var rpcs = {
     individuality: []
   },
   paseo: {
-    assetHub: [
-      "wss://asset-hub-paseo-rpc.n.dwellir.com",
-      "wss://sys.ibp.network/asset-hub-paseo"
-    ],
+    assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
     bulletin: [...BULLETIN_RPCS.paseo],
-    individuality: ["wss://paseo-people-next-rpc.polkadot.io"]
+    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) {
-  const assetHubImport = {
-    polkadot: () => import('@parity/product-sdk-descriptors/polkadot-asset-hub'),
-    kusama: () => import('@parity/product-sdk-descriptors/kusama-asset-hub'),
-    paseo: () => import('@parity/product-sdk-descriptors/paseo-asset-hub')
-  }[env]();
-  const [ahMod, { bulletin }, { individuality }] = await Promise.all([
-    assetHubImport,
-    import('@parity/product-sdk-descriptors/bulletin'),
-    import('@parity/product-sdk-descriptors/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 loaders = {
+    polkadot: () => Promise.all([
+      import('@parity/product-sdk-descriptors/polkadot-asset-hub'),
+      // Polkadot bulletin/individuality are not yet live; gated by
+      // AVAILABLE_ENVIRONMENTS so this branch is unreachable today.
+      Promise.reject(new Error("polkadot bulletin descriptor not yet available")),
+      Promise.reject(new Error("polkadot individuality descriptor not yet available"))
+    ]),
+    kusama: () => Promise.all([
+      import('@parity/product-sdk-descriptors/kusama-asset-hub'),
+      Promise.reject(new Error("kusama bulletin descriptor not yet available")),
+      Promise.reject(new Error("kusama individuality descriptor not yet available"))
+    ]),
+    paseo: () => Promise.all([
+      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;
   return { assetHub, bulletin, individuality };
 }
 async function getChainAPI(env) {

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 use host routing (via `@parity/product-sdk-host`) when inside a container,\n * falling back to direct WebSocket RPC.\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 \"./descriptors/paseo-asset-hub\";\n * import { bulletin } from \"./descriptors/bulletin\";\n *\n * const client = await createChainClient({\n *     chains: { assetHub: paseo_asset_hub, bulletin },\n *     rpcs: {\n *         assetHub: [\"wss://sys.ibp.network/asset-hub-paseo\"],\n *         bulletin: [\"wss://paseo-bulletin-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., InkSdk for contracts)\n * import { createInkSdk } from \"@polkadot-api/sdk-ink\";\n * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });\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.\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 { bulletin as BulletinDef } from \"@parity/product-sdk-descriptors/bulletin\";\nimport type { individuality as IndividualityDef } from \"@parity/product-sdk-descriptors/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: [\n            \"wss://asset-hub-paseo-rpc.n.dwellir.com\",\n            \"wss://sys.ibp.network/asset-hub-paseo\",\n        ],\n        bulletin: [...BULLETIN_RPCS.paseo],\n        individuality: [\"wss://paseo-people-next-rpc.polkadot.io\"],\n    },\n} as const;\n\n/**\n * Lazy-load descriptors for a specific environment.\n * Only imports the chains needed — avoids bundling all 5 chains when\n * a consumer only uses one environment.\n */\nasync function loadDescriptors(env: Environment) {\n    const assetHubImport = {\n        polkadot: () => import(\"@parity/product-sdk-descriptors/polkadot-asset-hub\"),\n        kusama: () => import(\"@parity/product-sdk-descriptors/kusama-asset-hub\"),\n        paseo: () => import(\"@parity/product-sdk-descriptors/paseo-asset-hub\"),\n    }[env]();\n\n    const [ahMod, { bulletin }, { individuality }] = await Promise.all([\n        assetHubImport,\n        import(\"@parity/product-sdk-descriptors/bulletin\"),\n        import(\"@parity/product-sdk-descriptors/individuality\"),\n    ]);\n\n    // Extract the asset hub descriptor (the named export varies per environment)\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 typeof import(\"@parity/product-sdk-descriptors/paseo-asset-hub\"))\n                    .paseo_asset_hub;\n\n    return { assetHub, bulletin, individuality };\n}\n\n/** Maps each environment to its asset hub descriptor type. */\ntype AssetHubDescriptors = {\n    polkadot: typeof PolkadotAssetHubDef;\n    kusama: typeof KusamaAssetHubDef;\n    paseo: typeof PaseoAssetHubDef;\n};\n\n/** The chain shape returned by {@link getChainAPI} for a given environment. */\nexport type PresetChains<E extends Environment> = {\n    assetHub: AssetHubDescriptors[E];\n    bulletin: typeof BulletinDef;\n    individuality: typeof IndividualityDef;\n};\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., InkSdk for contracts)\n * import { createInkSdk } from \"@polkadot-api/sdk-ink\";\n * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });\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: \"0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2\",\n        bulletin: \"0x744960c32e3a3df5440e1ecd4d34096f1ce2230d7016a5ada8a765d5a622b4ea\",\n        individuality: \"0xd01475fde5d0592989b7715ae1d2e89fdb4f8c7688c09c850d75e1d4bdb47d64\",\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.bulletin);\n        expect(descriptors.individuality.genesis).toBe(GENESIS.individuality);\n    });\n\n    test(\"loadDescriptors returns correct asset hub per environment\", async () => {\n        const polkadot = await loadDescriptors(\"polkadot\");\n        const kusama = await loadDescriptors(\"kusama\");\n        const paseo = await loadDescriptors(\"paseo\");\n        expect(polkadot.assetHub.genesis).toBe(GENESIS.polkadot_asset_hub);\n        expect(kusama.assetHub.genesis).toBe(GENESIS.kusama_asset_hub);\n        expect(paseo.assetHub.genesis).toBe(GENESIS.paseo_asset_hub);\n        // bulletin and individuality are the same across environments\n        expect(polkadot.bulletin.genesis).toBe(paseo.bulletin.genesis);\n        expect(polkadot.individuality.genesis).toBe(paseo.individuality.genesis);\n    });\n\n    // --- AVAILABLE_ENVIRONMENTS ---\n\n    test(\"only 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"]}
+{"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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-sdk-chain-client",
-  "version": "0.2.1",
+  "version": "0.4.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.2.1",
     "@parity/product-sdk-logger": "0.1.1",
-    "@parity/product-sdk-host": "0.2.0"
+    "@parity/product-sdk-descriptors": "0.4.0",
+    "@parity/product-sdk-host": "0.2.2"
   },
   "devDependencies": {
     "tsup": "^8.4.0",

package/src/clients.ts

@@ -28,8 +28,12 @@ function configFingerprint(chains: Record<string, ChainDefinition>): string {
  * Create a multi-chain client with user-provided descriptors and RPC endpoints.
  *
  * Returns fully-typed APIs for each chain plus raw `PolkadotClient` access via `.raw`.
- * Connections use host routing (via `@parity/product-sdk-host`) when inside a container,
- * falling back to direct WebSocket RPC.
+ * Connections route through the host provider (`@parity/product-sdk-host`) — the SDK
+ * 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.
@@ -37,14 +41,14 @@ function configFingerprint(chains: Record<string, ChainDefinition>): string {
  * @example
  * ```ts
  * import { createChainClient } from "@parity/product-sdk-chain-client";
- * import { paseo_asset_hub } from "./descriptors/paseo-asset-hub";
- * import { bulletin } from "./descriptors/bulletin";
+ * import { paseo_asset_hub } from "@parity/product-sdk-descriptors/paseo-asset-hub";
+ * import { paseo_bulletin } from "@parity/product-sdk-descriptors/paseo-bulletin";
  *
  * const client = await createChainClient({
- *     chains: { assetHub: paseo_asset_hub, bulletin },
+ *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
  *     rpcs: {
- *         assetHub: ["wss://sys.ibp.network/asset-hub-paseo"],
- *         bulletin: ["wss://paseo-bulletin-rpc.polkadot.io"],
+ *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
+ *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
  *     },
  * });
  *
@@ -52,9 +56,9 @@ function configFingerprint(chains: Record<string, ChainDefinition>): string {
  * const account = await client.assetHub.query.System.Account.getValue(addr);
  * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();
  *
- * // Raw client for advanced use (e.g., InkSdk for contracts)
- * import { createInkSdk } from "@polkadot-api/sdk-ink";
- * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });
+ * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)
+ * import { createContractRuntimeFromClient } from "@parity/product-sdk-contracts";
+ * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);
  *
  * // Cleanup
  * client.destroy();

package/src/presets.ts

@@ -5,17 +5,23 @@ import type { ChainClient } from "./types.js";
 
 // Type-only imports — erased at compile time, zero bundle cost.
 // These give us per-chain TypedApi types without importing runtime descriptor data.
+// Every environment ships its own descriptor for each chain (asset hub, bulletin,
+// individuality) so that genesis hashes and metadata reflect the live chain
+// instance the consumer connects to.
 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 { bulletin as BulletinDef } from "@parity/product-sdk-descriptors/bulletin";
-import type { individuality as IndividualityDef } from "@parity/product-sdk-descriptors/individuality";
+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";
+export type Environment = "polkadot" | "kusama" | "paseo" | "previewnet";
 
 /** Environments where all chains (asset hub, bulletin, individuality) are live. */
-const AVAILABLE_ENVIRONMENTS: Set<Environment> = new Set(["paseo"]);
+const AVAILABLE_ENVIRONMENTS: Set<Environment> = new Set(["paseo", "previewnet"]);
 
 const rpcs = {
     polkadot: {
@@ -35,58 +41,113 @@ const rpcs = {
         individuality: [] as string[],
     },
     paseo: {
-        assetHub: [
-            "wss://asset-hub-paseo-rpc.n.dwellir.com",
-            "wss://sys.ibp.network/asset-hub-paseo",
-        ],
+        assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
         bulletin: [...BULLETIN_RPCS.paseo],
-        individuality: ["wss://paseo-people-next-rpc.polkadot.io"],
+        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;
 
 /**
  * Lazy-load descriptors for a specific environment.
- * Only imports the chains needed — avoids bundling all 5 chains when
- * a consumer only uses one environment.
+ *
+ * Every chain (asset hub, bulletin, individuality) ships a per-environment
+ * descriptor so that genesis hashes and metadata reflect the live chain
+ * instance the consumer connects to. Dynamic imports are code-split per
+ * environment, so a consumer using one environment doesn't bundle the others.
  */
 async function loadDescriptors(env: Environment) {
-    const assetHubImport = {
-        polkadot: () => import("@parity/product-sdk-descriptors/polkadot-asset-hub"),
-        kusama: () => import("@parity/product-sdk-descriptors/kusama-asset-hub"),
-        paseo: () => import("@parity/product-sdk-descriptors/paseo-asset-hub"),
-    }[env]();
-
-    const [ahMod, { bulletin }, { individuality }] = await Promise.all([
-        assetHubImport,
-        import("@parity/product-sdk-descriptors/bulletin"),
-        import("@parity/product-sdk-descriptors/individuality"),
-    ]);
-
-    // Extract the asset hub descriptor (the named export varies per environment)
+    const loaders = {
+        polkadot: () =>
+            Promise.all([
+                import("@parity/product-sdk-descriptors/polkadot-asset-hub"),
+                // Polkadot bulletin/individuality are not yet live; gated by
+                // AVAILABLE_ENVIRONMENTS so this branch is unreachable today.
+                Promise.reject(new Error("polkadot bulletin descriptor not yet available")),
+                Promise.reject(new Error("polkadot individuality descriptor not yet available")),
+            ]),
+        kusama: () =>
+            Promise.all([
+                import("@parity/product-sdk-descriptors/kusama-asset-hub"),
+                Promise.reject(new Error("kusama bulletin descriptor not yet available")),
+                Promise.reject(new Error("kusama individuality descriptor not yet available")),
+            ]),
+        paseo: () =>
+            Promise.all([
+                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]();
+
+    // 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
-              : (ahMod as typeof import("@parity/product-sdk-descriptors/paseo-asset-hub"))
-                    .paseo_asset_hub;
+              : "paseo_asset_hub" in ahMod
+                ? ahMod.paseo_asset_hub
+                : (ahMod as { previewnet_asset_hub: typeof PreviewnetAssetHubDef })
+                      .previewnet_asset_hub;
+
+    const bulletin =
+        "paseo_bulletin" in bulletinMod
+            ? bulletinMod.paseo_bulletin
+            : (bulletinMod as { previewnet_bulletin: typeof PreviewnetBulletinDef })
+                  .previewnet_bulletin;
+
+    const individuality =
+        "paseo_individuality" in individualityMod
+            ? individualityMod.paseo_individuality
+            : (individualityMod as { previewnet_individuality: typeof PreviewnetIndividualityDef })
+                  .previewnet_individuality;
 
     return { assetHub, bulletin, individuality };
 }
 
-/** Maps each environment to its asset hub descriptor type. */
-type AssetHubDescriptors = {
-    polkadot: typeof PolkadotAssetHubDef;
-    kusama: typeof KusamaAssetHubDef;
-    paseo: typeof PaseoAssetHubDef;
+/** Per-environment descriptor types for each chain in the preset. */
+type PresetDescriptors = {
+    polkadot: {
+        assetHub: typeof PolkadotAssetHubDef;
+        // Bulletin/individuality not yet live on polkadot — types reuse paseo
+        // shape so the API surface stays consistent; runtime path is gated.
+        bulletin: typeof PaseoBulletinDef;
+        individuality: typeof PaseoIndividualityDef;
+    };
+    kusama: {
+        assetHub: typeof KusamaAssetHubDef;
+        bulletin: typeof PaseoBulletinDef;
+        individuality: typeof PaseoIndividualityDef;
+    };
+    paseo: {
+        assetHub: typeof PaseoAssetHubDef;
+        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. */
-export type PresetChains<E extends Environment> = {
-    assetHub: AssetHubDescriptors[E];
-    bulletin: typeof BulletinDef;
-    individuality: typeof IndividualityDef;
-};
+export type PresetChains<E extends Environment> = PresetDescriptors[E];
 
 /**
  * Get a chain client for a known environment with built-in descriptors and RPCs.
@@ -108,9 +169,10 @@ export type PresetChains<E extends Environment> = {
  * const account = await client.assetHub.query.System.Account.getValue(addr);
  * const fee = await client.bulletin.query.TransactionStorage.ByteFee.getValue();
  *
- * // Raw client for advanced use (e.g., InkSdk for contracts)
- * import { createInkSdk } from "@polkadot-api/sdk-ink";
- * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });
+ * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)
+ * import { createContractRuntimeFromClient } from "@parity/product-sdk-contracts";
+ * import { paseo_asset_hub } from "@parity/product-sdk-descriptors/paseo-asset-hub";
+ * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);
  *
  * client.destroy();
  * ```
@@ -144,12 +206,19 @@ 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: "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",
-        bulletin: "0x744960c32e3a3df5440e1ecd4d34096f1ce2230d7016a5ada8a765d5a622b4ea",
-        individuality: "0xd01475fde5d0592989b7715ae1d2e89fdb4f8c7688c09c850d75e1d4bdb47d64",
+        paseo_asset_hub: "0x173cea9df45656cf612c8b8ece56e04e9a693c69cfaac47d3628dae735067af8",
+        previewnet_asset_hub: "0x860d75a890388e2ad02c54aa451264d04af89765773a51cd56868b4293c7867c",
+        paseo_bulletin: "0x8cfe6717dc4becfda2e13c488a1e2061ff2dfee96e7d031157f72d36716c0a22",
+        previewnet_bulletin: "0xf37fa1f1450ea120edbf64c3fc447f671a00e1f1095a698f42eeec073c7ee487",
+        paseo_individuality: "0x053e1a785bb0990b98768124d9609e963d9ca3558f5ac6e90a4297aaa0a0bd4b",
+        previewnet_individuality:
+            "0xbf3a38ecba96d2f647bc12198011b9e4f0ba3a7e2a190597205cbe238f5c125d",
     } as const;
 
     beforeEach(() => {
@@ -167,7 +236,7 @@ if (import.meta.vitest) {
     // --- RPC config ---
 
     test("rpcs defined for all environments", () => {
-        for (const env of ["polkadot", "kusama", "paseo"] as const) {
+        for (const env of ["polkadot", "kusama", "paseo", "previewnet"] as const) {
             const envRpcs = rpcs[env];
             expect(envRpcs.assetHub.length).toBeGreaterThan(0);
         }
@@ -179,6 +248,12 @@ 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 () => {
@@ -195,26 +270,42 @@ if (import.meta.vitest) {
         expect(descriptors.bulletin).toBeDefined();
         expect(descriptors.individuality).toBeDefined();
         expect(descriptors.assetHub.genesis).toBe(GENESIS.paseo_asset_hub);
-        expect(descriptors.bulletin.genesis).toBe(GENESIS.bulletin);
-        expect(descriptors.individuality.genesis).toBe(GENESIS.individuality);
+        expect(descriptors.bulletin.genesis).toBe(GENESIS.paseo_bulletin);
+        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 correct asset hub per environment", async () => {
-        const polkadot = await loadDescriptors("polkadot");
-        const kusama = await loadDescriptors("kusama");
+    test("loadDescriptors returns environment-specific descriptors for every chain", async () => {
         const paseo = await loadDescriptors("paseo");
-        expect(polkadot.assetHub.genesis).toBe(GENESIS.polkadot_asset_hub);
-        expect(kusama.assetHub.genesis).toBe(GENESIS.kusama_asset_hub);
+        const previewnet = await loadDescriptors("previewnet");
+        // asset-hub: paseo and previewnet are different runtimes (different chains)
         expect(paseo.assetHub.genesis).toBe(GENESIS.paseo_asset_hub);
-        // bulletin and individuality are the same across environments
-        expect(polkadot.bulletin.genesis).toBe(paseo.bulletin.genesis);
-        expect(polkadot.individuality.genesis).toBe(paseo.individuality.genesis);
+        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("only paseo is currently available", () => {
+    test("paseo and previewnet are 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" | "local" | "westend";
+export type Environment = "polkadot" | "kusama" | "paseo" | "previewnet" | "local" | "westend";
 
 /**
  * Configuration for {@link createChainClient}.
@@ -17,14 +17,14 @@ export type Environment = "polkadot" | "kusama" | "paseo" | "local" | "westend";
  * @example
  * ```ts
  * import { createChainClient } from "@parity/product-sdk-chain-client";
- * import { paseo_asset_hub } from "./descriptors/paseo-asset-hub";
- * import { bulletin } from "./descriptors/bulletin";
+ * import { paseo_asset_hub } from "@parity/product-sdk-descriptors/paseo-asset-hub";
+ * import { paseo_bulletin } from "@parity/product-sdk-descriptors/paseo-bulletin";
  *
  * const client = await createChainClient({
- *     chains: { assetHub: paseo_asset_hub, bulletin },
+ *     chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },
  *     rpcs: {
- *         assetHub: ["wss://sys.ibp.network/asset-hub-paseo"],
- *         bulletin: ["wss://paseo-bulletin-rpc.polkadot.io"],
+ *         assetHub: ["wss://paseo-asset-hub-next-rpc.polkadot.io"],
+ *         bulletin: ["wss://paseo-bulletin-next-rpc.polkadot.io"],
  *     },
  * });
  * ```
@@ -43,7 +43,7 @@ export interface ChainClientConfig<
  *
  * Each key from your config maps to a fully-typed PAPI {@link TypedApi}.
  * Access raw `PolkadotClient` instances via `.raw` for advanced use cases
- * like creating an `InkSdk` for contract interactions.
+ * like creating a `ContractRuntime` for pallet-revive contract interactions.
  *
  * @typeParam TChains - The chain descriptor record used to create this client.
  *
@@ -52,15 +52,15 @@ export interface ChainClientConfig<
  * // Typed API access — fully typed from your descriptors
  * const account = await client.assetHub.query.System.Account.getValue(addr);
  *
- * // Raw client for advanced use (e.g., InkSdk for contracts)
- * import { createInkSdk } from "@polkadot-api/sdk-ink";
- * const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });
+ * // Raw client for advanced use (e.g., a ContractRuntime for pallet-revive contracts)
+ * import { createContractRuntimeFromClient } from "@parity/product-sdk-contracts";
+ * const runtime = createContractRuntimeFromClient(client.raw.assetHub, paseo_asset_hub);
  * ```
  */
 export type ChainClient<TChains extends Record<string, ChainDefinition>> = {
     [K in string & keyof TChains]: TypedApi<TChains[K]>;
 } & {
-    /** Raw `PolkadotClient` instances, keyed by chain name. Use for advanced APIs like `createInkSdk`. */
+    /** Raw `PolkadotClient` instances, keyed by chain name. Use for advanced APIs like `createContractRuntime`. */
     raw: { [K in string & keyof TChains]: PolkadotClient };
     /** Destroy all connections managed by this client. */
     destroy: () => void;