@dedot/api 0.0.1-next.9c1d51fe.10 → 0.0.1-next.b6596712.6

package/chaintypes/substrate/consts.js

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

package/chaintypes/substrate/errors.js

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

package/chaintypes/substrate/events.js

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

package/chaintypes/substrate/index.js

@@ -1 +1,2 @@
+// 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 +1,2 @@
+// Generated by dedot cli
 export {};

package/chaintypes/substrate/query.js

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

package/chaintypes/substrate/runtime.js

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

package/chaintypes/substrate/tx.js

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

package/chaintypes/substrate/types.js

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

package/cjs/chaintypes/substrate/consts.js

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

package/cjs/chaintypes/substrate/errors.js

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

package/cjs/chaintypes/substrate/events.js

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

package/cjs/chaintypes/substrate/index.js

@@ -1,4 +1,5 @@
 "use strict";
+// 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,2 +1,3 @@
 "use strict";
+// Generated by dedot cli
 Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/chaintypes/substrate/query.js

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

package/cjs/chaintypes/substrate/runtime.js

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

package/cjs/chaintypes/substrate/tx.js

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

package/cjs/chaintypes/substrate/types.js

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

package/cjs/client/DedotClient.js

@@ -14,7 +14,8 @@ const BaseSubstrateClient_js_1 = require("./BaseSubstrateClient.js");
  *
  * __Unstable, use with caution.__
  */
