polkadot-api 0.10.0 → 0.11.0

package/bin/cli.mjs

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
+import { getCli, add, generate, remove, update } from '@polkadot-api/cli';
 
-// src/cli.ts
-import { add, generate, getCli, remove, update } from "@polkadot-api/cli";
 getCli({
   add,
   generate,
   remove,
   update
 }).parse();
-//# sourceMappingURL=cli.mjs.map
+//# sourceMappingURL=cli.mjs.map

package/bin/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { add, generate, getCli, remove, update } from \"@polkadot-api/cli\"\n\ngetCli({\n  add,\n  generate,\n  remove,\n  update,\n}).parse()\n"],"mappings":";;;AAEA,SAAS,KAAK,UAAU,QAAQ,QAAQ,cAAc;AAEtD,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC,EAAE,MAAM;","names":[]}
+{"version":3,"file":"cli.mjs","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { add, generate, getCli, remove, update } from \"@polkadot-api/cli\"\n\ngetCli({\n  add,\n  generate,\n  remove,\n  update,\n}).parse()\n"],"names":[],"mappings":";;;AAIA,MAAO,CAAA;AAAA,EACL,GAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,MAAA;AACF,CAAC,EAAE,KAAM,EAAA"}

package/chains/ksmcc3/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_ksmcc3",
   "types": "../../dist/reexports/chains_ksmcc3.d.ts",
-  "module": "../../dist/reexports/chains_ksmcc3.mjs",
-  "import": "../../dist/reexports/chains_ksmcc3.mjs",
+  "module": "../../dist/esm/reexports/chains_ksmcc3.mjs",
+  "import": "../../dist/esm/reexports/chains_ksmcc3.mjs",
   "require": "../../dist/reexports/chains_ksmcc3.js",
   "default": "../../dist/reexports/chains_ksmcc3.js"
 }

package/chains/ksmcc3_asset_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_ksmcc3_asset_hub",
   "types": "../../dist/reexports/chains_ksmcc3_asset_hub.d.ts",
-  "module": "../../dist/reexports/chains_ksmcc3_asset_hub.mjs",
-  "import": "../../dist/reexports/chains_ksmcc3_asset_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_ksmcc3_asset_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_ksmcc3_asset_hub.mjs",
   "require": "../../dist/reexports/chains_ksmcc3_asset_hub.js",
   "default": "../../dist/reexports/chains_ksmcc3_asset_hub.js"
 }

package/chains/ksmcc3_bridge_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_ksmcc3_bridge_hub",
   "types": "../../dist/reexports/chains_ksmcc3_bridge_hub.d.ts",
-  "module": "../../dist/reexports/chains_ksmcc3_bridge_hub.mjs",
-  "import": "../../dist/reexports/chains_ksmcc3_bridge_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_ksmcc3_bridge_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_ksmcc3_bridge_hub.mjs",
   "require": "../../dist/reexports/chains_ksmcc3_bridge_hub.js",
   "default": "../../dist/reexports/chains_ksmcc3_bridge_hub.js"
 }

package/chains/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains",
   "types": "../dist/reexports/chains.d.ts",
-  "module": "../dist/reexports/chains.mjs",
-  "import": "../dist/reexports/chains.mjs",
+  "module": "../dist/esm/reexports/chains.mjs",
+  "import": "../dist/esm/reexports/chains.mjs",
   "require": "../dist/reexports/chains.js",
   "default": "../dist/reexports/chains.js"
 }

package/chains/paseo/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "polkadot-api_chains_paseo",
+  "types": "../../dist/reexports/chains_paseo.d.ts",
+  "module": "../../dist/esm/reexports/chains_paseo.mjs",
+  "import": "../../dist/esm/reexports/chains_paseo.mjs",
+  "require": "../../dist/reexports/chains_paseo.js",
+  "default": "../../dist/reexports/chains_paseo.js"
+}

package/chains/polkadot/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_polkadot",
   "types": "../../dist/reexports/chains_polkadot.d.ts",
-  "module": "../../dist/reexports/chains_polkadot.mjs",
-  "import": "../../dist/reexports/chains_polkadot.mjs",
+  "module": "../../dist/esm/reexports/chains_polkadot.mjs",
+  "import": "../../dist/esm/reexports/chains_polkadot.mjs",
   "require": "../../dist/reexports/chains_polkadot.js",
   "default": "../../dist/reexports/chains_polkadot.js"
 }

package/chains/polkadot_asset_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_polkadot_asset_hub",
   "types": "../../dist/reexports/chains_polkadot_asset_hub.d.ts",
-  "module": "../../dist/reexports/chains_polkadot_asset_hub.mjs",
-  "import": "../../dist/reexports/chains_polkadot_asset_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_polkadot_asset_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_polkadot_asset_hub.mjs",
   "require": "../../dist/reexports/chains_polkadot_asset_hub.js",
   "default": "../../dist/reexports/chains_polkadot_asset_hub.js"
 }

package/chains/polkadot_bridge_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_polkadot_bridge_hub",
   "types": "../../dist/reexports/chains_polkadot_bridge_hub.d.ts",
-  "module": "../../dist/reexports/chains_polkadot_bridge_hub.mjs",
-  "import": "../../dist/reexports/chains_polkadot_bridge_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_polkadot_bridge_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_polkadot_bridge_hub.mjs",
   "require": "../../dist/reexports/chains_polkadot_bridge_hub.js",
   "default": "../../dist/reexports/chains_polkadot_bridge_hub.js"
 }

package/chains/polkadot_collectives/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_polkadot_collectives",
   "types": "../../dist/reexports/chains_polkadot_collectives.d.ts",
-  "module": "../../dist/reexports/chains_polkadot_collectives.mjs",
-  "import": "../../dist/reexports/chains_polkadot_collectives.mjs",
+  "module": "../../dist/esm/reexports/chains_polkadot_collectives.mjs",
+  "import": "../../dist/esm/reexports/chains_polkadot_collectives.mjs",
   "require": "../../dist/reexports/chains_polkadot_collectives.js",
   "default": "../../dist/reexports/chains_polkadot_collectives.js"
 }

