@getpara/shared 1.6.0 → 1.8.0

package/dist/esm/utils/assets.js

@@ -25,22 +25,124 @@ export function formatCurrency(value, { fallback = '' } = {}) {
 }
 export function formatAssetQuantity({ quantity, symbol = '', decimals, fallback = '', }) {
     try {
-        if (quantity == null) {
+        if (quantity === undefined || isNaN(Number(quantity))) {
             return fallback;
         }
+        const num = Number(quantity);
         const formatter = new Intl.NumberFormat('en-US', {
             style: 'decimal',
-            maximumFractionDigits: decimals ?? (Math.abs(quantity) < 0.001 ? 6 : 3),
-            minimumFractionDigits: decimals ?? 3,
+            maximumFractionDigits: decimals ?? (Math.abs(num) < 0.001 ? 6 : 3),
+            minimumFractionDigits: 0,
         });
         const formattedQuantity = quantity === 0
             ? '0'
-            : Math.abs(quantity) < 10 ** (-1 * (decimals ?? 6))
+            : Math.abs(num) < 10 ** (-1 * (decimals ?? 6))
                 ? zeroAssetFormatter.format(0)
-                : formatter.format(quantity);
+                : formatter.format(num);
         return `${formattedQuantity}${symbol && symbol.length > 0 ? ` ${symbol}` : ''}`;
     }
     catch (_e) {
         return fallback;
     }
 }
+const buildCustomAssetId = (symbol) => `custom_${symbol}`;
+const isNonNullable = (value) => value !== null;
+export function filterWalletBalance(balance, config) {
+    if (config.isComprehensive) {
+        return balance;
+    }
+    const requestType = config.requestType ?? 'MAINNET';
+    let filteredAssets = balance.assets;
+    let filteredNetworks = balance.networks;
+    if (requestType !== 'MAINNET_AND_TESTNET') {
+        const includeTestnet = requestType === 'TESTNET';
+        filteredAssets = balance.assets
+            .map((asset) => {
+            const filteredAssetNetworks = asset.networks.filter((network) => {
+                const networkIsTestnet = network.metadata?.isTestnet ?? false;
+                return includeTestnet ? networkIsTestnet : !networkIsTestnet;
+            });
+            if (filteredAssetNetworks.length === 0) {
+                return null;
+            }
+            const quantity = filteredAssetNetworks.reduce((sum, n) => sum + n.quantity, 0);
+            const value = filteredAssetNetworks.reduce((sum, n) => sum + (n.value?.value ?? 0), 0);
+            return {
+                ...asset,
+                quantity,
+                networks: filteredAssetNetworks,
+                ...(asset.value ? { value: { value, currency: asset.value.currency } } : {}),
+            };
+        })
+            .filter(isNonNullable);
+        filteredNetworks = balance.networks
+            .map((network) => {
+            const networkIsTestnet = network.metadata?.isTestnet ?? false;
+            if (includeTestnet !== networkIsTestnet) {
+                return null;
+            }
+            const value = network.assets.reduce((sum, a) => sum + (a.value?.value ?? 0), 0);
+            return {
+                ...network,
+                assets: network.assets,
+                ...(network.value ? { value: { value, currency: network.value.currency } } : {}),
+            };
+        })
+            .filter(isNonNullable);
+    }
+    if (config.displayType === 'AGGREGATED' && config.excludeStandardAssets) {
+        filteredAssets = filteredAssets.filter((asset) => asset.metadata?.customAssetId !== undefined);
+        filteredNetworks = filteredNetworks
+            .map((network) => {
+            const filteredNetworkAssets = network.assets.filter((asset) => asset.metadata?.customAssetId !== undefined);
+            if (filteredNetworkAssets.length === 0) {
+                return null;
+            }
+            const value = filteredNetworkAssets.reduce((sum, a) => sum + (a.value?.value ?? 0), 0);
+            return {
+                ...network,
+                assets: filteredNetworkAssets,
+                ...(network.value ? { value: { value, currency: network.value.currency } } : {}),
+            };
+        })
+            .filter(isNonNullable);
+    }
+    if (config.displayType === 'CUSTOM_ASSET') {
+        const targetCustomAssetId = buildCustomAssetId(config.asset.symbol);
+        const matchesCustomAsset = (metadata) => {
+            if (metadata?.customAssetId) {
+                return metadata.customAssetId === targetCustomAssetId;
+            }
+            return metadata?.symbol === config.asset.symbol;
+        };
+        filteredAssets = filteredAssets.filter((asset) => matchesCustomAsset(asset.metadata));
+        filteredNetworks = filteredNetworks
+            .map((network) => {
+            const matchingAssets = network.assets.filter((asset) => matchesCustomAsset(asset.metadata));
+            if (matchingAssets.length === 0) {
+                return null;
+            }
+            return {
+                ...network,
+                assets: matchingAssets,
+            };
+        })
+            .filter(isNonNullable);
+    }
+    const totalValue = filteredAssets.reduce((sum, asset) => sum + (asset.value?.value ?? 0), 0);
+    return {
+        ...balance,
+        assets: filteredAssets,
+        networks: filteredNetworks,
+        ...(balance.value ? { value: { value: totalValue, currency: balance.value.currency } } : {}),
+    };
+}
+export function filterProfileBalance(balance, config) {
+    const filteredWallets = balance.wallets.map((wallet) => filterWalletBalance(wallet, config));
+    const totalValue = filteredWallets.reduce((sum, wallet) => sum + (wallet.value?.value ?? 0), 0);
+    return {
+        ...balance,
+        wallets: filteredWallets,
+        ...(balance.value ? { value: { value: totalValue, currency: balance.value.currency } } : {}),
+    };
+}

package/dist/esm/utils/index.js

@@ -1,15 +1,425 @@
 export const NETWORK_METADATA = [
-    { evmChainId: '11155111', internalId: 'SEPOLIA', zerionId: 'ethereum-sepolia', name: 'Sepolia' },
-    { evmChainId: '1', internalId: 'ETHEREUM', zerionId: 'ethereum', name: 'Ethereum' },
-    { evmChainId: '137', internalId: 'POLYGON', zerionId: 'polygon', name: 'Polygon' },
-    { evmChainId: '42220', internalId: 'CELO', zerionId: 'celo', name: 'Celo' },
-    { evmChainId: '8453', internalId: 'BASE', zerionId: 'base', name: 'Base' },
-    { evmChainId: '42161', internalId: 'ARBITRUM', zerionId: 'arbitrum', name: 'Arbitrum' },
-    { evmChainId: '10', internalId: 'OPTIMISM', zerionId: 'optimism', name: 'Optimism' },
-    { evmChainId: '80094', internalId: 'BERACHAIN', zerionId: 'berachain', name: 'Berachain' },
-    { internalId: 'SOLANA', name: 'Solana' },
-    { internalId: 'SOLANA_DEVNET', name: 'Solana Devnet' },
-    { internalId: 'COSMOS', name: 'Cosmos' },
+    {
+        type: 'EVM',
+        evmChainId: '11155111',
+        internalId: 'SEPOLIA',
+        zerionId: 'ethereum-sepolia',
+        name: 'Ethereum Sepolia',
+        alchemySlug: 'eth-sepolia',
+    },
+    {
+        type: 'EVM',
+        evmChainId: '1',
+        internalId: 'ETHEREUM',
+        zerionId: 'ethereum',
+        name: 'Ethereum',
+        alchemySlug: 'eth-mainnet',
+    },
+    {
+        type: 'EVM',
+        evmChainId: '137',
+        internalId: 'POLYGON',
+        zerionId: 'polygon',
+        name: 'Polygon',
+        alchemySlug: 'polygon-mainnet',
+    },
+    {
+        type: 'EVM',
+        evmChainId: '42220',
+        internalId: 'CELO',
+        zerionId: 'celo',
+        name: 'Celo',
+        alchemySlug: 'celo-mainnet',
+    },
+    {
+        type: 'EVM',
+        evmChainId: '8453',
+        internalId: 'BASE',
+        zerionId: 'base',
+        name: 'Base',
+        alchemySlug: 'base-mainnet',
+    },
+    {
+        type: 'EVM',
+        evmChainId: '42161',
+        internalId: 'ARBITRUM',
+        zerionId: 'arbitrum',
+        name: 'Arbitrum',
+        alchemySlug: 'arb-mainnet',
+    },
+    {
+        type: 'EVM',
+        evmChainId: '10',
+        internalId: 'OPTIMISM',
+        zerionId: 'optimism',
+        name: 'Optimism',
+        alchemySlug: 'opt-mainnet',
+    },
+    {
+        type: 'EVM',
+        evmChainId: '80094',
+        internalId: 'BERACHAIN',
+        zerionId: 'berachain',
+        name: 'Berachain',
+        alchemySlug: 'bera-mainnet',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'binance-smart-chain',
+        evmChainId: '56',
+        name: 'Binance Smart Chain',
+        alchemySlug: 'bsc-mainnet',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'tron',
+        evmChainId: '728126428',
+        name: 'Tron',
+        alchemySlug: 'tron-mainnet',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'blast',
+        evmChainId: '81457',
+        name: 'Blast',
+        alchemySlug: 'blast-mainnet',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'ape',
+        evmChainId: '33139',
+        name: 'Ape',
+        alchemySlug: 'ape-mainnet',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'cronos-zkevm',
+        evmChainId: '388',
+        name: 'Cronos ZK-EVM',
+    },
+    {
+        type: 'EVM',
+        zerionId: '0g',
+        evmChainId: '16661',
+        name: 'Harmony',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'opbnb',
+        evmChainId: '204',
+        alchemySlug: 'opbnb-mainnet',
+        name: 'Optimism Nova',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'abstract',
+        evmChainId: '2741',
+        alchemySlug: 'abstract-mainnet',
+        name: 'Abstract',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'avalanche',
+        evmChainId: '43114',
+        alchemySlug: 'avax-mainnet',
+        name: 'Avalanche',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'zksync-era',
+        evmChainId: '324',
+        alchemySlug: 'zksync-mainnet',
+        name: 'ZKSync Era',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'mantle',
+        evmChainId: '5000',
+        alchemySlug: 'mantle-mainnet',
+        name: 'Mantle',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'bob',
+        evmChainId: '60808',
+        alchemySlug: 'bob-mainnet',
+        name: 'Bob',
+    },
+    { type: 'EVM', zerionId: 'cyber', evmChainId: '7560' },
+    {
+        type: 'EVM',
+        zerionId: 'degen',
+        evmChainId: '666666666',
+        alchemySlug: 'degen-mainnet',
+        name: 'Degen',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'manta-pacific',
+        evmChainId: '169',
+        name: 'Manta Pacific',
+    },
+    { type: 'EVM', zerionId: 'fantom', evmChainId: '250', name: 'Fantom' },
+    {
+        type: 'EVM',
+        zerionId: 'ronin',
+        evmChainId: '2020',
+        alchemySlug: 'ronin-mainnet',
+        name: 'Ronin',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'linea',
+        evmChainId: '59144',
+        alchemySlug: 'linea-mainnet',
+        name: 'Linea',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'metis-andromeda',
+        evmChainId: '1088',
+        alchemySlug: 'metis-mainnet',
+        name: 'Metis Andromeda',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'aurora',
+        evmChainId: '1313161554',
+        name: 'Aurora',
+    },
+    { type: 'EVM', zerionId: 'xinfin-xdc', evmChainId: '50' },
+    {
+        type: 'EVM',
+        zerionId: 'fraxtal',
+        evmChainId: '252',
+        alchemySlug: 'frax-mainnet',
+        name: 'Frax',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'gravity-alpha',
+        evmChainId: '1625',
+        name: 'Gravity Alpha',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'hyperevm',
+        evmChainId: '999',
+        alchemySlug: 'hyperliquid-mainnet',
+        name: 'Hyperliquid',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'ink',
+        evmChainId: '57073',
+        alchemySlug: 'ink-mainnet',
+        name: 'Ink',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'lens',
+        evmChainId: '232',
+        alchemySlug: 'lens-mainnet',
+        name: 'Lens',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'lisk',
+        evmChainId: '1135',
+        name: 'Lisk',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'mode',
+        evmChainId: '34443',
+        alchemySlug: 'mode-mainnet',
+        name: 'Mode',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'plasma',
+        evmChainId: '9745',
+        alchemySlug: 'plasma-mainnet',
+        name: 'Plasma',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'polygon-zkevm',
+        evmChainId: '1101',
+        alchemySlug: 'polygonzkevm-mainnet',
+        name: 'Polygon ZK-EVM',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'polynomial',
+        evmChainId: '8008',
+        name: 'Polynomial',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'rari',
+        evmChainId: '1380012617',
+        name: 'Rari',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'redstone',
+        evmChainId: '690',
+        name: 'Redstone',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'scroll',
+        evmChainId: '534352',
+        alchemySlug: 'scroll-mainnet',
+        name: 'Scroll',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'sei',
+        evmChainId: '1329',
+        alchemySlug: 'sei-mainnet',
+        name: 'Sei',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'somnia',
+        evmChainId: '5031',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'soneium',
+        evmChainId: '1868',
+        alchemySlug: 'soneium-mainnet',
+        name: 'Soneium',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'sonic',
+        evmChainId: '146',
+        alchemySlug: 'sonic-mainnet',
+        name: 'Sonic',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'swellchain',
+        evmChainId: '1923',
+        name: 'Swellchain',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'taiko',
+        evmChainId: '167000',
+        alchemySlug: 'taiko-mainnet',
+        name: 'Taiko',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'unichain',
+        evmChainId: '130',
+        alchemySlug: 'uni-mainnet',
+        name: 'Unichain',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'wonder',
+        evmChainId: '9637',
+        name: 'Wonder',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'tomochain',
+        evmChainId: '88',
+        name: 'Tomochain',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'world',
+        evmChainId: '480',
+        alchemySlug: 'world-mainnet',
+        name: 'Worldchain',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'zero',
+        evmChainId: '543210',
+        name: 'Zero',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'okbchain',
+        evmChainId: '196',
+        name: 'OKBChain',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'zkcandy',
+        evmChainId: '320',
+        name: 'ZKCandy',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'zklink-nova',
+        evmChainId: '810180',
+        name: 'ZKLink Nova',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'zora',
+        evmChainId: '7777777',
+        alchemySlug: 'zora-mainnet',
+        name: 'Zora',
+    },
+    {
+        type: 'EVM',
+        zerionId: 're-al',
+        evmChainId: '111188',
+        name: 'Re-Al',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'katana',
+        evmChainId: '747474',
+        name: 'Katana',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'monad-test-v2',
+        evmChainId: '10143',
+        name: 'Monad Testnet',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'unichain-sepolia',
+        evmChainId: '1301',
+        name: 'Unichain Sepolia',
+    },
+    {
+        type: 'EVM',
+        zerionId: 'zero-sepolia-v2',
+        evmChainId: '43210',
+        name: 'Zero Sepolia V2',
+    },
+    {
+        type: 'SOLANA',
+        internalId: 'SOLANA',
+        zerionId: 'solana',
+        alchemySlug: 'solana-mainnet',
+        name: 'Solana',
+    },
+    {
+        type: 'SOLANA',
+        internalId: 'SOLANA_DEVNET',
+        alchemySlug: 'solana-devnet',
+        logoUrl: 'https://cdn.zerion.io/11111111111111111111111111111111.png',
+        explorer: {
+            name: 'Solana Explorer',
+            url: 'https://explorer.solana.com/?cluster=devnet',
+            txUrlFormat: 'https://explorer.solana.com/tx/{HASH}?cluster=devnet',
+        },
+        name: 'Solana Devnet',
+    },
+    { type: 'COSMOS', internalId: 'COSMOS', name: 'Cosmos' },
 ];
 export function getChainId(network) {
     return NETWORK_METADATA.find(({ internalId: n }) => n === network)?.evmChainId ?? undefined;

package/dist/types/index.d.ts

@@ -1,3 +1,5 @@
 export * from './types/index.js';
 export * from './utils/index.js';
+import * as transactionTypes from './types/transaction.js';
+export { transactionTypes };
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,KAAK,gBAAgB,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/types/types/assets.d.ts

@@ -120,7 +120,7 @@ export type AssetMetadata<Currency extends string = 'USD'> = {
      */
     symbol: string;
     /**
-     * The URL for the asset's icon logo.
+     * The URL for the asset's icon logo image.
      */
     logoUrl?: string;
     /**
@@ -150,10 +150,26 @@ export type NetworkMetadata = {
      * The display name for the network.
      */
     name?: string;
+    /**
+     * The URL for the network's logo image.
+     */
+    logoUrl?: string;
     /**
      * The EVM chain ID for the network, if applicable.
      */
     evmChainId?: `${number}`;
+    /**
+     * The RPC URL for the network.
+     */
+    rpcUrl?: string;
+    /**
+     * Template Explorer URL for transactions with {HASH} placeholder.
+     */
+    explorer?: BlockchainExplorer;
+    /**
+     * Whether the network is a testnet.
+     */
+    isTestnet?: boolean;
 };
 type WithAssetMetadata = {
     /**
@@ -225,6 +241,20 @@ export type ProfileBalance<Currency extends string = 'USD'> = WithAssetValue<Cur
      */
     formattedValue: string;
 };
+export type BlockchainExplorer = {
+    /**
+     * The name of the blockchain explorer.
+     */
+    name: string;
+    /**
+     * The homepage URL of the blockchain explorer.
+     */
+    url: string;
+    /**
+     * An explorer URL template for broadcast transactions, using `{HASH}` as the placeholder for the transaction hash. Example: `https://etherscan.io/tx/{HASH}`
+     */
+    txUrlFormat?: string;
+};
 export type CustomNetwork = Omit<NetworkMetadata, 'internalId' | 'zerionId' | 'evmChainId'> & {
     /**
      * The EVM chain ID for the network.
@@ -234,13 +264,17 @@ export type CustomNetwork = Omit<NetworkMetadata, 'internalId' | 'zerionId' | 'e
      * The EVM RPC URL for the network.
      */
     rpcUrl: string;
+    /**
+     * An explorer URL template for broadcast transactions, using `{HASH}` as the placeholder for the transaction hash. Example: `https://etherscan.io/tx/{HASH}`
+     */
+    explorer?: string;
 };
 export type NativeImplementation = {
     contractAddress?: undefined;
     /**
      * The custom network definition.
      */
-    network: CustomNetwork;
+    network: TNetwork | CustomNetwork;
 };
 export type NonNativeImplementation = Required<WithContractAddress> & {
     /**
@@ -265,6 +299,7 @@ export type CustomAsset<Currency extends string = 'USD'> = Omit<AssetMetadata<Cu
     price?: AssetValue<Currency>;
 };
 export type BalanceDisplayType = 'AGGREGATED' | 'CUSTOM_TOKEN';
+export type BalancesRequestType = 'MAINNET' | 'TESTNET' | 'MAINNET_AND_TESTNET';
 export type BalancesConfig<Currency extends string = 'USD'> = {
     /**
      * The type of balance data to display.
@@ -273,6 +308,14 @@ export type BalancesConfig<Currency extends string = 'USD'> = {
      * - `'CUSTOM_ASSET'` will display only the quantities of the asset you specify, without any currency conversion.
      */
     displayType: 'AGGREGATED' | 'CUSTOM_ASSET';
+    /**
+     * The type of assets to include in the balance calculation. Defaults to 'MAINNET'.
+     *
+     * - `'MAINNET'` will include all available mainnet assets only.
+     * - `'TESTNET'` will include all available testnet assets only. They will be treated as having zero fiat value.
+     * - `'MAINNET_AND_TESTNET'` will include both mainnet and testnet assets.
+     */
+    requestType?: BalancesRequestType;
 } & ({
     displayType: 'AGGREGATED';
     /**