@paraspell/sdk-core 10.4.8 → 10.4.10

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as _paraspell_sdk_common from '@paraspell/sdk-common';
-import { Version, TMultiLocation, TNodeDotKsmWithRelayChains, TNodeWithRelayChains, TNodePolkadotKusama, TNode, TJunction, TEcosystemType, TJunctions } from '@paraspell/sdk-common';
+import { TMultiLocation, TNodeDotKsmWithRelayChains, TNodeWithRelayChains, Version, TNodePolkadotKusama, TNode, TJunction, TEcosystemType, TJunctions } from '@paraspell/sdk-common';
 export * from '@paraspell/sdk-common';
 import * as _paraspell_assets from '@paraspell/assets';
-import { TMultiAsset, TCurrencyInputWithAmount, TCurrencyInput, WithAmount, TAsset, TMultiAssetWithFee, TCurrencyCore, TAmount } from '@paraspell/assets';
+import { TCurrencyInputWithAmount, TCurrencyInput, WithAmount, TAsset, TMultiAsset, TMultiAssetWithFee, TCurrencyCore, TAmount } from '@paraspell/assets';
 export * from '@paraspell/assets';
 import { TPallet } from '@paraspell/pallets';
 export * from '@paraspell/pallets';
@@ -13,61 +13,14 @@ type WithApi<TBase, TApi, TRes> = TBase & {
 };
 type TApiOrUrl<TApi> = TApi | string | string[];
 
