@paraspell/sdk-pjs 8.0.2 → 8.1.0

package/README.md

@@ -77,31 +77,37 @@ NOTES:
 - 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
+- You can now query foreign asset minimal deposits also.
 ```
 
 ```
 Latest news:
-- You can now query foreign asset minimal deposits also.
 - 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.
 ```
 
 ### Builder pattern:
 
 ##### Transfer assets from Parachain to Parachain
 ```ts
-await Builder(/*node api/ws_url_string/ws_url_array - optional*/)
+const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .from(NODE)
       .to(NODE /*,customParaId - optional*/ | Multilocation object /*Only works for PolkadotXCM pallet*/) 
       .currency({id: currencyID, amount: amount} | {symbol: currencySymbol, amount: amount} | {symbol: Native('currencySymbol'), amount: amount} | {symbol: Foreign('currencySymbol'), amount: amount} | {symbol: ForeignAbstract('currencySymbol'), amount: amount} | {multilocation: AssetMultilocationString, amount: amount | AssetMultilocationJson, amount: amount} | {multilocation: Override('Custom Multilocation'), amount: amount} | {multiasset: {currencySelection, isFeeAsset?: true /* for example symbol: symbol or id: id, or multilocation: multilocation*/, amount: amount}})
       .address(address | Multilocation object /*If you are sending through xTokens, you need to pass the destination and address multilocation in one object (x2)*/)
       /*.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.*/
-      .build()
+
+const tx = await builder.build()
+
+//Make sure to disconnect API after it is no longer used (eg. after transaction)
+await builder.disconnect()
+
 /*
 EXAMPLE:
-const tx = await Builder()
+const builder = Builder()
   .from('Acala')
   .to('Astar')
   .currency({
@@ -109,22 +115,31 @@ const tx = await Builder()
     amount: '1000000000'
   })
   .address(address)
-  .build();
+
+const tx = await builder.build()
+
+//Disconnect API after TX
+await builder.disconnect()
 */
 ```
 ##### Transfer assets from the Relay chain to Parachain
 ```ts
-await Builder(/*node api/ws_url_string/ws_url_array - optional*/)
+const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .from(RELAY_NODE) //Kusama or Polkadot
       .to(NODE/*,customParaId - optional*/ | Multilocation object)
       .currency({symbol: 'DOT', amount: amount})
       .address(address | Multilocation object)
       /*.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.*/
-      .build()
+
+const tx = await builder.build()
+
+//Make sure to disconnect API after it is no longer used (eg. after transaction)
+await builder.disconnect()
+
 /*
 EXAMPLE:
-const tx = await Builder()
+const builder = await Builder()
   .from('Polkadot')
   .to('Astar')
   .currency({
@@ -132,22 +147,31 @@ const tx = await Builder()
     amount: '1000000000'
   })
   .address(address)
-  .build();
+
+const tx = await builder.build()
+
+//Disconnect API after TX
+await builder.disconnect()
 */
 ```
 ##### Transfer assets from Parachain to Relay chain
 ```ts
-await Builder(/*node api/ws_url_string/ws_url_array - optional*/)
+const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .from(NODE)
       .to(RELAY_NODE) //Kusama or Polkadot
       .currency({symbol: 'DOT', amount: amount})
       .address(address | Multilocation object)
       /*.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.*/
-      .build()
+
+const tx = await builder.build()
+
+//Make sure to disconnect API after it is no longer used (eg. after transaction)
+await builder.disconnect()
+
 /*
 EXAMPLE:
-const tx = await Builder()
+const builder = await Builder()
   .from('Astar')
   .to('Polkadot')
   .currency({
@@ -155,14 +179,18 @@ const tx = await Builder()
     amount: '1000000000'
   })
   .address(address)
-  .build();
+
+const tx = await builder.build()
+
+//Disconnect API after TX
+await builder.disconnect()
 */
 ```
 
 ##### 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/ws_url_string/ws_url_array - optional*/)
+const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .from(NODE) //Ensure, that origin node is the same in all batched XCM Calls.
       .to(NODE_2) //Any compatible Parachain
       .currency({currencySelection, amount}) //Currency to transfer - options as in scenarios above
@@ -174,10 +202,14 @@ await Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .currency({currencySelection, amount}) //Currency to transfer - options as in scenarios above
       .address(address | Multilocation object)
       .addToBatch()
-      .buildBatch({ 
+      
+const tx = await builder.buildBatch({ 
           // This settings object is optional and batch all is the default option
           mode: BatchMode.BATCH_ALL //or BatchMode.BATCH
       })
+
+//Make sure to disconnect API after it is no longer used (eg. after transaction)
+await builder.disconnect()
 ```
 
 ### Dry run your XCM Calls:
