@paraspell/sdk 5.8.0 → 5.10.0

package/README.md

@@ -67,6 +67,7 @@ NOTES:
 - POLKADOT <> KUSAMA Bridge is now available! Try sending DOT or KSM between AssetHubs - More information here: https://paraspell.github.io/docs/sdk/xcmPallet.html#ecosystem-bridges.
 - You can now customize XCM Version! Try using .xcmVersion parameter after address in builder.
 - POLKADOT <> ETHEREUM Bridge is now available! Try sending WETH between the ecosystems - More information here: https://paraspell.github.io/docs/sdk/xcmPallet.html#ecosystem-bridges.
+- If you have duplicit asset error when building your call you can now specify which asset by new object selection eg. {symbol: number | bigint | string } or {id: number | bigint | string}
 ```
 
 ### Builder pattern:
@@ -76,7 +77,7 @@ NOTES:
 await Builder(/*node api - optional*/)
       .from(NODE)
       .to(NODE /*,customParaId - optional*/ | Multilocation object /*Only works for PolkadotXCM pallet*/) 
-      .currency(CurrencyString| CurrencyID | Multilocation object | MultilocationArray)
+      .currency(CurrencyString | CurrencyID | Multilocation object | MultilocationArray | { symbol: string | number | bigint} | { id: string | number | bigint}) // Object selection is used when there are duplicate assets found and selector is unable to pick based on details provided (You will get an error from SDK when this happens).
       /*.feeAsset(feeAsset) - Parameter required when using MultilocationArray*/
       .amount(amount) // Overriden when using MultilocationArray
       .address(address | Multilocation object /*If you are sending through xTokens, you need to pass the destination and address multilocation in one object (x2)*/)
@@ -140,6 +141,30 @@ await Builder(/*node api - optional*/)
       /*.xcmVersion(Version.V1/V2/V3/V4)  //Optional parameter for manual override of XCM Version used in call*/
       .build()
 ```
+
+##### Batch calls
+You can batch XCM calls and execute multiple XCM calls within one call. All three scenarios (Para->Para, Para->Relay, Relay->Para) can be used and combined.
+```js
+await Builder(/*node api - optional*/)
+      .from(NODE) //Ensure, that origin node is the same in all batched XCM Calls.
+      .to(NODE_2) //Any compatible Parachain
+      .currency(currency) //Currency to transfer (If Para->Para), otherwise you do not need to specify .currency()
+      .amount(amount) 
+      .address(address | Multilocation object)
+      .addToBatch()
+
+      .from(NODE) //Ensure, that origin node is the same in all batched XCM Calls.
+      .to(NODE_3) //Any compatible Parachain
+      .currency(currency) //Currency to transfer (If Para->Para), otherwise you do not need to specify .currency()
+      .amount(amount)
+      .address(address | Multilocation object)
+      .addToBatch()
+      .buildBatch({ 
+          // This settings object is optional and batch all is the default option
+          mode: BatchMode.BATCH_ALL //or BatchMode.BATCH
+      })
+```
+
 ##### Close HRMP channels
 ```ts
 Builder(api)