@paraspell/sdk-pjs 13.4.1 → 13.6.0

package/README.md

@@ -173,6 +173,74 @@ 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()
+```
+
 #### Local transfers
 
 ```ts

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _paraspell_sdk_core from '@paraspell/sdk-core';
-import { WithApi, TChain, TCurrencyInputWithAmount, 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 { WithApi, TChain, TCurrencyInputWithAmount, 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 * as _polkadot_api from '@polkadot/api';
 import { ApiPromise } from '@polkadot/api';
@@ -171,14 +171,14 @@ declare class EvmBuilderCore<TApi, TRes, TSigner, T extends Partial<TPjsEvmBuild
 /**
  * Creates a new Builder instance.
  *
- * @param api - The API instance to use for building transactions. If not provided, a new instance will be created.
+ * @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<TPjsApi>>) => GeneralBuilder$1<_polkadot_api.ApiPromise, Extrinsic, TPjsSigner, object>;
-type GeneralBuilder<T extends Partial<TTransferBaseOptions<TPjsApi, Extrinsic, TPjsSigner>> = object> = GeneralBuilder$1<TPjsApi, Extrinsic, TPjsSigner, T>;
+declare const Builder: <const TOpts extends TBuilderOptions<TApiOrUrl<TPjsApi>>>(options?: TOpts) => GeneralBuilder$1<_polkadot_api.ApiPromise, Extrinsic, TPjsSigner, object, TCustomChainFrom<TOpts>>;
+type GeneralBuilder<T extends Partial<TTransferBaseOptions<TPjsApi, Extrinsic, TPjsSigner>> = object, TCustomChain extends string = never> = GeneralBuilder$1<TPjsApi, Extrinsic, TPjsSigner, T, TCustomChain>;
 /** @deprecated EvmBuilder is deprecated. Please use the Builder class instead. */
 declare const EvmBuilder: (provider?: AbstractProvider, api?: TBuilderOptions<TApiOrUrl<TPjsApi>>) => EvmBuilderCore<unknown, unknown, unknown, {
-    api: _paraspell_sdk_core.PolkadotApi<_polkadot_api.ApiPromise, Extrinsic, TPjsSigner>;
+    api: _paraspell_sdk_core.PolkadotApi<_polkadot_api.ApiPromise, Extrinsic, TPjsSigner, never>;
     provider: AbstractProvider | undefined;
 }>;
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { getNativeAssetSymbol, getOtherAssets, hasJunction, getJunctionValue, getEvmPrivateKeyHex, UnsupportedOperationError, createClientCache, MAX_CLIENTS, EXTENSION_MS, createClientPoolHelpers, BatchMode, isConfig, findNativeAssetInfoOrThrow, getChainProviders, isSenderSigner, PolkadotApi, findAssetInfoOrThrow, hasXcmPaymentApiSupport, resolveModuleError, getAssetsObject, RuntimeApiUnavailableError, wrapTxBypass, normalizeLocation, localizeLocation, createAssetId, addXcmVersionHeader, isAssetXcEqual, RELAY_LOCATION, getRelayChainOf, SubmitTransactionError, 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, assertHasId, getParaId, RoutingResolutionError, abstractDecimals, MissingParameterError, isOverrideLocationSpecifier, transferMoonbeamEvm, transferMoonbeamToEth, validateAddress as validateAddress$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 { getNativeAssetSymbol, getOtherAssets, hasJunction, getJunctionValue, getEvmPrivateKeyHex, UnsupportedOperationError, createClientCache, MAX_CLIENTS, EXTENSION_MS, createClientPoolHelpers, BatchMode, isConfig, findNativeAssetInfoOrThrow, getChainProvidersImpl, isSenderSigner, PolkadotApi, findAssetInfoOrThrow, hasXcmPaymentApiSupport, resolveModuleError, getAssetsObject, RuntimeApiUnavailableError, wrapTxBypass, normalizeLocation, localizeLocation, createAssetId, addXcmVersionHeader, isAssetXcEqual, RELAY_LOCATION, getRelayChainOf, SubmitTransactionError, 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, assertHasId, getParaId, RoutingResolutionError, abstractDecimals, MissingParameterError, isOverrideLocationSpecifier, transferMoonbeamEvm, transferMoonbeamToEth, validateAddress as validateAddress$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 { Keyring, WsProvider, ApiPromise } from '@polkadot/api';
 import { u8aConcat, compactToU8a, u8aEq, isHex, u8aToHex, hexToU8a, stringToU8a } from '@polkadot/util';
@@ -698,6 +698,33 @@ var PolkadotJsApi = /*#__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 _this2 = this;
+      var entries = this.api.runtimeMetadata.asLatest.pallets.map(function (p) {
+        var name = p.name.toString();
+        return {
+          name: name,
+          index: p.index.toNumber(),
+          hasExtrinsics: _this2.api.tx[lowercaseFirstLetter(name)] !== undefined
+        };
+      });
+      return Promise.resolve(entries);
+    }
+  }, {
+    key: "isEvmChain",
+    value: function isEvmChain() {
+      var _types$, _path$includes;
+      var types = this.api.runtimeMetadata.asLatest.lookup.types;
+      var path = (_types$ = types[0]) === null || _types$ === void 0 ? void 0 : _types$.type.path.toJSON();
+      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 () {
@@ -814,7 +841,7 @@ var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
     key: "getDryRunCall",
     value: function () {
       var _getDryRunCall = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0(options) {
-        var _this2 = this;
+        var _this3 = this;
         var tx, address, feeAsset, chain, destination, version, _options$useRootOrigi, useRootOrigin, bypassOptions, supportsDryRunApi, basePayload, resolvedTx, resolvedFeeAsset, performDryRunCall, findFailingEventInResult, getExecutionSuccessFromResult, extractFailureReasonFromResult, response, resultHuman, resultJson, isSuccess, failureErr, shouldRetryWithVersion, msg, _msg, forwardedXcms, actualWeight, weight, destParaId, overriddenWeight, xcmFee, _yield$this$getPaymen, executionFee, fee, _t, _t2, _t3, _t4;
         return _regenerator().w(function (_context0) {
           while (1) switch (_context0.p = _context0.n) {
@@ -858,13 +885,13 @@ var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
               resolvedFeeAsset = _context0.v;
               performDryRunCall = /*#__PURE__*/function () {
                 var _ref6 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9(includeVersion) {
-                  var _this2$api$call$dryRu;
+                  var _this3$api$call$dryRu;
                   var versionNum;
                   return _regenerator().w(function (_context9) {
                     while (1) switch (_context9.n) {
                       case 0:
                         versionNum = Number(version.charAt(1));
-                        return _context9.a(2, (_this2$api$call$dryRu = _this2.api.call.dryRunApi).dryRunCall.apply(_this2$api$call$dryRu, [basePayload, resolvedTx].concat(_toConsumableArray(includeVersion ? [versionNum] : []))));
+                        return _context9.a(2, (_this3$api$call$dryRu = _this3.api.call.dryRunApi).dryRunCall.apply(_this3$api$call$dryRu, [basePayload, resolvedTx].concat(_toConsumableArray(includeVersion ? [versionNum] : []))));
                     }
                   }, _callee9);
                 }));
@@ -1425,6 +1452,32 @@ var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
       }
       return getBridgeStatus;
     }()
+  }, {
+    key: "getSystemProperties",
+    value: function () {
+      var _getSystemProperties = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee15() {
+        var _props$ss58Format, _props$tokenSymbol, _props$tokenDecimals;
+        var props;
+        return _regenerator().w(function (_context15) {
+          while (1) switch (_context15.n) {
+            case 0:
+              _context15.n = 1;
+              return this.api.rpc.system.properties();
+            case 1:
+              props = _context15.v.toPrimitive();
+              return _context15.a(2, {
+                ss58Format: (_props$ss58Format = props.ss58Format) !== null && _props$ss58Format !== void 0 ? _props$ss58Format : undefined,
+                tokenSymbol: (_props$tokenSymbol = props.tokenSymbol) === null || _props$tokenSymbol === void 0 ? void 0 : _props$tokenSymbol[0],
+                tokenDecimals: (_props$tokenDecimals = props.tokenDecimals) === null || _props$tokenDecimals === void 0 ? void 0 : _props$tokenDecimals[0]
+              });
+          }
+        }, _callee15, this);
+      }));
+      function getSystemProperties() {
+        return _getSystemProperties.apply(this, arguments);
+      }
+      return getSystemProperties;
+    }()
   }, {
     key: "disconnect",
     value: function disconnect() {
@@ -1442,7 +1495,7 @@ var PolkadotJsApi = /*#__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);
         }
       }
@@ -1469,33 +1522,33 @@ var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
   }, {
     key: "signAndSubmit",
     value: function () {
-      var _signAndSubmit = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee15(tx, sender) {
+      var _signAndSubmit = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee16(tx, sender) {
         var hash, _t8;
-        return _regenerator().w(function (_context15) {
-          while (1) switch (_context15.n) {
+        return _regenerator().w(function (_context16) {
+          while (1) switch (_context16.n) {
             case 0:
               if (!isSenderSigner(sender)) {
-                _context15.n = 2;
+                _context16.n = 2;
                 break;
               }
-              _context15.n = 1;
+              _context16.n = 1;
               return tx.signAndSend(sender.address, {
                 signer: sender.signer
               });
             case 1:
-              _t8 = _context15.v;
-              _context15.n = 4;
+              _t8 = _context16.v;
+              _context16.n = 4;
               break;
             case 2:
-              _context15.n = 3;
+              _context16.n = 3;
               return tx.signAndSend(createKeyringPair(sender));
             case 3:
-              _t8 = _context15.v;
+              _t8 = _context16.v;
             case 4:
               hash = _t8;
-              return _context15.a(2, hash.toHex());
+              return _context16.a(2, hash.toHex());
           }
-        }, _callee15);
+        }, _callee16);
       }));
       function signAndSubmit(_x28, _x29) {
         return _signAndSubmit.apply(this, arguments);
@@ -1505,27 +1558,27 @@ var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
   }, {
     key: "signAndSubmitFinalized",
     value: function () {
-      var _signAndSubmitFinalized = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee16(tx, sender) {
-        var _this3 = this;
-        return _regenerator().w(function (_context16) {
-          while (1) switch (_context16.n) {
+      var _signAndSubmitFinalized = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee17(tx, sender) {
+        var _this4 = this;
+        return _regenerator().w(function (_context17) {
+          while (1) switch (_context17.n) {
             case 0:
               if (!isSenderSigner(sender)) {
-                _context16.n = 2;
+                _context17.n = 2;
                 break;
               }
-              _context16.n = 1;
+              _context17.n = 1;
               return tx.signAsync(sender.address, {
                 signer: sender.signer
               });
             case 1:
-              _context16.n = 3;
+              _context17.n = 3;
               break;
             case 2:
-              _context16.n = 3;
+              _context17.n = 3;
               return tx.signAsync(createKeyringPair(sender));
             case 3:
-              return _context16.a(2, new Promise(function (resolve, reject) {
+              return _context17.a(2, new Promise(function (resolve, reject) {
                 tx.send(function (_ref14) {
                   var status = _ref14.status,
                     dispatchError = _ref14.dispatchError,
@@ -1533,7 +1586,7 @@ var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
                   if (status.isFinalized) {
                     if (dispatchError !== undefined) {
                       if (dispatchError.isModule) {
-                        var decoded = _this3.api.registry.findMetaError(dispatchError.asModule);
+                        var decoded = _this4.api.registry.findMetaError(dispatchError.asModule);
                         var docs = decoded.docs,
                           name = decoded.name,
                           section = decoded.section;
@@ -1550,7 +1603,7 @@ var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
                 });
               }));
           }
-        }, _callee16);
+        }, _callee17);
       }));
       function signAndSubmitFinalized(_x30, _x31) {
         return _signAndSubmitFinalized.apply(this, arguments);
@@ -2019,11 +2072,11 @@ var EvmBuilder$1 = function EvmBuilder(api, provider) {
 /**
  * Creates a new Builder instance.
  *
- * @param api - The API instance to use for building transactions. If not provided, a new instance will be created.
+ * @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 pjsApi = new PolkadotJsApi(api);
+var Builder = function Builder(options) {
+  var pjsApi = new PolkadotJsApi(options);
   return Builder$1(pjsApi);
 };
 /** @deprecated EvmBuilder is deprecated. Please use the Builder class instead. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk-pjs",
-  "version": "13.4.1",
+  "version": "13.6.0",
   "description": "Polkadot.js based SDK for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -22,14 +22,14 @@
     "dist"
   ],
   "dependencies": {
-    "@snowbridge/api": "^1.0.13",
-    "@snowbridge/base-types": "^1.0.13",
-    "@snowbridge/contract-types": "^1.0.13",
-    "@snowbridge/provider-ethers": "^1.0.13",
-    "@snowbridge/registry": "^1.0.13",
+    "@snowbridge/api": "^1.1.6",
+    "@snowbridge/base-types": "^1.1.6",
+    "@snowbridge/contract-types": "^1.1.6",
+    "@snowbridge/provider-ethers": "^1.1.6",
+    "@snowbridge/registry": "^1.1.6",
     "ethers": "^6.16.0",
-    "viem": "^2.48.4",
-    "@paraspell/sdk-core": "13.4.1"
+    "viem": "^2.51.3",
+    "@paraspell/sdk-core": "13.6.0"
   },
   "peerDependencies": {
     "@polkadot/api": ">= 16.0 < 17",
@@ -39,16 +39,16 @@
     "@polkadot/util-crypto": ">= 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",
-    "axios": "^1.15.2",
+    "@vitest/coverage-v8": "^4.1.7",
+    "axios": "^1.16.1",
     "dotenv": "^17.4.2",
-    "rollup": "^4.60.2",
+    "rollup": "^4.60.4",
     "rollup-plugin-dts": "^6.4.1",
     "tslib": "^2.8.1"
   },