package/chains/rococo_v2_2/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_rococo_v2_2",
   "types": "../../dist/reexports/chains_rococo_v2_2.d.ts",
-  "module": "../../dist/reexports/chains_rococo_v2_2.mjs",
-  "import": "../../dist/reexports/chains_rococo_v2_2.mjs",
+  "module": "../../dist/esm/reexports/chains_rococo_v2_2.mjs",
+  "import": "../../dist/esm/reexports/chains_rococo_v2_2.mjs",
   "require": "../../dist/reexports/chains_rococo_v2_2.js",
   "default": "../../dist/reexports/chains_rococo_v2_2.js"
 }

package/chains/rococo_v2_2_asset_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_rococo_v2_2_asset_hub",
   "types": "../../dist/reexports/chains_rococo_v2_2_asset_hub.d.ts",
-  "module": "../../dist/reexports/chains_rococo_v2_2_asset_hub.mjs",
-  "import": "../../dist/reexports/chains_rococo_v2_2_asset_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_rococo_v2_2_asset_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_rococo_v2_2_asset_hub.mjs",
   "require": "../../dist/reexports/chains_rococo_v2_2_asset_hub.js",
   "default": "../../dist/reexports/chains_rococo_v2_2_asset_hub.js"
 }

package/chains/rococo_v2_2_bridge_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_rococo_v2_2_bridge_hub",
   "types": "../../dist/reexports/chains_rococo_v2_2_bridge_hub.d.ts",
-  "module": "../../dist/reexports/chains_rococo_v2_2_bridge_hub.mjs",
-  "import": "../../dist/reexports/chains_rococo_v2_2_bridge_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_rococo_v2_2_bridge_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_rococo_v2_2_bridge_hub.mjs",
   "require": "../../dist/reexports/chains_rococo_v2_2_bridge_hub.js",
   "default": "../../dist/reexports/chains_rococo_v2_2_bridge_hub.js"
 }

package/chains/westend2/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_westend2",
   "types": "../../dist/reexports/chains_westend2.d.ts",
-  "module": "../../dist/reexports/chains_westend2.mjs",
-  "import": "../../dist/reexports/chains_westend2.mjs",
+  "module": "../../dist/esm/reexports/chains_westend2.mjs",
+  "import": "../../dist/esm/reexports/chains_westend2.mjs",
   "require": "../../dist/reexports/chains_westend2.js",
   "default": "../../dist/reexports/chains_westend2.js"
 }

package/chains/westend2_asset_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_westend2_asset_hub",
   "types": "../../dist/reexports/chains_westend2_asset_hub.d.ts",
-  "module": "../../dist/reexports/chains_westend2_asset_hub.mjs",
-  "import": "../../dist/reexports/chains_westend2_asset_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_westend2_asset_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_westend2_asset_hub.mjs",
   "require": "../../dist/reexports/chains_westend2_asset_hub.js",
   "default": "../../dist/reexports/chains_westend2_asset_hub.js"
 }

package/chains/westend2_bridge_hub/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_westend2_bridge_hub",
   "types": "../../dist/reexports/chains_westend2_bridge_hub.d.ts",
-  "module": "../../dist/reexports/chains_westend2_bridge_hub.mjs",
-  "import": "../../dist/reexports/chains_westend2_bridge_hub.mjs",
+  "module": "../../dist/esm/reexports/chains_westend2_bridge_hub.mjs",
+  "import": "../../dist/esm/reexports/chains_westend2_bridge_hub.mjs",
   "require": "../../dist/reexports/chains_westend2_bridge_hub.js",
   "default": "../../dist/reexports/chains_westend2_bridge_hub.js"
 }

package/chains/westend2_collectives/package.json

@@ -1,8 +1,8 @@
 {
   "name": "polkadot-api_chains_westend2_collectives",
   "types": "../../dist/reexports/chains_westend2_collectives.d.ts",
-  "module": "../../dist/reexports/chains_westend2_collectives.mjs",
-  "import": "../../dist/reexports/chains_westend2_collectives.mjs",
+  "module": "../../dist/esm/reexports/chains_westend2_collectives.mjs",
+  "import": "../../dist/esm/reexports/chains_westend2_collectives.mjs",
   "require": "../../dist/reexports/chains_westend2_collectives.js",
   "default": "../../dist/reexports/chains_westend2_collectives.js"
 }

package/dist/esm/client.mjs

