@paraspell/sdk-common 13.5.0 → 13.6.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Supported Polkadot / Kusama / Westend / Paseo parachains.
  */
-declare const PARACHAINS: readonly ["AssetHubPolkadot", "Acala", "Ajuna", "Astar", "BifrostPolkadot", "BridgeHubPolkadot", "Centrifuge", "Darwinia", "EnergyWebX", "Hydration", "Interlay", "Heima", "Jamton", "Moonbeam", "CoretimePolkadot", "Collectives", "Crust", "NeuroWeb", "Pendulum", "Mythos", "Peaq", "PeoplePolkadot", "Unique", "Xode", "AssetHubKusama", "BridgeHubKusama", "Karura", "Kintsugi", "Moonriver", "CoretimeKusama", "Encointer", "Basilisk", "BifrostKusama", "CrustShadow", "Crab", "Laos", "Quartz", "RobonomicsPolkadot", "PeopleKusama", "Shiden", "Zeitgeist", "AssetHubWestend", "BridgeHubWestend", "CollectivesWestend", "CoretimeWestend", "Penpal", "PeopleWestend", "AjunaPaseo", "AssetHubPaseo", "BifrostPaseo", "BridgeHubPaseo", "CoretimePaseo", "EnergyWebXPaseo", "HeimaPaseo", "HydrationPaseo", "LaosPaseo", "NeuroWebPaseo", "PeoplePaseo", "ZeitgeistPaseo"];
+declare const PARACHAINS: readonly ["AssetHubPolkadot", "Acala", "Ajuna", "Astar", "BifrostPolkadot", "BridgeHubPolkadot", "Centrifuge", "Darwinia", "EnergyWebX", "Hydration", "Interlay", "Heima", "Jamton", "Moonbeam", "CoretimePolkadot", "Collectives", "Crust", "NeuroWeb", "Pendulum", "Mythos", "Peaq", "PeoplePolkadot", "Unique", "Xode", "AssetHubKusama", "BridgeHubKusama", "Karura", "Kintsugi", "Moonriver", "CoretimeKusama", "Encointer", "Basilisk", "BifrostKusama", "CrustShadow", "Crab", "Quartz", "RobonomicsPolkadot", "PeopleKusama", "Shiden", "Zeitgeist", "AssetHubWestend", "BridgeHubWestend", "CollectivesWestend", "CoretimeWestend", "Penpal", "PeopleWestend", "AjunaPaseo", "AssetHubPaseo", "BifrostPaseo", "BridgeHubPaseo", "CoretimePaseo", "EnergyWebXPaseo", "HeimaPaseo", "HydrationPaseo", "NeuroWebPaseo", "PeoplePaseo", "ZeitgeistPaseo"];
 /**
  * Relaychains.
  */
@@ -9,15 +9,19 @@ declare const RELAYCHAINS: readonly ["Polkadot", "Kusama", "Westend", "Paseo"];
 /**
  * All Substrate chains (parachains + relaychains).
  */
