@paraspell/sdk 8.12.1 → 8.13.0

package/README.md

@@ -91,8 +91,9 @@ const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .from(NODE)
       .to(NODE /*,customParaId - optional*/ | Multilocation object /*Only works for PolkadotXCM pallet*/) 
       .currency({id: currencyID, amount: amount} | {symbol: currencySymbol, amount: amount} | {symbol: Native('currencySymbol'), amount: amount} | {symbol: Foreign('currencySymbol'), amount: amount} | {symbol: ForeignAbstract('currencySymbol'), amount: amount} | {multilocation: AssetMultilocationString, amount: amount | AssetMultilocationJson, amount: amount} | {multilocation: Override('Custom Multilocation'), amount: amount} | {multiasset: {currencySelection, isFeeAsset?: true /* for example symbol: symbol or id: id, or multilocation: multilocation*/, amount: amount}})
-      .address(address | Multilocation object /*If you are sending through xTokens, you need to pass the destination and address multilocation in one object (x2)*/, /*senderAddress - OPTIONAL - used when origin is AssetHub and feeAsset parameter is provided*/)
-      /*.feeAsset({symbol: 'symbol'} || {id: 'id'} || {multilocation: 'multilocation'}) // Optional parameter used when multiasset is provided or when origin is AssetHub - so user can pay in fees different than DOT
+      .address(address | Multilocation object /*If you are sending through xTokens, you need to pass the destination and address multilocation in one object (x2)*/)
+      /*.senderAddress(address) - OPTIONAL - used when origin is AssetHub and feeAsset parameter is provided
+        .feeAsset({symbol: 'symbol'} || {id: 'id'} || {multilocation: 'multilocation'}) // Optional parameter used when multiasset is provided or when origin is AssetHub - so user can pay in fees different than DOT
         .xcmVersion(Version.V1/V2/V3/V4)  //Optional parameter for manual override of XCM Version used in call
         .customPallet('Pallet','pallet_function') //Optional parameter for manual override of XCM Pallet and function used in call (If they are named differently on some node but syntax stays the same). Both pallet name and function required. Pallet name must be CamelCase, function name snake_case.*/
 
@@ -216,10 +217,8 @@ const result = await Builder(API /*optional*/)
         .to(NODE_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} | {multilocation: AssetMultilocationString, amount: amount | AssetMultilocationJson, amount: amount} | {multilocation: Override('Custom Multilocation'), amount: amount} | {multiasset: {currencySelection, isFeeAsset?: true /* for example symbol: symbol or id: id, or multilocation: multilocation*/, amount: amount}})
         .address(ADDRESS)
-        .dryRun(SENDER_ADDRESS)
-
-//Function pattern
-await getDryRun({api /*optional*/,  node, address /*sender address*/, tx /* Extrinsic object */})
+        .senderAddress(SENDER_ADDRESS)
+        .dryRun()
 
 //Check Parachain for DryRun support - returns true/false
 import { hasDryRunSupport } from "@paraspell/sdk-pjs";
@@ -242,7 +241,8 @@ const fee = await Builder(/*node api/ws_url_string/ws_url_array - optional*/)
           .from(ORIGIN_CHAIN)
           .to(DESTINATION_CHAIN)
           .currency(CURRENCY)
-          .address(RECIPIENT_ADDRESS, SENDER_ADDRESS) // Both sender and recipient addresses are required!
+          .address(RECIPIENT_ADDRESS)
+          .senderAddress(SENDER_ADDRESS)
           .getXcmFee({disableFallback: true / false})  //When fallback is disabled, you only get notified of DryRun error, but no Payment info query fallback is performed. Payment info is still performed if Origin or Destination chain do not support DryRun out of the box.
 ```
 
@@ -258,7 +258,8 @@ const fee = await Builder(/*node api/ws_url_string/ws_url_array - optional*/)
           .from(ORIGIN_CHAIN)
           .to(DESTINATION_CHAIN)
           .currency(CURRENCY)
-          .address(RECIPIENT_ADDRESS, SENDER_ADDRESS) // Both sender and recipient addresses are required!
+          .address(RECIPIENT_ADDRESS)
+          .senderAddress(SENDER_ADDRESS) 
           .getXcmFeeEstimate()
 ```
 

package/dist/index.cjs