@@ -0,0 +1,150 @@
+import { storageEntryPoint, singleValueEntryPoint, runtimeCallEntryPoint, enumValueEntryPointNode, voidEntryPointNode } from '@polkadot-api/metadata-compatibility';
+import { getObservableClient } from '@polkadot-api/observable-client';
+import { createClient as createClient$1 } from '@polkadot-api/substrate-client';
+import { firstValueFrom } from 'rxjs';
+import { createCompatibilityToken, compatibilityHelper, OpType } from './compatibility.mjs';
+import { createConstantEntry } from './constants.mjs';
+import { createEventEntry } from './event.mjs';
+import { createRuntimeCallEntry } from './runtime-call.mjs';
+import { createStorageEntry } from './storage.mjs';
+import { createTxEntry } from './tx/tx.mjs';
+import { submit, submit$ } from './tx/submit-fns.mjs';
+
+const createTypedApi = (compatibilityToken, chainHead, broadcast$) => {
+  const target = {};
+  const createProxy = (propCall) => new Proxy(target, {
+    get(_, prop) {
+      return propCall(prop);
+    }
+  });
+  const createProxyPath = (pathCall) => {
+    const cache = {};
+    return createProxy((a) => {
+      if (!cache[a]) cache[a] = {};
+      return createProxy((b) => {
+        if (!cache[a][b]) cache[a][b] = pathCall(a, b);
+        return cache[a][b];
+      });
+    });
+  };
+  const getPallet = (ctx, name) => ctx.lookup.metadata.pallets.find((p) => p.name === name);
+  const query = createProxyPath(
+    (pallet, name) => createStorageEntry(
+      pallet,
+      name,
+      chainHead,
+      compatibilityHelper(
+        compatibilityToken,
+        (r) => r.getPalletEntryPoint(OpType.Storage, pallet, name),
+        // TODO this is way sub-optimal. Needs some rethought - maybe a builder for entry points?.
+        (ctx) => storageEntryPoint(
+          getPallet(ctx, pallet).storage.items.find((s) => s.name === name)
+        )
+      )
+    )
+  );
+  const getEnumEntry = (ctx, side, id, name) => {
+    const entry = ctx.lookup(id);
+    if (entry.type !== "enum") throw new Error("Expected enum");
+    const node = enumValueEntryPointNode(entry.value[name]);
+    return {
+      args: side === "args" ? node : voidEntryPointNode,
+      values: side === "args" ? voidEntryPointNode : node
+    };
+  };
+  const tx = createProxyPath(
+    (pallet, name) => createTxEntry(
+      pallet,
+      name,
+      chainHead,
+      broadcast$,
+      compatibilityHelper(
+        compatibilityToken,
+        (r) => r.getPalletEntryPoint(OpType.Tx, pallet, name),
+        (ctx) => getEnumEntry(ctx, "args", getPallet(ctx, pallet).calls, name)
+      )
+    )
+  );
+  const event = createProxyPath(
+    (pallet, name) => createEventEntry(
+      pallet,
+      name,
+      chainHead,
+      compatibilityHelper(
+        compatibilityToken,
+        (r) => r.getPalletEntryPoint(OpType.Event, pallet, name),
+        (ctx) => getEnumEntry(ctx, "values", getPallet(ctx, pallet).events, name)
+      )
+    )
+  );
+  const constants = createProxyPath(
+    (pallet, name) => createConstantEntry(
+      pallet,
+      name,
+      compatibilityHelper(
+        compatibilityToken,
+        (r) => r.getPalletEntryPoint(OpType.Const, pallet, name),
+        (ctx) => singleValueEntryPoint(
+          getPallet(ctx, pallet).constants.find((c) => c.name === name).type
+        )
+      )
+    )
+  );
+  const apis = createProxyPath(
+    (api, method) => createRuntimeCallEntry(
+      api,
+      method,
+      chainHead,
+      compatibilityHelper(
+        compatibilityToken,
+        (r) => r.getApiEntryPoint(api, method),
+        (ctx) => runtimeCallEntryPoint(
+          ctx.lookup.metadata.apis.find((a) => a.name === api).methods.find((m) => m.name === method)
+        )
+      )
+    )
+  );
+  return {
+    query,
+    tx,
+    event,
+    apis,
+    constants,
+    compatibilityToken
+  };
+};
+function createClient(provider) {
+  const rawClient = createClient$1(provider);
+  const client = getObservableClient(rawClient);
+  const chainHead = client.chainHead$();
+  const { getChainSpecData } = rawClient;
+  const _request = rawClient.request;
+  const compatibilityToken = /* @__PURE__ */ new WeakMap();
+  const getChainToken = (chainDefinition) => {
+    const result = compatibilityToken.get(chainDefinition) || createCompatibilityToken(chainDefinition, chainHead);
+    compatibilityToken.set(chainDefinition, result);
+    return result;
+  };
+  const { broadcastTx$ } = client;
+  return {
+    getChainSpecData,
+    finalizedBlock$: chainHead.finalized$,
+    getFinalizedBlock: () => firstValueFrom(chainHead.finalized$),
+    bestBlocks$: chainHead.bestBlocks$,
+    getBestBlocks: () => firstValueFrom(chainHead.bestBlocks$),
+    watchBlockBody: chainHead.body$,
+    getBlockBody: (hash) => firstValueFrom(chainHead.body$(hash)),
+    getBlockHeader: (hash) => firstValueFrom(chainHead.header$(hash ?? null)),
+    submit: (...args) => submit(chainHead, broadcastTx$, ...args),
+    submitAndWatch: (...args) => submit$(chainHead, broadcastTx$, ...args),
+    getTypedApi: (chainDefinition) => createTypedApi(getChainToken(chainDefinition), chainHead, broadcastTx$),
+    destroy: () => {
+      chainHead.unfollow();
+      client.destroy();
+    },
+    _request
+  };
+}
+
+export { createClient };
+//# sourceMappingURL=client.mjs.map

