import {z} from 'zod' export type GetApiMainPageTransactionsOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const fee = z.object({type: z.string(), value: z.string()}); export const addressTag = z.object({address_hash: z.string(), display_name: z.string(), label: z.string()}); export const watchlistName = z.object({display_name: z.string(), label: z.string()}); export const addressParam = z.object({hash: z.string(), implementation_name: z.string(), name: z.string(), ens_domain_name: z.string().optional(), metadata: z.object({}).optional(), is_contract: z.boolean(), private_tags: z.array(addressTag), watchlist_names: z.array(watchlistName), public_tags: z.array(addressTag), is_verified: z.boolean()}); export const tokenInfo = z.object({circulating_market_cap: z.string(), icon_url: z.string(), name: z.string(), decimals: z.string(), symbol: z.string(), address_hash: z.string().optional(), type: z.string(), holders_count: z.string().optional(), exchange_rate: z.string(), total_supply: z.string()}); export const totalERC20 = z.object({decimals: z.string(), value: z.string()}); export const nFTInstance = z.object({is_unique: z.boolean(), id: z.string(), holder_address_hash: z.string().optional(), image_url: z.string().optional(), animation_url: z.string().optional(), external_app_url: z.string().optional(), metadata: z.object({}).optional(), owner: addressParam, token: tokenInfo}); export const totalERC721 = z.object({token_id: z.string(), token_instance: nFTInstance.optional()}); export const totalERC1155 = z.object({token_id: z.string(), decimals: z.string(), value: z.string(), token_instance: nFTInstance.optional()}); export const tokenTransfer = z.object({block_hash: z.string(), from: addressParam, log_index: z.number().int(), method: z.string().optional(), timestamp: z.string().optional(), to: addressParam, token: tokenInfo, total: z.union([totalERC20, totalERC721, totalERC1155]), transaction_hash: z.string(), type: z.string()}); export const transactionActionAaveV3LiquidationCall = z.object({data: z.object({}), protocol: z.string(), type: z.string()}); export const transactionActionAaveV3BSWRF = z.object({data: z.object({}), protocol: z.string(), type: z.string()}); export const transactionActionAaveV3EnableDisableCollateral = z.object({data: z.object({}), protocol: z.string(), type: z.string()}); export const transactionActionUniswapV3MintNFT = z.object({data: z.object({}), protocol: z.string(), type: z.string()}); export const transactionActionUniswapV3BCS = z.object({data: z.object({}), protocol: z.string(), type: z.string()}); export const transactionAction = z.union([transactionActionAaveV3LiquidationCall, transactionActionAaveV3BSWRF, transactionActionAaveV3EnableDisableCollateral, transactionActionUniswapV3MintNFT, transactionActionUniswapV3BCS]); export const decodedInputParameter = z.object({name: z.string(), type: z.string(), value: z.string()}); export const decodedInput = z.object({method_call: z.string(), method_id: z.string(), parameters: z.array(decodedInputParameter)}); export const transaction = z.object({timestamp: z.string(), fee: fee, gas_limit: z.number().int(), block_number: z.number().int(), status: z.string(), method: z.string(), confirmations: z.number().int(), type: z.number().int(), exchange_rate: z.string(), to: addressParam, transaction_burnt_fee: z.string(), max_fee_per_gas: z.string(), result: z.string(), hash: z.string(), gas_price: z.string(), priority_fee: z.string(), base_fee_per_gas: z.string(), from: addressParam, token_transfers: z.array(tokenTransfer), transaction_types: z.array(z.string()), gas_used: z.string(), created_contract: addressParam, position: z.number().int(), nonce: z.number().int(), has_error_in_internal_transactions: z.boolean(), actions: z.array(transactionAction), decoded_input: decodedInput, token_transfers_overflow: z.boolean(), raw_input: z.string(), value: z.string(), max_priority_fee_per_gas: z.string(), revert_reason: z.string(), confirmation_duration: z.object({}), transaction_tag: z.string()}); export const getApiMainPageTransactionsResponse = z.array(transaction); 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 main page transactions * * GET /main-page/transactions */ export const getApiMainPageTransactions = async (options?: GetApiMainPageTransactionsOptions) => { const {baseUrl = "https://eth.blockscout.com/api/v2", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") const url = `${baseUrl.replace(/\/+$/, '')}/main-page/transactions${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(getApiMainPageTransactionsResponse, await res.json()) };