-declare const SUBSTRATE_CHAINS: readonly ["AssetHubPolkadot", "Acala", "Ajuna", "Astar", "BifrostPolkadot", "BridgeHubPolkadot", "Centrifuge", "Darwinia", "EnergyWebX", "Hydration", "Interlay", "Heima", "Jamton", "Moonbeam", "CoretimePolkadot", "Collectives", "Crust", "NeuroWeb", "Pendulum", "Mythos", "Peaq", "PeoplePolkadot", "Unique", "Xode", "AssetHubKusama", "BridgeHubKusama", "Karura", "Kintsugi", "Moonriver", "CoretimeKusama", "Encointer", "Basilisk", "BifrostKusama", "CrustShadow", "Crab", "Laos", "Quartz", "RobonomicsPolkadot", "PeopleKusama", "Shiden", "Zeitgeist", "AssetHubWestend", "BridgeHubWestend", "CollectivesWestend", "CoretimeWestend", "Penpal", "PeopleWestend", "AjunaPaseo", "AssetHubPaseo", "BifrostPaseo", "BridgeHubPaseo", "CoretimePaseo", "EnergyWebXPaseo", "HeimaPaseo", "HydrationPaseo", "LaosPaseo", "NeuroWebPaseo", "PeoplePaseo", "ZeitgeistPaseo", "Polkadot", "Kusama", "Westend", "Paseo"];
+declare const SUBSTRATE_CHAINS: readonly ["AssetHubPolkadot", "Acala", "Ajuna", "Astar", "BifrostPolkadot", "BridgeHubPolkadot", "Centrifuge", "Darwinia", "EnergyWebX", "Hydration", "Interlay", "Heima", "Jamton", "Moonbeam", "CoretimePolkadot", "Collectives", "Crust", "NeuroWeb", "Pendulum", "Mythos", "Peaq", "PeoplePolkadot", "Unique", "Xode", "AssetHubKusama", "BridgeHubKusama", "Karura", "Kintsugi", "Moonriver", "CoretimeKusama", "Encointer", "Basilisk", "BifrostKusama", "CrustShadow", "Crab", "Quartz", "RobonomicsPolkadot", "PeopleKusama", "Shiden", "Zeitgeist", "AssetHubWestend", "BridgeHubWestend", "CollectivesWestend", "CoretimeWestend", "Penpal", "PeopleWestend", "AjunaPaseo", "AssetHubPaseo", "BifrostPaseo", "BridgeHubPaseo", "CoretimePaseo", "EnergyWebXPaseo", "HeimaPaseo", "HydrationPaseo", "NeuroWebPaseo", "PeoplePaseo", "ZeitgeistPaseo", "Polkadot", "Kusama", "Westend", "Paseo"];
 /**
  * External chains (non-Substrate/Polkadot ecosystem chains).
  */
 declare const EXTERNAL_CHAINS: readonly ["Ethereum", "EthereumTestnet"];
+/**
+ * Default SS58 address prefix.
+ */
+declare const DEFAULT_SS58_PREFIX = 42;
 /**
  * All supported chains.
  */
-declare const CHAINS: readonly ["AssetHubPolkadot", "Acala", "Ajuna", "Astar", "BifrostPolkadot", "BridgeHubPolkadot", "Centrifuge", "Darwinia", "EnergyWebX", "Hydration", "Interlay", "Heima", "Jamton", "Moonbeam", "CoretimePolkadot", "Collectives", "Crust", "NeuroWeb", "Pendulum", "Mythos", "Peaq", "PeoplePolkadot", "Unique", "Xode", "AssetHubKusama", "BridgeHubKusama", "Karura", "Kintsugi", "Moonriver", "CoretimeKusama", "Encointer", "Basilisk", "BifrostKusama", "CrustShadow", "Crab", "Laos", "Quartz", "RobonomicsPolkadot", "PeopleKusama", "Shiden", "Zeitgeist", "AssetHubWestend", "BridgeHubWestend", "CollectivesWestend", "CoretimeWestend", "Penpal", "PeopleWestend", "AjunaPaseo", "AssetHubPaseo", "BifrostPaseo", "BridgeHubPaseo", "CoretimePaseo", "EnergyWebXPaseo", "HeimaPaseo", "HydrationPaseo", "LaosPaseo", "NeuroWebPaseo", "PeoplePaseo", "ZeitgeistPaseo", "Polkadot", "Kusama", "Westend", "Paseo", "Ethereum", "EthereumTestnet"];
+declare const CHAINS: readonly ["AssetHubPolkadot", "Acala", "Ajuna", "Astar", "BifrostPolkadot", "BridgeHubPolkadot", "Centrifuge", "Darwinia", "EnergyWebX", "Hydration", "Interlay", "Heima", "Jamton", "Moonbeam", "CoretimePolkadot", "Collectives", "Crust", "NeuroWeb", "Pendulum", "Mythos", "Peaq", "PeoplePolkadot", "Unique", "Xode", "AssetHubKusama", "BridgeHubKusama", "Karura", "Kintsugi", "Moonriver", "CoretimeKusama", "Encointer", "Basilisk", "BifrostKusama", "CrustShadow", "Crab", "Quartz", "RobonomicsPolkadot", "PeopleKusama", "Shiden", "Zeitgeist", "AssetHubWestend", "BridgeHubWestend", "CollectivesWestend", "CoretimeWestend", "Penpal", "PeopleWestend", "AjunaPaseo", "AssetHubPaseo", "BifrostPaseo", "BridgeHubPaseo", "CoretimePaseo", "EnergyWebXPaseo", "HeimaPaseo", "HydrationPaseo", "NeuroWebPaseo", "PeoplePaseo", "ZeitgeistPaseo", "Polkadot", "Kusama", "Westend", "Paseo", "Ethereum", "EthereumTestnet"];
 
 type TParachain = (typeof PARACHAINS)[number];
 type TRelaychain = (typeof RELAYCHAINS)[number];
