@paraspell/sdk-pjs 11.3.1 → 11.4.0

package/README.md

@@ -276,6 +276,21 @@ import { hasDryRunSupport } from "@paraspell/sdk";
 const result = hasDryRunSupport(chain)
 ```
 
+#### Dry run preview:
+More on this feature in [official documentation](https://paraspell.github.io/docs/sdk/xcmPallet.html#preview-your-call-results)
+
+```ts
+//Builder pattern
+const result = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/)
+        .from(CHAIN)
+        .to(CHAIN_2)
+        .currency({id: currencyID, amount: amount} | {symbol: currencySymbol, amount: amount} | {symbol: Native('currencySymbol'), amount: amount} | {symbol: Foreign('currencySymbol'), amount: amount} | {symbol: ForeignAbstract('currencySymbol'), amount: amount} | {location: AssetLocationString, amount: amount | AssetLocationJson, amount: amount} | {location: Override('Custom Location'), amount: amount} | {[{currencySelection, isFeeAsset?: true /* for example symbol: symbol or id: id, or Location: Location*/, amount: amount}]})
+        /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in same fee asset as selected currency.*/
+        .address(ADDRESS)
+        .senderAddress(SENDER_ADDRESS)
+        .dryRunPreview(/*{ mintFeeAssets: true } - false by default - Mints fee assets also, if user does not have enough to cover fees on origin.*/)
+```
+
 ### Localhost test setup
 
 SDK offers enhanced localhost support. You can pass an object containing overrides for all WS endpoints (Including hops) used in the test transfer. This allows for advanced localhost testing such as localhost dry-run or xcm-fee queries. More information about available options can be found in the [official documentation](https://paraspell.github.io/docs/sdk/xcmPallet.html#localhost-testing-setup).

package/dist/index.cjs

@@ -776,64 +776,158 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getDryRunCall",
     value: function () {
-      var _getDryRunCall = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee15(_ref4) {
-        var _this$api$call$dryRun, _feeAsset$symbol;
-        var tx, address, asset, feeAsset, chain, supportsDryRunApi, chainsRequiringVersionParam, needsVersionParam, DEFAULT_XCM_VERSION, response, result, resultJson, usedSymbol, usedAsset, isSuccess, moduleError, failureReason, executionFee, fee, actualWeight, weight, forwardedXcms, destParaId;
-        return _regenerator().w(function (_context15) {
-          while (1) switch (_context15.n) {
+      var _getDryRunCall = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee16(_ref4) {
+        var _feeAsset$symbol,
+          _this = this;
+        var tx, address, asset, feeAsset, chain, supportsDryRunApi, DEFAULT_XCM_VERSION, usedSymbol, usedAsset, performDryRunCall, getExecutionSuccessFromResult, extractFailureReasonFromResult, response, resultHuman, resultJson, isSuccess, failureReason, shouldRetryWithVersion, msg, _msg, executionFee, fee, actualWeight, weight, forwardedXcms, destParaId, _t, _t2;
+        return _regenerator().w(function (_context16) {
+          while (1) switch (_context16.p = _context16.n) {
             case 0:
               tx = _ref4.tx, address = _ref4.address, asset = _ref4.asset, feeAsset = _ref4.feeAsset, chain = _ref4.chain;
               supportsDryRunApi = sdkCore.getAssetsObject(chain).supportsDryRunApi;
               if (supportsDryRunApi) {
-                _context15.n = 1;
+                _context16.n = 1;
                 break;
               }
               throw new sdkCore.ChainNotSupportedError("DryRunApi is not available on chain ".concat(chain));
             case 1:
-              chainsRequiringVersionParam = ['BifrostPolkadot', 'BifrostKusama', 'AssetHubKusama', 'AssetHubPolkadot', 'Kusama', 'Polkadot', 'Polimec', 'Astar'];
-              needsVersionParam = chainsRequiringVersionParam.includes(chain);
               DEFAULT_XCM_VERSION = 3;
-              _context15.n = 2;
-              return (_this$api$call$dryRun = this.api.call.dryRunApi).dryRunCall.apply(_this$api$call$dryRun, [{
-                system: {
-                  Signed: address
-                }
-              }, tx].concat(_toConsumableArray(needsVersionParam ? [DEFAULT_XCM_VERSION] : [])));
-            case 2:
-              response = _context15.v;
-              result = response.toHuman();
-              resultJson = response.toJSON();
               usedSymbol = (_feeAsset$symbol = feeAsset === null || feeAsset === void 0 ? void 0 : feeAsset.symbol) !== null && _feeAsset$symbol !== void 0 ? _feeAsset$symbol : asset === null || asset === void 0 ? void 0 : asset.symbol;
               usedAsset = feeAsset !== null && feeAsset !== void 0 ? feeAsset : asset;
-              isSuccess = result.Ok && result.Ok.executionResult.Ok;
-              if (isSuccess) {
-                _context15.n = 3;
+              performDryRunCall = /*#__PURE__*/function () {
+                var _ref5 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee15(includeVersion) {
+                  var _this$api$call$dryRun;
+                  return _regenerator().w(function (_context15) {
+                    while (1) switch (_context15.n) {
+                      case 0:
+                        return _context15.a(2, (_this$api$call$dryRun = _this.api.call.dryRunApi).dryRunCall.apply(_this$api$call$dryRun, [{
+                          system: {
+                            Signed: address
+                          }
+                        }, tx].concat(_toConsumableArray(includeVersion ? [DEFAULT_XCM_VERSION] : []))));
+                    }
+                  }, _callee15);
+                }));
+                return function performDryRunCall(_x31) {
+                  return _ref5.apply(this, arguments);
+                };
+              }();
+              getExecutionSuccessFromResult = function getExecutionSuccessFromResult(resultHuman) {
+                var _resultHuman$Ok$execu;
+                return Boolean((resultHuman === null || resultHuman === void 0 ? void 0 : resultHuman.Ok) && ((_resultHuman$Ok$execu = resultHuman.Ok.executionResult) === null || _resultHuman$Ok$execu === void 0 ? void 0 : _resultHuman$Ok$execu.Ok));
+              };
+              extractFailureReasonFromResult = function extractFailureReasonFromResult(resultHuman, resultJson) {
+                var _resultHuman$Ok, _resultHuman$Ok2, _resultJson$ok, _ref6;
+                var modErrHuman = resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok = resultHuman.Ok) === null || _resultHuman$Ok === void 0 || (_resultHuman$Ok = _resultHuman$Ok.executionResult) === null || _resultHuman$Ok === void 0 || (_resultHuman$Ok = _resultHuman$Ok.Err) === null || _resultHuman$Ok === void 0 || (_resultHuman$Ok = _resultHuman$Ok.error) === null || _resultHuman$Ok === void 0 ? void 0 : _resultHuman$Ok.Module;
+                if (modErrHuman) {
+                  return sdkCore.resolveModuleError(chain, modErrHuman);
+                }
+                var otherErrHuman = resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok2 = resultHuman.Ok) === null || _resultHuman$Ok2 === void 0 || (_resultHuman$Ok2 = _resultHuman$Ok2.executionResult) === null || _resultHuman$Ok2 === void 0 || (_resultHuman$Ok2 = _resultHuman$Ok2.Err) === null || _resultHuman$Ok2 === void 0 || (_resultHuman$Ok2 = _resultHuman$Ok2.error) === null || _resultHuman$Ok2 === void 0 ? void 0 : _resultHuman$Ok2.Other;
+                if (otherErrHuman) {
+                  return String(otherErrHuman);
+                }
+                var execErrJson = resultJson === null || resultJson === void 0 || (_resultJson$ok = resultJson.ok) === null || _resultJson$ok === void 0 || (_resultJson$ok = _resultJson$ok.executionResult) === null || _resultJson$ok === void 0 || (_resultJson$ok = _resultJson$ok.err) === null || _resultJson$ok === void 0 ? void 0 : _resultJson$ok.error;
+                if (execErrJson !== null && execErrJson !== void 0 && execErrJson.module) {
+                  return sdkCore.resolveModuleError(chain, execErrJson.module);
+                }
+                if (execErrJson !== null && execErrJson !== void 0 && execErrJson.other) {
+                  return String(execErrJson.other);
+                }
+                return JSON.stringify((_ref6 = resultJson !== null && resultJson !== void 0 ? resultJson : resultHuman) !== null && _ref6 !== void 0 ? _ref6 : 'Unknown error');
+              }; // Attempt 1: WITHOUT version
+              isSuccess = false;
+              failureReason = '';
+              shouldRetryWithVersion = false;
+              _context16.p = 2;
+              _context16.n = 3;
+              return performDryRunCall(false);
+            case 3:
+              response = _context16.v;
+              resultHuman = response.toHuman();
+              resultJson = response.toJSON();
+              isSuccess = getExecutionSuccessFromResult(resultHuman);
+              if (!isSuccess) {
+                failureReason = extractFailureReasonFromResult(resultHuman, resultJson);
+                if (failureReason === 'VersionedConversionFailed') {
+                  shouldRetryWithVersion = true;
+                }
+              }
+              _context16.n = 6;
+              break;
+            case 4:
+              _context16.p = 4;
+              _t = _context16.v;
+              msg = _t instanceof Error ? _t.message : String(_t);
+              if (!msg.includes('Expected 3 arguments')) {
+                _context16.n = 5;
                 break;
               }
-              moduleError = result.Ok.executionResult.Err.error.Module;
-              failureReason = sdkCore.resolveModuleError(chain, moduleError);
-              return _context15.a(2, {
+              shouldRetryWithVersion = true;
+              _context16.n = 6;
+              break;
+            case 5:
+              return _context16.a(2, {
+                success: false,
+                failureReason: msg,
+                currency: usedSymbol,
+                asset: usedAsset
+              });
+            case 6:
+              if (!shouldRetryWithVersion) {
+                _context16.n = 10;
+                break;
+              }
+              _context16.p = 7;
+              _context16.n = 8;
+              return performDryRunCall(true);
+            case 8:
+              response = _context16.v;
+              resultHuman = response.toHuman();
+              resultJson = response.toJSON();
+              isSuccess = getExecutionSuccessFromResult(resultHuman);
+              if (!isSuccess) {
+                failureReason = extractFailureReasonFromResult(resultHuman, resultJson);
+              }
+              _context16.n = 10;
+              break;
+            case 9:
+              _context16.p = 9;
+              _t2 = _context16.v;
+              _msg = _t2 instanceof Error ? _t2.message : String(_t2);
+              failureReason = failureReason || _msg;
+              return _context16.a(2, {
                 success: false,
                 failureReason: failureReason,
                 currency: usedSymbol,
                 asset: usedAsset
               });
-            case 3:
-              _context15.n = 4;
+            case 10:
+              if (isSuccess) {
+                _context16.n = 11;
+                break;
+              }
+              return _context16.a(2, {
+                success: false,
+                failureReason: failureReason || 'Unknown error',
+                currency: usedSymbol,
+                asset: usedAsset
+              });
+            case 11:
+              _context16.n = 12;
               return this.calculateTransactionFee(tx, address);
-            case 4:
-              executionFee = _context15.v;
-              fee = sdkCore.computeFeeFromDryRunPjs(result, chain, executionFee);
+            case 12:
+              executionFee = _context16.v;
+              fee = sdkCore.computeFeeFromDryRunPjs(resultHuman, chain, executionFee);
               actualWeight = resultJson.ok.executionResult.ok.actualWeight;
               weight = actualWeight ? {
                 refTime: BigInt(actualWeight.refTime),
                 proofSize: BigInt(actualWeight.proofSize)
               } : undefined;
               forwardedXcms = resultJson.ok.forwardedXcms.length > 0 ? resultJson.ok.forwardedXcms[0] : [];
-              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref5) {
-                return i.here === null ? 0 : (_ref5 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref5 === void 0 ? void 0 : _ref5.parachain;
+              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref7) {
+                return i.here === null ? 0 : (_ref7 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref7 === void 0 ? void 0 : _ref7.parachain;
               }(Object.values(forwardedXcms[0])[0].interior);
-              return _context15.a(2, {
+              return _context16.a(2, {
                 success: true,
                 fee: fee,
                 currency: usedSymbol,
@@ -843,7 +937,7 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                 destParaId: destParaId
               });
           }
-        }, _callee15, this);
+        }, _callee16, this, [[7, 9], [2, 4]]);
       }));
       function getDryRunCall(_x30) {
         return _getDryRunCall.apply(this, arguments);
@@ -853,27 +947,27 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getXcmPaymentApiFee",
     value: function () {
-      var _getXcmPaymentApiFee = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee16(chain, xcm, asset) {
+      var _getXcmPaymentApiFee = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee17(chain, xcm, asset) {
         var weight, localizedLocation, feeResult, res;
-        return _regenerator().w(function (_context16) {
-          while (1) switch (_context16.n) {
+        return _regenerator().w(function (_context17) {
+          while (1) switch (_context17.n) {
             case 0:
-              _context16.n = 1;
+              _context17.n = 1;
               return this.getXcmWeight(xcm);
             case 1:
-              weight = _context16.v;
+              weight = _context17.v;
               sdkCore.assertHasLocation(asset);
               localizedLocation = chain === 'AssetHubPolkadot' || chain === 'AssetHubKusama' || sdkCore.isRelayChain(chain) ? sdkCore.localizeLocation(chain, asset.location) : asset.location;
-              _context16.n = 2;
+              _context17.n = 2;
               return this.api.call.xcmPaymentApi.queryWeightToAssetFee(weight, sdkCore.addXcmVersionHeader(localizedLocation, sdkCore.Version.V4));
             case 2:
-              feeResult = _context16.v;
+              feeResult = _context17.v;
               res = feeResult.toJSON();
-              return _context16.a(2, BigInt(res.ok));
+              return _context17.a(2, BigInt(res.ok));
           }
-        }, _callee16, this);
+        }, _callee17, this);
       }));
-      function getXcmPaymentApiFee(_x31, _x32, _x33) {
+      function getXcmPaymentApiFee(_x32, _x33, _x34) {
         return _getXcmPaymentApiFee.apply(this, arguments);
       }
       return getXcmPaymentApiFee;
@@ -881,21 +975,21 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getXcmWeight",
     value: function () {
-      var _getXcmWeight = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee17(xcm) {
+      var _getXcmWeight = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee18(xcm) {
         var result, resultJson;
-        return _regenerator().w(function (_context17) {
-          while (1) switch (_context17.n) {
+        return _regenerator().w(function (_context18) {
+          while (1) switch (_context18.n) {
             case 0:
-              _context17.n = 1;
+              _context18.n = 1;
               return this.api.call.xcmPaymentApi.queryXcmWeight(xcm);
             case 1:
-              result = _context17.v;
+              result = _context18.v;
               resultJson = result.toJSON();
-              return _context17.a(2, resultJson.ok);
+              return _context18.a(2, resultJson.ok);
           }
-        }, _callee17, this);
+        }, _callee18, this);
       }));
-      function getXcmWeight(_x34) {
+      function getXcmWeight(_x35) {
         return _getXcmWeight.apply(this, arguments);
       }
       return getXcmWeight;
@@ -903,34 +997,34 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getDryRunXcm",
     value: function () {
-      var _getDryRunXcm = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee18(_ref6) {
-        var _ref7, _ref8, _ref9;
+      var _getDryRunXcm = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee19(_ref8) {
+        var _ref9, _ref0, _ref1;
         var originLocation, xcm, asset, chain, origin, supportsDryRunApi, response, result, resultJson, symbol, isSuccess, failureReason, emitted, reversedEvents, palletsWithIssued, feeEvent, feeAmount, fee, actualWeight, weight, forwardedXcms, destParaId;
-        return _regenerator().w(function (_context18) {
-          while (1) switch (_context18.n) {
+        return _regenerator().w(function (_context19) {
+          while (1) switch (_context19.n) {
             case 0:
-              originLocation = _ref6.originLocation, xcm = _ref6.xcm, asset = _ref6.asset, chain = _ref6.chain, origin = _ref6.origin;
+              originLocation = _ref8.originLocation, xcm = _ref8.xcm, asset = _ref8.asset, chain = _ref8.chain, origin = _ref8.origin;
               supportsDryRunApi = sdkCore.getAssetsObject(chain).supportsDryRunApi;
               if (supportsDryRunApi) {
-                _context18.n = 1;
+                _context19.n = 1;
                 break;
               }
               throw new sdkCore.ChainNotSupportedError("DryRunApi is not available on chain ".concat(chain));
             case 1:
-              _context18.n = 2;
+              _context19.n = 2;
               return this.api.call.dryRunApi.dryRunXcm(originLocation, xcm);
             case 2:
-              response = _context18.v;
+              response = _context19.v;
               result = response.toHuman();
               resultJson = response.toJSON();
               symbol = asset.symbol;
               isSuccess = result.Ok && result.Ok.executionResult.Complete;
               if (isSuccess) {
-                _context18.n = 3;
+                _context19.n = 3;
                 break;
               }
               failureReason = result.Ok.executionResult.Incomplete.error;
-              return _context18.a(2, {
+              return _context19.a(2, {
                 success: false,
                 failureReason: failureReason,
                 currency: symbol,
@@ -940,24 +1034,24 @@ var PolkadotJsApi = /*#__PURE__*/function () {
               emitted = result.Ok.emittedEvents; // We want to look for the last event
               reversedEvents = _toConsumableArray(emitted).reverse();
               palletsWithIssued = ['balances', 'foreignAssets', 'assets'];
-              feeEvent = (_ref7 = (_ref8 = (_ref9 = origin === 'Mythos' ? reversedEvents.find(function (event) {
+              feeEvent = (_ref9 = (_ref0 = (_ref1 = origin === 'Mythos' ? reversedEvents.find(function (event) {
                 return event.section === 'assetConversion' && event.method === 'SwapCreditExecuted';
-              }) : undefined) !== null && _ref9 !== void 0 ? _ref9 :
+              }) : undefined) !== null && _ref1 !== void 0 ? _ref1 :
               // Prefer an Issued event
               reversedEvents.find(function (event) {
                 return palletsWithIssued.includes(event.section) && event.method === 'Issued';
-              })) !== null && _ref8 !== void 0 ? _ref8 :
+              })) !== null && _ref0 !== void 0 ? _ref0 :
               // Fallback to Minted event
               reversedEvents.find(function (event) {
                 return ['balances', 'foreignAssets'].includes(event.section) && event.method === 'Minted';
-              })) !== null && _ref7 !== void 0 ? _ref7 : reversedEvents.find(function (event) {
+              })) !== null && _ref9 !== void 0 ? _ref9 : reversedEvents.find(function (event) {
                 return ['currencies', 'tokens'].includes(event.section) && event.method === 'Deposited';
               });
               if (feeEvent) {
-                _context18.n = 4;
+                _context19.n = 4;
                 break;
               }
-              return _context18.a(2, Promise.resolve({
+              return _context19.a(2, Promise.resolve({
                 success: false,
                 failureReason: 'Cannot determine destination fee. No Issued event found',
                 currency: symbol,
@@ -972,10 +1066,10 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                 proofSize: BigInt(actualWeight.proofSize)
               } : undefined;
               forwardedXcms = resultJson.ok.forwardedXcms.length > 0 ? resultJson.ok.forwardedXcms[0] : [];
-              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref0) {
-                return i.Here ? 0 : (_ref0 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref0 === void 0 ? void 0 : _ref0.parachain;
+              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref10) {
+                return i.Here ? 0 : (_ref10 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref10 === void 0 ? void 0 : _ref10.parachain;
               }(Object.values(forwardedXcms[0])[0].interior);
-              return _context18.a(2, {
+              return _context19.a(2, {
                 success: true,
                 fee: fee,
                 currency: symbol,
@@ -985,9 +1079,9 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                 destParaId: destParaId
               });
           }
-        }, _callee18, this);
+        }, _callee19, this);
       }));
-      function getDryRunXcm(_x35) {
+      function getDryRunXcm(_x36) {
         return _getDryRunXcm.apply(this, arguments);
       }
       return getDryRunXcm;
@@ -995,18 +1089,18 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getBridgeStatus",
     value: function () {
-      var _getBridgeStatus = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee19() {
+      var _getBridgeStatus = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee20() {
         var outboundOperatingMode;
-        return _regenerator().w(function (_context19) {
-          while (1) switch (_context19.n) {
+        return _regenerator().w(function (_context20) {
+          while (1) switch (_context20.n) {
             case 0:
-              _context19.n = 1;
+              _context20.n = 1;
               return this.api.query.ethereumOutboundQueue.operatingMode();
             case 1:
-              outboundOperatingMode = _context19.v;
-              return _context19.a(2, outboundOperatingMode.toPrimitive());
+              outboundOperatingMode = _context20.v;
+              return _context20.a(2, outboundOperatingMode.toPrimitive());
           }
-        }, _callee19, this);
+        }, _callee20, this);
       }));
       function getBridgeStatus() {
         return _getBridgeStatus.apply(this, arguments);
@@ -1026,38 +1120,38 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "disconnect",
     value: function () {
-      var _disconnect = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee20() {
+      var _disconnect = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee21() {
         var _this$_config$apiOver2;
         var force,
           api,
-          _args20 = arguments;
-        return _regenerator().w(function (_context20) {
-          while (1) switch (_context20.n) {
+          _args21 = arguments;
+        return _regenerator().w(function (_context21) {
+          while (1) switch (_context21.n) {
             case 0:
-              force = _args20.length > 0 && _args20[0] !== undefined ? _args20[0] : false;
+              force = _args21.length > 0 && _args21[0] !== undefined ? _args21[0] : false;
               if (this.initialized) {
-                _context20.n = 1;
+                _context21.n = 1;
                 break;
               }
-              return _context20.a(2, Promise.resolve());
+              return _context21.a(2, Promise.resolve());
             case 1:
               if (!(!force && !this.disconnectAllowed)) {
-                _context20.n = 2;
+                _context21.n = 2;
                 break;
               }
-              return _context20.a(2);
+              return _context21.a(2);
             case 2:
               api = sdkCore.isConfig(this._config) ? (_this$_config$apiOver2 = this._config.apiOverrides) === null || _this$_config$apiOver2 === void 0 ? void 0 : _this$_config$apiOver2[this._chain] : this._config; // Disconnect api only if it was created automatically
               if (!(force || typeof api === 'string' || api === undefined)) {
-                _context20.n = 3;
+                _context21.n = 3;
                 break;
               }
-              _context20.n = 3;
+              _context21.n = 3;
               return this.api.disconnect();
             case 3:
-              return _context20.a(2);
+              return _context21.a(2);
           }
-        }, _callee20, this);
+        }, _callee21, this);
       }));
       function disconnect() {
         return _disconnect.apply(this, arguments);

package/dist/index.d.ts

@@ -57,6 +57,8 @@ declare const getBalanceNative: (options: _paraspell_sdk_core.TGetBalanceNativeO
  * @returns The balance of the foreign asset as a bigint, or null if not found.
  */
 declare const getBalanceForeign: (options: _paraspell_sdk_core.TGetBalanceForeignOptionsBase & {
+    currency: _paraspell_sdk_core.TCurrencyCore;
+} & {
     api?: TPjsApiOrUrl;
 }) => Promise<bigint>;
 /**

package/dist/index.mjs

@@ -775,64 +775,158 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getDryRunCall",
     value: function () {
-      var _getDryRunCall = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee15(_ref4) {
-        var _this$api$call$dryRun, _feeAsset$symbol;
-        var tx, address, asset, feeAsset, chain, supportsDryRunApi, chainsRequiringVersionParam, needsVersionParam, DEFAULT_XCM_VERSION, response, result, resultJson, usedSymbol, usedAsset, isSuccess, moduleError, failureReason, executionFee, fee, actualWeight, weight, forwardedXcms, destParaId;
-        return _regenerator().w(function (_context15) {
-          while (1) switch (_context15.n) {
+      var _getDryRunCall = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee16(_ref4) {
+        var _feeAsset$symbol,
+          _this = this;
+        var tx, address, asset, feeAsset, chain, supportsDryRunApi, DEFAULT_XCM_VERSION, usedSymbol, usedAsset, performDryRunCall, getExecutionSuccessFromResult, extractFailureReasonFromResult, response, resultHuman, resultJson, isSuccess, failureReason, shouldRetryWithVersion, msg, _msg, executionFee, fee, actualWeight, weight, forwardedXcms, destParaId, _t, _t2;
+        return _regenerator().w(function (_context16) {
+          while (1) switch (_context16.p = _context16.n) {
             case 0:
               tx = _ref4.tx, address = _ref4.address, asset = _ref4.asset, feeAsset = _ref4.feeAsset, chain = _ref4.chain;
               supportsDryRunApi = getAssetsObject(chain).supportsDryRunApi;
               if (supportsDryRunApi) {
-                _context15.n = 1;
+                _context16.n = 1;
                 break;
               }
               throw new ChainNotSupportedError("DryRunApi is not available on chain ".concat(chain));
             case 1:
-              chainsRequiringVersionParam = ['BifrostPolkadot', 'BifrostKusama', 'AssetHubKusama', 'AssetHubPolkadot', 'Kusama', 'Polkadot', 'Polimec', 'Astar'];
-              needsVersionParam = chainsRequiringVersionParam.includes(chain);
               DEFAULT_XCM_VERSION = 3;
-              _context15.n = 2;
-              return (_this$api$call$dryRun = this.api.call.dryRunApi).dryRunCall.apply(_this$api$call$dryRun, [{
-                system: {
-                  Signed: address
-                }
-              }, tx].concat(_toConsumableArray(needsVersionParam ? [DEFAULT_XCM_VERSION] : [])));
-            case 2:
-              response = _context15.v;
-              result = response.toHuman();
-              resultJson = response.toJSON();
               usedSymbol = (_feeAsset$symbol = feeAsset === null || feeAsset === void 0 ? void 0 : feeAsset.symbol) !== null && _feeAsset$symbol !== void 0 ? _feeAsset$symbol : asset === null || asset === void 0 ? void 0 : asset.symbol;
               usedAsset = feeAsset !== null && feeAsset !== void 0 ? feeAsset : asset;
-              isSuccess = result.Ok && result.Ok.executionResult.Ok;
-              if (isSuccess) {
-                _context15.n = 3;
+              performDryRunCall = /*#__PURE__*/function () {
+                var _ref5 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee15(includeVersion) {
+                  var _this$api$call$dryRun;
+                  return _regenerator().w(function (_context15) {
+                    while (1) switch (_context15.n) {
+                      case 0:
+                        return _context15.a(2, (_this$api$call$dryRun = _this.api.call.dryRunApi).dryRunCall.apply(_this$api$call$dryRun, [{
+                          system: {
+                            Signed: address
+                          }
+                        }, tx].concat(_toConsumableArray(includeVersion ? [DEFAULT_XCM_VERSION] : []))));
+                    }
+                  }, _callee15);
+                }));
+                return function performDryRunCall(_x31) {
+                  return _ref5.apply(this, arguments);
+                };
+              }();
+              getExecutionSuccessFromResult = function getExecutionSuccessFromResult(resultHuman) {
+                var _resultHuman$Ok$execu;
+                return Boolean((resultHuman === null || resultHuman === void 0 ? void 0 : resultHuman.Ok) && ((_resultHuman$Ok$execu = resultHuman.Ok.executionResult) === null || _resultHuman$Ok$execu === void 0 ? void 0 : _resultHuman$Ok$execu.Ok));
+              };
+              extractFailureReasonFromResult = function extractFailureReasonFromResult(resultHuman, resultJson) {
+                var _resultHuman$Ok, _resultHuman$Ok2, _resultJson$ok, _ref6;
+                var modErrHuman = resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok = resultHuman.Ok) === null || _resultHuman$Ok === void 0 || (_resultHuman$Ok = _resultHuman$Ok.executionResult) === null || _resultHuman$Ok === void 0 || (_resultHuman$Ok = _resultHuman$Ok.Err) === null || _resultHuman$Ok === void 0 || (_resultHuman$Ok = _resultHuman$Ok.error) === null || _resultHuman$Ok === void 0 ? void 0 : _resultHuman$Ok.Module;
+                if (modErrHuman) {
+                  return resolveModuleError(chain, modErrHuman);
+                }
+                var otherErrHuman = resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok2 = resultHuman.Ok) === null || _resultHuman$Ok2 === void 0 || (_resultHuman$Ok2 = _resultHuman$Ok2.executionResult) === null || _resultHuman$Ok2 === void 0 || (_resultHuman$Ok2 = _resultHuman$Ok2.Err) === null || _resultHuman$Ok2 === void 0 || (_resultHuman$Ok2 = _resultHuman$Ok2.error) === null || _resultHuman$Ok2 === void 0 ? void 0 : _resultHuman$Ok2.Other;
+                if (otherErrHuman) {
+                  return String(otherErrHuman);
+                }
+                var execErrJson = resultJson === null || resultJson === void 0 || (_resultJson$ok = resultJson.ok) === null || _resultJson$ok === void 0 || (_resultJson$ok = _resultJson$ok.executionResult) === null || _resultJson$ok === void 0 || (_resultJson$ok = _resultJson$ok.err) === null || _resultJson$ok === void 0 ? void 0 : _resultJson$ok.error;
+                if (execErrJson !== null && execErrJson !== void 0 && execErrJson.module) {
+                  return resolveModuleError(chain, execErrJson.module);
+                }
+                if (execErrJson !== null && execErrJson !== void 0 && execErrJson.other) {
+                  return String(execErrJson.other);
+                }
+                return JSON.stringify((_ref6 = resultJson !== null && resultJson !== void 0 ? resultJson : resultHuman) !== null && _ref6 !== void 0 ? _ref6 : 'Unknown error');
+              }; // Attempt 1: WITHOUT version
+              isSuccess = false;
+              failureReason = '';
+              shouldRetryWithVersion = false;
+              _context16.p = 2;
+              _context16.n = 3;
+              return performDryRunCall(false);
+            case 3:
+              response = _context16.v;
+              resultHuman = response.toHuman();
+              resultJson = response.toJSON();
+              isSuccess = getExecutionSuccessFromResult(resultHuman);
+              if (!isSuccess) {
+                failureReason = extractFailureReasonFromResult(resultHuman, resultJson);
+                if (failureReason === 'VersionedConversionFailed') {
+                  shouldRetryWithVersion = true;
+                }
+              }
+              _context16.n = 6;
+              break;
+            case 4:
+              _context16.p = 4;
+              _t = _context16.v;
+              msg = _t instanceof Error ? _t.message : String(_t);
+              if (!msg.includes('Expected 3 arguments')) {
+                _context16.n = 5;
                 break;
               }
-              moduleError = result.Ok.executionResult.Err.error.Module;
-              failureReason = resolveModuleError(chain, moduleError);
-              return _context15.a(2, {
+              shouldRetryWithVersion = true;
+              _context16.n = 6;
+              break;
+            case 5:
+              return _context16.a(2, {
+                success: false,
+                failureReason: msg,
+                currency: usedSymbol,
+                asset: usedAsset
+              });
+            case 6:
+              if (!shouldRetryWithVersion) {
+                _context16.n = 10;
+                break;
+              }
+              _context16.p = 7;
+              _context16.n = 8;
+              return performDryRunCall(true);
+            case 8:
+              response = _context16.v;
+              resultHuman = response.toHuman();
+              resultJson = response.toJSON();
+              isSuccess = getExecutionSuccessFromResult(resultHuman);
+              if (!isSuccess) {
+                failureReason = extractFailureReasonFromResult(resultHuman, resultJson);
+              }
+              _context16.n = 10;
+              break;
+            case 9:
+              _context16.p = 9;
+              _t2 = _context16.v;
+              _msg = _t2 instanceof Error ? _t2.message : String(_t2);
+              failureReason = failureReason || _msg;
+              return _context16.a(2, {
                 success: false,
                 failureReason: failureReason,
                 currency: usedSymbol,
                 asset: usedAsset
               });
-            case 3:
-              _context15.n = 4;
+            case 10:
+              if (isSuccess) {
+                _context16.n = 11;
+                break;
+              }
+              return _context16.a(2, {
+                success: false,
+                failureReason: failureReason || 'Unknown error',
+                currency: usedSymbol,
+                asset: usedAsset
+              });
+            case 11:
+              _context16.n = 12;
               return this.calculateTransactionFee(tx, address);
-            case 4:
-              executionFee = _context15.v;
-              fee = computeFeeFromDryRunPjs(result, chain, executionFee);
+            case 12:
+              executionFee = _context16.v;
+              fee = computeFeeFromDryRunPjs(resultHuman, chain, executionFee);
               actualWeight = resultJson.ok.executionResult.ok.actualWeight;
               weight = actualWeight ? {
                 refTime: BigInt(actualWeight.refTime),
                 proofSize: BigInt(actualWeight.proofSize)
               } : undefined;
               forwardedXcms = resultJson.ok.forwardedXcms.length > 0 ? resultJson.ok.forwardedXcms[0] : [];
-              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref5) {
-                return i.here === null ? 0 : (_ref5 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref5 === void 0 ? void 0 : _ref5.parachain;
+              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref7) {
+                return i.here === null ? 0 : (_ref7 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref7 === void 0 ? void 0 : _ref7.parachain;
               }(Object.values(forwardedXcms[0])[0].interior);
-              return _context15.a(2, {
+              return _context16.a(2, {
                 success: true,
                 fee: fee,
                 currency: usedSymbol,
@@ -842,7 +936,7 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                 destParaId: destParaId
               });
           }
-        }, _callee15, this);
+        }, _callee16, this, [[7, 9], [2, 4]]);
       }));
       function getDryRunCall(_x30) {
         return _getDryRunCall.apply(this, arguments);
@@ -852,27 +946,27 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getXcmPaymentApiFee",
     value: function () {
-      var _getXcmPaymentApiFee = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee16(chain, xcm, asset) {
+      var _getXcmPaymentApiFee = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee17(chain, xcm, asset) {
         var weight, localizedLocation, feeResult, res;
-        return _regenerator().w(function (_context16) {
-          while (1) switch (_context16.n) {
+        return _regenerator().w(function (_context17) {
+          while (1) switch (_context17.n) {
             case 0:
-              _context16.n = 1;
+              _context17.n = 1;
               return this.getXcmWeight(xcm);
             case 1:
-              weight = _context16.v;
+              weight = _context17.v;
               assertHasLocation(asset);
               localizedLocation = chain === 'AssetHubPolkadot' || chain === 'AssetHubKusama' || isRelayChain(chain) ? localizeLocation(chain, asset.location) : asset.location;
-              _context16.n = 2;
+              _context17.n = 2;
               return this.api.call.xcmPaymentApi.queryWeightToAssetFee(weight, addXcmVersionHeader(localizedLocation, Version.V4));
             case 2:
-              feeResult = _context16.v;
+              feeResult = _context17.v;
               res = feeResult.toJSON();
-              return _context16.a(2, BigInt(res.ok));
+              return _context17.a(2, BigInt(res.ok));
           }
-        }, _callee16, this);
+        }, _callee17, this);
       }));
-      function getXcmPaymentApiFee(_x31, _x32, _x33) {
+      function getXcmPaymentApiFee(_x32, _x33, _x34) {
         return _getXcmPaymentApiFee.apply(this, arguments);
       }
       return getXcmPaymentApiFee;
@@ -880,21 +974,21 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getXcmWeight",
     value: function () {
-      var _getXcmWeight = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee17(xcm) {
+      var _getXcmWeight = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee18(xcm) {
         var result, resultJson;
-        return _regenerator().w(function (_context17) {
-          while (1) switch (_context17.n) {
+        return _regenerator().w(function (_context18) {
+          while (1) switch (_context18.n) {
             case 0:
-              _context17.n = 1;
+              _context18.n = 1;
               return this.api.call.xcmPaymentApi.queryXcmWeight(xcm);
             case 1:
-              result = _context17.v;
+              result = _context18.v;
               resultJson = result.toJSON();
-              return _context17.a(2, resultJson.ok);
+              return _context18.a(2, resultJson.ok);
           }
-        }, _callee17, this);
+        }, _callee18, this);
       }));
-      function getXcmWeight(_x34) {
+      function getXcmWeight(_x35) {
         return _getXcmWeight.apply(this, arguments);
       }
       return getXcmWeight;
@@ -902,34 +996,34 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getDryRunXcm",
     value: function () {
-      var _getDryRunXcm = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee18(_ref6) {
-        var _ref7, _ref8, _ref9;
+      var _getDryRunXcm = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee19(_ref8) {
+        var _ref9, _ref0, _ref1;
         var originLocation, xcm, asset, chain, origin, supportsDryRunApi, response, result, resultJson, symbol, isSuccess, failureReason, emitted, reversedEvents, palletsWithIssued, feeEvent, feeAmount, fee, actualWeight, weight, forwardedXcms, destParaId;
-        return _regenerator().w(function (_context18) {
-          while (1) switch (_context18.n) {
+        return _regenerator().w(function (_context19) {
+          while (1) switch (_context19.n) {
             case 0:
-              originLocation = _ref6.originLocation, xcm = _ref6.xcm, asset = _ref6.asset, chain = _ref6.chain, origin = _ref6.origin;
+              originLocation = _ref8.originLocation, xcm = _ref8.xcm, asset = _ref8.asset, chain = _ref8.chain, origin = _ref8.origin;
               supportsDryRunApi = getAssetsObject(chain).supportsDryRunApi;
               if (supportsDryRunApi) {
-                _context18.n = 1;
+                _context19.n = 1;
                 break;
               }
               throw new ChainNotSupportedError("DryRunApi is not available on chain ".concat(chain));
             case 1:
-              _context18.n = 2;
+              _context19.n = 2;
               return this.api.call.dryRunApi.dryRunXcm(originLocation, xcm);
             case 2:
-              response = _context18.v;
+              response = _context19.v;
               result = response.toHuman();
               resultJson = response.toJSON();
               symbol = asset.symbol;
               isSuccess = result.Ok && result.Ok.executionResult.Complete;
               if (isSuccess) {
-                _context18.n = 3;
+                _context19.n = 3;
                 break;
               }
               failureReason = result.Ok.executionResult.Incomplete.error;
-              return _context18.a(2, {
+              return _context19.a(2, {
                 success: false,
                 failureReason: failureReason,
                 currency: symbol,
@@ -939,24 +1033,24 @@ var PolkadotJsApi = /*#__PURE__*/function () {
               emitted = result.Ok.emittedEvents; // We want to look for the last event
               reversedEvents = _toConsumableArray(emitted).reverse();
               palletsWithIssued = ['balances', 'foreignAssets', 'assets'];
-              feeEvent = (_ref7 = (_ref8 = (_ref9 = origin === 'Mythos' ? reversedEvents.find(function (event) {
+              feeEvent = (_ref9 = (_ref0 = (_ref1 = origin === 'Mythos' ? reversedEvents.find(function (event) {
                 return event.section === 'assetConversion' && event.method === 'SwapCreditExecuted';
-              }) : undefined) !== null && _ref9 !== void 0 ? _ref9 :
+              }) : undefined) !== null && _ref1 !== void 0 ? _ref1 :
               // Prefer an Issued event
               reversedEvents.find(function (event) {
                 return palletsWithIssued.includes(event.section) && event.method === 'Issued';
-              })) !== null && _ref8 !== void 0 ? _ref8 :
+              })) !== null && _ref0 !== void 0 ? _ref0 :
               // Fallback to Minted event
               reversedEvents.find(function (event) {
                 return ['balances', 'foreignAssets'].includes(event.section) && event.method === 'Minted';
-              })) !== null && _ref7 !== void 0 ? _ref7 : reversedEvents.find(function (event) {
+              })) !== null && _ref9 !== void 0 ? _ref9 : reversedEvents.find(function (event) {
                 return ['currencies', 'tokens'].includes(event.section) && event.method === 'Deposited';
               });
               if (feeEvent) {
-                _context18.n = 4;
+                _context19.n = 4;
                 break;
               }
-              return _context18.a(2, Promise.resolve({
+              return _context19.a(2, Promise.resolve({
                 success: false,
                 failureReason: 'Cannot determine destination fee. No Issued event found',
                 currency: symbol,
@@ -971,10 +1065,10 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                 proofSize: BigInt(actualWeight.proofSize)
               } : undefined;
               forwardedXcms = resultJson.ok.forwardedXcms.length > 0 ? resultJson.ok.forwardedXcms[0] : [];
-              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref0) {
-                return i.Here ? 0 : (_ref0 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref0 === void 0 ? void 0 : _ref0.parachain;
+              destParaId = forwardedXcms.length === 0 ? undefined : function (i, _ref10) {
+                return i.Here ? 0 : (_ref10 = Array.isArray(i.x1) ? i.x1[0] : i.x1) === null || _ref10 === void 0 ? void 0 : _ref10.parachain;
               }(Object.values(forwardedXcms[0])[0].interior);
-              return _context18.a(2, {
+              return _context19.a(2, {
                 success: true,
                 fee: fee,
                 currency: symbol,
@@ -984,9 +1078,9 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                 destParaId: destParaId
               });
           }
-        }, _callee18, this);
+        }, _callee19, this);
       }));
-      function getDryRunXcm(_x35) {
+      function getDryRunXcm(_x36) {
         return _getDryRunXcm.apply(this, arguments);
       }
       return getDryRunXcm;
@@ -994,18 +1088,18 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "getBridgeStatus",
     value: function () {
-      var _getBridgeStatus = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee19() {
+      var _getBridgeStatus = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee20() {
         var outboundOperatingMode;
-        return _regenerator().w(function (_context19) {
-          while (1) switch (_context19.n) {
+        return _regenerator().w(function (_context20) {
+          while (1) switch (_context20.n) {
             case 0:
-              _context19.n = 1;
+              _context20.n = 1;
               return this.api.query.ethereumOutboundQueue.operatingMode();
             case 1:
-              outboundOperatingMode = _context19.v;
-              return _context19.a(2, outboundOperatingMode.toPrimitive());
+              outboundOperatingMode = _context20.v;
+              return _context20.a(2, outboundOperatingMode.toPrimitive());
           }
-        }, _callee19, this);
+        }, _callee20, this);
       }));
       function getBridgeStatus() {
         return _getBridgeStatus.apply(this, arguments);
@@ -1025,38 +1119,38 @@ var PolkadotJsApi = /*#__PURE__*/function () {
   }, {
     key: "disconnect",
     value: function () {
-      var _disconnect = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee20() {
+      var _disconnect = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee21() {
         var _this$_config$apiOver2;
         var force,
           api,
-          _args20 = arguments;
-        return _regenerator().w(function (_context20) {
-          while (1) switch (_context20.n) {
+          _args21 = arguments;
+        return _regenerator().w(function (_context21) {
+          while (1) switch (_context21.n) {
             case 0:
-              force = _args20.length > 0 && _args20[0] !== undefined ? _args20[0] : false;
+              force = _args21.length > 0 && _args21[0] !== undefined ? _args21[0] : false;
               if (this.initialized) {
-                _context20.n = 1;
+                _context21.n = 1;
                 break;
               }
-              return _context20.a(2, Promise.resolve());
+              return _context21.a(2, Promise.resolve());
             case 1:
               if (!(!force && !this.disconnectAllowed)) {
-                _context20.n = 2;
+                _context21.n = 2;
                 break;
               }
-              return _context20.a(2);
+              return _context21.a(2);
             case 2:
               api = isConfig(this._config) ? (_this$_config$apiOver2 = this._config.apiOverrides) === null || _this$_config$apiOver2 === void 0 ? void 0 : _this$_config$apiOver2[this._chain] : this._config; // Disconnect api only if it was created automatically
               if (!(force || typeof api === 'string' || api === undefined)) {
-                _context20.n = 3;
+                _context21.n = 3;
                 break;
               }
-              _context20.n = 3;
+              _context21.n = 3;
               return this.api.disconnect();
             case 3:
-              return _context20.a(2);
+              return _context21.a(2);
           }
-        }, _callee20, this);
+        }, _callee21, this);
       }));
       function disconnect() {
         return _disconnect.apply(this, arguments);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk-pjs",
-  "version": "11.3.1",
+  "version": "11.4.0",
   "description": "Polkadot.js based SDK for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
     "@snowbridge/contract-types": "0.2.0",
     "ethers": "^6.15.0",
     "viem": "^2.36.0",
-    "@paraspell/sdk-core": "11.3.1"
+    "@paraspell/sdk-core": "11.4.0"
   },
   "peerDependencies": {
     "@polkadot/api": ">= 16.0 < 17",