Information

This package serves as a core component for both @paraspell/sdk and @paraspell/sdk-pjs and is automatically installed as a dependency. The package on its own offers functionality that can be imported separately and be used in front-end applications. It allows to retrieve asset data from compatible Parachains. Users can retrieve details like asset decimals, registered assets on particular Parachain, check if the asset is registered on Parachain and more.

Implementation

$3

``bash
pnpm | npm install || yarn add @paraspell/assets
`

$3

To use this functionality you first have to import it in the following way.

`ts
import { getSupportedDestinations, getSupportedAssets, getFeeAssets, getAssetsObject, getAssetId, getRelayChainSymbol, getNativeAssets, getNativeAssets, getOtherAssets, getAllAssetsSymbols, hasSupportForAsset, getAssetDecimals, getParaId, getTChain, getAssetLocation, TParachain, TRelaychain, TSubstrateChain, TExternalChain, TChain, findAssetInfo, findAssetInfoOrThrow } from '@paraspell/assets'
`




$3


This function returns assets object from assets.json for particular Parachain including information about native and foreign assets. Function uses TChain types.

`ts
getAssetsObject(TChain)
`

$3


This function returns assetId for particular Parachain and asset symbol. Function uses TChain types.

`ts
getAssetId(TChain, ASSET_SYMBOL)
`

$3


This function returns the symbol of the Relay chain for a particular Parachain. Either DOT or KSM or WND or PAS. Function uses TChain types.

`ts
getRelayChainSymbol(TChain)
`

$3


This function returns a string array of native assets symbols for a particular Parachain. Function uses TChain types.

`ts
getNativeAssets(TChain)
`

$3

This function returns an object array of foreign assets for a particular Parachain. Each object has a symbol and assetId property. Function uses TChain types.

`ts
getOtherAssets(TChain)
`

$3

Function returns string array of all asset symbols for a specific Parachain. (native and foreign assets are merged into a single array). Function uses TChain types.

`ts
getAllAssetsSymbols(TChain)
`

$3

The function checks if Parachain supports a particular asset. (Both native and foreign assets are searched). Returns boolean. Function uses TChain types.

`ts
hasSupportForAsset(TChain, ASSET_SYMBOL)
`

$3

The function returns decimals for a specific asset. Function uses TChain types.

`ts
getAssetDecimals(TChain, ASSET_SYMBOL)
`

$3

The function returns specific Parachain id. Function uses TChain types.

`ts
getParaId(TChain)
`

### Query asset data and support for specific chain I
Find out whether asset is registered on chain and return its entire parameters. If not found, returns null. Function uses TChain types.

`ts
findAssetInfo(TChain, ASSET_SYMBOL/, DESTINATION?/)
`

### Query asset data and support for specific chain II
Find out whether asset is registered on chain and return its entire parameters. If not found, returns error. Function uses TChain types.

`ts
findAssetInfoOrThrow(TChain, ASSET_SYMBOL/, DESTINATION?/)
`

$3

Function to get specific TChain from Parachain id.

`ts
getTChain(chainID: number, ecosystem: 'Polkadot' | 'Kusama' | 'Ethereum' | 'Paseo' | 'Westend') //When Ethereum ecosystem is selected please fill chainID as 1 to select Ethereum.
`

$3

There are 5 options for types you can choose based on your prefference

`ts
// Export all Parachains
console.log(TParachain)

// Export all Relay chains
console.log(TRelaychain)

// Export all Substrate chains (Parachains + Relays)
console.log(TSubstrateChain)

// Export chains outside Polkadot ecosystem (Ethereum)
console.log(TExternalChain)

// Export all chains implemented in ParaSpell
console.log(TChain)
`

$3

There are 5 options for constants you can choose based on your prefference

`ts
// Export all Parachains
console.log(PARACHAINS)

// Export all Relay chains
console.log(RELAYCHAINS)

// Export all Substrate chains (Parachains + Relays)
console.log(SUBSTRATE_CHAINS)

// Export chains outside Polkadot ecosystem (Ethereum)
console.log(EXTERNAL_CHAINS)

// Export all chains implemented in ParaSpell
console.log(CHAINS)
`

$3

Get location for asset id or symbol. Function uses TChain types.

`ts
getAssetLocation(TChain, { symbol: symbol } | { id: assetId })
`

💻 Tests

- Run compilation using pnpm compile

- Run linter using pnpm lint

- Run unit tests using pnpm test

- Update Parachain registered assets in the map using script - pnpm updateAssets

- Update existential deposits in the map using script - pnpm updateEds`

> [!NOTE]
> Asset queries can be tested in XCM Playground.

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.

Get Support 🚑

- Contact form on our landing page.
- Message us on our X.
- Support channel on telegram.

License

Made with 💛 by ParaSpell✨

Published under MIT License.

Supported by