@paraspell/sdk-pjs 12.9.7 → 12.10.0-rc.1

package/README.md

@@ -44,7 +44,33 @@ npm install | pnpm add | yarn add @polkadot/api @polkadot/types @polkadot/api-ba
 npm install | pnpm add | yarn add @paraspell/sdk-pjs
 ```
 
-### Importing package to your project
+### Install Swap extension
+
+If you plan to [do Swap XCMs](https://paraspell.github.io/docs/sdk/xcmPallet.html#swap) you can install Swap package which allows you to do cross-chain swaps on popular Polkadot, Kusama, Paseo, Westend exchanges. Now available in all JS client versions of SDK.
+
+> [!IMPORTANT]
+> - ⚠️  **WebAssembly (Wasm) must be enabled in your project** because of the Hydration SDK (One of the exchanges implemented in XCM Router). Wasm can be enabled either through the web application configuration or through the appropriate plugin. 
+>
+> - ⚠️ Additionally, Hydration requires the use of the **augment package** (see: https://github.com/galacticcouncil/sdk/issues/114).
+
+```bash
+npm install | pnpm add | yarn add @paraspell/swap @galacticcouncil/api-augment
+```
+
+### Setup Swap extension
+
+Add the `@paraspell/swap` import to your application's root component (Usually `App.tsx`). This ensures the extension is registered before using Builder.
+
+```ts
+// Import swap extension here
+import '@paraspell/swap';
+
+export default function App() {
+  return {/* Your app here */};
+}
+```
+
+### Importing SDK functionality
 
 Named import:
 ```ts
@@ -61,13 +87,14 @@ import * as paraspell from '@paraspell/sdk-pjs'
 ## Implementation
 
 > [!NOTE]
-> - Brand new asset decimal abstraction introduced. It can be turned on in Builder config. Will be turned on by default in next major release.
-> - V11 > V12 Migration guide https://paraspell.github.io/docs/migration/v11-to-v12.html
-> 
-> **Latest news:**
-> - You can now pass signer directly into senderAddress parameter
+> - You can now pass signer directly into sender parameter
 > - The local transfers now have additional builder parameter called keepAlive
 > - Transact is here! Find out more: https://paraspell.github.io/docs/sdk/xcmPallet.html#transact
+> 
+> **Latest news:**
+> - V12 > V13 Migration guide: https://paraspell.github.io/docs/migration/v12-to-v13.html
+> - Swap package is now available on every XCM SDK version: https://paraspell.github.io/docs/sdk/getting-started.html#install-swap-extension
+> - abstractDecimals is now turned on by default!
 
 
 ### Sending XCM
@@ -80,15 +107,15 @@ const builder = Builder(/*chain api/builder_config/ws_url_string/ws_url_array -
       .from(TSubstrateChain)
       .to(TChain /*,customParaId - optional*/ | Location object /*Only works for PolkadotXCM pallet*/) 
       .currency({id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | {location: Override('Custom Location'), amount: amount /*Use "ALL" to transfer everything*/} | [{currencySelection /*for example symbol: symbol or id: id, or location: location*/, amount: amount /*Use "ALL" to transfer everything*/}, {currencySelection}, ..])
-      .address(address | Location object /*If you are sending through xTokens, you need to pass the destination and address Location in one object (x2)*/)
-      .senderAddress(address | {address, PJS_Signer}) // - OPTIONAL but strongly recommended as it is automatically ignored when not needed - Used when origin is AssetHub with feeAsset or when sending to AssetHub to prevent asset traps by auto-swapping to DOT to have DOT ED.
+      .recipient(address | Location object /*If you are sending through xTokens, you need to pass the destination and address Location in one object (x2)*/)
+      .sender(address | {address, PJS_Signer}) // - OPTIONAL but strongly recommended as it is automatically ignored when not needed - Used when origin is AssetHub with feeAsset or when sending to AssetHub to prevent asset traps by auto-swapping to DOT to have DOT ED.
       /*.ahAddress(ahAddress) - OPTIONAL - used when origin is EVM chain and XCM goes through AssetHub (Multihop transfer where we are unable to convert Key20 to ID32 address eg. origin: Moonbeam & destination: Ethereum (Multihop goes from Moonbeam > AssetHub > BridgeHub > Ethereum)
         .feeAsset({symbol: 'symbol'} || {id: 'id'} || {location: 'location'}) // Optional parameter used when multiasset is provided or when origin is AssetHub - so user can pay in fees different than DOT
         .xcmVersion(Version.V3/V4/V5)  //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 chain but syntax stays the same). Both pallet name and function required. Pallet name must be CamelCase, function name snake_case.*/
 
 const tx = await builder.build()
-// Or if you use signers in senderAddress:
+// Or if you use signers in sender:
 // await builder.signAndSubmit() - Signs and submits the transaction; returns TX hash for tracking
 
 //Make sure to disconnect the API after it is no longer used (eg, after a transaction)
@@ -101,9 +128,9 @@ const builder = Builder()
   .to('Polkadot')
   .currency({
     symbol: 'DOT',
-    amount: '1000000000'
+    amount: '1'
   })
-  .address(address)
+  .recipient(address)
 
 const tx = await builder.build()
 
@@ -119,7 +146,7 @@ const builder = Builder(/*chain api/builder_config/ws_url_string/ws_url_array -
       .from(TSubstrateChain)
       .to(TChain) //Has to be the same as the origin (from)
       .currency({id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | {location: Override('Custom Location'), amount: amount /*Use "ALL" to transfer everything*/} | [{currencySelection /*for example symbol: symbol or id: id, or location: location*/, amount: amount /*Use "ALL" to transfer everything*/}, {currencySelection}, ..])
-      .address(address)
+      .recipient(address)
    /* .keepAlive(bool) - Optional: Allows draining the account below the existential deposit. */
 
 
@@ -135,9 +162,9 @@ const builder = Builder()
   .to('Hydration')
   .currency({
     symbol: 'DOT',
-    amount: '1000000000'
+    amount: '1'
   })
-  .address(address)
+  .recipient(address)
 
 const tx = await builder.build()
 
@@ -153,18 +180,45 @@ const builder = Builder(/*client | builder_config | ws_url | [ws_url, ws_url,..]
       .from(TSubstrateChain) // 'AssetHubPolkadot' | 'Hydration' | 'Moonbeam' | 'Polkadot' |  ... https://paraspell.github.io/docs/sdk/AssetPallet.html#import-chains-as-types
       .to(TChain) // Has to be same as origin (from)
       .currency(CURRENCY_SPEC) // Refer to currency spec options below
-      .senderAddress(senderAddress | PAPI SIGNER)
-      .address(address)
+      .sender(sender | PAPI SIGNER)
+      .recipient(address)
       .transact(hex, /* originType, TWeight - Optional */)
 
 const tx = await builder.build()
