import {z} from 'zod' export type GetApiTransactionsTransactionIdArgs = {transactionId: string}; export type GetApiTransactionsTransactionIdOptions = {baseUrl?: string | undefined, BearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const typeId = z.string(); export const sourceToDestination = z.enum(["cryptoToCrypto", "cryptoToCash", "cryptoToFiatAccount", "cashToCrypto", "fiatAccountToCrypto", "fiatAccountToFiatAccount"]); export const transactionStatus = z.enum(["processing", "awaitingAction", "completed", "failed"]); export const transactionSubStatus = z.enum(["processing.fundsPulled", "processing.cashPickupReady", "processing.underReview", "completed.cashPickupCollected", "completed.cashPickupExpired", "awaitingAction.awaitingSenderAttribution", "awaitingAction.depositAddressFrozen", "awaitingAction.depositAddressInactive", "failed.attributionTimeout", "failed.depositAddressFrozenTimeout", "failed.depositAddressInactiveTimeout", "failed.depositAddressClosed", "processing.awaitingCryptoOut", "processing.cryptoOut", "processing.awaitingFiatOut", "processing.fiatOut", "processing.inboundPending", "processing.inboundProcessing", "failed.inboundFailed", "failed.returnPending", "failed.returnStarted", "failed.returnComplete", "failed.returnFailed"]); export const depositAddressDepositInstructions = z.object({asset: z.string(), network: z.string(), address: z.string(), expiresAt: z.string().optional()}); export const precursorDepositAddressDetails = z.object({depositAddressId: typeId, depositInstructions: depositAddressDepositInstructions.optional()}); export const assetNetworkPair = z.object({asset: z.string(), network: z.string()}); export const bankRoutingBlockBeneficiary = z.object({name: z.string(), address: z.string()}); export const bankRoutingBlock = z.object({supportedSources: z.array(assetNetworkPair).optional(), bankName: z.string(), bankAddress: z.string(), accountNumber: z.string(), routingNumber: z.string().nullable(), accountType: z.string().nullable(), BIC: z.string().nullable(), beneficiary: bankRoutingBlockBeneficiary, memo: z.string().nullable()}); export const virtualAccountInstructions = z.object({bankUs: z.array(bankRoutingBlock).optional()}); export const precursorVirtualAccountDetails = z.object({virtualAccountId: typeId, depositInstructions: virtualAccountInstructions.optional()}); export const cashInDepositInstructions = z.object({code: z.string(), expiresAt: z.string(), locationName: z.string().optional(), locationAddress: z.string().optional()}); export const precursorCashInDetails = z.object({cashInId: typeId, depositInstructions: cashInDepositInstructions.optional()}); export const precursorQuoteDetails = z.object({quoteId: typeId}); export const precursor = z.discriminatedUnion("type", [z.object({type: z.literal("depositAddress"), details: precursorDepositAddressDetails}), z.object({type: z.literal("virtualAccount"), details: precursorVirtualAccountDetails}), z.object({type: z.literal("cashIn"), details: precursorCashInDetails}), z.object({type: z.literal("quote"), details: precursorQuoteDetails}), z.object({type: z.literal("manual")})]); 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 destinationCustodian = z.enum(["ANCHORAGE_SG", "ANCHORAGE_US", "AQUANOW_CA", "B2C2_UK", "B2C2_US", "BITGO_SG", "BITGO_US", "BITSTAMP_US", "BVNK_US", "CIRCLE_FR", "CIRCLE_US", "CITIBANK_US", "COINBASE_US", "COINSMART_CA", "COPPER_CH", "COPPER_UK", "CUMBERLAND_DRW_LLC_US", "CUMBERLAND_SG", "EREBOR_BANK_US", "FALCONX_US", "FIDELITY_UK", "FIDELITY_US", "FIREBLOCKS_APAC", "FIREBLOCKS_US", "GALAXY_KY", "GEMINI_US", "KRAKEN_BVI", "KRAKEN_EU_IE", "KRAKEN_UK", "KRAKEN_US", "NUBANK_BR", "PAXOS_US", "RAMP_NETWORK_US", "ROBINHOOD_US", "WINTERMUTE_GB", "SELF_HOSTED", "OTHER"]); export const recoveryReferenceFields = z.object({transactionId: typeId.optional(), sourceTxHash: z.string().optional()}); export const manualRecovery = z.object({type: z.literal("manualRecovery").optional(), custodian: destinationCustodian.optional(), instructions: z.string().optional(), referenceFields: recoveryReferenceFields.optional()}); export const settlementError = z.object({code: z.string(), message: z.string(), occurredAt: z.string(), recoverable: z.boolean(), manualRecovery: manualRecovery.optional()}); export const matchableExternalAccountCriteria = z.object({type: z.literal("walletExternal").optional(), customerId: typeId.optional(), blockchainAddress: z.string().optional(), networkFamily: z.string().optional()}); export const externalAccountStatusReason = z.enum(["deleted", "invalid"]); export const holdInactiveCause = z.object({type: z.literal("destinationExternalAccount").optional(), externalAccountId: typeId.optional(), externalAccountStatus: externalAccountStatusReason.optional(), invalidReason: z.string().optional()}); export const hold = z.discriminatedUnion("type", [z.object({required: z.boolean().optional(), since: z.string().optional(), deadline: z.string().optional(), resolvedAt: z.string().optional(), type: z.literal("senderAttribution"), txHash: z.string().optional(), matchableExternalAccountCriteria: matchableExternalAccountCriteria.optional()}), z.object({required: z.boolean().optional(), since: z.string().optional(), deadline: z.string().optional(), resolvedAt: z.string().optional(), type: z.literal("depositAddressFrozen")}), z.object({required: z.boolean().optional(), since: z.string().optional(), deadline: z.string().optional(), resolvedAt: z.string().optional(), type: z.literal("depositAddressInactive"), cause: holdInactiveCause.optional()})]); export const omsxProjectId = z.string(); export const transaction = z.object({id: typeId, object: z.literal("transaction"), sourceToDestination: sourceToDestination.optional(), status: transactionStatus, subStatus: transactionSubStatus.optional(), customerId: typeId, precursor: precursor, source: transactionSide, destination: transactionDestination, pricing: pricing, estimatedArrival: z.string().optional(), error: settlementError.optional(), hold: hold.optional(), metadata: z.record(z.string(), z.string()).optional(), createdAt: z.string().optional(), updatedAt: z.string().optional(), expiresAt: z.string().optional(), projectId: omsxProjectId.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 }; /** * Get transaction by ID * * GET /transactions/{transactionId} */ export const getApiTransactionsTransactionId = async (args: GetApiTransactionsTransactionIdArgs, options?: GetApiTransactionsTransactionIdOptions) => { const {baseUrl = "https://sandbox-api.polygon.technology/v0.10", fetch: fetchFn = fetch, BearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (BearerAuth !== undefined) headers.set('authorization', `Bearer ${BearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/transactions/${encodeURIComponent(String(args.transactionId))}${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(transaction, await res.json()) };