@paraspell/sdk 8.10.0 → 8.11.1

package/README.md

@@ -70,26 +70,19 @@ import { Native, Foreign, ForeignAbstract } from '@paraspell/sdk'; //Only needed
 
 ```
 NOTES:
-- If you wish to transfer from Parachain that uses long IDs for example Moonbeam you have to add the character 'n' to the end of currencyID. Eg: .currency({id: 42259045809535163221576417993425387648n}) will mean you transfer xcDOT.
-- You can now use custom ParachainIDs if you wish to test in TestNet. Just add parachainID as an additional parameter eg: .to('Basilisk', 2948).
-- 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.
-- ParaSpell now offers advanced asset symbol selection {symbol: "symbol"} for non duplicate assets, {symbol: Native("symbol")} or {symbol: Foreign("symbol")} if the duplicates are between native and foreign assets and {symbol: ForeignAbstract("symbol")} if the duplicates are in foreign assets only. You will get an error that will guide you further if you simply start with {symbol: "symbol"}.
-- You can now select assets by multilocation by simply using { multilocation: string | JSON }. The custom multilocation selection remains supported, but in order to use it you now have to use override - {multilocation: Override('Custom Multilocation')}.
-- The balance queries also support multilocation asset selection
 - PAPI version of SDK is now fully PJS-less (We removed apps/config as dependency entirely).
 - You can now query foreign asset minimal deposits also.
-```
-
-```
-Latest news:
 - Since v8, amount moved closer to currency selection and specifying from and to parameters is no longer optional to save code.
 - More information on v8 major breaking change: https://github.com/paraspell/xcm-tools/pull/554
 - XCM SDK Now supports API Failsafe - If one endpoint doesn't work it automatically switches to the next one.
 - Builder now allows you to directly disconnect API.
 ```
 
+```
+Latest news:
+- Local transfers are now available for every currency and every chain. To try them, simply use same origin and destination parameters.
+```
+
 ### Builder pattern:
 
 ##### Transfer assets from Parachain to Parachain
@@ -99,7 +92,8 @@ const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .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*/)
-      /*.xcmVersion(Version.V1/V2/V3/V4)  //Optional parameter for manual override of XCM Version used in call
+      /*.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.*/
 
 const tx = await builder.build()
@@ -131,8 +125,7 @@ const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .to(NODE/*,customParaId - optional*/ | Multilocation object)
       .currency({symbol: 'DOT', amount: amount})
       .address(address | Multilocation object)
-    /*.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
+      /*.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.*/
 
 const tx = await builder.build()
@@ -249,6 +242,37 @@ const tx = await builder.build()
 await builder.disconnect()
 ```
 
+### Local transfers
+```ts
+const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
+      .from(NODE)
+      .to(NODE) //Has to be same as origin (from)
+      .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)
+
+const tx = await builder.build()
+
+//Make sure to disconnect API after it is no longer used (eg. after transaction)
+await builder.disconnect()
+
+/*
+EXAMPLE:
+const builder = Builder()
+  .from('Hydration')
+  .to('Hydration')
+  .currency({
+    symbol: 'DOT',
+    amount: '1000000000'
+  })
+  .address(address)
+
+const tx = await builder.build()
+
+//Disconnect API after TX
+await builder.disconnect()
+*/
+```
+
 ### Asset queries:
 
 ```ts

package/dist/index.cjs

@@ -532,6 +532,11 @@ var _transform = function transform(obj) {
             id: polkadotApi.FixedSizeBinary.fromHex(value.id)
           }
         };
+      } else if (key === 'Id') {
+        return {
+          type: key,
+          value: value
+        };
       } else if (key === 'OtherReserve') {
         return {
           type: key,
@@ -627,6 +632,10 @@ var _transform = function transform(obj) {
             newObj[k] = undefined;
             continue;
           }
+          if ((k === 'dest' || k === 'target') && typeof v === 'string') {
+            newObj[k] = v;
+            continue;
+          }
           if (typeof v === 'string' && v.startsWith('0x')) {
             newObj[k] = polkadotApi.FixedSizeBinary.fromHex(v);
           } else if (typeof v === 'string') {

package/dist/index.mjs

@@ -531,6 +531,11 @@ var _transform = function transform(obj) {
             id: FixedSizeBinary.fromHex(value.id)
           }
         };
+      } else if (key === 'Id') {
+        return {
+          type: key,
+          value: value
+        };
       } else if (key === 'OtherReserve') {
         return {
           type: key,
@@ -626,6 +631,10 @@ var _transform = function transform(obj) {
             newObj[k] = undefined;
             continue;
           }
+          if ((k === 'dest' || k === 'target') && typeof v === 'string') {
+            newObj[k] = v;
+            continue;
+          }
           if (typeof v === 'string' && v.startsWith('0x')) {
             newObj[k] = FixedSizeBinary.fromHex(v);
           } else if (typeof v === 'string') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk",
-  "version": "8.10.0",
+  "version": "8.11.1",
   "description": "SDK for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "ethers": "^6.13.5",
     "viem": "^2.23.15",
     "@noble/hashes": "^1.7.1",
-    "@paraspell/sdk-core": "8.10.0"
+    "@paraspell/sdk-core": "8.11.1"
   },
   "peerDependencies": {
     "polkadot-api": ">= 1.9.7 < 2"