-// Or if you use signers in senderAddress:
+// Or if you use signers in sender:
 // await builder.signAndSubmit() - Signs and submits the transaction; returns TX hash for tracking
 
 //Disconnect API after TX
 await builder.disconnect()
 ```
 
+#### Swap
+
+```ts
+const builder = Builder(/*client | builder_config |ws_url | [ws_url, ws_url,..] - Optional*/)
+      .from(TSubstrateChain) // 'AssetHubPolkadot' | 'Hydration' | 'Moonbeam' | 'Polkadot' |  ... https://paraspell.github.io/docs/sdk/AssetPallet.html#import-chains-as-types
+      .to(TChain /*,customParaId - optional*/ | Location object /*Only works for PolkadotXCM pallet*/) //'AssetHubPolkadot' | 'Hydration' | 'Moonbeam' | 'Polkadot' |  ... https://paraspell.github.io/docs/sdk/AssetPallet.html#import-chains-as-types
+      .currency({id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | {location: Override('Custom Location'), amount: amount /*Use "ALL" to transfer everything*/})
+      .recipient(address | Location object /*If you are sending through xTokens, you need to pass the destination and address location in one object (x2)*/)
+      .sender(address | PAPI_SIGNER /*Only in PAPI SDK*/ | {address, PJS_SIGNER} /*Only in PJS SDK*/) // - OPTIONAL but strongly recommended as it is automatically ignored when not needed - Used when origin is AssetHub/Hydration with feeAsset or when sending to AssetHub to prevent asset traps by auto-swapping to DOT to have DOT ED.
+      .swap({
+          currencyTo: {id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | {location: Override('Custom Location'), amount: amount /*Use "ALL" to transfer everything*/}
+          // exchange: ['AssetHubPolkadotDex'], - Optional parameter - 'HydrationDex' | 'AcalaDex' | 'AssetHubPolkadotDex' | ...
+          // slippage: 1, - Optional - 1 by default
+          // evmsender: '0x000', - Optional parameter when origin CHAIN is EVM based (Required with evmSigner)
+          // evmSigner: Signer, - Optional parameter when origin CHAIN is EVM based (Required with evmInjectorAddress)
+          // onStatusChange: (event) => void - Optional parameter for callback events when sender address is supplied as signer
+      })
+
+const tx = await builder.buildAll()
+// Or if you use signers in sender:
+// await builder.signAndSubmit() - Signs and submits the transaction (only working in 1click scenarios); returns TX hash for tracking
+// await builder.signAndSubmitAll() - Signs and submits transactions (required in 2click scenarios); returns array of TX hashes for tracking
+
+// Make sure to disconnect API after it is no longer used (eg. after transaction)
+await builder.disconnect()
+```
+
 #### Dry run your XCM Calls:
 ```ts
 //Builder pattern
@@ -173,8 +227,8 @@ const result = await Builder(/*chain api/builder_config/ws_url_string/ws_url_arr
         .to(TChain)
         .currency({id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | {location: Override('Custom Location'), amount: amount /*Use "ALL" to transfer everything*/} | {[{currencySelection, isFeeAsset?: true /* for example symbol: symbol or id: id, or Location: Location*/, amount: amount /*Use "ALL" to transfer everything*/}]})
         /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in same fee asset as selected currency.*/
-        .address(ADDRESS)
-        .senderAddress(address | {address, PJS_Signer})
+        .recipient(ADDRESS)
+        .sender(address | {address, PJS_Signer})
         .dryRun()
 
 //Check Parachain for DryRun support - returns true/false
@@ -191,8 +245,8 @@ const result = await Builder(/*chain api/builder_config/ws_url_string/ws_url_arr
         .to(TChain)
         .currency({id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | {location: Override('Custom Location'), amount: amount /*Use "ALL" to transfer everything*/} | {[{currencySelection, isFeeAsset?: true /* for example symbol: symbol or id: id, or Location: Location*/, amount: amount /*Use "ALL" to transfer everything*/}]})
         /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in same fee asset as selected currency.*/
-        .address(ADDRESS)
-        .senderAddress(address | {address, PJS_Signer})
+        .recipient(ADDRESS)
+        .sender(address | {address, PJS_Signer})
         .dryRunPreview(/*{ mintFeeAssets: true } - false by default - Mints fee assets also, if user does not have enough to cover fees on origin.*/)
 ```
 
@@ -203,13 +257,13 @@ const builder = Builder(/*chain api/builder_config/ws_url_string/ws_url_array -
       .from(TSubstrateChain) //Ensure, that origin chain is the same in all batched XCM Calls.
       .to(TChain2) //Any compatible Parachain
       .currency({currencySelection, amount}) //Currency to transfer - options as in scenarios above
-      .address(address | Location object)
+      .recipient(address | Location object)
       .addToBatch()
 
       .from(TSubstrateChain) //Ensure, that origin chain is the same in all batched XCM Calls.
       .to(TChain3) //Any compatible Parachain
       .currency({currencySelection, amount}) //Currency to transfer - options as in scenarios above
-      .address(address | Location object)
+      .recipient(address | Location object)
       .addToBatch()
       
 const tx = await builder.buildBatch({ 
@@ -229,7 +283,7 @@ const builder = Builder(/*chain api/builder_config/ws_url_string/ws_url_array -
       .claimfrom(TSubstrateChain)
       .currency({id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | [{currencySelection /*for example symbol: symbol or id: id, or location: location*/, amount: amount /*Use "ALL" to transfer everything*/}, {currencySelection}, ..]
 )
-      .address(address | Location object)
+      .recipient(address | Location object)
       /*.xcmVersion(Version.V3) Optional parameter, by default chain specific version. XCM Version ENUM if a different XCM version is needed (Supported V3 & V4 & V5). Requires importing Version enum.*/
 
 const tx = await builder.build()
@@ -253,11 +307,11 @@ const builder = await Builder({
   .from(TSubstrateChain)
   .to(TChain)
   .currency({id: currencyID, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: currencySymbol, amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Native('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: Foreign('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {symbol: ForeignAbstract('currencySymbol'), amount: amount /*Use "ALL" to transfer everything*/} | {location: AssetLocationString, amount: amount /*Use "ALL" to transfer everything*/ | AssetLocationJson, amount: amount /*Use "ALL" to transfer everything*/} | {location: Override('Custom Location'), amount: amount /*Use "ALL" to transfer everything*/} | [{currencySelection, isFeeAsset?: true /* for example symbol: symbol or id: id, or Location: Location*/, amount: amount /*Use "ALL" to transfer everything*/}])
-  .address(address) //You can also use prederived accounts - //Alice, //Bob... //Alith, //Balthathar...
-  .senderAddress(address | {address, PJS_Signer}) //You can also use prederived accounts //Alice, //Bob... //Alith, //Balthathar...
+  .recipient(address) //You can also use prederived accounts - //Alice, //Bob... //Alith, //Balthathar...
+  .sender(address | {address, PJS_Signer}) //You can also use prederived accounts //Alice, //Bob... //Alith, //Balthathar...
 
 const tx = await builder.build()
-//Or if you use prederived account as senderAddress:
+//Or if you use prederived account as sender:
 //await builder.signAndSubmit()
 
 //Disconnect API after TX
@@ -276,8 +330,8 @@ const fee = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array
           .to(TChain)
           .currency(CURRENCY_SPEC)
           /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in the same fee asset as selected currency.*/
-          .address(RECIPIENT_ADDRESS)
-          .senderAddress(address | {address, PJS_Signer})
+          .recipient(RECIPIENT_ADDRESS)
+          .sender(address | {address, PJS_Signer})
           .getXcmFee(/*{disableFallback: true / false}*/)  //Fallback is optional. When fallback is disabled, you only get notified of a 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.
 ```
 
