# @paraspell/sdk-pjs > Polkadot.js based SDK for ParaSpell XCM/XCMP tool for developers Latest version **14.3.4** (published 2026-09-07) · MIT license · 0 weekly downloads ## Install ```sh npm install @paraspell/sdk-pjs pnpm add @paraspell/sdk-pjs yarn add @paraspell/sdk-pjs bun add @paraspell/sdk-pjs ``` ## Health **Score 75/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 14.3.4 | | Published | 2026-09-07 | | First published | 2024-12-29 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 2 | | Unpacked size | 113.6 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 58 | | Maintainers | dudo50 | ## Links - npm: https://www.npmjs.com/package/@paraspell/sdk-pjs - Repository: https://github.com/paraspell/xcm-tools - npm.io page: https://npm.io/package/@paraspell/sdk-pjs ## Dependencies (2) - [@paraspell/sdk-core](https://npm.io/package/@paraspell/sdk-core.md) 14.3.4 - [@paraspell/sdk-common](https://npm.io/package/@paraspell/sdk-common.md) 14.3.4 ## Recent versions - 14.3.4 (latest) — 2026-09-07 - 14.1.0-rc.1 (rc) — 2026-07-30 - 11.14.13 (legacy) — 2026-01-13 - 14.3.3 — 2026-09-02 - 14.3.0 — 2026-08-31 - 14.2.2 — 2026-08-21 - 14.2.1 — 2026-08-21 - 14.2.0 — 2026-08-19 - 14.1.1 — 2026-08-07 - 14.1.0 — 2026-07-31 - 13.11.1 — 2026-07-31 - 14.1.0-rc — 2026-07-22 - 14.0.0 — 2026-07-20 - 13.11.0 — 2026-07-07 - 13.10.1 — 2026-07-03 - … 242 more at https://npm.io/package/@paraspell/sdk-pjs/versions ## README

@paraspell/sdk-pjs

SDK for handling XCM asset transfers across Polkadot, Kusama, Paseo and Westend ecosystems.

version downloads build

Supporting every XCM Active Parachain [list]

SDK documentation [here]





