import {z} from 'zod' export type ChainName = string; export type GetApiV1ChainsChainNameStacksArgs = {chain_name: ChainName, stack_id: Array}; export type GetApiV1ChainsChainNameStacksOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const chain = z.object({id: z.string(), name: z.string()}); export const marketplaceContractType = z.enum(["ERC721", "ERC1155"]); export const nFTMetadataAttribute = z.object({display_type: z.enum(["number", "boost_percentage", "boost_number", "date"]).nullable().optional(), trait_type: z.string(), value: z.union([z.string(), z.number(), z.boolean()])}); export const stack = z.object({stack_id: z.string(), chain: chain, contract_address: z.string(), contract_type: marketplaceContractType, created_at: z.string(), updated_at: z.string(), name: z.string().nullable(), description: z.string().nullable(), image: z.string().nullable(), external_url: z.string().nullable(), animation_url: z.string().nullable(), youtube_url: z.string().nullable(), attributes: z.array(nFTMetadataAttribute).nullable()}); export const marketPriceNativeToken = z.object({type: z.literal("NATIVE"), symbol: z.string().nullable()}); export const marketPriceERC20Token = z.object({type: z.literal("ERC20"), contract_address: z.string(), symbol: z.string().nullable(), decimals: z.number().int().nullable()}); export const paymentAmount = z.string(); export const marketPriceFees = z.object({amount: z.string(), type: z.enum(["ROYALTY", "MAKER_ECOSYSTEM", "TAKER_ECOSYSTEM", "PROTOCOL"]), recipient_address: z.string()}); export const convertedPrices = z.record(z.string(), z.string()).nullable(); export const marketPriceDetails = z.object({token: z.discriminatedUnion("type", [marketPriceNativeToken, marketPriceERC20Token]), amount: paymentAmount, fee_inclusive_amount: paymentAmount, fees: z.array(marketPriceFees), converted_prices: convertedPrices}); export const listing = z.object({listing_id: z.string(), price_details: marketPriceDetails, token_id: z.string(), contract_address: z.string(), creator: z.string(), amount: z.string()}); export const bid = z.object({bid_id: z.string(), price_details: marketPriceDetails, token_id: z.string().nullable(), contract_address: z.string(), creator: z.string(), amount: z.string()}); export const lastTrade = z.object({trade_id: z.string(), contract_address: z.string(), token_id: z.string(), price_details: z.array(marketPriceDetails), amount: z.string(), created_at: z.string()}).nullable(); export const market = z.object({floor_listing: listing.nullable(), top_bid: bid.nullable(), last_trade: lastTrade}); export const stackBundle = z.object({stack: stack, stack_count: z.number().int(), market: market.nullable(), listings: z.array(listing), bids: z.array(bid)}); export const getApiV1ChainsChainNameStacksResponse = z.array(stackBundle); 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 NFT stack bundles by stack_id. Response will include Market, Listings & Stack Count information for each stack * * GET /v1/chains/{chain_name}/stacks */ export const getApiV1ChainsChainNameStacks = async (args: GetApiV1ChainsChainNameStacksArgs, options?: GetApiV1ChainsChainNameStacksOptions) => { const {baseUrl = "https://api.sandbox.immutable.com", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") for (const item of args.stack_id ?? []) query.append("stack_id", String(item)) const url = `${baseUrl.replace(/\/+$/, '')}/v1/chains/${encodeURIComponent(String(args.chain_name))}/stacks${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(getApiV1ChainsChainNameStacksResponse, await res.json()) };