import {z} from 'zod' export type ChainName = string; export type PageSize = number; export type PageCursor = string; export type GetApiV1ChainsChainNameSearchNftsArgs = {chain_name: ChainName, contract_address: Array, account_address?: string | undefined, stack_id?: Array | undefined, only_include_owner_listings?: boolean | undefined, page_size?: PageSize | undefined, page_cursor?: PageCursor | undefined}; export type GetApiV1ChainsChainNameSearchNftsOptions = {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 nFTWithStack = z.object({token_id: z.string(), 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(), balance: z.number().int().gte(1).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 nFTBundle = z.object({nft_with_stack: nFTWithStack, market: market.nullable(), listings: z.array(listing), bids: z.array(bid)}); export const page = z.object({previous_cursor: z.string().nullable(), next_cursor: z.string().nullable()}); export const searchNFTsResult = z.object({result: z.array(nFTBundle), page: page}); 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 }; /** * Search NFTs * * GET /v1/chains/{chain_name}/search/nfts */ export const getApiV1ChainsChainNameSearchNfts = async (args: GetApiV1ChainsChainNameSearchNftsArgs, options?: GetApiV1ChainsChainNameSearchNftsOptions) => { 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.contract_address ?? []) query.append("contract_address", String(item)) if (args.account_address != null) query.append("account_address", String(args.account_address)) for (const item of args.stack_id ?? []) query.append("stack_id", String(item)) if (args.only_include_owner_listings != null) query.append("only_include_owner_listings", String(args.only_include_owner_listings)) if (args.page_size != null) query.append("page_size", String(args.page_size)) if (args.page_cursor != null) query.append("page_cursor", String(args.page_cursor)) const url = `${baseUrl.replace(/\/+$/, '')}/v1/chains/${encodeURIComponent(String(args.chain_name))}/search/nfts${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(searchNFTsResult, await res.json()) };