@dedot/api 0.14.1 → 0.15.1

package/chaintypes/substrate/index.d.ts

@@ -6,6 +6,7 @@ import { ChainJsonRpcApis } from './json-rpc.js';
 import { ChainStorage } from './query.js';
 import { RuntimeApis } from './runtime.js';
 import { ChainTx } from './tx.js';
+import { ChainViewFunctions } from './view-functions.js';
 export * from './types.js';
 export interface VersionedSubstrateApi<Rv extends RpcVersion> extends GenericSubstrateApi<Rv> {
     rpc: ChainJsonRpcApis<Rv>;
@@ -14,6 +15,7 @@ export interface VersionedSubstrateApi<Rv extends RpcVersion> extends GenericSub
     errors: ChainErrors<Rv>;
     events: ChainEvents<Rv>;
     call: RuntimeApis<Rv>;
+    view: ChainViewFunctions<Rv>;
     tx: ChainTx<Rv>;
 }
 /**

package/chaintypes/substrate/runtime.d.ts

@@ -1,6 +1,6 @@
 import type { AccountId32, AccountId32Like, Bytes, BytesLike, DispatchError, FixedBytes, H160, H256, Header, Result, RuntimeVersion, U256, UncheckedExtrinsic, UncheckedExtrinsicLike } from '@dedot/codecs';
 import type { GenericRuntimeApiMethod, GenericRuntimeApis, RpcVersion } from '@dedot/types';
-import type { FrameSupportTokensFungibleUnionOfNativeOrWithId, FrameSupportViewFunctionsViewFunctionDispatchError, FrameSupportViewFunctionsViewFunctionId, KitchensinkRuntimeRuntimeCallLike, PalletContractsPrimitivesCode, PalletContractsPrimitivesCodeUploadReturnValue, PalletContractsPrimitivesContractAccessError, PalletContractsPrimitivesContractResult, PalletContractsPrimitivesContractResultResult, PalletContractsWasmDeterminism, PalletReviveEvmApiDebugRpcTypesCallTrace, PalletReviveEvmApiDebugRpcTypesTracerConfig, PalletReviveEvmApiRpcTypesGenGenericTransaction, PalletRevivePrimitivesCode, PalletRevivePrimitivesCodeUploadReturnValue, PalletRevivePrimitivesContractAccessError, PalletRevivePrimitivesContractResult, PalletRevivePrimitivesContractResultInstantiateReturnValue, PalletRevivePrimitivesEthTransactError, PalletRevivePrimitivesEthTransactInfo, PalletTransactionPaymentFeeDetails, PalletTransactionPaymentRuntimeDispatchInfo, SpAuthorityDiscoveryAppPublic, SpConsensusBabeAppPublic, SpConsensusBabeBabeConfiguration, SpConsensusBabeEpoch, SpConsensusBabeOpaqueKeyOwnershipProof, SpConsensusBeefyDoubleVotingProof, SpConsensusBeefyEcdsaCryptoPublic, SpConsensusBeefyForkVotingProofOpaqueValue, SpConsensusBeefyFutureBlockVotingProof, SpConsensusBeefyValidatorSet, SpConsensusGrandpaAppPublic, SpConsensusGrandpaEquivocationProof, SpConsensusSlotsEquivocationProof, SpConsensusSlotsSlot, SpCoreCryptoKeyTypeId, SpCoreOpaqueMetadata, SpInherentsCheckInherentsResult, SpInherentsInherentData, SpMixnetMixnode, SpMixnetMixnodesErr, SpMixnetSessionStatus, SpMmrPrimitivesEncodableOpaqueLeaf, SpMmrPrimitivesError, SpMmrPrimitivesLeafProof, SpRuntimeBlock, SpRuntimeExtrinsicInclusionMode, SpRuntimeOpaqueValue, SpRuntimeTransactionValidityTransactionSource, SpRuntimeTransactionValidityTransactionValidityError, SpRuntimeTransactionValidityValidTransaction, SpStatementStoreRuntimeApiInvalidStatement, SpStatementStoreRuntimeApiStatementSource, SpStatementStoreRuntimeApiValidStatement, SpStatementStoreStatement, SpWeightsWeightV2Weight } from './types.js';
+import type { FrameSupportTokensFungibleUnionOfNativeOrWithId, FrameSupportViewFunctionsViewFunctionDispatchError, FrameSupportViewFunctionsViewFunctionId, KitchensinkRuntimeRuntimeCallLike, PalletContractsPrimitivesCode, PalletContractsPrimitivesCodeUploadReturnValue, PalletContractsPrimitivesContractAccessError, PalletContractsPrimitivesContractResult, PalletContractsPrimitivesContractResultResult, PalletContractsWasmDeterminism, PalletReviveEvmApiDebugRpcTypesTrace, PalletReviveEvmApiDebugRpcTypesTracerType, PalletReviveEvmApiRpcTypesGenGenericTransaction, PalletRevivePrimitivesCode, PalletRevivePrimitivesCodeUploadReturnValue, PalletRevivePrimitivesContractAccessError, PalletRevivePrimitivesContractResult, PalletRevivePrimitivesContractResultInstantiateReturnValue, PalletRevivePrimitivesEthTransactError, PalletRevivePrimitivesEthTransactInfo, PalletTransactionPaymentFeeDetails, PalletTransactionPaymentRuntimeDispatchInfo, SpAuthorityDiscoveryAppPublic, SpConsensusBabeAppPublic, SpConsensusBabeBabeConfiguration, SpConsensusBabeEpoch, SpConsensusBabeOpaqueKeyOwnershipProof, SpConsensusBeefyDoubleVotingProof, SpConsensusBeefyEcdsaCryptoPublic, SpConsensusBeefyForkVotingProofOpaqueValue, SpConsensusBeefyFutureBlockVotingProof, SpConsensusBeefyValidatorSet, SpConsensusGrandpaAppPublic, SpConsensusGrandpaEquivocationProof, SpConsensusSlotsEquivocationProof, SpConsensusSlotsSlot, SpCoreCryptoKeyTypeId, SpCoreOpaqueMetadata, SpInherentsCheckInherentsResult, SpInherentsInherentData, SpMixnetMixnode, SpMixnetMixnodesErr, SpMixnetSessionStatus, SpMmrPrimitivesEncodableOpaqueLeaf, SpMmrPrimitivesError, SpMmrPrimitivesLeafProof, SpRuntimeBlock, SpRuntimeExtrinsicInclusionMode, SpRuntimeOpaqueValue, SpRuntimeTransactionValidityTransactionSource, SpRuntimeTransactionValidityTransactionValidityError, SpRuntimeTransactionValidityValidTransaction, SpStatementStoreRuntimeApiInvalidStatement, SpStatementStoreRuntimeApiStatementSource, SpStatementStoreRuntimeApiValidStatement, SpStatementStoreStatement, SpWeightsWeightV2Weight } from './types.js';
 export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<Rv> {
     /**
      * @runtimeapi: Core - 0xdf6acb689907609b
@@ -645,9 +645,9 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
          *
          * @callname: ReviveApi_trace_block
          * @param {SpRuntimeBlock} block
-         * @param {PalletReviveEvmApiDebugRpcTypesTracerConfig} config
+         * @param {PalletReviveEvmApiDebugRpcTypesTracerType} config
          **/