@@ -110,32 +114,52 @@ declare enum Version {
 
 declare const isTLocation: (value: unknown) => value is TLocation;
 
-declare const isSubstrateBridge: (origin: TChain, destination: TChain) => boolean;
-declare const isSnowbridge: (_origin: TChain, destination: TChain) => boolean;
-declare const isBridge: (origin: TChain, destination: TChain) => boolean;
+declare const isSubstrateBridge: <TCustomChain extends string = never>(origin: TChain | TCustomChain, destination: TChain | TCustomChain) => boolean;
+declare const isSnowbridge: <TCustomChain extends string = never>(_origin: TChain | TCustomChain, destination: TChain | TCustomChain) => boolean;
+declare const isBridge: <TCustomChain extends string = never>(origin: TChain | TCustomChain, destination: TChain | TCustomChain) => boolean;
 
+/** * Checks if a given string is a valid chain.
+ *
+ * @param chain - The string to check.
+ * @returns True if the string is a valid chain; otherwise, false.
+ */
+declare const isChain: (chain: string) => chain is TChain;
+/**
+ * Checks if a given string is a valid substrate chain.
+ *
+ * @param chain - The string to check.
+ * @returns True if the string is a valid substrate chain; otherwise, false.
+ */
+declare const isSubstrateChain: (chain: string) => chain is TSubstrateChain;
 /**
  * Determines whether a given chain is a relaychain.
  *
  * @param chain - The chain to check.
  * @returns True if the chain is a relaychain; otherwise, false.
  */
-declare const isRelayChain: (chain: TChain) => chain is TRelaychain;
+declare const isRelayChain: <TCustomChain extends string = never>(chain: TChain | TCustomChain) => chain is TRelaychain;
 /**
  * Determines whether a given chain is an external chain.
  *
  * @param chain - The chain to check.
  * @returns True if the chain is an external chain; otherwise, false.
  */
-declare const isExternalChain: (chain: TChain) => chain is TExternalChain;
+declare const isExternalChain: <TCustomChain extends string = never>(chain: TChain | TCustomChain) => chain is TExternalChain;
+/**
+ * Determines whether a given chain is a custom (user-registered) chain.
+ *
+ * @param chain - The chain to check.
+ * @returns True if the chain is a custom added chain; otherwise, false.
+ */
+declare const isCustomChain: <TCustomChain extends string = never>(chain: TChain | TCustomChain) => chain is TCustomChain;
 /**
  * Checks if a given chain is a system chain.
  *
  * @param chain - The chain to check.
  * @returns True if the chain is a system chain; otherwise, false.
  */
-declare const isSystemChain: (chain: TChain) => boolean;
-declare const isTrustedChain: (chain: TChain) => boolean;
+declare const isSystemChain: <TCustomChain extends string = never>(chain: TChain | TCustomChain) => boolean;
+declare const isTrustedChain: <TCustomChain extends string = never>(chain: TChain | TCustomChain) => boolean;
 
 declare const isPrimitive: (obj: unknown) => boolean;
 declare const deepEqual: (obj1: unknown, obj2: unknown) => boolean;
@@ -145,5 +169,5 @@ declare const hasJunction: (location: TLocation, junctionType: TJunctionType, ju
 
 declare const replaceBigInt: (_key: string, value: unknown) => unknown;
 
-export { CHAINS, EXTERNAL_CHAINS, PARACHAINS, Parents, RELAYCHAINS, SUBSTRATE_CHAINS, Version, deepEqual, getJunctionValue, hasJunction, isBridge, isExternalChain, isPrimitive, isRelayChain, isSnowbridge, isSubstrateBridge, isSystemChain, isTLocation, isTrustedChain, replaceBigInt };
+export { CHAINS, DEFAULT_SS58_PREFIX, EXTERNAL_CHAINS, PARACHAINS, Parents, RELAYCHAINS, SUBSTRATE_CHAINS, Version, deepEqual, getJunctionValue, hasJunction, isBridge, isChain, isCustomChain, isExternalChain, isPrimitive, isRelayChain, isSnowbridge, isSubstrateBridge, isSubstrateChain, isSystemChain, isTLocation, isTrustedChain, replaceBigInt };
 export type { TChain, TExternalChain, TJunction, TJunctionAccountId32, TJunctionAccountIndex64, TJunctionAccountKey20, TJunctionGeneralIndex, TJunctionGeneralKey, TJunctionGlobalConsensus, TJunctionOnlyChild, TJunctionPalletInstance, TJunctionParachain, TJunctionPlurality, TJunctionType, TJunctions, TLocation, TParachain, TRelaychain, TSubstrateChain };

package/dist/index.mjs

@@ -5,11 +5,11 @@ var PARACHAINS = [
 // Polkadot chains
 'AssetHubPolkadot', 'Acala', 'Ajuna', 'Astar', 'BifrostPolkadot', 'BridgeHubPolkadot', 'Centrifuge', 'Darwinia', 'EnergyWebX', 'Hydration', 'Interlay', 'Heima', 'Jamton', 'Moonbeam', 'CoretimePolkadot', 'Collectives', 'Crust', 'NeuroWeb', 'Pendulum', 'Mythos', 'Peaq', 'PeoplePolkadot', 'Unique', 'Xode',
 // Kusama chains
-'AssetHubKusama', 'BridgeHubKusama', 'Karura', 'Kintsugi', 'Moonriver', 'CoretimeKusama', 'Encointer', 'Basilisk', 'BifrostKusama', 'CrustShadow', 'Crab', 'Laos', 'Quartz', 'RobonomicsPolkadot', 'PeopleKusama', 'Shiden', 'Zeitgeist',
+'AssetHubKusama', 'BridgeHubKusama', 'Karura', 'Kintsugi', 'Moonriver', 'CoretimeKusama', 'Encointer', 'Basilisk', 'BifrostKusama', 'CrustShadow', 'Crab', 'Quartz', 'RobonomicsPolkadot', 'PeopleKusama', 'Shiden', 'Zeitgeist',
 // Westend testnet chains
 'AssetHubWestend', 'BridgeHubWestend', 'CollectivesWestend', 'CoretimeWestend', 'Penpal', 'PeopleWestend',
 // Paseo testnet chains
-'AjunaPaseo', 'AssetHubPaseo', 'BifrostPaseo', 'BridgeHubPaseo', 'CoretimePaseo', 'EnergyWebXPaseo', 'HeimaPaseo', 'HydrationPaseo', 'LaosPaseo', 'NeuroWebPaseo', 'PeoplePaseo', 'ZeitgeistPaseo'];
+'AjunaPaseo', 'AssetHubPaseo', 'BifrostPaseo', 'BridgeHubPaseo', 'CoretimePaseo', 'EnergyWebXPaseo', 'HeimaPaseo', 'HydrationPaseo', 'NeuroWebPaseo', 'PeoplePaseo', 'ZeitgeistPaseo'];
 /**
  * Relaychains.
  */
@@ -22,6 +22,10 @@ var SUBSTRATE_CHAINS = [].concat(PARACHAINS, RELAYCHAINS);
  * External chains (non-Substrate/Polkadot ecosystem chains).
  */
 var EXTERNAL_CHAINS = ['Ethereum', 'EthereumTestnet'];
+/**
+ * Default SS58 address prefix.
+ */
+var DEFAULT_SS58_PREFIX = 42;
 /**
  * All supported chains.
  */
@@ -163,6 +167,27 @@ var Version;
   Version["V5"] = "V5";
 })(Version || (Version = {}));
 
