@polkadot-api/substrate-client 0.0.1-ff4e99b70602ea882d2c55b6adafc6b6ec8a0da2.1.0 → 0.0.1

package/README.md

@@ -1 +1,211 @@
 # @polkadot-api/substrate-client
+
+This TypeScript package provides low-level bindings to the [Substrate JSON-RPC Interface](https://paritytech.github.io/json-rpc-interface-spec/introduction.html), enabling interaction with Substrate-based blockchains.
+
+## Usage
+
+Start by creating a `SubstrateClient` object with the exported function `createClient`. To create one, you need a `ConnectProvider` provider defined in [@polkadot-api/json-rpc-provider](https://github.com/polkadot-api/polkadot-api/tree/main/packages/json-rpc-provider) for establishing a connection to a specific blockchain client.
+
+For instance, you can use [@polkadot-api/sc-provider](https://github.com/polkadot-api/polkadot-api/tree/main/packages/sc-provider) to get a substrate-connect provider for connecting to the Polkadot relay chain through a light client:
+
+```ts
+import { getScProvider, WellKnownChain } from "@polkadot-api/sc-provider"
+import { createClient } from "@polkadot-api/substrate-client"
+
+const scProvider = getScProvider()
+const { relayChain } = scProvider(WellKnownChain.polkadot)
+
+const client = createClient(relayChain)
+```
+
+### Request
+
+Invoke any method defined in the [JSON-RPC Spec](https://paritytech.github.io/json-rpc-interface-spec/introduction.html) using `client.request(method, params, abortSignal?)`. This returns a promise resolving with the response from the JSON-RPC server.
+
+```ts
+const genesisHash = await client.request("chainSpec_v1_genesisHash", [])
+```
+
+All promise-returning functions exported by this package accept an [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) for operation cancellation.
+
+### ChainHead
+
+Operations within the [`chainHead` group of functions](https://paritytech.github.io/json-rpc-interface-spec/api/chainHead.html) involve subscriptions and interdependencies between methods. The client has a function that simplifies the interaction with these group.
+
+Calling `client.chainHead(withRuntime, onFollowEvent, onFollowError)` will start a `chainHead_unstable_follow` subscription, and will return a handle to perform operations with the chainHead.
+
+```ts
+const chainHead = client.chainHead(
+  true,
+  (event) => {
+    // ...
+  },
+  (error) => {
+    // ...
+  },
+)
+```
+
+The handle provides one method per each of the functions defined inside `chainHead`: `chainHead_unstable_body`, `chainHead_unstable_call`, `chainHead_unstable_header`, `chainHead_unstable_storage`, and `chainHead_unstable_unpin`.
+
+The JSON-RPC Spec for chainHead specifies that these functions return an `operationId`, and that the resolved response for the call will come through the `chainHead_unstable_follow` subscription, linking it through this `operationId`.
+
+**`substrate-client`'s chainHead is an abstraction over this**: The events emitted through the `client.chainHead()` callback are only the ones initiated from the JSON-RPC Server. The promise returned by any of the `chainHead`'s handle functions will resolve with the respective event.
+
+```ts
+const chainHead = client.chainHead(
+  true,
+  async (event) => {
+    if (event.type === "newBlock") {
+      const body = await chainHead.body(event.blockHash)
+      // body is a string[] containing the SCALE-encoded values within the body
+      processBody(body)
+
+      chainHead.unpin([event.blockHash])
+    }
+  },
+  (error) => {
+    // ...
+  },
+)
+```
+
+#### header
+
+Calls `chainHead_unstable_call` and returns a promise that resolves with the SCALE-encoded header of the block
+
+```ts
+const header = await chainHead.header(blockHash)
+```
+
+#### body
+
+Calls `chainHead_unstable_body` and returns a promise that will resolve with an array of strings containing the SCALE-encoded extrinsics found in the block
+
+```ts
+const body = await chainHead.body(blockHash)
+```
+
+#### call
+
+Calls `chainHead_unstable_header` and returns a promise that resolves with the encoded output of the runtime function call
+
+```ts
+const result = await chainHead.call(blockHash, fnName, callParameters)
+```
+
+#### storage
+
+Calls `chainHead_unstable_storage` and returns a promise that resolves with the value returned by the JSON-RPC server, which depends on the `type` parameter. See the [JSON-RPC spec for chainHead_unstable_storage](https://paritytech.github.io/json-rpc-interface-spec/api/chainHead_unstable_storage.html) for the details on the usage.
+
+```ts
+// string with the SCALE-encoded value
+const value = await chainHead.storage(blockHash, "value", key, childTrie)
+
+// string with the hash value
+const hash = await chainHead.storage(blockHash, "hash", key, childTrie)
+
+// string with the merkle value
+const items = await chainHead.storage(
+  blockHash,
+  "closestDescendantMerkleValue",
+  key,
+  childTrie,
+)
+
+// array of key-value pairs
+const items = await chainHead.storage(
+  blockHash,
+  "descendantsValues",
+  key,
+  childTrie,
+)
+
+// array of key-hash pairs
+const hashes = await chainHead.storage(
+  blockHash,
+  "descendantsHashes",
+  key,
+  childTrie,
+)
+```
+
+#### storageSubscription
+
+While `storage` only can resolve for one specific item, the JSON-RPC specification allows to resolve multiple items within the same call. For this case, substrate-client also offers a lower-level version called `chainHead.storageSubscription(hash, inputs, childTrie, onItems, onError, onDone, onDiscardedItems)` that emits the storage items as they get resolved by the JSON-RPC server:
+
+```ts
+const abort = chainHead.storageSubscription(
+  hash,
+  [
+    { key, type },
+    /* ... each item */
+  ],
+  null,
+  (items) => {
+    // items is an array of { key, value?, hash?, closestDescendantMerkleValue? }
+  },
+  onError,
+  onDone,
+  (nDiscardedItems) => {
+    // amount of discarded items, as defined by the JSON-RPC spec.
+  },
+)
+```
+
+`storageSubscription` returns a function to cancel the operation.
+
+#### unpin
+
+Calls `chainHead_unstable_unpin` and returns a promise that will resolve after the operation is done.
+
+```ts
+chainHead.unpin(blockHashes)
+```
+
+#### unfollow
+
+To close the chainHead subscription, call `chainHead.unfollow()`.
+
+### Transaction
+
+[`transaction` group of functions](https://paritytech.github.io/json-rpc-interface-spec/api/transaction.html) also deals with subscriptions through `submitAndWatch`. SubstrateClient also abstracts over this:
+
+```ts
+const cancelRequest = client.transaction(
+  transaction, // SCALE-encoded transaction
+  (event) => {
+    // ...
+  },
+  (error) => {
+    // ...
+  },
+)
+
+// call `cancelRequest()` to abort the transaction (`transaction_unstable_stop`)
+```
+
+The `event` emitted through the callback are fully typed, and can be discriminated through `event.type`
+
+```ts
+switch (event.type) {
+  case "validated":
+    break
+  case "broadcasted":
+    const { numPeers } = event
+    break
+  case "bestChainBlockIncluded":
+  case "finalized":
+    const { block } = event
+    break
+  case "dropped":
+  case "error":
+  case "invalid":
+    const { error } = event
+    break
+}
+```
+
+### Destroy
+
+Call `client.destroy()` to disconnect from the provider.

package/dist/index.d.mts

@@ -1,5 +1,4 @@
-import { ConnectProvider } from '@polkadot-api/json-rpc-provider';
-export { ConnectProvider, Provider } from '@polkadot-api/json-rpc-provider';
+import { JsonRpcProvider } from '@polkadot-api/json-rpc-provider';
 
 interface IRpcError {
     code: number;
@@ -24,7 +23,7 @@ interface Subscriber<T> {
     error: (e: Error) => void;
 }
 
-type FollowSubscriptionCb<T> = (subscriptionId: string, cb: Subscriber<T>) => UnsubscribeFn;
+type FollowSubscriptionCb<T> = (methodName: string, subscriptionId: string, cb: Subscriber<T>) => UnsubscribeFn;
 type ClientRequestCb<T, TT> = {
     onSuccess: (result: T, followSubscription: FollowSubscriptionCb<TT>) => void;
     onError: (e: Error) => void;
@@ -35,6 +34,16 @@ interface Client {
     request: ClientRequest<any, any>;
 }
 
+declare class DestroyedError extends Error {
+    constructor();
+}
+
+type FollowInnerSubscriptionCb<T> = (subscriptionId: string, cb: Subscriber<T>) => UnsubscribeFn;
+type ClientInnerRequestCb<T, TT> = {
+    onSuccess: (result: T, followSubscription: FollowInnerSubscriptionCb<TT>) => void;
+    onError: (e: Error) => void;
+};
+type ClientInnerRequest<T, TT> = (method: string, params: Array<any>, cb?: ClientInnerRequestCb<T, TT>) => UnsubscribeFn;
 interface StorageItemInput {
     key: string;
     type: "value" | "hash" | "closestDescendantMerkleValue" | "descendantsValues" | "descendantsHashes";
@@ -55,7 +64,7 @@ interface Runtime {
 }
 interface Initialized {
     type: "initialized";
-    finalizedBlockHash: string;
+    finalizedBlockHashes: string[];
 }
 type InitializedWithRuntime$1 = Initialized & {
     finalizedBlockRuntime: Runtime;
@@ -99,11 +108,12 @@ interface FollowResponse {
     storageSubscription: (hash: string, inputs: Array<StorageItemInput>, childTrie: string | null, onItems: (items: Array<StorageItemResponse>) => void, onError: (e: Error) => void, onDone: () => void, onDiscardedItems: (nDiscarded: number) => void) => () => void;
     header: (hash: string) => Promise<string>;
     unpin: (hashes: Array<string>) => Promise<void>;
-    _request: <Reply, Notification>(method: string, params: any[], cb?: ClientRequestCb<Reply, Notification>) => UnsubscribeFn;
+    _request: <Reply, Notification>(method: string, params: any[], cb?: ClientInnerRequestCb<Reply, Notification>) => UnsubscribeFn;
 }
 interface ChainHead {
     (withRuntime: false, cb: (event: FollowEventWithoutRuntime) => void, onError: (error: Error) => void): FollowResponse;
     (withRuntime: true, cb: (event: FollowEventWithRuntime) => void, onError: (error: Error) => void): FollowResponse;
+    (withRuntime: boolean, cb: (event: FollowEventWithoutRuntime | FollowEventWithRuntime) => void, onError: (error: Error) => void): FollowResponse;
 }
 
 declare class StopError extends Error {
@@ -130,10 +140,13 @@ interface RuntimeRpc {
     transactionVersion: number;
     apis: Record<string, number>;
 }
-interface InitializedRpc {
+type InitializedRpc = {
     event: "initialized";
     finalizedBlockHash: string;
-}
+} | {
+    event: "initialized";
+    finalizedBlockHashes: string[];
+};
 type InitializedWithRuntime = InitializedRpc & {
     finalizedBlockRuntime: RuntimeRpc;
 };
@@ -200,97 +213,17 @@ type OperationEventsRpc = OperationBodyDoneRpc | OperationCallDoneRpc | Operatio
 type FollowEventRpc = FollowEventWithRuntimeRpc | FollowEventWithoutRuntimeRpc | OperationEventsRpc | StopRpc;
 declare function getChainHead(request: ClientRequest<string, FollowEventRpc>): ChainHead;
 
-interface TxValidated {
-    type: "validated";
-}
-interface TxBroadcasted {
-    type: "broadcasted";
-    numPeers: number;
-}
-interface TxBestChainBlockIncluded {
-    type: "bestChainBlockIncluded";
-    block: {
-        hash: string;
-        index: number;
-    } | null;
-}
-interface TxFinalized {
-    type: "finalized";
-    block: {
-        hash: string;
-        index: number;
-    };
-}
-interface TxInvalid {
-    type: "invalid";
-    error: string;
-}
-interface TxDropped {
-    type: "dropped";
-    broadcasted: boolean;
-    error: string;
-}
-interface TxError {
-    type: "error";
-    error: string;
-}
-type TxEvent = TxValidated | TxBroadcasted | TxBestChainBlockIncluded | TxFinalized | TxInvalid | TxDropped | TxError;
-type Transaction = (tx: string, next: (event: TxEvent) => void, error: (e: Error) => void) => UnsubscribeFn;
-
-interface TxValidatedRpc {
-    event: "validated";
-}
-interface TxBroadcastedRpc {
-    event: "broadcasted";
-    numPeers: number;
-}
-interface TxBestChainBlockIncludedRpc {
-    event: "bestChainBlockIncluded";
-    block: {
-        hash: string;
-        index: number;
-    } | null;
-}
-interface TxFinalizedRpc {
-    event: "finalized";
-    block: {
-        hash: string;
-        index: number;
-    };
-}
-interface TxInvalidRpc {
-    event: "invalid";
-    error: string;
-}
-interface TxDroppedRpc {
-    event: "dropped";
-    broadcasted: boolean;
-    error: string;
-}
-interface TxErrorRpc {
-    event: "error";
-    error: string;
-}
-type TxEventRpc = TxValidatedRpc | TxBroadcastedRpc | TxBestChainBlockIncludedRpc | TxFinalizedRpc | TxInvalidRpc | TxDroppedRpc | TxErrorRpc;
+type Transaction = (tx: string, error: (e: Error) => void) => UnsubscribeFn;
 
-type ErrorEvents = TxDroppedRpc | TxInvalidRpc | TxErrorRpc;
-interface ITxError {
-    type: ErrorEvents["event"];
-    error: string;
-}
-declare class TransactionError extends Error implements ITxError {
-    type: "error" | "invalid" | "dropped";
-    error: string;
-    constructor(e: ErrorEvents);
-}
-declare const getTransaction: (request: ClientRequest<string, TxEventRpc>) => Transaction;
+declare const getTransaction: (request: ClientRequest<string, any>, rpcMethods: Promise<Set<string>> | Set<string>) => (tx: string, error: (e: Error) => void) => () => void;
 
 interface SubstrateClient {
     chainHead: ChainHead;
     transaction: Transaction;
     destroy: UnsubscribeFn;
+    request: <T>(method: string, params: any[], abortSignal?: AbortSignal) => Promise<T>;
     _request: <Reply, Notification>(method: string, params: any[], cb?: ClientRequestCb<Reply, Notification>) => UnsubscribeFn;
 }
-declare const createClient: (provider: ConnectProvider) => SubstrateClient;
+declare const createClient: (provider: JsonRpcProvider) => SubstrateClient;
 
-export { AbortablePromiseFn, BestBlockChanged, ChainHead, Client, ClientRequest, ClientRequestCb, DisjointError, Finalized, FollowEventWithRuntime, FollowEventWithoutRuntime, FollowResponse, FollowSubscriptionCb, IRpcError, Initialized, InitializedWithRuntime$1 as InitializedWithRuntime, NewBlock, NewBlockWithRuntime$1 as NewBlockWithRuntime, OperationError, OperationInaccessibleError, OperationLimitError, RpcError, Runtime, StopError, StorageItemInput, StorageItemResponse, StorageResult, SubstrateClient, Transaction, TransactionError, TxBestChainBlockIncluded, TxBroadcasted, TxDropped, TxError, TxEvent, TxFinalized, TxInvalid, TxValidated, UnsubscribeFn, createClient, getChainHead, getTransaction };
+export { type AbortablePromiseFn, type BestBlockChanged, type ChainHead, type Client, type ClientInnerRequest, type ClientInnerRequestCb, type ClientRequest, type ClientRequestCb, DestroyedError, DisjointError, type Finalized, type FollowEventWithRuntime, type FollowEventWithoutRuntime, type FollowInnerSubscriptionCb, type FollowResponse, type FollowSubscriptionCb, type IRpcError, type Initialized, type InitializedWithRuntime$1 as InitializedWithRuntime, type NewBlock, type NewBlockWithRuntime$1 as NewBlockWithRuntime, OperationError, OperationInaccessibleError, OperationLimitError, RpcError, type Runtime, StopError, type StorageItemInput, type StorageItemResponse, type StorageResult, type SubstrateClient, type Transaction, type UnsubscribeFn, createClient, getChainHead, getTransaction };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { ConnectProvider } from '@polkadot-api/json-rpc-provider';
-export { ConnectProvider, Provider } from '@polkadot-api/json-rpc-provider';
+import { JsonRpcProvider } from '@polkadot-api/json-rpc-provider';
 
 interface IRpcError {
     code: number;
@@ -24,7 +23,7 @@ interface Subscriber<T> {
     error: (e: Error) => void;
 }
 
-type FollowSubscriptionCb<T> = (subscriptionId: string, cb: Subscriber<T>) => UnsubscribeFn;
+type FollowSubscriptionCb<T> = (methodName: string, subscriptionId: string, cb: Subscriber<T>) => UnsubscribeFn;
 type ClientRequestCb<T, TT> = {
     onSuccess: (result: T, followSubscription: FollowSubscriptionCb<TT>) => void;
     onError: (e: Error) => void;
@@ -35,6 +34,16 @@ interface Client {
     request: ClientRequest<any, any>;
 }
 
+declare class DestroyedError extends Error {
+    constructor();
+}
+
+type FollowInnerSubscriptionCb<T> = (subscriptionId: string, cb: Subscriber<T>) => UnsubscribeFn;
+type ClientInnerRequestCb<T, TT> = {
+    onSuccess: (result: T, followSubscription: FollowInnerSubscriptionCb<TT>) => void;
+    onError: (e: Error) => void;
+};
+type ClientInnerRequest<T, TT> = (method: string, params: Array<any>, cb?: ClientInnerRequestCb<T, TT>) => UnsubscribeFn;
 interface StorageItemInput {
     key: string;
     type: "value" | "hash" | "closestDescendantMerkleValue" | "descendantsValues" | "descendantsHashes";
@@ -55,7 +64,7 @@ interface Runtime {
 }
 interface Initialized {
     type: "initialized";
-    finalizedBlockHash: string;
+    finalizedBlockHashes: string[];
 }
 type InitializedWithRuntime$1 = Initialized & {
     finalizedBlockRuntime: Runtime;
@@ -99,11 +108,12 @@ interface FollowResponse {
     storageSubscription: (hash: string, inputs: Array<StorageItemInput>, childTrie: string | null, onItems: (items: Array<StorageItemResponse>) => void, onError: (e: Error) => void, onDone: () => void, onDiscardedItems: (nDiscarded: number) => void) => () => void;
     header: (hash: string) => Promise<string>;
     unpin: (hashes: Array<string>) => Promise<void>;
-    _request: <Reply, Notification>(method: string, params: any[], cb?: ClientRequestCb<Reply, Notification>) => UnsubscribeFn;
+    _request: <Reply, Notification>(method: string, params: any[], cb?: ClientInnerRequestCb<Reply, Notification>) => UnsubscribeFn;
 }
 interface ChainHead {
     (withRuntime: false, cb: (event: FollowEventWithoutRuntime) => void, onError: (error: Error) => void): FollowResponse;
     (withRuntime: true, cb: (event: FollowEventWithRuntime) => void, onError: (error: Error) => void): FollowResponse;
+    (withRuntime: boolean, cb: (event: FollowEventWithoutRuntime | FollowEventWithRuntime) => void, onError: (error: Error) => void): FollowResponse;
 }
 
 declare class StopError extends Error {
@@ -130,10 +140,13 @@ interface RuntimeRpc {
     transactionVersion: number;
     apis: Record<string, number>;
 }
-interface InitializedRpc {
+type InitializedRpc = {
     event: "initialized";
     finalizedBlockHash: string;
-}
+} | {
+    event: "initialized";
+    finalizedBlockHashes: string[];
+};
 type InitializedWithRuntime = InitializedRpc & {
     finalizedBlockRuntime: RuntimeRpc;
 };
@@ -200,97 +213,17 @@ type OperationEventsRpc = OperationBodyDoneRpc | OperationCallDoneRpc | Operatio
 type FollowEventRpc = FollowEventWithRuntimeRpc | FollowEventWithoutRuntimeRpc | OperationEventsRpc | StopRpc;
 declare function getChainHead(request: ClientRequest<string, FollowEventRpc>): ChainHead;
 
-interface TxValidated {
-    type: "validated";
-}
-interface TxBroadcasted {
-    type: "broadcasted";
-    numPeers: number;
-}
-interface TxBestChainBlockIncluded {
-    type: "bestChainBlockIncluded";
-    block: {
-        hash: string;
-        index: number;
-    } | null;
-}
-interface TxFinalized {
-    type: "finalized";
-    block: {
-        hash: string;
-        index: number;
-    };
-}
-interface TxInvalid {
-    type: "invalid";
-    error: string;
-}
-interface TxDropped {
-    type: "dropped";
-    broadcasted: boolean;
-    error: string;
-}
-interface TxError {
-    type: "error";
-    error: string;
-}
-type TxEvent = TxValidated | TxBroadcasted | TxBestChainBlockIncluded | TxFinalized | TxInvalid | TxDropped | TxError;
-type Transaction = (tx: string, next: (event: TxEvent) => void, error: (e: Error) => void) => UnsubscribeFn;
-
-interface TxValidatedRpc {
-    event: "validated";
-}
-interface TxBroadcastedRpc {
-    event: "broadcasted";
-    numPeers: number;
-}
-interface TxBestChainBlockIncludedRpc {
-    event: "bestChainBlockIncluded";
-    block: {
-        hash: string;
-        index: number;
-    } | null;
-}
-interface TxFinalizedRpc {
-    event: "finalized";
-    block: {
-        hash: string;
-        index: number;
-    };
-}
-interface TxInvalidRpc {
-    event: "invalid";
-    error: string;
-}
-interface TxDroppedRpc {
-    event: "dropped";
-    broadcasted: boolean;
-    error: string;
-}
-interface TxErrorRpc {
-    event: "error";
-    error: string;
-}
-type TxEventRpc = TxValidatedRpc | TxBroadcastedRpc | TxBestChainBlockIncludedRpc | TxFinalizedRpc | TxInvalidRpc | TxDroppedRpc | TxErrorRpc;
+type Transaction = (tx: string, error: (e: Error) => void) => UnsubscribeFn;
 
-type ErrorEvents = TxDroppedRpc | TxInvalidRpc | TxErrorRpc;
-interface ITxError {
-    type: ErrorEvents["event"];
-    error: string;
-}
-declare class TransactionError extends Error implements ITxError {
-    type: "error" | "invalid" | "dropped";
-    error: string;
-    constructor(e: ErrorEvents);
-}
-declare const getTransaction: (request: ClientRequest<string, TxEventRpc>) => Transaction;
+declare const getTransaction: (request: ClientRequest<string, any>, rpcMethods: Promise<Set<string>> | Set<string>) => (tx: string, error: (e: Error) => void) => () => void;
 
 interface SubstrateClient {
     chainHead: ChainHead;
     transaction: Transaction;
     destroy: UnsubscribeFn;
+    request: <T>(method: string, params: any[], abortSignal?: AbortSignal) => Promise<T>;
     _request: <Reply, Notification>(method: string, params: any[], cb?: ClientRequestCb<Reply, Notification>) => UnsubscribeFn;
 }
-declare const createClient: (provider: ConnectProvider) => SubstrateClient;
+declare const createClient: (provider: JsonRpcProvider) => SubstrateClient;
 
-export { AbortablePromiseFn, BestBlockChanged, ChainHead, Client, ClientRequest, ClientRequestCb, DisjointError, Finalized, FollowEventWithRuntime, FollowEventWithoutRuntime, FollowResponse, FollowSubscriptionCb, IRpcError, Initialized, InitializedWithRuntime$1 as InitializedWithRuntime, NewBlock, NewBlockWithRuntime$1 as NewBlockWithRuntime, OperationError, OperationInaccessibleError, OperationLimitError, RpcError, Runtime, StopError, StorageItemInput, StorageItemResponse, StorageResult, SubstrateClient, Transaction, TransactionError, TxBestChainBlockIncluded, TxBroadcasted, TxDropped, TxError, TxEvent, TxFinalized, TxInvalid, TxValidated, UnsubscribeFn, createClient, getChainHead, getTransaction };
+export { type AbortablePromiseFn, type BestBlockChanged, type ChainHead, type Client, type ClientInnerRequest, type ClientInnerRequestCb, type ClientRequest, type ClientRequestCb, DestroyedError, DisjointError, type Finalized, type FollowEventWithRuntime, type FollowEventWithoutRuntime, type FollowInnerSubscriptionCb, type FollowResponse, type FollowSubscriptionCb, type IRpcError, type Initialized, type InitializedWithRuntime$1 as InitializedWithRuntime, type NewBlock, type NewBlockWithRuntime$1 as NewBlockWithRuntime, OperationError, OperationInaccessibleError, OperationLimitError, RpcError, type Runtime, StopError, type StorageItemInput, type StorageItemResponse, type StorageResult, type SubstrateClient, type Transaction, type UnsubscribeFn, createClient, getChainHead, getTransaction };