-        traceBlock: GenericRuntimeApiMethod<Rv, (block: SpRuntimeBlock, config: PalletReviveEvmApiDebugRpcTypesTracerConfig) => Promise<Array<[number, PalletReviveEvmApiDebugRpcTypesCallTrace]>>>;
+        traceBlock: GenericRuntimeApiMethod<Rv, (block: SpRuntimeBlock, config: PalletReviveEvmApiDebugRpcTypesTracerType) => Promise<Array<[number, PalletReviveEvmApiDebugRpcTypesTrace]>>>;
         /**
          * Traces the execution of a specific transaction within a block.
          *
@@ -659,9 +659,9 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
          * @callname: ReviveApi_trace_tx
          * @param {SpRuntimeBlock} block
          * @param {number} tx_index
-         * @param {PalletReviveEvmApiDebugRpcTypesTracerConfig} config
+         * @param {PalletReviveEvmApiDebugRpcTypesTracerType} config
          **/
-        traceTx: GenericRuntimeApiMethod<Rv, (block: SpRuntimeBlock, txIndex: number, config: PalletReviveEvmApiDebugRpcTypesTracerConfig) => Promise<PalletReviveEvmApiDebugRpcTypesCallTrace | undefined>>;
+        traceTx: GenericRuntimeApiMethod<Rv, (block: SpRuntimeBlock, txIndex: number, config: PalletReviveEvmApiDebugRpcTypesTracerType) => Promise<PalletReviveEvmApiDebugRpcTypesTrace | undefined>>;
         /**
          * Dry run and return the trace of the given call.
          *
@@ -669,9 +669,9 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
          *
          * @callname: ReviveApi_trace_call
          * @param {PalletReviveEvmApiRpcTypesGenGenericTransaction} tx
-         * @param {PalletReviveEvmApiDebugRpcTypesTracerConfig} config
+         * @param {PalletReviveEvmApiDebugRpcTypesTracerType} config
          **/
-        traceCall: GenericRuntimeApiMethod<Rv, (tx: PalletReviveEvmApiRpcTypesGenGenericTransaction, config: PalletReviveEvmApiDebugRpcTypesTracerConfig) => Promise<Result<PalletReviveEvmApiDebugRpcTypesCallTrace, PalletRevivePrimitivesEthTransactError>>>;
+        traceCall: GenericRuntimeApiMethod<Rv, (tx: PalletReviveEvmApiRpcTypesGenGenericTransaction, config: PalletReviveEvmApiDebugRpcTypesTracerType) => Promise<Result<PalletReviveEvmApiDebugRpcTypesTrace, PalletRevivePrimitivesEthTransactError>>>;
         /**
          * Generic runtime api call
          **/

package/chaintypes/substrate/types.d.ts

@@ -33461,11 +33461,17 @@ export type PalletRevivePrimitivesCodeUploadReturnValue = {
     deposit: bigint;
 };
 export type PalletRevivePrimitivesContractAccessError = 'DoesntExist' | 'KeyDecodingFailed';
