npm - @parity/product-sdk-chain-client - Versions diffs - 0.2.1 → 0.3.0 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -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,11 +23,11 @@ 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"],
@@ -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,11 +95,11 @@ 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"],
@@ -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.
  *

package/dist/index.js CHANGED Viewed

@@ -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: [
@@ -153,20 +153,42 @@ var rpcs = {
     ],
     bulletin: [...BULLETIN_RPCS.paseo],
     individuality: ["wss://paseo-people-next-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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/providers.ts","../src/hmr.ts","../src/clients.ts","../src/presets.ts"],"names":[],"mappings":";;;;;AAWA,eAAsB,eAAe,WAAA,EAA+C;AAChF,EAAA,MAAM,YAAA,GAAe,MAAM,eAAA,CAAgB,WAA4B,CAAA;AACvE,EAAA,IAAI,CAAC,YAAA,EAAc;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,uCAAuC,WAAW,CAAA,8EAAA;AAAA,KACtD;AAAA,EACJ;AACA,EAAA,OAAO,YAAA;AACX;;;ACZO,SAAS,cAAA,GAA0C;AACtD,EAAA,UAAA,CAAW,kBAAA,yBAA2B,GAAA,EAAI;AAC1C,EAAA,OAAO,UAAA,CAAW,kBAAA;AACtB;AAGO,SAAS,gBAAA,GAAyB;AACrC,EAAA,MAAM,QAAQ,cAAA,EAAe;AAC7B,EAAA,KAAA,MAAW,KAAA,IAAS,KAAA,CAAM,MAAA,EAAO,EAAG;AAChC,IAAA,IAAI;AACA,MAAA,KAAA,CAAM,OAAO,OAAA,EAAQ;AAAA,IACzB,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACJ;AACA,EAAA,KAAA,CAAM,KAAA,EAAM;AAChB;;;ACfA,IAAM,WAAW,CAAC,WAAA,EAAqB,YAAoB,CAAA,EAAG,WAAW,IAAI,OAAO,CAAA,CAAA;AAEpF,SAAS,mBAAmB,OAAA,EAAyC;AACjE,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,gBAAe,EAAG;AACzC,IAAA,IAAI,IAAI,QAAA,CAAS,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,GAAG,OAAO,KAAA;AAAA,EAC5C;AACJ;AAEA,IAAM,eAAA,uBAAsB,GAAA,EAAuC;AAGnE,SAAS,kBAAkB,MAAA,EAAiD;AACxE,EAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CACvB,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,cAAc,CAAC,CAAC,CAAA,CACrC,GAAA,CAAI,CAAC,CAAC,IAAA,EAAM,IAAI,MAAM,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,IAAA,CAAK,OAAA,IAAW,SAAS,CAAA,CAAE,CAAA,CAC5D,KAAK,GAAG,CAAA;AACjB;AAsCA,eAAsB,kBAClB,MAAA,EAC6B;AAC7B,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,MAAA,CAAO,MAAM,CAAA;AAEnD,EAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,GAAA,CAAI,WAAW,CAAA;AAChD,EAAA,IAAI,UAAU,OAAO,QAAA;AAErB,EAAA,MAAM,UAAU,eAAA,CAAgB,MAAA,EAAQ,WAAW,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAQ;AAGhE,IAAA,MAAM,QAAQ,cAAA,EAAe;AAC7B,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,KAAA,EAAO;AAC9B,MAAA,IAAI,GAAA,CAAI,UAAA,CAAW,CAAA,EAAG,WAAW,GAAG,CAAA,EAAG;AACnC,QAAA,IAAI;AACA,UAAA,KAAA,CAAM,OAAO,OAAA,EAAQ;AAAA,QACzB,CAAA,CAAA,MAAQ;AAAA,QAER;AACA,QAAA,KAAA,CAAM,OAAO,GAAG,CAAA;AAAA,MACpB;AAAA,IACJ;AACA,IAAA,eAAA,CAAgB,OAAO,WAAW,CAAA;AAClC,IAAA,MAAM,GAAA;AAAA,EACV,CAAC,CAAA;AACD,EAAA,eAAA,CAAgB,GAAA,CAAI,aAAa,OAAO,CAAA;AACxC,EAAA,OAAO,OAAA;AACX;AAGA,eAAe,eAAA,CACX,QACA,WAAA,EAC6B;AAC7B,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,MAAM,CAAA;AACvC,EAAA,MAAM,cAAc,cAAA,EAAe;AAGnC,EAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,GAAA;AAAA,IAC1B,KAAA,CAAM,GAAA,CAAI,OAAO,IAAA,KAAS;AACtB,MAAA,MAAM,UAAA,GAAa,MAAA,CAAO,MAAA,CAAO,IAAI,CAAA;AACrC,MAAA,MAAM,UAAU,UAAA,CAAW,OAAA;AAC3B,MAAA,IAAI,CAAC,OAAA,EAAS;AACV,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,IAAI,CAAA,sBAAA,CAAwB,CAAA;AAAA,MACzE;AACA,MAAA,MAAM,QAAA,GAAW,MAAM,cAAA,CAAe,OAAO,CAAA;AAC7C,MAAA,MAAM,MAAA,GAAS,aAAa,QAAQ,CAAA;AAGpC,MAAA,MAAM,GAAA,GAAM,QAAA,CAAS,WAAA,EAAa,OAAO,CAAA;AACzC,MAAA,IAAI,CAAC,WAAA,CAAY,GAAA,CAAI,GAAG,CAAA,EAAG;AACvB,QAAA,WAAA,CAAY,IAAI,GAAA,EAAK;AAAA,UACjB,MAAA;AAAA,UACA,GAAA,sBAAS,GAAA;AAAI,SACK,CAAA;AAAA,MAC1B;AAEA,MAAA,OAAO,EAAE,IAAA,EAAM,UAAA,EAAY,MAAA,EAAQ,OAAA,EAAQ;AAAA,IAC/C,CAAC;AAAA,GACL;AAGA,EAAA,MAAM,OAAO,EAAC;AACd,EAAA,MAAM,MAAM,EAAC;AAEb,EAAA,KAAA,MAAW,EAAE,IAAA,EAAM,UAAA,EAAY,MAAA,MAAY,OAAA,EAAS;AAChD,IAAA,IAAA,CAAK,IAAI,CAAA,GAAI,MAAA,CAAO,WAAA,CAAY,UAAU,CAAA;AAC1C,IAAA,GAAA,CAAI,IAAI,CAAA,GAAI,MAAA;AAAA,EAChB;AAEA,EAAA,OAAO;AAAA,IACH,GAAG,IAAA;AAAA,IACH,GAAA;AAAA,IACA,OAAA,GAAU;AACN,MAAA,KAAA,MAAW,EAAE,OAAA,EAAQ,IAAK,OAAA,EAAS;AAC/B,QAAA,MAAM,GAAA,GAAM,QAAA,CAAS,WAAA,EAAa,OAAO,CAAA;AACzC,QAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,GAAG,CAAA;AACjC,QAAA,IAAI,KAAA,EAAO;AACP,UAAA,IAAI;AACA,YAAA,KAAA,CAAM,OAAO,OAAA,EAAQ;AAAA,UACzB,CAAA,CAAA,MAAQ;AAAA,UAER;AACA,UAAA,WAAA,CAAY,OAAO,GAAG,CAAA;AAAA,QAC1B;AAAA,MACJ;AACA,MAAA,eAAA,CAAgB,OAAO,WAAW,CAAA;AAAA,IACtC;AAAA,GACJ;AACJ;AAOO,SAAS,UAAA,GAAmB;AAC/B,EAAA,gBAAA,EAAiB;AACjB,EAAA,eAAA,CAAgB,KAAA,EAAM;AAC1B;AAUO,SAAS,UAAU,UAAA,EAA6C;AACnE,EAAA,MAAM,UAAU,UAAA,CAAW,OAAA;AAC3B,EAAA,IAAI,CAAC,OAAA,EAAS,MAAM,IAAI,MAAM,iCAAiC,CAAA;AAC/D,EAAA,MAAM,KAAA,GAAQ,mBAAmB,OAAO,CAAA;AACxC,EAAA,IAAI,CAAC,OAAO,MAAA,EAAQ;AAChB,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,iCAAiC,OAAO,CAAA,2DAAA;AAAA,KAC5C;AAAA,EACJ;AACA,EAAA,OAAO,KAAA,CAAM,MAAA;AACjB;AAOO,SAAS,YAAY,UAAA,EAAsC;AAC9D,EAAA,MAAM,UAAU,UAAA,CAAW,OAAA;AAC3B,EAAA,IAAI,CAAC,SAAS,OAAO,KAAA;AACrB,EAAA,OAAO,kBAAA,CAAmB,OAAO,CAAA,KAAM,MAAA;AAC3C;AC/KA,IAAM,sBAAA,mBAA2C,IAAI,GAAA,CAAI,CAAC,OAAO,CAAC,CAAA;AAElE,IAAM,IAAA,GAAO;AAAA,EACT,QAAA,EAAU;AAAA,IACN,QAAA,EAAU;AAAA,MACN,0CAAA;AAAA,MACA;AAAA,KACJ;AAAA,IACA,QAAA,EAAU,CAAC,GAAG,aAAA,CAAc,QAAQ,CAAA;AAAA,IACpC,eAAe;AAAC,GACpB;AAAA,EACA,MAAA,EAAQ;AAAA,IACJ,QAAA,EAAU;AAAA,MACN,wCAAA;AAAA,MACA;AAAA,KACJ;AAAA,IACA,QAAA,EAAU,CAAC,GAAG,aAAA,CAAc,MAAM,CAAA;AAAA,IAClC,eAAe;AAAC,GACpB;AAAA,EACA,KAAA,EAAO;AAAA,IACH,QAAA,EAAU;AAAA,MACN,yCAAA;AAAA,MACA;AAAA,KACJ;AAAA,IACA,QAAA,EAAU,CAAC,GAAG,aAAA,CAAc,KAAK,CAAA;AAAA,IACjC,aAAA,EAAe,CAAC,yCAAyC;AAAA;AAEjE,CAAA;AAOA,eAAe,gBAAgB,GAAA,EAAkB;AAC7C,EAAA,MAAM,cAAA,GAAiB;AAAA,IACnB,QAAA,EAAU,MAAM,OAAO,oDAAoD,CAAA;AAAA,IAC3E,MAAA,EAAQ,MAAM,OAAO,kDAAkD,CAAA;AAAA,IACvE,KAAA,EAAO,MAAM,OAAO,iDAAiD;AAAA,GACzE,CAAE,GAAG,CAAA,EAAE;AAEP,EAAA,MAAM,CAAC,KAAA,EAAO,EAAE,QAAA,EAAS,EAAG,EAAE,aAAA,EAAe,CAAA,GAAI,MAAM,OAAA,CAAQ,GAAA,CAAI;AAAA,IAC/D,cAAA;AAAA,IACA,OAAO,0CAA0C,CAAA;AAAA,IACjD,OAAO,+CAA+C;AAAA,GACzD,CAAA;AAGD,EAAA,MAAM,QAAA,GACF,wBAAwB,KAAA,GAClB,KAAA,CAAM,qBACN,kBAAA,IAAsB,KAAA,GACpB,KAAA,CAAM,gBAAA,GACL,KAAA,CACI,eAAA;AAEjB,EAAA,OAAO,EAAE,QAAA,EAAU,QAAA,EAAU,aAAA,EAAc;AAC/C;AA2CA,eAAsB,YAClB,GAAA,EACqC;AACrC,EAAA,IAAI,CAAC,sBAAA,CAAuB,GAAA,CAAI,GAAG,CAAA,EAAG;AAClC,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,GAAG,CAAA,sBAAA,CAAwB,CAAA;AAAA,EACjE;AAEA,EAAA,MAAM,WAAA,GAAc,MAAM,eAAA,CAAgB,GAAG,CAAA;AAC7C,EAAA,MAAM,OAAA,GAAU,KAAK,GAAG,CAAA;AAExB,EAAA,OAAO,iBAAA,CAAkB;AAAA,IACrB,MAAA,EAAQ;AAAA,MACJ,UAAU,WAAA,CAAY,QAAA;AAAA,MACtB,UAAU,WAAA,CAAY,QAAA;AAAA,MACtB,eAAe,WAAA,CAAY;AAAA,KAC/B;AAAA,IACA,IAAA,EAAM;AAAA,MACF,QAAA,EAAU,CAAC,GAAG,OAAA,CAAQ,QAAQ,CAAA;AAAA,MAC9B,QAAA,EAAU,CAAC,GAAG,OAAA,CAAQ,QAAQ,CAAA;AAAA,MAC9B,aAAA,EAAe,CAAC,GAAG,OAAA,CAAQ,aAAa;AAAA;AAC5C,GACH,CAAA;AACL","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"]}
