import {z} from 'zod' export type GetApiV4KyaScreeningV2Args = {chain: string, address: string, rule_set_id?: string | undefined, mode?: string | undefined}; export type GetApiV4KyaScreeningV2Options = {baseUrl: string, ApiKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; 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 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 riskSaaSRiskFactor = z.object({category: riskCategory.optional(), exposure: riskExposureContextForDB.optional(), level: riskLevel.optional(), origin: riskOrigin.optional(), sub_origin: riskSubOrigin.optional(), trigger: riskTriggerContextForDB.optional()}); export const screeningTaskVin = z.object({address: z.string().optional(), amount: z.string().optional()}); export const screeningTaskVout = z.object({address: z.string().optional(), amount: z.string().optional()}); export const screeningTaskTransaction = z.object({amount: z.string().optional(), block_number: z.number().int().optional(), chain: z.string().optional(), from: z.string().optional(), hash: z.string().optional(), timestamp: z.number().int().optional(), to: z.string().optional(), token_address: z.string().optional(), token_decimals: z.number().int().optional(), token_name: z.string().optional(), token_price: z.number().optional(), token_symbol: z.string().optional(), type: z.string().optional(), usd_value: z.number().optional(), vins: z.array(screeningTaskVin).optional(), vouts: z.array(screeningTaskVout).optional()}); export const screeningTaskCounterparty = z.object({counterparty: z.string().optional(), risk_factors: z.record(z.string(), z.array(riskSaaSRiskFactor)).optional(), transactions: z.array(screeningTaskTransaction).optional()}); export const entityLocalized = z.object({en: z.string().optional(), zh: z.string().optional()}); export const entityEntity = z.object({country: entityLocalized.optional(), description: entityLocalized.optional(), entity_id: z.string().optional(), entity_name: entityLocalized.optional(), link: z.string().optional(), other_link: z.string().optional()}); 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 screeningTaskScreeningResult = z.object({counterparties: z.record(z.string(), screeningTaskCounterparty).optional(), entities: z.array(entityEntity).optional(), labels: z.array(labelLabels).optional(), risk_results: z.record(z.string(), z.array(riskSaaSRiskFactor)).optional()}); export const getApiV4KyaScreeningV2Response = z.object({code: z.number().int().optional(), data: z.object({address: z.string().optional(), api_key: z.string().optional(), chain: z.string().optional(), created_at: z.string().optional(), error: z.string().optional(), finished_at: z.string().optional(), org_id: z.string().optional(), result: screeningTaskScreeningResult.optional(), retry_count: z.number().int().optional(), rule_set_id: z.string().optional(), started_at: z.string().optional(), status: z.string().optional(), updated_at: z.string().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 }; /** * Submit screening result for a blockchain address * * GET /v4/kya/screening_v2 * * Also accepts auth: ApiSecretAuth */ export const getApiV4KyaScreeningV2 = async (args: GetApiV4KyaScreeningV2Args, options: GetApiV4KyaScreeningV2Options) => { const {baseUrl, fetch: fetchFn = fetch, ApiKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.chain != null) query.append("chain", String(args.chain)) if (args.address != null) query.append("address", String(args.address)) if (args.rule_set_id != null) query.append("rule_set_id", String(args.rule_set_id)) if (args.mode != null) query.append("mode", String(args.mode)) if (ApiKeyAuth !== undefined) headers.set("X-API-Key", ApiKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/v4/kya/screening_v2${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(getApiV4KyaScreeningV2Response, await res.json()) };