import {z} from 'zod' export type TelegramExternalChannel = {chat_id: string, topic_ids: Array}; export type TelegramExternalAction = {type: 'telegram', chats: Array, message_format?: (string | null) | undefined}; export type SlackExternalAction = {type: 'slack', message_format?: (string | null) | undefined, channels: Array}; export type EmailExternalAction = {type: 'email', to: Array, cc?: (Array | null) | undefined, bcc?: (Array | null) | undefined, body?: (string | null) | undefined}; export type FallbackBehavior = 'reject' | 'approve' | 'manual_review'; export type ApproverSigningMode = 'active_approval' | 'reporting_only'; export type ExternalPolicyOption = 'blockaid_ootb_policy' | 'advanced_control_policy'; export type DecisionAction = 'approve' | 'reject' | 'pending'; export type FireblocksCosignerDataExternal = {type: 'fireblocks', integration_instance_id: string, scope: 'specific_vaults', vault_ids: Array, chains?: (Array | null) | undefined, involvement_level: ApproverSigningMode, security_policy?: (ExternalPolicyOption | null) | undefined, unsupported_chain_behavior: DecisionAction}; export type WorkspaceScope = 'all_vaults' | 'specific_vaults'; export type SignerSigningMode = 'active_approval' | 'reporting_only'; export type FordefiCosignerDataExternal = {type: 'fordefi', integration_instance_id: string, scope: WorkspaceScope, vault_ids?: (Array | null) | undefined, chains?: (Array | null) | undefined, involvement_level: SignerSigningMode, security_policy?: (ExternalPolicyOption | null) | undefined, unsupported_chain_behavior: DecisionAction}; export type UtilaCosignerDataExternal = {chains?: (Array | null) | undefined, integration_instance_id: string, involvement_level: SignerSigningMode, security_policy?: (ExternalPolicyOption | null) | undefined, type: 'utila', unsupported_chain_behavior: DecisionAction}; export type CosignerSafeDataExternal = {chain: string, type: 'safe', override_address: string | null, involvement_level: SignerSigningMode, security_policy?: (ExternalPolicyOption | null) | undefined, wallet_address: string}; export type CosignerSquadsDataExternal = {chain: 'solana-mainnet', type: 'squads', involvement_level: SignerSigningMode, security_policy?: (ExternalPolicyOption | null) | undefined, wallet_address: string}; export type CreateCosignerExternalRequest = {tags: Array, proposal_actions: Array, rejection_actions: Array, approval_actions: Array, malicious_actions?: (Array | null) | undefined, name: string, fallback_behavior?: FallbackBehavior | undefined, data: FireblocksCosignerDataExternal | FordefiCosignerDataExternal | UtilaCosignerDataExternal | CosignerSafeDataExternal | CosignerSquadsDataExternal}; export type CreateApiV0PlatformCosignersArgs = {body: CreateCosignerExternalRequest}; export type CreateApiV0PlatformCosignersOptions = {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 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 }; /** * Create a new Cosigner * * POST /v0/platform/cosigners * * Also accepts auth: ClientID, JWT */ export const createApiV0PlatformCosigners = async (args: CreateApiV0PlatformCosignersArgs, options?: CreateApiV0PlatformCosignersOptions) => { 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${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(cosignerExternalResponse, await res.json()) };