import {z} from 'zod' export type PoolSortKey = 'tvl' | 'volume' | 'fee_tvl_ratio' | 'l_m'; export type OrderBy = 'asc' | 'desc'; export type PoolTypeQueryParam = 'dynamic' | 'multitoken' | 'lst' | 'farms'; export type GetApiPoolsSearchArgs = {page: number, size: number, filter?: (string | null) | undefined, sort_key?: (PoolSortKey | null) | undefined, order_by?: (OrderBy | null) | undefined, pools_to_top?: Array | undefined, unknown?: (boolean | null) | undefined, pool_type?: (PoolTypeQueryParam | null) | undefined, is_monitoring?: (boolean | null) | undefined, hide_low_tvl?: (number | null) | undefined, hide_low_apr?: (boolean | null) | undefined, include_token_mints?: (Array | null) | undefined, include_pool_token_pairs?: (Array | null) | undefined, launchpad?: (Array | null) | undefined}; export type GetApiPoolsSearchOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const cumulativeMetrics = z.object({fees: z.number(), volume: z.number()}); export const timeWindowData = z.object({"12h": z.number(), "1h": z.number(), "24h": z.number(), "2h": z.number(), "30m": z.number(), "4h": z.number()}); export const poolConfig = z.object({base_fee_pct: z.number(), bin_step: z.number().int().gte(0), collect_fee_mode: z.number().int().gte(0), max_fee_pct: z.number(), protocol_fee_pct: z.number()}); export const tokenMetrics = z.object({address: z.string(), decimals: z.number().int().gte(0), freeze_authority_disabled: z.boolean(), holders: z.number().int(), is_verified: z.boolean(), market_cap: z.number(), name: z.string(), price: z.number(), symbol: z.string(), total_supply: z.number()}); export const poolResponse = z.object({address: z.string(), apr: z.number(), apy: z.number(), created_at: z.number().int().gte(0), cumulative_metrics: cumulativeMetrics, current_price: z.number(), dynamic_fee_pct: z.number(), farm_apr: z.number(), farm_apy: z.number(), fee_tvl_ratio: timeWindowData, fees: timeWindowData, has_farm: z.boolean(), is_blacklisted: z.boolean(), launchpad: z.unknown(), name: z.string(), pool_config: poolConfig, protocol_fees: timeWindowData, reserve_x: z.string(), reserve_y: z.string(), reward_mint_x: z.string(), reward_mint_y: z.string(), tags: z.array(z.string()), token_x: tokenMetrics, token_x_amount: z.number(), token_y: tokenMetrics, token_y_amount: z.number(), tvl: z.number(), volume: timeWindowData}); export const paginatedPoolResponse = z.object({data: poolResponse, page: z.number().int().gte(0), total_count: z.number().int().gte(0)}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Pool Search * * GET /pools/search */ export const getApiPoolsSearch = async (args: GetApiPoolsSearchArgs, options?: GetApiPoolsSearchOptions) => { const {baseUrl = "https://damm-api.meteora.ag", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.page != null) query.append("page", String(args.page)) if (args.size != null) query.append("size", String(args.size)) if (args.filter != null) query.append("filter", String(args.filter)) if (args.sort_key != null) query.append("sort_key", String(args.sort_key)) if (args.order_by != null) query.append("order_by", String(args.order_by)) for (const item of args.pools_to_top ?? []) query.append("pools_to_top", String(item)) if (args.unknown != null) query.append("unknown", String(args.unknown)) if (args.pool_type != null) query.append("pool_type", String(args.pool_type)) if (args.is_monitoring != null) query.append("is_monitoring", String(args.is_monitoring)) if (args.hide_low_tvl != null) query.append("hide_low_tvl", String(args.hide_low_tvl)) if (args.hide_low_apr != null) query.append("hide_low_apr", String(args.hide_low_apr)) for (const item of args.include_token_mints ?? []) query.append("include_token_mints", String(item)) for (const item of args.include_pool_token_pairs ?? []) query.append("include_pool_token_pairs", String(item)) for (const item of args.launchpad ?? []) query.append("launchpad", String(item)) const url = `${baseUrl.replace(/\/+$/, '')}/pools/search${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(paginatedPoolResponse, await res.json()) };