@paraspell/sdk-dedot 13.5.0 → 13.6.0

package/README.md

@@ -317,6 +317,74 @@ const tx = await builder.buildBatch({
 await builder.disconnect()
 ```
 
+#### Adding chain and/or assets
+SDK features ability to add custom chain and/or custom assets simply by adding its config to the Builder.
+
+```ts
+  const tx = await Builder({
+    // Adding custom chain
+    customChains: {
+      MyChain: {
+        paraId: 4242,
+        ecosystem: 'Polkadot',
+        xcmVersion: Version.V5,
+        providers: [{ name: 'Primary', endpoint: 'wss://rpc.mychain.example/ws' }],
+        // Everything below is optional — auto-fetched from runtime `system.properties` when omitted
+        nativeAssetSymbol: 'MYC',
+        nativeAssetDecimals: 12,
+        ss58Prefix: 42,
+        pallets: {
+            nativeAssets: "Balances”,
+            otherAssets: "Assets",
+        }
+        assets: [
+          {
+            symbol: 'USDC',
+            decimals: 6,
+            location: {
+              parents: 1,
+              interior: { X3: [{ Parachain: 1000 }, { PalletInstance: 50 }, {
+  GeneralIndex: 1337 }] }
+            },
+            assetId: '1337'
+          }
+        ]
+      }
+    },
+
+    // Adding assets to existing chains
+    customAssets: {
+      AssetHubPolkadot: [
+        {
+          symbol: 'MYNEWUSD',
+          decimals: 6,
+          assetId: '9999',
+          location: {
+            parents: 0,
+            interior: { X2: [{ PalletInstance: 50 }, { GeneralIndex: 9999 }] }
+          }
+        },
+        {
+          // Replace an existing registry asset that shares the same location
+          symbol: 'USDT',
+          decimals: 6,
+          assetId: '1984',
+          location: {
+            parents: 0,
+            interior: { X2: [{ PalletInstance: 50 }, { GeneralIndex: 1984 }] }
+          },
+          forceOverride: true
+        }
+      ]
+    }
+  })
+    .from('MyChain') // custom chain name — TS-autocompletes
+    .to('AssetHubPolkadot') // could be any of the existing or also the new ones added
+    .currency({ symbol: 'USDC', amount: amount })
+    .recipient(address)
+    .build()
+```
+
 ### Localhost test setup
 
 ```ts

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _paraspell_sdk_core from '@paraspell/sdk-core';
-import { Foreign, ForeignAbstract, Native, Override, findAssetInfo, getAllAssetsSymbols, getAssetDecimals, getAssetId, getAssets, getAssetsObject, getExistentialDeposit, getNativeAssetSymbol, getNativeAssets, getOtherAssets, getRelayChainSymbol, getSupportedAssets, getTChain, hasSupportForAsset, isChainEvm, TSubstrateChain, TBuilderOptions, TApiOrUrl, GeneralBuilder as GeneralBuilder$1, TTransferBaseOptions } from '@paraspell/sdk-core';
+import { Foreign, ForeignAbstract, Native, Override, findAssetInfo, getAllAssetsSymbols, getAssetDecimals, getAssetId, getAssets, getAssetsObject, getExistentialDeposit, getNativeAssetSymbol, getNativeAssets, getOtherAssets, getRelayChainSymbol, getSupportedAssets, getTChain, hasSupportForAsset, isChainEvm, TSubstrateChain, TBuilderOptions, TApiOrUrl, GeneralBuilder as GeneralBuilder$1, TCustomChainFrom, TTransferBaseOptions } from '@paraspell/sdk-core';
 export * from '@paraspell/sdk-core';
 import { DedotClient as DedotClient$1 } from 'dedot';
 import { GenericSubstrateApi as GenericSubstrateApi$1, ChainSubmittableExtrinsic as ChainSubmittableExtrinsic$1, IKeyringPair as IKeyringPair$1 } from 'dedot/types';
@@ -67,13 +67,13 @@ declare namespace assets {
 declare const convertSs58: (address: string, chain: TSubstrateChain) => string;
 
 /**
- * Creates a new Builder instance using the Dedot client.
+ * Creates a new Builder instance.
  *
- * @param api - The API instance or options to use for building transactions.
+ * @param options - Either an existing API instance, a WS URL, or a config object.
  * @returns A new Builder instance.
  */
-declare const Builder: (api?: TBuilderOptions<TApiOrUrl<TDedotApi>>) => GeneralBuilder$1<DedotClient<GenericSubstrateApi>, ChainSubmittableExtrinsic, IKeyringPair, object>;
-type GeneralBuilder<T extends Partial<TTransferBaseOptions<TDedotApi, TDedotExtrinsic, TDedotSigner>> = object> = GeneralBuilder$1<TDedotApi, TDedotExtrinsic, TDedotSigner, T>;
+declare const Builder: <const TOpts extends TBuilderOptions<TApiOrUrl<TDedotApi>>>(options?: TOpts) => GeneralBuilder$1<DedotClient<GenericSubstrateApi>, ChainSubmittableExtrinsic, IKeyringPair, object, TCustomChainFrom<TOpts>>;
+type GeneralBuilder<T extends Partial<TTransferBaseOptions<TDedotApi, TDedotExtrinsic, TDedotSigner>> = object, TCustomChain extends string = never> = GeneralBuilder$1<TDedotApi, TDedotExtrinsic, TDedotSigner, T, TCustomChain>;
 
 declare const dryRun: (options: _paraspell_sdk_core.TDryRunBaseOptions<ChainSubmittableExtrinsic> & {
     api?: TApiOrUrl<TDedotApi>;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { getEvmPrivateKeyHex, getNativeAssetSymbol, getOtherAssets, NumberFormatError, createClientCache, MAX_CLIENTS, EXTENSION_MS, createClientPoolHelpers, BatchMode, isConfig, findNativeAssetInfoOrThrow, getChainProviders, isSenderSigner, PolkadotApi, UnsupportedOperationError, findAssetInfoOrThrow, hasXcmPaymentApiSupport, resolveModuleError, getAssetsObject, RuntimeApiUnavailableError, wrapTxBypass, localizeLocation, createAssetId, addXcmVersionHeader, isAssetXcEqual, RELAY_LOCATION, getRelayChainOf, replaceBigInt, createChainClient as createChainClient$1, getBalance as getBalance$1, Foreign, ForeignAbstract, Native, Override, findAssetInfo, getAllAssetsSymbols, getAssetDecimals, getAssetId, getAssets, getExistentialDeposit, getNativeAssets, getRelayChainSymbol, getSupportedAssets, getTChain, hasSupportForAsset, isChainEvm, convertSs58 as convertSs58$1, Builder as Builder$1, getBridgeStatus as getBridgeStatus$1, getParaEthTransferFees as getParaEthTransferFees$1, DRY_RUN_CLIENT_TIMEOUT_MS, dryRun as dryRun$1, dryRunOrigin as dryRunOrigin$1 } from '@paraspell/sdk-core';
+import { getEvmPrivateKeyHex, getNativeAssetSymbol, getOtherAssets, NumberFormatError, createClientCache, MAX_CLIENTS, EXTENSION_MS, createClientPoolHelpers, BatchMode, isConfig, findNativeAssetInfoOrThrow, getChainProvidersImpl, isSenderSigner, PolkadotApi, UnsupportedOperationError, findAssetInfoOrThrow, hasXcmPaymentApiSupport, resolveModuleError, getAssetsObject, RuntimeApiUnavailableError, wrapTxBypass, localizeLocation, createAssetId, addXcmVersionHeader, isAssetXcEqual, RELAY_LOCATION, getRelayChainOf, replaceBigInt, createChainClient as createChainClient$1, getBalance as getBalance$1, Foreign, ForeignAbstract, Native, Override, findAssetInfo, getAllAssetsSymbols, getAssetDecimals, getAssetId, getAssets, getExistentialDeposit, getNativeAssets, getRelayChainSymbol, getSupportedAssets, getTChain, hasSupportForAsset, isChainEvm, convertSs58 as convertSs58$1, Builder as Builder$1, getBridgeStatus as getBridgeStatus$1, getParaEthTransferFees as getParaEthTransferFees$1, DRY_RUN_CLIENT_TIMEOUT_MS, dryRun as dryRun$1, dryRunOrigin as dryRunOrigin$1 } from '@paraspell/sdk-core';
 export * from '@paraspell/sdk-core';
 import { stringPascalCase, isEvmAddress, decodeAddress, isHex, u8aToHex, hexToU8a, stringToU8a, blake2AsHex } from 'dedot/utils';
 import { Keyring } from '@polkadot/keyring';
@@ -941,6 +941,30 @@ var DedotApi = /*#__PURE__*/function (_PolkadotApi) {
       var methodFormatted = snakeToCamel(method);
       return Promise.resolve(((_this$api$tx$palletFo = this.api.tx[palletFormatted]) === null || _this$api$tx$palletFo === void 0 ? void 0 : _this$api$tx$palletFo[methodFormatted]) !== undefined);
     }
+  }, {
+    key: "hasRuntimeApi",
+    value: function hasRuntimeApi(runtimeApi) {
+      return Promise.resolve(this.api.call[lowercaseFirstLetter(runtimeApi)] !== undefined);
+    }
+  }, {
+    key: "fetchPalletList",
+    value: function fetchPalletList() {
+      var entries = this.api.metadata.latest.pallets.map(function (p) {
+        return {
+          name: p.name,
+          index: p.index,
+          hasExtrinsics: p.calls !== undefined
+        };
+      });
+      return Promise.resolve(entries);
+    }
+  }, {
+    key: "isEvmChain",
+    value: function isEvmChain() {
+      var _this$api$metadata$la, _path$includes;
+      var path = (_this$api$metadata$la = this.api.metadata.latest.types[0]) === null || _this$api$metadata$la === void 0 ? void 0 : _this$api$metadata$la.path;
+      return Promise.resolve((_path$includes = path === null || path === void 0 ? void 0 : path.includes("AccountId20")) !== null && _path$includes !== void 0 ? _path$includes : false);
+    }
   }, {
     key: "getFromRpc",
     value: function () {
@@ -1661,6 +1685,31 @@ var DedotApi = /*#__PURE__*/function (_PolkadotApi) {
       }
       return getBridgeStatus;
     }()
+  }, {
+    key: "getSystemProperties",
+    value: function () {
+      var _getSystemProperties = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee13() {
+        var props;
+        return _regenerator().w(function (_context13) {
+          while (1) switch (_context13.n) {
+            case 0:
+              _context13.n = 1;
+              return this.api.rpc.system_properties();
+            case 1:
+              props = _context13.v;
+              return _context13.a(2, {
+                ss58Format: typeof (props === null || props === void 0 ? void 0 : props.ss58Format) === "number" ? props.ss58Format : undefined,
+                tokenSymbol: [props === null || props === void 0 ? void 0 : props.tokenSymbol].flat()[0],
+                tokenDecimals: [props === null || props === void 0 ? void 0 : props.tokenDecimals].flat()[0]
+              });
+          }
+        }, _callee13, this);
+      }));
+      function getSystemProperties() {
+        return _getSystemProperties.apply(this, arguments);
+      }
+      return getSystemProperties;
+    }()
   }, {
     key: "disconnect",
     value: function disconnect() {
@@ -1678,7 +1727,7 @@ var DedotApi = /*#__PURE__*/function (_PolkadotApi) {
         if (force) {
           void this.api.disconnect();
         } else {
-          var key = api === undefined ? getChainProviders(this._chain) : api;
+          var key = api === undefined ? getChainProvidersImpl(this._chain, this._customCtx) : api;
           releaseClient(key);
         }
       }
@@ -1705,18 +1754,18 @@ var DedotApi = /*#__PURE__*/function (_PolkadotApi) {
   }, {
     key: "signAndSubmit",
     value: function () {
-      var _signAndSubmit = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee13(tx, sender) {
+      var _signAndSubmit = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee14(tx, sender) {
         var account;
-        return _regenerator().w(function (_context13) {
-          while (1) switch (_context13.n) {
+        return _regenerator().w(function (_context14) {
+          while (1) switch (_context14.n) {
             case 0:
               account = isSenderSigner(sender) ? sender : createKeyringPair(sender);
-              _context13.n = 1;
+              _context14.n = 1;
               return tx.signAndSend(account);
             case 1:
-              return _context13.a(2, _context13.v);
+              return _context14.a(2, _context14.v);
           }
-        }, _callee13);
+        }, _callee14);
       }));
       function signAndSubmit(_x25, _x26) {
         return _signAndSubmit.apply(this, arguments);
@@ -1726,19 +1775,19 @@ var DedotApi = /*#__PURE__*/function (_PolkadotApi) {
   }, {
     key: "signAndSubmitFinalized",
     value: function () {
-      var _signAndSubmitFinalized = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee14(tx, sender) {
+      var _signAndSubmitFinalized = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee15(tx, sender) {
         var account, result;
-        return _regenerator().w(function (_context14) {
-          while (1) switch (_context14.n) {
+        return _regenerator().w(function (_context15) {
+          while (1) switch (_context15.n) {
             case 0:
               account = isSenderSigner(sender) ? sender : createKeyringPair(sender);
-              _context14.n = 1;
+              _context15.n = 1;
               return tx.signAndSend(account).untilFinalized();
             case 1:
-              result = _context14.v;
-              return _context14.a(2, result.txHash);
+              result = _context15.v;
+              return _context15.a(2, result.txHash);
           }
-        }, _callee14);
+        }, _callee15);
       }));
       function signAndSubmitFinalized(_x27, _x28) {
         return _signAndSubmitFinalized.apply(this, arguments);
@@ -1810,13 +1859,13 @@ var convertSs58 = function convertSs58(address, chain) {
 };
 
 /**
- * Creates a new Builder instance using the Dedot client.
+ * Creates a new Builder instance.
  *
- * @param api - The API instance or options to use for building transactions.
+ * @param options - Either an existing API instance, a WS URL, or a config object.
  * @returns A new Builder instance.
  */
-var Builder = function Builder(api) {
-  var dedotApi = new DedotApi(api);
+var Builder = function Builder(options) {
+  var dedotApi = new DedotApi(options);
   return Builder$1(dedotApi);
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk-dedot",
-  "version": "13.5.0",
+  "version": "13.6.0",
   "description": "Dedot-based SDK for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -22,22 +22,22 @@
     "dist"
   ],
   "dependencies": {
-    "@paraspell/sdk-core": "13.5.0"
+    "@paraspell/sdk-core": "13.6.0"
   },
   "peerDependencies": {
     "dedot": ">= 1.3.0",
     "@polkadot/keyring": ">= 14"
   },
   "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",
     "@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",
     "tslib": "^2.8.1"
   },