-type OneKey<K extends string, V = unknown> = {
-    [P in K]: Record<P, V> & Partial<Record<Exclude<K, P>, never>> extends infer O ? {
-        [Q in keyof O]: O[Q];
-    } : never;
-}[K];
-type TXcmVersioned<T> = OneKey<Version, T>;
-type TXcmForeignAsset = {
-    ForeignAsset: string | number | bigint | undefined;
-};
-type TForeignAssetId = {
-    ForeignAssetId: bigint | undefined;
-};
-type TForeignOrTokenAsset = TXcmForeignAsset | {
-    Token: string | undefined;
-};
-type TForeignOrNativeAsset = TXcmForeignAsset | 'Native';
-type TXcmAsset = {
-    XCM: number | undefined;
-} | {
-    Native: null;
-};
-type TMantaAsset = {
-    MantaCurrency: bigint | undefined;
-};
-type TNativeTokenAsset = 'NativeToken';
-type TNodleAsset = 'NodleNative';
-type TZeitgeistAsset = 'Ztg';
-type TOtherReserveAsset = {
-    OtherReserve: string | bigint | undefined;
-};
-type TSelfReserveAsset = 'SelfReserve';
-type TReserveAsset = TOtherReserveAsset | TSelfReserveAsset;
-type TBifrostToken = {
-    Native: string;
-} | {
-    VToken: string;
-} | {
-    Token: string;
-} | {
-    VSToken2: number;
-} | {
-    VToken2: number;
-} | {
-    Token2: number;
-};
-type TXTokensCurrencySelection = TXcmVersioned<TMultiLocation | TMultiAsset | TMultiAsset[]> | TXcmForeignAsset | TForeignAssetId | TForeignOrTokenAsset | TXcmAsset | TMantaAsset | TOtherReserveAsset | TBifrostToken | string | bigint | number | undefined;
-
 type TRelaychain = 'Polkadot' | 'Kusama';
 
 type TPolkadotXCMTransferOptions<TApi, TRes> = {
     api: IPolkadotApi<TApi, TRes>;
-    header: TXcmVersioned<TMultiLocation>;
-    addressSelection: TXcmVersioned<TMultiLocation>;
+    destLocation: TMultiLocation;
+    beneficiaryLocation: TMultiLocation;
     address: TAddress;
-    currencySelection: TXcmVersioned<TMultiAsset[]>;
+    multiAsset: TMultiAsset;
     overriddenAsset?: TMultiLocation | TMultiAssetWithFee[];
     scenario: TScenario;
     asset: WithAmount<TAsset>;
@@ -84,7 +37,7 @@ type TPolkadotXCMTransferOptions<TApi, TRes> = {
 type TXTokensTransferOptions<TApi, TRes> = {
     api: IPolkadotApi<TApi, TRes>;
     asset: WithAmount<TAsset>;
-    addressSelection: TXcmVersioned<TMultiLocation>;
+    destLocation: TMultiLocation;
     fees: number;
     scenario: TScenario;
     origin: TNodePolkadotKusama;
@@ -99,9 +52,10 @@ type TXTokensTransferOptions<TApi, TRes> = {
 type TXTransferTransferOptions<TApi, TRes> = {
     api: IPolkadotApi<TApi, TRes>;
     asset: WithAmount<TAsset>;
+    scenario: TScenario;
     recipientAddress: TAddress;
     origin: TNodePolkadotKusama;
-    paraId?: number;
+    paraIdTo?: number;
     destination: TDestination;
     overriddenAsset?: TMultiLocation | TMultiAsset[];
     pallet?: string;
@@ -515,6 +469,53 @@ type TNodeConfig = {
 };
 type TNodeConfigMap = Record<TNodeDotKsmWithRelayChains, TNodeConfig>;
 
+type OneKey<K extends string, V = unknown> = {
+    [P in K]: Record<P, V> & Partial<Record<Exclude<K, P>, never>> extends infer O ? {
+        [Q in keyof O]: O[Q];
+    } : never;
+}[K];
+type TXcmVersioned<T> = OneKey<Version, T>;
+type TXcmForeignAsset = {
+    ForeignAsset: string | number | bigint | undefined;
+};
+type TForeignAssetId = {
+    ForeignAssetId: bigint | undefined;
+};
+type TForeignOrTokenAsset = TXcmForeignAsset | {
+    Token: string | undefined;
+};
+type TForeignOrNativeAsset = TXcmForeignAsset | 'Native';
+type TXcmAsset = {
+    XCM: number | undefined;
+} | {
+    Native: null;
+};
+type TMantaAsset = {
+    MantaCurrency: bigint | undefined;
+};
+type TNativeTokenAsset = 'NativeToken';
+type TNodleAsset = 'NodleNative';
+type TZeitgeistAsset = 'Ztg';
+type TOtherReserveAsset = {
+    OtherReserve: string | bigint | undefined;
+};
+type TSelfReserveAsset = 'SelfReserve';
+type TReserveAsset = TOtherReserveAsset | TSelfReserveAsset;
+type TBifrostToken = {
+    Native: string;
+} | {
+    VToken: string;
+} | {
+    Token: string;
+} | {
+    VSToken2: number;
+} | {
+    VToken2: number;
+} | {
+    Token2: number;
+};
+type TXTokensCurrencySelection = TXcmVersioned<TMultiLocation | TMultiAsset | TMultiAsset[]> | TXcmForeignAsset | TForeignAssetId | TForeignOrTokenAsset | TXcmAsset | TMantaAsset | TOtherReserveAsset | TBifrostToken | string | bigint | number | undefined;
+
 type TDryRunBaseOptions<TRes> = {
     tx: TRes;
     origin: TNodeDotKsmWithRelayChains;
@@ -1223,8 +1224,7 @@ declare abstract class ParachainNode<TApi, TRes> {
     transfer(options: TSendInternalOptions<TApi, TRes>): Promise<TRes>;
     getRelayToParaOverrides(): TRelayToParaOverrides;
     transferRelayToPara(options: TRelayToParaOptions<TApi, TRes>): TSerializedApiCall;
-    createCurrencySpec(amount: TAmount, scenario: TScenario, version: Version, _asset?: TAsset, _isOverridenAsset?: boolean): TXcmVersioned<TMultiAsset[]>;
-    createVersionedDestination(scenario: TScenario, version: Version, destination: TDestination, paraId?: number): TXcmVersioned<TMultiLocation>;
+    createCurrencySpec(amount: TAmount, scenario: TScenario, version: Version, _asset?: TAsset, _isOverridenAsset?: boolean): TMultiAsset;
     getNativeAssetSymbol(): string;
     transferLocal(options: TSendInternalOptions<TApi, TRes>): TRes;
     transferLocalNativeAsset(options: TTransferLocalOptions<TApi, TRes>): TRes;
@@ -1266,47 +1266,23 @@ declare class AssetHubKusama<TApi, TRes> extends ParachainNode<TApi, TRes> imple
     constructor();
     transferPolkadotXCM<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     getRelayToParaOverrides(): TRelayToParaOverrides;
-    createCurrencySpec(amount: string, scenario: TScenario, version: Version, asset?: TAsset, isOverridenAsset?: boolean): {
-        V3: _paraspell_assets.TMultiAsset[];
-        V4?: undefined;
-        V5?: undefined;
-    } | {
-        V4: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V5?: undefined;
-    } | {
-        V5: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V4?: undefined;
-    };
+    createCurrencySpec(amount: string, scenario: TScenario, version: Version, asset?: TAsset, isOverridenAsset?: boolean): _paraspell_assets.TMultiAsset;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes>): TRes;
 }
 
 declare class AssetHubPolkadot<TApi, TRes> extends ParachainNode<TApi, TRes> implements IPolkadotXCMTransfer {
     constructor();
-    handleBridgeTransfer<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>, targetChain: 'Polkadot' | 'Kusama'): TRes;
+    handleBridgeTransfer<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>, targetChain: 'Polkadot' | 'Kusama'): Promise<TRes>;
     handleEthBridgeNativeTransfer<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     handleEthBridgeTransfer<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
-    handleMythosTransfer<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): TRes;
+    handleMythosTransfer<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     handleLocalReserveTransfer: <TApi_1, TRes_1>(input: TPolkadotXCMTransferOptions<TApi_1, TRes_1>, useDOTAsFeeAsset?: boolean) => TRes_1;
     patchInput<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): TPolkadotXCMTransferOptions<TApi, TRes>;
     private getMethod;
     private handleExecuteTransfer;
     transferPolkadotXCM<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     getRelayToParaOverrides(): TRelayToParaOverrides;
-    createCurrencySpec(amount: TAmount, scenario: TScenario, version: Version, asset?: TAsset, isOverriddenAsset?: boolean): {
-        V3: _paraspell_assets.TMultiAsset[];
-        V4?: undefined;
-        V5?: undefined;
-    } | {
-        V4: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V5?: undefined;
-    } | {
-        V5: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V4?: undefined;
-    };
+    createCurrencySpec(amount: TAmount, scenario: TScenario, version: Version, asset?: TAsset, isOverriddenAsset?: boolean): _paraspell_assets.TMultiAsset;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes>): TRes;
 }
 
