@zkp2p/sdk 0.2.1 → 0.2.4

package/README.md

@@ -6,7 +6,7 @@
 
 Stable TypeScript SDK for trustless fiat-to-crypto on Base. ZKP2P combines escrowed on-chain settlement, TLS attestations for payment verification, and API/indexer helpers so makers, takers, wallets, and embedded ramps can ship production-grade fiat liquidity flows without building their own contract or indexing stack.
 
-Current version: `0.1.0`
+Current version: `0.2.3`
 
 ## Why This SDK
 
@@ -28,8 +28,8 @@ Current version: `0.1.0`
 
 - RPC-first reads: primary reads use ProtocolViewer and on-chain fallbacks, so `getDeposits()`, `getDeposit()`, `getIntents()`, `getIntent()`, and the `getPv*` methods are not blocked on indexer lag.
 - Indexer for history and filtering: use `client.indexer.*` for pagination, historical volumes, fund activities, daily snapshots, and vault analytics.
-- Current-stack routing: the client resolves against the upgraded escrow and orchestrator contracts by default, while keeping historical escrow lookups available for reads and legacy deposits.
-- Modular internals: stable `0.1.0` extracted intent, vault, and ProtocolViewer logic into `IntentOperations`, `VaultOperations`, and `ProtocolViewerReader`, keeping `Zkp2pClient` focused on orchestration.
+- Current-stack routing: the client resolves against the upgraded escrow and orchestrator contracts, with historical escrow lookups available for reads and legacy deposits.
+- Modular internals: intent, vault, and ProtocolViewer logic are extracted into `IntentOperations`, `VaultOperations`, and `ProtocolViewerReader`, keeping `Zkp2pClient` focused on orchestration.
 - App-level rollout control: the SDK is capability-based. Product gating and phase flags belong in your app layer, not inside transaction helpers.
 
 ## Installation
