import {z} from 'zod' export type StarknetChain = 'mainnet'; export type StarknetOptions = 'validation' | 'simulation'; export type StarknetInvokeV1TransactionSchema = {version: 1, nonce: string, sender_address: string, calldata?: Array | undefined, max_fee: string}; export type StarknetInvokeV3TransactionSchema = {version: 3, nonce: string, sender_address: string, calldata: Array, chain_id: string, nonce_data_availability_mode?: 0 | undefined, paymaster_data?: Array | undefined, account_deployment_data?: Array | undefined}; export type StarknetDeployAccountV1TransactionSchema = {version: 1, nonce: string, class_hash: string, contract_address_salt: string, constructor_calldata: Array, max_fee: string}; export type StarknetDeployAccountV3TransactionSchema = {version: 3, nonce: string, class_hash: string, contract_address_salt: string, constructor_calldata: Array, max_fee: string}; export type StarknetOutsideCallSchema = {to: string, selector: string, calldata?: Array | undefined}; export type StarknetOutsideExecutionSchema = {caller: string, nonce: string, execute_after: string, execute_before: string, calls: Array}; export type StarknetWalletRequestMetadata = {type: 'wallet', url: string}; export type StarknetInAppRequestMetadata = {type?: 'in_app' | undefined}; export type StarknetTransactionScanRequest = {chain: StarknetChain | string, options?: Array | undefined, account_address: string, transaction: StarknetInvokeV1TransactionSchema | StarknetInvokeV3TransactionSchema | StarknetDeployAccountV1TransactionSchema | StarknetDeployAccountV3TransactionSchema | StarknetOutsideExecutionSchema, metadata: StarknetWalletRequestMetadata | StarknetInAppRequestMetadata, block_number?: (string | null) | undefined}; export type CreateApiV0StarknetTransactionScanArgs = {body: StarknetTransactionScanRequest}; export type CreateApiV0StarknetTransactionScanOptions = {baseUrl?: string | undefined, APIKey?: string | undefined, fetch?: typeof fetch | undefined}; export const starknetERC20Details = z.object({type: z.literal("ERC20").optional(), name: z.string(), symbol: z.string(), address: z.string(), decimals: z.number().int(), logo_url: z.string().nullable().optional()}); export const starknetERC20DiffSchema = z.object({usd_price: z.number().nullable().optional(), summary: z.string().nullable().optional(), value: z.string(), raw_value: z.number().int()}); export const starknetERC20AssetDiff = z.object({asset: starknetERC20Details, in: starknetERC20DiffSchema.optional(), out: starknetERC20DiffSchema.optional(), asset_type: z.string()}); export const starknetERC721Details = z.object({type: z.literal("ERC721").optional(), name: z.string(), symbol: z.string(), address: z.string(), logo_url: z.string().nullable().optional()}); export const starknetERC721DiffSchema = z.object({usd_price: z.number().nullable().optional(), summary: z.string().nullable().optional(), token_id: z.string()}); export const starknetERC721AssetDiff = z.object({asset: starknetERC721Details, in: starknetERC721DiffSchema.optional(), out: starknetERC721DiffSchema.optional(), asset_type: z.string()}); export const starknetERC1155Details = z.object({type: z.literal("ERC1155").optional(), name: z.string(), symbol: z.string(), address: z.string(), logo_url: z.string().nullable().optional()}); export const starknetERC1155DiffSchema = z.object({usd_price: z.number().nullable().optional(), summary: z.string().nullable().optional(), token_id: z.string(), value: z.number().int()}); export const starknetERC1155AssetDiff = z.object({asset: starknetERC1155Details, in: starknetERC1155DiffSchema.optional(), out: starknetERC1155DiffSchema.optional(), asset_type: z.string()}); export const starknetERC20ExposureSchema = z.object({exposure: z.array(starknetERC20DiffSchema), summary: z.string().nullable().optional(), approval: z.string(), expiration: z.string().nullable().optional()}); export const starknetERC20Exposure = z.object({asset: starknetERC20Details, spenders: z.record(z.string(), starknetERC20ExposureSchema).optional()}); export const starknetERC721ExposureSchema = z.object({exposure: z.array(starknetERC721DiffSchema), summary: z.string().nullable().optional(), is_approved_for_all: z.boolean()}); export const starknetERC721Exposure = z.object({asset: starknetERC721Details, spenders: z.record(z.string(), starknetERC721ExposureSchema).optional()}); export const starknetERC1155ExposureSchema = z.object({exposure: z.array(starknetERC1155DiffSchema), summary: z.string().nullable().optional(), is_approved_for_all: z.boolean()}); export const starknetERC1155Exposure = z.object({asset: starknetERC1155Details, spenders: z.record(z.string(), starknetERC1155ExposureSchema).optional()}); export const starknetAddressDetailsBaseSchema = z.object({account_address: z.unknown(), description: z.string().nullable().optional()}); export const starknetTotalUsdDiffSchema = z.object({in: z.number(), out: z.number(), total: z.number().optional()}); export const starknetAccountSummary = z.object({account_assets_diffs: z.array(z.union([starknetERC20AssetDiff, starknetERC721AssetDiff, starknetERC1155AssetDiff])).optional(), account_exposures: z.array(z.union([starknetERC20Exposure, starknetERC721Exposure, starknetERC1155Exposure])), total_usd_diff: starknetTotalUsdDiffSchema, total_usd_exposure: z.record(z.string(), z.number()).optional()}); export const starknetStarknetSimulationResultSchema = z.object({status: z.literal("Success"), assets_diffs: z.record(z.string(), z.array(z.union([starknetERC20AssetDiff, starknetERC721AssetDiff, starknetERC1155AssetDiff]))).optional(), exposures: z.record(z.string(), z.array(z.union([starknetERC20Exposure, starknetERC721Exposure, starknetERC1155Exposure]))).optional(), address_details: z.array(starknetAddressDetailsBaseSchema).optional(), account_summary: starknetAccountSummary, block_number: z.string().nullable().optional()}); export const starknetSimulationErrorSchema = z.object({status: z.literal("Error"), error: z.string()}); export const starknetVerdict = z.enum(["Benign", "Warning", "Malicious", "Error"]); export const starknetValidationFeatureType = z.enum(["Benign", "Warning", "Malicious", "Info"]); export const starknetValidationFeature = z.object({type: starknetValidationFeatureType, feature_id: z.string(), description: z.string(), address: z.string()}); export const starknetValidationResult = z.object({status: z.literal("Success"), result_type: starknetVerdict, description: z.string(), reason: z.string(), classification: z.string(), features: z.array(starknetValidationFeature)}); export const starknetValidationErrorSchema = z.object({status: z.literal("Error"), error: z.string()}); export const starknetValidationResponse = z.union([starknetValidationResult, starknetValidationErrorSchema]); export const starknetTransactionScanResponse = z.object({simulation: z.union([starknetStarknetSimulationResultSchema, starknetSimulationErrorSchema]).nullable().optional(), validation: starknetValidationResponse.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 }; /** * Scan Transactions * * POST /v0/starknet/transaction/scan * * Also accepts auth: ClientID */ export const createApiV0StarknetTransactionScan = async (args: CreateApiV0StarknetTransactionScanArgs, options?: CreateApiV0StarknetTransactionScanOptions) => { 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/starknet/transaction/scan${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(starknetTransactionScanResponse, await res.json()) };