@@ -289,8 +343,8 @@ const fee = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array
           .to(TChain)
           .currency(CURRENCY_SPEC)
           /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in the same fee asset as selected currency.*/
-          .address(RECIPIENT_ADDRESS)
-          .senderAddress(address | {address, PJS_Signer})
+          .recipient(RECIPIENT_ADDRESS)
+          .sender(address | {address, PJS_Signer})
           .getOriginXcmFee(/*{disableFallback: true / false}*/)  //Fallback is optional. When fallback is disabled, you only get notified of a DryRun error, but no Payment info query fallback is performed. Payment info is still performed if Origin do not support DryRun out of the box.
 ```
 
@@ -301,8 +355,8 @@ const info = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array
           .to(TChain)
           .currency(CURRENCY_SPEC)
           /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in the same fee asset as selected currency.*/
-          .address(RECIPIENT_ADDRESS)
-          .senderAddress(address | {address, PJS_Signer})
+          .recipient(RECIPIENT_ADDRESS)
+          .sender(address | {address, PJS_Signer})
           .getTransferInfo()
 ```
 
@@ -313,8 +367,8 @@ const transferable = await Builder(/*chain api/builder_config/ws_url_string/ws_u
           .to(TChain)
           .currency(CURRENCY_SPEC)
           /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in the same fee asset as selected currency.*/
-          .address(RECIPIENT_ADDRESS)
-          .senderAddress(address | {address, PJS_Signer})
+          .recipient(RECIPIENT_ADDRESS)
+          .sender(address | {address, PJS_Signer})
           .getTransferableAmount()
 ```
 
@@ -325,8 +379,8 @@ const transferable = await Builder(/*chain api/builder_config/ws_url_string/ws_u
           .to(TChain)
           .currency(CURRENCY_SPEC)
           /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in the same fee asset as selected currency.*/
-          .address(RECIPIENT_ADDRESS)
-          .senderAddress(address | {address, PJS_Signer})
+          .recipient(RECIPIENT_ADDRESS)
+          .sender(address | {address, PJS_Signer})
           .getMinTransferableAmount()
 ```
 
@@ -337,8 +391,8 @@ const receivable = await Builder(/*chain api/builder_config/ws_url_string/ws_url
           .to(TChain)
           .currency(CURRENCY_SPEC)
           /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in the same fee asset as selected currency.*/
-          .address(RECIPIENT_ADDRESS)
-          .senderAddress(address | {address, PJS_Signer})
+          .recipient(RECIPIENT_ADDRESS)
+          .sender(address | {address, PJS_Signer})
           .getReceivableAmount()
 ```
 
@@ -349,8 +403,8 @@ const ed = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array -
           .to(TChain)
           .currency(CURRENCY_SPEC)
           /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in the same fee asset as selected currency.*/
-          .address(RECIPIENT_ADDRESS)
-          .senderAddress(address | {address, PJS_Signer})
+          .recipient(RECIPIENT_ADDRESS)
+          .sender(address | {address, PJS_Signer})
           .verifyEdOnDestination()
 ```
 
@@ -390,7 +444,7 @@ let result = convertSs58(ADDRESS, TChain) // returns converted address in string
 For full documentation with output examples of asset queries, head over to [official documentation](https://paraspell.github.io/docs/sdk/AssetPallet.html).
 
 ```ts
-import { getSupportedDestinations, getFeeAssets, getAssetsObject, getAssetId, getRelayChainSymbol, getNativeAssets, getNativeAssets, getOtherAssets, getAllAssetsSymbols, hasSupportForAsset, getAssetDecimals, getParaId, getTChain, getAssetLocation, CHAINS, findAssetInfo, findAssetInfoOrThrow } from  '@paraspell/sdk-pjs'
+import { getSupportedDestinations, getFeeAssets, getAssetsObject, getRelayChainSymbol, getNativeAssets, getNativeAssets, getOtherAssets, getAllAssetsSymbols, getParaId, getTChain, getAssetLocation, CHAINS, findAssetInfo, findAssetInfoOrThrow } from  '@paraspell/sdk-pjs'
 
 //Get chains that support the specific asset related to origin
 getSupportedDestinations(TChain, CURRENCY)
@@ -413,9 +467,6 @@ getAssetLocation(TChain, { symbol: symbol } | { id: assetId })
 // Retrieve assets object from assets.json for a particular chain, including information about native and foreign assets
 getAssetsObject(TChain)
 
-// Retrieve foreign assetId for a particular chain and asset symbol
-getAssetId(TChain, ASSET_SYMBOL)
-
 // Retrieve the symbol of the relay chain for a particular chain. Either "DOT" or "KSM"
 getRelayChainSymbol(TChain)
 
@@ -428,12 +479,6 @@ getOtherAssets(TChain)
 // Retrieve string array of all asset symbols. (native and foreign assets are merged into a single array)
 getAllAssetsSymbols(TChain)
 
-// Check if a chain supports a particular asset. (Both native and foreign assets are searched). Returns boolean
-hasSupportForAsset(TChain, ASSET_SYMBOL)
-
-// Get decimals for specific asset
-getAssetDecimals(TChain, ASSET_SYMBOL)
-
 // Get specific chain id
 getParaId(TChain)
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _paraspell_sdk_core from '@paraspell/sdk-core';
-import { TApiOrUrl, WithApi, TEvmChainFrom, TChain, TCurrencyInputWithAmount, Foreign, ForeignAbstract, Native, Override, findAssetInfo, getAllAssetsSymbols, getAssetDecimals, getAssetId, getAssets, getAssetsObject, getExistentialDeposit, getNativeAssetSymbol, getNativeAssets, getOtherAssets, getRelayChainSymbol, getSupportedAssets, getTChain, hasSupportForAsset, isChainEvm, TSubstrateChain, TBuilderOptions, GeneralBuilder as GeneralBuilder$1, TSendBaseOptions } from '@paraspell/sdk-core';
+import { WithApi, TEvmChainFrom, 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';
 export * from '@paraspell/sdk-core';
 import * as _polkadot_api from '@polkadot/api';
 import { ApiPromise } from '@polkadot/api';
@@ -10,7 +10,6 @@ import { WalletClient } from 'viem';
 import { toPolkadotV2 } from '@snowbridge/api';
 
 type TPjsApi = ApiPromise;
-type TPjsApiOrUrl = TApiOrUrl<TPjsApi>;
 type Extrinsic = SubmittableExtrinsic<'promise'>;
 type TPjsSigner = {
     signer: Signer;
@@ -32,7 +31,7 @@ type TEvmBuilderOptionsBase = {
     /**
      * The Polkadot destination address.
      */
-    address: string;
+    recipient: string;
     /**
      * The AssetHub address
      */
@@ -54,22 +53,13 @@ type TPjsEvmBuilderOptions<TApi, TRes, TSigner> = WithApi<TEvmBuilderOptionsBase
 declare const getBalance: (options: _paraspell_sdk_core.TGetBalanceCommonOptions & {
     currency?: _paraspell_sdk_core.TCurrencyCore;
 } & {
-    api?: TPjsApiOrUrl;
+    api?: _paraspell_sdk_core.TApiOrUrl<TPjsApi>;
 }) => Promise<bigint>;
-/**
- * Claims assets from a parachain.
- *
- * @returns An extrinsic representing the claim transaction.
- */
-declare const claimAssets: (options: _paraspell_sdk_core.TAssetClaimOptionsBase & {
-    api?: TPjsApiOrUrl;
-}) => Promise<Extrinsic>;
 
 declare const assets_Foreign: typeof Foreign;
 declare const assets_ForeignAbstract: typeof ForeignAbstract;
 declare const assets_Native: typeof Native;
 declare const assets_Override: typeof Override;
-declare const assets_claimAssets: typeof claimAssets;
 declare const assets_findAssetInfo: typeof findAssetInfo;
 declare const assets_getAllAssetsSymbols: typeof getAllAssetsSymbols;
 declare const assets_getAssetDecimals: typeof getAssetDecimals;
@@ -92,7 +82,6 @@ declare namespace assets {
     assets_ForeignAbstract as ForeignAbstract,
     assets_Native as Native,
     assets_Override as Override,
-    assets_claimAssets as claimAssets,
     assets_findAssetInfo as findAssetInfo,
     assets_getAllAssetsSymbols as getAllAssetsSymbols,
     assets_getAssetDecimals as getAssetDecimals,
@@ -147,8 +136,8 @@ declare class EvmBuilderCore<TApi, TRes, TSigner, T extends Partial<TPjsEvmBuild
      * @param address - The Polkadot address to receive the transfer.
      * @returns An instance of EvmBuilder
      */
-    address(address: string): EvmBuilderCore<TApi, TRes, TSigner, T & {
-        address: string;
+    recipient(address: string): EvmBuilderCore<TApi, TRes, TSigner, T & {
+        recipient: string;
     }>;
     /**
      * Sets the asset hub address. This is used for transfers that go through the Asset Hub.
@@ -182,10 +171,10 @@ declare class EvmBuilderCore<TApi, TRes, TSigner, T extends Partial<TPjsEvmBuild
  * @param api - The API instance to use for building transactions. If not provided, a new instance will be created.
  * @returns A new Builder instance.
  */
-declare const Builder: (api?: TBuilderOptions<TPjsApiOrUrl>) => GeneralBuilder$1<_polkadot_api.ApiPromise, Extrinsic, TPjsSigner, object>;
-type GeneralBuilder<T extends Partial<TSendBaseOptions<TPjsApi, Extrinsic, TPjsSigner>> = object> = GeneralBuilder$1<TPjsApi, Extrinsic, TPjsSigner, T>;
-declare const EvmBuilder: (provider?: AbstractProvider, api?: TBuilderOptions<TPjsApiOrUrl>) => EvmBuilderCore<unknown, unknown, unknown, {
-    api: _paraspell_sdk_core.IPolkadotApi<_polkadot_api.ApiPromise, Extrinsic, TPjsSigner>;
+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 EvmBuilder: (provider?: AbstractProvider, api?: TBuilderOptions<TApiOrUrl<TPjsApi>>) => EvmBuilderCore<unknown, unknown, unknown, {
+    api: _paraspell_sdk_core.PolkadotApi<_polkadot_api.ApiPromise, Extrinsic, TPjsSigner>;
     provider: AbstractProvider | undefined;
 }>;
 
@@ -209,7 +198,7 @@ declare const depositToken: (signer: Signer$1, amount: bigint, symbol: string) =
  *
  * @throws Will throw an error if the transfer validation fails or if the transfer cannot be completed.
  */
-declare const transferEthToPolkadot$1: <TApi, TRes, TSigner>({ api, provider, signer, address, to, currency }: TPjsEvmBuilderOptions<TApi, TRes, TSigner>) => Promise<{
+declare const transferEthToPolkadot$1: <TApi, TRes, TSigner>({ api, provider, signer, recipient, to, currency }: TPjsEvmBuilderOptions<TApi, TRes, TSigner>) => Promise<{
     response: ethers.TransactionResponse;
     messageReceipt: toPolkadotV2.MessageReceipt;
 }>;
@@ -217,17 +206,17 @@ declare const transferEthToPolkadot$1: <TApi, TRes, TSigner>({ api, provider, si
 declare const getTokenBalance: (signer: Signer$1, symbol: string) => Promise<bigint>;
 
 declare const dryRun: (options: _paraspell_sdk_core.TDryRunBaseOptions<Extrinsic> & {
-    api?: TPjsApiOrUrl;
+    api?: TApiOrUrl<TPjsApi>;
 }) => Promise<_paraspell_sdk_core.TDryRunResult>;
 declare const dryRunOrigin: (options: _paraspell_sdk_core.TDryRunCallBaseOptions<Extrinsic> & {
-    api?: TPjsApiOrUrl;
+    api?: TApiOrUrl<TPjsApi>;
 }) => Promise<_paraspell_sdk_core.TDryRunChainResult>;
 declare const transferEthToPolkadot: (options: Omit<TPjsEvmBuilderOptions<TPjsApi, Extrinsic, TPjsSigner>, "api">) => ReturnType<typeof transferEthToPolkadot$1>;
-declare const getParaEthTransferFees: (api?: TPjsApiOrUrl) => Promise<[bigint, bigint]>;
+declare const getParaEthTransferFees: (api?: TApiOrUrl<TPjsApi>) => Promise<[bigint, bigint]>;
 /**
  * Gets the Ethereum bridge status.
  */
-declare const getBridgeStatus: (api?: TPjsApiOrUrl) => Promise<_paraspell_sdk_core.TBridgeStatus>;
+declare const getBridgeStatus: (api?: TApiOrUrl<TPjsApi>) => Promise<_paraspell_sdk_core.TBridgeStatus>;
 
 declare const transfer_approveToken: typeof approveToken;
 declare const transfer_depositToken: typeof depositToken;
@@ -250,7 +239,7 @@ declare namespace transfer {
   };
 }
 
-declare const createChainClient: (chain: TSubstrateChain, builderOptions?: TBuilderOptions<TPjsApiOrUrl>) => Promise<_polkadot_api.ApiPromise>;
+declare const createChainClient: (chain: TSubstrateChain, builderOptions?: TBuilderOptions<TApiOrUrl<TPjsApi>>) => Promise<_polkadot_api.ApiPromise>;
 
-export { Builder, EvmBuilder, approveToken, assets, claimAssets, convertSs58, createChainClient, depositToken, dryRun, dryRunOrigin, getBalance, getBridgeStatus, getParaEthTransferFees, getTokenBalance, transferEthToPolkadot, transfer as xcmPallet };
-export type { Extrinsic, GeneralBuilder, TPjsApi, TPjsApiOrUrl, TPjsEvmBuilderOptions, TPjsSigner };
+export { Builder, EvmBuilder, approveToken, assets, convertSs58, createChainClient, depositToken, dryRun, dryRunOrigin, getBalance, getBridgeStatus, getParaEthTransferFees, getTokenBalance, transferEthToPolkadot, transfer as xcmPallet };
+export type { Extrinsic, GeneralBuilder, TPjsApi, TPjsEvmBuilderOptions, TPjsSigner };

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { getNativeAssetSymbol, getOtherAssets, hasJunction, getJunctionValue, getEvmPrivateKeyHex, createClientCache, MAX_CLIENTS, EXTENSION_MS, createClientPoolHelpers, BatchMode, isConfig, findNativeAssetInfoOrThrow, getChainProviders, isSenderSigner, DEFAULT_TTL_MS, resolveChainApi, isExternalChain, UnsupportedOperationError, findAssetInfoOrThrow, hasXcmPaymentApiSupport, resolveModuleError, getAssetsObject, RuntimeApiUnavailableError, wrapTxBypass, localizeLocation, addXcmVersionHeader, isAssetXcEqual, RELAY_LOCATION, getRelayChainOf, createChainClient as createChainClient$1, getBalance as getBalance$1, claimAssets as claimAssets$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, getChainProviders, isSenderSigner, PolkadotApi, resolveChainApi, DEFAULT_TTL_MS, isExternalChain, findAssetInfoOrThrow, hasXcmPaymentApiSupport, resolveModuleError, getAssetsObject, RuntimeApiUnavailableError, wrapTxBypass, localizeLocation, 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 { isHex, u8aToHex, hexToU8a, stringToU8a } from '@polkadot/util';
+import { u8aConcat, compactToU8a, u8aEq, isHex, u8aToHex, hexToU8a, stringToU8a } from '@polkadot/util';
 import { decodeAddress, blake2AsHex, validateAddress } from '@polkadot/util-crypto';
 import { WETH9__factory } from '@snowbridge/contract-types';
 import { bridgeInfoFor } from '@snowbridge/registry';
@@ -15,6 +15,10 @@ function _arrayLikeToArray(r, a) {
 function _arrayWithoutHoles(r) {
   if (Array.isArray(r)) return _arrayLikeToArray(r);
 }
+function _assertThisInitialized(e) {
+  if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+  return e;
+}
 function asyncGeneratorStep(n, t, e, r, o, a, c) {
   try {
     var i = n[a](c),
@@ -40,6 +44,9 @@ function _asyncToGenerator(n) {
     });
   };
 }
+function _callSuper(t, o, e) {
+  return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e));
+}
 function _classCallCheck(a, n) {
   if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
 }
@@ -110,6 +117,31 @@ function _defineProperty(e, r, t) {
     writable: true
   }) : e[r] = t, e;
 }
+function _getPrototypeOf(t) {
+  return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) {
+    return t.__proto__ || Object.getPrototypeOf(t);
+  }, _getPrototypeOf(t);
+}
+function _inherits(t, e) {
+  if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function");
+  t.prototype = Object.create(e && e.prototype, {
+    constructor: {
+      value: t,
+      writable: true,
+      configurable: true
+    }
+  }), Object.defineProperty(t, "prototype", {
+    writable: false
+  }), e && _setPrototypeOf(t, e);
+}
+function _isNativeReflectConstruct() {
+  try {
+    var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {}));
+  } catch (t) {}
+  return (_isNativeReflectConstruct = function () {
+    return !!t;
+  })();
+}
 function _iterableToArray(r) {
   if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
 }
@@ -137,6 +169,11 @@ function _objectSpread2(e) {
   }
   return e;
 }
+function _possibleConstructorReturn(t, e) {
+  if (e && ("object" == typeof e || "function" == typeof e)) return e;
+  if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined");
+  return _assertThisInitialized(t);
+}
 function _regenerator() {
   /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */
   var e,
@@ -245,6 +282,11 @@ function _regeneratorDefine(e, r, n, t) {
     }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2));
   }, _regeneratorDefine(e, r, n, t);
 }
+function _setPrototypeOf(t, e) {
+  return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) {
+    return t.__proto__ = e, t;
+  }, _setPrototypeOf(t, e);
+}
 function _toConsumableArray(r) {
   return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
 }
@@ -359,6 +401,54 @@ var snakeToCamel = function snakeToCamel(str) {
   });
 };
 
+var txFromHex = function txFromHex(api, hex) {
+  var _api$tx$section;
+  // Try as full extrinsic
+  try {
+    var tx = api.tx(hex);
+    if (tx.toHex() === hex) return tx;
+  } catch (_unused) {
+    // Not a valid extrinsic, try other formats
+  }
+  // Try as Call
+  try {
+    var _call = api.createType('Call', hex);
+    var callHex = _call.toHex();
+    if (callHex === hex) {
+      var _api$tx$_section;
+      var _api$registry$findMet = api.registry.findMetaCall(_call.callIndex),
+        _method = _api$registry$findMet.method,
+        _section = _api$registry$findMet.section;
+      return (_api$tx$_section = api.tx[_section])[_method].apply(_api$tx$_section, _toConsumableArray(_call.args));
+    }
+    if (hex.startsWith(callHex)) {
+      // Try as un-prefixed ExtrinsicPayload
+      var prefixed = u8aConcat(compactToU8a(_call.encodedLength), hex);
+      var _payload = api.createType('ExtrinsicPayload', prefixed);
+      if (u8aEq(_payload.toU8a(), prefixed)) {
+        var _api$tx$_section2;
+        var payloadCall = api.createType('Call', _payload.method.toHex());
+        var _api$registry$findMet2 = api.registry.findMetaCall(payloadCall.callIndex),
+          _method2 = _api$registry$findMet2.method,
+          _section2 = _api$registry$findMet2.section;
+        return (_api$tx$_section2 = api.tx[_section2])[_method2].apply(_api$tx$_section2, _toConsumableArray(payloadCall.args));
+      }
+    }
+  } catch (_unused2) {
+    // Not a valid call, try as payload
+  }
+  // Final attempt: try as prefixed ExtrinsicPayload
+  var payload = api.createType('ExtrinsicPayload', hex);
+  if (payload.toHex() !== hex) {
+    throw new UnsupportedOperationError('Unable to decode hex as Extrinsic, Call, or ExtrinsicPayload');
+  }
+  var call = api.createType('Call', payload.method.toHex());
+  var _api$registry$findMet3 = api.registry.findMetaCall(call.callIndex),
+    method = _api$registry$findMet3.method,
+    section = _api$registry$findMet3.section;
+  return (_api$tx$section = api.tx[section])[method].apply(_api$tx$section, _toConsumableArray(call.args));
+};
+
 var clientPool = createClientCache(MAX_CLIENTS, /*#__PURE__*/function () {
   var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(client) {
     return _regenerator().w(function (_context) {
@@ -397,41 +487,27 @@ var createPolkadotJsClient = /*#__PURE__*/function () {
 var _createClientPoolHelp = createClientPoolHelpers(clientPool, createPolkadotJsClient),
   leaseClient = _createClientPoolHelp.leaseClient,
   releaseClient = _createClientPoolHelp.releaseClient;
-var PolkadotJsApi = /*#__PURE__*/function () {
-  function PolkadotJsApi(config) {
+var PolkadotJsApi = /*#__PURE__*/function (_PolkadotApi) {
+  function PolkadotJsApi() {
+    var _this;
     _classCallCheck(this, PolkadotJsApi);
-    this._ttlMs = DEFAULT_TTL_MS;
-    this.initialized = false;
-    this.disconnectAllowed = true;
-    this._config = config;
+    _this = _callSuper(this, PolkadotJsApi, arguments);
+    _this.type = 'PJS';
+    return _this;
   }
+  _inherits(PolkadotJsApi, _PolkadotApi);
   return _createClass(PolkadotJsApi, [{
-    key: "getType",
-    value: function getType() {
-      return 'PJS';
-    }
-  }, {
-    key: "getConfig",
-    value: function getConfig() {
-      return this._config;
-    }
-  }, {
-    key: "getApi",
-    value: function getApi() {
-      return this.api;
-    }
-  }, {
     key: "init",
     value: function () {
       var _init = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(chain) {
-        var _this = this;
+        var _this2 = this;
         var clientTtlMs,
           _args = arguments;
         return _regenerator().w(function (_context3) {
           while (1) switch (_context3.n) {
             case 0:
               clientTtlMs = _args.length > 1 && _args[1] !== undefined ? _args[1] : DEFAULT_TTL_MS;
-              if (!(this.initialized || isExternalChain(chain))) {
+              if (!(this._chain !== undefined || isExternalChain(chain))) {
                 _context3.n = 1;
                 break;
               }
@@ -441,11 +517,10 @@ var PolkadotJsApi = /*#__PURE__*/function () {
               this._chain = chain;
               _context3.n = 2;
               return resolveChainApi(this._config, chain, function (wsUrl, c) {
-                return _this.createApiInstance(wsUrl, c);
+                return _this2.createApiInstance(wsUrl, c);
               });
             case 2:
-              this.api = _context3.v;
-              this.initialized = true;
+              this._api = _context3.v;
             case 3:
               return _context3.a(2);
           }
@@ -497,8 +572,8 @@ var PolkadotJsApi = /*#__PURE__*/function () {
     }
   }, {
     key: "txFromHex",
-    value: function txFromHex(hex) {
-      return Promise.resolve(this.api.tx(hex));
+    value: function txFromHex$1(hex) {
+      return Promise.resolve(txFromHex(this.api, hex));
     }
   }, {
     key: "queryState",
@@ -691,13 +766,13 @@ var PolkadotJsApi = /*#__PURE__*/function () {
         return _regenerator().w(function (_context8) {
           while (1) switch (_context8.n) {
             case 0:
-              api = new PolkadotJsApi();
+              api = new PolkadotJsApi(isConfig(this._config) ? this._config : undefined);
               _context8.n = 1;
               return api.init(chain);
             case 1:
               return _context8.a(2, api);
           }
-        }, _callee8);
+        }, _callee8, this);
       }));
       function createApiForChain(_x11) {
         return _createApiForChain.apply(this, arguments);
@@ -747,7 +822,7 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                 isCustomAsset: true,
                 asset: findAssetInfoOrThrow(chain, {
                   id: assetId
-                }, null)
+                })
               });
           }
         }, _callee9, this);
@@ -761,8 +836,8 @@ var PolkadotJsApi = /*#__PURE__*/function () {
     key: "getDryRunCall",
     value: function () {
       var _getDryRunCall = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee1(options) {
-        var _this2 = this;
-        var tx, address, feeAsset, chain, destination, version, _options$useRootOrigi, useRootOrigin, bypassOptions, supportsDryRunApi, basePayload, resolvedTx, resolvedFeeAsset, performDryRunCall, 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;
+        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 (_context1) {
           while (1) switch (_context1.p = _context1.n) {
             case 0:
@@ -805,13 +880,13 @@ var PolkadotJsApi = /*#__PURE__*/function () {
               resolvedFeeAsset = _context1.v;
               performDryRunCall = /*#__PURE__*/function () {
                 var _ref5 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0(includeVersion) {
-                  var _this2$api$call$dryRu;
+                  var _this3$api$call$dryRu;
                   var versionNum;
                   return _regenerator().w(function (_context0) {
                     while (1) switch (_context0.n) {
                       case 0:
                         versionNum = Number(version.charAt(1));
-                        return _context0.a(2, (_this2$api$call$dryRu = _this2.api.call.dryRunApi).dryRunCall.apply(_this2$api$call$dryRu, [basePayload, resolvedTx].concat(_toConsumableArray(includeVersion ? [versionNum] : []))));
+                        return _context0.a(2, (_this3$api$call$dryRu = _this3.api.call.dryRunApi).dryRunCall.apply(_this3$api$call$dryRu, [basePayload, resolvedTx].concat(_toConsumableArray(includeVersion ? [versionNum] : []))));
                     }
                   }, _callee0);
                 }));
@@ -819,23 +894,31 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                   return _ref5.apply(this, arguments);
                 };
               }();
+              findFailingEventInResult = function findFailingEventInResult(resultHuman) {
+                var _resultHuman$Ok;
+                return resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok = resultHuman.Ok) === null || _resultHuman$Ok === void 0 || (_resultHuman$Ok = _resultHuman$Ok.emittedEvents) === null || _resultHuman$Ok === void 0 ? void 0 : _resultHuman$Ok.find(function (event) {
+                  var _event$data;
+                  return (event.section === 'utility' || event.section === 'Utility') && event.method === 'DispatchedAs' && ((_event$data = event.data) === null || _event$data === void 0 || (_event$data = _event$data.result) === null || _event$data === void 0 ? void 0 : _event$data.Err);
+                });
+              };
               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));
+                var errorInEvents = findFailingEventInResult(resultHuman);
+                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) && !errorInEvents);
               };
               extractFailureReasonFromResult = function extractFailureReasonFromResult(resultHuman, resultJson) {
-                var _resultHuman$Ok, _resultHuman$Ok2, _resultHuman$Ok3, _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;
+                var _resultHuman$Ok2, _resultHuman$Ok3, _resultHuman$Ok4, _resultJson$ok, _ref6;
+                var modErrHuman = 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.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;
+                var otherErrHuman = resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok3 = resultHuman.Ok) === null || _resultHuman$Ok3 === void 0 || (_resultHuman$Ok3 = _resultHuman$Ok3.executionResult) === null || _resultHuman$Ok3 === void 0 || (_resultHuman$Ok3 = _resultHuman$Ok3.Err) === null || _resultHuman$Ok3 === void 0 || (_resultHuman$Ok3 = _resultHuman$Ok3.error) === null || _resultHuman$Ok3 === void 0 ? void 0 : _resultHuman$Ok3.Other;
                 if (otherErrHuman) {
                   return {
                     failureReason: String(otherErrHuman)
                   };
                 }
-                var secondErrHuman = resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok3 = resultHuman.Ok) === null || _resultHuman$Ok3 === void 0 || (_resultHuman$Ok3 = _resultHuman$Ok3.executionResult) === null || _resultHuman$Ok3 === void 0 || (_resultHuman$Ok3 = _resultHuman$Ok3.Err) === null || _resultHuman$Ok3 === void 0 ? void 0 : _resultHuman$Ok3.error;
+                var secondErrHuman = resultHuman === null || resultHuman === void 0 || (_resultHuman$Ok4 = resultHuman.Ok) === null || _resultHuman$Ok4 === void 0 || (_resultHuman$Ok4 = _resultHuman$Ok4.executionResult) === null || _resultHuman$Ok4 === void 0 || (_resultHuman$Ok4 = _resultHuman$Ok4.Err) === null || _resultHuman$Ok4 === void 0 ? void 0 : _resultHuman$Ok4.error;
                 if (secondErrHuman) {
                   return {
                     failureReason: String(secondErrHuman)
@@ -850,6 +933,19 @@ var PolkadotJsApi = /*#__PURE__*/function () {
                     failureReason: String(execErrJson.other)
                   };
                 }
+                var erroredEvent = findFailingEventInResult(resultHuman);
+                if (erroredEvent) {
+                  var _erroredEvent$data;
+                  var err = (_erroredEvent$data = erroredEvent.data) === null || _erroredEvent$data === void 0 || (_erroredEvent$data = _erroredEvent$data.result) === null || _erroredEvent$data === void 0 ? void 0 : _erroredEvent$data.Err;
+                  if (err !== null && err !== void 0 && err.Module) {
+                    return resolveModuleError(chain, err.Module);
+                  }
+                  if (err) {
+                    return {
+                      failureReason: typeof err === 'string' ? err : JSON.stringify(err)
+                    };
+                  }
+                }
                 return {
                   failureReason: JSON.stringify((_ref6 = resultJson !== null && resultJson !== void 0 ? resultJson : resultHuman) !== null && _ref6 !== void 0 ? _ref6 : 'Unknown error')
                 };
@@ -1339,22 +1435,12 @@ var PolkadotJsApi = /*#__PURE__*/function () {
       }
       return getBridgeStatus;
     }()
-  }, {
-    key: "setDisconnectAllowed",
-    value: function setDisconnectAllowed(allowed) {
-      this.disconnectAllowed = allowed;
-    }
-  }, {
-    key: "getDisconnectAllowed",
-    value: function getDisconnectAllowed() {
-      return this.disconnectAllowed;
-    }
   }, {
     key: "disconnect",
     value: function disconnect() {
       var _this$_config$apiOver;
       var force = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
-      if (!this.initialized) return Promise.resolve();
+      if (!this._chain) return Promise.resolve();
       if (!force && !this.disconnectAllowed) return Promise.resolve();
       var api = isConfig(this._config) ? (_this$_config$apiOver = this._config.apiOverrides) === null || _this$_config$apiOver === void 0 ? void 0 : _this$_config$apiOver[this._chain] : this._config;
       // Own client provided, destroy only if force true
@@ -1426,8 +1512,63 @@ var PolkadotJsApi = /*#__PURE__*/function () {
       }
       return signAndSubmit;
     }()
+  }, {
+    key: "signAndSubmitFinalized",
+    value: function () {
+      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)) {
+                _context17.n = 2;
+                break;
+              }
+              _context17.n = 1;
+              return tx.signAsync(sender.address, {
+                signer: sender.signer
+              });
+            case 1:
+              _context17.n = 3;
+              break;
+            case 2:
+              _context17.n = 3;
+              return tx.signAsync(createKeyringPair(sender));
+            case 3:
+              return _context17.a(2, new Promise(function (resolve, reject) {
+                tx.send(function (_ref13) {
+                  var status = _ref13.status,
+                    dispatchError = _ref13.dispatchError,
+                    txHash = _ref13.txHash;
+                  if (status.isFinalized) {
+                    if (dispatchError !== undefined) {
+                      if (dispatchError.isModule) {
+                        var decoded = _this4.api.registry.findMetaError(dispatchError.asModule);
+                        var docs = decoded.docs,
+                          name = decoded.name,
+                          section = decoded.section;
+                        reject(new SubmitTransactionError("".concat(section, ".").concat(name, ": ").concat(docs.join(' '))));
+                      } else {
+                        reject(new SubmitTransactionError(dispatchError.toString()));
+                      }
+                    } else {
+                      resolve(txHash.toString());
+                    }
+                  }
+                })["catch"](function (error) {
+                  reject(error instanceof Error ? error : new SubmitTransactionError(String(error)));
+                });
+              }));
+          }
+        }, _callee17);
+      }));
+      function signAndSubmitFinalized(_x33, _x34) {
+        return _signAndSubmitFinalized.apply(this, arguments);
+      }
+      return signAndSubmitFinalized;
+    }()
   }]);
-}();
+}(PolkadotApi);
 
 var createChainClient = function createChainClient(chain, builderOptions) {
   var pjsApi = new PolkadotJsApi(builderOptions);
@@ -1463,12 +1604,6 @@ var isEthersSigner = function isEthersSigner(signer) {
  * @returns The asset balance as a bigint.
  */
 var getBalance = createPolkadotJsApiCall(getBalance$1);
-/**
- * Claims assets from a parachain.
- *
- * @returns An extrinsic representing the claim transaction.
- */
-var claimAssets = createPolkadotJsApiCall(claimAssets$1);
 
 var assets = /*#__PURE__*/Object.freeze({
   __proto__: null,
@@ -1476,7 +1611,6 @@ var assets = /*#__PURE__*/Object.freeze({
   ForeignAbstract: ForeignAbstract,
   Native: Native,
   Override: Override,
-  claimAssets: claimAssets,
   findAssetInfo: findAssetInfo,
   getAllAssetsSymbols: getAllAssetsSymbols,
   getAssetDecimals: getAssetDecimals,
@@ -1509,7 +1643,7 @@ var approveToken = /*#__PURE__*/function () {
           _bridgeInfoFor = bridgeInfoFor('polkadot_mainnet'), gatewayContract = _bridgeInfoFor.environment.gatewayContract;
           asset = findAssetInfoOrThrow('Ethereum', {
             symbol: symbol
-          }, null);
+          });
           assertHasId(asset);
           weth9 = WETH9__factory.connect(asset.assetId, signer);
           _context.n = 1;
@@ -1540,7 +1674,7 @@ var depositToken = /*#__PURE__*/function () {
         case 0:
           asset = findAssetInfoOrThrow('Ethereum', {
             symbol: symbol
-          }, null);
+          });
           assertHasId(asset);
           weth9 = WETH9__factory.connect(asset.assetId, signer);
           _context.n = 1;
@@ -1599,11 +1733,11 @@ var createContext = function createContext(executionUrl, env) {
  */
 var transferEthToPolkadot$1 = /*#__PURE__*/function () {
   var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(_ref) {
-    var api, provider, signer, address, to, currency, ethAsset, amount, _bridgeInfoFor, environment, registry, context, destParaId, fee, sourceAddress, transfer, validation, tx, response, receipt, messageReceipt, _t, _t2, _t3, _t4, _t5, _t6, _t7, _t8, _t9, _t0, _t1;
+    var api, provider, signer, recipient, to, currency, ethAsset, amount, _bridgeInfoFor, environment, registry, context, destParaId, fee, sourceAddress, transfer, validation, tx, response, receipt, messageReceipt, _t, _t2, _t3, _t4, _t5, _t6, _t7, _t8, _t9, _t0, _t1;
     return _regenerator().w(function (_context) {
       while (1) switch (_context.n) {
         case 0:
-          api = _ref.api, provider = _ref.provider, signer = _ref.signer, address = _ref.address, to = _ref.to, currency = _ref.currency;
+          api = _ref.api, provider = _ref.provider, signer = _ref.signer, recipient = _ref.recipient, to = _ref.to, currency = _ref.currency;
           if (!Array.isArray(currency)) {
             _context.n = 1;
             break;
@@ -1657,7 +1791,7 @@ var transferEthToPolkadot$1 = /*#__PURE__*/function () {
         case 8:
           sourceAddress = _context.v;
           _context.n = 9;
-          return toPolkadotV2.createTransfer(registry, sourceAddress, address, ethAsset.assetId, destParaId, amount, fee);
+          return toPolkadotV2.createTransfer(registry, sourceAddress, recipient, ethAsset.assetId, destParaId, amount, fee);
         case 9:
           transfer = _context.v;
           _t5 = toPolkadotV2;
@@ -1752,7 +1886,7 @@ var getTokenBalance = /*#__PURE__*/function () {
         case 0:
           asset = findAssetInfoOrThrow('Ethereum', {
             symbol: symbol
-          }, null);
+          });
           assertHasId(asset);
           weth9 = WETH9__factory.connect(asset.assetId, signer);
           _context.n = 1;
@@ -1816,10 +1950,10 @@ var EvmBuilderCore = /*#__PURE__*/function () {
      * @returns An instance of EvmBuilder
      */
   }, {
-    key: "address",
-    value: function address(_address) {
+    key: "recipient",
+    value: function recipient(address) {
       return new EvmBuilderCore(_objectSpread2(_objectSpread2({}, this._options), {}, {
-        address: _address
+        recipient: address
       }));
     }
     /**
@@ -1857,12 +1991,12 @@ var EvmBuilderCore = /*#__PURE__*/function () {
     key: "build",
     value: (function () {
       var _build = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
-        var _this$_options, from, to, address, signer, api, _yield$transferEthToP, response;
+        var _this$_options, from, to, recipient, signer, api, _yield$transferEthToP, response;
         return _regenerator().w(function (_context) {
           while (1) switch (_context.n) {
             case 0:
-              _this$_options = this._options, from = _this$_options.from, to = _this$_options.to, address = _this$_options.address, signer = _this$_options.signer, api = _this$_options.api;
-              validateAddress$1(api, address, to);
+              _this$_options = this._options, from = _this$_options.from, to = _this$_options.to, recipient = _this$_options.recipient, signer = _this$_options.signer, api = _this$_options.api;
+              validateAddress$1(api, recipient, to);
               if (!(from === 'Moonbeam' && to === 'Ethereum')) {
                 _context.n = 2;
                 break;
@@ -1993,4 +2127,4 @@ var transfer = /*#__PURE__*/Object.freeze({
   transferEthToPolkadot: transferEthToPolkadot
 });
 
-export { Builder, EvmBuilder, approveToken, assets, claimAssets, convertSs58, createChainClient, depositToken, dryRun, dryRunOrigin, getBalance, getBridgeStatus, getParaEthTransferFees, getTokenBalance, transferEthToPolkadot, transfer as xcmPallet };
+export { Builder, EvmBuilder, approveToken, assets, convertSs58, createChainClient, depositToken, dryRun, dryRunOrigin, getBalance, getBridgeStatus, getParaEthTransferFees, getTokenBalance, transferEthToPolkadot, transfer as xcmPallet };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk-pjs",
-  "version": "12.9.7",
+  "version": "12.10.0-rc.1",
   "description": "Polkadot.js based SDK for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -29,7 +29,7 @@
     "@snowbridge/registry": "^0.4.4",
     "ethers": "^6.16.0",
     "viem": "2.47.1",
-    "@paraspell/sdk-core": "12.9.7"
+    "@paraspell/sdk-core": "12.10.0-rc.1"
   },
   "peerDependencies": {
     "@polkadot/api": ">= 16.0 < 17",