@@ -72,10 +72,14 @@ const client = new Zkp2pClient({
 
 - Supported runtime environments: `'production'`, `'preproduction'`, `'staging'`
 - `runtimeEnv` default: `'production'`
-- `apiKey`: optional curator API key for authenticated service endpoints
+- `rpcUrl`: optional RPC URL override (defaults to wallet's chain RPC)
+- `apiKey`: optional curator API key — enhances some responses (e.g. `getQuote` returns `depositData` when authenticated) but is **not required** for any SDK method
 - `authorizationToken` / `getAuthorizationToken`: optional bearer auth for hybrid client and indexer flows
 - `indexerApiKey`: optional `x-api-key` for indexer proxy auth
 - `indexerUrl` and `baseApiUrl`: override defaults when you are targeting custom deployments
+- `timeouts`: `{ api?: number }` — API timeout in milliseconds (default 15000)
+
+**No API key is required to get started.** `createDeposit`, `registerPayeeDetails`, `getQuote`, `getTakerTier`, and all other SDK methods work without `apiKey` or `authorizationToken`. Auth credentials are optional and only affect response richness (e.g. authenticated quotes include maker `depositData`).
 
 Indexer defaults by environment:
 
@@ -85,20 +89,20 @@ Indexer defaults by environment:
 
 ## Core Capabilities
 
-| Area                           | Stable surface                                                                                                                                                                                                                           |
-| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Deposits                       | `createDeposit`, `addFunds`, `removeFunds`, `withdrawDeposit`, `ensureAllowance`, `setAcceptingIntents`, `setIntentRange`, `setCurrencyMinRate`, `setRetainOnEmpty`                                                                      |
-| Payment methods and currencies | `addPaymentMethods`, `removePaymentMethod`, `setPaymentMethodActive`, `addCurrencies`, `removeCurrency`, `deactivateCurrency`, `pruneExpiredIntents`                                                                                     |
-| Intents                        | `signalIntent`, `fulfillIntent`, `cancelIntent`, `releaseFundsToPayer`, `getFulfillIntentInputs`                                                                                                                                         |
-| Prepared transactions          | `client.prepareCreateDeposit(...)`, `client.signalIntent.prepare(...)`, `client.fulfillIntent.prepare(...)`, `client.setVaultFee.prepare(...)`, and equivalent prepare flows across the rest of the prepareable write surface            |
-| Payee and quote APIs           | `registerPayeeDetails`, `resolvePayeeHash`, `getQuote`, `getTakerTier`                                                                                                                                                                   |
-| Delegation and hooks           | `setDelegate`, `removeDelegate`, `setRateManager`, `clearRateManager`, `setDepositRateManager`, `clearDepositRateManager`, `setDepositPreIntentHook`, `setDepositWhitelistHook`                                                          |
-| Vault / DRM                    | `createRateManager`, `setVaultMinRate`, `setVaultMinRatesBatch`, `setVaultFee`, `setVaultConfig`, `getDepositRateManager`, `getManagerFee`, `getEffectiveRate`                                                                           |
-| Oracle config                  | `setOracleRateConfig`, `setOracleRateConfigBatch`, `removeOracleRateConfig`, `updateCurrencyConfigBatch`, `deactivateCurrenciesBatch`, `supportsInlineOracleRateConfig`, `validateOracleFeedsOnChain`                                    |
-| RPC reads                      | `getDeposits`, `getDeposit`, `getDepositsById`, `getIntents`, `getIntent`, `getPvDepositById`, `getPvDepositsFromIds`, `getPvAccountDeposits`, `getPvAccountIntents`, `getPvIntent`                                                      |
-| Indexer                        | `client.indexer.getDeposits`, `getDepositsWithRelations`, `getDepositById`, `getIntentFulfillmentAmounts`, `getDepositFundActivities`, `getDepositDailySnapshots`, `getRateManagers`, `getRateManagerDetail`, `getManagerDailySnapshots` |
-| React hooks                    | `@zkp2p/sdk/react` exports hooks for deposits, intents, delegation, vaults, payment methods, and taker tier                                                                                                                              |
-| Attribution                    | ERC-8021 helpers like `sendTransactionWithAttribution`, `encodeWithAttribution`, and `txOverrides.referrer` support                                                                                                                      |
+| Area                           | Stable surface                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Deposits                       | `createDeposit`, `addFunds`, `removeFunds`, `withdrawDeposit`, `ensureAllowance`, `setAcceptingIntents`, `setIntentRange`, `setCurrencyMinRate`, `setRetainOnEmpty`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Payment methods and currencies | `addPaymentMethods`, `removePaymentMethod`, `setPaymentMethodActive`, `addCurrencies`, `removeCurrency`, `deactivateCurrency`, `pruneExpiredIntents`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| Intents                        | `signalIntent`, `fulfillIntent`, `cancelIntent`, `releaseFundsToPayer`, `getFulfillIntentInputs`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| Prepared transactions          | `client.prepareCreateDeposit(...)`, `client.signalIntent.prepare(...)`, `client.fulfillIntent.prepare(...)`, `client.setVaultFee.prepare(...)`, and equivalent prepare flows across the rest of the prepareable write surface                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Payee and quote APIs           | `registerPayeeDetails`, `resolvePayeeHash`, `getQuote`, `getTakerTier`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| Delegation and hooks           | `setDelegate`, `removeDelegate`, `setRateManager`, `clearRateManager`, `setDepositRateManager`, `clearDepositRateManager`, `setDepositPreIntentHook`, `setDepositWhitelistHook`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| Vault / DRM                    | `createRateManager`, `setVaultMinRate`, `setVaultMinRatesBatch`, `setVaultFee`, `setVaultConfig`, `getDepositRateManager`, `getManagerFee`, `getEffectiveRate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| Oracle config                  | `setOracleRateConfig`, `setOracleRateConfigBatch`, `removeOracleRateConfig`, `updateCurrencyConfigBatch`, `deactivateCurrenciesBatch`, `supportsInlineOracleRateConfig`, `validateOracleFeedsOnChain`                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| RPC reads                      | `getDeposits`, `getDeposit`, `getDepositsById`, `getIntents`, `getIntent`, `getPvDepositById`, `getPvDepositsFromIds`, `getPvAccountDeposits`, `getPvAccountIntents`, `getPvIntent`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Indexer                        | `client.indexer.getDeposits`, `getDepositsWithRelations`, `getDepositById`, `getDepositsByIds`, `getDepositsByIdsWithRelations`, `getDepositsByPayeeHash`, `getIntentsForDeposits`, `getOwnerIntents`, `getIntentsByRateManager`, `getIntentByHash`, `getExpiredIntents`, `getFulfilledIntentEvents`, `getIntentFulfillmentAmounts`, `getFulfillmentAndPayment`, `getDepositFundActivities`, `getMakerFundActivities`, `getDepositDailySnapshots`, `getProfitSnapshotsByDeposits`, `getRateManagers`, `getRateManagerDetail`, `getRateManagerDelegations`, `getDelegationForDeposit`, `getManagerDailySnapshots`, `getManualRateUpdates`, `getOracleConfigUpdates`, `query` |
+| React hooks                    | `@zkp2p/sdk/react` exports hooks for deposits, intents, delegation, vaults, payment methods, and taker tier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| Attribution                    | ERC-8021 helpers like `sendTransactionWithAttribution`, `encodeWithAttribution`, and `txOverrides.referrer` support                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 
 ## Create a Deposit
 
@@ -181,7 +185,7 @@ await client.releaseFundsToPayer({
 });
 ```
 
-For OrchestratorV2 flows, prefer `referralFees[]`. Legacy `referrer` and `referrerFee` fields remain available for compatibility.
+Use `referralFees[]` for multi-recipient fee distribution on OrchestratorV2.
 
 ## Prepared Transactions
 
@@ -385,35 +389,77 @@ You can also use the convenience wrappers `getDeposits()`, `getDeposit()`, `getI
 
 ## Indexer Queries
 
-Use the indexer for filtered queries, pagination, fund activity history, snapshots, and vault analytics.
+Use the indexer for filtered queries, pagination, fund activity history, snapshots, and vault analytics. All methods live on the flat `client.indexer.*` namespace.
 
 ```ts
+// Deposit queries
 const deposits = await client.indexer.getDeposits(
   { status: 'ACTIVE', depositor: '0xMaker' },
   { limit: 25, orderBy: 'updatedAt', orderDirection: 'desc' },
 );
-
-const depositWithRelations = await client.indexer.getDepositById('8453_0xEscrowAddress_42', {
+const depositsWithRelations = await client.indexer.getDepositsWithRelations(
+  { status: 'ACTIVE' },
+  { limit: 10 },
+  { includeIntents: true },
+);
+const deposit = await client.indexer.getDepositById('8453_0xEscrowAddress_42', {
+  includeIntents: true,
+});
+const depositsByIds = await client.indexer.getDepositsByIds(['8453_0xEscrow_42']);
+const depositsByIdsWithRelations = await client.indexer.getDepositsByIdsWithRelations(
+  ['8453_0xEscrow_42'],
+  { includeIntents: true },
+);
+const depositsByPayee = await client.indexer.getDepositsByPayeeHash('0xPayeeHash', {
+  paymentMethodHash: '0x...',
+  limit: 10,
   includeIntents: true,
 });
 
+// Intent queries
+const intentsForDeposits = await client.indexer.getIntentsForDeposits(
+  ['8453_0xEscrow_42'],
+  ['SIGNALED'],
+);
+const ownerIntents = await client.indexer.getOwnerIntents('0xTaker', ['SIGNALED', 'FULFILLED']);
+const intentsByVault = await client.indexer.getIntentsByRateManager('0xVaultId');
+const intent = await client.indexer.getIntentByHash('0xIntentHash');
+const expiredIntents = await client.indexer.getExpiredIntents({
+  now: BigInt(Math.floor(Date.now() / 1000)),
+  depositIds: ['8453_0xEscrow_42'],
+});
+const fulfilledEvents = await client.indexer.getFulfilledIntentEvents(['0xIntentHash']);
 const fulfillment = await client.indexer.getIntentFulfillmentAmounts('0xIntentHash');
+const fulfillmentAndPayment = await client.indexer.getFulfillmentAndPayment('0xIntentHash');
+
+// Fund activity and snapshots
 const fundActivities = await client.indexer.getDepositFundActivities('8453_0xEscrowAddress_42');
+const makerActivities = await client.indexer.getMakerFundActivities('0xMaker', 50);
 const snapshots = await client.indexer.getDepositDailySnapshots('8453_0xEscrowAddress_42', 30);
+const profitSnapshots = await client.indexer.getProfitSnapshotsByDeposits(['8453_0xEscrow_42']);
 
+// Rate manager (vault) queries
 const managers = await client.indexer.getRateManagers({
   limit: 10,
   orderBy: 'currentDelegatedBalance',
   orderDirection: 'desc',
 });
-
 const managerDetail = await client.indexer.getRateManagerDetail('0xVaultId', {
   rateManagerAddress: '0xVaultAddress',
+  statsLimit: 30,
+});
+const delegations = await client.indexer.getRateManagerDelegations('0xVaultId');
+const delegation = await client.indexer.getDelegationForDeposit('8453_0xEscrow_42');
+const managerSnapshots = await client.indexer.getManagerDailySnapshots('0xVaultId');
+const manualRates = await client.indexer.getManualRateUpdates('0xVaultId');
+const oracleUpdates = await client.indexer.getOracleConfigUpdates('0xVaultId');
+
+// Raw GraphQL
+const custom = await client.indexer.query<MyType>({
+  query: '{ deposits(limit: 5) { id } }',
 });
 ```
 
-`managerDetail?.aggregate` gives you current delegated balance and filled volume stats alongside recent snapshots and delegation history.
-
 ## React Hooks
 
 Install React and import hooks from `@zkp2p/sdk/react`. React is an optional peer dependency of the SDK.
@@ -494,7 +540,7 @@ const hash = await client.signalIntent({
 });
 ```
 
-Lower-level helpers are also exported: `BASE_BUILDER_CODE`, `getAttributionDataSuffix()`, `appendAttributionToCalldata()`, `encodeWithAttribution()`, and `sendTransactionWithAttribution()`.
+Lower-level helpers are also exported: `BASE_BUILDER_CODE`, `ZKP2P_IOS_REFERRER`, `ZKP2P_ANDROID_REFERRER`, `getAttributionDataSuffix()`, `appendAttributionToCalldata()`, `encodeWithAttribution()`, and `sendTransactionWithAttribution()`.
 
 ## TypeDoc API Reference
 

package/dist/{chunk-J33LUXNA.mjs → chunk-AXX3QCRW.mjs}

@@ -73,38 +73,6 @@ function unwrapConstants(mod) {
   }
   return m;
 }
-var HISTORICAL_ESCROW_ADDRESSES = {
-  base: [
-    "0x2f121CDDCA6d652f35e8B3E560f9760898888888"
-    // EscrowV2 production (contracts-v2 0.2.0-rc.6)
-  ],
-  base_staging: [
-    "0x5C2a8D9246777eE4501B6C426a8B8C7635C7b5b5",
-    // EscrowV2 staging (contracts-v2 0.2.0-rc.5)
-    "0x18EAcBf3FF19528ABe8035CF5cA266F31A2e3f14",
-    // EscrowV2 staging (contracts-v2 0.1.11-rc.3)
-    "0x07Cc97c254A5Fb0957553E9F58E4040699357f28",
-    // EscrowV2 staging (contracts-v2 0.1.11-rc.2)
-    "0x8455b9a31041125C785044f45458eCf2cbB12eF7",
-    // v2.1 staging Escrow (2025-10-18, PR #83)
-    "0x21f007107269ea1c8Fe0730736548090F4945736"
-    // v2.1 staging Escrow (2025-10-04, PR #71)
-  ]
-};
-var HISTORICAL_ORCHESTRATOR_ADDRESSES = {
-  base: [
-    "0x88888883Ed048FF0a415271B28b2F52d431810D0"
-    // OrchestratorV2 production (contracts-v2 0.2.0-rc.6)
-  ],
-  base_staging: [
-    "0xF9b9CD27Deea496B960b3cb5221b514705fCaF5e",
-    // OrchestratorV2 staging (contracts-v2 0.2.0-rc.5)
-    "0xC0389b3d7A4E6B823e361e562C4a29F04B6C4fB5"
-    // OrchestratorV2 staging (contracts-v2 0.1.11-rc.3)
-  ]
-};
-var STAGING_ESCROW_V2_FALLBACK = "0x77e8f808FE201075e0bD651CD46fdF239fc83265";
-var STAGING_ORCHESTRATOR_V2_FALLBACK = "0xc17a59227B136c45fAa153086a15EF87ED14bE00";
 var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 function isValidAddress(value) {
   return typeof value === "string" && /^0x[a-fA-F0-9]{40}$/.test(value) && value.toLowerCase() !== ZERO_ADDRESS;
@@ -196,13 +164,12 @@ function getContracts(chainId, env = "production") {
       escrowV2: pickAddress(baseContracts, ["EscrowV2", "Escrow_V2"]),
       escrowAddresses: uniqueAddresses(
         pickAddress(baseContracts, ["EscrowV2", "Escrow_V2"]),
-        ...HISTORICAL_ESCROW_ADDRESSES.base
+        pickAddress(baseContracts, ["Escrow"])
       ),
       orchestrator: pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"]) ?? pickAddress(baseContracts, ["Orchestrator"]),
       orchestratorV2: pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"]),
       orchestratorAddresses: uniqueAddresses(
-        pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"]),
-        ...HISTORICAL_ORCHESTRATOR_ADDRESSES.base
+        pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"])
       ),
       unifiedPaymentVerifier: pickAddress(baseContracts, [
         "UnifiedPaymentVerifierV2",
@@ -260,28 +227,22 @@ function getContracts(chainId, env = "production") {
       "VITE_BASE_STAGING_ESCROW_V2_ADDRESS",
       "VITE_ESCROW_V2_ADDRESS"
     ]);
-    const stagingEscrowCurrent = stagingEscrowV2Override ?? pickAddress(sc, ["EscrowV2", "Escrow_V2"]) ?? pickAddress(sc, ["Escrow"]) ?? STAGING_ESCROW_V2_FALLBACK;
+    const stagingEscrowCurrent = stagingEscrowV2Override ?? pickAddress(sc, ["EscrowV2", "Escrow_V2"]) ?? pickAddress(sc, ["Escrow"]);
     const stagingOrchestratorV2Override = resolveRuntimeAddressOverride([
       "VITE_BASE_STAGING_ORCHESTRATOR_V2_ADDRESS",
       "VITE_ORCHESTRATOR_V2_ADDRESS",
       "VITE_ORCHESTRATORV2_ADDRESS"
     ]);
-    const stagingOrchestratorCurrent = stagingOrchestratorV2Override ?? pickAddress(sc, ["OrchestratorV2", "Orchestrator_V2"]) ?? pickAddress(sc, ["Orchestrator"]) ?? STAGING_ORCHESTRATOR_V2_FALLBACK;
+    const stagingOrchestratorCurrent = stagingOrchestratorV2Override ?? pickAddress(sc, ["OrchestratorV2", "Orchestrator_V2"]) ?? pickAddress(sc, ["Orchestrator"]);
     const stagingRateManagerV1 = pickAddress(sc, ["RateManagerV1", "DepositRateManagerRegistryV1"]);
     return {
       addresses: {
         escrow: stagingEscrowCurrent,
         escrowV2: stagingEscrowCurrent,
-        escrowAddresses: uniqueAddresses(
-          stagingEscrowCurrent,
-          ...HISTORICAL_ESCROW_ADDRESSES.base_staging
-        ),
+        escrowAddresses: uniqueAddresses(stagingEscrowCurrent),
         orchestrator: stagingOrchestratorCurrent,
         orchestratorV2: stagingOrchestratorCurrent,
-        orchestratorAddresses: uniqueAddresses(
-          stagingOrchestratorCurrent,
-          ...HISTORICAL_ORCHESTRATOR_ADDRESSES.base_staging
-        ),
+        orchestratorAddresses: uniqueAddresses(stagingOrchestratorCurrent),
         unifiedPaymentVerifier: pickAddress(sc, [
           "UnifiedPaymentVerifierV2",
           "UnifiedPaymentVerifier"
@@ -357,10 +318,7 @@ function getPaymentMethodsCatalog(_chainId, env = "production") {
   const methods = src?.methods ?? {};
   return methods;
 }
-function getGatingServiceAddress(_chainId, env = "production") {
-  if (env === "staging") {
-    return "0x396D31055Db28C0C6f36e8b36f18FE7227248a97";
-  }
+function getGatingServiceAddress(_chainId, _env = "production") {
   return "0x396D31055Db28C0C6f36e8b36f18FE7227248a97";
 }
 function getRateManagerContracts(chainId, env = "production") {
@@ -559,6 +517,6 @@ function enrichPvIntentView(view, chainId, env = "production") {
   };
 }
 
-export { HISTORICAL_ESCROW_ADDRESSES, asciiToBytes32, enrichPvDepositView, enrichPvIntentView, ensureBytes32, getContracts, getGatingServiceAddress, getPaymentMethodsCatalog, getRateManagerContracts, parseBigIntLike, parseDepositView, parseIntentView, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash };
-//# sourceMappingURL=chunk-J33LUXNA.mjs.map
-//# sourceMappingURL=chunk-J33LUXNA.mjs.map
+export { asciiToBytes32, enrichPvDepositView, enrichPvIntentView, ensureBytes32, getContracts, getGatingServiceAddress, getPaymentMethodsCatalog, getRateManagerContracts, parseBigIntLike, parseDepositView, parseIntentView, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash };
+//# sourceMappingURL=chunk-AXX3QCRW.mjs.map
+//# sourceMappingURL=chunk-AXX3QCRW.mjs.map

package/dist/chunk-AXX3QCRW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/bigint.ts","../src/contracts.ts","../src/utils/bytes32.ts","../src/utils/paymentMethodHashes.ts","../src/utils/paymentResolution.ts","../src/utils/protocolViewerParsers.ts"],"names":["baseStagingPaymentMethods"],"mappings":"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","file":"chunk-AXX3QCRW.mjs","sourcesContent":["export function parseBigIntLike(\n  value: unknown,\n  errorMessage = 'Unsupported numeric value',\n): bigint {\n  if (typeof value === 'bigint') return value;\n  if (typeof value === 'number') return BigInt(value);\n  if (typeof value === 'string') {\n    const normalized = value.trim();\n    if (!normalized) throw new Error(errorMessage);\n    return BigInt(normalized);\n  }\n\n  if (value && typeof (value as { toString?: () => string }).toString === 'function') {\n    const normalized = (value as { toString: () => string }).toString().trim();\n    if (!normalized) throw new Error(errorMessage);\n    return BigInt(normalized);\n  }\n\n  throw new Error(errorMessage);\n}\n","/**\n * Contract resolution utilities for the SDK.\n *\n * Provides access to deployed contract addresses and ABIs for different\n * networks (Base) and environments (production, staging).\n *\n * @module contracts\n */\n\nimport type { Abi } from 'abitype';\n\n// Typed imports from @zkp2p/contracts-v2 (module declarations provided in src/@types)\n// Use *Raw suffix for imports that need runtime normalization (addresses, constants)\nimport baseAddressesRaw from '@zkp2p/contracts-v2/addresses/base';\nimport baseStagingAddressesRaw from '@zkp2p/contracts-v2/addresses/baseStaging';\nimport * as baseAbisRaw from '@zkp2p/contracts-v2/abis/base';\nimport * as baseStagingAbisRaw from '@zkp2p/contracts-v2/abis/baseStaging';\n\nimport EscrowBase from '@zkp2p/contracts-v2/abis/base/Escrow.json';\nimport OrchestratorBase from '@zkp2p/contracts-v2/abis/base/Orchestrator.json';\nimport ProtocolViewerBase from '@zkp2p/contracts-v2/abis/base/ProtocolViewer.json';\nimport UnifiedPaymentVerifierBase from '@zkp2p/contracts-v2/abis/base/UnifiedPaymentVerifier.json';\n\nimport EscrowBaseStaging from '@zkp2p/contracts-v2/abis/baseStaging/Escrow.json';\nimport OrchestratorBaseStaging from '@zkp2p/contracts-v2/abis/baseStaging/Orchestrator.json';\nimport UnifiedPaymentVerifierBaseStaging from '@zkp2p/contracts-v2/abis/baseStaging/UnifiedPaymentVerifier.json';\nimport ProtocolViewerBaseStaging from '@zkp2p/contracts-v2/abis/baseStaging/ProtocolViewer.json';\n\nimport baseConstantsRaw from '@zkp2p/contracts-v2/constants/base';\nimport baseStagingConstantsRaw from '@zkp2p/contracts-v2/constants/baseStaging';\n// Payment methods catalogs (JSON). Import statically so ESM bundlers include the data.\n// These modules are present in @zkp2p/contracts-v2; tsconfig sets resolveJsonModule: true\nimport basePaymentMethodsRaw from '@zkp2p/contracts-v2/paymentMethods/base.json';\nimport baseStagingPaymentMethodsRaw from '@zkp2p/contracts-v2/paymentMethods/baseStaging.json';\n\n// ---------------------------------------------------------------------------\n// Runtime normalization helpers for ESM/CJS interoperability\n// ---------------------------------------------------------------------------\n// In certain runtimes (tsx, Node ESM), deep imports from @zkp2p/contracts-v2\n// resolve as { default: [Getter] } or { default: { contracts: {...} } } instead\n// of the expected shape. These helpers unwrap the actual data regardless of shape.\n\n/**\n * Normalize address module shape. Handles:\n * - { contracts: {...} } (direct)\n * - { default: { contracts: {...} } } (wrapped)\n * - { default: [Getter] } (lazy)\n */\nfunction unwrapAddresses(mod: unknown): {\n  name?: string;\n  chainId?: number;\n  contracts?: Record<string, `0x${string}`>;\n} {\n  if (!mod) return {} as ReturnType<typeof unwrapAddresses>;\n  const m = mod as Record<string, unknown>;\n  // Direct shape\n  if (m.contracts) return m as ReturnType<typeof unwrapAddresses>;\n  // Wrapped shape\n  if ((m.default as Record<string, unknown>)?.contracts)\n    return m.default as ReturnType<typeof unwrapAddresses>;\n  // Lazy getter shape\n  try {\n    const d = typeof m.default === 'function' ? (m.default as () => unknown)() : m.default;\n    if ((d as Record<string, unknown>)?.contracts) return d as ReturnType<typeof unwrapAddresses>;\n  } catch {\n    // ignore\n  }\n  return m as ReturnType<typeof unwrapAddresses>;\n}\n\n/**\n * Normalize payment methods module shape. Handles:\n * - { methods: {...} } (direct)\n * - { default: { methods: {...} } } (wrapped)\n * - { default: [Getter] } (lazy)\n */\nfunction unwrapMethods(mod: unknown): {\n  methods?: Record<string, { paymentMethodHash: `0x${string}`; currencies?: `0x${string}`[] }>;\n} {\n  if (!mod) return {} as ReturnType<typeof unwrapMethods>;\n  const m = mod as Record<string, unknown>;\n  if (m.methods) return m as ReturnType<typeof unwrapMethods>;\n  if ((m.default as Record<string, unknown>)?.methods)\n    return m.default as ReturnType<typeof unwrapMethods>;\n  try {\n    const d = typeof m.default === 'function' ? (m.default as () => unknown)() : m.default;\n    if ((d as Record<string, unknown>)?.methods) return d as ReturnType<typeof unwrapMethods>;\n  } catch {\n    // ignore\n  }\n  return m as ReturnType<typeof unwrapMethods>;\n}\n\n/**\n * Normalize constants module shape (for USDC address, etc.)\n */\nfunction unwrapConstants(mod: unknown): Record<string, unknown> {\n  if (!mod) return {};\n  const m = mod as Record<string, unknown>;\n  if (m.USDC) return m;\n  if ((m.default as Record<string, unknown>)?.USDC) return m.default as Record<string, unknown>;\n  try {\n    const d = typeof m.default === 'function' ? (m.default as () => unknown)() : m.default;\n    if ((d as Record<string, unknown>)?.USDC) return d as Record<string, unknown>;\n  } catch {\n    // ignore\n  }\n  return m;\n}\n\nconst ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';\n\nfunction isValidAddress(value?: string | null): value is `0x${string}` {\n  return (\n    typeof value === 'string' &&\n    /^0x[a-fA-F0-9]{40}$/.test(value) &&\n    value.toLowerCase() !== ZERO_ADDRESS\n  );\n}\n\nfunction pickAddress(\n  contracts: Record<string, string> | undefined,\n  keys: string[],\n): `0x${string}` | undefined {\n  if (!contracts) return undefined;\n  for (const key of keys) {\n    const candidate = contracts[key];\n    if (isValidAddress(candidate)) return candidate;\n  }\n  return undefined;\n}\n\nfunction pickAbi(source: Record<string, unknown>, names: string[]): Abi | undefined {\n  for (const name of names) {\n    const candidate = source[name];\n    if (Array.isArray(candidate)) return candidate as unknown as Abi;\n    // ESM interop: import * as abis may yield { default: [...] } per entry\n    if (\n      candidate &&\n      typeof candidate === 'object' &&\n      Array.isArray((candidate as Record<string, unknown>).default)\n    ) {\n      return (candidate as Record<string, unknown>).default as unknown as Abi;\n    }\n  }\n  return undefined;\n}\n\nfunction uniqueAddresses(...values: Array<string | undefined>): `0x${string}`[] {\n  const seen = new Set<string>();\n  const addresses: `0x${string}`[] = [];\n  for (const value of values) {\n    if (!isValidAddress(value)) continue;\n    const normalized = value.toLowerCase();\n    if (seen.has(normalized)) continue;\n    seen.add(normalized);\n    addresses.push(value);\n  }\n  return addresses;\n}\n\nfunction addressesEqual(left?: string, right?: string): boolean {\n  return Boolean(left && right && left.toLowerCase() === right.toLowerCase());\n}\n\nfunction readRuntimeEnv(key: string): string | undefined {\n  try {\n    const meta = import.meta as { env?: Record<string, string | undefined> };\n    const fromVite = meta?.env?.[key];\n    if (fromVite) return fromVite;\n  } catch {\n    // ignore\n  }\n  try {\n    const proc = (\n      globalThis as {\n        process?: { env?: Record<string, string | undefined> };\n      }\n    ).process;\n    return proc?.env?.[key];\n  } catch {\n    // ignore\n  }\n  return undefined;\n}\n\nfunction resolveRuntimeAddressOverride(envKeys: string[]): `0x${string}` | undefined {\n  for (const key of envKeys) {\n    const candidate = readRuntimeEnv(key);\n    if (isValidAddress(candidate)) return candidate;\n  }\n  return undefined;\n}\n\n// Apply runtime normalization to all imports\nconst baseAddresses = unwrapAddresses(baseAddressesRaw);\nconst baseStagingAddresses = unwrapAddresses(baseStagingAddressesRaw);\nconst basePaymentMethods = unwrapMethods(basePaymentMethodsRaw);\nconst baseStagingPaymentMethods = unwrapMethods(baseStagingPaymentMethodsRaw);\nconst baseConstants = unwrapConstants(baseConstantsRaw);\nconst baseStagingConstants = unwrapConstants(baseStagingConstantsRaw);\n\n/**\n * Contract addresses for a specific deployment.\n */\nexport type V2ContractAddresses = {\n  /** Escrow contract (holds deposits and manages intents) */\n  escrow: `0x${string}`;\n  /** EscrowV2 contract (supports native rate-manager delegation) */\n  escrowV2?: `0x${string}`;\n  /** All supported upgraded escrow addresses (current first, then historical) */\n  escrowAddresses?: `0x${string}`[];\n  /** Orchestrator contract (handles intent signaling and fulfillment) */\n  orchestrator?: `0x${string}`;\n  /** OrchestratorV2 contract (queries EscrowV2 effective rates) */\n  orchestratorV2?: `0x${string}`;\n  /** All supported upgraded orchestrator addresses (current first, then historical) */\n  orchestratorAddresses?: `0x${string}`[];\n  /** UnifiedPaymentVerifier contract (verifies payment proofs) */\n  unifiedPaymentVerifier?: `0x${string}`;\n  /** UnifiedPaymentVerifierV2 contract (updated verifier) */\n  unifiedPaymentVerifierV2?: `0x${string}`;\n  /** ProtocolViewer contract (batch read operations) */\n  protocolViewer?: `0x${string}`;\n  /** Ordered list of all ProtocolViewer instances (primary first, legacy fallback after) */\n  protocolViewerEntries?: Array<{ address: `0x${string}`; abi: Abi }>;\n  /** USDC token address */\n  usdc?: `0x${string}`;\n  /** RateManagerV1 contract */\n  rateManagerV1?: `0x${string}`;\n  /** OrchestratorRegistry contract */\n  orchestratorRegistry?: `0x${string}`;\n  /** DepositRateManagerRegistryV1 contract */\n  rateManagerRegistry?: `0x${string}`;\n  /** DepositRateManagerController contract */\n  rateManagerController?: `0x${string}`;\n  /** ChainlinkOracleAdapter contract */\n  chainlinkOracleAdapter?: `0x${string}`;\n  /** PythOracleAdapter contract */\n  pythOracleAdapter?: `0x${string}`;\n};\n\n/**\n * Contract ABIs for a specific deployment.\n */\nexport type V2ContractAbis = {\n  escrow: Abi;\n  escrowV2?: Abi;\n  orchestrator?: Abi;\n  orchestratorV2?: Abi;\n  unifiedPaymentVerifier?: Abi;\n  unifiedPaymentVerifierV2?: Abi;\n  protocolViewer?: Abi;\n  rateManagerV1?: Abi;\n  orchestratorRegistry?: Abi;\n  rateManagerRegistry?: Abi;\n  rateManagerController?: Abi;\n};\n\n/**\n * Runtime environment: 'production' for mainnet, 'preproduction' for preprod\n * (production contracts + preprod indexer), 'staging' for testnet/dev.\n */\nexport type RuntimeEnv = 'production' | 'preproduction' | 'staging';\n\n/**\n * Converts a chain ID to its network key.\n * @internal\n */\nexport function networkKeyFromChainId(_chainId: number): 'base' {\n  return 'base';\n}\n\n/**\n * Retrieves deployed contract addresses and ABIs for a given chain and environment.\n *\n * @param chainId - The chain ID (8453 for Base)\n * @param env - Runtime environment ('production' or 'staging')\n * @returns Object containing addresses and ABIs\n *\n * @example\n * ```typescript\n * import { getContracts } from '@zkp2p/sdk';\n *\n * const { addresses, abis } = getContracts(8453, 'production');\n * console.log(addresses.escrow);  // \"0x...\"\n * console.log(addresses.usdc);    // \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n * ```\n */\nexport function getContracts(\n  chainId: number,\n  env: RuntimeEnv = 'production',\n): { addresses: V2ContractAddresses; abis: V2ContractAbis } {\n  const key = networkKeyFromChainId(chainId);\n  const baseContracts = (baseAddresses.contracts ?? {}) as Record<string, string>;\n  const baseV2ProtocolViewerAbi = pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n    'ProtocolViewerV2',\n  ]);\n  const baseV2ProtocolViewerAddress = pickAddress(baseContracts, ['ProtocolViewerV2']);\n  const baseV1ProtocolViewerAddress = pickAddress(baseContracts, ['ProtocolViewer']);\n  const baseProtocolViewerEntries = (() => {\n    const entries: Array<{ address: `0x${string}`; abi: Abi }> = [];\n    if (baseV2ProtocolViewerAddress && baseV2ProtocolViewerAbi) {\n      entries.push({ address: baseV2ProtocolViewerAddress, abi: baseV2ProtocolViewerAbi });\n    }\n    if (\n      baseV1ProtocolViewerAddress &&\n      !addressesEqual(baseV1ProtocolViewerAddress, baseV2ProtocolViewerAddress)\n    ) {\n      entries.push({ address: baseV1ProtocolViewerAddress, abi: ProtocolViewerBase as Abi });\n    }\n    return entries.length > 0 ? entries : undefined;\n  })();\n\n  const addressesByKey: Record<'base', V2ContractAddresses> = {\n    base: {\n      escrow:\n        pickAddress(baseContracts, ['EscrowV2', 'Escrow_V2']) ??\n        pickAddress(baseContracts, ['Escrow']) ??\n        ('' as `0x${string}`),\n      escrowV2: pickAddress(baseContracts, ['EscrowV2', 'Escrow_V2']),\n      escrowAddresses: uniqueAddresses(\n        pickAddress(baseContracts, ['EscrowV2', 'Escrow_V2']),\n        pickAddress(baseContracts, ['Escrow']),\n      ),\n      orchestrator:\n        pickAddress(baseContracts, ['OrchestratorV2', 'Orchestrator_V2']) ??\n        pickAddress(baseContracts, ['Orchestrator']),\n      orchestratorV2: pickAddress(baseContracts, ['OrchestratorV2', 'Orchestrator_V2']),\n      orchestratorAddresses: uniqueAddresses(\n        pickAddress(baseContracts, ['OrchestratorV2', 'Orchestrator_V2']),\n      ),\n      unifiedPaymentVerifier: pickAddress(baseContracts, [\n        'UnifiedPaymentVerifierV2',\n        'UnifiedPaymentVerifier',\n      ]),\n      unifiedPaymentVerifierV2: pickAddress(baseContracts, ['UnifiedPaymentVerifierV2']),\n      protocolViewer:\n        baseProtocolViewerEntries?.[0]?.address ??\n        baseV1ProtocolViewerAddress ??\n        baseV2ProtocolViewerAddress,\n      protocolViewerEntries: baseProtocolViewerEntries,\n      usdc: baseConstants.USDC as `0x${string}` | undefined,\n      rateManagerV1: pickAddress(baseContracts, ['RateManagerV1', 'DepositRateManagerRegistryV1']),\n      orchestratorRegistry: pickAddress(baseContracts, ['OrchestratorRegistry']),\n      rateManagerRegistry: pickAddress(baseContracts, [\n        'DepositRateManagerRegistryV1',\n        'RateManagerV1',\n      ]),\n      rateManagerController: pickAddress(baseContracts, ['DepositRateManagerController']),\n      chainlinkOracleAdapter: pickAddress(baseContracts, ['ChainlinkOracleAdapter']),\n      pythOracleAdapter: pickAddress(baseContracts, ['PythOracleAdapter']),\n    },\n  };\n\n  const abisByKey: Record<'base', V2ContractAbis> = {\n    base: {\n      escrow: EscrowBase as unknown as Abi,\n      escrowV2: (pickAbi(baseAbisRaw as unknown as Record<string, unknown>, ['EscrowV2']) ??\n        (EscrowBase as unknown as Abi)) as Abi,\n      orchestrator: OrchestratorBase as unknown as Abi,\n      orchestratorV2: (pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n        'OrchestratorV2',\n      ]) ?? (OrchestratorBase as unknown as Abi)) as Abi,\n      unifiedPaymentVerifier: (pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n        'UnifiedPaymentVerifierV2',\n      ]) ?? (UnifiedPaymentVerifierBase as unknown as Abi)) as Abi,\n      unifiedPaymentVerifierV2: pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n        'UnifiedPaymentVerifierV2',\n      ]),\n      protocolViewer: (baseProtocolViewerEntries?.[0]?.abi ??\n        (ProtocolViewerBase as unknown as Abi)) as Abi,\n      rateManagerV1: pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n        'RateManagerV1',\n        'DepositRateManagerRegistryV1',\n      ]),\n      orchestratorRegistry: pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n        'OrchestratorRegistry',\n      ]),\n      rateManagerRegistry: pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n        'DepositRateManagerRegistryV1',\n        'RateManagerV1',\n      ]),\n      rateManagerController: pickAbi(baseAbisRaw as unknown as Record<string, unknown>, [\n        'DepositRateManagerController',\n      ]),\n    },\n  };\n\n  // Staging overrides (addresses/abis from contracts-v2 baseStaging deployment)\n  if (env === 'staging') {\n    const sc = baseStagingAddresses.contracts as Record<string, string> | undefined;\n    const stagingEscrowV2Override = resolveRuntimeAddressOverride([\n      'VITE_BASE_STAGING_ESCROW_V2_ADDRESS',\n      'VITE_ESCROW_V2_ADDRESS',\n    ]);\n    const stagingEscrowCurrent =\n      stagingEscrowV2Override ??\n      pickAddress(sc, ['EscrowV2', 'Escrow_V2']) ??\n      pickAddress(sc, ['Escrow']);\n    const stagingOrchestratorV2Override = resolveRuntimeAddressOverride([\n      'VITE_BASE_STAGING_ORCHESTRATOR_V2_ADDRESS',\n      'VITE_ORCHESTRATOR_V2_ADDRESS',\n      'VITE_ORCHESTRATORV2_ADDRESS',\n    ]);\n    const stagingOrchestratorCurrent =\n      stagingOrchestratorV2Override ??\n      pickAddress(sc, ['OrchestratorV2', 'Orchestrator_V2']) ??\n      pickAddress(sc, ['Orchestrator']);\n    const stagingRateManagerV1 = pickAddress(sc, ['RateManagerV1', 'DepositRateManagerRegistryV1']);\n\n    return {\n      addresses: {\n        escrow: stagingEscrowCurrent as `0x${string}`,\n        escrowV2: stagingEscrowCurrent,\n        escrowAddresses: uniqueAddresses(stagingEscrowCurrent),\n        orchestrator: stagingOrchestratorCurrent,\n        orchestratorV2: stagingOrchestratorCurrent,\n        orchestratorAddresses: uniqueAddresses(stagingOrchestratorCurrent),\n        unifiedPaymentVerifier: pickAddress(sc, [\n          'UnifiedPaymentVerifierV2',\n          'UnifiedPaymentVerifier',\n        ]),\n        unifiedPaymentVerifierV2: pickAddress(sc, ['UnifiedPaymentVerifierV2']),\n        protocolViewer: pickAddress(sc, ['ProtocolViewerV2', 'ProtocolViewer']),\n        protocolViewerEntries: (() => {\n          const entries: Array<{ address: `0x${string}`; abi: Abi }> = [];\n          // Primary: V2 PV (reads from V2 orchestrator)\n          const pvV2Address = pickAddress(sc, ['ProtocolViewerV2']);\n          const pvV2Abi = pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n            'ProtocolViewerV2',\n          ]) as Abi | undefined;\n          if (pvV2Address && pvV2Abi) {\n            entries.push({ address: pvV2Address, abi: pvV2Abi });\n          }\n          // Fallback: V1 PV (reads V1 orchestrator intents via 1-input functions)\n          const pvV1Address = pickAddress(sc, ['ProtocolViewer']);\n          const pvV1Abi = ProtocolViewerBaseStaging as unknown as Abi;\n          if (pvV1Address && !addressesEqual(pvV1Address, pvV2Address) && pvV1Abi) {\n            entries.push({ address: pvV1Address, abi: pvV1Abi });\n          }\n          return entries.length > 0 ? entries : undefined;\n        })(),\n        usdc: baseStagingConstants.USDC as `0x${string}` | undefined,\n        rateManagerV1: stagingRateManagerV1,\n        orchestratorRegistry: pickAddress(sc, ['OrchestratorRegistry']),\n        rateManagerRegistry: (pickAddress(sc, ['DepositRateManagerRegistryV1']) ??\n          stagingRateManagerV1) as `0x${string}` | undefined,\n        rateManagerController: pickAddress(sc, ['DepositRateManagerController']),\n        chainlinkOracleAdapter: pickAddress(sc, ['ChainlinkOracleAdapter']),\n        pythOracleAdapter: pickAddress(sc, ['PythOracleAdapter']),\n      },\n      abis: {\n        escrow: EscrowBaseStaging as unknown as Abi,\n        escrowV2: (addressesEqual(stagingEscrowCurrent, pickAddress(sc, ['Escrow']))\n          ? (EscrowBaseStaging as unknown as Abi)\n          : (pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, ['EscrowV2']) ??\n            (EscrowBaseStaging as unknown as Abi))) as Abi,\n        orchestrator: OrchestratorBaseStaging as unknown as Abi,\n        orchestratorV2: (addressesEqual(\n          stagingOrchestratorCurrent,\n          pickAddress(sc, ['Orchestrator']),\n        )\n          ? (OrchestratorBaseStaging as unknown as Abi)\n          : (pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n              'OrchestratorV2',\n            ]) ?? (OrchestratorBaseStaging as unknown as Abi))) as Abi,\n        unifiedPaymentVerifier: (pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n          'UnifiedPaymentVerifierV2',\n        ]) ?? (UnifiedPaymentVerifierBaseStaging as unknown as Abi)) as Abi,\n        unifiedPaymentVerifierV2: pickAbi(\n          baseStagingAbisRaw as unknown as Record<string, unknown>,\n          ['UnifiedPaymentVerifierV2'],\n        ),\n        protocolViewer: (pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n          'ProtocolViewerV2',\n        ]) ?? (ProtocolViewerBaseStaging as unknown as Abi)) as Abi,\n        rateManagerV1: pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n          'RateManagerV1',\n          'DepositRateManagerRegistryV1',\n        ]),\n        orchestratorRegistry: pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n          'OrchestratorRegistry',\n        ]),\n        rateManagerRegistry: pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n          'DepositRateManagerRegistryV1',\n          'RateManagerV1',\n        ]),\n        rateManagerController: pickAbi(baseStagingAbisRaw as unknown as Record<string, unknown>, [\n          'DepositRateManagerController',\n        ]),\n      },\n    };\n  }\n\n  const result = { addresses: addressesByKey[key], abis: abisByKey[key] };\n\n  return result;\n}\n\n/**\n * Catalog of payment methods with their hashes and supported currencies.\n */\nexport type PaymentMethodCatalog = Record<\n  string,\n  { paymentMethodHash: `0x${string}`; currencies?: `0x${string}`[] }\n>;\n\n/**\n * Retrieves the payment methods catalog for a given chain and environment.\n *\n * The catalog maps payment platform names (e.g., 'wise', 'revolut') to their\n * on-chain hashes and supported currency hashes.\n *\n * @param chainId - The chain ID\n * @param env - Runtime environment\n * @returns Payment method catalog keyed by platform name\n *\n * @example\n * ```typescript\n * import { getPaymentMethodsCatalog } from '@zkp2p/sdk';\n *\n * const catalog = getPaymentMethodsCatalog(8453, 'production');\n * console.log(Object.keys(catalog)); // ['wise', 'venmo', 'revolut', ...]\n * console.log(catalog.wise.paymentMethodHash); // \"0x...\"\n * console.log(catalog.wise.currencies); // [\"0x...\", \"0x...\"] (currency hashes)\n * ```\n */\nexport function getPaymentMethodsCatalog(\n  _chainId: number,\n  env: RuntimeEnv = 'production',\n): PaymentMethodCatalog {\n  const src = env === 'staging' ? baseStagingPaymentMethods : basePaymentMethods;\n  const methods = (src?.methods ?? {}) as PaymentMethodCatalog;\n  return methods;\n}\n\n/**\n * Returns the gating service address for a given chain and environment.\n *\n * The gating service signs intent parameters before they can be submitted\n * on-chain, providing an additional validation layer.\n *\n * @param chainId - The chain ID\n * @param env - Runtime environment\n * @returns Gating service signer address\n */\nexport function getGatingServiceAddress(\n  _chainId: number,\n  _env: RuntimeEnv = 'production',\n): `0x${string}` {\n  // Staging and production share the same gating service signer\n  return '0x396D31055Db28C0C6f36e8b36f18FE7227248a97' as `0x${string}`;\n}\n\nexport function getRateManagerContracts(\n  chainId: number,\n  env: RuntimeEnv = 'production',\n): {\n  addresses: { registry: `0x${string}`; controller?: `0x${string}` };\n  abis: { registry: Abi; controller?: Abi };\n} {\n  const { addresses, abis } = getContracts(chainId, env);\n  const registryAddress = addresses.rateManagerV1 ?? addresses.rateManagerRegistry;\n  const registryAbi = abis.rateManagerV1 ?? abis.rateManagerRegistry;\n  if (!registryAddress || !registryAbi) {\n    throw new Error(`Rate manager contracts not available for chainId=${chainId}, env=${env}`);\n  }\n  const controllerAddress = addresses.rateManagerController;\n  const controllerAbi = controllerAddress ? abis.rateManagerController : undefined;\n\n  return {\n    addresses: {\n      registry: registryAddress,\n      ...(controllerAddress ? { controller: controllerAddress } : {}),\n    },\n    abis: {\n      registry: registryAbi,\n      ...(controllerAbi ? { controller: controllerAbi } : {}),\n    },\n  };\n}\n","import { keccak256, toBytes, hexToBytes, bytesToHex } from 'viem';\n\n/**\n * Ensure a value is 32 bytes hex (0x + 64 nibbles). If ascii, keccak256 by default when hash=true.\n */\nexport function ensureBytes32(\n  value: string,\n  { hashIfAscii = false }: { hashIfAscii?: boolean } = {},\n): `0x${string}` {\n  if (value.startsWith('0x')) {\n    const bytes = hexToBytes(value as `0x${string}`);\n    if (bytes.length !== 32) throw new Error('Expected 32-byte hex value');\n    return value as `0x${string}`;\n  }\n  if (!hashIfAscii)\n    throw new Error('Expected 32-byte hex; received ascii string. Pass hashIfAscii=true to hash.');\n  const hashed = keccak256(toBytes(value));\n  return hashed as `0x${string}`;\n}\n\n/**\n * Encode ASCII (<=32 chars) left-aligned, right-padded with zeros to 32 bytes.\n */\nexport function asciiToBytes32(value: string): `0x${string}` {\n  const b = toBytes(value);\n  if (b.length > 32) throw new Error('ASCII input exceeds 32 bytes');\n  const padded = new Uint8Array(32);\n  padded.set(b);\n  return bytesToHex(padded);\n}\n","import lookups from '@zkp2p/contracts-v2/paymentMethods/lookups.json';\n\n/**\n * Canonical payment-method hash map sourced from contracts.\n */\nexport const METHOD_NAME_TO_HASH = lookups.nameToHash;\n","/**\n * Payment method resolution utilities.\n *\n * These functions convert between human-readable payment platform names\n * (e.g., 'wise', 'revolut') and their on-chain bytes32 hashes.\n *\n * @module paymentResolution\n */\n\nimport { ensureBytes32 } from './bytes32';\nimport { currencyKeccak256 } from './currencyKeccak256';\nimport { METHOD_NAME_TO_HASH } from './paymentMethodHashes';\nimport type { PaymentMethodCatalog } from '../contracts';\n\n// Optional JSON maps from @zkp2p/contracts-v2 (only provided on some envs)\n// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore\nimport baseStagingPaymentMethods from '@zkp2p/contracts-v2/paymentMethods/baseStaging';\n\ntype NetworkKey = 'base';\ntype RuntimeEnv = 'production' | 'preproduction' | 'staging';\n\nfunction getPaymentMethodMap(\n  env: RuntimeEnv,\n  _network: NetworkKey,\n): Record<string, { paymentMethodHash: `0x${string}` }> | null {\n  if (env === 'staging') {\n    const m = (baseStagingPaymentMethods?.methods ?? {}) as Record<\n      string,\n      { paymentMethodHash: `0x${string}` }\n    >;\n    return m && Object.keys(m).length ? m : null;\n  }\n  return null;\n}\n\n/**\n * Resolves a payment method hash from a human-readable name.\n *\n * First attempts to look up the hash from contracts-v2 payment method maps.\n * Falls back to keccak256(name) when maps are unavailable.\n *\n * **Warning**: The fallback may not match on-chain mappings. Prefer using\n * `resolvePaymentMethodHashFromCatalog` with an explicit catalog.\n *\n * @param nameOrBytes - Payment method name ('wise') or existing bytes32 hash\n * @param opts.env - Runtime environment ('production' | 'staging')\n * @param opts.network - Network key ('base')\n * @returns bytes32 payment method hash\n *\n * @example\n * ```typescript\n * const hash = resolvePaymentMethodHash('wise', { env: 'production' });\n * ```\n */\nexport function resolvePaymentMethodHash(\n  nameOrBytes: string,\n  opts: { env?: RuntimeEnv; network?: NetworkKey } = {},\n): `0x${string}` {\n  const { env = 'production', network = 'base' } = opts;\n  if (nameOrBytes.startsWith('0x')) return ensureBytes32(nameOrBytes) as `0x${string}`;\n  const mapping = getPaymentMethodMap(env, network);\n  if (mapping) {\n    const key = nameOrBytes.toLowerCase();\n    const entry = mapping[key];\n    if (entry?.paymentMethodHash) return entry.paymentMethodHash;\n  }\n  // Fallback: hash ascii name to bytes32\n  return ensureBytes32(nameOrBytes, { hashIfAscii: true });\n}\n\n/**\n * Encodes a fiat currency code into bytes32 format (keccak256 hash).\n *\n * If the input is already a hex string (0x-prefixed), it's normalized to bytes32.\n * Otherwise, the currency code is hashed using keccak256.\n *\n * @param codeOrBytes - Currency code ('USD') or existing bytes32 hash\n * @returns bytes32 keccak256 hash of the currency code\n *\n * @example\n * ```typescript\n * const bytes = resolveFiatCurrencyBytes32('USD');\n * // Returns: 0xc4ae21aac0c6549d71dd96035b7e0bdb6c79ebdba8891b666115bc976d16a29e\n * ```\n */\nexport function resolveFiatCurrencyBytes32(codeOrBytes: string): `0x${string}` {\n  if (codeOrBytes.startsWith('0x')) return ensureBytes32(codeOrBytes) as `0x${string}`;\n  return currencyKeccak256(codeOrBytes.toUpperCase()) as `0x${string}`;\n}\n\n/**\n * Resolves a payment method hash from a provided catalog.\n *\n * This is the recommended method for resolving payment methods as it uses\n * the exact catalog from `getPaymentMethodsCatalog()`, ensuring consistency\n * with on-chain registrations.\n *\n * If the processor is not found in the catalog, falls back to the known\n * protocol payment method hashes before throwing an error.\n *\n * @param processorName - Payment platform name ('wise', 'revolut', etc.)\n * @param catalog - Payment method catalog from `getPaymentMethodsCatalog()`\n * @returns bytes32 payment method hash\n * @throws Error with available processors if not found in catalog or fallback\n *\n * @example\n * ```typescript\n * import { getPaymentMethodsCatalog, resolvePaymentMethodHashFromCatalog } from '@zkp2p/sdk';\n *\n * const catalog = getPaymentMethodsCatalog(8453, 'production');\n * const hash = resolvePaymentMethodHashFromCatalog('wise', catalog);\n * ```\n */\nexport function resolvePaymentMethodHashFromCatalog(\n  processorName: string,\n  catalog: Record<string, { paymentMethodHash: `0x${string}`; currencies?: `0x${string}`[] }>,\n): `0x${string}` {\n  if (!processorName) {\n    throw new Error('processorName is required to resolve paymentMethodHash');\n  }\n  if (processorName.startsWith('0x')) {\n    return ensureBytes32(processorName) as `0x${string}`;\n  }\n  const key = processorName.toLowerCase();\n  const entry = catalog?.[key];\n  if (entry?.paymentMethodHash) return entry.paymentMethodHash;\n\n  // Fallback to known protocol payment method hashes when catalog is missing the entry\n  const fallbackHash = METHOD_NAME_TO_HASH[key as keyof typeof METHOD_NAME_TO_HASH];\n  if (fallbackHash) return fallbackHash as `0x${string}`;\n\n  const available = Object.keys(catalog || {})\n    .sort()\n    .join(', ');\n  throw new Error(\n    available\n      ? `Unknown processorName: ${processorName}. Available: ${available}`\n      : `Unknown processorName: ${processorName}. The payment methods catalog is empty or unavailable.`,\n  );\n}\n\n/**\n * Reverse-lookup: converts a payment method hash back to its name.\n *\n * @param hash - The payment method hash (bytes32)\n * @param catalog - Payment method catalog from `getPaymentMethodsCatalog()`\n * @returns Payment platform name (e.g., 'wise') or undefined if not found\n *\n * @example\n * ```typescript\n * const name = resolvePaymentMethodNameFromHash('0x...', catalog);\n * console.log(name); // \"wise\"\n * ```\n */\nexport function resolvePaymentMethodNameFromHash(\n  hash: string,\n  catalog: PaymentMethodCatalog,\n): string | undefined {\n  if (!hash) return undefined;\n  const target = ensureBytes32(hash) as `0x${string}`;\n  for (const [name, entry] of Object.entries(catalog || {})) {\n    if (entry?.paymentMethodHash?.toLowerCase() === target.toLowerCase()) return name;\n  }\n  return undefined;\n}\n","import { parseBigIntLike as toBigInt } from './bigint';\n\nexport type PV_ReferralFee = {\n  recipient: `0x${string}`;\n  fee: bigint;\n};\n\nexport type PV_Deposit = {\n  depositor: string;\n  delegate: string;\n  token: string;\n  amount: bigint;\n  intentAmountRange: { min: bigint; max: bigint };\n  acceptingIntents: boolean;\n  remainingDeposits: bigint;\n  outstandingIntentAmount: bigint;\n  makerProtocolFee: bigint;\n  reservedMakerFees: bigint;\n  accruedMakerFees: bigint;\n  accruedReferrerFees: bigint;\n  intentGuardian: string;\n  retainOnEmpty: boolean;\n  referrer: string;\n  referrerFee: bigint;\n};\n\nexport type PV_Currency = { code: string; minConversionRate: bigint };\nexport type PV_PaymentMethodData = {\n  paymentMethod: string; // bytes32\n  verificationData: {\n    intentGatingService: string;\n    payeeDetails: string; // bytes32\n    data: string; // bytes\n  };\n  currencies: PV_Currency[];\n};\n\nexport type PV_DepositView = {\n  depositId: bigint;\n  deposit: PV_Deposit;\n  availableLiquidity: bigint;\n  paymentMethods: PV_PaymentMethodData[];\n  intentHashes: string[];\n};\n\nexport type PV_Intent = {\n  owner: string;\n  to: string;\n  escrow: string;\n  depositId: bigint;\n  amount: bigint;\n  timestamp: bigint;\n  paymentMethod: string; // bytes32\n  fiatCurrency: string; // bytes32\n  conversionRate: bigint;\n  referralFees: PV_ReferralFee[];\n  postIntentHook: string;\n  data: string;\n};\n\nexport type PV_IntentView = {\n  intentHash: string;\n  intent: PV_Intent;\n  deposit: Omit<PV_DepositView, 'intentHashes'>;\n};\n\nfunction parseReferralFees(rawIntent: any): PV_ReferralFee[] {\n  if (Array.isArray(rawIntent?.referralFees)) {\n    return rawIntent.referralFees.map((fee: any) => ({\n      recipient: (fee.recipient ?? '') as `0x${string}`,\n      fee: toBigInt(fee.fee ?? 0),\n    }));\n  }\n\n  const legacyRecipient = rawIntent?.referrer ?? '';\n  const legacyFee = toBigInt(rawIntent?.referrerFee ?? 0);\n  if (\n    typeof legacyRecipient === 'string' &&\n    legacyRecipient !== '' &&\n    legacyRecipient !== '0x0000000000000000000000000000000000000000' &&\n    legacyFee > 0n\n  ) {\n    return [{ recipient: legacyRecipient as `0x${string}`, fee: legacyFee }];\n  }\n\n  return [];\n}\n\nexport function parseDepositView(raw: any): PV_DepositView {\n  return {\n    depositId: toBigInt(raw.depositId),\n    deposit: {\n      depositor: raw.deposit.depositor,\n      delegate: raw.deposit.delegate,\n      token: raw.deposit.token,\n      amount: toBigInt(raw.deposit.amount ?? 0),\n      intentAmountRange: {\n        min: toBigInt(raw.deposit.intentAmountRange?.min ?? 0),\n        max: toBigInt(raw.deposit.intentAmountRange?.max ?? 0),\n      },\n      acceptingIntents: raw.deposit.acceptingIntents ?? false,\n      remainingDeposits: toBigInt(raw.deposit.remainingDeposits ?? 0),\n      outstandingIntentAmount: toBigInt(raw.deposit.outstandingIntentAmount ?? 0),\n      makerProtocolFee: toBigInt(raw.deposit.makerProtocolFee ?? 0),\n      reservedMakerFees: toBigInt(raw.deposit.reservedMakerFees ?? 0),\n      accruedMakerFees: toBigInt(raw.deposit.accruedMakerFees ?? 0),\n      accruedReferrerFees: toBigInt(raw.deposit.accruedReferrerFees ?? 0),\n      intentGuardian: raw.deposit.intentGuardian ?? '',\n      retainOnEmpty: raw.deposit.retainOnEmpty ?? false,\n      referrer: raw.deposit.referrer ?? '',\n      referrerFee: toBigInt(raw.deposit.referrerFee ?? 0),\n    },\n    availableLiquidity: toBigInt(raw.availableLiquidity),\n    paymentMethods: (raw.paymentMethods || []).map((pm: any) => ({\n      paymentMethod: pm.paymentMethod,\n      verificationData: {\n        intentGatingService: pm.verificationData.intentGatingService,\n        payeeDetails: pm.verificationData.payeeDetails,\n        data: pm.verificationData.data,\n      },\n      currencies: (pm.currencies || []).map((c: any) => ({\n        code: c.code,\n        minConversionRate: toBigInt(c.minConversionRate),\n      })),\n    })),\n    intentHashes: raw.intentHashes || [],\n  };\n}\n\nexport function parseIntentView(raw: any): PV_IntentView {\n  const parsedDeposit = parseDepositView(raw.deposit);\n  const deposit: Omit<PV_DepositView, 'intentHashes'> = {\n    depositId: parsedDeposit.depositId,\n    deposit: parsedDeposit.deposit,\n    availableLiquidity: parsedDeposit.availableLiquidity,\n    paymentMethods: parsedDeposit.paymentMethods,\n  };\n  return {\n    intentHash: raw.intentHash,\n    intent: {\n      owner: raw.intent.owner,\n      to: raw.intent.to,\n      escrow: raw.intent.escrow,\n      depositId: toBigInt(raw.intent.depositId),\n      amount: toBigInt(raw.intent.amount),\n      timestamp: toBigInt(raw.intent.timestamp),\n      paymentMethod: raw.intent.paymentMethod,\n      fiatCurrency: raw.intent.fiatCurrency,\n      conversionRate: toBigInt(raw.intent.conversionRate),\n      referralFees: parseReferralFees(raw.intent),\n      postIntentHook: raw.intent.postIntentHook,\n      data: raw.intent.data,\n    },\n    deposit,\n  };\n}\n\n// Enrichment helpers for dashboards/explorers\nimport { getPaymentMethodsCatalog, type RuntimeEnv } from '../contracts';\nimport { resolvePaymentMethodNameFromHash } from './paymentResolution';\nimport { getCurrencyInfoFromHash } from './currency';\n\nexport function enrichPvDepositView(\n  view: PV_DepositView,\n  chainId: number,\n  env: RuntimeEnv = 'production',\n) {\n  const catalog = getPaymentMethodsCatalog(chainId, env);\n  return {\n    ...view,\n    paymentMethods: view.paymentMethods.map((pm) => ({\n      ...pm,\n      processorName: resolvePaymentMethodNameFromHash(pm.paymentMethod, catalog),\n      currencies: pm.currencies.map((c) => ({\n        ...c,\n        currencyInfo: getCurrencyInfoFromHash(c.code),\n      })),\n    })),\n  };\n}\n\nexport function enrichPvIntentView(\n  view: PV_IntentView,\n  chainId: number,\n  env: RuntimeEnv = 'production',\n) {\n  const catalog = getPaymentMethodsCatalog(chainId, env);\n  return {\n    ...view,\n    intent: {\n      ...view.intent,\n      processorName: resolvePaymentMethodNameFromHash(view.intent.paymentMethod, catalog),\n      currencyInfo: getCurrencyInfoFromHash(view.intent.fiatCurrency),\n    },\n    deposit: enrichPvDepositView(view.deposit as any, chainId, env),\n  } as any;\n}\n"]}