1	+ {"version":3,"sources":["../src/providers.ts","../src/hmr.ts","../src/clients.ts","../src/presets.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { getHostProvider } from \"@parity/product-sdk-host\";\nimport type { JsonRpcProvider } from \"polkadot-api\";\n\n/*\n Create a PAPI-compatible JSON-RPC provider for a chain.\n \n Routes connections through the host provider (`@parity/product-sdk-host`).\n * The SDK is designed to run exclusively inside a host container.\n \n @throws {Error} If the host provider is unavailable (not inside a container).\n /\nexport async function createProvider(genesisHash: string): Promise<JsonRpcProvider> {\n const hostProvider = await getHostProvider(genesisHash as `0x${string}`);\n if (!hostProvider) {\n throw new Error(\n `Host provider unavailable for chain ${genesisHash}. Ensure you are running inside a host container (Polkadot Browser / Desktop).`,\n );\n }\n return hostProvider;\n}\n\nif (import.meta.vitest) {\n const { test, expect, vi, beforeEach } = import.meta.vitest;\n\n // Shared state between hoisted mocks and tests\n const state = vi.hoisted(() => ({\n fakeProvider: (() => {}) as unknown as JsonRpcProvider,\n hostProviderCalls: [] as unknown[][],\n hostProviderAvailable: true,\n }));\n\n vi.mock(\"@parity/product-sdk-host\", async (importOriginal) => ({\n ...(await importOriginal<typeof import(\"@parity/product-sdk-host\")>()),\n getHostProvider: async (...args: unknown[]) => {\n state.hostProviderCalls.push(args);\n if (!state.hostProviderAvailable) return null;\n return state.fakeProvider;\n },\n }));\n\n beforeEach(() => {\n state.hostProviderCalls = [];\n state.hostProviderAvailable = true;\n });\n\n test(\"returns host provider when available\", async () => {\n const result = await createProvider(\"0xabc\");\n expect(result).toBe(state.fakeProvider);\n expect(state.hostProviderCalls.length).toBe(1);\n expect(state.hostProviderCalls[0][0]).toBe(\"0xabc\");\n });\n\n test(\"throws when host provider unavailable\", async () => {\n state.hostProviderAvailable = false;\n await expect(createProvider(\"0xabc\")).rejects.toThrow(/Host provider unavailable/);\n });\n}\n","import type { ChainEntry } from \"./types.js\";\n\ndeclare global {\n var __chainClientCache: Map<string, ChainEntry> \| undefined;\n}\n\n/* Get the HMR-safe client cache, keyed by genesis hash. /\nexport function getClientCache(): Map<string, ChainEntry> {\n globalThis.__chainClientCache ??= new Map();\n return globalThis.__chainClientCache;\n}\n\n/* Clear all entries from the client cache. Destroys active clients. /\nexport function clearClientCache(): void {\n const cache = getClientCache();\n for (const entry of cache.values()) {\n try {\n entry.client.destroy();\n } catch {\n // client may already be destroyed\n }\n }\n cache.clear();\n}\n\nif (import.meta.vitest) {\n const { test, expect } = import.meta.vitest;\n\n test(\"getClientCache returns a Map\", () => {\n const cache = getClientCache();\n expect(cache).toBeInstanceOf(Map);\n });\n\n test(\"getClientCache returns the same instance on repeated calls\", () => {\n const a = getClientCache();\n const b = getClientCache();\n expect(a).toBe(b);\n });\n}\n","import type { ChainDefinition, PolkadotClient } from \"polkadot-api\";\nimport { createClient } from \"polkadot-api\";\nimport { createProvider } from \"./providers.js\";\nimport { getClientCache, clearClientCache } from \"./hmr.js\";\nimport type { ChainEntry, ChainClientConfig, ChainClient } from \"./types.js\";\n\n// Cache keys are scoped by a fingerprint of the config so that two\n// `createChainClient` calls with different chain sets don't collide.\nconst cacheKey = (fingerprint: string, genesis: string) => `${fingerprint}:${genesis}`;\n\nfunction findEntryByGenesis(genesis: string): ChainEntry \| undefined {\n for (const [key, entry] of getClientCache()) {\n if (key.endsWith(`:${genesis}`)) return entry;\n }\n}\n\nconst clientInstances = new Map<string, Promise<ChainClient<any>>>();\n\n/* Build a stable fingerprint from sorted chain names + genesis hashes. /\nfunction configFingerprint(chains: Record<string, ChainDefinition>): string {\n return Object.entries(chains)\n .sort(([a], [b]) => a.localeCompare(b))\n .map(([name, desc]) => `${name}:${desc.genesis ?? \"unknown\"}`)\n .join(\"\|\");\n}\n\n/\n Create a multi-chain client with user-provided descriptors and RPC endpoints.\n \n Returns fully-typed APIs for each chain plus raw `PolkadotClient` access via `.raw`.\n * Connections route through the host provider (`@parity/product-sdk-host`) — the SDK\n * is designed to run exclusively inside a host container (Polkadot Browser / Desktop).\n * Throws if no host provider is available; there is no direct-WebSocket fallback.\n \n The `config.rpcs` field is currently unused at runtime (kept for API compatibility\n * and BYOD documentation), since the host owns the chain connection.\n \n Results are cached by genesis-hash fingerprint — calling with the same descriptors\n * returns the same instance.\n \n @example\n * ```ts\n * import { createChainClient } from \"@parity/product-sdk-chain-client\";\n * import { paseo_asset_hub } from \"@parity/product-sdk-descriptors/paseo-asset-hub\";\n * import { paseo_bulletin } from \"@parity/product-sdk-descriptors/paseo-bulletin\";\n \n const client = await createChainClient({\n * chains: { assetHub: paseo_asset_hub, bulletin: paseo_bulletin },\n * rpcs: {\n * assetHub: [\"wss://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.\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: [\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 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., 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 // 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: \"0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2\",\n previewnet_asset_hub: \"0x860d75a890388e2ad02c54aa451264d04af89765773a51cd56868b4293c7867c\",\n paseo_bulletin: \"0x744960c32e3a3df5440e1ecd4d34096f1ce2230d7016a5ada8a765d5a622b4ea\",\n previewnet_bulletin: \"0xf37fa1f1450ea120edbf64c3fc447f671a00e1f1095a698f42eeec073c7ee487\",\n paseo_individuality: \"0xa22a2424d2cbf561eaecf7da8b1b548fa9d1939f60265e942b1049616a012f71\",\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 CHANGED Viewed

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

package/src/clients.ts CHANGED Viewed

@@ -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,11 +41,11 @@ 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"],

package/src/presets.ts CHANGED Viewed

@@ -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: {
@@ -42,51 +48,109 @@ const rpcs = {
         bulletin: [...BULLETIN_RPCS.paseo],
         individuality: ["wss://paseo-people-next-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.
@@ -144,12 +208,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",
+        previewnet_asset_hub: "0x860d75a890388e2ad02c54aa451264d04af89765773a51cd56868b4293c7867c",
+        paseo_bulletin: "0x744960c32e3a3df5440e1ecd4d34096f1ce2230d7016a5ada8a765d5a622b4ea",
+        previewnet_bulletin: "0xf37fa1f1450ea120edbf64c3fc447f671a00e1f1095a698f42eeec073c7ee487",
+        paseo_individuality: "0xa22a2424d2cbf561eaecf7da8b1b548fa9d1939f60265e942b1049616a012f71",
+        previewnet_individuality:
+            "0xbf3a38ecba96d2f647bc12198011b9e4f0ba3a7e2a190597205cbe238f5c125d",
     } as const;
     beforeEach(() => {
@@ -167,7 +238,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 +250,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 +272,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 CHANGED Viewed

@@ -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,11 +17,11 @@ 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"],