package/dist/esm/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","sources":["../../src/client.ts"],"sourcesContent":["import { JsonRpcProvider } from \"@polkadot-api/json-rpc-provider\"\nimport {\n  enumValueEntryPointNode,\n  runtimeCallEntryPoint,\n  singleValueEntryPoint,\n  storageEntryPoint,\n  voidEntryPointNode,\n} from \"@polkadot-api/metadata-compatibility\"\nimport {\n  RuntimeContext,\n  getObservableClient,\n} from \"@polkadot-api/observable-client\"\nimport {\n  SubstrateClient,\n  createClient as createRawClient,\n} from \"@polkadot-api/substrate-client\"\nimport { Observable, firstValueFrom } from \"rxjs\"\nimport {\n  CompatibilityToken,\n  OpType,\n  compatibilityHelper,\n  createCompatibilityToken,\n} from \"./compatibility\"\nimport { createConstantEntry } from \"./constants\"\nimport { ChainDefinition } from \"./descriptors\"\nimport { createEventEntry } from \"./event\"\nimport { createRuntimeCallEntry } from \"./runtime-call\"\nimport { createStorageEntry } from \"./storage\"\nimport { createTxEntry, submit, submit$ } from \"./tx\"\nimport { PolkadotClient, TypedApi } from \"./types\"\n\nconst createTypedApi = <D extends ChainDefinition>(\n  compatibilityToken: Promise<CompatibilityToken>,\n  chainHead: ReturnType<ReturnType<typeof getObservableClient>[\"chainHead$\"]>,\n  broadcast$: (tx: string) => Observable<never>,\n): TypedApi<D> => {\n  const target = {}\n  const createProxy = (propCall: (prop: string) => unknown) =>\n    new Proxy(target, {\n      get(_, prop) {\n        return propCall(prop as string)\n      },\n    })\n  const createProxyPath = <T>(pathCall: (a: string, b: string) => T) => {\n    const cache: Record<string, Record<string, T>> = {}\n    return createProxy((a) => {\n      if (!cache[a]) cache[a] = {}\n      return createProxy((b) => {\n        if (!cache[a][b]) cache[a][b] = pathCall(a, b)\n        return cache[a][b]\n      })\n    }) as Record<string, Record<string, T>>\n  }\n\n  const getPallet = (ctx: RuntimeContext, name: string) =>\n    ctx.lookup.metadata.pallets.find((p) => p.name === name)!\n  const query = createProxyPath((pallet, name) =>\n    createStorageEntry(\n      pallet,\n      name,\n      chainHead,\n      compatibilityHelper(\n        compatibilityToken,\n        (r) => r.getPalletEntryPoint(OpType.Storage, pallet, name),\n        // TODO this is way sub-optimal. Needs some rethought - maybe a builder for entry points?.\n        (ctx) =>\n          storageEntryPoint(\n            getPallet(ctx, pallet).storage!.items.find((s) => s.name === name)!,\n          ),\n      ),\n    ),\n  )\n\n  const getEnumEntry = (\n    ctx: RuntimeContext,\n    side: \"args\" | \"values\",\n    id: number,\n    name: string,\n  ) => {\n    const entry = ctx.lookup(id)\n    if (entry.type !== \"enum\") throw new Error(\"Expected enum\")\n\n    const node = enumValueEntryPointNode(entry.value[name])\n    return {\n      args: side === \"args\" ? node : voidEntryPointNode,\n      values: side === \"args\" ? voidEntryPointNode : node,\n    }\n  }\n  const tx = createProxyPath((pallet, name) =>\n    createTxEntry(\n      pallet,\n      name,\n      chainHead,\n      broadcast$,\n      compatibilityHelper(\n        compatibilityToken,\n        (r) => r.getPalletEntryPoint(OpType.Tx, pallet, name),\n        (ctx) => getEnumEntry(ctx, \"args\", getPallet(ctx, pallet).calls!, name),\n      ),\n    ),\n  )\n\n  const event = createProxyPath((pallet, name) =>\n    createEventEntry(\n      pallet,\n      name,\n      chainHead,\n      compatibilityHelper(\n        compatibilityToken,\n        (r) => r.getPalletEntryPoint(OpType.Event, pallet, name),\n        (ctx) =>\n          getEnumEntry(ctx, \"values\", getPallet(ctx, pallet).events!, name),\n      ),\n    ),\n  )\n\n  const constants = createProxyPath((pallet, name) =>\n    createConstantEntry(\n      pallet,\n      name,\n      compatibilityHelper(\n        compatibilityToken,\n        (r) => r.getPalletEntryPoint(OpType.Const, pallet, name),\n        (ctx) =>\n          singleValueEntryPoint(\n            getPallet(ctx, pallet).constants.find((c) => c.name === name)!.type,\n          ),\n      ),\n    ),\n  )\n\n  const apis = createProxyPath((api, method) =>\n    createRuntimeCallEntry(\n      api,\n      method,\n      chainHead,\n      compatibilityHelper(\n        compatibilityToken,\n        (r) => r.getApiEntryPoint(api, method),\n        (ctx) =>\n          runtimeCallEntryPoint(\n            ctx.lookup.metadata.apis\n              .find((a) => a.name === api)!\n              .methods.find((m) => m.name === method)!,\n          ),\n      ),\n    ),\n  )\n\n  return {\n    query,\n    tx,\n    event,\n    apis,\n    constants,\n    compatibilityToken,\n  } as any\n}\n\n/**\n * This is the top-level export for `polkadot-api`.\n *\n * @param provider  A `JsonRpcProvider` compliant with the [JSON-RPC\n *                  spec](https://paritytech.github.io/json-rpc-interface-spec/),\n *                  which must support the `chainHead`, `transaction` and\n *                  `chainSpec` groups.\n * @example\n *\n *   import { createClient } from \"polkadot-api\"\n *   import { getSmProvider } from \"polkadot-api/sm-provider\"\n *   import { chainSpec } from \"polkadot-api/chains/polkadot\"\n *   import { start } from \"polkadot-api/smoldot\"\n *\n *   const smoldot = start()\n *   const chain = await smoldot.addChain({ chainSpec })\n *\n *   // Connect to the polkadot relay chain.\n *   const client = createClient(getSmProvider(chain))\n *\n */\nexport function createClient(provider: JsonRpcProvider): PolkadotClient {\n  const rawClient: SubstrateClient = createRawClient(provider)\n  const client = getObservableClient(rawClient)\n  const chainHead = client.chainHead$()\n\n  const { getChainSpecData } = rawClient\n\n  const _request: <Reply = any, Params extends Array<any> = any[]>(\n    method: string,\n    params: Params,\n  ) => Promise<Reply> = rawClient.request\n\n  const compatibilityToken = new WeakMap<\n    ChainDefinition,\n    Promise<CompatibilityToken<any>>\n  >()\n  const getChainToken = (chainDefinition: ChainDefinition) => {\n    const result =\n      compatibilityToken.get(chainDefinition) ||\n      createCompatibilityToken(chainDefinition, chainHead)\n    compatibilityToken.set(chainDefinition, result)\n    return result\n  }\n\n  const { broadcastTx$ } = client\n  return {\n    getChainSpecData,\n\n    finalizedBlock$: chainHead.finalized$,\n    getFinalizedBlock: () => firstValueFrom(chainHead.finalized$),\n\n    bestBlocks$: chainHead.bestBlocks$,\n    getBestBlocks: () => firstValueFrom(chainHead.bestBlocks$),\n\n    watchBlockBody: chainHead.body$,\n    getBlockBody: (hash: string) => firstValueFrom(chainHead.body$(hash)),\n\n    getBlockHeader: (hash?: string) =>\n      firstValueFrom(chainHead.header$(hash ?? null)),\n\n    submit: (...args) => submit(chainHead, broadcastTx$, ...args),\n    submitAndWatch: (...args) => submit$(chainHead, broadcastTx$, ...args),\n\n    getTypedApi: <D extends ChainDefinition>(chainDefinition: D) =>\n      createTypedApi(getChainToken(chainDefinition), chainHead, broadcastTx$),\n\n    destroy: () => {\n      chainHead.unfollow()\n      client.destroy()\n    },\n\n    _request,\n  }\n}\n"],"names":["createRawClient"],"mappings":"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"}