@@ -1406,7 +1382,6 @@ declare class Collectives<TApi, TRes> extends ParachainNode<TApi, TRes> implemen
     constructor();
     transferPolkadotXCM<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     getRelayToParaOverrides(): TRelayToParaOverrides;
-    createCurrencySpec(amount: string, scenario: TScenario, version: Version, asset?: TAsset): TXcmVersioned<_paraspell_assets.TMultiAsset[]>;
 }
 
 declare class ComposableFinance<TApi, TRes> extends ParachainNode<TApi, TRes> implements IXTokensTransfer {
@@ -1430,19 +1405,7 @@ declare class Crab<TApi, TRes> extends ParachainNode<TApi, TRes> implements IPol
     constructor();
     transferPolkadotXCM<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     transferRelayToPara(): TSerializedApiCall;
-    createCurrencySpec(amount: string, scenario: TScenario, version: Version, _asset?: TAsset): {
-        V3: _paraspell_assets.TMultiAsset[];
-        V4?: undefined;
-        V5?: undefined;
-    } | {
-        V4: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V5?: undefined;
-    } | {
-        V5: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V4?: undefined;
-    };
+    createCurrencySpec(amount: string, scenario: TScenario, version: Version, _asset?: TAsset): _paraspell_assets.TMultiAsset;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes>): TRes;
 }
 
@@ -1468,19 +1431,7 @@ declare class Curio<TApi, TRes> extends ParachainNode<TApi, TRes> implements IXT
 declare class Darwinia<TApi, TRes> extends ParachainNode<TApi, TRes> implements IPolkadotXCMTransfer {
     constructor();
     transferPolkadotXCM<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
-    createCurrencySpec(amount: string, scenario: TScenario, version: Version, _asset?: TAsset): {
-        V3: _paraspell_assets.TMultiAsset[];
-        V4?: undefined;
-        V5?: undefined;
-    } | {
-        V4: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V5?: undefined;
-    } | {
-        V5: _paraspell_assets.TMultiAsset[];
-        V3?: undefined;
-        V4?: undefined;
-    };
+    createCurrencySpec(amount: string, scenario: TScenario, version: Version, _asset?: TAsset): _paraspell_assets.TMultiAsset;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes>): TRes;
 }
 
@@ -1499,7 +1450,7 @@ declare class Hydration<TApi, TRes> extends ParachainNode<TApi, TRes> implements
     private static NATIVE_ASSET_ID;
     constructor();
     transferToAssetHub<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): TRes;
