@dedot/api 0.0.1-next.8d3b3cd0.51 → 0.0.1-next.a5b1d2fb.22

package/README.md

@@ -1,517 +1 @@
-# dedot
-
-A delightful JavaScript/TypeScript client for [Polkadot](https://polkadot.network/) & [Substrate](https://substrate.io/)
-
-<p align="left">
-  <img src="https://img.shields.io/github/license/dedotdev/dedot?style=flat-square"/>
-  <img src="https://img.shields.io/github/actions/workflow/status/dedotdev/dedot/run-tests.yml?label=unit%20tests&style=flat-square"/>
-  <img src="https://img.shields.io/github/package-json/v/dedotdev/dedot?filename=packages%2Fapi%2Fpackage.json&style=flat-square"/>
-</p>
-
-_Note: The project is still in active development phase, the information on this page might be outdated. Feel free to raise an [issue](https://github.com/dedotdev/dedot/issues/new) if you run into any problems or want to share any ideas._
-
----
-### Features
-- ✅ Small bundle size, tree-shakable (no more bn.js or wasm-blob tight dependencies)
-- ✅ Built-in metadata caching mechanism
-- ✅ Types & APIs suggestions for each individual Substrate-based blockchain network ([@dedot/chaintypes](https://github.com/dedotdev/chaintypes))
-- ✅ Familiar api style with `@polkadot/api`, easy & fast migration!
-- ✅ Native TypeScript type system for scale-codec
-- ✅ Compatible with `@polkadot/extension`-based wallets
-- ✅ Support Metadata V14, V15 (latest)
-- ⏳ Support both the legacy (✅) & [new](https://paritytech.github.io/json-rpc-interface-spec/introduction.html) (⏳) JSON-RPC APIs
-- ⏳ Support light clients ([smoldot](https://www.npmjs.com/package/smoldot))
-
-### Have a quick taste
-
-Try `dedot` now on [CodeSandbox Playground](https://codesandbox.io/p/devbox/trydedot-th96cm?file=%2Fmain.ts%3A24%2C26) or follow the below steps to run it on your local environment.
-- Install `dedot` package
-```shell
-# via yarn
-yarn add dedot
-
-# via npm
-npm i dedot
-```
-
-- Install `@dedot/chaintypes` package for chain types & APIs suggestion. Skip this step if you don't use TypeScript.
-```shell
-# via yarn
-yarn add -D @dedot/chaintypes
-
-# via npm
-npm i -D @dedot/chaintypes
-```
-
-- Initialize the API client and start interacting with Polkadot network
-```typescript
-// main.ts
-import { Dedot } from 'dedot';
-import type { PolkadotApi } from '@dedot/chaintypes';
-
-const run = async () => {
-  const api = await Dedot.new<PolkadotApi>('wss://rpc.polkadot.io');
-
-  // Call rpc `state_getMetadata` to fetch raw scale-encoded metadata and decode it.
-  const metadata = await api.rpc.state.getMetadata();
-  console.log('Metadata:', metadata);
-
-  // Query on-chain storage
-  const balance = await api.query.system.account(<address>);
-  console.log('Balance:', balance);
-
-
-  // Subscribe to on-chain storage changes
-  const unsub = await api.query.system.number((blockNumber) => {
-    console.log(`Current block number: ${blockNumber}`);
-  });
-
-  // Get pallet constants
-  const ss58Prefix = api.consts.system.ss58Prefix;
-  console.log('Polkadot ss58Prefix:', ss58Prefix);
-
-  // Call runtime api
-  const pendingRewards = await api.call.nominationPoolsApi.pendingRewards(<address>)
-  console.log('Pending rewards:', pendingRewards);
-
-  // await unsub();
-  // await api.disconnect();
-}
-
-run().catch(console.error);
-```
-- You can also import `dedot` using `require`.
-
-```js
-// main.js
-const { Dedot } = require('dedot');
-// ...
-const api = await Dedot.new('wss://rpc.polkadot.io');
-```
-### Table of contents
-- [Status](#status)
-- [Chain Types & APIs](#chain-types--apis)
-- [Execute RPC Methods](#execute-rpc-methods)
-- [Query On-chain Storage](#query-on-chain-storage)
-- [Constants](#constants)
-- [Runtime APIs](#runtime-apis)
-- [Submit Transactions](#transaction-apis)
-- [Events](#events)
-- [Errors](#errors)
-- [`@polkadot/api` -> `dedot`](#migration-from-polkadotapi-to-dedot)
-- [Credit](#credit)
-
-### Status
-
-| Feature                                                     | Status |
-|-------------------------------------------------------------|--------|
-| Execute RPC (`api.rpc`)                                     | ✅      |
-| Query On-chain Storage (`api.query`)                        | ✅      |
-| Get runtime constants (`api.consts`)                        | ✅      |
-| Runtime APIs (`api.call`)                                   | ✅      |
-| Transaction APIs (`api.tx`)                                 | ✅      |
-| Events (`api.events`)                                       | ✅      |
-| Errors (`api.errors`)                                       | ✅      |
-| Contract APIs                                               | ⏳      |
-| Metadata v14                                                | ✅      |
-| Metadata v15                                                | ✅      |
-| [RPC v2](https://github.com/dedotdev/dedot/issues/20)       | ⏳      |
-| [Extrinsic V5](https://github.com/dedotdev/dedot/issues/55) | ⏳      |
-
-### Chain Types & APIs
-
-Each Substrate-based blockchain has their own set of data types & APIs to interact with, so being aware of those types & APIs when working with a blockchain will greatly improve the overall development experience. `dedot` exposes TypeScript's types & APIs for each individual Substrate-based blockchain, we recommend using TypeScript for your project to have the best experience.
-
-Types & APIs for each Substrate-based blockchains are defined in package [`@dedot/chaintypes`](https://github.com/dedotdev/dedot/tree/main/packages/chaintypes):
-```shell
-# via yarn
-yarn add -D @dedot/chaintypes
-
-# via npm
-npm i -D @dedot/chaintypes
-```
-
-Initialize a `Dedot` instance using the `ChainApi` interface for a target chain to enable types & APIs suggestion/autocompletion for that particular chain:
-```typescript
-import { Dedot } from 'dedot';
-import type { PolkadotApi, KusamaApi, MoonbeamApi, AstarApi } from '@dedot/chaintypes';
-
-// ...
-
-const polkadotApi = await Dedot.new<PolkadotApi>('wss://rpc.polkadot.io');
-console.log(await polkadotApi.query.babe.authorities());
-
-const kusamaApi = await Dedot.new<KusamaApi>('wss://kusama-rpc.polkadot.io');
-console.log(await kusamaApi.query.society.memberCount());
-
-const moonbeamApi = await Dedot.new<MoonbeamApi>('wss://wss.api.moonbeam.network');
-console.log(await moonbeamApi.query.ethereumChainId.chainId());
-
-const astarApi = await Dedot.new<AstarApi>('wss://rpc.astar.network');
-console.log(await astarApi.query.dappsStaking.blockRewardAccumulator());
-
-const genericApi = await Dedot.new('ws://localhost:9944');
-
-// ...
-```
-
-Supported `ChainApi` interfaces are defined [here](https://github.com/dedotdev/dedot/blob/main/packages/chaintypes/src/index.ts), you can also generate the `ChainApi` interface for the chain you want to connect with using `@dedot/cli`.
-
-```shell
-# Install @dedot/cli via yarn
-yarn add -D @dedot/cli
-
-# Or via npm
-npm i -D @dedot/cli
-
-# Generate ChainApi interface for Polkadot network via rpc endpoint: wss://rpc.polkadot.io
-npx dedot chaintypes -w wss://rpc.polkadot.io
-```
-
-### Execute RPC Methods
-
-RPCs can be executed via `api.rpc` entry point. After creating a `Dedot` instance with a `ChainApi` interface of the network you want to interact with, all RPC methods of the network will be exposed in the autocompletion/suggestion with format: `api.rpc.<module>.<methodName>`. E.g: you can find all supported RPC methods for Polkadot network [here](https://github.com/dedotdev/dedot/blob/main/packages/chaintypes/src/polkadot/rpc.d.ts), similarly for other networks as well.
-
-Examples:
-```typescript
-// Call rpc: `state_getMetadata`
-const metadata = await api.rpc.state.getMetadata(); 
-
-// Call an arbitrary rpc: `module_rpc_name` with arguments ['param1', 'param2']
-const result = await api.rpc.module.rpc_name('param1', 'param2');
-```
-
-### Query On-chain Storage
-
-On-chain storage can be queried via `api.query` entry point. All the available storage entries for a chain are exposed in the `ChainApi` interface for that chain and can be executed with format: `api.query.<pallet>.<storgeEntry>`. E.g: You can find all the available storage queries of Polkadot network [here](https://github.com/dedotdev/dedot/blob/main/packages/chaintypes/src/polkadot/query.d.ts), similarly for other networks as well.
-
-Examples:
-```typescript
-// Query account balance
-const balance = await api.query.system.account(<address>);
-
-// Get all events of current block
-const events = await api.query.system.events();
-```
-### Constants
-
-Runtime constants (parameter types) are defined in metadata, and can be inspected via `api.consts` entry point with format: `api.consts.<pallet>.<constantName>`. All available constants are also exposed in the `ChainApi` interface. E.g: Available constants for Polkadot network is defined [here](https://github.com/dedotdev/dedot/blob/main/packages/chaintypes/src/polkadot/consts.d.ts), similarly for other networks.
-
-Examples:
-```typescript
-// Get runtime version
-const runtimeVersion = api.consts.system.version;
-
-// Get existential deposit in pallet balances
-const existentialDeposit = api.consts.balances.existentialDeposit;
-```
-
-### Runtime APIs
-
-The latest stable Metadata V15 now includes all the runtime apis type information. So for chains that are supported Metadata V15, we can now execute all available runtime apis with syntax `api.call.<runtimeApi>.<methodName>`, those apis are exposed in `ChainApi` interface. E.g: Runtime Apis for Polkadot network is defined [here](https://github.com/dedotdev/dedot/blob/main/packages/chaintypes/src/polkadot/runtime.d.ts), similarly for other networks as well.
-
-Examples:
-```typescript
-// Get account nonce
-const nonce = await api.call.accountNonceApi.accountNonce(<address>);
-
-// Query transaction payment info
-const tx = api.tx.balances.transferKeepAlive(<address>, 2_000_000_000_000n);
-const queryInfo = await api.call.transactionPaymentApi.queryInfo(tx.toU8a(), tx.length);
-
-// Get runtime version
-const runtimeVersion = await api.call.core.version();
-```
-
-For chains that only support Metadata V14, we need to bring in the Runtime Api definitions when initializing the Dedot client instance to encode & decode the calls. You can find all supported Runtime Api definitions in [`@dedot/runtime-specs`](https://github.com/dedotdev/dedot/blob/60de0fed8ba19c67a7e174c6168a127fdbf6caef/packages/runtime-specs/src/runtime/all.ts#L21-L39) package.
-
-Examples:
-```typescript
-import { RuntimeApis } from '@dedot/runtime-specs';
-const api = await Dedot.new({ endpoint: 'wss://rpc.mynetwork.com', runtimeApis: RuntimeApis });
-
-// Or bring in only the Runtime Api definition that you want to interact with
-import { AccountNonceApi } from '@dedot/runtime-specs';
-const api = await Dedot.new({ endpoint: 'wss://rpc.mynetwork.com', runtimeApis: { AccountNonceApi } });
-
-// Get account nonce
-const nonce = await api.call.accountNonceApi.accountNonce(<address>);
-```
-
-You absolutely can define your own Runtime Api definition if you don't find it in the [supported list](https://github.com/dedotdev/dedot/blob/60de0fed8ba19c67a7e174c6168a127fdbf6caef/packages/runtime-specs/src/runtime/all.ts#L21-L39).
-
-### Transaction APIs
-
-Transaction apis are designed to be compatible with [`IKeyringPair`](https://github.com/polkadot-js/api/blob/3bdf49b0428a62f16b3222b9a31bfefa43c1ca55/packages/types/src/types/interfaces.ts#L15-L21) and [`Signer`](https://github.com/polkadot-js/api/blob/3bdf49b0428a62f16b3222b9a31bfefa43c1ca55/packages/types/src/types/extrinsic.ts#L135-L150) interfaces, so you can sign the transactions with accounts created by a [`Keyring`](https://github.com/polkadot-js/common/blob/22aab4a4e62944a2cf8c885f50be2c1b842813ec/packages/keyring/src/keyring.ts#L41-L40) or from any [Polkadot{.js}-based](https://github.com/polkadot-js/extension?tab=readme-ov-file#api-interface) wallet extensions.
-
-All transaction apis are exposed in `ChainApi` interface and can be access with syntax: `api.tx.<pallet>.<transactionName>`. E.g: Available transaction apis for Polkadot network are defined [here](https://github.com/dedotdev/dedot/blob/516c5dd948ac89ef53644b7fb1f62df1727adadb/packages/chaintypes/src/polkadot/tx.d.ts), similarly for other networks as well.
-
-Example 1: Sign transaction with a Keying account
-```typescript
-import { cryptoWaitReady } from '@polkadot/util-crypto';
-import { Keyring } from '@polkadot/keyring';
-...
-await cryptoWaitReady();
-const keyring = new Keyring({ type: 'sr25519' });
-const alice = keyring.addFromUri('//Alice');
-
-const unsub = await api.tx.balances
-    .transferKeepAlive(<destAddress>, 2_000_000_000_000n)
-    .signAndSend(alice, async ({ status }) => {
-      console.log('Transaction status', status.tag);
-      if (status.tag === 'InBlock') {
-        console.log(`Transaction completed at block hash ${status.value}`);
-        await unsub();
-      }
-    });
-```
-
-Example 2: Sign transaction using `Signer` from Polkadot{.js} wallet extension
-```typescript
-const injected = await window.injectedWeb3['polkadot-js'].enable('A cool dapp');
-const account = (await injected.accounts.get())[0];
-const signer = injected.signer;
-
-const unsub = await api.tx.balances
-    .transferKeepAlive(<destAddress>, 2_000_000_000_000n)
-    .signAndSend(account.address, { signer }, async ({ status }) => {
-      console.log('Transaction status', status.tag);
-      if (status.tag === 'InBlock') {
-        console.log(`Transaction completed at block hash ${status.value}`);
-        await unsub();
-      }
-    });
-```
-
-Example 3: Submit a batch transaction
-```typescript
-import type { PolkadotRuntimeRuntimeCallLike } from '@dedot/chaintypes/polkadot';
-
-// Omit the detail for simplicity
-const account = ...;
-const signer = ...;
-
-const transferTx = api.tx.balances.transferKeepAlive(<destAddress>, 2_000_000_000_000n);
-const remarkCall: PolkadotRuntimeRuntimeCallLike = {
-  pallet: 'System',
-  palletCall: {
-    name: 'RemarkWithEvent',
-    params: {
-      remark: 'Hello Dedot!',
-    },
-  },
-};
-
-const unsub = api.tx.utility.batch([transferTx.call, remarkCall])
-    .signAndSend(account.address, { signer }, async ({ status }) => {
-      console.log('Transaction status', status.tag);
-      if (status.tag === 'InBlock') {
-        console.log(`Transaction completed at block hash ${status.value}`);
-        await unsub();
-      }
-    });
-```
-
-<details>
-  <summary>Example 4: Teleport WND from Westend Asset Hub to Westend via XCM</summary>
-  
-```typescript
-import { WestendAssetHubApi, XcmVersionedLocation, XcmVersionedAssets, XcmV3WeightLimit } from '@dedot/chaintypes/westendAssetHub';
-import { AccountId32 } from '@dedot/codecs';
-
-const TWO_TOKENS = 2_000_000_000_000n;
-const destAddress = <bobAddress>;
-
-const api = await Dedot.new<WestendAssetHubApi>('...westend-assethub-rpc...');
-
-const dest: XcmVersionedLocation = {
-  tag: 'V3',
-  value: { parents: 1, interior: { tag: 'Here' } },
-};
-
-const beneficiary: XcmVersionedLocation = {
-  tag: 'V3',
-  value: {
-    parents: 0,
-    interior: {
-      tag: 'X1',
-      value: {
-        tag: 'AccountId32',
-        value: { id: new AccountId32(destAddress).raw },
-      },
-    },
-  },
-};
-
-const assets: XcmVersionedAssets = {
-  tag: 'V3',
-  value: [
-    {
-      id: {
-        tag: 'Concrete',
-        value: {
-          parents: 1,
-          interior: { tag: 'Here' },
-        },
-      },
-      fun: {
-        tag: 'Fungible',
-        value: TWO_TOKENS,
-      },
-    },
-  ],
-};
-
-const weight: XcmV3WeightLimit = { tag: 'Unlimited' };
-
-api.tx.polkadotXcm
-  .limitedTeleportAssets(dest, beneficiary, assets, 0, weight)
-  .signAndSend(alice, { signer, tip: 1_000_000n }, (result) => {
-    console.dir(result, { depth: null });
-  });
-```
-</details>
-
-
-### Events
-
-Events for each pallet emit during runtime operations and are defined in the medata. Available events are also exposed in `ChainApi` interface so we can get information of an event through syntax `api.events.<pallet>.<eventName>`. E.g: Events for Polkadot network can be found [here](https://github.com/dedotdev/dedot/blob/main/packages/chaintypes/src/polkadot/events.d.ts), similarly for other network as well.
-
-This `api.events` is helpful when we want quickly check if an event matches with an event that we're expecting in a list of events, the API also comes with type narrowing for the matched event, so event name & related data of the event are fully typed.
-
-Example to list new accounts created in each block:
-```typescript
-// ...
-const ss58Prefix = api.consts.system.ss58Prefix;
-await api.query.system.events(async (eventRecords) => {
-  const newAccountEvents = eventRecords
-    .map(({ event }) => api.events.system.NewAccount.as(event))
-    .filter((one) => one);
-
-  console.log(newAccountEvents.length, 'account(s) was created in block', await api.query.system.number());
-
-  newAccountEvents.forEach((event, index) => {
-    console.log(`New Account ${index + 1}:`, event.palletEvent.data.account.address(ss58Prefix));
-  });
-});
-// ...
-```
-
-### Errors
-
-Pallet errors are thrown out when things go wrong in the runtime, those are defined in the metadata. Available errors for each pallet are also exposed in `ChainApi` interface, so we can get information an error through this syntax: `api.errors.<pallet>.<errorName>`. E.g: Available errors for Polkadot network can be found [here](https://github.com/dedotdev/dedot/blob/main/packages/chaintypes/src/polkadot/errors.d.ts).
-
-Similar to events API, this API is helpful when we want to check if an error maches with an error that we're expecting.
-
-Example if an error is `AlreadyExists` from `Assets` pallet:
-```typescript
-// ...
-await api.query.system.events(async (eventRecords) => {
-  for (const tx of eventRecords) {
-    if (api.events.system.ExtrinsicFailed.is(tx.event)) {
-      const { dispatchError } = tx.event.palletEvent.data;
-      if (dispatchError.tag === 'Module' && api.errors.assets.AlreadyExists.is(dispatchError.value)) {
-        console.log('Assets.AlreadyExists error occurred!');
-      } else {
-        console.log('Other error occurred', dispatchError);
-      }
-    }
-  }
-});
-// ...
-```
-
-### Migration from `@polkadot/api` to `dedot`
-`dedot` is inspired by `@polkadot/api`, so both are sharing some common patterns and api styling (eg: api syntax `api.<type>.<module>.<section>`). Although we have experimented some other different api stylings but to our findings and development experience, we find that the api style of `@polkadot/api` is very intuiative and easy to use. We decide the use a similar api styling with `@polkadot/api`, this also helps the migration from `@polkadot/api` to `dedot` easier & faster. 
-
-While the api style are similar, but there're also some differences you might need to be aware of when switching to use `dedot`. 
-
-**Initialize api client**
-- `@polkadot/api`
-```typescript
-import { ApiPromise, WsProvider } from '@polkadot/api';
-
-const api = await ApiPromise.create({ provider: new WsProvider('wss://rpc.polkadot.io') });
-```
-- `dedot`
-```typescript
-import { Dedot } from 'dedot';
-import type { PolkadotApi } from '@dedot/chaintypes';
-
-const api = await Dedot.new<PolkadotApi>('wss://rpc.polkadot.io'); // or Dedot.create(...) if you prefer
-
-// OR you want to have a custom provider
-import { WsProvider } from 'dedot'
-const api = await Dedot.new<PolkadotApi>({ provider: new WsProvider('wss://rpc.polkadot.io') });
-```
-
-- Notes:
-  - Under the hood, a `WsProvider` will be created if you initialize `Dedot` directly with an rpc endpoint.
-  - `dedot` only supports provider can make subscription request (e.g: via Websocket).
-  - We recommend specifying the `ChainApi` interface (e.g: [`PolkadotApi`](https://github.com/dedotdev/dedot/blob/02d7bca4c3c3d12c9591ea43b3410daf8e5aacbb/packages/chaintypes/src/polkadot/index.d.ts) in the example above) of the chain that you want to interact with. This enable apis & types suggestion/autocompletion for that particular chain (via IntelliSense). If you don't specify a `ChainApi` interface, the default [`SubstrateApi`](https://github.com/dedotdev/dedot/blob/a762faf8f6af40d3e4ef163bd538b270a5ca31e8/packages/chaintypes/src/substrate/index.d.ts) interface will be used.
-
-**Type system**
-
-Unlike `@polkadot/api` where data are wrapped inside a [codec types](https://polkadot.js.org/docs/api/start/types.basics), so we always need to unwrap the data before using it (e.g: via `.unwrap()`, `.toNumber()`, `.toString()`, `.toJSON()` ...). `dedot` leverages the native TypeScript type system to represent scale-codec types, so you can use the data directly without extra handling/unwrapping. The table below is a mapping between scale-codec types and TypeScript types that we're using for `dedot`:
-
-
-| Scale Codec                                             | TypeScript (`dedot`)                                                                                                           |
-|---------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|
-| `u8`, `u16`, `u32`, `i8`, `i16`, `i32`                  | `number`                                                                                                                       |
-| `u64`, `u128`, `u256`, `i64`, `i128`, `i256`            | `bigint` (native [BigInt](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt), not bn.js) |
-| `bool`                                                  | `boolean` (true, false)                                                                                                        |
-| `Option<T>`                                             | `T \| undefined`                                                                                                               |
-| `Result<Ok, Err>`                                       | `{ isOk: true; isErr?: false; value: Ok } \| { isOk?: false; isErr: true; err: Err }`                                          |
-| `Vec<T>`                                                | `Array<T>`                                                                                                                     |
-| `str`                                                   | `string`                                                                                                                       |
-| Tuple: `(A, B)`, `()`                                   | `[A, B]`, `[]`                                                                                                                 |
-| Struct: `struct { field_1: u8, field_2: str }`          | `{ field_1: number, field_2: string}`                                                                                          |
-| Enum: `enum { Variant1(u8), Variant2(bool), Variant3 }` | `{ tag: 'Variant1', value: number } \| { tag: 'Variant2', value: boolean } \| { tag: 'Variant2' }`                             |
-| FlatEnum: `enum { Variant1, Variant2 }`                 | `'Variant1' \| 'Variant2'`                                                                                                     |
-
-E.g 1:
-```typescript
-const runtimeVersion = api.consts.system.version;
-
-// @polkadot/api
-const specName: string = runtimeVersion.toJSON().specName; // OR runtimeVersion.specName.toString()
-
-// dedot
-const specName: string = runtimeVersion.specName;
-```
-
-E.g 2: 
-```typescript
-const balance = await api.query.system.account(<address>);
-
-// @polkadot/api
-const freeBalance: bigint = balance.data.free.toBigInt();
-
-// dedot
-const freeBalance: bigint = balance.data.free;
-```
-
-E.g 3:
-```typescript
-// @polkadot/api
-const proposalBondMaximum: bigint | undefined = api.consts.treasury.proposalBondMaximum.unwrapOr(undefined)?.toBigInt();
-
-// dedot
-const proposalBondMaximum: bigint | undefined = api.consts.treasury.proposalBondMaximum;
-```
-
-
-### Credit
-
-`dedot` take a lot of inspirations from project [@polkadot/api](https://github.com/polkadot-js/api). A big thank to all the maintainers/contributors of this awesome library.
-
-Proudly supported by Web3 Foundation Grants Program.
-<p align="left">
-  <img width="479" src="https://user-images.githubusercontent.com/6867026/227230786-0796214a-3e3f-42af-94e9-d4122c730b62.png">
-</p>
-
-
-### License
-
-[Apache-2.0](https://github.com/dedotdev/dedot/blob/main/LICENSE)
-
+# @dedot/api

package/chaintypes/substrate/consts.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/errors.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/events.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/index.d.ts

@@ -1,4 +1,4 @@
-import { GenericSubstrateApi, RpcLegacy, RpcV2, RpcVersion } from '@dedot/types';
+import type { GenericSubstrateApi, RpcLegacy, RpcV2, RpcVersion } from '@dedot/types';
 import { ChainConsts } from './consts.js';
 import { ChainErrors } from './errors.js';
 import { ChainEvents } from './events.js';

package/chaintypes/substrate/index.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export * from './types.js';

package/chaintypes/substrate/json-rpc.d.ts

@@ -1,3 +1,3 @@
 import type { GenericJsonRpcApis, RpcVersion } from '@dedot/types';
 import type { JsonRpcApis } from '@dedot/types/json-rpc';
-export type ChainJsonRpcApis<Rv extends RpcVersion> = Pick<JsonRpcApis, 'author_hasKey' | 'author_hasSessionKeys' | 'author_insertKey' | 'author_pendingExtrinsics' | 'author_removeExtrinsic' | 'author_rotateKeys' | 'author_submitAndWatchExtrinsic' | 'author_submitExtrinsic' | 'babe_epochAuthorship' | 'beefy_getFinalizedHead' | 'beefy_subscribeJustifications' | 'chainHead_unstable_body' | 'chainHead_unstable_call' | 'chainHead_unstable_continue' | 'chainHead_unstable_follow' | 'chainHead_unstable_header' | 'chainHead_unstable_stopOperation' | 'chainHead_unstable_storage' | 'chainHead_unstable_unpin' | 'chainSpec_v1_chainName' | 'chainSpec_v1_genesisHash' | 'chainSpec_v1_properties' | 'chain_getBlock' | 'chain_getBlockHash' | 'chain_getFinalizedHead' | 'chain_getHeader' | 'chain_subscribeAllHeads' | 'chain_subscribeFinalizedHeads' | 'chain_subscribeNewHeads' | 'childstate_getKeys' | 'childstate_getKeysPaged' | 'childstate_getStorage' | 'childstate_getStorageEntries' | 'childstate_getStorageHash' | 'childstate_getStorageSize' | 'dev_getBlockStats' | 'grandpa_proveFinality' | 'grandpa_roundState' | 'grandpa_subscribeJustifications' | 'mmr_generateProof' | 'mmr_root' | 'mmr_verifyProof' | 'mmr_verifyProofStateless' | 'offchain_localStorageGet' | 'offchain_localStorageSet' | 'payment_queryFeeDetails' | 'payment_queryInfo' | 'rpc_methods' | 'state_call' | 'state_getChildReadProof' | 'state_getKeys' | 'state_getKeysPaged' | 'state_getMetadata' | 'state_getPairs' | 'state_getReadProof' | 'state_getRuntimeVersion' | 'state_getStorage' | 'state_getStorageHash' | 'state_getStorageSize' | 'state_queryStorage' | 'state_queryStorageAt' | 'state_subscribeRuntimeVersion' | 'state_subscribeStorage' | 'state_traceBlock' | 'state_trieMigrationStatus' | 'statement_broadcasts' | 'statement_dump' | 'statement_posted' | 'statement_postedClear' | 'statement_remove' | 'statement_submit' | 'sync_state_genSyncSpec' | 'system_accountNextIndex' | 'system_addLogFilter' | 'system_addReservedPeer' | 'system_chain' | 'system_chainType' | 'system_dryRun' | 'system_health' | 'system_localListenAddresses' | 'system_localPeerId' | 'system_name' | 'system_nodeRoles' | 'system_peers' | 'system_properties' | 'system_removeReservedPeer' | 'system_reservedPeers' | 'system_resetLogFilter' | 'system_syncState' | 'system_unstable_networkState' | 'system_version' | 'transactionWatch_unstable_submitAndWatch' | 'transaction_unstable_broadcast' | 'transaction_unstable_stop'> & GenericJsonRpcApis<Rv>;
+export type ChainJsonRpcApis<Rv extends RpcVersion> = Pick<JsonRpcApis, 'author_hasKey' | 'author_hasSessionKeys' | 'author_insertKey' | 'author_pendingExtrinsics' | 'author_removeExtrinsic' | 'author_rotateKeys' | 'author_submitAndWatchExtrinsic' | 'author_submitExtrinsic' | 'babe_epochAuthorship' | 'beefy_getFinalizedHead' | 'beefy_subscribeJustifications' | 'chainHead_v1_body' | 'chainHead_v1_call' | 'chainHead_v1_continue' | 'chainHead_v1_follow' | 'chainHead_v1_header' | 'chainHead_v1_stopOperation' | 'chainHead_v1_storage' | 'chainHead_v1_unpin' | 'chainSpec_v1_chainName' | 'chainSpec_v1_genesisHash' | 'chainSpec_v1_properties' | 'chain_getBlock' | 'chain_getBlockHash' | 'chain_getFinalizedHead' | 'chain_getHeader' | 'chain_subscribeAllHeads' | 'chain_subscribeFinalizedHeads' | 'chain_subscribeNewHeads' | 'childstate_getKeys' | 'childstate_getKeysPaged' | 'childstate_getStorage' | 'childstate_getStorageEntries' | 'childstate_getStorageHash' | 'childstate_getStorageSize' | 'dev_getBlockStats' | 'grandpa_proveFinality' | 'grandpa_roundState' | 'grandpa_subscribeJustifications' | 'mmr_generateProof' | 'mmr_root' | 'mmr_verifyProof' | 'mmr_verifyProofStateless' | 'offchain_localStorageGet' | 'offchain_localStorageSet' | 'payment_queryFeeDetails' | 'payment_queryInfo' | 'rpc_methods' | 'state_call' | 'state_getChildReadProof' | 'state_getKeys' | 'state_getKeysPaged' | 'state_getMetadata' | 'state_getPairs' | 'state_getReadProof' | 'state_getRuntimeVersion' | 'state_getStorage' | 'state_getStorageHash' | 'state_getStorageSize' | 'state_queryStorage' | 'state_queryStorageAt' | 'state_subscribeRuntimeVersion' | 'state_subscribeStorage' | 'state_traceBlock' | 'state_trieMigrationStatus' | 'statement_broadcasts' | 'statement_dump' | 'statement_posted' | 'statement_postedClear' | 'statement_remove' | 'statement_submit' | 'sync_state_genSyncSpec' | 'system_accountNextIndex' | 'system_addLogFilter' | 'system_addReservedPeer' | 'system_chain' | 'system_chainType' | 'system_dryRun' | 'system_health' | 'system_localListenAddresses' | 'system_localPeerId' | 'system_name' | 'system_nodeRoles' | 'system_peers' | 'system_properties' | 'system_removeReservedPeer' | 'system_reservedPeers' | 'system_resetLogFilter' | 'system_syncState' | 'system_unstable_networkState' | 'system_version' | 'transactionWatch_v1_submitAndWatch' | 'transaction_v1_broadcast' | 'transaction_v1_stop'> & GenericJsonRpcApis<Rv>;

package/chaintypes/substrate/json-rpc.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/query.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/runtime.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/tx.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/types.js

@@ -1,2 +1,2 @@
-// Generated by @dedot/codegen
+// Generated by dedot cli
 export {};

package/cjs/chaintypes/substrate/consts.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/errors.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/events.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/index.js

@@ -1,5 +1,5 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/cjs/chaintypes/substrate/json-rpc.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/query.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/runtime.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/tx.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/types.js

@@ -1,3 +1,3 @@
 "use strict";
-// Generated by @dedot/codegen
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/client/BaseSubstrateClient.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseSubstrateClient = exports.ensurePresence = void 0;
+exports.BaseSubstrateClient = void 0;
+exports.ensurePresence = ensurePresence;
 const codecs_1 = require("@dedot/codecs");
 const storage_1 = require("@dedot/storage");
 const utils_1 = require("@dedot/utils");
@@ -13,7 +14,6 @@ const MESSAGE = 'Make sure to call `.connect()` method first before using the AP
 function ensurePresence(value) {
     return (0, utils_1.ensurePresence)(value, MESSAGE);
 }
-exports.ensurePresence = ensurePresence;
 /**
  * @name BaseSubstrateClient
  * @description Base & shared abstraction for Substrate API Clients

package/cjs/client/{Dedot.js → LegacyClient.js}

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Dedot = void 0;
+exports.LegacyClient = void 0;
 const codecs_1 = require("@dedot/codecs");
 const index_js_1 = require("../executor/index.js");
 const proxychain_js_1 = require("../proxychain.js");
 const BaseSubstrateClient_js_1 = require("./BaseSubstrateClient.js");
 const KEEP_ALIVE_INTERVAL = 10_000; // in ms
 /**
- * @name Dedot
+ * @name LegacyClient
  * @description Promised-based API Client for Polkadot & Substrate
  *
  * Initialize API instance and interact with substrate-based network
@@ -16,7 +16,7 @@ const KEEP_ALIVE_INTERVAL = 10_000; // in ms
  * import type { PolkadotApi } from '@dedot/chaintypes/polkadot';
  *
  * const run = async () => {
- *   const api = await Dedot.new<PolkadotApi>('wss://rpc.polkadot.io');
+ *   const api = await LegacyClient.new<PolkadotApi>('wss://rpc.polkadot.io');
  *
  *   // Call rpc `state_getMetadata` to fetch raw scale-encoded metadata and decode it.
  *   const metadata = await api.rpc.state.getMetadata();
@@ -44,7 +44,7 @@ const KEEP_ALIVE_INTERVAL = 10_000; // in ms
  * run().catch(console.error);
  * ```
  */
-class Dedot extends BaseSubstrateClient_js_1.BaseSubstrateClient {
+class LegacyClient extends BaseSubstrateClient_js_1.BaseSubstrateClient {
     #runtimeSubscriptionUnsub;
     #healthTimer;
     #apiAtCache = {};
@@ -62,15 +62,15 @@ class Dedot extends BaseSubstrateClient_js_1.BaseSubstrateClient {
      * @param options
      */
     static async create(options) {
-        return new Dedot(options).connect();
+        return new LegacyClient(options).connect();
     }
     /**
-     * Alias for __Dedot.create__
+     * Alias for __LegacyClient.create__
      *
      * @param options
      */
     static async new(options) {
-        return Dedot.create(options);
+        return LegacyClient.create(options);
     }
     onDisconnected = async () => {
         await this.#unsubscribeUpdates();
@@ -247,4 +247,4 @@ class Dedot extends BaseSubstrateClient_js_1.BaseSubstrateClient {
         return api;
     }
 }
-exports.Dedot = Dedot;
+exports.LegacyClient = LegacyClient;

package/cjs/client/index.js

@@ -14,5 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./Dedot.js"), exports);
+__exportStar(require("./LegacyClient.js"), exports);
 __exportStar(require("./DedotClient.js"), exports);

package/cjs/executor/v2/StorageQueryExecutorV2.js

@@ -35,13 +35,13 @@ class StorageQueryExecutorV2 extends StorageQueryExecutor_js_1.StorageQueryExecu
         }, {});
     }
     async subscribeStorage(keys, callback) {
-        let initialHash = await this.chainHead.bestHash();
+        let best = await this.chainHead.bestBlock();
         let eventToListen = 'bestBlock';
         // TODO subscribe to finalized data source
         // initialHash = this.chainHead.finalizedHash;
         // eventToListen = 'finalizedBlock';
         const latestChanges = {};
-        const pull = async (hash) => {
+        const pull = async ({ hash }) => {
             const results = await this.queryStorage(keys, hash);
             let changed = false;
             keys.forEach((key) => {
@@ -55,7 +55,7 @@ class StorageQueryExecutorV2 extends StorageQueryExecutor_js_1.StorageQueryExecu
                 return;
             callback(keys.map((key) => latestChanges[key]));
         };
-        await pull(initialHash);
+        await pull(best);
         const unsub = this.chainHead.on(eventToListen, pull);
         return async () => {
             unsub();

package/cjs/extrinsic/extensions/known/CheckMetadataHash.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckMetadataHash = void 0;
+const utils_1 = require("@dedot/utils");
+const SignedExtension_js_1 = require("../SignedExtension.js");
+/**
+ * @description Genesis hash check to provide replay protection between different networks.
+ */
+class CheckMetadataHash extends SignedExtension_js_1.SignedExtension {
+    async init() {
+        let metadataHash = this.payloadOptions.metadataHash;
+        if (metadataHash) {
+            (0, utils_1.assert)((0, utils_1.isHex)(metadataHash), 'Metadata hash is not a valid hex string');
+            this.data = { mode: 'Enabled' };
+            this.additionalSigned = metadataHash;
+        }
+        else {
+            this.data = { mode: 'Disabled' };
+            this.additionalSigned = undefined;
+        }
+    }
+    toPayload() {
+        // Ref: https://github.com/paritytech/polkadot-sdk/blob/8dbe4ee80734bba6644c7e5f879a363ce7c0a19f/substrate/frame/metadata-hash-extension/src/lib.rs#L55-L58
+        let enabled = this.data.mode === 'Enabled';
+        return {
+            mode: enabled ? 1 : 0, // 0 -> disabled, 1 -> enabled
+            metadataHash: this.additionalSigned,
+        };
+    }
+}
+exports.CheckMetadataHash = CheckMetadataHash;

package/cjs/extrinsic/extensions/known/StorageWeightReclaim.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageWeightReclaim = void 0;
+const SignedExtension_js_1 = require("../SignedExtension.js");
+/**
+ * @description Storage weight reclaim mechanism.
+ */
+class StorageWeightReclaim extends SignedExtension_js_1.SignedExtension {
+}
+exports.StorageWeightReclaim = StorageWeightReclaim;

package/cjs/extrinsic/extensions/known/index.js

@@ -4,6 +4,7 @@ exports.knownSignedExtensions = void 0;
 const ChargeAssetTxPayment_js_1 = require("./ChargeAssetTxPayment.js");
 const ChargeTransactionPayment_js_1 = require("./ChargeTransactionPayment.js");
 const CheckGenesis_js_1 = require("./CheckGenesis.js");
+const CheckMetadataHash_js_1 = require("./CheckMetadataHash.js");
 const CheckMortality_js_1 = require("./CheckMortality.js");
 const CheckNonZeroSender_js_1 = require("./CheckNonZeroSender.js");
 const CheckNonce_js_1 = require("./CheckNonce.js");
@@ -11,6 +12,7 @@ const CheckSpecVersion_js_1 = require("./CheckSpecVersion.js");
 const CheckTxVersion_js_1 = require("./CheckTxVersion.js");
 const CheckWeight_js_1 = require("./CheckWeight.js");
 const PrevalidateAttests_js_1 = require("./PrevalidateAttests.js");
+const StorageWeightReclaim_js_1 = require("./StorageWeightReclaim.js");
 exports.knownSignedExtensions = {
     CheckNonZeroSender: CheckNonZeroSender_js_1.CheckNonZeroSender,
     CheckSpecVersion: CheckSpecVersion_js_1.CheckSpecVersion,
@@ -22,4 +24,6 @@ exports.knownSignedExtensions = {
     ChargeTransactionPayment: ChargeTransactionPayment_js_1.ChargeTransactionPayment,
     PrevalidateAttests: PrevalidateAttests_js_1.PrevalidateAttests,
     ChargeAssetTxPayment: ChargeAssetTxPayment_js_1.ChargeAssetTxPayment,
+    CheckMetadataHash: CheckMetadataHash_js_1.CheckMetadataHash,
+    StorageWeightReclaim: StorageWeightReclaim_js_1.StorageWeightReclaim,
 };

package/cjs/extrinsic/submittable/utils.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.signRaw = exports.isKeyringPair = void 0;
+exports.isKeyringPair = isKeyringPair;
+exports.signRaw = signRaw;
 const utils_1 = require("@dedot/utils");
 function isKeyringPair(account) {
     return (0, utils_1.isFunction)(account.sign);
 }
-exports.isKeyringPair = isKeyringPair;
 /**
  * Sign a raw message
  * @param signerPair
@@ -17,4 +17,3 @@ function signRaw(signerPair, raw) {
     const toSignRaw = u8a.length > 256 ? (0, utils_1.blake2AsU8a)(u8a, 256) : u8a;
     return signerPair.sign(toSignRaw, { withType: true });
 }
-exports.signRaw = signRaw;

package/client/{Dedot.d.ts → LegacyClient.d.ts}

@@ -5,7 +5,7 @@ import type { SubstrateApi } from '../chaintypes/index.js';
 import type { ApiOptions, ISubstrateClientAt } from '../types.js';
 import { BaseSubstrateClient } from './BaseSubstrateClient.js';
 /**
- * @name Dedot
+ * @name LegacyClient
  * @description Promised-based API Client for Polkadot & Substrate
  *
  * Initialize API instance and interact with substrate-based network
@@ -14,7 +14,7 @@ import { BaseSubstrateClient } from './BaseSubstrateClient.js';
  * import type { PolkadotApi } from '@dedot/chaintypes/polkadot';
  *
  * const run = async () => {
- *   const api = await Dedot.new<PolkadotApi>('wss://rpc.polkadot.io');
+ *   const api = await LegacyClient.new<PolkadotApi>('wss://rpc.polkadot.io');
  *
  *   // Call rpc `state_getMetadata` to fetch raw scale-encoded metadata and decode it.
  *   const metadata = await api.rpc.state.getMetadata();
@@ -42,7 +42,7 @@ import { BaseSubstrateClient } from './BaseSubstrateClient.js';
  * run().catch(console.error);
  * ```
  */
-export declare class Dedot<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi> extends BaseSubstrateClient<ChainApi> {
+export declare class LegacyClient<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi> extends BaseSubstrateClient<ChainApi> {
     #private;
     /**
      * Use factory methods (`create`, `new`) to create `Dedot` instances.
@@ -55,13 +55,13 @@ export declare class Dedot<ChainApi extends VersionedGenericSubstrateApi = Subst
      *
      * @param options
      */
-    static create<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi>(options: ApiOptions | JsonRpcProvider): Promise<Dedot<ChainApi>>;
+    static create<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi>(options: ApiOptions | JsonRpcProvider): Promise<LegacyClient<ChainApi>>;
     /**
-     * Alias for __Dedot.create__
+     * Alias for __LegacyClient.create__
      *
      * @param options
      */
-    static new<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi>(options: ApiOptions | JsonRpcProvider): Promise<Dedot<ChainApi>>;
+    static new<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi>(options: ApiOptions | JsonRpcProvider): Promise<LegacyClient<ChainApi>>;
     protected onDisconnected: () => Promise<void>;
     protected beforeDisconnect(): Promise<void>;
     /**

package/client/{Dedot.js → LegacyClient.js}

@@ -4,7 +4,7 @@ import { newProxyChain } from '../proxychain.js';
 import { BaseSubstrateClient } from './BaseSubstrateClient.js';
 const KEEP_ALIVE_INTERVAL = 10_000; // in ms
 /**
- * @name Dedot
+ * @name LegacyClient
  * @description Promised-based API Client for Polkadot & Substrate
  *
  * Initialize API instance and interact with substrate-based network
@@ -13,7 +13,7 @@ const KEEP_ALIVE_INTERVAL = 10_000; // in ms
  * import type { PolkadotApi } from '@dedot/chaintypes/polkadot';
  *
  * const run = async () => {
- *   const api = await Dedot.new<PolkadotApi>('wss://rpc.polkadot.io');
+ *   const api = await LegacyClient.new<PolkadotApi>('wss://rpc.polkadot.io');
  *
  *   // Call rpc `state_getMetadata` to fetch raw scale-encoded metadata and decode it.
  *   const metadata = await api.rpc.state.getMetadata();
@@ -41,7 +41,7 @@ const KEEP_ALIVE_INTERVAL = 10_000; // in ms
  * run().catch(console.error);
  * ```
  */
-export class Dedot extends BaseSubstrateClient {
+export class LegacyClient extends BaseSubstrateClient {
     #runtimeSubscriptionUnsub;
     #healthTimer;
     #apiAtCache = {};
@@ -59,15 +59,15 @@ export class Dedot extends BaseSubstrateClient {
      * @param options
      */
     static async create(options) {
-        return new Dedot(options).connect();
+        return new LegacyClient(options).connect();
     }
     /**
-     * Alias for __Dedot.create__
+     * Alias for __LegacyClient.create__
      *
      * @param options
      */
     static async new(options) {
-        return Dedot.create(options);
+        return LegacyClient.create(options);
     }
     onDisconnected = async () => {
         await this.#unsubscribeUpdates();

package/client/index.d.ts

@@ -1,2 +1,2 @@
-export * from './Dedot.js';
+export * from './LegacyClient.js';
 export * from './DedotClient.js';

package/client/index.js

@@ -1,2 +1,2 @@
-export * from './Dedot.js';
+export * from './LegacyClient.js';
 export * from './DedotClient.js';

package/executor/v2/StorageQueryExecutorV2.js

@@ -32,13 +32,13 @@ export class StorageQueryExecutorV2 extends StorageQueryExecutor {
         }, {});
     }
     async subscribeStorage(keys, callback) {
-        let initialHash = await this.chainHead.bestHash();
+        let best = await this.chainHead.bestBlock();
         let eventToListen = 'bestBlock';
         // TODO subscribe to finalized data source
         // initialHash = this.chainHead.finalizedHash;
         // eventToListen = 'finalizedBlock';
         const latestChanges = {};
-        const pull = async (hash) => {
+        const pull = async ({ hash }) => {
             const results = await this.queryStorage(keys, hash);
             let changed = false;
             keys.forEach((key) => {
@@ -52,7 +52,7 @@ export class StorageQueryExecutorV2 extends StorageQueryExecutor {
                 return;
             callback(keys.map((key) => latestChanges[key]));
         };
-        await pull(initialHash);
+        await pull(best);
         const unsub = this.chainHead.on(eventToListen, pull);
         return async () => {
             unsub();

package/extrinsic/extensions/known/CheckMetadataHash.d.ts

@@ -0,0 +1,13 @@
+import { SignerPayloadJSON } from '@polkadot/types/types';
+import { Hash } from '@dedot/codecs';
+import { SignedExtension } from '../SignedExtension.js';
+export type CheckMetadataHashMode = 'Disabled' | 'Enabled';
+/**
+ * @description Genesis hash check to provide replay protection between different networks.
+ */
+export declare class CheckMetadataHash extends SignedExtension<{
+    mode: CheckMetadataHashMode;
+}, Hash | undefined> {
+    init(): Promise<void>;
+    toPayload(): Partial<SignerPayloadJSON>;
+}

package/extrinsic/extensions/known/CheckMetadataHash.js

@@ -0,0 +1,27 @@
+import { assert, isHex } from '@dedot/utils';
+import { SignedExtension } from '../SignedExtension.js';
+/**
+ * @description Genesis hash check to provide replay protection between different networks.
+ */
+export class CheckMetadataHash extends SignedExtension {
+    async init() {
+        let metadataHash = this.payloadOptions.metadataHash;
+        if (metadataHash) {
+            assert(isHex(metadataHash), 'Metadata hash is not a valid hex string');
+            this.data = { mode: 'Enabled' };
+            this.additionalSigned = metadataHash;
+        }
+        else {
+            this.data = { mode: 'Disabled' };
+            this.additionalSigned = undefined;
+        }
+    }
+    toPayload() {
+        // Ref: https://github.com/paritytech/polkadot-sdk/blob/8dbe4ee80734bba6644c7e5f879a363ce7c0a19f/substrate/frame/metadata-hash-extension/src/lib.rs#L55-L58
+        let enabled = this.data.mode === 'Enabled';
+        return {
+            mode: enabled ? 1 : 0, // 0 -> disabled, 1 -> enabled
+            metadataHash: this.additionalSigned,
+        };
+    }
+}

package/extrinsic/extensions/known/StorageWeightReclaim.d.ts

@@ -0,0 +1,6 @@
+import { SignedExtension } from '../SignedExtension.js';
+/**
+ * @description Storage weight reclaim mechanism.
+ */
+export declare class StorageWeightReclaim extends SignedExtension {
+}

package/extrinsic/extensions/known/StorageWeightReclaim.js

@@ -0,0 +1,6 @@
+import { SignedExtension } from '../SignedExtension.js';
+/**
+ * @description Storage weight reclaim mechanism.
+ */
+export class StorageWeightReclaim extends SignedExtension {
+}

package/extrinsic/extensions/known/index.js

@@ -1,6 +1,7 @@
 import { ChargeAssetTxPayment } from './ChargeAssetTxPayment.js';
 import { ChargeTransactionPayment } from './ChargeTransactionPayment.js';
 import { CheckGenesis } from './CheckGenesis.js';
+import { CheckMetadataHash } from './CheckMetadataHash.js';
 import { CheckMortality } from './CheckMortality.js';
 import { CheckNonZeroSender } from './CheckNonZeroSender.js';
 import { CheckNonce } from './CheckNonce.js';
@@ -8,6 +9,7 @@ import { CheckSpecVersion } from './CheckSpecVersion.js';
 import { CheckTxVersion } from './CheckTxVersion.js';
 import { CheckWeight } from './CheckWeight.js';
 import { PrevalidateAttests } from './PrevalidateAttests.js';
+import { StorageWeightReclaim } from './StorageWeightReclaim.js';
 export const knownSignedExtensions = {
     CheckNonZeroSender,
     CheckSpecVersion,
@@ -19,4 +21,6 @@ export const knownSignedExtensions = {
     ChargeTransactionPayment,
     PrevalidateAttests,
     ChargeAssetTxPayment,
+    CheckMetadataHash,
+    StorageWeightReclaim,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dedot/api",
-  "version": "0.0.1-next.8d3b3cd0.51+8d3b3cd",
+  "version": "0.0.1-next.a5b1d2fb.22+a5b1d2f",
   "description": "A delightful JavaScript/TypeScript client for Polkadot & Substrate",
   "author": "Thang X. Vu <thang@coongcrafts.io>",
   "homepage": "https://github.com/dedotdev/dedot",
@@ -13,13 +13,13 @@
   "type": "module",
   "sideEffects": false,
   "dependencies": {
-    "@dedot/codecs": "0.0.1-next.8d3b3cd0.51+8d3b3cd",
-    "@dedot/providers": "0.0.1-next.8d3b3cd0.51+8d3b3cd",
-    "@dedot/runtime-specs": "0.0.1-next.8d3b3cd0.51+8d3b3cd",
-    "@dedot/shape": "0.0.1-next.8d3b3cd0.51+8d3b3cd",
-    "@dedot/storage": "0.0.1-next.8d3b3cd0.51+8d3b3cd",
-    "@dedot/types": "0.0.1-next.8d3b3cd0.51+8d3b3cd",
-    "@dedot/utils": "0.0.1-next.8d3b3cd0.51+8d3b3cd"
+    "@dedot/codecs": "0.0.1-next.a5b1d2fb.22+a5b1d2f",
+    "@dedot/providers": "0.0.1-next.a5b1d2fb.22+a5b1d2f",
+    "@dedot/runtime-specs": "0.0.1-next.a5b1d2fb.22+a5b1d2f",
+    "@dedot/shape": "0.0.1-next.a5b1d2fb.22+a5b1d2f",
+    "@dedot/storage": "0.0.1-next.a5b1d2fb.22+a5b1d2f",
+    "@dedot/types": "0.0.1-next.a5b1d2fb.22+a5b1d2f",
+    "@dedot/utils": "0.0.1-next.a5b1d2fb.22+a5b1d2f"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json",
@@ -46,9 +46,9 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@polkadot/types": "^11.0.2"
+    "@polkadot/types": "^11.3.1"
   },
-  "gitHead": "8d3b3cd091a10b2d2c362b346cf29437610cd8cc",
+  "gitHead": "a5b1d2fbb14107e2e5bb9de229b2707d814a02e5",
   "module": "./index.js",
   "types": "./index.d.ts"
 }

package/proxychain.d.ts

@@ -11,4 +11,4 @@ export interface Carrier<ChainApi extends GenericSubstrateApi> {
  * @param currentLevel
  * @param maxLevel
  */
-export declare const newProxyChain: <ChainApi extends GenericSubstrateApi<import("@dedot/types").RpcVersion>>(carrier: Carrier<ChainApi>, currentLevel?: number, maxLevel?: number) => unknown;
+export declare const newProxyChain: <ChainApi extends GenericSubstrateApi>(carrier: Carrier<ChainApi>, currentLevel?: number, maxLevel?: number) => unknown;