package/dist/esm/compatibility.mjs

@@ -0,0 +1,132 @@
+import { EntryPointCodec, TypedefCodec, mapLookupToTypedef, entryPointsAreCompatible, CompatibilityLevel, valueIsCompatibleWithDest } from '@polkadot-api/metadata-compatibility';
+import { Vector, Tuple } from '@polkadot-api/substrate-bindings';
+import { filter, firstValueFrom, combineLatest, map } from 'rxjs';
+
+class CompatibilityToken {
+  // @ts-ignore
+  constructor(_descriptors) {
+    this._descriptors = _descriptors;
+  }
+}
+const compatibilityTokenApi = /* @__PURE__ */ new WeakMap();
+const getCompatibilityApi = (token) => compatibilityTokenApi.get(token);
+var OpType = /* @__PURE__ */ ((OpType2) => {
+  OpType2["Storage"] = "storage";
+  OpType2["Tx"] = "tx";
+  OpType2["Event"] = "events";
+  OpType2["Error"] = "errors";
+  OpType2["Const"] = "constants";
+  return OpType2;
+})(OpType || {});
+const EntryPointsCodec = Vector(EntryPointCodec);
+const TypedefsCodec = Vector(TypedefCodec);
+const TypesCodec = Tuple(EntryPointsCodec, TypedefsCodec);
+const createCompatibilityToken = (chainDefinition, chainHead) => {
+  const awaitedRuntime = new Promise(async (resolve) => {
+    const loadedRuntime$ = chainHead.runtime$.pipe(filter((v) => v != null));
+    let latest = await firstValueFrom(loadedRuntime$);
+    loadedRuntime$.subscribe((v) => latest = v);
+    resolve(() => latest);
+  });
+  const promise = Promise.all([
+    chainDefinition.metadataTypes.then(TypesCodec.dec),
+    chainDefinition.descriptors,
+    awaitedRuntime
+  ]).then(([[entryPoints, typedefNodes], descriptors, runtime]) => {
+    const token = new CompatibilityToken();
+    compatibilityTokenApi.set(token, {
+      runtime,
+      getPalletEntryPoint(opType, pallet, name) {
+        return entryPoints[descriptors[opType][pallet][name]];
+      },
+      getApiEntryPoint(name, method) {
+        return entryPoints[descriptors.apis[name][method]];
+      },
+      typedefNodes
+    });
+    return token;
+  });
+  return promise;
+};
+const metadataCache = /* @__PURE__ */ new WeakMap();
+const getMetadataCache = (ctx) => {
+  if (!metadataCache.has(ctx.metadataRaw)) {
+    metadataCache.set(ctx.metadataRaw, {
+      compat: /* @__PURE__ */ new Map(),
+      lookup: ctx.lookup,
+      typeNodes: []
+    });
+  }
+  return metadataCache.get(ctx.metadataRaw);
+};
+const compatibilityHelper = (descriptors, getDescriptorEntryPoint, getRuntimeEntryPoint) => {
+  const getRuntimeTypedef = (ctx, id) => {
+    var _a;
+    const cache = getMetadataCache(ctx);
+    return (_a = cache.typeNodes)[id] || (_a[id] = mapLookupToTypedef(cache.lookup(id)));
+  };
+  function getCompatibilityLevels(descriptors2, ctx) {
+    const compatibilityApi = compatibilityTokenApi.get(descriptors2);
+    ctx || (ctx = compatibilityApi.runtime());
+    const descriptorEntryPoint = getDescriptorEntryPoint(compatibilityApi);
+    const runtimeEntryPoint = getRuntimeEntryPoint(ctx);
+    const descriptorNodes = compatibilityApi.typedefNodes;
+    const cache = getMetadataCache(ctx);
+    return entryPointsAreCompatible(
+      descriptorEntryPoint,
+      (id) => descriptorNodes[id],
+      runtimeEntryPoint,
+      (id) => getRuntimeTypedef(ctx, id),
+      cache.compat
+    );
+  }
+  const getCompatibilityLevel = withOptionalToken(
+    descriptors,
+    (runtime) => minCompatLevel(getCompatibilityLevels(runtime))
+  );
+  const waitDescriptors = () => descriptors;
+  const compatibleRuntime$ = (chainHead, hash) => combineLatest([waitDescriptors(), chainHead.getRuntimeContext$(hash)]);
+  const withCompatibleRuntime = (chainHead, mapper) => (source$) => combineLatest([
+    source$.pipe(chainHead.withRuntime(mapper)),
+    waitDescriptors()
+  ]).pipe(map(([[x, ctx], descriptors2]) => [x, descriptors2, ctx]));
+  const argsAreCompatible = (descriptors2, ctx, args) => {
+    const levels = getCompatibilityLevels(descriptors2, ctx);
+    if (levels.args === CompatibilityLevel.Incompatible) return false;
+    if (levels.args > CompatibilityLevel.Partial) return true;
+    if (levels.values === CompatibilityLevel.Incompatible) return false;
+    const entryPoint = getRuntimeEntryPoint(ctx);
+    return valueIsCompatibleWithDest(
+      entryPoint.args,
+      (id) => getRuntimeTypedef(ctx, id),
+      args
+    );
+  };
+  const valuesAreCompatible = (descriptors2, ctx, values) => {
+    const level = getCompatibilityLevels(descriptors2, ctx).values;
+    if (level === CompatibilityLevel.Incompatible) return false;
+    if (level > CompatibilityLevel.Partial) return true;
+    const compatibilityApi = compatibilityTokenApi.get(descriptors2);
+    const entryPoint = getDescriptorEntryPoint(compatibilityApi);
+    return valueIsCompatibleWithDest(
+      entryPoint.values,
+      (id) => compatibilityApi.typedefNodes[id],
+      values
+    );
+  };
+  return {
+    getCompatibilityLevel,
+    getCompatibilityLevels,
+    waitDescriptors,
+    withCompatibleRuntime,
+    compatibleRuntime$,
+    argsAreCompatible,
+    valuesAreCompatible,
+    getRuntimeTypedef
+  };
+};
+const minCompatLevel = (levels) => Math.min(levels.args, levels.values);
+const withOptionalToken = (compatibilityToken, fn) => (runtime) => runtime ? fn(runtime) : compatibilityToken.then(fn);
+
+export { CompatibilityToken, OpType, compatibilityHelper, createCompatibilityToken, getCompatibilityApi, minCompatLevel };
+//# sourceMappingURL=compatibility.mjs.map

