@klappay/types 4.0.0 → 4.1.0

package/README.md

@@ -39,6 +39,9 @@ already have it if you use any of them directly.
   `charge.created`. `TypedWebhookPayload`/`WebhookEventDataMap` give the
   exact `data` shape per event, keyed by `event` (a discriminated union —
   see the webhook example below).
+- Deployment metadata and helpers (`TOKEN_DEPLOYMENTS`, `TokenDeployment`,
+  `getTokenDeployment`, `isPaymentDeploymentEnabled`) that resolve a
+  token contract and its decimals per network/environment.
 - A handful of small constants (`TOKEN_ADDRESSES`, `NETWORK_EXPLORERS`,
   `EVM_NETWORKS`, `OPERATIONAL_NETWORKS`, `CHAIN_IDS`,
   `CHARGE_ACCEPTED_PAYMENTS_MAX`) that mirror values the API itself uses —
@@ -123,14 +126,15 @@ needed. See the live API reference for details.
 
 ## Zero-dependency constants
 
-Every plain-object constant this package exports (`TOKEN_ADDRESSES`,
+Every plain constant and deployment resolver this package exports (`TOKEN_DEPLOYMENTS`,
+`getTokenDeployment`, `isPaymentDeploymentEnabled`, `TOKEN_ADDRESSES`,
 `ALT_TOKEN_ADDRESSES`, `CHAIN_IDS`, `NETWORK_LABELS`, `NETWORK_EXPLORERS`,
 `EVM_NETWORKS`, `OPERATIONAL_NETWORKS`, `TOKEN_DECIMALS`,
 `ALT_TOKEN_DECIMALS`) is also available from a second entry point that
 carries zero `zod` in its bundle:
 
 ```ts
-import { CHAIN_IDS, TOKEN_ADDRESSES } from '@klappay/types/constants'
+import { CHAIN_IDS, getTokenDeployment } from '@klappay/types/constants'
 ```
 
 Useful for a browser/wallet-side bundle that only needs these plain
@@ -139,6 +143,20 @@ with the main entry. Everything exported here is identical to (and stays
 in sync with) the same name imported from `@klappay/types` — nothing is
 exclusive to this subpath, it's just a smaller bundle of the same values.
 
+Use `getTokenDeployment(token, network, environment)?.decimals` for token
+amounts. The legacy `TOKEN_DECIMALS = 6` export is deprecated: the BNB
+contracts in the catalog use 18 decimals, and both BNB payment pairs are
+currently disabled. `TOKEN_ADDRESSES` is an address-only compatibility
+view, not a payment-availability matrix. Check `GET /v1/networks` before
+offering a payment method.
+
+Charge responses provide optional `amountExact`, `amountReceivedExact`,
+and `paymentUnavailable`; swap quotes provide optional exact amount and
+fee strings. Prefer the decimal strings for calculations. The original
+numeric fields remain for compatibility and can lose precision. See the
+[charge documentation](https://api.klappay.com/types/charges) for units and
+availability handling.
+
 ## Versioning
 
 This package follows the API's own versioning. A breaking change to a

package/dist/chunk-WKIOAEJ3.mjs

@@ -0,0 +1,137 @@
+// src/networks.constants.ts
+var NETWORK_LABELS = {
+  base: "Base",
+  optimism: "Optimism",
+  polygon: "Polygon",
+  ethereum: "Ethereum",
+  arbitrum: "Arbitrum",
+  avalanche: "Avalanche",
+  bnb: "BNB Chain"
+};
+var NETWORK_EXPLORERS = {
+  base: "https://basescan.org",
+  optimism: "https://optimistic.etherscan.io",
+  polygon: "https://polygonscan.com",
+  ethereum: "https://etherscan.io",
+  arbitrum: "https://arbiscan.io",
+  avalanche: "https://snowtrace.io",
+  bnb: "https://bscscan.com"
+};
+var EVM_NETWORKS = [
+  "base",
+  "optimism",
+  "polygon",
+  "ethereum",
+  "arbitrum",
+  "avalanche",
+  "bnb"
+];
+var OPERATIONAL_NETWORKS = [
+  "base",
+  "arbitrum",
+  "optimism",
+  "polygon",
+  "ethereum",
+  "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/tokens.constants.ts
+var TOKEN_DECIMALS = 6;
+var TOKEN_DEPLOYMENTS = {
+  USDC: {
+    base: {
+      live: { address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", decimals: 6 },
+      test: { address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e", decimals: 6 }
+    },
+    optimism: {
+      live: { address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", decimals: 6 },
+      test: { address: "0x5fd84259d66Cd46123540766Be93DFE6D43130D7", decimals: 6 }
+    },
+    polygon: { live: { address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", decimals: 6 } },
+    ethereum: {
+      live: { address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", decimals: 6 },
+      test: { address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238", decimals: 6 }
+    },
+    arbitrum: { live: { address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", decimals: 6 } },
+    avalanche: { live: { address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E", decimals: 6 } },
+    bnb: { live: { address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d", decimals: 18 } }
+  },
+  USDT: {
+    base: { live: { address: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2", decimals: 6 } },
+    optimism: { live: { address: "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58", decimals: 6 } },
+    polygon: { live: { address: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", decimals: 6 } },
+    ethereum: { live: { address: "0xdAC17F958D2ee523a2206206994597C13D831ec7", decimals: 6 } },
+    arbitrum: { live: { address: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9", decimals: 6 } },
+    avalanche: { live: { address: "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7", decimals: 6 } },
+    bnb: { live: { address: "0x55d398326f99059fF775485246999027B3197955", decimals: 18 } }
+  }
+};
+function getTokenDeployment(token, network, environment) {
+  return TOKEN_DEPLOYMENTS[token][network]?.[environment];
+}
+function isPaymentDeploymentEnabled(token, network, environment) {
+  if (network === "bnb" && environment === "live") return false;
+  return getTokenDeployment(token, network, environment) !== void 0;
+}
+function deriveAddresses(deployments) {
+  const addresses = {};
+  for (const network of EVM_NETWORKS) {
+    const byEnvironment = deployments[network];
+    if (!byEnvironment) continue;
+    const networkAddresses = {};
+    for (const environment of ["live", "test"]) {
+      const deployment = byEnvironment[environment];
+      if (deployment) networkAddresses[environment] = deployment.address;
+    }
+    addresses[network] = networkAddresses;
+  }
+  return addresses;
+}
+var TOKEN_ADDRESSES = {
+  USDC: deriveAddresses(TOKEN_DEPLOYMENTS.USDC),
+  USDT: deriveAddresses(TOKEN_DEPLOYMENTS.USDT)
+};
+
+// src/alt-tokens.constants.ts
+var ALT_TOKEN_DECIMALS = {
+  ETH: 18,
+  BNB: 18,
+  MATIC: 18,
+  AVAX: 18,
+  BTC: 8
+};
+var ALT_TOKEN_ADDRESSES = {
+  base: { ETH: "native", BTC: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf" },
+  optimism: { ETH: "native", BTC: "0x68f180fcCe6836688e9084f035309E29Bf0A2095" },
+  ethereum: { ETH: "native", BTC: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599" },
+  arbitrum: { ETH: "native", BTC: "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f" },
+  polygon: { MATIC: "native", BTC: "0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6" },
+  avalanche: { AVAX: "native" },
+  bnb: { BNB: "native" }
+};
+
+export {
+  NETWORK_LABELS,
+  NETWORK_EXPLORERS,
+  EVM_NETWORKS,
+  OPERATIONAL_NETWORKS,
+  CHAIN_IDS,
+  TOKEN_DECIMALS,
+  TOKEN_DEPLOYMENTS,
+  getTokenDeployment,
+  isPaymentDeploymentEnabled,
+  TOKEN_ADDRESSES,
+  ALT_TOKEN_DECIMALS,
+  ALT_TOKEN_ADDRESSES
+};
+//# sourceMappingURL=chunk-WKIOAEJ3.mjs.map

package/dist/chunk-WKIOAEJ3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/networks.constants.ts","../src/tokens.constants.ts","../src/alt-tokens.constants.ts"],"sourcesContent":["import type { Environment } from './environment'\nimport type { Network } from './networks'\n\nexport const NETWORK_LABELS: Record<Network, string> = {\n  base: 'Base',\n  optimism: 'Optimism',\n  polygon: 'Polygon',\n  ethereum: 'Ethereum',\n  arbitrum: 'Arbitrum',\n  avalanche: 'Avalanche',\n  bnb: 'BNB Chain',\n}\n\nexport const NETWORK_EXPLORERS: Record<Network, string> = {\n  base: 'https://basescan.org',\n  optimism: 'https://optimistic.etherscan.io',\n  polygon: 'https://polygonscan.com',\n  ethereum: 'https://etherscan.io',\n  arbitrum: 'https://arbiscan.io',\n  avalanche: 'https://snowtrace.io',\n  bnb: 'https://bscscan.com',\n}\n\nexport const EVM_NETWORKS = [\n  'base',\n  'optimism',\n  'polygon',\n  'ethereum',\n  'arbitrum',\n  'avalanche',\n  'bnb',\n] as const\nexport type EvmNetwork = (typeof EVM_NETWORKS)[number]\n\nexport const OPERATIONAL_NETWORKS = [\n  'base',\n  'arbitrum',\n  'optimism',\n  'polygon',\n  'ethereum',\n  'avalanche',\n  'bnb',\n] as const\nexport type OperationalNetwork = (typeof OPERATIONAL_NETWORKS)[number]\n\nexport const CHAIN_IDS: Record<EvmNetwork, Partial<Record<Environment, number>>> = {\n  base: { live: 8453, test: 84532 },\n  optimism: { live: 10, test: 11155420 },\n  ethereum: { live: 1, test: 11155111 },\n  polygon: { live: 137 },\n  arbitrum: { live: 42161 },\n  avalanche: { live: 43114 },\n  bnb: { live: 56 },\n}\n","import type { Environment } from './environment'\nimport type { Network } from './networks'\nimport { EVM_NETWORKS } from './networks.constants'\nimport type { Token } from './tokens'\n\nexport const TOKEN_DECIMALS = 6\n\nexport type TokenDeployment = { address: `0x${string}`; decimals: number }\n\ntype DeploymentsByNetwork = Partial<Record<Network, Partial<Record<Environment, TokenDeployment>>>>\ntype AddressesByNetwork = Partial<Record<Network, Partial<Record<Environment, `0x${string}`>>>>\n\nexport const TOKEN_DEPLOYMENTS: Record<Token, DeploymentsByNetwork> = {\n  USDC: {\n    base: {\n      live: { address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', decimals: 6 },\n      test: { address: '0x036CbD53842c5426634e7929541eC2318f3dCF7e', decimals: 6 },\n    },\n    optimism: {\n      live: { address: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85', decimals: 6 },\n      test: { address: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7', decimals: 6 },\n    },\n    polygon: { live: { address: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359', decimals: 6 } },\n    ethereum: {\n      live: { address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', decimals: 6 },\n      test: { address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238', decimals: 6 },\n    },\n    arbitrum: { live: { address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', decimals: 6 } },\n    avalanche: { live: { address: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E', decimals: 6 } },\n    bnb: { live: { address: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', decimals: 18 } },\n  },\n  USDT: {\n    base: { live: { address: '0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2', decimals: 6 } },\n    optimism: { live: { address: '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58', decimals: 6 } },\n    polygon: { live: { address: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F', decimals: 6 } },\n    ethereum: { live: { address: '0xdAC17F958D2ee523a2206206994597C13D831ec7', decimals: 6 } },\n    arbitrum: { live: { address: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9', decimals: 6 } },\n    avalanche: { live: { address: '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7', decimals: 6 } },\n    bnb: { live: { address: '0x55d398326f99059fF775485246999027B3197955', decimals: 18 } },\n  },\n}\n\nexport function getTokenDeployment(\n  token: Token,\n  network: Network,\n  environment: Environment,\n): TokenDeployment | undefined {\n  return TOKEN_DEPLOYMENTS[token][network]?.[environment]\n}\n\nexport function isPaymentDeploymentEnabled(\n  token: Token,\n  network: Network,\n  environment: Environment,\n): boolean {\n  if (network === 'bnb' && environment === 'live') return false\n  return getTokenDeployment(token, network, environment) !== undefined\n}\n\nfunction deriveAddresses(deployments: DeploymentsByNetwork): AddressesByNetwork {\n  const addresses: AddressesByNetwork = {}\n  for (const network of EVM_NETWORKS) {\n    const byEnvironment = deployments[network]\n    if (!byEnvironment) continue\n    const networkAddresses: Partial<Record<Environment, `0x${string}`>> = {}\n    for (const environment of ['live', 'test'] as const) {\n      const deployment = byEnvironment[environment]\n      if (deployment) networkAddresses[environment] = deployment.address\n    }\n    addresses[network] = networkAddresses\n  }\n  return addresses\n}\n\nexport const TOKEN_ADDRESSES: Record<Token, AddressesByNetwork> = {\n  USDC: deriveAddresses(TOKEN_DEPLOYMENTS.USDC),\n  USDT: deriveAddresses(TOKEN_DEPLOYMENTS.USDT),\n}\n","import type { AltToken } from './alt-tokens'\nimport type { Network } from './networks'\n\nexport const ALT_TOKEN_DECIMALS: Record<AltToken, number> = {\n  ETH: 18,\n  BNB: 18,\n  MATIC: 18,\n  AVAX: 18,\n  BTC: 8,\n}\n\nexport const ALT_TOKEN_ADDRESSES: Record<\n  Network,\n  Partial<Record<AltToken, 'native' | `0x${string}`>>\n> = {\n  base: { ETH: 'native', BTC: '0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf' },\n  optimism: { ETH: 'native', BTC: '0x68f180fcCe6836688e9084f035309E29Bf0A2095' },\n  ethereum: { ETH: 'native', BTC: '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599' },\n  arbitrum: { ETH: 'native', BTC: '0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f' },\n  polygon: { MATIC: 'native', BTC: '0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6' },\n  avalanche: { AVAX: 'native' },\n  bnb: { BNB: 'native' },\n}\n"],"mappings":"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","names":[]}

package/dist/{constants-DQGVNS9O.d.mts → constants-021Ybu31.d.mts}

@@ -18,7 +18,16 @@ 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}`>>>>>;
+type TokenDeployment = {
+    address: `0x${string}`;
+    decimals: number;
+};
+type DeploymentsByNetwork = Partial<Record<Network, Partial<Record<Environment, TokenDeployment>>>>;
+type AddressesByNetwork = Partial<Record<Network, Partial<Record<Environment, `0x${string}`>>>>;
+declare const TOKEN_DEPLOYMENTS: Record<Token, DeploymentsByNetwork>;
+declare function getTokenDeployment(token: Token, network: Network, environment: Environment): TokenDeployment | undefined;
+declare function isPaymentDeploymentEnabled(token: Token, network: Network, environment: Environment): boolean;
+declare const TOKEN_ADDRESSES: Record<Token, AddressesByNetwork>;
 
 declare const AltTokenSchema: z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>;
 type AltToken = z.infer<typeof AltTokenSchema>;
@@ -38,4 +47,4 @@ declare function listSwapAlternatives(networks: readonly Network[]): SwapAlterna
 declare const ALT_TOKEN_DECIMALS: Record<AltToken, number>;
 declare const ALT_TOKEN_ADDRESSES: Record<Network, Partial<Record<AltToken, 'native' | `0x${string}`>>>;
 
-export { ALT_TOKEN_ADDRESSES as A, CHAIN_IDS as C, EVM_NETWORKS as E, NETWORK_EXPLORERS as N, OPERATIONAL_NETWORKS as O, type SwapAlternative as S, TOKEN_ADDRESSES as T, ALT_TOKEN_DECIMALS as a, type AltToken as b, AltTokenSchema as c, type Environment as d, EnvironmentSchema as e, type EvmNetwork as f, NETWORK_LABELS as g, type Network as h, NetworkSchema as i, type OperationalNetwork as j, SwapAlternativeSchema as k, TOKEN_DECIMALS as l, type Token as m, TokenSchema as n, listSwapAlternatives as o };
+export { ALT_TOKEN_ADDRESSES as A, CHAIN_IDS as C, EVM_NETWORKS as E, NETWORK_EXPLORERS as N, OPERATIONAL_NETWORKS as O, type SwapAlternative as S, TOKEN_ADDRESSES as T, ALT_TOKEN_DECIMALS as a, type AltToken as b, AltTokenSchema as c, type Environment as d, EnvironmentSchema as e, type EvmNetwork as f, NETWORK_LABELS as g, type Network as h, NetworkSchema as i, type OperationalNetwork as j, SwapAlternativeSchema as k, TOKEN_DECIMALS as l, TOKEN_DEPLOYMENTS as m, type Token as n, type TokenDeployment as o, TokenSchema as p, getTokenDeployment as q, isPaymentDeploymentEnabled as r, listSwapAlternatives as s };

package/dist/{constants-DQGVNS9O.d.ts → constants-021Ybu31.d.ts}

@@ -18,7 +18,16 @@ 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}`>>>>>;
+type TokenDeployment = {
+    address: `0x${string}`;
+    decimals: number;
+};
+type DeploymentsByNetwork = Partial<Record<Network, Partial<Record<Environment, TokenDeployment>>>>;
+type AddressesByNetwork = Partial<Record<Network, Partial<Record<Environment, `0x${string}`>>>>;
+declare const TOKEN_DEPLOYMENTS: Record<Token, DeploymentsByNetwork>;
+declare function getTokenDeployment(token: Token, network: Network, environment: Environment): TokenDeployment | undefined;
+declare function isPaymentDeploymentEnabled(token: Token, network: Network, environment: Environment): boolean;
+declare const TOKEN_ADDRESSES: Record<Token, AddressesByNetwork>;
 
 declare const AltTokenSchema: z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>;
 type AltToken = z.infer<typeof AltTokenSchema>;
@@ -38,4 +47,4 @@ declare function listSwapAlternatives(networks: readonly Network[]): SwapAlterna
 declare const ALT_TOKEN_DECIMALS: Record<AltToken, number>;
 declare const ALT_TOKEN_ADDRESSES: Record<Network, Partial<Record<AltToken, 'native' | `0x${string}`>>>;
 
-export { ALT_TOKEN_ADDRESSES as A, CHAIN_IDS as C, EVM_NETWORKS as E, NETWORK_EXPLORERS as N, OPERATIONAL_NETWORKS as O, type SwapAlternative as S, TOKEN_ADDRESSES as T, ALT_TOKEN_DECIMALS as a, type AltToken as b, AltTokenSchema as c, type Environment as d, EnvironmentSchema as e, type EvmNetwork as f, NETWORK_LABELS as g, type Network as h, NetworkSchema as i, type OperationalNetwork as j, SwapAlternativeSchema as k, TOKEN_DECIMALS as l, type Token as m, TokenSchema as n, listSwapAlternatives as o };
+export { ALT_TOKEN_ADDRESSES as A, CHAIN_IDS as C, EVM_NETWORKS as E, NETWORK_EXPLORERS as N, OPERATIONAL_NETWORKS as O, type SwapAlternative as S, TOKEN_ADDRESSES as T, ALT_TOKEN_DECIMALS as a, type AltToken as b, AltTokenSchema as c, type Environment as d, EnvironmentSchema as e, type EvmNetwork as f, NETWORK_LABELS as g, type Network as h, NetworkSchema as i, type OperationalNetwork as j, SwapAlternativeSchema as k, TOKEN_DECIMALS as l, TOKEN_DEPLOYMENTS as m, type Token as n, type TokenDeployment as o, TokenSchema as p, getTokenDeployment as q, isPaymentDeploymentEnabled as r, listSwapAlternatives as s };

package/dist/constants.d.mts

@@ -1,2 +1,2 @@
-export { A as ALT_TOKEN_ADDRESSES, a as ALT_TOKEN_DECIMALS, C as CHAIN_IDS, E as EVM_NETWORKS, f as EvmNetwork, N as NETWORK_EXPLORERS, g as NETWORK_LABELS, O as OPERATIONAL_NETWORKS, j as OperationalNetwork, T as TOKEN_ADDRESSES, l as TOKEN_DECIMALS } from './constants-DQGVNS9O.mjs';
+export { A as ALT_TOKEN_ADDRESSES, a as ALT_TOKEN_DECIMALS, C as CHAIN_IDS, E as EVM_NETWORKS, f as EvmNetwork, N as NETWORK_EXPLORERS, g as NETWORK_LABELS, O as OPERATIONAL_NETWORKS, j as OperationalNetwork, T as TOKEN_ADDRESSES, l as TOKEN_DECIMALS, m as TOKEN_DEPLOYMENTS, o as TokenDeployment, q as getTokenDeployment, r as isPaymentDeploymentEnabled } from './constants-021Ybu31.mjs';
 import 'zod';

package/dist/constants.d.ts

@@ -1,2 +1,2 @@
-export { A as ALT_TOKEN_ADDRESSES, a as ALT_TOKEN_DECIMALS, C as CHAIN_IDS, E as EVM_NETWORKS, f as EvmNetwork, N as NETWORK_EXPLORERS, g as NETWORK_LABELS, O as OPERATIONAL_NETWORKS, j as OperationalNetwork, T as TOKEN_ADDRESSES, l as TOKEN_DECIMALS } from './constants-DQGVNS9O.js';
+export { A as ALT_TOKEN_ADDRESSES, a as ALT_TOKEN_DECIMALS, C as CHAIN_IDS, E as EVM_NETWORKS, f as EvmNetwork, N as NETWORK_EXPLORERS, g as NETWORK_LABELS, O as OPERATIONAL_NETWORKS, j as OperationalNetwork, T as TOKEN_ADDRESSES, l as TOKEN_DECIMALS, m as TOKEN_DEPLOYMENTS, o as TokenDeployment, q as getTokenDeployment, r as isPaymentDeploymentEnabled } from './constants-021Ybu31.js';
 import 'zod';

package/dist/constants.js

@@ -28,7 +28,10 @@ __export(constants_exports, {
   NETWORK_LABELS: () => NETWORK_LABELS,
   OPERATIONAL_NETWORKS: () => OPERATIONAL_NETWORKS,
   TOKEN_ADDRESSES: () => TOKEN_ADDRESSES,
-  TOKEN_DECIMALS: () => TOKEN_DECIMALS
+  TOKEN_DECIMALS: () => TOKEN_DECIMALS,
+  TOKEN_DEPLOYMENTS: () => TOKEN_DEPLOYMENTS,
+  getTokenDeployment: () => getTokenDeployment,
+  isPaymentDeploymentEnabled: () => isPaymentDeploymentEnabled
 });
 module.exports = __toCommonJS(constants_exports);
 
@@ -81,34 +84,59 @@ var CHAIN_IDS = {
 
 // src/tokens.constants.ts
 var TOKEN_DECIMALS = 6;
-var TOKEN_ADDRESSES = {
+var TOKEN_DEPLOYMENTS = {
   USDC: {
     base: {
-      live: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-      test: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+      live: { address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", decimals: 6 },
+      test: { address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e", decimals: 6 }
     },
     optimism: {
-      live: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
-      test: "0x5fd84259d66Cd46123540766Be93DFE6D43130D7"
+      live: { address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", decimals: 6 },
+      test: { address: "0x5fd84259d66Cd46123540766Be93DFE6D43130D7", decimals: 6 }
     },
-    polygon: { live: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359" },
+    polygon: { live: { address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", decimals: 6 } },
     ethereum: {
-      live: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
-      test: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
+      live: { address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", decimals: 6 },
+      test: { address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238", decimals: 6 }
     },
-    arbitrum: { live: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831" },
-    avalanche: { live: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E" },
-    bnb: { live: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d" }
+    arbitrum: { live: { address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", decimals: 6 } },
+    avalanche: { live: { address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E", decimals: 6 } },
+    bnb: { live: { address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d", decimals: 18 } }
   },
   USDT: {
-    base: { live: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2" },
-    optimism: { live: "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58" },
-    polygon: { live: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F" },
-    ethereum: { live: "0xdAC17F958D2ee523a2206206994597C13D831ec7" },
-    arbitrum: { live: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9" },
-    avalanche: { live: "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7" },
-    bnb: { live: "0x55d398326f99059fF775485246999027B3197955" }
+    base: { live: { address: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2", decimals: 6 } },
+    optimism: { live: { address: "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58", decimals: 6 } },
+    polygon: { live: { address: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", decimals: 6 } },
+    ethereum: { live: { address: "0xdAC17F958D2ee523a2206206994597C13D831ec7", decimals: 6 } },
+    arbitrum: { live: { address: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9", decimals: 6 } },
+    avalanche: { live: { address: "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7", decimals: 6 } },
+    bnb: { live: { address: "0x55d398326f99059fF775485246999027B3197955", decimals: 18 } }
+  }
+};
+function getTokenDeployment(token, network, environment) {
+  return TOKEN_DEPLOYMENTS[token][network]?.[environment];
+}
+function isPaymentDeploymentEnabled(token, network, environment) {
+  if (network === "bnb" && environment === "live") return false;
+  return getTokenDeployment(token, network, environment) !== void 0;
+}
+function deriveAddresses(deployments) {
+  const addresses = {};
+  for (const network of EVM_NETWORKS) {
+    const byEnvironment = deployments[network];
+    if (!byEnvironment) continue;
+    const networkAddresses = {};
+    for (const environment of ["live", "test"]) {
+      const deployment = byEnvironment[environment];
+      if (deployment) networkAddresses[environment] = deployment.address;
+    }
+    addresses[network] = networkAddresses;
   }
+  return addresses;
+}
+var TOKEN_ADDRESSES = {
+  USDC: deriveAddresses(TOKEN_DEPLOYMENTS.USDC),
+  USDT: deriveAddresses(TOKEN_DEPLOYMENTS.USDT)
 };
 
 // src/alt-tokens.constants.ts
@@ -138,6 +166,9 @@ var ALT_TOKEN_ADDRESSES = {
   NETWORK_LABELS,
   OPERATIONAL_NETWORKS,
   TOKEN_ADDRESSES,
-  TOKEN_DECIMALS
+  TOKEN_DECIMALS,
+  TOKEN_DEPLOYMENTS,
+  getTokenDeployment,
+  isPaymentDeploymentEnabled
 });
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/networks.constants.ts","../src/tokens.constants.ts","../src/alt-tokens.constants.ts"],"sourcesContent":["export * from './networks.constants'\nexport * from './tokens.constants'\nexport * from './alt-tokens.constants'\n","import type { Environment } from './environment'\nimport type { Network } from './networks'\n\nexport const NETWORK_LABELS: Record<Network, string> = {\n  base: 'Base',\n  optimism: 'Optimism',\n  polygon: 'Polygon',\n  ethereum: 'Ethereum',\n  arbitrum: 'Arbitrum',\n  avalanche: 'Avalanche',\n  bnb: 'BNB Chain',\n}\n\nexport const NETWORK_EXPLORERS: Record<Network, string> = {\n  base: 'https://basescan.org',\n  optimism: 'https://optimistic.etherscan.io',\n  polygon: 'https://polygonscan.com',\n  ethereum: 'https://etherscan.io',\n  arbitrum: 'https://arbiscan.io',\n  avalanche: 'https://snowtrace.io',\n  bnb: 'https://bscscan.com',\n}\n\nexport const EVM_NETWORKS = [\n  'base',\n  'optimism',\n  'polygon',\n  'ethereum',\n  'arbitrum',\n  'avalanche',\n  'bnb',\n] as const\nexport type EvmNetwork = (typeof EVM_NETWORKS)[number]\n\nexport const OPERATIONAL_NETWORKS = [\n  'base',\n  'arbitrum',\n  'optimism',\n  'polygon',\n  'ethereum',\n  'avalanche',\n  'bnb',\n] as const\nexport type OperationalNetwork = (typeof OPERATIONAL_NETWORKS)[number]\n\nexport const CHAIN_IDS: Record<EvmNetwork, Partial<Record<Environment, number>>> = {\n  base: { live: 8453, test: 84532 },\n  optimism: { live: 10, test: 11155420 },\n  ethereum: { live: 1, test: 11155111 },\n  polygon: { live: 137 },\n  arbitrum: { live: 42161 },\n  avalanche: { live: 43114 },\n  bnb: { live: 56 },\n}\n","import type { Environment } from './environment'\nimport type { Network } from './networks'\nimport type { Token } from './tokens'\n\nexport const TOKEN_DECIMALS = 6\n\nexport const TOKEN_ADDRESSES: Record<\n  Token,\n  Partial<Record<Network, Partial<Record<Environment, `0x${string}`>>>>\n> = {\n  USDC: {\n    base: {\n      live: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n      test: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',\n    },\n    optimism: {\n      live: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',\n      test: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',\n    },\n    polygon: { live: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359' },\n    ethereum: {\n      live: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',\n      test: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',\n    },\n    arbitrum: { live: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831' },\n    avalanche: { live: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E' },\n    bnb: { live: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d' },\n  },\n  USDT: {\n    base: { live: '0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2' },\n    optimism: { live: '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58' },\n    polygon: { live: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F' },\n    ethereum: { live: '0xdAC17F958D2ee523a2206206994597C13D831ec7' },\n    arbitrum: { live: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9' },\n    avalanche: { live: '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7' },\n    bnb: { live: '0x55d398326f99059fF775485246999027B3197955' },\n  },\n}\n","import type { AltToken } from './alt-tokens'\nimport type { Network } from './networks'\n\nexport const ALT_TOKEN_DECIMALS: Record<AltToken, number> = {\n  ETH: 18,\n  BNB: 18,\n  MATIC: 18,\n  AVAX: 18,\n  BTC: 8,\n}\n\nexport const ALT_TOKEN_ADDRESSES: Record<\n  Network,\n  Partial<Record<AltToken, 'native' | `0x${string}`>>\n> = {\n  base: { ETH: 'native', BTC: '0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf' },\n  optimism: { ETH: 'native', BTC: '0x68f180fcCe6836688e9084f035309E29Bf0A2095' },\n  ethereum: { ETH: 'native', BTC: '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599' },\n  arbitrum: { ETH: 'native', BTC: '0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f' },\n  polygon: { MATIC: 'native', BTC: '0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6' },\n  avalanche: { AVAX: 'native' },\n  bnb: { BNB: 'native' },\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,iBAA0C;AAAA,EACrD,MAAM;AAAA,EACN,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,UAAU;AAAA,EACV,WAAW;AAAA,EACX,KAAK;AACP;AAEO,IAAM,oBAA6C;AAAA,EACxD,MAAM;AAAA,EACN,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,UAAU;AAAA,EACV,WAAW;AAAA,EACX,KAAK;AACP;AAEO,IAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,IAAM,YAAsE;AAAA,EACjF,MAAM,EAAE,MAAM,MAAM,MAAM,MAAM;AAAA,EAChC,UAAU,EAAE,MAAM,IAAI,MAAM,SAAS;AAAA,EACrC,UAAU,EAAE,MAAM,GAAG,MAAM,SAAS;AAAA,EACpC,SAAS,EAAE,MAAM,IAAI;AAAA,EACrB,UAAU,EAAE,MAAM,MAAM;AAAA,EACxB,WAAW,EAAE,MAAM,MAAM;AAAA,EACzB,KAAK,EAAE,MAAM,GAAG;AAClB;;;ACjDO,IAAM,iBAAiB;AAEvB,IAAM,kBAGT;AAAA,EACF,MAAM;AAAA,IACJ,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,SAAS,EAAE,MAAM,6CAA6C;AAAA,IAC9D,UAAU;AAAA,MACR,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,UAAU,EAAE,MAAM,6CAA6C;AAAA,IAC/D,WAAW,EAAE,MAAM,6CAA6C;AAAA,IAChE,KAAK,EAAE,MAAM,6CAA6C;AAAA,EAC5D;AAAA,EACA,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,6CAA6C;AAAA,IAC3D,UAAU,EAAE,MAAM,6CAA6C;AAAA,IAC/D,SAAS,EAAE,MAAM,6CAA6C;AAAA,IAC9D,UAAU,EAAE,MAAM,6CAA6C;AAAA,IAC/D,UAAU,EAAE,MAAM,6CAA6C;AAAA,IAC/D,WAAW,EAAE,MAAM,6CAA6C;AAAA,IAChE,KAAK,EAAE,MAAM,6CAA6C;AAAA,EAC5D;AACF;;;AClCO,IAAM,qBAA+C;AAAA,EAC1D,KAAK;AAAA,EACL,KAAK;AAAA,EACL,OAAO;AAAA,EACP,MAAM;AAAA,EACN,KAAK;AACP;AAEO,IAAM,sBAGT;AAAA,EACF,MAAM,EAAE,KAAK,UAAU,KAAK,6CAA6C;AAAA,EACzE,UAAU,EAAE,KAAK,UAAU,KAAK,6CAA6C;AAAA,EAC7E,UAAU,EAAE,KAAK,UAAU,KAAK,6CAA6C;AAAA,EAC7E,UAAU,EAAE,KAAK,UAAU,KAAK,6CAA6C;AAAA,EAC7E,SAAS,EAAE,OAAO,UAAU,KAAK,6CAA6C;AAAA,EAC9E,WAAW,EAAE,MAAM,SAAS;AAAA,EAC5B,KAAK,EAAE,KAAK,SAAS;AACvB;","names":[]}
+{"version":3,"sources":["../src/constants.ts","../src/networks.constants.ts","../src/tokens.constants.ts","../src/alt-tokens.constants.ts"],"sourcesContent":["export * from './networks.constants'\nexport * from './tokens.constants'\nexport * from './alt-tokens.constants'\n","import type { Environment } from './environment'\nimport type { Network } from './networks'\n\nexport const NETWORK_LABELS: Record<Network, string> = {\n  base: 'Base',\n  optimism: 'Optimism',\n  polygon: 'Polygon',\n  ethereum: 'Ethereum',\n  arbitrum: 'Arbitrum',\n  avalanche: 'Avalanche',\n  bnb: 'BNB Chain',\n}\n\nexport const NETWORK_EXPLORERS: Record<Network, string> = {\n  base: 'https://basescan.org',\n  optimism: 'https://optimistic.etherscan.io',\n  polygon: 'https://polygonscan.com',\n  ethereum: 'https://etherscan.io',\n  arbitrum: 'https://arbiscan.io',\n  avalanche: 'https://snowtrace.io',\n  bnb: 'https://bscscan.com',\n}\n\nexport const EVM_NETWORKS = [\n  'base',\n  'optimism',\n  'polygon',\n  'ethereum',\n  'arbitrum',\n  'avalanche',\n  'bnb',\n] as const\nexport type EvmNetwork = (typeof EVM_NETWORKS)[number]\n\nexport const OPERATIONAL_NETWORKS = [\n  'base',\n  'arbitrum',\n  'optimism',\n  'polygon',\n  'ethereum',\n  'avalanche',\n  'bnb',\n] as const\nexport type OperationalNetwork = (typeof OPERATIONAL_NETWORKS)[number]\n\nexport const CHAIN_IDS: Record<EvmNetwork, Partial<Record<Environment, number>>> = {\n  base: { live: 8453, test: 84532 },\n  optimism: { live: 10, test: 11155420 },\n  ethereum: { live: 1, test: 11155111 },\n  polygon: { live: 137 },\n  arbitrum: { live: 42161 },\n  avalanche: { live: 43114 },\n  bnb: { live: 56 },\n}\n","import type { Environment } from './environment'\nimport type { Network } from './networks'\nimport { EVM_NETWORKS } from './networks.constants'\nimport type { Token } from './tokens'\n\nexport const TOKEN_DECIMALS = 6\n\nexport type TokenDeployment = { address: `0x${string}`; decimals: number }\n\ntype DeploymentsByNetwork = Partial<Record<Network, Partial<Record<Environment, TokenDeployment>>>>\ntype AddressesByNetwork = Partial<Record<Network, Partial<Record<Environment, `0x${string}`>>>>\n\nexport const TOKEN_DEPLOYMENTS: Record<Token, DeploymentsByNetwork> = {\n  USDC: {\n    base: {\n      live: { address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', decimals: 6 },\n      test: { address: '0x036CbD53842c5426634e7929541eC2318f3dCF7e', decimals: 6 },\n    },\n    optimism: {\n      live: { address: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85', decimals: 6 },\n      test: { address: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7', decimals: 6 },\n    },\n    polygon: { live: { address: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359', decimals: 6 } },\n    ethereum: {\n      live: { address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', decimals: 6 },\n      test: { address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238', decimals: 6 },\n    },\n    arbitrum: { live: { address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', decimals: 6 } },\n    avalanche: { live: { address: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E', decimals: 6 } },\n    bnb: { live: { address: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', decimals: 18 } },\n  },\n  USDT: {\n    base: { live: { address: '0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2', decimals: 6 } },\n    optimism: { live: { address: '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58', decimals: 6 } },\n    polygon: { live: { address: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F', decimals: 6 } },\n    ethereum: { live: { address: '0xdAC17F958D2ee523a2206206994597C13D831ec7', decimals: 6 } },\n    arbitrum: { live: { address: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9', decimals: 6 } },\n    avalanche: { live: { address: '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7', decimals: 6 } },\n    bnb: { live: { address: '0x55d398326f99059fF775485246999027B3197955', decimals: 18 } },\n  },\n}\n\nexport function getTokenDeployment(\n  token: Token,\n  network: Network,\n  environment: Environment,\n): TokenDeployment | undefined {\n  return TOKEN_DEPLOYMENTS[token][network]?.[environment]\n}\n\nexport function isPaymentDeploymentEnabled(\n  token: Token,\n  network: Network,\n  environment: Environment,\n): boolean {\n  if (network === 'bnb' && environment === 'live') return false\n  return getTokenDeployment(token, network, environment) !== undefined\n}\n\nfunction deriveAddresses(deployments: DeploymentsByNetwork): AddressesByNetwork {\n  const addresses: AddressesByNetwork = {}\n  for (const network of EVM_NETWORKS) {\n    const byEnvironment = deployments[network]\n    if (!byEnvironment) continue\n    const networkAddresses: Partial<Record<Environment, `0x${string}`>> = {}\n    for (const environment of ['live', 'test'] as const) {\n      const deployment = byEnvironment[environment]\n      if (deployment) networkAddresses[environment] = deployment.address\n    }\n    addresses[network] = networkAddresses\n  }\n  return addresses\n}\n\nexport const TOKEN_ADDRESSES: Record<Token, AddressesByNetwork> = {\n  USDC: deriveAddresses(TOKEN_DEPLOYMENTS.USDC),\n  USDT: deriveAddresses(TOKEN_DEPLOYMENTS.USDT),\n}\n","import type { AltToken } from './alt-tokens'\nimport type { Network } from './networks'\n\nexport const ALT_TOKEN_DECIMALS: Record<AltToken, number> = {\n  ETH: 18,\n  BNB: 18,\n  MATIC: 18,\n  AVAX: 18,\n  BTC: 8,\n}\n\nexport const ALT_TOKEN_ADDRESSES: Record<\n  Network,\n  Partial<Record<AltToken, 'native' | `0x${string}`>>\n> = {\n  base: { ETH: 'native', BTC: '0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf' },\n  optimism: { ETH: 'native', BTC: '0x68f180fcCe6836688e9084f035309E29Bf0A2095' },\n  ethereum: { ETH: 'native', BTC: '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599' },\n  arbitrum: { ETH: 'native', BTC: '0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f' },\n  polygon: { MATIC: 'native', BTC: '0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6' },\n  avalanche: { AVAX: 'native' },\n  bnb: { BNB: 'native' },\n}\n"],"mappings":"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","names":[]}

package/dist/constants.mjs

@@ -7,8 +7,11 @@ import {
   NETWORK_LABELS,
   OPERATIONAL_NETWORKS,
   TOKEN_ADDRESSES,
-  TOKEN_DECIMALS
-} from "./chunk-KZ3646WX.mjs";
+  TOKEN_DECIMALS,
+  TOKEN_DEPLOYMENTS,
+  getTokenDeployment,
+  isPaymentDeploymentEnabled
+} from "./chunk-WKIOAEJ3.mjs";
 export {
   ALT_TOKEN_ADDRESSES,
   ALT_TOKEN_DECIMALS,
@@ -18,6 +21,9 @@ export {
   NETWORK_LABELS,
   OPERATIONAL_NETWORKS,
   TOKEN_ADDRESSES,
-  TOKEN_DECIMALS
+  TOKEN_DECIMALS,
+  TOKEN_DEPLOYMENTS,
+  getTokenDeployment,
+  isPaymentDeploymentEnabled
 };
 //# sourceMappingURL=constants.mjs.map

package/dist/index.d.mts

@@ -1,5 +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.mjs';
+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_DEPLOYMENTS, n as Token, o as TokenDeployment, p as TokenSchema, q as getTokenDeployment, r as isPaymentDeploymentEnabled, s as listSwapAlternatives } from './constants-021Ybu31.mjs';
 
 declare const ErrorPayloadSchema: z.ZodObject<{
     error: z.ZodObject<{
@@ -359,11 +359,14 @@ type CreateChargeRequest = z.input<typeof CreateChargeSchema>;
 declare const ChargeSchema: z.ZodObject<{
     id: z.ZodString;
     amount: z.ZodNumber;
+    amountExact: z.ZodOptional<z.ZodString>;
     feePayer: z.ZodEnum<["merchant", "payer"]>;
     feePercent: z.ZodNumber;
     feeAmount: z.ZodNumber;
     merchantAmount: z.ZodNumber;
     amountReceived: z.ZodNullable<z.ZodNumber>;
+    amountReceivedExact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    paymentUnavailable: z.ZodOptional<z.ZodBoolean>;
     isOverpaid: z.ZodBoolean;
     currency: z.ZodString;
     acceptedPayments: z.ZodArray<z.ZodObject<{
@@ -598,6 +601,9 @@ declare const ChargeSchema: z.ZodObject<{
     confirmedAt: string | null;
     settledAt: string | null;
     lastActivityAt: string;
+    amountExact?: string | undefined;
+    amountReceivedExact?: string | null | undefined;
+    paymentUnavailable?: boolean | undefined;
 }, {
     status: "pending" | "partially_paid" | "confirmed" | "expired" | "underpaid";
     address: string;
@@ -674,6 +680,9 @@ declare const ChargeSchema: z.ZodObject<{
     confirmedAt: string | null;
     settledAt: string | null;
     lastActivityAt: string;
+    amountExact?: string | undefined;
+    amountReceivedExact?: string | null | undefined;
+    paymentUnavailable?: boolean | undefined;
 }>;
 type Charge = z.infer<typeof ChargeSchema>;
 declare const ListChargesSchema: z.ZodObject<{
@@ -711,11 +720,14 @@ declare const PaginatedChargesSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         amount: z.ZodNumber;
+        amountExact: z.ZodOptional<z.ZodString>;
         feePayer: z.ZodEnum<["merchant", "payer"]>;
         feePercent: z.ZodNumber;
         feeAmount: z.ZodNumber;
         merchantAmount: z.ZodNumber;
         amountReceived: z.ZodNullable<z.ZodNumber>;
+        amountReceivedExact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        paymentUnavailable: z.ZodOptional<z.ZodBoolean>;
         isOverpaid: z.ZodBoolean;
         currency: z.ZodString;
         acceptedPayments: z.ZodArray<z.ZodObject<{
@@ -950,6 +962,9 @@ declare const PaginatedChargesSchema: z.ZodObject<{
         confirmedAt: string | null;
         settledAt: string | null;
         lastActivityAt: string;
+        amountExact?: string | undefined;
+        amountReceivedExact?: string | null | undefined;
+        paymentUnavailable?: boolean | undefined;
     }, {
         status: "pending" | "partially_paid" | "confirmed" | "expired" | "underpaid";
         address: string;
@@ -1026,6 +1041,9 @@ declare const PaginatedChargesSchema: z.ZodObject<{
         confirmedAt: string | null;
         settledAt: string | null;
         lastActivityAt: string;
+        amountExact?: string | undefined;
+        amountReceivedExact?: string | null | undefined;
+        paymentUnavailable?: boolean | undefined;
     }>, "many">;
     nextCursor: z.ZodNullable<z.ZodString>;
     hasMore: z.ZodBoolean;
@@ -1106,6 +1124,9 @@ declare const PaginatedChargesSchema: z.ZodObject<{
         confirmedAt: string | null;
         settledAt: string | null;
         lastActivityAt: string;
+        amountExact?: string | undefined;
+        amountReceivedExact?: string | null | undefined;
+        paymentUnavailable?: boolean | undefined;
     }[];
     nextCursor: string | null;
     hasMore: boolean;
@@ -1186,6 +1207,9 @@ declare const PaginatedChargesSchema: z.ZodObject<{
         confirmedAt: string | null;
         settledAt: string | null;
         lastActivityAt: string;
+        amountExact?: string | undefined;
+        amountReceivedExact?: string | null | undefined;
+        paymentUnavailable?: boolean | undefined;
     }[];
     nextCursor: string | null;
     hasMore: boolean;
@@ -1224,11 +1248,14 @@ type CheckChargeRequest = z.infer<typeof CheckChargeRequestSchema>;
 declare const CheckChargeResponseSchema: z.ZodObject<{
     id: z.ZodString;
     amount: z.ZodNumber;
+    amountExact: z.ZodOptional<z.ZodString>;
     feePayer: z.ZodEnum<["merchant", "payer"]>;
     feePercent: z.ZodNumber;
     feeAmount: z.ZodNumber;
     merchantAmount: z.ZodNumber;
     amountReceived: z.ZodNullable<z.ZodNumber>;
+    amountReceivedExact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    paymentUnavailable: z.ZodOptional<z.ZodBoolean>;
     isOverpaid: z.ZodBoolean;
     currency: z.ZodString;
     acceptedPayments: z.ZodArray<z.ZodObject<{
@@ -1488,6 +1515,9 @@ declare const CheckChargeResponseSchema: z.ZodObject<{
         blocksSeen: number;
         blocksRequired: number;
     } | null;
+    amountExact?: string | undefined;
+    amountReceivedExact?: string | null | undefined;
+    paymentUnavailable?: boolean | undefined;
 }, {
     status: "pending" | "partially_paid" | "confirmed" | "expired" | "underpaid";
     address: string;
@@ -1571,6 +1601,9 @@ declare const CheckChargeResponseSchema: z.ZodObject<{
         blocksSeen: number;
         blocksRequired: number;
     } | null;
+    amountExact?: string | undefined;
+    amountReceivedExact?: string | null | undefined;
+    paymentUnavailable?: boolean | undefined;
 }>;
 type CheckChargeResponse = z.infer<typeof CheckChargeResponseSchema>;
 
@@ -3079,18 +3112,26 @@ declare const SwapQuoteSchema: z.ZodObject<{
     inputToken: z.ZodEnum<["ETH", "BNB", "MATIC", "AVAX", "BTC"]>;
     inputNetwork: z.ZodEnum<["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]>;
     inputAmount: z.ZodNumber;
+    inputAmountExact: z.ZodOptional<z.ZodString>;
     outputToken: z.ZodEnum<["USDC", "USDT"]>;
     outputNetwork: z.ZodEnum<["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]>;
     outputAmount: z.ZodNumber;
+    outputAmountExact: z.ZodOptional<z.ZodString>;
     fees: z.ZodObject<{
         klappayFee: z.ZodNumber;
+        klappayFeeExact: z.ZodOptional<z.ZodString>;
         zeroExFee: z.ZodNullable<z.ZodNumber>;
+        zeroExFeeExact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
         klappayFee: number;
         zeroExFee: number | null;
+        klappayFeeExact?: string | undefined;
+        zeroExFeeExact?: string | null | undefined;
     }, {
         klappayFee: number;
         zeroExFee: number | null;
+        klappayFeeExact?: string | undefined;
+        zeroExFeeExact?: string | null | undefined;
     }>;
     expiresAt: z.ZodString;
     transaction: z.ZodObject<{
@@ -3124,12 +3165,16 @@ declare const SwapQuoteSchema: z.ZodObject<{
     fees: {
         klappayFee: number;
         zeroExFee: number | null;
+        klappayFeeExact?: string | undefined;
+        zeroExFeeExact?: string | null | undefined;
     };
     transaction: {
         value: string;
         data: string;
         to: string;
     };
+    inputAmountExact?: string | undefined;
+    outputAmountExact?: string | undefined;
     permit2?: {
         eip712: Record<string, unknown>;
     } | null | undefined;
@@ -3144,12 +3189,16 @@ declare const SwapQuoteSchema: z.ZodObject<{
     fees: {
         klappayFee: number;
         zeroExFee: number | null;
+        klappayFeeExact?: string | undefined;
+        zeroExFeeExact?: string | null | undefined;
     };
     transaction: {
         value: string;
         data: string;
         to: string;
     };
+    inputAmountExact?: string | undefined;
+    outputAmountExact?: string | undefined;
     permit2?: {
         eip712: Record<string, unknown>;
     } | null | undefined;