import {z} from 'zod' export type GetApiV4MonitorListArgs = {page?: number | undefined, size?: number | undefined}; export type GetApiV4MonitorListOptions = {baseUrl: string, ApiKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const labelLabels = z.object({address: z.string().optional(), category: z.string().optional(), chain: z.string().optional(), label: z.string().optional(), source: z.string().optional(), sub_category: z.string().optional(), ts: z.number().int().optional()}); export const riskCategory = z.enum(["", "Sanctioned", "TerroristFinancing", "ChildAbuse", "Hack", "Scam", "Ransomware", "Darkweb", "Mixing", "Laundering", "NoKYCExchange", "Gambling", "Blocked", "Blacklisted", "UnregisteredVASP", "RiskyEscrow", "HumanTrafficking", "PoliticalFigure", "Unknown", "Guarantee"]); export const riskDirection = z.enum(["inflow", "outflow", "both"]); export const riskExposureHopForDB = z.object({address: z.string().optional(), amount: z.number().optional(), amount_usd: z.number().optional(), chain: z.string().optional(), direction: z.string().optional(), timestamp: z.number().int().optional(), token_symbol: z.string().optional(), tx_hash: z.string().optional()}); export const riskExposurePathForDB = z.object({amount: z.number().optional(), amount_usd: z.number().optional(), hops: z.array(riskExposureHopForDB).optional(), share: z.number().optional()}); export const riskExposureContextForDB = z.object({amount: z.number().optional(), amount_usd: z.number().optional(), counterparty_address: z.string().optional(), direction: z.string().optional(), hop_count: z.number().int().optional(), path_count: z.number().int().optional(), paths: z.array(riskExposurePathForDB).optional(), paths_aggregated: z.boolean().optional(), share: z.number().optional(), tx_count: z.number().int().optional()}); export const riskLevel = z.enum(["None", "Low", "Medium", "High"]); export const riskOrigin = z.enum(["self", "counterparty"]); export const riskSubOrigin = z.enum(["", "label", "entity", "behavior", "structural", "user_blacklist", "address_set", "direct", "indirect", "concentration"]); export const riskTriggerContextForDB = z.object({rule_id: z.string().optional(), rule_name: z.string().optional(), trigger_id: z.string().optional()}); export const riskRiskFactor = z.object({category: riskCategory.optional(), chain: z.string().optional(), description: z.string().optional(), direction: riskDirection.optional(), exposure: riskExposureContextForDB.optional(), id: z.string().optional(), level: riskLevel.optional(), observed_at: z.string().optional(), origin: riskOrigin.optional(), rule_id: z.string().optional(), sub_origin: riskSubOrigin.optional(), trigger: riskTriggerContextForDB.optional(), weight: z.number().optional()}); export const typesStatistics = z.object({ratio: z.number().optional(), ratio_count: z.number().optional(), total: z.number().optional()}); export const typesCountAndRatio = z.object({count: z.number().int().optional(), ratio: z.number().optional()}); export const typesRisk7dCountRatio = z.object({alert_count: z.number().int().optional(), high_count: typesCountAndRatio.optional(), low_count: typesCountAndRatio.optional(), medium_count: typesCountAndRatio.optional(), none_count: typesCountAndRatio.optional(), tx_count: z.number().int().optional()}); export const typesTopCounterPartyInfo = z.object({address: z.string().optional(), entity: z.string().optional(), labels: z.array(labelLabels).nullable().optional(), ratio: z.number().optional(), risk_level: riskLevel.optional(), tx_count: z.number().int().optional()}); export const typesRiskFactorCount = z.object({category: riskCategory.optional(), count: z.number().int().optional()}); export const typesSummaryMonitor = z.object({high_risk_count: typesStatistics.optional(), low_risk_count: typesStatistics.optional(), medium_count: typesStatistics.optional(), none_risk_count: typesStatistics.optional(), risk_7d_count: typesRisk7dCountRatio.optional(), risk_counterparty: typesStatistics.optional(), risk_usd_exposure: typesStatistics.optional(), top_5_counterparty: z.array(typesTopCounterPartyInfo).nullable().optional(), top_counterparty: typesStatistics.optional(), top_risk_factor: z.array(typesRiskFactorCount).nullable().optional(), trigger_alert: typesStatistics.optional()}); export const typesListMonitor = z.object({address: z.string().optional(), alert_count: z.number().int().optional(), chain: z.string().optional(), create_time: z.string().optional(), entity: z.string().optional(), entity_name: z.string().optional(), event_count: z.number().int().optional(), labels: z.array(labelLabels).nullable().optional(), last_alert: z.string().optional(), last_event: z.string().optional(), monitor_id: z.string().optional(), risk_factor: z.array(riskRiskFactor).nullable().optional(), risk_level: riskLevel.optional(), rule_set: z.string().optional(), status: z.string().optional(), summary: typesSummaryMonitor.nullable().optional()}); export const typesPagination = z.object({has_next: z.boolean().optional(), has_prev: z.boolean().optional(), page: z.number().int().optional(), size: z.number().int().optional(), total: z.number().int().optional(), total_pages: z.number().int().optional()}); export const getApiV4MonitorListResponse = z.object({code: z.number().int().optional(), data: z.object({list: z.array(typesListMonitor).nullable().optional(), pagination: typesPagination.optional()}).nullable().optional(), message: z.string().optional()}); 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 }; /** * List monitor tasks * * GET /v4/monitor/list * * Also accepts auth: ApiSecretAuth */ export const getApiV4MonitorList = async (args: GetApiV4MonitorListArgs, options: GetApiV4MonitorListOptions) => { const {baseUrl, fetch: fetchFn = fetch, ApiKeyAuth} = 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 (ApiKeyAuth !== undefined) headers.set("X-API-Key", ApiKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/v4/monitor/list${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(getApiV4MonitorListResponse, await res.json()) };