package/dist/esm/compatibility.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.mjs","sources":["../../src/compatibility.ts"],"sourcesContent":["import { MetadataLookup } from \"@polkadot-api/metadata-builders\"\nimport {\n  CompatibilityCache,\n  CompatibilityLevel,\n  EntryPoint,\n  EntryPointCodec,\n  TypedefCodec,\n  TypedefNode,\n  entryPointsAreCompatible,\n  mapLookupToTypedef,\n  valueIsCompatibleWithDest,\n} from \"@polkadot-api/metadata-compatibility\"\nimport {\n  ChainHead$,\n  getObservableClient,\n  RuntimeContext,\n} from \"@polkadot-api/observable-client\"\nimport { Tuple, Vector } from \"@polkadot-api/substrate-bindings\"\nimport { Observable, combineLatest, filter, firstValueFrom, map } from \"rxjs\"\nimport { ChainDefinition } from \"./descriptors\"\n\nexport class CompatibilityToken<D = unknown> {\n  // @ts-ignore\n  private constructor(protected _descriptors: D) {}\n}\n\ninterface CompatibilityTokenApi {\n  runtime: () => RuntimeContext\n  typedefNodes: TypedefNode[]\n  getPalletEntryPoint: (\n    opType: OpType,\n    pallet: string,\n    name: string,\n  ) => EntryPoint\n  getApiEntryPoint: (name: string, method: string) => EntryPoint\n}\nconst compatibilityTokenApi = new WeakMap<\n  CompatibilityToken,\n  CompatibilityTokenApi\n>()\nexport const getCompatibilityApi = (token: CompatibilityToken) =>\n  compatibilityTokenApi.get(token)!\n\nexport const enum OpType {\n  Storage = \"storage\",\n  Tx = \"tx\",\n  Event = \"events\",\n  Error = \"errors\",\n  Const = \"constants\",\n}\n\nconst EntryPointsCodec = Vector(EntryPointCodec)\nconst TypedefsCodec = Vector(TypedefCodec)\nconst TypesCodec = Tuple(EntryPointsCodec, TypedefsCodec)\n\nexport const createCompatibilityToken = <D extends ChainDefinition>(\n  chainDefinition: D,\n  chainHead: ReturnType<ReturnType<typeof getObservableClient>[\"chainHead$\"]>,\n): Promise<CompatibilityToken<D>> => {\n  const awaitedRuntime = new Promise<() => RuntimeContext>(async (resolve) => {\n    const loadedRuntime$ = chainHead.runtime$.pipe(filter((v) => v != null))\n\n    let latest = await firstValueFrom(loadedRuntime$)\n    loadedRuntime$.subscribe((v) => (latest = v))\n\n    resolve(() => latest)\n  })\n\n  const promise = Promise.all([\n    chainDefinition.metadataTypes.then(TypesCodec.dec),\n    chainDefinition.descriptors,\n    awaitedRuntime,\n  ]).then(([[entryPoints, typedefNodes], descriptors, runtime]) => {\n    const token = new (CompatibilityToken as any)()\n    compatibilityTokenApi.set(token, {\n      runtime,\n      getPalletEntryPoint(opType, pallet, name) {\n        return entryPoints[descriptors[opType][pallet][name]]\n      },\n      getApiEntryPoint(name, method) {\n        return entryPoints[descriptors.apis[name][method]]\n      },\n      typedefNodes,\n    })\n\n    return token\n  })\n\n  return promise\n}\n\n// metadataRaw -> cache\nconst metadataCache = new WeakMap<\n  Uint8Array,\n  {\n    compat: CompatibilityCache\n    lookup: MetadataLookup\n    typeNodes: (TypedefNode | null)[]\n  }\n>()\nconst getMetadataCache = (ctx: RuntimeContext) => {\n  if (!metadataCache.has(ctx.metadataRaw)) {\n    metadataCache.set(ctx.metadataRaw, {\n      compat: new Map(),\n      lookup: ctx.lookup,\n      typeNodes: [],\n    })\n  }\n  return metadataCache.get(ctx.metadataRaw)!\n}\nexport const compatibilityHelper = (\n  descriptors: Promise<CompatibilityToken>,\n  getDescriptorEntryPoint: (descriptorApi: CompatibilityTokenApi) => EntryPoint,\n  getRuntimeEntryPoint: (ctx: RuntimeContext) => EntryPoint,\n) => {\n  const getRuntimeTypedef = (ctx: RuntimeContext, id: number) => {\n    const cache = getMetadataCache(ctx)\n    return (cache.typeNodes[id] ||= mapLookupToTypedef(cache.lookup(id)))\n  }\n\n  function getCompatibilityLevels(\n    descriptors: CompatibilityToken,\n    /**\n     * The `Runtime` of runtimeWithDescriptors already has a RuntimeContext,\n     * which is the runtime of the finalized block.\n     * But on some cases, the user wants to perform an action on a specific\n     * block hash, which has a different RuntimeContext.\n     */\n    ctx?: RuntimeContext,\n  ) {\n    const compatibilityApi = compatibilityTokenApi.get(descriptors)!\n    ctx ||= compatibilityApi.runtime()\n    const descriptorEntryPoint = getDescriptorEntryPoint(compatibilityApi)\n    const runtimeEntryPoint = getRuntimeEntryPoint(ctx)\n    const descriptorNodes = compatibilityApi.typedefNodes\n\n    const cache = getMetadataCache(ctx)\n\n    return entryPointsAreCompatible(\n      descriptorEntryPoint,\n      (id) => descriptorNodes[id],\n      runtimeEntryPoint,\n      (id) => getRuntimeTypedef(ctx, id),\n      cache.compat,\n    )\n  }\n\n  const getCompatibilityLevel = withOptionalToken(descriptors, (runtime) =>\n    minCompatLevel(getCompatibilityLevels(runtime)),\n  )\n\n  const waitDescriptors = () => descriptors\n  const compatibleRuntime$ = (chainHead: ChainHead$, hash: string | null) =>\n    combineLatest([waitDescriptors(), chainHead.getRuntimeContext$(hash)])\n\n  const withCompatibleRuntime =\n    <T>(chainHead: ChainHead$, mapper: (x: T) => string) =>\n    (\n      source$: Observable<T>,\n    ): Observable<[T, CompatibilityToken, RuntimeContext]> =>\n      combineLatest([\n        source$.pipe(chainHead.withRuntime(mapper)),\n        waitDescriptors(),\n      ]).pipe(map(([[x, ctx], descriptors]) => [x, descriptors, ctx]))\n\n  const argsAreCompatible = (\n    descriptors: CompatibilityToken,\n    ctx: RuntimeContext,\n    args: unknown,\n  ) => {\n    const levels = getCompatibilityLevels(descriptors, ctx)\n    if (levels.args === CompatibilityLevel.Incompatible) return false\n    if (levels.args > CompatibilityLevel.Partial) return true\n    // Although technically args could still be compatible, if the output will be incompatible we might as well just return false to skip sending the request.\n    if (levels.values === CompatibilityLevel.Incompatible) return false\n\n    const entryPoint = getRuntimeEntryPoint(ctx)\n\n    return valueIsCompatibleWithDest(\n      entryPoint.args,\n      (id) => getRuntimeTypedef(ctx, id),\n      args,\n    )\n  }\n  const valuesAreCompatible = (\n    descriptors: CompatibilityToken,\n    ctx: RuntimeContext,\n    values: unknown,\n  ) => {\n    const level = getCompatibilityLevels(descriptors, ctx).values\n    if (level === CompatibilityLevel.Incompatible) return false\n    if (level > CompatibilityLevel.Partial) return true\n\n    const compatibilityApi = compatibilityTokenApi.get(descriptors)!\n\n    const entryPoint = getDescriptorEntryPoint(compatibilityApi)\n\n    return valueIsCompatibleWithDest(\n      entryPoint.values,\n      (id) => compatibilityApi.typedefNodes[id],\n      values,\n    )\n  }\n\n  return {\n    getCompatibilityLevel,\n    getCompatibilityLevels,\n    waitDescriptors,\n    withCompatibleRuntime,\n    compatibleRuntime$,\n    argsAreCompatible,\n    valuesAreCompatible,\n    getRuntimeTypedef,\n  }\n}\nexport type CompatibilityHelper = ReturnType<typeof compatibilityHelper>\n\nexport const minCompatLevel = (levels: {\n  args: CompatibilityLevel\n  values: CompatibilityLevel\n}) => Math.min(levels.args, levels.values)\n\nconst withOptionalToken =\n  <T, D>(\n    compatibilityToken: Promise<CompatibilityToken<D>>,\n    fn: (runtime: CompatibilityToken) => T,\n  ): WithOptionalRuntime<T, D> =>\n  (runtime?: CompatibilityToken): any =>\n    runtime ? fn(runtime) : compatibilityToken.then(fn)\n\nexport type WithOptionalRuntime<T, D> = {\n  /**\n   * Returns the result after waiting for the runtime to load.\n   */\n  (): Promise<T>\n  /**\n   * Returns the result synchronously with the loaded runtime.\n   */\n  (runtime: CompatibilityToken<D>): T\n}\n\nexport interface CompatibilityFunctions<D> {\n  /**\n   * Returns the `CompatibilityLevel` for this call comparing the descriptors\n   * generated on dev time with the current live metadata.\n   */\n  getCompatibilityLevel: WithOptionalRuntime<CompatibilityLevel, D>\n}\n"],"names":["OpType","descriptors"],"mappings":"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"}