-class DedotClient extends BaseSubstrateClient_js_1.BaseSubstrateClient {
+class DedotClient// prettier-end-here
+ extends BaseSubstrateClient_js_1.BaseSubstrateClient {
     _chainHead;
     _chainSpec;
     _txBroadcaster;

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,8 @@ const KEEP_ALIVE_INTERVAL = 10_000; // in ms
  * run().catch(console.error);
  * ```
  */
-class Dedot extends BaseSubstrateClient_js_1.BaseSubstrateClient {
+class LegacyClient// prettier-end-here
+ extends BaseSubstrateClient_js_1.BaseSubstrateClient {
     #runtimeSubscriptionUnsub;
     #healthTimer;
     #apiAtCache = {};
@@ -62,15 +63,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 +248,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/client/BaseSubstrateClient.d.ts

@@ -1,8 +1,7 @@
 import { BlockHash, Hash, Metadata, PortableRegistry, RuntimeVersion } from '@dedot/codecs';
 import type { JsonRpcProvider } from '@dedot/providers';
 import { type IStorage } from '@dedot/storage';
-import { GenericSubstrateApi, RpcVersion, VersionedGenericSubstrateApi } from '@dedot/types';
-import type { SubstrateApi } from '../chaintypes/index.js';
+import { GenericSubstrateApi, RpcVersion } from '@dedot/types';
 import { JsonRpcClient } from '../json-rpc/index.js';
 import type { ApiEvent, ApiOptions, ISubstrateClient, ISubstrateClientAt, JsonRpcClientOptions, MetadataKey, SubstrateRuntimeVersion } from '../types.js';
 export declare function ensurePresence<T>(value: T): NonNullable<T>;
@@ -10,7 +9,7 @@ export declare function ensurePresence<T>(value: T): NonNullable<T>;
  * @name BaseSubstrateClient
  * @description Base & shared abstraction for Substrate API Clients
  */
-export declare abstract class BaseSubstrateClient<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi> extends JsonRpcClient<ChainApi[RpcVersion], ApiEvent> implements ISubstrateClient<ChainApi[RpcVersion]> {
+export declare abstract class BaseSubstrateClient<ChainApi extends GenericSubstrateApi = GenericSubstrateApi> extends JsonRpcClient<ChainApi, ApiEvent> implements ISubstrateClient<ChainApi> {
     rpcVersion: RpcVersion;
     protected _options: ApiOptions;
     protected _registry?: PortableRegistry;
@@ -54,12 +53,12 @@ export declare abstract class BaseSubstrateClient<ChainApi extends VersionedGene
     get registry(): PortableRegistry;
     get genesisHash(): Hash;
     get runtimeVersion(): SubstrateRuntimeVersion;
-    get consts(): ChainApi[RpcVersion]['consts'];
-    get errors(): ChainApi[RpcVersion]['errors'];
-    get events(): ChainApi[RpcVersion]['events'];
-    get query(): ChainApi[RpcVersion]['query'];
-    get call(): ChainApi[RpcVersion]['call'];
-    protected callAt(hash?: BlockHash): ChainApi[RpcVersion]['call'];
-    get tx(): ChainApi[RpcVersion]['tx'];
-    at<ChainApiAt extends GenericSubstrateApi = ChainApi[RpcVersion]>(hash: BlockHash): Promise<ISubstrateClientAt<ChainApiAt>>;
+    get consts(): ChainApi['consts'];
+    get errors(): ChainApi['errors'];
+    get events(): ChainApi['events'];
+    get query(): ChainApi['query'];
+    get call(): ChainApi['call'];
+    protected callAt(hash?: BlockHash): ChainApi['call'];
+    get tx(): ChainApi['tx'];
+    at<ChainApiAt extends GenericSubstrateApi = ChainApi>(hash: BlockHash): Promise<ISubstrateClientAt<ChainApiAt>>;
 }

package/client/DedotClient.d.ts

@@ -11,7 +11,8 @@ import { BaseSubstrateClient } from './BaseSubstrateClient.js';
  *
  * __Unstable, use with caution.__
  */
-export declare class DedotClient<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi> extends BaseSubstrateClient<ChainApi> {
+export declare class DedotClient<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi>// prettier-end-here
+ extends BaseSubstrateClient<ChainApi[RpcV2]> {
     #private;
     protected _chainHead?: ChainHead;
     protected _chainSpec?: ChainSpec;

package/client/DedotClient.js

@@ -11,7 +11,8 @@ import { BaseSubstrateClient, ensurePresence } from './BaseSubstrateClient.js';
  *
  * __Unstable, use with caution.__
  */
-export class DedotClient extends BaseSubstrateClient {
+export class DedotClient// prettier-end-here
+ extends BaseSubstrateClient {
     _chainHead;
     _chainSpec;
     _txBroadcaster;

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,8 @@ 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>// prettier-end-here
+ extends BaseSubstrateClient<ChainApi[RpcLegacy]> {
     #private;
     /**
      * Use factory methods (`create`, `new`) to create `Dedot` instances.
@@ -55,13 +56,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,8 @@ const KEEP_ALIVE_INTERVAL = 10_000; // in ms
  * run().catch(console.error);
  * ```
  */
-export class Dedot extends BaseSubstrateClient {
+export class LegacyClient// prettier-end-here
+ extends BaseSubstrateClient {
     #runtimeSubscriptionUnsub;
     #healthTimer;
     #apiAtCache = {};
@@ -59,15 +60,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.9c1d51fe.10+9c1d51f",
+  "version": "0.0.1-next.b6596712.6+b659671",
   "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.9c1d51fe.10+9c1d51f",
-    "@dedot/providers": "0.0.1-next.9c1d51fe.10+9c1d51f",
-    "@dedot/runtime-specs": "0.0.1-next.9c1d51fe.10+9c1d51f",
-    "@dedot/shape": "0.0.1-next.9c1d51fe.10+9c1d51f",
-    "@dedot/storage": "0.0.1-next.9c1d51fe.10+9c1d51f",
-    "@dedot/types": "0.0.1-next.9c1d51fe.10+9c1d51f",
-    "@dedot/utils": "0.0.1-next.9c1d51fe.10+9c1d51f"
+    "@dedot/codecs": "0.0.1-next.b6596712.6+b659671",
+    "@dedot/providers": "0.0.1-next.b6596712.6+b659671",
+    "@dedot/runtime-specs": "0.0.1-next.b6596712.6+b659671",
+    "@dedot/shape": "0.0.1-next.b6596712.6+b659671",
+    "@dedot/storage": "0.0.1-next.b6596712.6+b659671",
+    "@dedot/types": "0.0.1-next.b6596712.6+b659671",
+    "@dedot/utils": "0.0.1-next.b6596712.6+b659671"
   },
   "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": "^12.0.1"
   },
-  "gitHead": "9c1d51fe7b14ed2f0361ec6329d881bd54f48c2e",
+  "gitHead": "b6596712119e3812b8af54d50f23371a3d556ad4",
   "module": "./index.js",
   "types": "./index.d.ts"
 }