import {z} from 'zod' export type Region = 'asia-southeast1' | 'ap-southeast-1' | 'us-west-2' | 'us-east-1' | 'uksouth' | 'eu3'; export type Provider = 'aws' | 'azure' | 'gcloud' | 'vzo'; export type Protocol = 'ethereum' | 'polygon-pos' | 'bsc' | 'avalanche' | 'arbitrum' | 'near' | 'aurora' | 'gnosis' | 'cronos' | 'fantom' | 'starknet' | 'tezos' | 'fuse' | 'bitcoin'; export type NodeStatusEnum = 'pending' | 'running' | 'maintenance' | 'failed' | 'error' | 'stopping' | 'stopped' | 'starting'; export type NodeRoleEnum = 'peer'; export type NodeTypeEnum = 'shared' | 'dedicated'; export type ProjectTypeEnum = 'public'; export type GetApiV1NodesArgs = {order_by?: ('name' | 'created_at') | undefined, page?: number | undefined, project?: string | undefined, organization?: string | undefined, network?: string | undefined, region?: Region | undefined, provider?: Provider | undefined, protocol?: Protocol | undefined, status?: NodeStatusEnum | undefined, role?: NodeRoleEnum | undefined, type?: NodeTypeEnum | undefined, archive?: boolean | undefined, public_network?: ('ethereum-mainnet' | 'ethereum-ropsten-testnet' | 'ethereum-rinkeby-testnet' | 'polygon-pos-mainnet' | 'polygon-pos-testnet' | 'bsc-mainnet' | 'bsc-testnet' | 'avalanche-mainnet' | 'avalanche-testnet' | 'arbitrum-mainnet' | 'arbitrum-goerli' | 'near-mainnet' | 'near-testnet' | 'aurora-mainnet' | 'aurora-testnet' | 'gnosis-mainnet' | 'gnosis-testnet' | 'cronos-mainnet' | 'cronos-testnet' | 'fantom-mainnet' | 'fantom-testnet' | 'starknet-mainnet' | 'starknet-testnet' | 'tezos-mainnet' | 'tezos-testnet' | 'fuse-mainnet' | 'fuse-testnet' | 'bitcoin-mainnet' | 'bitcoin-testnet') | undefined, name?: string | undefined, project_type?: ProjectTypeEnum | undefined}; export type GetApiV1NodesOptions = {baseUrl?: string | undefined, APIKeyAuthentication?: string | undefined, fetch?: typeof fetch | undefined}; export const nodeTypeEnum = z.enum(["shared", "dedicated"]); export const provider = z.enum(["aws", "azure", "gcloud", "vzo"]); export const region = z.enum(["asia-southeast1", "ap-southeast-1", "us-west-2", "us-east-1", "uksouth", "eu3"]); export const ethereumNodeDetails = z.object({mode: z.enum(["full", "archive"]).optional(), version: z.string().optional(), api_namespaces: z.array(z.string()).optional(), https_endpoint: z.string().optional(), wss_endpoint: z.string().optional(), beacon_endpoint: z.string().optional(), graphql_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const binanceSmartChainNodeDetails = z.object({mode: z.enum(["full", "archive"]).optional(), version: z.string().optional(), api_namespaces: z.array(z.string()).optional(), https_endpoint: z.string().optional(), wss_endpoint: z.string().optional(), graphql_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const avalancheNodeDetails = z.object({version: z.string().optional(), api_namespaces: z.array(z.string()).optional(), https_endpoint: z.string().optional(), wss_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const fantomNodeDetails = z.object({version: z.string().optional(), api_namespaces: z.array(z.string()).optional(), https_endpoint: z.string().optional(), wss_endpoint: z.string().optional(), graphql_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const tezosNodeDetails = z.object({version: z.string().optional(), https_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const solanaNodeDetails = z.object({version: z.string().optional(), https_endpoint: z.string().optional(), wss_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const starknetNodeDetails = z.object({version: z.string().optional(), https_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const bitcoinNodeDetails = z.object({version: z.string().optional(), https_endpoint: z.string().optional(), auth_username: z.string().optional(), auth_password: z.string().optional(), auth_key: z.string().optional()}); export const nodeDetails = z.union([ethereumNodeDetails, binanceSmartChainNodeDetails, avalancheNodeDetails, fantomNodeDetails, tezosNodeDetails, solanaNodeDetails, starknetNodeDetails, bitcoinNodeDetails]); export const nodeStatusEnum = z.enum(["pending", "running", "maintenance", "failed", "error", "stopping", "stopped", "starting"]); export const object = z.object({id: z.string().optional(), name: z.string().optional()}); export const creator = z.object({id: z.string().optional(), email: z.string().optional(), first_name: z.string().optional(), last_name: z.string().optional(), organization: object.optional()}); export const createdAt = z.string(); export const nodeRoleEnum = z.literal("peer"); export const ethereumNodeConfiguration = z.object({archive: z.boolean().optional()}); export const polygonPoSNodeConfiguration = z.object({archive: z.boolean().optional()}); export const binanceSmartChainNodeConfiguration = z.object({archive: z.boolean().optional()}); export const avalancheNodeConfiguration = z.object({archive: z.boolean().optional()}); export const fantomNodeConfiguration = z.object({archive: z.boolean().optional()}); export const tezosNodeConfiguration = z.object({archive: z.boolean().optional(), tezos_node_type: z.string().optional()}); export const solanaNodeConfiguration = z.object({}); export const starknetNodeConfiguration = z.object({}); export const nodeConfiguration = z.union([ethereumNodeConfiguration, polygonPoSNodeConfiguration, binanceSmartChainNodeConfiguration, avalancheNodeConfiguration, fantomNodeConfiguration, tezosNodeConfiguration, solanaNodeConfiguration, starknetNodeConfiguration]); export const getApiV1NodesResponse = z.object({count: z.number().int().optional(), next: z.string().nullable().optional(), previous: z.string().nullable().optional(), results: z.array(z.object({id: z.string().optional(), name: z.string().optional(), network: z.string().optional(), organization: z.string().optional(), type: nodeTypeEnum.optional(), provider: provider.optional(), region: region.optional(), details: nodeDetails.optional(), status: nodeStatusEnum.optional(), creator: creator.optional(), created_at: createdAt.optional(), role: nodeRoleEnum.optional(), configuration: nodeConfiguration.optional()})).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 all Nodes * * GET /v1/nodes/ */ export const getApiV1Nodes = async (args: GetApiV1NodesArgs, options?: GetApiV1NodesOptions) => { const {baseUrl = "https://api.chainstack.com", fetch: fetchFn = fetch, APIKeyAuthentication} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.order_by != null) query.append("order_by", String(args.order_by)) if (args.page != null) query.append("page", String(args.page)) if (args.project != null) query.append("project", String(args.project)) if (args.organization != null) query.append("organization", String(args.organization)) if (args.network != null) query.append("network", String(args.network)) if (args.region != null) query.append("region", String(args.region)) if (args.provider != null) query.append("provider", String(args.provider)) if (args.protocol != null) query.append("protocol", String(args.protocol)) if (args.status != null) query.append("status", String(args.status)) if (args.role != null) query.append("role", String(args.role)) if (args.type != null) query.append("type", String(args.type)) if (args.archive != null) query.append("archive", String(args.archive)) if (args.public_network != null) query.append("public_network", String(args.public_network)) if (args.name != null) query.append("name", String(args.name)) if (args.project_type != null) query.append("project_type", String(args.project_type)) if (APIKeyAuthentication !== undefined) headers.set('authorization', `Bearer ${APIKeyAuthentication}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/nodes/${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(getApiV1NodesResponse, await res.json()) };