import {z} from 'zod' export type WalletOmsSideDetails = {id: string, asset: string, network: string}; export type DecimalString = string; export type WalletFiatSideDetails = {id: string, asset: 'usd'}; export type CardSideDetails = {id: string, asset: 'usd'}; export type QuoteSourceRequest = {type: 'walletOms', details: WalletOmsSideDetails, amount?: DecimalString | undefined} | {type: 'walletFiat', details: WalletFiatSideDetails, amount?: DecimalString | undefined} | {type: 'card', details: CardSideDetails, amount?: DecimalString | undefined}; export type WalletExternalSideDetails = {id?: string | undefined, blockchainAddress?: string | undefined, asset: string, network: string}; export type AccountHolder = 'customer'; export type BankUsSideDetails = {id: string, asset: 'usd', network: 'ach' | 'achSameDay' | 'wire', accountHolder: AccountHolder}; export type BankIbanSideDetails = {id: string, asset: 'usd', network?: 'swift' | undefined, accountHolder: AccountHolder}; export type BankCanadaSideDetails = {id: string, asset: 'usd' | 'cad', network: 'swift' | 'local', accountHolder: AccountHolder}; export type CashSideDetails = {asset: 'usd', cashLocationId: string, cashLocationReference: string, amount: DecimalString}; export type QuoteSideRequest = {type: 'walletOms', details: WalletOmsSideDetails, amount?: DecimalString | undefined} | {type: 'walletExternal', details: WalletExternalSideDetails, amount?: DecimalString | undefined} | {type: 'bankUs', details: BankUsSideDetails, amount?: DecimalString | undefined} | {type: 'bankIban', details: BankIbanSideDetails, amount?: DecimalString | undefined} | {type: 'bankCanada', details: BankCanadaSideDetails, amount?: DecimalString | undefined} | {type: 'card', details: CardSideDetails, amount?: DecimalString | undefined} | {type: 'cash', details: CashSideDetails}; export type QuoteCreateRequest = {customerId: string, source: QuoteSourceRequest, destination: QuoteSideRequest, sponsorGas?: boolean | undefined, settlementType?: ('internal' | 'external') | undefined, metadata?: {[key: string]: string} | undefined}; export type CreateApiQuotesArgs = {'Idempotency-Key': string, body: QuoteCreateRequest}; export type CreateApiQuotesOptions = {baseUrl?: string | undefined, BearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const typeId = z.string(); export const quoteStatus = z.enum(["open", "accepted", "expired"]); export const sourceToDestination = z.enum(["cryptoToCrypto", "cryptoToCash", "cryptoToFiatAccount", "cashToCrypto", "fiatAccountToCrypto", "fiatAccountToFiatAccount"]); export const ownerType = z.enum(["individual", "business"]); export const address = z.object({line1: z.string().optional(), line2: z.string().optional(), city: z.string().optional(), state: z.string().optional(), country: z.string().optional(), zipCode: z.string().optional()}); export const party = z.discriminatedUnion("relationship", [z.object({relationship: z.literal("customer"), entityType: ownerType.optional(), customerId: typeId}), z.object({relationship: z.literal("otherCustomer"), entityType: ownerType.optional(), customerId: typeId, name: z.string().nullable().optional()}), z.object({relationship: z.literal("externalRegistered"), entityType: ownerType.optional(), counterpartyId: typeId, name: z.string().nullable().optional(), address: address.nullable().optional()}), z.object({relationship: z.literal("externalUnregistered"), name: z.string().nullable().optional(), address: address.nullable().optional()})]); export const blockchainProtocol = z.enum(["evm", "svm", "sui"]); export const blockchainAsset = z.object({protocol: blockchainProtocol, chainId: z.string(), tokenId: z.string()}); export const walletOmsDetails = z.object({id: typeId.optional(), asset: z.string().optional(), network: z.string().optional(), blockchainAddress: z.string().optional(), custodyType: z.enum(["custodial", "embedded"]).optional(), txHash: z.string().optional(), blockchainAsset: blockchainAsset.optional()}); export const walletExternalDetails = z.object({id: typeId.optional(), asset: z.string().optional(), network: z.string().optional(), blockchainAddress: z.string().optional(), custodian: z.string().optional(), otherCustodian: z.string().optional(), txHash: z.string().optional(), blockchainAsset: blockchainAsset.optional()}); export const walletFiatInstrumentDetails = z.object({id: z.string().optional(), asset: z.literal("usd").optional(), provider: z.string().optional()}); export const secCode = z.enum(["ccd", "ppd", "web"]); export const bankUsDetails = z.object({id: typeId.optional(), asset: z.literal("usd").optional(), network: z.enum(["ach", "achSameDay", "wire", "rtp"]).optional(), secCode: secCode.optional(), accountNumberLast4: z.string().optional(), routingNumber: z.string().optional(), bankName: z.string().optional(), accountType: z.enum(["checking", "savings"]).optional(), memo: z.string().optional()}); export const bankIbanDetails = z.object({id: typeId.optional(), asset: z.string().optional(), network: z.literal("swift").optional(), ibanLast4: z.string().optional(), BIC: z.string().optional(), bankAddress: address.optional(), countryCode: z.string().optional(), memo: z.string().optional()}); export const bankCanadaDetails = z.object({id: typeId.optional(), asset: z.enum(["usd", "cad"]).optional(), network: z.enum(["swift", "local"]).optional(), institutionNumber: z.string().optional(), transitNumber: z.string().optional(), accountNumberLast4: z.string().optional(), bankName: z.string().optional(), memo: z.string().optional()}); export const cardDetails = z.object({id: z.string().optional(), asset: z.literal("usd").optional(), network: z.literal("card").optional(), cardNumberLast4: z.string().optional(), cardProvider: z.string().optional(), memo: z.string().optional()}); export const cashDetails = z.object({asset: z.string().optional(), cashLocationId: z.string().optional(), cashLocationReference: z.string().optional(), code: z.string().optional(), expiresAt: z.string().optional(), locationName: z.string().optional(), locationAddress: z.string().optional()}); export const transactionSide = z.discriminatedUnion("type", [z.object({party: party.optional(), type: z.literal("walletOms"), category: z.literal("crypto"), details: walletOmsDetails}), z.object({party: party.optional(), type: z.literal("walletExternal"), category: z.literal("crypto"), details: walletExternalDetails}), z.object({party: party.optional(), type: z.literal("walletFiat"), category: z.literal("fiatAccount"), details: walletFiatInstrumentDetails}), z.object({party: party.optional(), type: z.literal("bankUs"), category: z.literal("fiatAccount"), details: bankUsDetails}), z.object({party: party.optional(), type: z.literal("bankIban"), category: z.literal("fiatAccount"), details: bankIbanDetails}), z.object({party: party.optional(), type: z.literal("bankCanada"), category: z.literal("fiatAccount"), details: bankCanadaDetails}), z.object({party: party.optional(), type: z.literal("card"), category: z.literal("fiatAccount"), details: cardDetails}), z.object({party: party.optional(), type: z.literal("cash"), category: z.literal("cash"), details: cashDetails})]); export const accountHolder = z.literal("customer"); export const payoutOriginBankDetails = z.object({accountHolder: accountHolder.optional(), accountHolderName: z.string().optional(), accountNumber: z.string().nullable().optional(), routingNumber: z.string().nullable().optional(), virtualAccountId: typeId.nullable().optional()}); export const payoutOrigin = z.discriminatedUnion("type", [z.object({type: z.literal("bank"), details: payoutOriginBankDetails}), z.object({type: z.literal("blockchain"), blockchainAddress: z.string().optional(), network: z.string().optional(), txHash: z.string().optional(), custodian: z.string().optional()})]); export const transactionDestination = z.discriminatedUnion("type", [z.object({party: party.optional(), type: z.literal("walletOms"), category: z.literal("crypto"), details: walletOmsDetails, payoutOrigin: payoutOrigin.optional()}), z.object({party: party.optional(), type: z.literal("walletExternal"), category: z.literal("crypto"), details: walletExternalDetails, payoutOrigin: payoutOrigin.optional()}), z.object({party: party.optional(), type: z.literal("bankUs"), category: z.literal("fiatAccount"), details: bankUsDetails, payoutOrigin: payoutOrigin.optional()}), z.object({party: party.optional(), type: z.literal("bankIban"), category: z.literal("fiatAccount"), details: bankIbanDetails, payoutOrigin: payoutOrigin.optional()}), z.object({party: party.optional(), type: z.literal("bankCanada"), category: z.literal("fiatAccount"), details: bankCanadaDetails, payoutOrigin: payoutOrigin.optional()}), z.object({party: party.optional(), type: z.literal("card"), category: z.literal("fiatAccount"), details: cardDetails, payoutOrigin: payoutOrigin.optional()}), z.object({party: party.optional(), type: z.literal("cash"), category: z.literal("cash"), details: cashDetails, payoutOrigin: payoutOrigin.optional()})]); export const feesDeducted = z.object({total: z.string(), developer: z.string(), oms: z.string(), gas: z.string()}); export const pricingSide = z.object({asset: z.string().optional(), amountGross: z.string().optional(), amountNet: z.string().optional(), feesDeducted: feesDeducted.optional()}); export const pricing = z.object({source: pricingSide.optional(), destination: pricingSide.optional(), pair: z.string().optional(), exchangeRate: z.string().optional(), effectiveRate: z.string().optional(), fixedAmountSide: z.enum(["source", "destination"]).optional(), sponsorGas: z.boolean().optional(), sponsorGasCost: z.string().optional()}); export const quote = z.object({id: typeId, object: z.literal("quote"), status: quoteStatus, sourceToDestination: sourceToDestination.optional(), customerId: typeId, source: transactionSide, destination: transactionDestination, pricing: pricing, expiresAt: z.string().optional(), createdAt: z.string().optional(), metadata: z.record(z.string(), z.string()).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 }; /** * Create a payment quote * * POST /quotes */ export const createApiQuotes = async (args: CreateApiQuotesArgs, options?: CreateApiQuotesOptions) => { const {baseUrl = "https://sandbox-api.polygon.technology/v0.10", fetch: fetchFn = fetch, BearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args['Idempotency-Key'] != null) headers.set("Idempotency-Key", String(args['Idempotency-Key'])) if (BearerAuth !== undefined) headers.set('authorization', `Bearer ${BearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/quotes${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(quote, await res.json()) };