import type { TokenInfo, TokenListFile } from "../schema/schema.js";
/**
 * Get all tokens on a given chain.
 */
export declare function getTokensByChain(list: TokenListFile, chainId: number): TokenInfo[];
/**
 * Find a token by address (case-insensitive) on a given chain.
 */
export declare function getTokenByAddress(list: TokenListFile, chainId: number, address: string): TokenInfo | undefined;
/**
 * Find a token by symbol (case-insensitive) on a given chain.
 * Validator enforces uniqueness per chain.
 */
export declare function getTokenBySymbol(list: TokenListFile, chainId: number, symbol: string): TokenInfo | undefined;
/**
 * Get tokens that have a given tag ID (e.g. "stablecoin", "bluechip").
 */
export declare function getTokensByTag(list: TokenListFile, tagId: string): TokenInfo[];
/**
 * Build a logo URI for a token using jsDelivr, since the list stores
 * repo-relative `image` paths like "images/<chainId>/<address>.svg".
 *
 * If the token has `logoURI` set, that is preferred.
 */
export declare function getLogoUri(token: TokenInfo, options?: {
    /**
     * npm package name, default: "@xrise33/token-list"
     */
    packageName?: string;
    /**
     * Specific version or tag. Default: "latest".
     * Example: "1.2.3" or "1".
     */
    version?: string;
    /**
     * Override entire base (e.g. for self-hosted CDN).
     * Example: "https://cdn.mycdn.com/@xrise33/token-list/1.0.0"
     */
    baseUriOverride?: string;
}): string | undefined;