## Installation ### Install dependencies ParaSpell XCM SDK is the 🥇 in the ecosystem to support **PolkadotJS**, **Dedot** and **PolkadotAPI**. **This version of SDK uses PolkadotJS** if you wish to use **PolkadotAPI** version please reffer to [following package](https://github.com/paraspell/xcm-tools/tree/main/packages/sdk) or or **Dedot** please reffer to [following package](https://github.com/paraspell/xcm-tools/tree/main/packages/sdk-dedot).. ```bash #PolkadotJS peer dependencies npm install | pnpm add | yarn add @polkadot/api @polkadot/types @polkadot/api-base @polkadot/util @polkadot/util-crypto ``` ### Install SDK ```bash npm install | pnpm add | yarn add @paraspell/sdk-pjs ``` ### (OPTIONAL) Install Swap extension If you plan to [do Swap XCMs](https://paraspell.github.io/docs/xcm-sdk/send-xcm.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 */}; } ``` ### (OPTIONAL) Install EVM extension If you plan to [do EVM contract transfers](https://paraspell.github.io/docs/xcm-sdk/send-xcm.html#moonbeam-xtokens-smart-contract) you can install EVM package which allows you to interact with EVM contract based XCMs on Moonbeam, Moonriver and Darwinia. Available in **ALL** versions of SDK. ```bash npm install | pnpm add | yarn add @paraspell/evm ``` #### Setup EVM extension Add the `@paraspell/evm` import to your application's root component (Usually `App.tsx`). This ensures the extension is registered before using Builder. ```ts // Import EVM extension here import '@paraspell/evm'; export default function App() { return {/* Your app here */}; } ``` ### (OPTIONAL) Install Snowbridge extension If you plan to [do Snowbridge transfers from Ethereum](https://paraspell.github.io/docs/xcm-sdk/send-xcm.html#ethereum-polkadot-transfer) you can install Snowbridge package which allows you to input "Ethereum" as from chain parameter. Available in **ALL** versions of SDK. ```bash npm install | pnpm add | yarn add @paraspell/evm-snowbridge ``` #### Setup Snowbridge extension Add the `@paraspell/evm-snowbridge` import to your application's root component (Usually `App.tsx`). This ensures the extension is registered before using Builder. ```ts // Import Snowbridge extension here import '@paraspell/evm-snowbridge'; export default function App() { return {/* Your app here */}; } ``` ### Importing SDK functionality Named import: ```ts import { Builder } from '@paraspell/sdk-pjs' ``` Default import: ```ts // ESM import * as paraspell from '@paraspell/sdk-pjs' ``` ## Implementation > [!NOTE] > **Latest news:** > - V13 > V14 Migration guide: https://paraspell.github.io/docs/migration/v13-to-v14.html ### Sending XCM For full documentation on XCM Transfers head over to [official documentation](https://paraspell.github.io/docs/xcm-sdk/send-xcm.html). #### Transfer assets from Substrate to Substrate ```ts const builder = Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .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}, ..]) .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 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) await builder.disconnect() /* EXAMPLE: const builder = Builder() .from('AssetHubPolkadot') .to('Polkadot') .currency({ symbol: 'DOT', amount: '1' }) .recipient(address) const tx = await builder.build() //Disconnect API after TX await builder.disconnect() */ ``` #### Local transfers ```ts const builder = Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .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}, ..]) .recipient(address) /* .keepAlive(bool) - Optional: Allows draining the account below the existential deposit. */ const tx = await builder.build() //Make sure to disconnect the API after it is no longer used (eg, after a transaction) await builder.disconnect() /* EXAMPLE: const builder = Builder() .from('Hydration') .to('Hydration') .currency({ symbol: 'DOT', amount: '1' }) .recipient(address) const tx = await builder.build() //Disconnect API after TX await builder.disconnect() */ ``` #### Transact ```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/xcm-sdk/asset-package.html#import-chains-as-types .to(TChain) // Has to be same as origin (from) .currency(CURRENCY_SPEC) // Refer to currency spec options below .sender(sender | PAPI SIGNER) .recipient(address) .transact(hex, /* originType, TWeight - Optional */) const tx = await builder.build() // 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/xcm-sdk/asset-package.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/xcm-sdk/asset-package.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: ['AssetHubPolkadot'], - Optional parameter - 'Hydration' | 'Acala' | 'AssetHubPolkadot' | ... // slippage: 1, - Optional - 1 by default // evmSenderAddress: '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 const result = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .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*/}]}) /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in same fee asset as selected currency. .swap({ currencyTo: CURRENCY_SPEC, //Reffer to currency spec options above // exchange: ['AssetHubPolkadot'], - Optional parameter - 'Hydration' | 'Acala' | 'AssetHubPolkadot' | ... // slippage: 1, - Optional - 1 by default // evmSenderAddress: '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 })*/ .recipient(ADDRESS) .sender(address | {address, PJS_Signer}) .dryRun() //Check Parachain for DryRun support - returns true/false import { hasDryRunSupport } from "@paraspell/sdk"; const result = hasDryRunSupport(chain) ``` #### Dry run preview: ```ts //Builder pattern const result = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .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*/}]}) /*.feeAsset(CURRENCY) - Optional parameter when origin === AssetHubPolkadot and TX is supposed to be paid in same fee asset as selected currency.*/ .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.*/) ``` #### Batch calls ```ts const builder = Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .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 .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 .recipient(address | Location object) .addToBatch() 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 the API after it is no longer used (eg, after a transaction) await builder.disconnect() ``` #### Adding chain and/or assets SDK features ability to add custom chain and/or custom assets simply by adding its config to the Builder. ```ts const tx = await Builder({ // Adding custom chain customChains: { MyChain: { paraId: 4242, ecosystem: 'Polkadot', xcmVersion: Version.V5, providers: [{ name: 'Primary', endpoint: 'wss://rpc.mychain.example/ws' }], // Everything below is optional — auto-fetched from runtime `system.properties` when omitted nativeAssetSymbol: 'MYC', nativeAssetDecimals: 12, ss58Prefix: 42, pallets: { nativeAssets: "Balances”, otherAssets: "Assets", } assets: [ { symbol: 'USDC', decimals: 6, existentialDeposit: 100000000, //Needs to be in plancks location: { parents: 1, interior: { X3: [{ Parachain: 1000 }, { PalletInstance: 50 }, { GeneralIndex: 1337 }] } }, assetId: '1337' } ] } }, // Adding assets to existing chains customAssets: { AssetHubPolkadot: [ { symbol: 'MYNEWUSD', decimals: 6, assetId: '9999', existentialDeposit: 100000000, //Needs to be in plancks location: { parents: 0, interior: { X2: [{ PalletInstance: 50 }, { GeneralIndex: 9999 }] } } }, { // Replace an existing registry asset that shares the same location symbol: 'USDT', decimals: 6, assetId: '1984', existentialDeposit: 100000000, //Needs to be in plancks location: { parents: 0, interior: { X2: [{ PalletInstance: 50 }, { GeneralIndex: 1984 }] } }, forceOverride: true } ] } }) .from('MyChain') // custom chain name — TS-autocompletes .to('AssetHubPolkadot') // could be any of the existing or also the new ones added .currency({ symbol: 'USDC', amount: amount }) .recipient(address) .build() ``` ### Localhost test setup ```ts const builder = await Builder({ development: true, // Optional: Enforces overrides for all chains used decimalAbstraction: true // Abstracts decimals, so 1 as input amount equals 10_000_000_000 if selected asset is DOT. apiOverrides: { Hydration: // "wsEndpointString" | papiClient BridgeHubPolkadot: // "wsEndpointString" | papiClient //ChainName: ... } }) .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*/}]) .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 sender: //await builder.signAndSubmit() //Disconnect API after TX await builder.disconnect() ``` ### XCM Fee queries For full documentation with output examples of XCM Fee queries, head to [official documentation](https://paraspell.github.io/docs/xcm-sdk/xcm-utils.html). #### XCM Fee (Origin and Dest.) ```ts const fee = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) .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. .swap({ currencyTo: CURRENCY_SPEC, //Reffer to currency spec options above // exchange: ['AssetHubPolkadot'], - Optional parameter - 'Hydration' | 'Acala' | 'AssetHubPolkadot' | ... // slippage: 1, - Optional - 1 by default // evmSenderAddress: '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 })*/ .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. ``` #### XCM Fee (Origin only) ```ts const fee = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) .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.*/ .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. ``` #### XCM Transfer info ```ts const info = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) .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.*/ .recipient(RECIPIENT_ADDRESS) .sender(address | {address, PJS_Signer}) .getTransferInfo() ``` #### Transferable amount ```ts const transferable = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) .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. .swap({ currencyTo: CURRENCY_SPEC, //Reffer to currency spec options above // exchange: ['AssetHubPolkadot'], - Optional parameter - 'Hydration' | 'Acala' | 'AssetHubPolkadot' | ... // slippage: 1, - Optional - 1 by default // evmSenderAddress: '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 })*/ .recipient(RECIPIENT_ADDRESS) .sender(address | {address, PJS_Signer}) .getTransferableAmount() ``` #### Minimal transferable amount ```ts const transferable = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) .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. .swap({ currencyTo: CURRENCY_SPEC, //Reffer to currency spec options above // exchange: ['AssetHubPolkadot'], - Optional parameter - 'Hydration' | 'Acala' | 'AssetHubPolkadot' | ... // slippage: 1, - Optional - 1 by default // evmSenderAddress: '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 })*/ .recipient(RECIPIENT_ADDRESS) .sender(address | {address, PJS_Signer}) .getMinTransferableAmount() ``` #### Receivable amount ```ts const receivable = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) .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.*/ .recipient(RECIPIENT_ADDRESS) .sender(address | {address, PJS_Signer}) .getReceivableAmount() ``` #### Verify ED on destination ```ts const ed = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) .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.*/ .recipient(RECIPIENT_ADDRESS) .sender(address | {address, PJS_Signer}) .verifyEdOnDestination() ``` #### Get best amount out ```ts const result = await Builder(/*chain api/builder_config/ws_url_string/ws_url_array - optional*/) .from(TSubstrateChain) //'AssetHubPolkadot' | 'Hydration' | 'Moonbeam' | 'Polkadot' | ... https://paraspell.github.io/docs/xcm-sdk/asset-package.html#import-chains-as-types .to(TChain) //'AssetHubPolkadot' | 'Hydration' | 'Moonbeam' | 'Polkadot' | ... https://paraspell.github.io/docs/xcm-sdk/asset-package.html#import-chains-as-types .currency(CURRENCY_SPEC) .recipient(RECIPIENT_ADDRESS) .sender(SENDER_ADDRESS) .swap({ currencyTo: CURRENCY_SPEC, // exchange: ['AssetHubPolkadot'], - Optional parameter - 'Hydration' | 'Acala' | 'AssetHubPolkadot' | ... // slippage: 1, - Optional - 1 by default // evmSenderAddress: '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 }) .getBestAmountOut(); ``` #### Asset balance ```ts import { getBalance } from "@paraspell/sdk-pjs"; //Retrieves the asset balance for a given account on a specified chain (You do not need to specify if it is native or foreign). const balance = await getBalance({ADDRESS, TChain, CURRENCY_SPEC /*- {id: currencyID} | {symbol: currencySymbol} | {symbol: Native('currencySymbol')} | {symbol: Foreign('currencySymbol')} | {symbol: ForeignAbstract('currencySymbol')} | {location: AssetLocationString | AssetLocationJson}*/, api /* api/ws_url_string optional */}); ``` #### Ethereum bridge fees ```ts import { getParaEthTransferFees } from "@paraspell/sdk-pjs"; const fees = await getParaEthTransferFees(/*api - optional (Can also be WS port string or array o WS ports. Must be AssetHubPolkadot WS!)*/) ``` #### Existential deposit queries ```ts import { getExistentialDeposit } from "@paraspell/sdk-pjs"; //Currency is an optional parameter. If you wish to query native asset, currency parameter is not necessary. //Currency can be either {symbol: assetSymbol}, {id: assetId}, {location: assetLocation}. const ed = getExistentialDeposit(Tchain, CURRENCY_SPEC?) ``` #### Convert SS58 address ```ts import { convertSs58 } from "@paraspell/sdk-pjs"; let result = convertSs58(ADDRESS, TChain) // returns converted address in string ``` ### Asset queries: For full documentation with output examples of asset queries, head over to [official documentation](https://paraspell.github.io/docs/xcm-sdk/asset-package.html). ```ts 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) //Get reserve chain for specific asset on specific chain getAssetReserveChain(chain: TSubstrateChain, location: TLocation) //Find out whether asset is registered on chain and return its entire parameters. If not found, returns null. findAssetInfo(TChain, CURRENCY, DESTINATION?) //Find out whether asset is registered on chain and return its entire parameters. If not found, returns error. findAssetInfoOrThrow(TChain, CURRENCY, DESTINATION?) // Retrieve Fee asset queries (Assets accepted as XCM Fee on specific chain) getFeeAssets(TChain) // Get Location for asset ID or symbol on a specific chain 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 the symbol of the relay chain for a particular chain. Either "DOT" or "KSM" getRelayChainSymbol(TChain) // Retrieve string array of native assets symbols for a particular chain getNativeAssets(TChain) // Retrieve object array of foreign assets for a particular chain. Each object has a symbol and an assetId property getOtherAssets(TChain) // Retrieve string array of all asset symbols. (native and foreign assets are merged into a single array) getAllAssetsSymbols(TChain) // Get specific chain id getParaId(TChain) // Get specific TChain from chainID getTChain(paraID: number, ecosystem: 'Polkadot' | 'Kusama' | 'Ethereum' | 'Paseo' | 'Westend') //When the Ethereum ecosystem is selected, please fill chainID as 1 to select Ethereum. // Import all compatible chains as constant CHAINS ``` ### Parachain XCM Pallet queries For full documentation with output examples of pallet queries, head over to [official documentation](https://paraspell.github.io/docs/xcm-sdk/pallet-package.html). ```ts import { getDefaultPallet, getSupportedPallets, getPalletIndex, getNativeAssetsPallet, getOtherAssetsPallets, SUPPORTED_PALLETS } from '@paraspell/sdk-pjs'; //Retrieve default pallet for specific Parachain getDefaultPallet(chain: TChain) // Returns an array of supported pallets for a specific Parachain getSupportedPallets(chain: TChain) //Returns index of XCM Pallet used by Parachain getPalletIndex(chain: TChain) //Returns all pallets for local transfers of native assets for specific chain. getNativeAssetsPallet(chain: TChain) //Returns all pallets for local transfers of foreign assets for specific chain. getOtherAssetsPallets(chain: TChain) // Print all pallets that are currently supported console.log(SUPPORTED_PALLETS) ``` ### Import chains as types There are 6 options for types you can choose based on your prefference ```ts // Import all exchange chains (Swap) import type { TExchangeChain } from "@paraspell/sdk-pjs" // Import all Parachains import type { TParachain } from "@paraspell/sdk-pjs" // Import all Relay chains import type { TRelaychain } from "@paraspell/sdk-pjs" // Import all Substrate chains (Parachains + Relays) import type { TSubstrateChain } from "@paraspell/sdk-pjs" // Import chains outside Polkadot ecosystem (Ethereum) import type { TExternalChain } from "@paraspell/sdk-pjs" // Import all chains implemented in ParaSpell import type { TChain } from "@paraspell/sdk-pjs" ``` ### Import chains as constant There are 6 options for constants you can choose based on your prefference ```ts // Print all exchange chains (Swap) console.log(EXCHANGE_CHAINS) // Print all Parachains console.log(PARACHAINS) // Print all Relay chains console.log(RELAYCHAINS) // Print all Substrate chains (Parachains + Relays) console.log(SUBSTRATE_CHAINS) // Print chains outside Polkadot ecosystem (Ethereum) console.log(EXTERNAL_CHAINS) // Print all chains implemented in ParaSpell console.log(CHAINS) ``` ## 💻 Tests - Run compilation using `pnpm compile` - Run linter using `pnpm lint` - Run unit tests using `pnpm test` - Run end-to-end tests (SDK+SWAP) using `pnpm test:e2e` - Run all core tests and checks using `pnpm runAll` > [!NOTE] > XCM SDK can be tested in [Playground](https://playground.paraspell.xyz/xcm-sdk/xcm-transfer). ## Contribute to XCM Tools and earn rewards 💰 We run an open Bug Bounty Program that rewards contributors for reporting and fixing bugs in the project. More information on bug bounty can be found in the [official documentation](https://paraspell.github.io/docs/contribution-guidelines.html). ## Get Support 🚑 - Contact form on our [landing page](https://paraspell.xyz/#contact-us). - Message us on our [X](https://x.com/paraspell). - Support channel on [telegram](https://t.me/paraspell). ## License Made with 💛 by [ParaSpell✨](https://paraspell.xyz/) Published under [MIT License](https://github.com/paraspell/xcm-tools/blob/main/packages/sdk-pjs/LICENSE). ## Supported by

Shows a black logo in light color mode and a white one in dark color mode.

--- _Source: https://npm.io/package/@paraspell/sdk-pjs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._