@talismn/sapi 0.0.6 → 0.0.8

package/dist/declarations/src/helpers/getDecodedCall.d.ts

@@ -8,4 +8,6 @@ export declare const getDecodedCall: (palletName: string, methodName: string, ar
         value: unknown;
     };
 };
-export declare const getDecodedCallFromPayload: <Res extends DecodedCall>(chain: Chain, payload: SignerPayloadJSON) => Res;
+export declare const getDecodedCallFromPayload: <Res extends DecodedCall>(chain: Chain, payload: {
+    method: SignerPayloadJSON["method"];
+}) => Res;

package/dist/declarations/src/helpers/types.d.ts

@@ -1,8 +1,6 @@
 import { ExtDef } from "@polkadot/types/extrinsic/signedExtensions/types";
-import { getDynamicBuilder, getLookupFn, UnifiedMetadata } from "@talismn/scale";
+import { MetadataBuilder, MetadataLookup, UnifiedMetadata } from "@talismn/scale";
 import { SapiConnector } from "./getSapiConnector";
-export type ScaleBuilder = ReturnType<typeof getDynamicBuilder>;
-export type ScaleLookup = ReturnType<typeof getLookupFn>;
 export type Chain = {
     connector: SapiConnector;
     hexMetadata: `0x${string}`;
@@ -14,8 +12,9 @@ export type Chain = {
     signedExtensions?: ExtDef;
     registryTypes?: unknown;
     metadata: UnifiedMetadata;
-    lookup: ScaleLookup;
-    builder: ScaleBuilder;
+    lookup: MetadataLookup;
+    builder: MetadataBuilder;
+    metadataRpc: `0x${string}`;
 };
 export type ChainInfo = {
     specName: string;

package/dist/declarations/src/sapi.d.ts

@@ -1,5 +1,6 @@
 import { ExtDef } from "@polkadot/types/extrinsic/signedExtensions/types";
 import { SignerPayloadJSON } from "@polkadot/types/types";
+import { Chain } from "./helpers/types";
 import { DecodedCall, PayloadSignerConfig, SapiConnectorProps } from "./types";
 export type ScaleApi = NonNullable<ReturnType<typeof getScaleApi>>;
 export declare const getScaleApi: (connector: SapiConnectorProps, hexMetadata: `0x${string}`, token: {
@@ -16,6 +17,7 @@ export declare const getScaleApi: (connector: SapiConnectorProps, hexMetadata: `
         symbol: string;
         decimals: number;
     };
+    chain: Chain;
     getConstant: <T>(pallet: string, constant: string) => T;
     getStorage: <T>(pallet: string, entry: string, keys: unknown[], at?: string) => Promise<T>;
     getDecodedCall: (pallet: string, method: string, args: unknown) => {
@@ -25,7 +27,9 @@ export declare const getScaleApi: (connector: SapiConnectorProps, hexMetadata: `
             value: unknown;
         };
     };
-    getDecodedCallFromPayload: <Res extends DecodedCall>(payload: SignerPayloadJSON) => Res;
+    getDecodedCallFromPayload: <Res extends DecodedCall>(payload: {
+        method: SignerPayloadJSON["method"];
+    }) => Res;
     getExtrinsicPayload: (pallet: string, method: string, args: unknown, config: PayloadSignerConfig) => Promise<{
         payload: SignerPayloadJSON;
         txMetadata?: Uint8Array;
@@ -33,7 +37,7 @@ export declare const getScaleApi: (connector: SapiConnectorProps, hexMetadata: `
     getFeeEstimate: (payload: SignerPayloadJSON) => Promise<bigint>;
     getRuntimeCallValue: <T>(apiName: string, method: string, args: unknown[]) => Promise<T>;
     getTypeRegistry: (payload: SignerPayloadJSON) => import("@polkadot/types").TypeRegistry;
-    submit: (payload: SignerPayloadJSON, signature?: `0x${string}`, txInfo?: any) => Promise<{
+    submit: (payload: SignerPayloadJSON, signature?: `0x${string}`, txInfo?: unknown) => Promise<{
         hash: `0x${string}`;
     }>;
     getCallDocs: (pallet: string, method: string) => string | null;

package/dist/talismn-sapi.cjs.dev.js

@@ -1,11 +1,11 @@
 'use strict';
 
-var util = require('@polkadot/util');
 var scale = require('@talismn/scale');
 var anylogger = require('anylogger');
 var polkadotApi = require('polkadot-api');
 var metadataBuilders = require('@polkadot-api/metadata-builders');
 var utils = require('@polkadot-api/utils');
+var util = require('@polkadot/util');
 var types = require('@polkadot/types');
 var merkleizeMetadata = require('@polkadot-api/merkleize-metadata');
 var substrateBindings = require('@polkadot-api/substrate-bindings');
@@ -431,7 +431,7 @@ function trailingZeroes(n) {
   return i;
 }
 
-const PERIOD = 64; // validity period in blocks, used for mortal era
+const ERA_PERIOD = 64; // validity period in blocks, used for mortal era
 
 const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerConfig, chainInfo) => {
   const {
@@ -442,13 +442,23 @@ const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerC
 
   // on unstable networks with lots of forks (ex: westend asset hub as of june 2025),
   // using a finalized block as reference for mortality is necessary for txs to get through
-  const blockHash = await getSendRequestResult(chain, "chain_getFinalizedHead", [], false);
-  const [nonce, genesisHash, blockNumber] = await Promise.all([getSendRequestResult(chain, "system_accountNextIndex", [signerConfig.address], false), getStorageValue(chain, "System", "BlockHash", [0]), getStorageValue(chain, "System", "Number", [], blockHash)]);
+  let blockHash = await getSendRequestResult(chain, "chain_getFinalizedHead", [], false);
+  const [nonce, genesisHash, blockNumberFinalized, blockNumberCurrent] = await Promise.all([getSendRequestResult(chain, "system_accountNextIndex", [signerConfig.address], false), getStorageValue(chain, "System", "BlockHash", [0]), getStorageValue(chain, "System", "Number", [], blockHash), getStorageValue(chain, "System", "Number", [])]);
   if (!genesisHash) throw new Error("Genesis hash not found");
   if (!blockHash) throw new Error("Block hash not found");
+  let blockNumber = blockNumberFinalized;
+
+  // on Autonomys the finalized block hash is wrong (7000 blocks behind),
+  // if we use it to craft a tx it will be invalid
+  // => if finalized block number is more than 32 blocks behind, use current - 16
+  if (blockNumberCurrent - blockNumberFinalized > 32) {
+    blockNumber = blockNumberCurrent - 16;
+    const binBlockHash = await getStorageValue(chain, "System", "BlockHash", [blockNumber]);
+    blockHash = binBlockHash.asHex();
+  }
   const era = mortal({
-    period: PERIOD,
-    phase: blockNumber % PERIOD
+    period: ERA_PERIOD,
+    phase: blockNumber % ERA_PERIOD
   });
   const signedExtensions = chain.metadata.extrinsic.signedExtensions.map(ext => ext.identifier);
   const basePayload = {
@@ -485,10 +495,11 @@ const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerC
 };
 
 const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signedExtensions, registryTypes) => {
-  const metadata = scale.unifyMetadata(scale.decAnyMetadata(hexMetadata));
-  util.assert(metadata, `Missing Metadata V14+ for chain ${connector.chainId}`);
-  const lookup = scale.getLookupFn(metadata);
-  const builder = scale.getDynamicBuilder(lookup);
+  const {
+    unifiedMetadata: metadata,
+    lookupFn: lookup,
+    builder
+  } = scale.parseMetadataRpc(hexMetadata);
   const chain = {
     connector: getSapiConnector(connector),
     hexMetadata,
@@ -498,7 +509,8 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     registryTypes,
     metadata,
     lookup,
-    builder
+    builder,
+    metadataRpc: hexMetadata
   };
   const chainInfo = getChainInfo(chain);
   const {
@@ -514,6 +526,7 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     hasCheckMetadataHash,
     base58Prefix,
     token: chain.token,
+    chain,
     getConstant: (pallet, constant) => getConstantValue(chain, pallet, constant),
     getStorage: (pallet, entry, keys, at) => getStorageValue(chain, pallet, entry, keys, at),
     getDecodedCall: (pallet, method, args) => getDecodedCall(pallet, method, args),
@@ -522,8 +535,7 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     getFeeEstimate: payload => getFeeEstimate(chain, payload, chainInfo),
     getRuntimeCallValue: (apiName, method, args) => getRuntimeCallResult(chain, apiName, method, args),
     getTypeRegistry: payload => getTypeRegistry(chain, payload),
-    submit: (payload, signature, txInfo // eslint-disable-line @typescript-eslint/no-explicit-any
-    ) => chain.connector.submit(payload, signature, txInfo),
+    submit: (payload, signature, txInfo) => chain.connector.submit(payload, signature, txInfo),
     getCallDocs: (pallet, method) => getCallDocs(chain, pallet, method),
     getDryRunCall: (from, decodedCall) => getDryRunCall(chain, from, decodedCall),
     isApiAvailable: (name, method) => isApiAvailable(chain, name, method)
@@ -553,7 +565,11 @@ const fetchBestMetadata = async (rpcSend, allowLegacyFallback) => {
     const message = cause?.message;
     if (allowLegacyFallback || message?.includes("is not found") ||
     // ex: crust standalone
-    message?.includes("Module doesn't have export Metadata_metadata_versions") // ex: 3DPass
+    message?.includes("Module doesn't have export Metadata_metadata_versions") ||
+    // ex: 3DPass
+    message?.includes("Exported method Metadata_metadata_versions is not found") ||
+    // ex: sora-polkadot & sora-standalone
+    message?.includes("Execution, MethodNotFound, Metadata_metadata_versions") // ex: stafi
     ) {
       return await rpcSend("state_getMetadata", [], true);
     }

package/dist/talismn-sapi.cjs.prod.js

@@ -1,11 +1,11 @@
 'use strict';
 
-var util = require('@polkadot/util');
 var scale = require('@talismn/scale');
 var anylogger = require('anylogger');
 var polkadotApi = require('polkadot-api');
 var metadataBuilders = require('@polkadot-api/metadata-builders');
 var utils = require('@polkadot-api/utils');
+var util = require('@polkadot/util');
 var types = require('@polkadot/types');
 var merkleizeMetadata = require('@polkadot-api/merkleize-metadata');
 var substrateBindings = require('@polkadot-api/substrate-bindings');
@@ -431,7 +431,7 @@ function trailingZeroes(n) {
   return i;
 }
 
-const PERIOD = 64; // validity period in blocks, used for mortal era
+const ERA_PERIOD = 64; // validity period in blocks, used for mortal era
 
 const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerConfig, chainInfo) => {
   const {
@@ -442,13 +442,23 @@ const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerC
 
   // on unstable networks with lots of forks (ex: westend asset hub as of june 2025),
   // using a finalized block as reference for mortality is necessary for txs to get through
-  const blockHash = await getSendRequestResult(chain, "chain_getFinalizedHead", [], false);
-  const [nonce, genesisHash, blockNumber] = await Promise.all([getSendRequestResult(chain, "system_accountNextIndex", [signerConfig.address], false), getStorageValue(chain, "System", "BlockHash", [0]), getStorageValue(chain, "System", "Number", [], blockHash)]);
+  let blockHash = await getSendRequestResult(chain, "chain_getFinalizedHead", [], false);
+  const [nonce, genesisHash, blockNumberFinalized, blockNumberCurrent] = await Promise.all([getSendRequestResult(chain, "system_accountNextIndex", [signerConfig.address], false), getStorageValue(chain, "System", "BlockHash", [0]), getStorageValue(chain, "System", "Number", [], blockHash), getStorageValue(chain, "System", "Number", [])]);
   if (!genesisHash) throw new Error("Genesis hash not found");
   if (!blockHash) throw new Error("Block hash not found");
+  let blockNumber = blockNumberFinalized;
+
+  // on Autonomys the finalized block hash is wrong (7000 blocks behind),
+  // if we use it to craft a tx it will be invalid
+  // => if finalized block number is more than 32 blocks behind, use current - 16
+  if (blockNumberCurrent - blockNumberFinalized > 32) {
+    blockNumber = blockNumberCurrent - 16;
+    const binBlockHash = await getStorageValue(chain, "System", "BlockHash", [blockNumber]);
+    blockHash = binBlockHash.asHex();
+  }
   const era = mortal({
-    period: PERIOD,
-    phase: blockNumber % PERIOD
+    period: ERA_PERIOD,
+    phase: blockNumber % ERA_PERIOD
   });
   const signedExtensions = chain.metadata.extrinsic.signedExtensions.map(ext => ext.identifier);
   const basePayload = {
@@ -485,10 +495,11 @@ const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerC
 };
 
 const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signedExtensions, registryTypes) => {
-  const metadata = scale.unifyMetadata(scale.decAnyMetadata(hexMetadata));
-  util.assert(metadata, `Missing Metadata V14+ for chain ${connector.chainId}`);
-  const lookup = scale.getLookupFn(metadata);
-  const builder = scale.getDynamicBuilder(lookup);
+  const {
+    unifiedMetadata: metadata,
+    lookupFn: lookup,
+    builder
+  } = scale.parseMetadataRpc(hexMetadata);
   const chain = {
     connector: getSapiConnector(connector),
     hexMetadata,
@@ -498,7 +509,8 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     registryTypes,
     metadata,
     lookup,
-    builder
+    builder,
+    metadataRpc: hexMetadata
   };
   const chainInfo = getChainInfo(chain);
   const {
@@ -514,6 +526,7 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     hasCheckMetadataHash,
     base58Prefix,
     token: chain.token,
+    chain,
     getConstant: (pallet, constant) => getConstantValue(chain, pallet, constant),
     getStorage: (pallet, entry, keys, at) => getStorageValue(chain, pallet, entry, keys, at),
     getDecodedCall: (pallet, method, args) => getDecodedCall(pallet, method, args),
@@ -522,8 +535,7 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     getFeeEstimate: payload => getFeeEstimate(chain, payload, chainInfo),
     getRuntimeCallValue: (apiName, method, args) => getRuntimeCallResult(chain, apiName, method, args),
     getTypeRegistry: payload => getTypeRegistry(chain, payload),
-    submit: (payload, signature, txInfo // eslint-disable-line @typescript-eslint/no-explicit-any
-    ) => chain.connector.submit(payload, signature, txInfo),
+    submit: (payload, signature, txInfo) => chain.connector.submit(payload, signature, txInfo),
     getCallDocs: (pallet, method) => getCallDocs(chain, pallet, method),
     getDryRunCall: (from, decodedCall) => getDryRunCall(chain, from, decodedCall),
     isApiAvailable: (name, method) => isApiAvailable(chain, name, method)
@@ -553,7 +565,11 @@ const fetchBestMetadata = async (rpcSend, allowLegacyFallback) => {
     const message = cause?.message;
     if (allowLegacyFallback || message?.includes("is not found") ||
     // ex: crust standalone
-    message?.includes("Module doesn't have export Metadata_metadata_versions") // ex: 3DPass
+    message?.includes("Module doesn't have export Metadata_metadata_versions") ||
+    // ex: 3DPass
+    message?.includes("Exported method Metadata_metadata_versions is not found") ||
+    // ex: sora-polkadot & sora-standalone
+    message?.includes("Execution, MethodNotFound, Metadata_metadata_versions") // ex: stafi
     ) {
       return await rpcSend("state_getMetadata", [], true);
     }

package/dist/talismn-sapi.esm.js

@@ -1,9 +1,9 @@
-import { assert, u8aConcatStrict } from '@polkadot/util';
-import { unifyMetadata, decAnyMetadata, getLookupFn as getLookupFn$1, getDynamicBuilder } from '@talismn/scale';
+import { parseMetadataRpc } from '@talismn/scale';
 import anylogger from 'anylogger';
 import { Enum, Binary } from 'polkadot-api';
 import { getLookupFn } from '@polkadot-api/metadata-builders';
 import { toHex, mergeUint8 } from '@polkadot-api/utils';
+import { assert, u8aConcatStrict } from '@polkadot/util';
 import { TypeRegistry, Metadata } from '@polkadot/types';
 import { merkleizeMetadata } from '@polkadot-api/merkleize-metadata';
 import { enhanceEncoder, Bytes, u16 } from '@polkadot-api/substrate-bindings';
@@ -425,7 +425,7 @@ function trailingZeroes(n) {
   return i;
 }
 
-const PERIOD = 64; // validity period in blocks, used for mortal era
+const ERA_PERIOD = 64; // validity period in blocks, used for mortal era
 
 const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerConfig, chainInfo) => {
   const {
@@ -436,13 +436,23 @@ const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerC
 
   // on unstable networks with lots of forks (ex: westend asset hub as of june 2025),
   // using a finalized block as reference for mortality is necessary for txs to get through
-  const blockHash = await getSendRequestResult(chain, "chain_getFinalizedHead", [], false);
-  const [nonce, genesisHash, blockNumber] = await Promise.all([getSendRequestResult(chain, "system_accountNextIndex", [signerConfig.address], false), getStorageValue(chain, "System", "BlockHash", [0]), getStorageValue(chain, "System", "Number", [], blockHash)]);
+  let blockHash = await getSendRequestResult(chain, "chain_getFinalizedHead", [], false);
+  const [nonce, genesisHash, blockNumberFinalized, blockNumberCurrent] = await Promise.all([getSendRequestResult(chain, "system_accountNextIndex", [signerConfig.address], false), getStorageValue(chain, "System", "BlockHash", [0]), getStorageValue(chain, "System", "Number", [], blockHash), getStorageValue(chain, "System", "Number", [])]);
   if (!genesisHash) throw new Error("Genesis hash not found");
   if (!blockHash) throw new Error("Block hash not found");
+  let blockNumber = blockNumberFinalized;
+
+  // on Autonomys the finalized block hash is wrong (7000 blocks behind),
+  // if we use it to craft a tx it will be invalid
+  // => if finalized block number is more than 32 blocks behind, use current - 16
+  if (blockNumberCurrent - blockNumberFinalized > 32) {
+    blockNumber = blockNumberCurrent - 16;
+    const binBlockHash = await getStorageValue(chain, "System", "BlockHash", [blockNumber]);
+    blockHash = binBlockHash.asHex();
+  }
   const era = mortal({
-    period: PERIOD,
-    phase: blockNumber % PERIOD
+    period: ERA_PERIOD,
+    phase: blockNumber % ERA_PERIOD
   });
   const signedExtensions = chain.metadata.extrinsic.signedExtensions.map(ext => ext.identifier);
   const basePayload = {
@@ -479,10 +489,11 @@ const getSignerPayloadJSON = async (chain, palletName, methodName, args, signerC
 };
 
 const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signedExtensions, registryTypes) => {
-  const metadata = unifyMetadata(decAnyMetadata(hexMetadata));
-  assert(metadata, `Missing Metadata V14+ for chain ${connector.chainId}`);
-  const lookup = getLookupFn$1(metadata);
-  const builder = getDynamicBuilder(lookup);
+  const {
+    unifiedMetadata: metadata,
+    lookupFn: lookup,
+    builder
+  } = parseMetadataRpc(hexMetadata);
   const chain = {
     connector: getSapiConnector(connector),
     hexMetadata,
@@ -492,7 +503,8 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     registryTypes,
     metadata,
     lookup,
-    builder
+    builder,
+    metadataRpc: hexMetadata
   };
   const chainInfo = getChainInfo(chain);
   const {
@@ -508,6 +520,7 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     hasCheckMetadataHash,
     base58Prefix,
     token: chain.token,
+    chain,
     getConstant: (pallet, constant) => getConstantValue(chain, pallet, constant),
     getStorage: (pallet, entry, keys, at) => getStorageValue(chain, pallet, entry, keys, at),
     getDecodedCall: (pallet, method, args) => getDecodedCall(pallet, method, args),
@@ -516,8 +529,7 @@ const getScaleApi = (connector, hexMetadata, token, hasCheckMetadataHash, signed
     getFeeEstimate: payload => getFeeEstimate(chain, payload, chainInfo),
     getRuntimeCallValue: (apiName, method, args) => getRuntimeCallResult(chain, apiName, method, args),
     getTypeRegistry: payload => getTypeRegistry(chain, payload),
-    submit: (payload, signature, txInfo // eslint-disable-line @typescript-eslint/no-explicit-any
-    ) => chain.connector.submit(payload, signature, txInfo),
+    submit: (payload, signature, txInfo) => chain.connector.submit(payload, signature, txInfo),
     getCallDocs: (pallet, method) => getCallDocs(chain, pallet, method),
     getDryRunCall: (from, decodedCall) => getDryRunCall(chain, from, decodedCall),
     isApiAvailable: (name, method) => isApiAvailable(chain, name, method)
@@ -547,7 +559,11 @@ const fetchBestMetadata = async (rpcSend, allowLegacyFallback) => {
     const message = cause?.message;
     if (allowLegacyFallback || message?.includes("is not found") ||
     // ex: crust standalone
-    message?.includes("Module doesn't have export Metadata_metadata_versions") // ex: 3DPass
+    message?.includes("Module doesn't have export Metadata_metadata_versions") ||
+    // ex: 3DPass
+    message?.includes("Exported method Metadata_metadata_versions is not found") ||
+    // ex: sora-polkadot & sora-standalone
+    message?.includes("Execution, MethodNotFound, Metadata_metadata_versions") // ex: stafi
     ) {
       return await rpcSend("state_getMetadata", [], true);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talismn/sapi",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "author": "Talisman",
   "homepage": "https://talisman.xyz",
   "license": "GPL-3.0-or-later",
@@ -31,7 +31,7 @@
     "anylogger": "^1.0.11",
     "polkadot-api": "1.13.1",
     "scale-ts": "^1.6.1",
-    "@talismn/scale": "0.1.2"
+    "@talismn/scale": "0.2.0"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",