package/dist/esm/constants.mjs

@@ -0,0 +1,37 @@
+import { getCompatibilityApi } from './compatibility.mjs';
+
+const createConstantEntry = (palletName, name, {
+  valuesAreCompatible,
+  waitDescriptors,
+  getCompatibilityLevel
+}) => {
+  const cachedResults = /* @__PURE__ */ new WeakMap();
+  const getValueWithContext = (ctx) => {
+    if (cachedResults.has(ctx)) {
+      return cachedResults.get(ctx);
+    }
+    const pallet = ctx.lookup.metadata.pallets.find(
+      (p) => p.name === palletName
+    );
+    const constant = pallet?.constants.find((c) => c.name === name);
+    const result = ctx.dynamicBuilder.buildConstant(palletName, name).dec(constant.value);
+    cachedResults.set(ctx, result);
+    return result;
+  };
+  const fn = (compatibilityToken) => {
+    if (compatibilityToken) {
+      const ctx = getCompatibilityApi(compatibilityToken).runtime();
+      const value = getValueWithContext(ctx);
+      if (!valuesAreCompatible(compatibilityToken, ctx, value))
+        throw new Error(
+          `Incompatible runtime entry Constant(${palletName}.${name})`
+        );
+      return value;
+    }
+    return waitDescriptors().then(fn);
+  };
+  return Object.assign(fn, { getCompatibilityLevel });
+};
+
+export { createConstantEntry };
+//# sourceMappingURL=constants.mjs.map