+/** * Checks if a given string is a valid chain.
+ *
+ * @param chain - The string to check.
+ * @returns True if the string is a valid chain; otherwise, false.
+ */
+var isChain = function isChain(chain) {
+  return CHAINS.some(function (c) {
+    return c === chain;
+  });
+};
+/**
+ * Checks if a given string is a valid substrate chain.
+ *
+ * @param chain - The string to check.
+ * @returns True if the string is a valid substrate chain; otherwise, false.
+ */
+var isSubstrateChain = function isSubstrateChain(chain) {
+  return SUBSTRATE_CHAINS.some(function (c) {
+    return c === chain;
+  });
+};
 /**
  * Determines whether a given chain is a relaychain.
  *
@@ -170,7 +195,9 @@ var Version;
  * @returns True if the chain is a relaychain; otherwise, false.
  */
 var isRelayChain = function isRelayChain(chain) {
-  return RELAYCHAINS.includes(chain);
+  return RELAYCHAINS.some(function (c) {
+    return c === chain;
+  });
 };
 /**
  * Determines whether a given chain is an external chain.
@@ -179,7 +206,20 @@ var isRelayChain = function isRelayChain(chain) {
  * @returns True if the chain is an external chain; otherwise, false.
  */
 var isExternalChain = function isExternalChain(chain) {
-  return EXTERNAL_CHAINS.includes(chain);
+  return EXTERNAL_CHAINS.some(function (c) {
+    return c === chain;
+  });
+};
+/**
+ * Determines whether a given chain is a custom (user-registered) chain.
+ *
+ * @param chain - The chain to check.
+ * @returns True if the chain is a custom added chain; otherwise, false.
+ */
+var isCustomChain = function isCustomChain(chain) {
+  return !CHAINS.some(function (c) {
+    return c === chain;
+  });
 };
 /**
  * Checks if a given chain is a system chain.
@@ -189,14 +229,15 @@ var isExternalChain = function isExternalChain(chain) {
  */
 var isSystemChain = function isSystemChain(chain) {
   var systemChains = ['AssetHubPolkadot', 'AssetHubKusama', 'AssetHubWestend', 'AssetHubPaseo', 'BridgeHubPolkadot', 'BridgeHubKusama', 'BridgeHubWestend', 'BridgeHubPaseo', 'PeoplePolkadot', 'PeopleKusama', 'PeopleWestend', 'PeoplePaseo', 'CoretimePolkadot', 'CoretimeKusama', 'CoretimeWestend', 'CoretimePaseo', 'Collectives', 'Encointer', 'CollectivesWestend'];
-  return systemChains.includes(chain) || isRelayChain(chain);
+  return systemChains.some(function (c) {
+    return c === chain;
+  }) || isRelayChain(chain);
 };
 var isTrustedChain = function isTrustedChain(chain) {
-  var trusted = ['Mythos', 'Encointer'];
-  var isTrustedByAh = function isTrustedByAh(chain) {
-    return trusted.includes(chain);
-  };
-  return isTrustedByAh(chain) || isSystemChain(chain);
+  var isTrustedByAh = ['Mythos', 'Encointer'];
+  return isTrustedByAh.some(function (t) {
+    return t === chain;
+  }) || isSystemChain(chain);
 };
 
 var COMPATIBLE_BRIDGES = [['AssetHubPolkadot', 'AssetHubKusama']];
