@klappay/types 3.0.1 → 3.1.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+export { A as ALT_TOKEN_ADDRESSES, a as ALT_TOKEN_DECIMALS, b as AltToken, c as AltTokenSchema, C as CHAIN_IDS, E as EVM_NETWORKS, d as Environment, e as EnvironmentSchema, f as EvmNetwork, N as NETWORK_EXPLORERS, g as NETWORK_LABELS, h as Network, i as NetworkSchema, O as OPERATIONAL_NETWORKS, j as OperationalNetwork, S as SwapAlternative, k as SwapAlternativeSchema, T as TOKEN_ADDRESSES, l as TOKEN_DECIMALS, m as Token, n as TokenSchema, o as listSwapAlternatives } from './constants-DQGVNS9O.js';
 
 declare const ErrorPayloadSchema: z.ZodObject<{
     error: z.ZodObject<{
@@ -29,24 +30,12 @@ declare const ErrorPayloadSchema: z.ZodObject<{
 }>;
 type ErrorPayload = z.infer<typeof ErrorPayloadSchema>;
 
-declare const EnvironmentSchema: z.ZodEnum<["live", "test"]>;
-type Environment = z.infer<typeof EnvironmentSchema>;
-
 declare const ApiKeyScopeSchema: z.ZodEnum<["charges:read", "charges:write", "webhooks:read", "webhooks:write", "webhooks:manage_secret", "metrics:read", "metrics:charges:read", "metrics:transactions:read", "metrics:distributions:read", "sandbox:trigger", "charges:split_write", "recipients:read", "recipients:write", "recipients:manage_payout"]>;
 type ApiKeyScope = z.infer<typeof ApiKeyScopeSchema>;
 declare const API_KEY_SCOPES: ["charges:read", "charges:write", "webhooks:read", "webhooks:write", "webhooks:manage_secret", "metrics:read", "metrics:charges:read", "metrics:transactions:read", "metrics:distributions:read", "sandbox:trigger", "charges:split_write", "recipients:read", "recipients:write", "recipients:manage_payout"];
 declare const CONFLICTING_SCOPE_PAIRS: ReadonlyArray<readonly [ApiKeyScope, ApiKeyScope]>;
 declare function findConflictingScopes(scopes: readonly ApiKeyScope[]): readonly [ApiKeyScope, ApiKeyScope] | null;
 
-declare const NetworkSchema: z.ZodEnum<["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]>;
-type Network = z.infer<typeof NetworkSchema>;
-declare const NETWORK_LABELS: Record<Network, string>;
-declare const NETWORK_EXPLORERS: Record<Network, string>;
-declare const EVM_NETWORKS: readonly ["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"];
-type EvmNetwork = (typeof EVM_NETWORKS)[number];
-declare const OPERATIONAL_NETWORKS: readonly ["base", "arbitrum", "optimism", "polygon", "ethereum", "avalanche", "bnb"];
-type OperationalNetwork = (typeof OPERATIONAL_NETWORKS)[number];
-
 declare const PAGINATION_LIMIT_MIN = 1;
 declare const PAGINATION_LIMIT_MAX = 100;
 declare const PAGINATION_LIMIT_DEFAULT = 20;
@@ -76,17 +65,6 @@ declare function paginatedSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodOb
     hasMore: boolean;
 }>;
 
-declare const TokenSchema: z.ZodEnum<["USDC", "USDT"]>;
-type Token = z.infer<typeof TokenSchema>;
-declare const TOKEN_DECIMALS = 6;
-declare const TOKEN_ADDRESSES: Record<Token, Partial<Record<Network, Partial<Record<Environment, `0x${string}`>>>>>;
-
-declare const AltTokenSchema: z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>;
-type AltToken = z.infer<typeof AltTokenSchema>;
-declare const ALT_TOKEN_DECIMALS: Record<AltToken, number>;
-declare const ALT_TOKEN_ADDRESSES: Record<Network, Partial<Record<AltToken, 'native' | `0x${string}`>>>;
-declare function listAltTokensForNetworks(networks: readonly Network[]): AltToken[];
-
 declare const ChargeStatusSchema: z.ZodEnum<["pending", "partially_paid", "confirmed", "expired", "underpaid"]>;
 type ChargeStatus = z.infer<typeof ChargeStatusSchema>;
 declare const SettlementStatusSchema: z.ZodEnum<["pending", "completed", "failed"]>;
@@ -386,7 +364,16 @@ declare const ChargeSchema: z.ZodObject<{
         token: "USDC" | "USDT";
         network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
     }>, "many">;
-    swapAlternatives: z.ZodArray<z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>, "many">;
+    swapAlternatives: z.ZodArray<z.ZodObject<{
+        token: z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>;
+        network: z.ZodEnum<["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]>;
+    }, "strip", z.ZodTypeAny, {
+        token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+        network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+    }, {
+        token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+        network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+    }>, "many">;
     address: z.ZodString;
     status: z.ZodEnum<["pending", "partially_paid", "confirmed", "expired", "underpaid"]>;
     settlementStatus: z.ZodNullable<z.ZodEnum<["pending", "completed", "failed"]>>;
@@ -553,7 +540,10 @@ declare const ChargeSchema: z.ZodObject<{
         token: "USDC" | "USDT";
         network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
     }[];
-    swapAlternatives: ("ETH" | "BNB" | "MATIC" | "AVAX" | "BTC")[];
+    swapAlternatives: {
+        token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+        network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+    }[];
     settlementStatus: "pending" | "completed" | "failed" | null;
     environment: "live" | "test";
     apiKeyId: string | null;
@@ -617,7 +607,10 @@ declare const ChargeSchema: z.ZodObject<{
         token: "USDC" | "USDT";
         network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
     }[];
-    swapAlternatives: ("ETH" | "BNB" | "MATIC" | "AVAX" | "BTC")[];
+    swapAlternatives: {
+        token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+        network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+    }[];
     settlementStatus: "pending" | "completed" | "failed" | null;
     environment: "live" | "test";
     apiKeyId: string | null;
@@ -688,7 +681,16 @@ declare const PaginatedChargesSchema: z.ZodObject<{
             token: "USDC" | "USDT";
             network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
         }>, "many">;
-        swapAlternatives: z.ZodArray<z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>, "many">;
+        swapAlternatives: z.ZodArray<z.ZodObject<{
+            token: z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>;
+            network: z.ZodEnum<["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]>;
+        }, "strip", z.ZodTypeAny, {
+            token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+            network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+        }, {
+            token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+            network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+        }>, "many">;
         address: z.ZodString;
         status: z.ZodEnum<["pending", "partially_paid", "confirmed", "expired", "underpaid"]>;
         settlementStatus: z.ZodNullable<z.ZodEnum<["pending", "completed", "failed"]>>;
@@ -855,7 +857,10 @@ declare const PaginatedChargesSchema: z.ZodObject<{
             token: "USDC" | "USDT";
             network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
         }[];
-        swapAlternatives: ("ETH" | "BNB" | "MATIC" | "AVAX" | "BTC")[];
+        swapAlternatives: {
+            token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+            network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+        }[];
         settlementStatus: "pending" | "completed" | "failed" | null;
         environment: "live" | "test";
         apiKeyId: string | null;
@@ -919,7 +924,10 @@ declare const PaginatedChargesSchema: z.ZodObject<{
             token: "USDC" | "USDT";
             network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
         }[];
-        swapAlternatives: ("ETH" | "BNB" | "MATIC" | "AVAX" | "BTC")[];
+        swapAlternatives: {
+            token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+            network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+        }[];
         settlementStatus: "pending" | "completed" | "failed" | null;
         environment: "live" | "test";
         apiKeyId: string | null;
@@ -987,7 +995,10 @@ declare const PaginatedChargesSchema: z.ZodObject<{
             token: "USDC" | "USDT";
             network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
         }[];
-        swapAlternatives: ("ETH" | "BNB" | "MATIC" | "AVAX" | "BTC")[];
+        swapAlternatives: {
+            token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+            network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+        }[];
         settlementStatus: "pending" | "completed" | "failed" | null;
         environment: "live" | "test";
         apiKeyId: string | null;
@@ -1055,7 +1066,10 @@ declare const PaginatedChargesSchema: z.ZodObject<{
             token: "USDC" | "USDT";
             network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
         }[];
-        swapAlternatives: ("ETH" | "BNB" | "MATIC" | "AVAX" | "BTC")[];
+        swapAlternatives: {
+            token: "ETH" | "BNB" | "MATIC" | "AVAX" | "BTC";
+            network: "base" | "optimism" | "polygon" | "ethereum" | "arbitrum" | "avalanche" | "bnb";
+        }[];
         settlementStatus: "pending" | "completed" | "failed" | null;
         environment: "live" | "test";
         apiKeyId: string | null;
@@ -2621,4 +2635,4 @@ declare const SwapQuoteSchema: z.ZodObject<{
 }>;
 type SwapQuote = z.infer<typeof SwapQuoteSchema>;
 
-export { ALT_TOKEN_ADDRESSES, ALT_TOKEN_DECIMALS, API_KEY_SCOPES, type AcceptedPayment, AcceptedPaymentSchema, type AltToken, AltTokenSchema, type ApiKeyScope, ApiKeyScopeSchema, CHARGE_ACCEPTED_PAYMENTS_MAX, CHARGE_AMOUNT_MAX, CHARGE_EXPIRES_IN_MAX_SECONDS, CHARGE_EXPIRES_IN_MIN_SECONDS, CHARGE_SPLIT_RECIPIENTS_MAX, CHECKOUT_PRODUCTS_MAX, CONFLICTING_SCOPE_PAIRS, type Capabilities, CapabilitiesSchema, type Charge, ChargeSchema, type ChargeStatus, ChargeStatusSchema, ChargeWebhookEventTypeSchema, type ChargesDateField, ChargesDateFieldSchema, type ChargesMetricField, ChargesMetricFieldSchema, type ChargesQueryField, ChargesQueryFieldSchema, type CheckoutProduct, CheckoutProductSchema, type CreateChargeInput, type CreateChargeRequest, CreateChargeSchema, type CreateRecipientInput, type CreateRecipientRequest, CreateRecipientSchema, type CreateSwapQuoteInput, CreateSwapQuoteSchema, type CreateWebhookInput, type CreateWebhookRequest, CreateWebhookSchema, type DistributionsDateField, DistributionsDateFieldSchema, type DistributionsMetricField, DistributionsMetricFieldSchema, type DistributionsQueryField, DistributionsQueryFieldSchema, EVENT_CATEGORY_MAP, EVM_NETWORKS, type Environment, EnvironmentSchema, type ErrorPayload, ErrorPayloadSchema, type EvmNetwork, type GetChargeQrCodeQuery, type GetChargeQrCodeQueryRequest, GetChargeQrCodeQuerySchema, type Health, HealthSchema, type KlappayCheckoutMetadata, KlappayCheckoutMetadataSchema, type ListChargesInput, type ListChargesRequest, ListChargesSchema, type ListWebhookDeliveriesInput, type ListWebhookDeliveriesRequest, ListWebhookDeliveriesSchema, type ListenPendingDistributionsQuery, ListenPendingDistributionsQuerySchema, MAX_METRICS_QUERY_DATE_RANGE_DAYS, METRICS_QUERY_DEFAULT_ROW_LIMIT, METRICS_QUERY_MAX_FILTERS, METRICS_QUERY_MAX_GROUP_BY, METRICS_QUERY_MAX_METRICS, METRICS_QUERY_MAX_ROW_LIMIT, MetadataWithKlappaySchema, type MetricsAggregation, MetricsAggregationSchema, type MetricsDateGranularity, MetricsDateGranularitySchema, type MetricsFilterOperator, MetricsFilterOperatorSchema, type MetricsQuery, type MetricsQueryRequest, type MetricsQueryResult, type MetricsQueryResultRow, MetricsQueryResultRowSchema, MetricsQueryResultSchema, MetricsQuerySchema, type MetricsResource, MetricsResourceSchema, NETWORK_EXPLORERS, NETWORK_LABELS, type Network, NetworkSchema, OPERATIONAL_NETWORKS, type OperationalNetwork, PAGINATION_LIMIT_DEFAULT, PAGINATION_LIMIT_MAX, PAGINATION_LIMIT_MIN, type PaginatedCharges, PaginatedChargesSchema, type PaginatedPendingDistributions, PaginatedPendingDistributionsSchema, type PaginatedWebhookDeliveries, PaginatedWebhookDeliveriesSchema, type PaginationQuery, type PaginationQueryRequest, PaginationQuerySchema, type PendingDistribution, type PendingDistributionEvent, PendingDistributionEventSchema, PendingDistributionRecipientSchema, PendingDistributionSchema, type Recipient, RecipientSchema, type SandboxTriggerInput, SandboxTriggerSchema, type SetRecipientPayoutInput, SetRecipientPayoutSchema, type SettlementStatus, SettlementStatusSchema, type SplitDistributionStatus, SplitDistributionStatusSchema, type SplitRecipient, type SplitRecipientInput, SplitRecipientInputSchema, SplitRecipientSchema, type SwapQuote, SwapQuoteSchema, TOKEN_ADDRESSES, TOKEN_DECIMALS, type TimelineEvent, TimelineEventSchema, type TimelineEventType, TimelineEventTypeSchema, type Token, TokenSchema, type TransactionSource, TransactionSourceSchema, type TransactionsDateField, TransactionsDateFieldSchema, type TransactionsMetricField, TransactionsMetricFieldSchema, type TransactionsQueryField, TransactionsQueryFieldSchema, type TriggerableChargeEvent, TriggerableChargeEventSchema, type TypedWebhookPayload, WEBHOOK_EVENTS_WILDCARD, WEBHOOK_EVENT_CATEGORIES, type Webhook, type WebhookCategory, WebhookCategorySchema, type WebhookDelivery, WebhookDeliveryEventTypeSchema, WebhookDeliverySchema, type WebhookDeliveryStatus, WebhookDeliveryStatusSchema, type WebhookEventDataMap, type WebhookEventType, WebhookEventTypeSchema, type WebhookHealthEventData, type WebhookListItem, WebhookListItemSchema, type WebhookPayload, WebhookPayloadSchema, WebhookSchema, findConflictingScopes, listAltTokensForNetworks, paginatedSchema };
+export { API_KEY_SCOPES, type AcceptedPayment, AcceptedPaymentSchema, type ApiKeyScope, ApiKeyScopeSchema, CHARGE_ACCEPTED_PAYMENTS_MAX, CHARGE_AMOUNT_MAX, CHARGE_EXPIRES_IN_MAX_SECONDS, CHARGE_EXPIRES_IN_MIN_SECONDS, CHARGE_SPLIT_RECIPIENTS_MAX, CHECKOUT_PRODUCTS_MAX, CONFLICTING_SCOPE_PAIRS, type Capabilities, CapabilitiesSchema, type Charge, ChargeSchema, type ChargeStatus, ChargeStatusSchema, ChargeWebhookEventTypeSchema, type ChargesDateField, ChargesDateFieldSchema, type ChargesMetricField, ChargesMetricFieldSchema, type ChargesQueryField, ChargesQueryFieldSchema, type CheckoutProduct, CheckoutProductSchema, type CreateChargeInput, type CreateChargeRequest, CreateChargeSchema, type CreateRecipientInput, type CreateRecipientRequest, CreateRecipientSchema, type CreateSwapQuoteInput, CreateSwapQuoteSchema, type CreateWebhookInput, type CreateWebhookRequest, CreateWebhookSchema, type DistributionsDateField, DistributionsDateFieldSchema, type DistributionsMetricField, DistributionsMetricFieldSchema, type DistributionsQueryField, DistributionsQueryFieldSchema, EVENT_CATEGORY_MAP, type ErrorPayload, ErrorPayloadSchema, type GetChargeQrCodeQuery, type GetChargeQrCodeQueryRequest, GetChargeQrCodeQuerySchema, type Health, HealthSchema, type KlappayCheckoutMetadata, KlappayCheckoutMetadataSchema, type ListChargesInput, type ListChargesRequest, ListChargesSchema, type ListWebhookDeliveriesInput, type ListWebhookDeliveriesRequest, ListWebhookDeliveriesSchema, type ListenPendingDistributionsQuery, ListenPendingDistributionsQuerySchema, MAX_METRICS_QUERY_DATE_RANGE_DAYS, METRICS_QUERY_DEFAULT_ROW_LIMIT, METRICS_QUERY_MAX_FILTERS, METRICS_QUERY_MAX_GROUP_BY, METRICS_QUERY_MAX_METRICS, METRICS_QUERY_MAX_ROW_LIMIT, MetadataWithKlappaySchema, type MetricsAggregation, MetricsAggregationSchema, type MetricsDateGranularity, MetricsDateGranularitySchema, type MetricsFilterOperator, MetricsFilterOperatorSchema, type MetricsQuery, type MetricsQueryRequest, type MetricsQueryResult, type MetricsQueryResultRow, MetricsQueryResultRowSchema, MetricsQueryResultSchema, MetricsQuerySchema, type MetricsResource, MetricsResourceSchema, PAGINATION_LIMIT_DEFAULT, PAGINATION_LIMIT_MAX, PAGINATION_LIMIT_MIN, type PaginatedCharges, PaginatedChargesSchema, type PaginatedPendingDistributions, PaginatedPendingDistributionsSchema, type PaginatedWebhookDeliveries, PaginatedWebhookDeliveriesSchema, type PaginationQuery, type PaginationQueryRequest, PaginationQuerySchema, type PendingDistribution, type PendingDistributionEvent, PendingDistributionEventSchema, PendingDistributionRecipientSchema, PendingDistributionSchema, type Recipient, RecipientSchema, type SandboxTriggerInput, SandboxTriggerSchema, type SetRecipientPayoutInput, SetRecipientPayoutSchema, type SettlementStatus, SettlementStatusSchema, type SplitDistributionStatus, SplitDistributionStatusSchema, type SplitRecipient, type SplitRecipientInput, SplitRecipientInputSchema, SplitRecipientSchema, type SwapQuote, SwapQuoteSchema, type TimelineEvent, TimelineEventSchema, type TimelineEventType, TimelineEventTypeSchema, type TransactionSource, TransactionSourceSchema, type TransactionsDateField, TransactionsDateFieldSchema, type TransactionsMetricField, TransactionsMetricFieldSchema, type TransactionsQueryField, TransactionsQueryFieldSchema, type TriggerableChargeEvent, TriggerableChargeEventSchema, type TypedWebhookPayload, WEBHOOK_EVENTS_WILDCARD, WEBHOOK_EVENT_CATEGORIES, type Webhook, type WebhookCategory, WebhookCategorySchema, type WebhookDelivery, WebhookDeliveryEventTypeSchema, WebhookDeliverySchema, type WebhookDeliveryStatus, WebhookDeliveryStatusSchema, type WebhookEventDataMap, type WebhookEventType, WebhookEventTypeSchema, type WebhookHealthEventData, type WebhookListItem, WebhookListItemSchema, type WebhookPayload, WebhookPayloadSchema, WebhookSchema, findConflictingScopes, paginatedSchema };

package/dist/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   AcceptedPaymentSchema: () => AcceptedPaymentSchema,
   AltTokenSchema: () => AltTokenSchema,
   ApiKeyScopeSchema: () => ApiKeyScopeSchema,
+  CHAIN_IDS: () => CHAIN_IDS,
   CHARGE_ACCEPTED_PAYMENTS_MAX: () => CHARGE_ACCEPTED_PAYMENTS_MAX,
   CHARGE_AMOUNT_MAX: () => CHARGE_AMOUNT_MAX,
   CHARGE_EXPIRES_IN_MAX_SECONDS: () => CHARGE_EXPIRES_IN_MAX_SECONDS,
@@ -93,6 +94,7 @@ __export(index_exports, {
   SplitDistributionStatusSchema: () => SplitDistributionStatusSchema,
   SplitRecipientInputSchema: () => SplitRecipientInputSchema,
   SplitRecipientSchema: () => SplitRecipientSchema,
+  SwapAlternativeSchema: () => SwapAlternativeSchema,
   SwapQuoteSchema: () => SwapQuoteSchema,
   TOKEN_ADDRESSES: () => TOKEN_ADDRESSES,
   TOKEN_DECIMALS: () => TOKEN_DECIMALS,
@@ -115,7 +117,7 @@ __export(index_exports, {
   WebhookPayloadSchema: () => WebhookPayloadSchema,
   WebhookSchema: () => WebhookSchema,
   findConflictingScopes: () => findConflictingScopes,
-  listAltTokensForNetworks: () => listAltTokensForNetworks,
+  listSwapAlternatives: () => listSwapAlternatives,
   paginatedSchema: () => paginatedSchema
 });
 module.exports = __toCommonJS(index_exports);
@@ -175,7 +177,8 @@ function findConflictingScopes(scopes) {
 
 // src/networks.ts
 var import_zod4 = require("zod");
-var NetworkSchema = import_zod4.z.enum(["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]).describe("The blockchain a charge/payment is on.");
+
+// src/networks.constants.ts
 var NETWORK_LABELS = {
   base: "Base",
   optimism: "Optimism",
@@ -212,6 +215,18 @@ var OPERATIONAL_NETWORKS = [
   "avalanche",
   "bnb"
 ];
+var CHAIN_IDS = {
+  base: { live: 8453, test: 84532 },
+  optimism: { live: 10, test: 11155420 },
+  ethereum: { live: 1, test: 11155111 },
+  polygon: { live: 137 },
+  arbitrum: { live: 42161 },
+  avalanche: { live: 43114 },
+  bnb: { live: 56 }
+};
+
+// src/networks.ts
+var NetworkSchema = import_zod4.z.enum(["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]).describe("The blockchain a charge/payment is on.");
 
 // src/pagination.ts
 var import_zod5 = require("zod");
@@ -236,9 +251,8 @@ function paginatedSchema(itemSchema) {
 
 // src/tokens.ts
 var import_zod6 = require("zod");
-var TokenSchema = import_zod6.z.enum(["USDC", "USDT"]).describe(
-  `Which stablecoin the payer will send. Support depends on both \`network\` and \`environment\` \u2014 not every token/network/environment combination is deployed; today, both \`USDC\` and \`USDT\` are deployed on every operational network's \`live\` side except BNB Chain (\`${OPERATIONAL_NETWORKS.join(", ")}\`), but \`test\` coverage varies per network \u2014 Base, Optimism, and Ethereum each have a \`test\` environment (\`USDC\` only; none has an official Sepolia USDT), Arbitrum, Polygon, Avalanche, and BNB Chain have none yet (0xSplits hasn't deployed on Arbitrum Sepolia and has no Polygon, Avalanche Fuji, or BNB testnet support at all). An unconfigured combination is rejected with \`422 token_not_supported\`, not silently accepted. **BNB Chain's \`USDC\` address is Binance-Peg USDC, not an official Circle deployment** \u2014 Circle does not issue native USDC on BNB Chain at all; this is a Binance-custodied, 1:1-pegged BEP-20 token, a materially different trust model than every other \`TOKEN_ADDRESSES\` entry (all verified directly against their real issuer). Accepted at the payer's own risk \u2014 Klappay does not verify or guarantee Binance's collateral backing it. \`USDT\` on BNB Chain is Tether's own official issuance, same trust model as everywhere else. More tokens/networks are expected to be added over time \u2014 check \`TOKEN_ADDRESSES\` in \`@klappay/types\` (or a future \`GET /v1/networks\` capabilities endpoint) for the exact current matrix rather than assuming full coverage.`
-);
+
+// src/tokens.constants.ts
 var TOKEN_DECIMALS = 6;
 var TOKEN_ADDRESSES = {
   USDC: {
@@ -270,11 +284,15 @@ var TOKEN_ADDRESSES = {
   }
 };
 
+// src/tokens.ts
+var TokenSchema = import_zod6.z.enum(["USDC", "USDT"]).describe(
+  `Which stablecoin the payer will send. Support depends on both \`network\` and \`environment\` \u2014 not every token/network/environment combination is deployed; today, both \`USDC\` and \`USDT\` are deployed on every operational network's \`live\` side except BNB Chain (\`${OPERATIONAL_NETWORKS.join(", ")}\`), but \`test\` coverage varies per network \u2014 Base, Optimism, and Ethereum each have a \`test\` environment (\`USDC\` only; none has an official Sepolia USDT), Arbitrum, Polygon, Avalanche, and BNB Chain have none yet (0xSplits hasn't deployed on Arbitrum Sepolia and has no Polygon, Avalanche Fuji, or BNB testnet support at all). An unconfigured combination is rejected with \`422 token_not_supported\`, not silently accepted. **BNB Chain's \`USDC\` address is Binance-Peg USDC, not an official Circle deployment** \u2014 Circle does not issue native USDC on BNB Chain at all; this is a Binance-custodied, 1:1-pegged BEP-20 token, a materially different trust model than every other \`TOKEN_ADDRESSES\` entry (all verified directly against their real issuer). Accepted at the payer's own risk \u2014 Klappay does not verify or guarantee Binance's collateral backing it. \`USDT\` on BNB Chain is Tether's own official issuance, same trust model as everywhere else. More tokens/networks are expected to be added over time \u2014 check \`TOKEN_ADDRESSES\` in \`@klappay/types\` (or a future \`GET /v1/networks\` capabilities endpoint) for the exact current matrix rather than assuming full coverage.`
+);
+
 // src/alt-tokens.ts
 var import_zod7 = require("zod");
-var AltTokenSchema = import_zod7.z.enum(["ETH", "BNB", "MATIC", "AVAX", "BTC"]).describe(
-  "A non-stablecoin cryptocurrency Klappay trusts as swap input for a charge, via the 0x Swap API \u2014 swapped to one of the charge's `acceptedPayments` tokens before it ever reaches the merchant, so the merchant always receives USDC/USDT regardless of what the payer sent. Only a network's own native currency, plus `BTC` (wrapped) on the networks with deep, reputably-custodied liquidity, is trusted today (see `ALT_TOKEN_ADDRESSES`) \u2014 never assume every value here is available on every network."
-);
+
+// src/alt-tokens.constants.ts
 var ALT_TOKEN_DECIMALS = {
   ETH: 18,
   BNB: 18,
@@ -291,14 +309,25 @@ var ALT_TOKEN_ADDRESSES = {
   avalanche: { AVAX: "native" },
   bnb: { BNB: "native" }
 };
-function listAltTokensForNetworks(networks) {
-  const found = /* @__PURE__ */ new Set();
-  for (const network of networks) {
+
+// src/alt-tokens.ts
+var AltTokenSchema = import_zod7.z.enum(["ETH", "BNB", "MATIC", "AVAX", "BTC"]).describe(
+  "A non-stablecoin cryptocurrency Klappay trusts as swap input for a charge, via the 0x Swap API \u2014 swapped to one of the charge's `acceptedPayments` tokens before it ever reaches the merchant, so the merchant always receives USDC/USDT regardless of what the payer sent. Only a network's own native currency, plus `BTC` (wrapped) on the networks with deep, reputably-custodied liquidity, is trusted today (see `ALT_TOKEN_ADDRESSES`) \u2014 never assume every value here is available on every network."
+);
+var SwapAlternativeSchema = import_zod7.z.object({
+  token: AltTokenSchema,
+  network: NetworkSchema.describe(
+    "Which network to send `token` on \u2014 pass both as `inputToken`/`inputNetwork` to `POST /v1/charges/{id}/quote`. The same token can appear more than once here, once per network that trusts it and that this charge accepts payment on."
+  )
+});
+function listSwapAlternatives(networks) {
+  const alternatives = [];
+  for (const network of new Set(networks)) {
     for (const token of Object.keys(ALT_TOKEN_ADDRESSES[network] ?? {})) {
-      found.add(token);
+      alternatives.push({ token, network });
     }
   }
-  return [...found];
+  return alternatives;
 }
 
 // src/charges.ts
@@ -439,8 +468,8 @@ var ChargeSchema = import_zod9.z.object({
   paidWith: import_zod9.z.array(AcceptedPaymentSchema).describe(
     "Every distinct `(token, network)` pair that has actually contributed a credited transfer so far \u2014 empty until the first one arrives. Can hold more than one entry: a charge accepting several pairs can be paid across a combination of them, and every entry here sums toward `amountReceived`."
   ),
-  swapAlternatives: import_zod9.z.array(AltTokenSchema).describe(
-    "Non-stablecoin cryptocurrencies the payer can pay with instead, via `POST /v1/charges/{id}/quote` \u2014 derived from the networks in `acceptedPayments` (e.g. a charge accepting USDC on Base lists `ETH` here, since Base's native currency is trusted as swap input). Recomputed on every read against Klappay's current trusted list, not frozen at creation \u2014 empty if this charge's networks have no trusted alt-token, or if swap-to-pay isn't configured on this deployment."
+  swapAlternatives: import_zod9.z.array(SwapAlternativeSchema).describe(
+    "Every `(token, network)` pair the payer can pay with instead, via `POST /v1/charges/{id}/quote` \u2014 derived from the networks in `acceptedPayments` (e.g. a charge accepting USDC on both Base and Optimism lists `ETH` on Base and `ETH` on Optimism separately, since they're different networks the payer has to choose between, not one merged option). Pass an entry's `token`/`network` straight through as `inputToken`/`inputNetwork`. Recomputed on every read against Klappay's current trusted list, not frozen at creation \u2014 empty if this charge's networks have no trusted alt-token, if swap-to-pay isn't configured on this deployment, or if `environment` is `test` (0x, who powers the swap, has no testnet support at all \u2014 `POST /v1/charges/{id}/quote` always rejects a test-environment charge with `422 swap_test_environment_unsupported`)."
   ),
   address: import_zod9.z.string().describe(
     "The on-chain address the payer must send funds to \u2014 identical across every accepted network (0xSplits addresses are chain-agnostic). Unique per charge, predicted at creation time \u2014 funds sent here go directly to the merchant, Klappay never custodies them."
@@ -1059,6 +1088,7 @@ var SwapQuoteSchema = import_zod19.z.object({
   AcceptedPaymentSchema,
   AltTokenSchema,
   ApiKeyScopeSchema,
+  CHAIN_IDS,
   CHARGE_ACCEPTED_PAYMENTS_MAX,
   CHARGE_AMOUNT_MAX,
   CHARGE_EXPIRES_IN_MAX_SECONDS,
@@ -1126,6 +1156,7 @@ var SwapQuoteSchema = import_zod19.z.object({
   SplitDistributionStatusSchema,
   SplitRecipientInputSchema,
   SplitRecipientSchema,
+  SwapAlternativeSchema,
   SwapQuoteSchema,
   TOKEN_ADDRESSES,
   TOKEN_DECIMALS,
@@ -1148,7 +1179,7 @@ var SwapQuoteSchema = import_zod19.z.object({
   WebhookPayloadSchema,
   WebhookSchema,
   findConflictingScopes,
-  listAltTokensForNetworks,
+  listSwapAlternatives,
   paginatedSchema
 });
 //# sourceMappingURL=index.js.map