import {z} from 'zod' export type ChainID = 1 | 10 | 56 | 137 | 4663 | 8453 | 42161 | 20000000000001 | 20000000000002 | 30000000000001 | 30000000000002; export type CurrencyBase = {address?: (string | null) | undefined, chain_id: ChainID}; export type MetadataItems = {name?: (string | null) | undefined, description?: (string | null) | undefined, image?: (string | null) | undefined, quantity?: (number | null) | undefined, unit_price?: (number | null) | undefined, currency?: (string | null) | undefined}; export type MetadataRefund = {name?: (string | null) | undefined, reason?: (string | null) | undefined, additional_info?: (string | null) | undefined, refund_amount?: (number | null) | undefined, currency?: (string | null) | undefined}; export type OrderMetadata = {items?: Array | undefined, refund?: (MetadataRefund | null) | undefined}; export type RefundOrderRequest = {amount: string, fiat_unit?: (string | null) | undefined, currency?: (CurrencyBase | null) | undefined, recipient?: (string | null) | undefined, metadata?: (OrderMetadata | null) | undefined}; export type CreateApiOrdersOrderIdRefundArgs = {'Authorization-Signature': string, order_id: string, body: RefundOrderRequest}; export type CreateApiOrdersOrderIdRefundOptions = {baseUrl?: string | undefined, Authorization?: string | undefined, fetch?: typeof fetch | undefined}; export const orderMode = z.enum(["SALE", "DEPOSIT", "REFUND", "SWAP", "FEE_CLAIM"]); export const orderStatus = z.enum(["PENDING", "EXPIRED", "FAILED", "AWAITING_PAYMENT", "OPTIMISTIC_CONFIRMED", "AWAITING_CONFIRMATION", "EXECUTING_ORDER", "COMPLETED", "REFUNDED", "PARTIAL_PAYMENT"]); export const chainID = z.union([z.literal(1), z.literal(10), z.literal(56), z.literal(137), z.literal(4663), z.literal(8453), z.literal(42161), z.literal(20000000000001), z.literal(20000000000002), z.literal(30000000000001), z.literal(30000000000002)]); export const currency = z.object({id: z.string(), chain_id: chainID, address: z.string().nullable().optional(), symbol: z.string(), name: z.string().optional(), decimals: z.number().int(), image_uri: z.string().nullable().optional(), chain_image_uri: z.string().nullable().optional(), price_usd: z.number().nullable().optional()}); export const bigInt = z.string(); export const amount = z.object({ui: z.string(), raw: bigInt, value_usd: z.number().nullable().optional()}); export const tradeType = z.enum(["EXACT_INPUT", "EXACT_OUTPUT"]); export const orderSwap = z.object({trade_type: tradeType.optional(), slippage_bps: z.number().int().nullable().optional()}); export const orderFulfillment = z.object({asset: currency.nullable().optional(), amount: amount, fiat_unit: z.string().nullable().optional(), rate_usd: z.string().nullable().optional(), recipient: z.string().nullable().optional(), custom_fee_bps: z.number().int().nullable().optional(), swap: orderSwap.nullable().optional()}); export const paymentRail = z.enum(["CRYPTO", "FIAT"]); export const quoteFees = z.object({total_fee: amount, protocol_fee: amount.nullable().optional(), custom_fee: amount.nullable().optional(), relayer_fee: amount.nullable().optional()}); export const quoteBreakdown = z.object({total: amount, base: amount, fees: quoteFees.nullable().optional(), gas: amount.nullable().optional()}); export const quoteInput = z.object({currency: currency, amount: amount, balance: amount.nullable().optional(), breakdown: quoteBreakdown.nullable().optional()}); export const quoteOutput = z.object({currency: currency, amount: amount, amount_out_minimum: amount.nullable().optional()}); export const paymentFundingTransaction = z.object({tx_hash: z.string(), amount: amount}); export const paymentFunding = z.object({required_amount: amount, received_amount: amount, remaining_amount: amount, transactions: z.array(paymentFundingTransaction)}); export const stepKind = z.enum(["deposit", "transaction", "stripe_onramp"]); export const currencyBase = z.object({address: z.string().nullable().optional(), chain_id: chainID}); export const depositStepData = z.object({deposit_address: z.string(), currency: currencyBase, amount: bigInt}); export const eVMPaymentData = z.object({from: z.string(), to: z.string(), data: z.string(), value: z.string(), chainId: chainID, maxFeePerGas: z.string().optional(), maxPriorityFeePerGas: z.string().optional()}); export const bitcoinPaymentData = z.object({transaction: z.string()}); export const solanaPaymentData = z.object({transaction: z.string()}); export const suiPaymentData = z.object({transaction: z.string()}); export const chainPaymentData = z.union([eVMPaymentData, bitcoinPaymentData, solanaPaymentData, suiPaymentData]); export const stripeOnrampCurrency = z.enum(["usd", "eur"]); export const stripeCryptoCurrency = z.enum(["usdc", "usdb", "usdsui", "usdt", "phantom_cash"]); export const stripeCryptoNetwork = z.enum(["arbitrum", "base", "bitcoin", "ethereum", "polygon", "solana", "sui", "tempo", "worldchain"]); export const stripeOnrampPaymentData = z.object({session_id: z.string().optional(), stripe_publishable_key: z.string(), status: z.string(), source_currency: stripeOnrampCurrency.nullable().optional(), destination_currency: stripeCryptoCurrency, destination_network: stripeCryptoNetwork, destination_amount: z.string(), wallet_address: z.string()}); export const paymentStep = z.object({id: z.string().optional(), purpose: z.string().optional(), status: z.string().optional(), expires_at: z.string().nullable().optional(), rail: paymentRail, kind: stepKind, action: z.string().optional(), description: z.string().optional(), data: z.union([depositStepData, chainPaymentData, stripeOnrampPaymentData]).optional()}); export const paymentRefund = z.object({address: z.string().nullable().optional(), tx_hash: z.string().nullable().optional(), reason: z.string().nullable().optional()}); export const paymentView = z.object({payment_rail: paymentRail, input: quoteInput, output: quoteOutput, funding: paymentFunding.nullable().optional(), recipient: z.string(), steps: z.array(paymentStep), expires_at: z.string(), estimated_duration_seconds: z.number().nullable().optional(), source_tx_hash: z.string().nullable().optional(), destination_tx_hash: z.string().nullable().optional(), fee_tx_hash: z.string().nullable().optional(), refund: paymentRefund.nullable().optional()}); export const metadataItems = z.object({name: z.string().nullable().optional(), description: z.string().nullable().optional(), image: z.string().nullable().optional(), quantity: z.number().int().nullable().optional(), unit_price: z.number().nullable().optional(), currency: z.string().nullable().optional()}); export const metadataRefund = z.object({name: z.string().nullable().optional(), reason: z.string().nullable().optional(), additional_info: z.string().nullable().optional(), refund_amount: z.number().nullable().optional(), currency: z.string().nullable().optional()}); export const orderMetadata = z.object({items: z.array(metadataItems).optional(), refund: metadataRefund.nullable().optional()}); export const organizationSettings = z.object({hide_footer: z.boolean().optional(), card_payments: z.boolean()}).and(z.record(z.string(), z.unknown())); export const orderResponse = z.object({id: z.string(), created_at: z.string(), updated_at: z.string(), organization_id: z.string(), mode: orderMode, status: orderStatus, fulfillment: orderFulfillment, payment: paymentView.nullable().optional(), metadata: orderMetadata.nullable().optional(), settings: organizationSettings.optional(), hosted_url: z.string()}); 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 }; /** * Refund Order * * POST /orders/{order_id}/refund */ export const createApiOrdersOrderIdRefund = async (args: CreateApiOrdersOrderIdRefundArgs, options?: CreateApiOrdersOrderIdRefundOptions) => { const {baseUrl = "https://api.coinvoyage.io/v3", fetch: fetchFn = fetch, Authorization} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args['Authorization-Signature'] != null) headers.set("Authorization-Signature", String(args['Authorization-Signature'])) if (Authorization !== undefined) headers.set("Authorization", Authorization) const url = `${baseUrl.replace(/\/+$/, '')}/orders/${encodeURIComponent(String(args.order_id))}/refund${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(orderResponse, await res.json()) };