Research
Security News
Threat Actor Exposes Playbook for Exploiting npm to Build Blockchain-Powered Botnets
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
@chain-registry/utils
Advanced tools
This module provides utility functions for working with the data in the chain-registry, focusing on asset and chain data management within the interchain ecosystem.
npm install @chain-registry/utils
Chain Utilities enable the retrieval and management of blockchain-specific data, such as chain names, chain IDs, and gas prices.
Import the functions from the package:
import {
getGasPriceRangesFromChain,
getChainByChainName,
getChainByChainId,
getChainNameByChainId,
getChainIdByChainName,
getChainGasPriceRanges,
getChainPrettyName,
getChainBech32Prefix
} from '@chain-registry/utils';
// import from chain-registry or your own Chain[]
import { chains } from 'chain-registry';
To retrieve a chain object by its name:
const chain = getChainByChainName(chains, 'osmosis');
// { chain_name: 'osmosis', ... }
To get the chain ID by its name:
const chainId = getChainIdByChainName(chains, 'osmosis');
// 'osmosis-1'
To get the pretty name of a chain:
const prettyName = getChainPrettyName(chains, 'osmosis');
// 'Osmosis'
To find the gas price ranges for a chain:
const gasPriceRanges = getChainGasPriceRanges(chains, 'osmosis');
// { low: number, average: number, high: number }
getGasPriceRangesFromChain
: Returns the gas price ranges (low, average, high) for a given chain.getChainByChainName
: Finds a chain by its name.getChainByChainId
: Retrieves a chain by its chain ID.getChainNameByChainId
: Gets the chain name associated with a given chain ID.getChainIdByChainName
: Fetches the chain ID for a specified chain name.getChainGasPriceRanges
: Provides the gas price ranges for a specified chain name.getChainPrettyName
: Returns the pretty (display) name of the chain.getChainBech32Prefix
: Gets the Bech32 prefix for a given chain.Asset Utilities facilitate access to details of blockchain assets, including denominations, symbols, and related chain data.
Import the functions from the package:
import {
getAssetByDenom,
getAssetBySymbol,
getChainLogo,
getChainNameByDenom,
getChainNameByStakingDenom,
getCoinGeckoIdByDenom,
getDenomByCoinGeckoId,
getDenomBySymbol,
getExponentByDenom,
getExponentBySymbol,
getNativeAssetByChainName,
getSymbolByDenom,
getAssetLogoByDenom,
getAssetNameByDenom
} from '@chain-registry/utils';
// import from chain-registry or your own AssetList[]
import { assets } from 'chain-registry';
To find an asset by its denomination:
const asset = getAssetByDenom(assets, 'uosmo', 'osmosis');
console.log(asset?.base); // 'uosmo'
To get the logo URL of a chain:
const logo = getChainLogo(assets, 'comdex');
console.log(logo); // 'https://raw.githubusercontent.com/cosmos/chain-registry/master/comdex/images/cmdx.png'
To retrieve the CoinGecko ID by asset denomination:
const coinGeckoId = getCoinGeckoIdByDenom(assets, 'uosmo');
console.log(coinGeckoId); // 'osmosis'
getAssetByDenom
: Retrieve an asset by its denomination.getAssetBySymbol
: Find an asset by its symbol.getChainLogo
: Get the logo URL of a chain.getChainNameByDenom
: Determine the chain name given an asset's denomination.getChainNameByStakingDenom
: Find the chain name by its staking token denomination.getCoinGeckoIdByDenom
: Get the CoinGecko ID associated with an asset denomination.getDenomByCoinGeckoId
: Find the denomination for an asset given its CoinGecko ID.getSymbolByDenom
: Retrieve the symbol associated with a denomination.getDenomBySymbol
: Get the denomination of an asset by its symbol.getExponentByDenom
: Find the exponent for a denomination.getExponentBySymbol
: Get the exponent for a symbol.getNativeAssetByChainName
: Retrieve the native token for a given chain name.getAssetLogoByDenom
: Get the logo URL for a token by its denomination.getAssetNameByDenom
: Find the name of a token by its denomination.IBC Utilities provide mechanisms to derive IBC denominations and trace IBC asset paths across multiple chains, enabling the management of inter-blockchain assets.
import {
getIbcAssetPath,
getIbcDenomByBase,
ibcDenom
} from '@chain-registry/utils';
// import from chain-registry or your own data
import { assets, ibc } from 'chain-registry';
To get the IBC denomination for a specific asset:
const denom = getIbcDenomByBase(ibc, 'osmosis', 'akash', assets, 'uakt');
// denom should be the IBC hashed denomination string
Example for AKT (Akash Token) on Osmosis:
const aktDenom = getIbcDenomByBase(ibc, 'osmosis', 'akash', assets, 'uakt');
console.log(aktDenom); // Expected: 'ibc/1480B8FD20AD5FCAE81EA87584D269547DD4D436843C1D20F15E00EB64743EF4'
Example for STARS (Stargaze Token) on Osmosis:
const starsDenom = getIbcDenomByBase(ibc, 'osmosis', 'stargaze', assets, 'ustars');
console.log(starsDenom); // Expected: 'ibc/987C17B11ABC2B20019178ACE62929FE9840202CE79498E29FE8E5CB02B7C0A4'
ibcDenom
: Generates the IBC denomination for an asset based on its transfer path.getIbcAssetPath
: Determines the path an asset takes across chains in the IBC network.getIbcDenomByBase
: Computes the IBC denomination for an asset from its base denomination.These functions provide utilities for converting asset units and calculating their values based on market data.
import {
mapCoinGeckoPricesToDenoms,
convertBaseUnitToDollarValue,
convertDollarValueToBaseUnit,
convertBaseUnitToDisplayUnit,
convertDisplayUnitToBaseUnit,
roundDown
} from '@chain-registry/utils';
This function maps prices obtained from CoinGecko to the corresponding denominations in the asset list, facilitating price-related calculations.
const priceMap = mapCoinGeckoPricesToDenoms(assets, coinGeckoPrices);
// priceMap will now contain a mapping of denominations to their USD prices
Convert an amount in the base unit of a specified asset to its dollar value using the provided price map.
const dollarValue = convertBaseUnitToDollarValue(assets, priceMap, 'OSMO', 1000000);
// dollarValue is the total value in USD of 1,000,000 base units of OSMO
Convert a dollar value into the base unit of the specified asset, based on the current price.
const baseUnit = convertDollarValueToBaseUnit(assets, priceMap, 'OSMO', 100);
// baseUnit is the amount in base units of OSMO that equals 100 USD
Converts an amount from the base unit to the display unit for the specified asset.
const displayUnit = convertBaseUnitToDisplayUnit(assets, 'OSMO', 1000000);
// displayUnit is the representation of 1,000,000 base units in display units (e.g., OSMO)
Converts an amount from the display unit to the base unit for the specified asset.
const baseUnit = convertDisplayUnitToBaseUnit(assets, 'OSMO', 1);
// baseUnit is the amount in base units that corresponds to 1 display unit (e.g., 1 OSMO)
Rounds down a number to the nearest integer, ensuring consistent lower-bound calculations in financial operations.
const rounded = roundDown(123.4567);
// rounded will be '123'
mapCoinGeckoPricesToDenoms
: Maps CoinGecko price data to asset denominations.convertBaseUnitToDollarValue
: Converts an amount in the base unit of an asset to its dollar value.convertDollarValueToBaseUnit
: Converts a dollar value into the base unit of a specified asset.convertBaseUnitToDisplayUnit
: Converts an amount from the base unit to the display unit of an asset.convertDisplayUnitToBaseUnit
: Converts an amount from the display unit to the base unit of an asset.roundDown
: Rounds down a number to the nearest integer.Checkout these related projects:
🛠 Built by Cosmology — if you like our tools, please consider delegating to our validator ⚛️
AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED “AS IS”, AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.
FAQs
Chain Registry Utils
The npm package @chain-registry/utils receives a total of 11,104 weekly downloads. As such, @chain-registry/utils popularity was classified as popular.
We found that @chain-registry/utils demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.