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