package/dist/esm/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sources":["../../src/constants.ts"],"sourcesContent":["import { RuntimeContext } from \"@polkadot-api/observable-client\"\nimport {\n  CompatibilityFunctions,\n  CompatibilityHelper,\n  CompatibilityToken,\n  getCompatibilityApi,\n} from \"./compatibility\"\n\nexport interface ConstantEntry<D, T> extends CompatibilityFunctions<D> {\n  /**\n   * Constants are simple key-value structures found in the runtime metadata.\n   *\n   * @returns Promise that will resolve in the value of the constant.\n   */\n  (): Promise<T>\n  /**\n   * @param compatibilityToken  Token from got with `await\n   *                            typedApi.compatibilityToken`\n   * @returns Synchronously returns value of the constant.\n   */\n  (compatibilityToken: CompatibilityToken): T\n}\n\nexport const createConstantEntry = <D, T>(\n  palletName: string,\n  name: string,\n  {\n    valuesAreCompatible,\n    waitDescriptors,\n    getCompatibilityLevel,\n  }: CompatibilityHelper,\n): ConstantEntry<D, T> => {\n  const cachedResults = new WeakMap<RuntimeContext, T>()\n  const getValueWithContext = (ctx: RuntimeContext) => {\n    if (cachedResults.has(ctx)) {\n      return cachedResults.get(ctx)!\n    }\n\n    const pallet = ctx.lookup.metadata.pallets.find(\n      (p) => p.name === palletName,\n    )\n    const constant = pallet?.constants.find((c) => c.name === name)!\n    const result = ctx.dynamicBuilder\n      .buildConstant(palletName, name)\n      .dec(constant.value)\n    cachedResults.set(ctx, result)\n    return result\n  }\n\n  const fn = (compatibilityToken?: CompatibilityToken): any => {\n    if (compatibilityToken) {\n      const ctx = getCompatibilityApi(compatibilityToken).runtime()\n      const value = getValueWithContext(ctx)\n      if (!valuesAreCompatible(compatibilityToken, ctx, value))\n        throw new Error(\n          `Incompatible runtime entry Constant(${palletName}.${name})`,\n        )\n      return value\n    }\n    return waitDescriptors().then(fn)\n  }\n\n  return Object.assign(fn, { getCompatibilityLevel })\n}\n"],"names":[],"mappings":";;AAuBa,MAAA,mBAAA,GAAsB,CACjC,UAAA,EACA,IACA,EAAA;AAAA,EACE,mBAAA;AAAA,EACA,eAAA;AAAA,EACA,qBAAA;AACF,CACwB,KAAA;AACxB,EAAM,MAAA,aAAA,uBAAoB,OAA2B,EAAA,CAAA;AACrD,EAAM,MAAA,mBAAA,GAAsB,CAAC,GAAwB,KAAA;AACnD,IAAI,IAAA,aAAA,CAAc,GAAI,CAAA,GAAG,CAAG,EAAA;AAC1B,MAAO,OAAA,aAAA,CAAc,IAAI,GAAG,CAAA,CAAA;AAAA,KAC9B;AAEA,IAAA,MAAM,MAAS,GAAA,GAAA,CAAI,MAAO,CAAA,QAAA,CAAS,OAAQ,CAAA,IAAA;AAAA,MACzC,CAAC,CAAM,KAAA,CAAA,CAAE,IAAS,KAAA,UAAA;AAAA,KACpB,CAAA;AACA,IAAM,MAAA,QAAA,GAAW,QAAQ,SAAU,CAAA,IAAA,CAAK,CAAC,CAAM,KAAA,CAAA,CAAE,SAAS,IAAI,CAAA,CAAA;AAC9D,IAAM,MAAA,MAAA,GAAS,IAAI,cAChB,CAAA,aAAA,CAAc,YAAY,IAAI,CAAA,CAC9B,GAAI,CAAA,QAAA,CAAS,KAAK,CAAA,CAAA;AACrB,IAAc,aAAA,CAAA,GAAA,CAAI,KAAK,MAAM,CAAA,CAAA;AAC7B,IAAO,OAAA,MAAA,CAAA;AAAA,GACT,CAAA;AAEA,EAAM,MAAA,EAAA,GAAK,CAAC,kBAAiD,KAAA;AAC3D,IAAA,IAAI,kBAAoB,EAAA;AACtB,MAAA,MAAM,GAAM,GAAA,mBAAA,CAAoB,kBAAkB,CAAA,CAAE,OAAQ,EAAA,CAAA;AAC5D,MAAM,MAAA,KAAA,GAAQ,oBAAoB,GAAG,CAAA,CAAA;AACrC,MAAA,IAAI,CAAC,mBAAA,CAAoB,kBAAoB,EAAA,GAAA,EAAK,KAAK,CAAA;AACrD,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,oCAAA,EAAuC,UAAU,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,CAAA;AAAA,SAC3D,CAAA;AACF,MAAO,OAAA,KAAA,CAAA;AAAA,KACT;AACA,IAAO,OAAA,eAAA,EAAkB,CAAA,IAAA,CAAK,EAAE,CAAA,CAAA;AAAA,GAClC,CAAA;AAEA,EAAA,OAAO,MAAO,CAAA,MAAA,CAAO,EAAI,EAAA,EAAE,uBAAuB,CAAA,CAAA;AACpD;;;;"}