-    transferToPolimec<TApi, TRes>(options: TPolkadotXCMTransferOptions<TApi, TRes>): TRes;
+    transferToPolimec<TApi, TRes>(options: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     transferPolkadotXCM<TApi, TRes>(input: TPolkadotXCMTransferOptions<TApi, TRes>): Promise<TRes>;
     transferXTokens<TApi, TRes>(input: TXTokensTransferOptions<TApi, TRes>): TRes;
     protected canUseXTokens({ to: destination, asset }: TSendInternalOptions<TApi, TRes>): boolean;
@@ -1780,13 +1731,16 @@ declare const send: <TApi, TRes>(options: TSendOptions<TApi, TRes>) => Promise<T
 
 declare const transferRelayToPara: <TApi, TRes>(options: TRelayToParaOptions<TApi, TRes>) => Promise<TRes>;
 
+declare const addXcmVersionHeader: <T, V extends Version>(obj: T, version: V) => OneKey<V, T>;
+
+declare const assertToIsString: (to: TDestination, overrideMsg?: string) => asserts to is Exclude<TDestination, TMultiLocation>;
+declare const assertAddressIsString: (address: TAddress) => asserts address is Exclude<TAddress, TMultiLocation>;
+
 declare const createApiInstanceForNode: <TApi, TRes>(api: IPolkadotApi<TApi, TRes>, node: TNodeDotKsmWithRelayChains) => Promise<TApi>;
 
 declare const createBeneficiary: <TApi, TRes>(options: TCreateBeneficiaryOptions<TApi, TRes>) => _paraspell_sdk_common.TMultiLocation;
 declare const createVersionedBeneficiary: <TApi, TRes>(options: TCreateBeneficiaryOptions<TApi, TRes>) => OneKey<_paraspell_sdk_common.Version, _paraspell_sdk_common.TMultiLocation>;
 
-declare const createX1Payload: (version: Version, junction: TJunction) => TJunctions;
-
 declare const computeFeeFromDryRun: (dryRun: any, node: TNodeDotKsmWithRelayChains, executionFee: bigint, isFeeAsset?: boolean) => bigint;
 
 declare const computeFeeFromDryRunPjs: (dryRun: any, node: TNodeDotKsmWithRelayChains, executionFee: bigint) => bigint;
@@ -1805,6 +1759,8 @@ declare const getNode: <TApi, TRes, T extends keyof ReturnType<typeof nodes>>(no
 
 declare const createBeneficiaryMultiLocation: <TApi, TRes>({ api, scenario, pallet, recipientAddress, version, paraId }: TCreateBeneficiaryOptions<TApi, TRes>) => TMultiLocation;
 
+declare const createX1Payload: (version: Version, junction: TJunction) => TJunctions;
+
 declare const reverseTransformMultiLocation: (multiLocation: TMultiLocation) => TMultiLocation;
 
 /**
@@ -1828,5 +1784,5 @@ declare const validateAddress: (address: TAddress, node: TNodeWithRelayChains, i
  */
 declare const determineRelayChain: (node: TNodeWithRelayChains) => TRelaychain;
 
-export { AssetClaimBuilder, BatchMode, BridgeHaltedError, Builder, DRY_RUN_CLIENT_TIMEOUT_MS, DryRunFailedError, ETHEREUM_JUNCTION, ETH_CHAIN_ID, GeneralBuilder, IncompatibleNodesError, InvalidAddressError, InvalidParameterError, NoXCMSupportImplementedError, NodeNotSupportedError, PolkadotXcmError, ScenarioNotSupportedError, TX_CLIENT_TIMEOUT_MS, TransferToAhNotSupported, UnableToComputeError, XTokensError, blake2b256, blake2b512, claimAssets, computeFeeFromDryRun, computeFeeFromDryRunPjs, convertSs58, createApiInstanceForNode, createBeneficiary, createBeneficiaryMultiLocation, createVersionedBeneficiary, createX1Payload, deriveAccountId, determineRelayChain, dryRun, dryRunOrigin, encodeSs58, getAssetBalance, getAssetBalanceInternal, getBalanceForeign, getBalanceForeignInternal, getBalanceNative, getBalanceNativeInternal, getBridgeStatus, getFees, getNode, getNodeConfig, getNodeProviders, getOriginFeeDetails, getOriginFeeDetailsInternal, getOriginXcmFee, getOriginXcmFeeEstimate, getParaEthTransferFees, getParaId, getTNode, getTransferInfo, getTransferableAmount, getTransferableAmountInternal, getXcmFee, getXcmFeeEstimate, resolveModuleError, resolveParaId, reverseTransformMultiLocation, send, transferMoonbeamEvm, transferMoonbeamToEth, transferRelayToPara, transformMultiLocation, validateAddress, verifyEdOnDestination };
+export { AssetClaimBuilder, BatchMode, BridgeHaltedError, Builder, DRY_RUN_CLIENT_TIMEOUT_MS, DryRunFailedError, ETHEREUM_JUNCTION, ETH_CHAIN_ID, GeneralBuilder, IncompatibleNodesError, InvalidAddressError, InvalidParameterError, NoXCMSupportImplementedError, NodeNotSupportedError, PolkadotXcmError, ScenarioNotSupportedError, TX_CLIENT_TIMEOUT_MS, TransferToAhNotSupported, UnableToComputeError, XTokensError, addXcmVersionHeader, assertAddressIsString, assertToIsString, blake2b256, blake2b512, claimAssets, computeFeeFromDryRun, computeFeeFromDryRunPjs, convertSs58, createApiInstanceForNode, createBeneficiary, createBeneficiaryMultiLocation, createVersionedBeneficiary, createX1Payload, deriveAccountId, determineRelayChain, dryRun, dryRunOrigin, encodeSs58, getAssetBalance, getAssetBalanceInternal, getBalanceForeign, getBalanceForeignInternal, getBalanceNative, getBalanceNativeInternal, getBridgeStatus, getFees, getNode, getNodeConfig, getNodeProviders, getOriginFeeDetails, getOriginFeeDetailsInternal, getOriginXcmFee, getOriginXcmFeeEstimate, getParaEthTransferFees, getParaId, getTNode, getTransferInfo, getTransferableAmount, getTransferableAmountInternal, getXcmFee, getXcmFeeEstimate, resolveModuleError, resolveParaId, reverseTransformMultiLocation, send, transferMoonbeamEvm, transferMoonbeamToEth, transferRelayToPara, transformMultiLocation, validateAddress, verifyEdOnDestination };
 export type { IPolkadotApi, IPolkadotXCMTransfer, IXTokensTransfer, IXTransferTransfer, OneKey, TAddress, TApiOrUrl, TAssetClaimOptions, TAssetClaimOptionsBase, TBalanceResponse, TBatchOptions, TBifrostToken, TBridgeStatus, TCreateBeneficiaryOptions, TDestWeight, TDestination, TDryRunBaseOptions, TDryRunCallBaseOptions, TDryRunCallOptions, TDryRunChain, TDryRunNodeFailure, TDryRunNodeResult, TDryRunNodeResultInternal, TDryRunNodeSuccess, TDryRunOptions, TDryRunResult, TDryRunXcmBaseOptions, TDryRunXcmOptions, TEdJsonMap, TEvmBuilderOptions, TEvmBuilderOptionsBase, TEvmNodeFrom, TFeeType, TForeignAssetId, TForeignOrNativeAsset, TForeignOrTokenAsset, TGetAssetBalanceOptions, TGetAssetBalanceOptionsBase, TGetBalanceForeignOptions, TGetBalanceForeignOptionsBase, TGetBalanceNativeOptions, TGetBalanceNativeOptionsBase, TGetFeeForDestNodeBaseOptions, TGetFeeForDestNodeOptions, TGetMaxForeignTransferableAmountOptions, TGetMaxForeignTransferableAmountOptionsBase, TGetMaxNativeTransferableAmountOptions, TGetMaxNativeTransferableAmountOptionsBase, TGetOriginFeeDetailsOptions, TGetOriginFeeDetailsOptionsBase, TGetOriginXcmFeeBaseOptions, TGetOriginXcmFeeEstimateOptions, TGetOriginXcmFeeOptions, TGetReverseTxFeeOptions, TGetTransferInfoOptions, TGetTransferInfoOptionsBase, TGetTransferableAmountOptions, TGetTransferableAmountOptionsBase, TGetXcmFeeBaseOptions, TGetXcmFeeBuilderOptions, TGetXcmFeeEstimateDetail, TGetXcmFeeEstimateOptions, TGetXcmFeeEstimateResult, TGetXcmFeeOptions, TGetXcmFeeResult, THubKey, TMantaAsset, TModuleError, TNativeTokenAsset, TNodeConfig, TNodeConfigMap, TNodleAsset, TOriginFeeDetails, TOtherReserveAsset, TPolkadotXCMTransferOptions, TPolkadotXcmMethod, TProviderEntry, TRelayToParaDestination, TRelayToParaOptions, TRelayToParaOverrides, TRelaychain, TReserveAsset, TScenario, TSelfReserveAsset, TSendBaseOptions, TSendBaseOptionsWithSenderAddress, TSendInternalOptions, TSendOptions, TSerializeEthTransferOptions, TSerializedApiCall, TSerializedEthTransfer, TTransferInfo, TTransferLocalOptions, TVerifyEdOnDestinationOptions, TVerifyEdOnDestinationOptionsBase, TWeight, TXTokensCurrencySelection, TXTokensMethod, TXTokensTransferOptions, TXTransferMethod, TXTransferTransferOptions, TXcmAsset, TXcmFeeBase, TXcmFeeChain, TXcmFeeDetail, TXcmForeignAsset, TXcmPalletMethod, TXcmVersioned, TZeitgeistAsset, WithApi, WithRequiredSenderAddress };