import {z} from 'zod' export type SortByField = {field: 'id' | 'created_at', operator: 'asc' | 'desc'}; export type CosignerSearchRequest = {page?: number | undefined, page_size?: number | undefined, sort?: (Array | null) | undefined}; export type CreateApiV0PlatformCosignersSearchArgs = {body: CosignerSearchRequest}; export type CreateApiV0PlatformCosignersSearchOptions = {baseUrl?: string | undefined, APIKey?: string | undefined, fetch?: typeof fetch | undefined}; export const telegramExternalChannel = z.object({chat_id: z.string(), topic_ids: z.array(z.number().int())}); export const telegramExternalAction = z.object({type: z.literal("telegram"), chats: z.array(telegramExternalChannel), message_format: z.string().nullable().optional()}); export const slackExternalAction = z.object({type: z.literal("slack"), message_format: z.string().nullable().optional(), channels: z.array(z.string())}); export const emailExternalAction = z.object({type: z.literal("email"), to: z.array(z.string()), cc: z.array(z.string()).nullable().optional(), bcc: z.array(z.string()).nullable().optional(), body: z.string().nullable().optional()}); export const cosignerStatusExternal = z.enum(["pending", "ok", "error"]); export const fallbackBehavior = z.enum(["reject", "approve", "manual_review"]); export const addressDetails = z.object({address: z.string(), chain: z.string()}); export const vaultDetails = z.object({vault_id: z.string(), name: z.string(), addresses: z.array(addressDetails)}); export const vaultError = z.object({vault_id: z.string(), error: z.string()}); export const approverSigningMode = z.enum(["active_approval", "reporting_only"]); export const externalPolicyOption = z.enum(["blockaid_ootb_policy", "advanced_control_policy"]); export const decisionAction = z.enum(["approve", "reject", "pending"]); export const fireblocksCosignerResponseExternal = z.object({type: z.literal("fireblocks"), integration_instance_id: z.string(), scope: z.literal("specific_vaults").optional(), vaults: z.array(z.union([vaultDetails, vaultError])), chains: z.array(z.string()).nullable().optional(), involvement_level: approverSigningMode, security_policy: externalPolicyOption.nullable().optional(), unsupported_chain_behavior: decisionAction}); export const workspaceScope = z.enum(["all_vaults", "specific_vaults"]); export const signerSigningMode = z.enum(["active_approval", "reporting_only"]); export const fordefiCosignerResponseExternal = z.object({type: z.literal("fordefi"), integration_instance_id: z.string(), scope: workspaceScope, vaults: z.array(z.union([vaultDetails, vaultError])), chains: z.array(z.string()).nullable().optional(), involvement_level: signerSigningMode, security_policy: externalPolicyOption.nullable().optional(), unsupported_chain_behavior: decisionAction}); export const cosignerSafeResponseExternal = z.object({chain: z.string(), type: z.literal("safe"), override_address: z.string().nullable(), cosigner_address: z.string(), involvement_level: signerSigningMode, security_policy: externalPolicyOption.nullable().optional(), wallet_address: z.string()}); export const cosignerSquadsResponseExternal = z.object({chain: z.literal("solana-mainnet"), type: z.literal("squads"), cosigner_address: z.string(), involvement_level: signerSigningMode, security_policy: externalPolicyOption.nullable().optional(), wallet_address: z.string()}); export const utilaCosignerResponseExternal = z.object({type: z.literal("utila"), integration_instance_id: z.string(), addresses: z.array(addressDetails), chains: z.array(z.string()).nullable().optional(), involvement_level: signerSigningMode, security_policy: externalPolicyOption.nullable().optional(), unsupported_chain_behavior: decisionAction}); export const cosignerExternalResponse = z.object({tags: z.array(z.string()), proposal_actions: z.array(z.discriminatedUnion("type", [telegramExternalAction, slackExternalAction, emailExternalAction])), rejection_actions: z.array(z.discriminatedUnion("type", [telegramExternalAction, slackExternalAction, emailExternalAction])), approval_actions: z.array(z.discriminatedUnion("type", [telegramExternalAction, slackExternalAction, emailExternalAction])), malicious_actions: z.array(z.discriminatedUnion("type", [telegramExternalAction, slackExternalAction, emailExternalAction])).nullable().optional(), id: z.string(), name: z.string().nullable(), status: cosignerStatusExternal, fallback_behavior: fallbackBehavior, error: z.string().nullable().optional(), created_at: z.string(), updated_at: z.string(), updated_by: z.string().nullable(), data: z.discriminatedUnion("type", [fireblocksCosignerResponseExternal, fordefiCosignerResponseExternal, cosignerSafeResponseExternal, cosignerSquadsResponseExternal, utilaCosignerResponseExternal]), created_by: z.string(), selected_chains: z.array(z.string()).nullable().optional()}); export const summaryStatus = z.object({ok: z.number().int(), pending: z.number().int(), error: z.number().int()}); export const cosignerPageCosignerExternalResponse = z.object({items: z.array(cosignerExternalResponse), total: z.number().int().gte(0).nullable(), page: z.number().int().gte(1).nullable(), size: z.number().int().gte(1).nullable(), pages: z.number().int().gte(0).nullable().optional(), status_summary: summaryStatus}); 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 }; /** * Get Cosigners Paginated Route * * POST /v0/platform/cosigners/search * * Also accepts auth: ClientID, JWT */ export const createApiV0PlatformCosignersSearch = async (args: CreateApiV0PlatformCosignersSearchArgs, options?: CreateApiV0PlatformCosignersSearchOptions) => { const {baseUrl = "https://api.blockaid.io", fetch: fetchFn = fetch, APIKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (APIKey !== undefined) headers.set("X-API-Key", APIKey) const url = `${baseUrl.replace(/\/+$/, '')}/v0/platform/cosigners/search${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(cosignerPageCosignerExternalResponse, await res.json()) };