-export type PalletReviveEvmApiDebugRpcTypesTracerConfig = {
+export type PalletReviveEvmApiDebugRpcTypesTracerType = {
     type: 'CallTracer';
-    value: {
-        withLogs: boolean;
-    };
+    value?: PalletReviveEvmApiDebugRpcTypesCallTracerConfig | undefined;
+};
+export type PalletReviveEvmApiDebugRpcTypesCallTracerConfig = {
+    withLogs: boolean;
+    onlyTopCall: boolean;
+};
+export type PalletReviveEvmApiDebugRpcTypesTrace = {
+    type: 'Call';
+    value: PalletReviveEvmApiDebugRpcTypesCallTrace;
 };
 export type PalletReviveEvmApiDebugRpcTypesCallTrace = {
     from: H160;

package/chaintypes/substrate/view-functions.d.ts

@@ -0,0 +1,3 @@
+import type { GenericChainViewFunctions, RpcVersion } from '@dedot/types';
+export interface ChainViewFunctions<Rv extends RpcVersion> extends GenericChainViewFunctions<Rv> {
+}

package/chaintypes/substrate/view-functions.js

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

package/cjs/chaintypes/substrate/view-functions.js

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

package/cjs/client/BaseSubstrateClient.js

@@ -8,7 +8,7 @@ const index_js_1 = require("../executor/index.js");
 const index_js_2 = require("../json-rpc/index.js");
 const proxychain_js_1 = require("../proxychain.js");
 const index_js_3 = require("../storage/index.js");
-const SUPPORTED_METADATA_VERSIONS = [15, 14];
+const SUPPORTED_METADATA_VERSIONS = [16, 15, 14];
 const MetadataApiHash = (0, utils_1.calcRuntimeApiHash)('Metadata'); // 0x37e397fc7c91f5e4
 const MESSAGE = 'Make sure to call `.connect()` method first before using the API interfaces.';
 function ensurePresence(value) {
@@ -163,10 +163,10 @@ class BaseSubstrateClient extends index_js_2.JsonRpcClient {
         // If there is no runtime, we assume that the node supports Metadata Api V2
         const supportedV2 = runtime ? runtime.apis[MetadataApiHash] === 2 : true;
         if (supportedV2) {
-            // It makes sense to call metadata.metadataVersions to fetch the list of supported metadata versions first
-            // But for now, this approach could potentially help save/reduce one rpc call to the server in case the node support v15
-            // Question: Why not having a `metadata.metadataLatest` to fetch the latest version?
-            for (const version of SUPPORTED_METADATA_VERSIONS) {
+            const versions = (await this.callAt(hash).metadata.metadataVersions()) // --
+                .filter((v) => SUPPORTED_METADATA_VERSIONS.includes(v))
+                .sort((a, b) => b - a); // sort desc, bigger first
+            for (const version of versions) {
                 try {
                     const rawMetadata = await this.callAt(hash).metadata.metadataAtVersion(version);
                     if (!rawMetadata)
@@ -297,6 +297,9 @@ class BaseSubstrateClient extends index_js_2.JsonRpcClient {
     get query() {
         throw new Error('Unimplemented!');
     }
+    get view() {
+        throw new Error('Unimplemented!');
+    }
     get call() {
         return this.callAt();
     }

package/cjs/client/DedotClient.js

@@ -141,6 +141,11 @@ class DedotClient// prettier-end-here
             executor: new index_js_1.StorageQueryExecutorV2(this, this.chainHead),
         });
     }
+    get view() {
+        return (0, proxychain_js_1.newProxyChain)({
+            executor: new index_js_1.ViewFunctionExecutorV2(this, this.chainHead),
+        });
+    }
     get call() {
         return this.callAt();
     }
@@ -189,6 +194,7 @@ class DedotClient// prettier-end-here
         api.errors = (0, proxychain_js_1.newProxyChain)({ executor: new index_js_1.ErrorExecutor(api) });
         api.query = (0, proxychain_js_1.newProxyChain)({ executor: new index_js_1.StorageQueryExecutorV2(api, this.chainHead) });
         api.call = (0, proxychain_js_1.newProxyChain)({ executor: new index_js_1.RuntimeApiExecutorV2(api, this.chainHead) });
+        api.view = (0, proxychain_js_1.newProxyChain)({ executor: new index_js_1.ViewFunctionExecutorV2(api, this.chainHead) });
         this.#apiAtCache[hash] = api;
         return api;
     }

package/cjs/client/LegacyClient.js

@@ -208,6 +208,9 @@ class LegacyClient// prettier-end-here
     callAt(hash) {
         return (0, proxychain_js_1.newProxyChain)({ executor: new index_js_1.RuntimeApiExecutor(this, hash) });
     }
+    get view() {
+        return (0, proxychain_js_1.newProxyChain)({ executor: new index_js_1.ViewFunctionExecutor(this) });
+    }
     /**
      * @description Entry-point for executing on-chain transactions
      *

package/cjs/executor/Executor.js

@@ -27,6 +27,13 @@ class Executor {
         (0, utils_1.assert)(targetPallet, new utils_1.UnknownApiError(`Pallet not found: ${name}`));
         return targetPallet;
     }
+    stateCall(callParams) {
+        const { func, params, at } = callParams;
+        const args = [func, params];
+        if (at)
+            args.push(at);
+        return this.client.rpc.state_call(...args);
+    }
     execute(...paths) {
         try {
             return this.doExecute(...paths);

package/cjs/executor/RuntimeApiExecutor.js

@@ -35,13 +35,6 @@ class RuntimeApiExecutor extends Executor_js_1.Executor {
         callFn.meta = callSpec;
         return callFn;
     }
-    stateCall(callParams) {
-        const { func, params, at } = callParams;
-        const args = [func, params];
-        if (at)
-            args.push(at);
-        return this.client.rpc.state_call(...args);
-    }
     tryDecode(callSpec, raw) {
         const $codec = this.#findCodec(callSpec, `Codec not found to decode respond data for ${this.#callName(callSpec)}`);
         return $codec.tryDecode(raw);

package/cjs/executor/ViewFunctionExecutor.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewFunctionExecutor = void 0;
+const $ = __importStar(require("@dedot/shape"));
+const utils_1 = require("@dedot/utils");
+const Executor_js_1 = require("./Executor.js");
+const RUNTIME_API_NAME = 'RuntimeViewFunction';
+const METHOD_NAME = 'execute_view_function';
+/**
+ * @name ViewFunctionExecutor
+ * @description Execute view functions using the runtimeViewFunction API
+ */
+class ViewFunctionExecutor extends Executor_js_1.Executor {
+    doExecute(pallet, viewFunction) {
+        const targetPallet = this.getPallet(pallet);
+        const viewFunctionDef = this.#findViewFunctionDef(targetPallet, viewFunction);
+        (0, utils_1.assert)(viewFunctionDef, new utils_1.UnknownApiError(`View function not found: ${pallet}.${viewFunction}`));
+        const callFn = async (...args) => {
+            const { inputs, id, output } = viewFunctionDef;
+            const formattedInputs = inputs.map(({ typeId }, index) => this.registry.findCodec(typeId).tryEncode(args[index]));
+            const bytes = (0, utils_1.u8aToHex)((0, utils_1.concatU8a)(id, $.Vec($.u8).tryEncode((0, utils_1.concatU8a)(...formattedInputs))));
+            const func = `${RUNTIME_API_NAME}_${METHOD_NAME}`;
+            const callParams = {
+                func,
+                params: bytes,
+                at: this.atBlockHash,
+            };
+            const rawResult = await this.stateCall(callParams);
+            const result = this.#decodeRawResult(rawResult);
+            if (result.isErr) {
+                throw new utils_1.DedotError(`Error when calling view function (type: ${result.err.type})`);
+            }
+            return this.registry.findCodec(output).tryDecode(result.value);
+        };
+        callFn.meta = {
+            ...viewFunctionDef,
+            pallet: targetPallet.name,
+            palletIndex: targetPallet.index,
+        };
+        return callFn;
+    }
+    #findViewFunctionDef(pallet, viewFunctionName) {
+        return pallet.viewFunctions.find((vf) => (0, utils_1.stringCamelCase)(vf.name) === viewFunctionName);
+    }
+    #decodeRawResult(rawResult) {
+        const runtimeViewFunctionDef = this.metadata.apis
+            .find((api) => api.name === RUNTIME_API_NAME)
+            ?.methods.find((method) => method.name === METHOD_NAME);
+        (0, utils_1.assert)(runtimeViewFunctionDef, new utils_1.UnknownApiError('RuntimeViewFunction definition not found'));
+        const $codec = this.registry.findCodec(runtimeViewFunctionDef.output);
+        const result = $codec.tryDecode(rawResult);
+        return result;
+    }
+}
+exports.ViewFunctionExecutor = ViewFunctionExecutor;

package/cjs/executor/index.js

@@ -22,6 +22,8 @@ __exportStar(require("./ErrorExecutor.js"), exports);
 __exportStar(require("./EventExecutor.js"), exports);
 __exportStar(require("./RuntimeApiExecutor.js"), exports);
 __exportStar(require("./TxExecutor.js"), exports);
+__exportStar(require("./ViewFunctionExecutor.js"), exports);
 __exportStar(require("./v2/StorageQueryExecutorV2.js"), exports);
 __exportStar(require("./v2/RuntimeApiExecutorV2.js"), exports);
 __exportStar(require("./v2/TxExecutorV2.js"), exports);
+__exportStar(require("./v2/ViewFunctionExecutorV2.js"), exports);

package/cjs/executor/v2/ViewFunctionExecutorV2.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewFunctionExecutorV2 = void 0;
+const utils_1 = require("@dedot/utils");
+const ViewFunctionExecutor_js_1 = require("../ViewFunctionExecutor.js");
+/**
+ * @name ViewFunctionExecutorV2
+ */
+class ViewFunctionExecutorV2 extends ViewFunctionExecutor_js_1.ViewFunctionExecutor {
+    chainHead;
+    constructor(client, chainHead) {
+        (0, utils_1.assert)(client.rpcVersion === 'v2', 'Only supports JSON-RPC v2');
+        super(client);
+        this.chainHead = chainHead;
+    }
+    stateCall(callParams) {
+        const { func, params, at } = callParams;
+        return this.chainHead.call(func, params, at);
+    }
+}
+exports.ViewFunctionExecutorV2 = ViewFunctionExecutorV2;

package/cjs/proxychain.js

@@ -15,12 +15,11 @@ const newProxyChain = (carrier, currentLevel = 1, maxLevel = 3) => {
     }
     return new Proxy(carrier, {
         get(target, property, receiver) {
-            if (!target.chain) {
-                target.chain = [];
-            }
-            const { chain } = target;
-            chain.push(property.toString());
-            return (0, exports.newProxyChain)(target, currentLevel + 1, maxLevel);
+            const newCarrier = {
+                executor: target.executor,
+                chain: [...(target.chain || []), property.toString()],
+            };
+            return (0, exports.newProxyChain)(newCarrier, currentLevel + 1, maxLevel);
         },
     });
 };

package/client/BaseSubstrateClient.d.ts

@@ -69,6 +69,7 @@ export declare abstract class BaseSubstrateClient<Rv extends RpcVersion, ChainAp
     get errors(): ChainApi[Rv]['errors'];
     get events(): ChainApi[Rv]['events'];
     get query(): ChainApi[Rv]['query'];
+    get view(): ChainApi[Rv]['view'];
     get call(): ChainApi[Rv]['call'];
     protected callAt(hash?: BlockHash): ChainApi[Rv]['call'];
     get tx(): ChainApi[Rv]['tx'];

package/client/BaseSubstrateClient.js

@@ -5,7 +5,7 @@ import { ConstantExecutor, ErrorExecutor, EventExecutor } from '../executor/inde
 import { isJsonRpcProvider, JsonRpcClient } from '../json-rpc/index.js';
 import { newProxyChain } from '../proxychain.js';
 import { QueryableStorage } from '../storage/index.js';
-const SUPPORTED_METADATA_VERSIONS = [15, 14];
+const SUPPORTED_METADATA_VERSIONS = [16, 15, 14];
 const MetadataApiHash = calcRuntimeApiHash('Metadata'); // 0x37e397fc7c91f5e4
 const MESSAGE = 'Make sure to call `.connect()` method first before using the API interfaces.';
 export function ensurePresence(value) {
@@ -159,10 +159,10 @@ export class BaseSubstrateClient extends JsonRpcClient {
         // If there is no runtime, we assume that the node supports Metadata Api V2
         const supportedV2 = runtime ? runtime.apis[MetadataApiHash] === 2 : true;
         if (supportedV2) {
-            // It makes sense to call metadata.metadataVersions to fetch the list of supported metadata versions first
-            // But for now, this approach could potentially help save/reduce one rpc call to the server in case the node support v15
-            // Question: Why not having a `metadata.metadataLatest` to fetch the latest version?
-            for (const version of SUPPORTED_METADATA_VERSIONS) {
+            const versions = (await this.callAt(hash).metadata.metadataVersions()) // --
+                .filter((v) => SUPPORTED_METADATA_VERSIONS.includes(v))
+                .sort((a, b) => b - a); // sort desc, bigger first
+            for (const version of versions) {
                 try {
                     const rawMetadata = await this.callAt(hash).metadata.metadataAtVersion(version);
                     if (!rawMetadata)
@@ -293,6 +293,9 @@ export class BaseSubstrateClient extends JsonRpcClient {
     get query() {
         throw new Error('Unimplemented!');
     }
+    get view() {
+        throw new Error('Unimplemented!');
+    }
     get call() {
         return this.callAt();
     }

package/client/DedotClient.d.ts

@@ -49,6 +49,7 @@ export declare class DedotClient<ChainApi extends VersionedGenericSubstrateApi =
     protected onDisconnected: () => Promise<void>;
     protected cleanUp(): void;
     get query(): ChainApi[RpcV2]['query'];
+    get view(): ChainApi[RpcV2]['view'];
     get call(): ChainApi[RpcV2]['call'];
     protected callAt(blockHash?: BlockHash): ChainApi[RpcV2]['call'];
     get tx(): ChainApi[RpcV2]['tx'];

package/client/DedotClient.js

@@ -1,7 +1,7 @@
 import { $H256, PortableRegistry } from '@dedot/codecs';
 import { u32 } from '@dedot/shape';
 import { assert, concatU8a, noop, twox64Concat, u8aToHex, xxhashAsU8a } from '@dedot/utils';
-import { ConstantExecutor, ErrorExecutor, EventExecutor, RuntimeApiExecutorV2, StorageQueryExecutorV2, TxExecutorV2, } from '../executor/index.js';
+import { ConstantExecutor, ErrorExecutor, EventExecutor, RuntimeApiExecutorV2, StorageQueryExecutorV2, ViewFunctionExecutorV2, TxExecutorV2, } from '../executor/index.js';
 import { ChainHead, ChainSpec, Transaction, TransactionWatch } from '../json-rpc/index.js';
 import { newProxyChain } from '../proxychain.js';
 import { NewStorageQuery } from '../storage/index.js';
@@ -138,6 +138,11 @@ export class DedotClient// prettier-end-here
             executor: new StorageQueryExecutorV2(this, this.chainHead),
         });
     }
+    get view() {
+        return newProxyChain({
+            executor: new ViewFunctionExecutorV2(this, this.chainHead),
+        });
+    }
     get call() {
         return this.callAt();
     }
@@ -186,6 +191,7 @@ export class DedotClient// prettier-end-here
         api.errors = newProxyChain({ executor: new ErrorExecutor(api) });
         api.query = newProxyChain({ executor: new StorageQueryExecutorV2(api, this.chainHead) });
         api.call = newProxyChain({ executor: new RuntimeApiExecutorV2(api, this.chainHead) });
+        api.view = newProxyChain({ executor: new ViewFunctionExecutorV2(api, this.chainHead) });
         this.#apiAtCache[hash] = api;
         return api;
     }

package/client/LegacyClient.d.ts

@@ -111,6 +111,7 @@ export declare class LegacyClient<ChainApi extends VersionedGenericSubstrateApi
      */
     get call(): ChainApi[RpcLegacy]['call'];
     protected callAt(hash?: BlockHash): ChainApi[RpcLegacy]['call'];
+    get view(): ChainApi[RpcLegacy]['view'];
     /**
      * @description Entry-point for executing on-chain transactions
      *

package/client/LegacyClient.js

@@ -1,5 +1,5 @@
 import { PortableRegistry } from '@dedot/codecs';
-import { ConstantExecutor, ErrorExecutor, EventExecutor, RuntimeApiExecutor, StorageQueryExecutor, TxExecutor, } from '../executor/index.js';
+import { ConstantExecutor, ErrorExecutor, EventExecutor, RuntimeApiExecutor, StorageQueryExecutor, TxExecutor, ViewFunctionExecutor, } from '../executor/index.js';
 import { newProxyChain } from '../proxychain.js';
 import { LegacyStorageQuery } from '../storage/index.js';
 import { BaseSubstrateClient } from './BaseSubstrateClient.js';
@@ -205,6 +205,9 @@ export class LegacyClient// prettier-end-here
     callAt(hash) {
         return newProxyChain({ executor: new RuntimeApiExecutor(this, hash) });
     }
+    get view() {
+        return newProxyChain({ executor: new ViewFunctionExecutor(this) });
+    }
     /**
      * @description Entry-point for executing on-chain transactions
      *

package/executor/Executor.d.ts

@@ -1,6 +1,12 @@
 import type { BlockHash, PalletDefLatest } from '@dedot/codecs';
 import type { GenericSubstrateApi } from '@dedot/types';
+import { HexString } from '@dedot/utils';
 import { ISubstrateClientAt } from '../types.js';
+export interface StateCallParams {
+    func: string;
+    params: HexString;
+    at?: BlockHash;
+}
 /**
  * @name Executor
  * @description Execution abstraction for a specific action
@@ -163,7 +169,7 @@ export declare abstract class Executor<ChainApi extends GenericSubstrateApi = Ge
                 docs: string[];
             }[];
             viewFunctions: {
-                id: readonly [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
+                id: Uint8Array;
                 name: string;
                 inputs: {
                     name: string;
@@ -200,8 +206,8 @@ export declare abstract class Executor<ChainApi extends GenericSubstrateApi = Ge
         extrinsic: {
             versions: number[];
             addressTypeId: number;
-            signatureTypeId: number;
             callTypeId: number;
+            signatureTypeId: number;
             signedExtensionsByVersion: ReadonlyMap<number, number[]>;
             signedExtensions: {
                 ident: string;
@@ -258,6 +264,7 @@ export declare abstract class Executor<ChainApi extends GenericSubstrateApi = Ge
         };
     };
     getPallet(name: string): PalletDefLatest;
+    protected stateCall(callParams: StateCallParams): Promise<HexString>;
     execute(...paths: string[]): unknown;
     abstract doExecute(...paths: string[]): unknown;
 }

package/executor/Executor.js

@@ -24,6 +24,13 @@ export class Executor {
         assert(targetPallet, new UnknownApiError(`Pallet not found: ${name}`));
         return targetPallet;
     }
+    stateCall(callParams) {
+        const { func, params, at } = callParams;
+        const args = [func, params];
+        if (at)
+            args.push(at);
+        return this.client.rpc.state_call(...args);
+    }
     execute(...paths) {
         try {
             return this.doExecute(...paths);

package/executor/RuntimeApiExecutor.d.ts

@@ -1,16 +1,9 @@
-import { BlockHash } from '@dedot/codecs';
 import type { GenericRuntimeApiMethod, GenericSubstrateApi, RuntimeApiMethodParamSpec, RuntimeApiMethodSpec, RuntimeApiSpec } from '@dedot/types';
-import { HexString } from '@dedot/utils';
 import { Executor } from './Executor.js';
 export declare const FallbackRuntimeApis: Record<string, number>;
 export declare const FallbackRuntimeApiSpecs: {
     Metadata: RuntimeApiSpec[];
 };
-export interface StateCallParams {
-    func: string;
-    params: HexString;
-    at?: BlockHash;
-}
 /**
  * @name RuntimeApiExecutor
  * @description Execute a runtime api call,
@@ -21,7 +14,6 @@ export interface StateCallParams {
 export declare class RuntimeApiExecutor<ChainApi extends GenericSubstrateApi = GenericSubstrateApi> extends Executor<ChainApi> {
     #private;
     doExecute(runtimeApi: string, method: string): GenericRuntimeApiMethod;
-    protected stateCall(callParams: StateCallParams): Promise<HexString>;
     tryDecode(callSpec: RuntimeApiMethodSpec, raw: any): unknown;
     tryEncode(paramSpec: RuntimeApiMethodParamSpec, value: any): Uint8Array;
 }

package/executor/RuntimeApiExecutor.js

@@ -32,13 +32,6 @@ export class RuntimeApiExecutor extends Executor {
         callFn.meta = callSpec;
         return callFn;
     }
-    stateCall(callParams) {
-        const { func, params, at } = callParams;
-        const args = [func, params];
-        if (at)
-            args.push(at);
-        return this.client.rpc.state_call(...args);
-    }
     tryDecode(callSpec, raw) {
         const $codec = this.#findCodec(callSpec, `Codec not found to decode respond data for ${this.#callName(callSpec)}`);
         return $codec.tryDecode(raw);

package/executor/ViewFunctionExecutor.d.ts

@@ -0,0 +1,10 @@
+import type { GenericSubstrateApi, GenericViewFunction } from '@dedot/types';
+import { Executor } from './Executor.js';
+/**
+ * @name ViewFunctionExecutor
+ * @description Execute view functions using the runtimeViewFunction API
+ */
+export declare class ViewFunctionExecutor<ChainApi extends GenericSubstrateApi = GenericSubstrateApi> extends Executor<ChainApi> {
+    #private;
+    doExecute(pallet: string, viewFunction: string): GenericViewFunction;
+}

package/executor/ViewFunctionExecutor.js

@@ -0,0 +1,51 @@
+import * as $ from '@dedot/shape';
+import { assert, concatU8a, stringCamelCase, u8aToHex, UnknownApiError, DedotError } from '@dedot/utils';
+import { Executor } from './Executor.js';
+const RUNTIME_API_NAME = 'RuntimeViewFunction';
+const METHOD_NAME = 'execute_view_function';
+/**
+ * @name ViewFunctionExecutor
+ * @description Execute view functions using the runtimeViewFunction API
+ */
+export class ViewFunctionExecutor extends Executor {
+    doExecute(pallet, viewFunction) {
+        const targetPallet = this.getPallet(pallet);
+        const viewFunctionDef = this.#findViewFunctionDef(targetPallet, viewFunction);
+        assert(viewFunctionDef, new UnknownApiError(`View function not found: ${pallet}.${viewFunction}`));
+        const callFn = async (...args) => {
+            const { inputs, id, output } = viewFunctionDef;
+            const formattedInputs = inputs.map(({ typeId }, index) => this.registry.findCodec(typeId).tryEncode(args[index]));
+            const bytes = u8aToHex(concatU8a(id, $.Vec($.u8).tryEncode(concatU8a(...formattedInputs))));
+            const func = `${RUNTIME_API_NAME}_${METHOD_NAME}`;
+            const callParams = {
+                func,
+                params: bytes,
+                at: this.atBlockHash,
+            };
+            const rawResult = await this.stateCall(callParams);
+            const result = this.#decodeRawResult(rawResult);
+            if (result.isErr) {
+                throw new DedotError(`Error when calling view function (type: ${result.err.type})`);
+            }
+            return this.registry.findCodec(output).tryDecode(result.value);
+        };
+        callFn.meta = {
+            ...viewFunctionDef,
+            pallet: targetPallet.name,
+            palletIndex: targetPallet.index,
+        };
+        return callFn;
+    }
+    #findViewFunctionDef(pallet, viewFunctionName) {
+        return pallet.viewFunctions.find((vf) => stringCamelCase(vf.name) === viewFunctionName);
+    }
+    #decodeRawResult(rawResult) {
+        const runtimeViewFunctionDef = this.metadata.apis
+            .find((api) => api.name === RUNTIME_API_NAME)
+            ?.methods.find((method) => method.name === METHOD_NAME);
+        assert(runtimeViewFunctionDef, new UnknownApiError('RuntimeViewFunction definition not found'));
+        const $codec = this.registry.findCodec(runtimeViewFunctionDef.output);
+        const result = $codec.tryDecode(rawResult);
+        return result;
+    }
+}

package/executor/index.d.ts

@@ -6,6 +6,8 @@ export * from './ErrorExecutor.js';
 export * from './EventExecutor.js';
 export * from './RuntimeApiExecutor.js';
 export * from './TxExecutor.js';
+export * from './ViewFunctionExecutor.js';
 export * from './v2/StorageQueryExecutorV2.js';
 export * from './v2/RuntimeApiExecutorV2.js';
 export * from './v2/TxExecutorV2.js';
+export * from './v2/ViewFunctionExecutorV2.js';

package/executor/index.js

@@ -6,6 +6,8 @@ export * from './ErrorExecutor.js';
 export * from './EventExecutor.js';
 export * from './RuntimeApiExecutor.js';
 export * from './TxExecutor.js';
+export * from './ViewFunctionExecutor.js';
 export * from './v2/StorageQueryExecutorV2.js';
 export * from './v2/RuntimeApiExecutorV2.js';
 export * from './v2/TxExecutorV2.js';
+export * from './v2/ViewFunctionExecutorV2.js';

package/executor/v2/RuntimeApiExecutorV2.d.ts

@@ -3,7 +3,8 @@ import type { GenericSubstrateApi } from '@dedot/types';
 import { HexString } from '@dedot/utils';
 import { ChainHead } from '../../json-rpc/index.js';
 import { ISubstrateClientAt } from '../../types.js';
-import { RuntimeApiExecutor, StateCallParams } from '../RuntimeApiExecutor.js';
+import { StateCallParams } from '../Executor.js';
+import { RuntimeApiExecutor } from '../RuntimeApiExecutor.js';
 /**
  * @name RuntimeApiExecutorV2
  */

package/executor/v2/ViewFunctionExecutorV2.d.ts

@@ -0,0 +1,14 @@
+import type { GenericSubstrateApi } from '@dedot/types';
+import { HexString } from '@dedot/utils';
+import { ChainHead } from '../../json-rpc/index.js';
+import { ISubstrateClientAt } from '../../types.js';
+import { StateCallParams } from '../Executor.js';
+import { ViewFunctionExecutor } from '../ViewFunctionExecutor.js';
+/**
+ * @name ViewFunctionExecutorV2
+ */
+export declare class ViewFunctionExecutorV2<ChainApi extends GenericSubstrateApi = GenericSubstrateApi> extends ViewFunctionExecutor<ChainApi> {
+    chainHead: ChainHead;
+    constructor(client: ISubstrateClientAt<ChainApi>, chainHead: ChainHead);
+    protected stateCall(callParams: StateCallParams): Promise<HexString>;
+}

package/executor/v2/ViewFunctionExecutorV2.js

@@ -0,0 +1,17 @@
+import { assert } from '@dedot/utils';
+import { ViewFunctionExecutor } from '../ViewFunctionExecutor.js';
+/**
+ * @name ViewFunctionExecutorV2
+ */
+export class ViewFunctionExecutorV2 extends ViewFunctionExecutor {
+    chainHead;
+    constructor(client, chainHead) {
+        assert(client.rpcVersion === 'v2', 'Only supports JSON-RPC v2');
+        super(client);
+        this.chainHead = chainHead;
+    }
+    stateCall(callParams) {
+        const { func, params, at } = callParams;
+        return this.chainHead.call(func, params, at);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dedot/api",
-  "version": "0.14.1",
+  "version": "0.15.1",
   "description": "A delightful JavaScript/TypeScript client for Polkadot & Substrate",
   "author": "Thang X. Vu <thang@dedot.dev>",
   "homepage": "https://dedot.dev",
@@ -13,13 +13,13 @@
   "type": "module",
   "sideEffects": false,
   "dependencies": {
-    "@dedot/codecs": "0.14.1",
-    "@dedot/providers": "0.14.1",
-    "@dedot/runtime-specs": "0.14.1",
-    "@dedot/shape": "0.14.1",
-    "@dedot/storage": "0.14.1",
-    "@dedot/types": "0.14.1",
-    "@dedot/utils": "0.14.1"
+    "@dedot/codecs": "0.15.1",
+    "@dedot/providers": "0.15.1",
+    "@dedot/runtime-specs": "0.15.1",
+    "@dedot/shape": "0.15.1",
+    "@dedot/storage": "0.15.1",
+    "@dedot/types": "0.15.1",
+    "@dedot/utils": "0.15.1"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json",
@@ -48,7 +48,7 @@
     "node": ">=18"
   },
   "license": "Apache-2.0",
-  "gitHead": "d5adec49781a6e0b45910055dcaf9bf472a39a6b",
+  "gitHead": "fdac8072dc7ea6698f19f11604904b665ec7ba89",
   "module": "./index.js",
   "types": "./index.d.ts"
 }

package/proxychain.js

@@ -12,12 +12,11 @@ export const newProxyChain = (carrier, currentLevel = 1, maxLevel = 3) => {
     }
     return new Proxy(carrier, {
         get(target, property, receiver) {
-            if (!target.chain) {
-                target.chain = [];
-            }
-            const { chain } = target;
-            chain.push(property.toString());
-            return newProxyChain(target, currentLevel + 1, maxLevel);
+            const newCarrier = {
+                executor: target.executor,
+                chain: [...(target.chain || []), property.toString()],
+            };
+            return newProxyChain(newCarrier, currentLevel + 1, maxLevel);
         },
     });
 };

package/types.d.ts

@@ -99,6 +99,7 @@ export interface ISubstrateClientAt<ChainApi extends GenericSubstrateApi = Gener
     call: ChainApi['call'];
     events: ChainApi['events'];
     errors: ChainApi['errors'];
+    view: ChainApi['view'];
 }
 /**
  * A generic interface for Substrate clients