@liberfi.io/utils 0.1.24 → 0.1.25

package/README.md

@@ -0,0 +1,290 @@
+# @liberfi.io/utils
+
+Framework-agnostic utility library for the Liberfi React SDK monorepo. Provides number/currency formatting, chain metadata, HTTP helpers, date/time formatting, token registries, URL builders, and string utilities. Consumed by all UI and integration packages in the monorepo.
+
+## Design Philosophy
+
+- **Pure functions** — All exports are stateless, side-effect-free functions (except `version` registration). No React, no DOM.
+- **Tiered precision formatting** — Number formatters automatically select decimal places and abbreviation based on magnitude, matching financial UI conventions.
+- **Single source of truth for chain data** — Chain slugs, colors, icons, and address validation live here so UI packages don't duplicate chain logic.
+- **Minimal dependencies** — Only `bignumber.js` for precision math, `lodash-es` for common utilities, and `@solana/kit` for Solana address validation.
+
+## Installation
+
+```bash
+pnpm add @liberfi.io/utils
+```
+
+Peer dependencies: none (all dependencies are direct).
+
+## API Reference
+
+### Number Formatting
+
+#### `SafeBigNumber`
+
+A `BigNumber` subclass that never throws on construction. Invalid/undefined values fall back to `0`.
+
+```typescript
+new SafeBigNumber(value?: BigNumber.Value, base?: number)
+```
+
+#### `isValidNumber(num: unknown): boolean`
+
+Returns `true` if `num` is a finite number, numeric string, or `BigNumber`/`SafeBigNumber` instance.
+
+#### `formatAmount(num, options?): string`
+
+Format a raw token/asset amount (no currency symbol). Precision auto-selects by magnitude.
+
+```typescript
+formatAmount(num: BigNumber.Value, options?: FormatAmountOptions): string
+```
+
+| Option               | Type      | Default | Description                     |
+| -------------------- | --------- | ------- | ------------------------------- |
+| `showPlusGtThanZero` | `boolean` | `false` | Prefix positive values with "+" |
+
+#### `formatAmountUSD(num, options?): string`
+
+Format a USD amount with `$` prefix. Standard precision tiers.
+
+#### `formatAmountUSDCompact(num, options?): string`
+
+Compact USD formatting — more aggressive rounding, suited for space-constrained UIs.
+
+#### `formatPriceUSD(num, options?): string`
+
+Format a token price with `$` prefix. Supports high-precision and low-precision modes.
+
+```typescript
+formatPriceUSD(num: BigNumber.Value, options?: FormatPriceOptions): string
+```
+
+| Option          | Type      | Default | Description                            |
+| --------------- | --------- | ------- | -------------------------------------- |
+| `isHighPrecise` | `boolean` | `true`  | Use high-precision mode (4 dp vs 2 dp) |
+
+#### `formatPercent(num, options?): string`
+
+Format a ratio as percentage (0.3 = 30%).
+
+```typescript
+formatPercent(num: BigNumber.Value, options?: FormatPercentOptions): string
+```
+
+| Option               | Type      | Default | Description                     |
+| -------------------- | --------- | ------- | ------------------------------- |
+| `showPlusGtThanZero` | `boolean` | `false` | Prefix positive values with "+" |
+| `precision`          | `number`  | `2`     | Decimal precision override      |
+
+### Chain Utilities
+
+#### `chainToNamespace(chain: Chain): ChainNamespace`
+
+Returns `ChainNamespace.SOLANA` or `ChainNamespace.EVM` for a given chain.
+
+#### `chainSlug(chainId: Chain): string | undefined`
+
+Returns the lowercase slug (e.g. `"ethereum"`, `"solana"`).
+
+#### `chainDisplayName(chainId: Chain): string`
+
+Returns a display-friendly name. Uses abbreviation if available (e.g. `"ETH"`, `"BSC"`), otherwise title-cases the slug.
+
+#### `chainColor(chainId: Chain): string | undefined`
+
+Returns the brand hex color for a chain.
+
+#### `chainIcon(chain: Chain | string): string | undefined`
+
+Returns a llamao.fi icon URL for the chain.
+
+#### `chainIdBySlug(slug: string): Chain | undefined`
+
+Reverse lookup — resolves a slug or abbreviation to a `Chain` enum value. Case-insensitive.
+
+#### `isValidEvmAddress(value: string): boolean`
+
+Validates a `0x`-prefixed 40-hex-character EVM address.
+
+#### `isValidSolanaAddress(value: string): boolean`
+
+Validates a Solana base58 address using `@solana/kit`.
+
+#### `isValidWalletAddress(chain: Chain | string, addr: string): boolean`
+
+Dispatches to the correct validator based on the chain's namespace.
+
+### Date/Time Formatting
+
+#### `formatAgeInSeconds(age: number, options?): string`
+
+Formats elapsed time in seconds to a compact string (`"just now"`, `"45s"`, `"2m"`, `"3h"`, `"5d"`, `"1y"`).
+
+#### `formatAge(age: number, options?): string`
+
+Same as `formatAgeInSeconds` but accepts milliseconds.
+
+```typescript
+interface FormatAgeOptions {
+  justNow?: string;
+  secondsAgo?: string; // use {n} placeholder
+  minutesAgo?: string;
+  hoursAgo?: string;
+  daysAgo?: string;
+  yearsAgo?: string;
+}
+```
+
+### HTTP Helpers
+
+#### `httpRequest<R>(url: string, options: RequestInit): Promise<R>`
+
+Core HTTP function. Throws `ApiError` for 400 responses, `Error` for other failures.
+
+#### `httpGet<R>(url, options?): Promise<R>`
+
+#### `httpPost<R, P>(url, data, options?): Promise<R>`
+
+#### `httpPut<R, P>(url, data, options?): Promise<R>`
+
+#### `httpDelete<R>(url, options?): Promise<R>`
+
+#### `httpMutate<R>(url, init): Promise<R>`
+
+### URL Builders
+
+#### `txExplorerUrl(chainId: Chain, txHash: string): string | undefined`
+
+Returns a block explorer URL for a transaction hash.
+
+#### `accountExplorerUrl(chainId: Chain, account: string): string | undefined`
+
+Returns a block explorer URL for an account/address.
+
+#### `searchImageUrl(image: string): string`
+
+Google Lens reverse image search URL.
+
+#### `searchTwitterUrl(q: string): string`
+
+X/Twitter search URL.
+
+#### `twitterUserUrl(username: string): string`
+
+#### `twitterTweetUrl(id: string): string`
+
+### String Utilities
+
+#### `capitalize(str: string): string`
+
+Capitalizes the first letter, lowercases the rest.
+
+#### `truncateAddress(address: string, start?: number, end?: number): string`
+
+Truncates a string with `...` in the middle. Defaults: `start=6`, `end=4`.
+
+### Symbol Formatting
+
+#### `formatSymbol(symbol: string, formatString?: string): string`
+
+Formats a trading pair symbol (`"PERP_BTC_USDT"`) using a template string with `type`, `base`, `quote` placeholders. Default format: `"base-type"`.
+
+### Token Protocols
+
+#### `parseTokenProtocolFamily(chain: Chain, protocolFamily: string): TokenProtocol | undefined`
+
+Parses a protocol family string to a known `TokenProtocol` (Solana only).
+
+#### `formatTokenProtocolName(protocol: TokenProtocol): string`
+
+Formats a protocol slug to display name (e.g. `"pump-amm"` → `"Pump Amm"`).
+
+### Token Registry
+
+#### `getNativeToken(chain: Chain): PredefinedToken | undefined`
+
+#### `getWrappedToken(chain: Chain): PredefinedToken | undefined`
+
+#### `getStablecoins(chain: Chain): Record<string, PredefinedToken> | undefined`
+
+#### `getCommonTokenAddresses(chain: Chain): string[]`
+
+#### `getCommonTokenSymbolsMap(chain: Chain): Record<string, string>`
+
+### Types
+
+- `FormatAmountOptions` — `{ showPlusGtThanZero: boolean }`
+- `FormatPriceOptions` — `{ isHighPrecise: boolean }`
+- `FormatPercentOptions` — `{ showPlusGtThanZero?: boolean; precision?: number }`
+- `FormatAgeOptions` — i18n label overrides for age formatting
+- `PredefinedToken` — `{ address: string; symbol: string; decimals: number }`
+- `ChainPredefinedTokens` — `{ native, wrapped, stablecoins }`
+- `ApiError` — Error subclass with `code: number`
+
+### Constants
+
+- `SOLANA_TOKENS`, `ETHEREUM_TOKENS`, `BSC_TOKENS`, `ARBITRUM_TOKENS`, `OPTIMISM_TOKENS`, `AVALANCHE_TOKENS` — Per-chain token registries
+- `CHAIN_TOKENS` — `Partial<Record<Chain, ChainPredefinedTokens>>`
+- `version` — Package version string
+
+### Re-exported from lodash-es
+
+`throttle`, `debounce`, `uniqBy`, `intersectionBy`, `keyBy`, `groupBy`, `mapKeys`, `mapValues`
+
+## Usage Examples
+
+### Number formatting
+
+```tsx
+import {
+  formatAmount,
+  formatAmountUSD,
+  formatPriceUSD,
+  formatPercent,
+} from "@liberfi.io/utils";
+
+formatAmount(1_500_000); // "1.5M"
+formatAmountUSD(42.678); // "$42.67"
+formatPriceUSD(0.0000382); // "$0.0₄382"
+formatPercent(0.3); // "30%"
+formatPercent(-0.05, { showPlusGtThanZero: true }); // "-5%"
+```
+
+### Chain utilities
+
+```tsx
+import { Chain } from "@liberfi.io/types";
+import {
+  chainDisplayName,
+  chainIcon,
+  isValidWalletAddress,
+} from "@liberfi.io/utils";
+
+chainDisplayName(Chain.ETHEREUM); // "ETH"
+chainIcon(Chain.SOLANA); // "https://icons.llamao.fi/icons/chains/rsz_solana.jpg"
+isValidWalletAddress(
+  Chain.ETHEREUM,
+  "0x1234567890abcdef1234567890abcdef12345678",
+); // true
+```
+
+### Date formatting
+
+```tsx
+import { formatAge } from "@liberfi.io/utils";
+
+formatAge(120000); // "2m"
+formatAge(120000, { minutesAgo: "{n} 分钟前" }); // "2 分钟前"
+```
+
+## Future Improvements
+
+- Extract shared formatting logic in `number.ts` to reduce DRY violations across `formatAmount` / `formatAmountUSD` / `formatAmountUSDCompact`.
+- Replace `any` defaults with `unknown` in `fetch.ts` generic type parameters.
+- Remove catch-rethrow antipattern in `fetch.ts` error handling.
+- Move `version.ts` window side effect to opt-in registration or provider initialization.
+- Consolidate chain metadata (`chainSlugs`, `chainSlugAbbrs`, `chainColors`) into a single structured registry.
+- Add grouping separators to `stringifyPercent` for large percentage values.
+- Extend `ApiError` with HTTP status code and response body fields.