@@ -330,4 +371,4 @@ var replaceBigInt = function replaceBigInt(_key, value) {
   return typeof value === 'bigint' ? value.toString() : value;
 };
 
-export { CHAINS, EXTERNAL_CHAINS, PARACHAINS, Parents, RELAYCHAINS, SUBSTRATE_CHAINS, Version, _deepEqual as deepEqual, getJunctionValue, hasJunction, isBridge, isExternalChain, isPrimitive, isRelayChain, isSnowbridge, isSubstrateBridge, isSystemChain, isTLocation, isTrustedChain, replaceBigInt };
+export { CHAINS, DEFAULT_SS58_PREFIX, EXTERNAL_CHAINS, PARACHAINS, Parents, RELAYCHAINS, SUBSTRATE_CHAINS, Version, _deepEqual as deepEqual, getJunctionValue, hasJunction, isBridge, isChain, isCustomChain, isExternalChain, isPrimitive, isRelayChain, isSnowbridge, isSubstrateBridge, isSubstrateChain, isSystemChain, isTLocation, isTrustedChain, replaceBigInt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk-common",
-  "version": "13.5.0",
+  "version": "13.6.0",
   "description": "SDK common code for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -23,17 +23,17 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@babel/plugin-syntax-import-attributes": "^7.28.6",
-    "@babel/preset-env": "^7.29.2",
+    "@babel/plugin-syntax-import-attributes": "^7.29.7",
+    "@babel/preset-env": "^7.29.7",
     "@codecov/rollup-plugin": "^2.0.1",
     "@polkadot/api": "^16.5.6",
     "@polkadot/types": "^16.5.6",
     "@rollup/plugin-babel": "^7.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@vitest/coverage-v8": "^4.1.5",
+    "@vitest/coverage-v8": "^4.1.7",
     "dotenv": "^17.4.2",
-    "rollup": "^4.60.2",
+    "rollup": "^4.60.4",
     "rollup-plugin-dts": "^6.4.1"
   },
   "scripts": {