@@ -1612,7 +1612,8 @@ var EvmBuilder = function EvmBuilder() {
  * @returns An extrinsic to be signed and sent.
  */
 var send = createPapiApiCall(sdkCore.send);
-var getDryRun = createPapiApiCall(sdkCore.getDryRun);
+var dryRun = createPapiApiCall(sdkCore.dryRun);
+var dryRunOrigin = createPapiApiCall(sdkCore.dryRunOrigin);
 var getParaEthTransferFees = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee(ahApi) {
     var papiApi;
@@ -1660,8 +1661,9 @@ var getBridgeStatus = /*#__PURE__*/function () {
 
 var transfer = /*#__PURE__*/Object.freeze({
   __proto__: null,
+  dryRun: dryRun,
+  dryRunOrigin: dryRunOrigin,
   getBridgeStatus: getBridgeStatus,
-  getDryRun: getDryRun,
   getParaEthTransferFees: getParaEthTransferFees,
   send: send
 });
@@ -1671,11 +1673,12 @@ exports.EvmBuilder = EvmBuilder;
 exports.assets = assets;
 exports.claimAssets = claimAssets;
 exports.createApiInstanceForNode = createApiInstanceForNode;
+exports.dryRun = dryRun;
+exports.dryRunOrigin = dryRunOrigin;
 exports.getAssetBalance = getAssetBalance;
 exports.getBalanceForeign = getBalanceForeign;
 exports.getBalanceNative = getBalanceNative;
 exports.getBridgeStatus = getBridgeStatus;
-exports.getDryRun = getDryRun;
 exports.getMaxForeignTransferableAmount = getMaxForeignTransferableAmount;
 exports.getMaxNativeTransferableAmount = getMaxNativeTransferableAmount;
 exports.getOriginFeeDetails = getOriginFeeDetails;

package/dist/index.d.ts

@@ -204,23 +204,28 @@ declare const EvmBuilder: () => EvmBuilderCore<unknown, unknown, {
 declare const send: (options: _paraspell_sdk_core.TSendBaseOptions & {
     api?: TPapiApiOrUrl;
 }) => Promise<TPapiTransaction>;
-declare const getDryRun: (options: _paraspell_sdk_core.TDryRunCallBaseOptions<TPapiTransaction> & {
+declare const dryRun: (options: _paraspell_sdk_core.TDryRunBaseOptions<TPapiTransaction> & {
     api?: TPapiApiOrUrl;
 }) => Promise<_paraspell_sdk_core.TDryRunResult>;
+declare const dryRunOrigin: (options: _paraspell_sdk_core.TDryRunCallBaseOptions<TPapiTransaction> & {
+    api?: TPapiApiOrUrl;
+}) => Promise<_paraspell_sdk_core.TDryRunNodeResult>;
 declare const getParaEthTransferFees: (ahApi?: TPapiApiOrUrl) => Promise<[bigint, bigint]>;
 /**
  * Gets the Ethereum bridge status.
  */
 declare const getBridgeStatus: (ahApi?: TPapiApiOrUrl) => Promise<_paraspell_sdk_core.TBridgeStatus>;
 
+declare const transfer_dryRun: typeof dryRun;
+declare const transfer_dryRunOrigin: typeof dryRunOrigin;
 declare const transfer_getBridgeStatus: typeof getBridgeStatus;
-declare const transfer_getDryRun: typeof getDryRun;
 declare const transfer_getParaEthTransferFees: typeof getParaEthTransferFees;
 declare const transfer_send: typeof send;
 declare namespace transfer {
   export {
+    transfer_dryRun as dryRun,
+    transfer_dryRunOrigin as dryRunOrigin,
     transfer_getBridgeStatus as getBridgeStatus,
-    transfer_getDryRun as getDryRun,
     transfer_getParaEthTransferFees as getParaEthTransferFees,
     transfer_send as send,
   };
@@ -228,5 +233,5 @@ declare namespace transfer {
 
 declare const createApiInstanceForNode: (node: TNodeDotKsmWithRelayChains) => Promise<polkadot_api.PolkadotClient>;
 
-export { Builder, EvmBuilder, assets, claimAssets, createApiInstanceForNode, getAssetBalance, getBalanceForeign, getBalanceNative, getBridgeStatus, getDryRun, getMaxForeignTransferableAmount, getMaxNativeTransferableAmount, getOriginFeeDetails, getParaEthTransferFees, getTransferInfo, getTransferableAmount, send, verifyEdOnDestination, transfer as xcmPallet };
+export { Builder, EvmBuilder, assets, claimAssets, createApiInstanceForNode, dryRun, dryRunOrigin, getAssetBalance, getBalanceForeign, getBalanceNative, getBridgeStatus, getMaxForeignTransferableAmount, getMaxNativeTransferableAmount, getOriginFeeDetails, getParaEthTransferFees, getTransferInfo, getTransferableAmount, send, verifyEdOnDestination, transfer as xcmPallet };
 export type { GeneralBuilder, TEvmNodeFromPapi, TPapiApi, TPapiApiOrUrl, TPapiTransaction };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { BatchMode, createApiInstanceForNode as createApiInstanceForNode$1, NodeNotSupportedError, Parents, Version, getNode, isForeignAsset, computeFeeFromDryRun, getAssetsObject, getBalanceNative as getBalanceNative$1, getBalanceForeign as getBalanceForeign$1, getTransferInfo as getTransferInfo$1, getAssetBalance as getAssetBalance$1, claimAssets as claimAssets$1, getOriginFeeDetails as getOriginFeeDetails$1, getMaxNativeTransferableAmount as getMaxNativeTransferableAmount$1, getMaxForeignTransferableAmount as getMaxForeignTransferableAmount$1, getTransferableAmount as getTransferableAmount$1, verifyEdOnDestination as verifyEdOnDestination$1, Foreign, ForeignAbstract, Native, Override, findAsset, getAllAssetsSymbols, getAssetDecimals, getAssetId, getAssets, getExistentialDeposit, getNativeAssetSymbol, getNativeAssets, getOtherAssets, getRelayChainSymbol, getSupportedAssets, getTNode, hasSupportForAsset, isNodeEvm, transferMoonbeamEvm, validateAddress, transferMoonbeamToEth, Builder as Builder$1, getParaEthTransferFees as getParaEthTransferFees$1, getBridgeStatus as getBridgeStatus$1, send as send$1, getDryRun as getDryRun$1 } from '@paraspell/sdk-core';
+import { BatchMode, createApiInstanceForNode as createApiInstanceForNode$1, NodeNotSupportedError, Parents, Version, getNode, isForeignAsset, computeFeeFromDryRun, getAssetsObject, getBalanceNative as getBalanceNative$1, getBalanceForeign as getBalanceForeign$1, getTransferInfo as getTransferInfo$1, getAssetBalance as getAssetBalance$1, claimAssets as claimAssets$1, getOriginFeeDetails as getOriginFeeDetails$1, getMaxNativeTransferableAmount as getMaxNativeTransferableAmount$1, getMaxForeignTransferableAmount as getMaxForeignTransferableAmount$1, getTransferableAmount as getTransferableAmount$1, verifyEdOnDestination as verifyEdOnDestination$1, Foreign, ForeignAbstract, Native, Override, findAsset, getAllAssetsSymbols, getAssetDecimals, getAssetId, getAssets, getExistentialDeposit, getNativeAssetSymbol, getNativeAssets, getOtherAssets, getRelayChainSymbol, getSupportedAssets, getTNode, hasSupportForAsset, isNodeEvm, transferMoonbeamEvm, validateAddress, transferMoonbeamToEth, Builder as Builder$1, getParaEthTransferFees as getParaEthTransferFees$1, getBridgeStatus as getBridgeStatus$1, send as send$1, dryRun as dryRun$1, dryRunOrigin as dryRunOrigin$1 } from '@paraspell/sdk-core';
 export * from '@paraspell/sdk-core';
 import { blake2b } from '@noble/hashes/blake2b';
 import { bytesToHex } from '@noble/hashes/utils';
@@ -1611,7 +1611,8 @@ var EvmBuilder = function EvmBuilder() {
  * @returns An extrinsic to be signed and sent.
  */
 var send = createPapiApiCall(send$1);
-var getDryRun = createPapiApiCall(getDryRun$1);
+var dryRun = createPapiApiCall(dryRun$1);
+var dryRunOrigin = createPapiApiCall(dryRunOrigin$1);
 var getParaEthTransferFees = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee(ahApi) {
     var papiApi;
@@ -1659,10 +1660,11 @@ var getBridgeStatus = /*#__PURE__*/function () {
 
 var transfer = /*#__PURE__*/Object.freeze({
   __proto__: null,
+  dryRun: dryRun,
+  dryRunOrigin: dryRunOrigin,
   getBridgeStatus: getBridgeStatus,
-  getDryRun: getDryRun,
   getParaEthTransferFees: getParaEthTransferFees,
   send: send
 });
 
-export { Builder, EvmBuilder, assets, claimAssets, createApiInstanceForNode, getAssetBalance, getBalanceForeign, getBalanceNative, getBridgeStatus, getDryRun, getMaxForeignTransferableAmount, getMaxNativeTransferableAmount, getOriginFeeDetails, getParaEthTransferFees, getTransferInfo, getTransferableAmount, send, verifyEdOnDestination, transfer as xcmPallet };
+export { Builder, EvmBuilder, assets, claimAssets, createApiInstanceForNode, dryRun, dryRunOrigin, getAssetBalance, getBalanceForeign, getBalanceNative, getBridgeStatus, getMaxForeignTransferableAmount, getMaxNativeTransferableAmount, getOriginFeeDetails, getParaEthTransferFees, getTransferInfo, getTransferableAmount, send, verifyEdOnDestination, transfer as xcmPallet };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk",
-  "version": "8.12.1",
+  "version": "8.13.0",
   "description": "SDK for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "ethers": "^6.13.7",
     "viem": "^2.28.1",
     "@noble/hashes": "^1.8.0",
-    "@paraspell/sdk-core": "8.12.1"
+    "@paraspell/sdk-core": "8.13.0"
   },
   "peerDependencies": {
     "polkadot-api": ">= 1.10.0 < 2"