import {z} from 'zod' export type NetworkStatusEnum = 'pending' | 'ok' | 'failed' | 'warning' | 'stopping' | 'stopped' | 'starting'; export type Protocol = 'ethereum' | 'polygon-pos' | 'bsc' | 'avalanche' | 'arbitrum' | 'near' | 'aurora' | 'gnosis' | 'cronos' | 'fantom' | 'starknet' | 'tezos' | 'fuse' | 'bitcoin'; export type ProjectTypeEnum = 'public'; export type GetApiV1NetworksArgs = {order_by?: ('name' | 'created_at') | undefined, page?: number | undefined, project?: string | undefined, name?: string | 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, status?: NetworkStatusEnum | undefined, protocol?: Protocol | undefined, project_type?: ProjectTypeEnum | undefined}; export type GetApiV1NetworksOptions = {baseUrl?: string | undefined, APIKeyAuthentication?: string | undefined, fetch?: typeof fetch | undefined}; export const protocol = z.enum(["ethereum", "polygon-pos", "bsc", "avalanche", "arbitrum", "near", "aurora", "gnosis", "cronos", "fantom", "starknet", "tezos", "fuse", "bitcoin"]); export const networkStatusEnum = z.enum(["pending", "ok", "failed", "warning", "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 ethereumNetworkConfiguration = z.object({network: z.enum(["ethereum-mainnet", "ethereum-ropsten-testnet", "ethereum-rinkeby-testnet"]).optional()}); export const polygonPoSNetworkConfiguration = z.object({network: z.enum(["polygon-pos-mainnet", "polygon-pos-testnet"]).optional()}); export const binanceSmartChainNetworkConfiguration = z.object({network: z.enum(["bsc-mainnet", "bsc-testnet"]).optional()}); export const avalancheNetworkConfiguration = z.object({network: z.enum(["avalanche-mainnet", "avalanche-testnet"]).optional()}); export const arbitrumNetworkConfiguration = z.object({network: z.enum(["arbitrum-mainnet", "arbitrum-goerli"]).optional()}); export const nearNetworkConfiguration = z.object({network: z.enum(["near-mainnet", "near-testnet"]).optional()}); export const auroraNetworkConfiguration = z.object({network: z.enum(["aurora-mainnet", "aurora-testnet"]).optional()}); export const gnosisNetworkConfiguration = z.object({network: z.enum(["gnosis-mainnet", "gnosis-testnet"]).optional()}); export const cronosNetworkConfiguration = z.object({network: z.enum(["cronos-mainnet", "cronos-testnet"]).optional()}); export const fantomNetworkConfiguration = z.object({network: z.enum(["fantom-mainnet", "fantom-testnet"]).optional()}); export const tezosNetworkConfiguration = z.object({network: z.enum(["tezos-mainnet", "tezos-testnet"]).optional()}); export const solanaNetworkConfiguration = z.object({network: z.enum(["solana-mainnet", "solana-devnet"]).optional()}); export const fuseNetworkConfiguration = z.object({network: z.enum(["fuse-mainnet", "fuse-testnet"]).optional()}); export const bitcoinNetworkConfiguration = z.object({network: z.enum(["bitcoin-mainnet", "bitcoin-testnet"]).optional()}); export const starknetNetworkConfiguration = z.object({network: z.literal("starknet-mainnet").optional()}); export const configuration = z.union([ethereumNetworkConfiguration, polygonPoSNetworkConfiguration, binanceSmartChainNetworkConfiguration, avalancheNetworkConfiguration, arbitrumNetworkConfiguration, nearNetworkConfiguration, auroraNetworkConfiguration, gnosisNetworkConfiguration, cronosNetworkConfiguration, fantomNetworkConfiguration, tezosNetworkConfiguration, solanaNetworkConfiguration, fuseNetworkConfiguration, bitcoinNetworkConfiguration, starknetNetworkConfiguration]); 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 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 node = 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()}); export const getApiV1NetworksResponse = 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(), project: z.string().optional(), protocol: protocol.optional(), details: z.object({}).optional(), status: networkStatusEnum.optional(), creator: creator.optional(), created_at: createdAt.optional(), configuration: configuration.optional(), nodes: z.array(node).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 Networks * * GET /v1/networks/ */ export const getApiV1Networks = async (args: GetApiV1NetworksArgs, options?: GetApiV1NetworksOptions) => { 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.name != null) query.append("name", String(args.name)) if (args.public_network != null) query.append("public_network", String(args.public_network)) if (args.status != null) query.append("status", String(args.status)) if (args.protocol != null) query.append("protocol", String(args.protocol)) 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/networks/${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(getApiV1NetworksResponse, await res.json()) };