@@ -197,12 +229,16 @@ getDryRun({api /*optional*/,  node, address, tx /* Extrinsic object */})
 ### Asset claim:
 ```ts
 //Claim XCM trapped assets from the selected chain
-await Builder(/*node api/ws_url_string/ws_url_array - optional*/)
+const builder = Builder(/*node api/ws_url_string/ws_url_array - optional*/)
       .claimFrom(NODE)
       .fungible(MultilocationArray (Only one multilocation allowed) [{Multilocation}])
       .account(address | Multilocation object)
       /*.xcmVersion(Version.V3) Optional parameter, by default V3. XCM Version ENUM if a different XCM version is needed (Supported V2 & V3). Requires importing Version enum.*/
-      .build()
+
+const tx = await builder.build()
+
+//Make sure to disconnect API after it is no longer used (eg. after transaction)
+await builder.disconnect()
 ```
 
 ### Asset queries:

package/dist/index.cjs

@@ -1182,22 +1182,31 @@ var PolkadotJsApi = /*#__PURE__*/function () {
     key: "disconnect",
     value: function () {
       var _disconnect = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee16() {
+        var force,
+          _args16 = arguments;
         return _regeneratorRuntime().wrap(function _callee16$(_context16) {
           while (1) switch (_context16.prev = _context16.next) {
             case 0:
-              if (this.disconnectAllowed) {
-                _context16.next = 2;
+              force = _args16.length > 0 && _args16[0] !== undefined ? _args16[0] : false;
+              if (this.initialized) {
+                _context16.next = 3;
                 break;
               }
-              return _context16.abrupt("return");
-            case 2:
-              if (!(typeof this._api === 'string' || this._api === undefined)) {
+              return _context16.abrupt("return", Promise.resolve());
+            case 3:
+              if (!(!force && !this.disconnectAllowed)) {
                 _context16.next = 5;
                 break;
               }
-              _context16.next = 5;
-              return this.api.disconnect();
+              return _context16.abrupt("return");
             case 5:
+              if (!(force || typeof this._api === 'string' || this._api === undefined)) {
+                _context16.next = 8;
+                break;
+              }
+              _context16.next = 8;
+              return this.api.disconnect();
+            case 8:
             case "end":
               return _context16.stop();
           }

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import { SubmittableExtrinsic } from '@polkadot/api/types';
 import * as _polkadot_api from '@polkadot/api';
 import { ApiPromise } from '@polkadot/api';
 import { AbstractProvider, Signer } from 'ethers';
+import { WalletClient } from 'viem';
 
 type TPjsApi = ApiPromise;
 type TPjsApiOrUrl = TApiOrUrl<TPjsApi>;
@@ -164,7 +165,7 @@ declare class EvmBuilderClass<TApi, TRes> {
      * @param signer - The Ethereum signer to authorize the transfer.
      * @returns An instance of EvmBuilder
      */
-    signer(signer: Signer): this;
+    signer(signer: Signer | WalletClient): this;
     /**
      * Builds and executes the transfer from Ethereum to Polkadot.
      *

package/dist/index.mjs

@@ -1181,22 +1181,31 @@ var PolkadotJsApi = /*#__PURE__*/function () {
     key: "disconnect",
     value: function () {
       var _disconnect = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee16() {
+        var force,
+          _args16 = arguments;
         return _regeneratorRuntime().wrap(function _callee16$(_context16) {
           while (1) switch (_context16.prev = _context16.next) {
             case 0:
-              if (this.disconnectAllowed) {
-                _context16.next = 2;
+              force = _args16.length > 0 && _args16[0] !== undefined ? _args16[0] : false;
+              if (this.initialized) {
+                _context16.next = 3;
                 break;
               }
-              return _context16.abrupt("return");
-            case 2:
-              if (!(typeof this._api === 'string' || this._api === undefined)) {
+              return _context16.abrupt("return", Promise.resolve());
+            case 3:
+              if (!(!force && !this.disconnectAllowed)) {
                 _context16.next = 5;
                 break;
               }
-              _context16.next = 5;
-              return this.api.disconnect();
+              return _context16.abrupt("return");
             case 5:
+              if (!(force || typeof this._api === 'string' || this._api === undefined)) {
+                _context16.next = 8;
+                break;
+              }
+              _context16.next = 8;
+              return this.api.disconnect();
+            case 8:
             case "end":
               return _context16.stop();
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraspell/sdk-pjs",
-  "version": "8.0.2",
+  "version": "8.1.0",
   "description": "Polkadot.js based SDK for ParaSpell XCM/XCMP tool for developers",
   "repository": {
     "type": "git",
@@ -11,9 +11,9 @@
   "type": "module",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     }
   },
   "main": "dist/index.cjs",
@@ -26,7 +26,7 @@
     "@snowbridge/api": "^0.1.25",
     "ethers": "^6.13.4",
     "viem": "^2.21.58",
-    "@paraspell/sdk-core": "8.0.2"
+    "@paraspell/sdk-core": "8.1.0"
   },
   "peerDependencies": {
     "@polkadot/api": ">= 15.0 < 16",