package/dist/index.d.mts

@@ -9,7 +9,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.24";
+declare const _default: "0.1.25";
 
 /** Returns the chain namespace (EVM or SOLANA) for a given chain */
 declare function chainToNamespace(chain: Chain): ChainNamespace;
@@ -27,12 +27,7 @@ declare class ApiError extends Error {
     constructor(message: string, code: number);
 }
 
-declare const millisecondsToHMS: (milliseconds: number) => [number, number, number];
-declare const timestampToString: (timestamp: number | Date) => string;
-declare function subtractDaysFromCurrentDate(days: number, startDate?: Date): Date;
-declare function formatTimeAgo(date: number | string | Date | null | undefined): string;
-declare function secondsSince(timestamp: number | Date, now?: number | Date): number;
-interface FormatReadableTimeOptions {
+interface FormatAgeOptions {
     justNow?: string;
     secondsAgo?: string;
     minutesAgo?: string;
@@ -41,94 +36,189 @@ interface FormatReadableTimeOptions {
     yearsAgo?: string;
 }
 /**
- * Formats a timestamp into a human-readable time ago string.
-
+ * Formats an age (elapsed time) given in **seconds** into a compact
+ * human-readable string like "3m", "2h", or "just now".
  *
- * @param timestamp - The timestamp (number) or Date object to format
- * @param options - Optional custom text translations
- * @returns Formatted time ago string
- */
-declare function formatReadableTime(timestamp: number | Date, options?: FormatReadableTimeOptions): string;
-/**
- * Formats an age in milliseconds into a human-readable time ago string.
- * @param timestamp Age in milliseconds
- * @param options Optional custom text translations
- * @returns Formatted time ago string
+ * Use this when you already have the elapsed time in seconds (e.g. from
+ * a server-provided `age` field). If you have milliseconds instead, use
+ * {@link formatAge}.
+ *
+ * @example
+ * formatAgeInSeconds(5)          // "just now"  (< 10s)
+ * formatAgeInSeconds(45)         // "45s"
+ * formatAgeInSeconds(120)        // "2m"
+ * formatAgeInSeconds(7200)       // "2h"
+ * formatAgeInSeconds(172800)     // "2d"
+ * formatAgeInSeconds(63072000)   // "2y"
+ *
+ * @example Custom labels (e.g. for i18n)
+ * formatAgeInSeconds(120, { minutesAgo: "{n} minutes ago" })  // "2 minutes ago"
  */
-declare function formatAge(age: number, options?: FormatReadableTimeOptions): string;
+declare function formatAgeInSeconds(age: number, options?: FormatAgeOptions): string;
 /**
- * Formats an age in seconds into a human-readable time ago string.
- * @param timestamp Age in seconds
- * @param options Optional custom text translations
- * @returns Formatted time ago string
- * @examples
- * formatAgeInSeconds(0) // "just now"
- * formatAgeInSeconds(10) // "10s"
- * formatAgeInSeconds(60) // "1m"
- * formatAgeInSeconds(3600) // "1h"
- * formatAgeInSeconds(86400) // "1d"
- * formatAgeInSeconds(31536000) // "1y"
+ * Formats an age (elapsed time) given in **milliseconds** into a compact
+ * human-readable string. Internally converts to seconds and delegates to
+ * {@link formatAgeInSeconds}.
+ *
+ * This is the primary function used across UI components to display how
+ * long ago something happened (e.g. a trade, a tweet, a channel update).
+ *
+ * @example
+ * formatAge(3000)    // "just now"  (3 s < 10 s threshold)
+ * formatAge(45000)   // "45s"
+ * formatAge(120000)  // "2m"
+ * formatAge(7200000) // "2h"
+ *
+ * @example Custom labels (e.g. for i18n)
+ * formatAge(120000, { minutesAgo: "{n} 分钟前" })  // "2 分钟前"
  */
-declare function formatAgeInSeconds(age: number, options?: FormatReadableTimeOptions): string;
+declare function formatAge(age: number, options?: FormatAgeOptions): string;
 
-declare function request<R = any>(url: string, options: RequestInit): Promise<R>;
-declare function get<R = any>(url: string, options?: RequestInit): Promise<R>;
-declare function post<R = any, P = any>(url: string, data: P, options?: Omit<RequestInit, "method">): Promise<R>;
-declare function put<R = any, P = any>(url: string, data: P, options?: Omit<RequestInit, "method">): Promise<R>;
-declare function del<R = any>(url: string, options?: Omit<RequestInit, "method">): Promise<R>;
-declare function mutate<R = any>(url: string, init: RequestInit): Promise<R>;
+declare function httpRequest<R = any>(url: string, options: RequestInit): Promise<R>;
+declare function httpGet<R = any>(url: string, options?: RequestInit): Promise<R>;
+declare function httpPost<R = any, P = any>(url: string, data: P, options?: Omit<RequestInit, "method">): Promise<R>;
+declare function httpPut<R = any, P = any>(url: string, data: P, options?: Omit<RequestInit, "method">): Promise<R>;
+declare function httpDelete<R = any>(url: string, options?: Omit<RequestInit, "method">): Promise<R>;
+declare function httpMutate<R = any>(url: string, init: RequestInit): Promise<R>;
 
+/**
+ * A `BigNumber` subclass that never throws on construction.
+ * Invalid / undefined values fall back to `0`.
+ */
 declare class SafeBigNumber extends BigNumber {
     constructor(num?: BigNumber.Value, base?: number);
 }
 declare const isValidNumber: (num: unknown) => boolean;
-declare const canConvertToNumber: (num: unknown) => boolean;
-declare const isValidTimeframe: (timeframe?: string) => boolean;
 type FormatAmountOptions = {
     showPlusGtThanZero: boolean;
 };
+/**
+ * Format a raw token / asset amount (no currency symbol).
+ *
+ * Precision tiers (ROUND_DOWN):
+ * | Range         | Format                  | Example input → output       |
+ * |---------------|-------------------------|------------------------------|
+ * | < 0.001       | 5 decimal places        | 0.0001234  → "0.00012"       |
+ * | < 1           | 3 decimal places        | 0.56789    → "0.567"         |
+ * | < 100         | 2 decimal places        | 42.678     → "42.67"         |
+ * | < 100 000     | grouped, 2 dp           | 12345.6    → "12,345.60"     |
+ * | ≥ 100 000     | abbreviated (K/M/B/T)   | 1_500_000  → "1.5M"          |
+ *
+ * @param num - The numeric value.
+ * @param options.showPlusGtThanZero - Prefix positive values with "+".
+ */
 declare const formatAmount: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
-declare const formatAmount2: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
-declare const formatAmount3: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
+/**
+ * Format a USD dollar amount with "$" prefix (standard precision).
+ *
+ * Precision tiers (ROUND_DOWN):
+ * | Range         | Format                  | Example input → output       |
+ * |---------------|-------------------------|------------------------------|
+ * | < 0.001       | "$0"                    | 0.00001    → "$0"            |
+ * | < 1           | 3 decimal places        | 0.56789    → "$0.567"        |
+ * | < 100         | 2 decimal places        | 42.678     → "$42.67"        |
+ * | < 10 000      | grouped, 2 dp           | 1234.5     → "$1,234.50"     |
+ * | ≥ 10 000      | abbreviated (K/M/B/T)   | 1_500_000  → "$1.5M"         |
+ *
+ * Use this for standard financial displays (volume, market cap, liquidity).
+ *
+ * @param num - The numeric value.
+ * @param options.showPlusGtThanZero - Prefix positive values with "+".
+ */
 declare const formatAmountUSD: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
-declare const formatAmountUSD2: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
-declare const formatAmountUSD3: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
-declare const formatAmountUSD4: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
-declare const formatAmountUSD5: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
+/**
+ * Format a USD dollar amount with "$" prefix — **compact** variant.
+ *
+ * Compared to {@link formatAmountUSD}, this variant is more aggressively
+ * rounded and suited for space-constrained UIs (cards, badges, list items):
+ *
+ * | Range         | Format                  | Example input → output       |
+ * |---------------|-------------------------|------------------------------|
+ * | < 0.001       | "$0"                    | 0.00001    → "$0"            |
+ * | < 1           | 3 decimal places        | 0.56789    → "$0.567"        |
+ * | < 100         | 2 decimal places        | 42.678     → "$42.67"        |
+ * | < 1 000       | 0 decimal places        | 567.89     → "$567"          |
+ * | ≥ 1 000       | abbreviated, 0 dp,      | 15 678     → "$15.6K"        |
+ * |               | rounded to nearest 100  | 1 234 567  → "$1.2M"         |
+ *
+ * Key differences from `formatAmountUSD`:
+ * - 100–1 000: shows 0 dp instead of 2 dp
+ * - ≥ 1 000: abbreviates earlier (1K vs 10K) with 0 precision, rounded to 100s
+ *
+ * @param num - The numeric value.
+ * @param options.showPlusGtThanZero - Prefix positive values with "+".
+ */
+declare const formatAmountUSDCompact: (num?: BigNumber.Value, options?: FormatAmountOptions) => string;
 type FormatPriceOptions = {
     isHighPrecise: boolean;
 };
-declare const formatPrice: (num?: BigNumber.Value, options?: FormatPriceOptions) => string;
+/**
+ * Format a token price with "$" prefix.
+ *
+ * Two precision modes controlled by `isHighPrecise` (default: `true`):
+ *
+ * | Range         | High precision (default)       | Low precision                |
+ * |---------------|-------------------------------|------------------------------|
+ * | < 0.0001      | subscript notation, 4 sig     | subscript notation, 2 sig    |
+ * |               | 0.0000382 → "$0.0₄382"        | 0.0000382 → "$0.0₄38"       |
+ * | < 1           | 4 dp, grouped                 | 2 significant dp             |
+ * |               | 0.12345 → "$0.1234"           | 0.12345 → "$0.12"           |
+ * | < 10 000      | 4 dp, grouped                 | 2 dp, grouped                |
+ * |               | 1234.567 → "$1,234.5670"      | 1234.567 → "$1,234.56"      |
+ * | < 100 000     | 2 dp, grouped                 | 2 dp, grouped                |
+ * | ≥ 100 000     | abbreviated (K/M/B/T)         | abbreviated (K/M/B/T)        |
+ *
+ * @param num - The price value.
+ * @param options.isHighPrecise - Use high-precision mode (default: true).
+ */
 declare const formatPriceUSD: (num?: BigNumber.Value, options?: FormatPriceOptions) => string;
 type FormatPercentOptions = {
     showPlusGtThanZero?: boolean;
     precision?: number;
 };
 /**
- * Format a number as a percentage.
- * @param num - The number to format, 0.3 means 30%.
- * @param options - The options to format the number.
- * @param options.showPlusGtThanZero - Whether to show the plus sign if the number is greater than zero.
- * @param options.precision - The precision to format the number.
- * @returns
+ * Format a ratio as a percentage string.
+ *
+ * The input is a **ratio** (0.3 = 30%, 1.5 = 150%).
+ *
+ * | Input range   | Output example                          |
+ * |---------------|-----------------------------------------|
+ * | < 0.0001      | "0%"                                    |
+ * | < 100         | "56.79%" (2 dp by default)              |
+ * | < 1000        | "15,000.5%" (1 dp by default)           |
+ * | ≥ 1000        | "> 99,999%"                             |
+ *
+ * @param num - The ratio value (0.3 means 30%).
+ * @param options.showPlusGtThanZero - Prefix positive values with "+".
+ * @param options.precision - Decimal precision override.
  */
 declare const formatPercent: (num?: BigNumber.Value, options?: FormatPercentOptions) => string;
-type FormatMultiplierOptions = {
-    showPlusGtThanZero?: boolean;
-};
-declare const formatMultiplier: (num?: BigNumber.Value, options?: FormatMultiplierOptions) => string;
-declare const formatCount: (num?: BigNumber.Value) => string | number;
-declare const formatCount2: (num?: BigNumber.Value) => string | number;
-declare const formatCount3: (num?: BigNumber.Value) => string;
-declare const displayCount4: (num?: BigNumber.Value) => string;
-declare const displayCount3: (num?: BigNumber.Value) => string | number;
 
-declare function capitalizeString(str: string): string;
-declare function camelCaseToSnakeCase(str: string): string;
-declare const findLongestCommonSubString: (str1: string, str2: string) => number;
-declare function isHex(value: string): boolean;
-declare function isHexString(value: string): boolean;
-declare function shortAddress(address: string, start?: number, end?: number): string;
+/**
+ * Capitalize the first letter of a string, lowercasing the rest.
+ *
+ * @example
+ * capitalize("hello")    // "Hello"
+ * capitalize("hELLO")    // "Hello"
+ * capitalize("solana")   // "Solana"
+ */
+declare function capitalize(str: string): string;
+/**
+ * Truncate an address (or any string) to show the first `start` and last `end`
+ * characters with "..." in between.
+ *
+ * @param address - The full address string.
+ * @param start   - Number of characters to keep from the beginning (default 6).
+ * @param end     - Number of characters to keep from the end (default 4).
+ *
+ * @example
+ * truncateAddress("0x1234567890abcdef1234567890abcdef12345678")
+ * // "0x1234...5678"
+ *
+ * truncateAddress("0x1234567890abcdef1234567890abcdef12345678", 4, 4)
+ * // "0x12...5678"
+ */
+declare function truncateAddress(address: string, start?: number, end?: number): string;
 
 /**
  * Format trading pair symbol *
@@ -182,15 +272,10 @@ declare function getCommonTokenAddresses(chain: Chain): string[];
 declare function getCommonTokenSymbolsMap(chain: Chain): Record<string, string>;
 
 declare function txExplorerUrl(chainId: Chain, txHash: string): string | undefined;
-declare const accountExplorerUrl: (chainId: Chain, account: string) => string | undefined;
+declare function accountExplorerUrl(chainId: Chain, account: string): string | undefined;
 declare function searchImageUrl(image: string): string;
 declare function searchTwitterUrl(q: string): string;
 declare function twitterUserUrl(username: string): string;
 declare function twitterTweetUrl(id: string): string;
-declare function twitterMediaUrl(id: string): string;
-
-declare const windowGuard: (cb: Function) => void;
-declare const getGlobalObject: () => typeof globalThis;
-declare const getTimestamp: () => number;
 
-export { ARBITRUM_TOKENS, AVALANCHE_TOKENS, ApiError, BSC_TOKENS, CHAIN_TOKENS, type ChainPredefinedTokens, ETHEREUM_TOKENS, type FormatAmountOptions, type FormatMultiplierOptions, type FormatPercentOptions, type FormatPriceOptions, type FormatReadableTimeOptions, OPTIMISM_TOKENS, type PredefinedToken, SOLANA_TOKENS, SafeBigNumber, accountExplorerUrl, camelCaseToSnakeCase, canConvertToNumber, capitalizeString, chainColor, chainDisplayName, chainIcon, chainIdBySlug, chainSlug, chainToNamespace, del, displayCount3, displayCount4, findLongestCommonSubString, formatAge, formatAgeInSeconds, formatAmount, formatAmount2, formatAmount3, formatAmountUSD, formatAmountUSD2, formatAmountUSD3, formatAmountUSD4, formatAmountUSD5, formatCount, formatCount2, formatCount3, formatMultiplier, formatPercent, formatPrice, formatPriceUSD, formatReadableTime, formatSymbol, formatTimeAgo, formatTokenProtocolName, get, getCommonTokenAddresses, getCommonTokenSymbolsMap, getGlobalObject, getNativeToken, getStablecoins, getTimestamp, getWrappedToken, isHex, isHexString, isValidEvmAddress, isValidNumber, isValidSolanaAddress, isValidTimeframe, isValidWalletAddress, millisecondsToHMS, mutate, parseTokenProtocolFamily, post, put, request, searchImageUrl, searchTwitterUrl, secondsSince, shortAddress, subtractDaysFromCurrentDate, timestampToString, twitterMediaUrl, twitterTweetUrl, twitterUserUrl, txExplorerUrl, _default as version, windowGuard };
+export { ARBITRUM_TOKENS, AVALANCHE_TOKENS, ApiError, BSC_TOKENS, CHAIN_TOKENS, type ChainPredefinedTokens, ETHEREUM_TOKENS, type FormatAgeOptions, type FormatAmountOptions, type FormatPercentOptions, type FormatPriceOptions, OPTIMISM_TOKENS, type PredefinedToken, SOLANA_TOKENS, SafeBigNumber, accountExplorerUrl, capitalize, chainColor, chainDisplayName, chainIcon, chainIdBySlug, chainSlug, chainToNamespace, formatAge, formatAgeInSeconds, formatAmount, formatAmountUSD, formatAmountUSDCompact, formatPercent, formatPriceUSD, formatSymbol, formatTokenProtocolName, getCommonTokenAddresses, getCommonTokenSymbolsMap, getNativeToken, getStablecoins, getWrappedToken, httpDelete, httpGet, httpMutate, httpPost, httpPut, httpRequest, isValidEvmAddress, isValidNumber, isValidSolanaAddress, isValidWalletAddress, parseTokenProtocolFamily, searchImageUrl, searchTwitterUrl, truncateAddress, twitterTweetUrl, twitterUserUrl, txExplorerUrl, _default as version };