@zkp2p/sdk 0.12.2-rc.0 → 0.12.2-rc.1

package/README.md

@@ -108,7 +108,7 @@ Indexer defaults by environment:
 | React hooks                    | `@zkp2p/sdk/react` exports hooks for deposits, intents, delegation, vaults, and payment methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | Attribution                    | ERC-8021 helpers like `sendTransactionWithAttribution`, `encodeWithAttribution`, and `txOverrides.referrer` support                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Taker staking                  | `ensureStakeAllowance`, `depositStake`, `withdrawStake`, `claim`, `setTakerAuthorization`, `selectStakeOwner`, `clearStakeOwner`, direct StakeVault reads, and `client.indexer.getStakingState()`                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| Chargeback keepers             | `releaseMaturedChargebackIntent`, `releaseMaturedChargebackIntents`, with caller-pinned `chargebackPolicyAddress` support                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| Chargeback keepers             | `releaseMaturedDisputeProtectionIntent`, `releaseMaturedDisputeProtectionIntents`, with caller-pinned `disputeProtectionPolicyAddress` support                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 
 ## Extension Metadata Bridge
 
@@ -256,53 +256,123 @@ const indexed = await client.indexer.getStakingState({
   chainId: 8453,
   environment: 'base',
   vaultAddress: client.getStakeVaultContract().address,
-  chargebackPolicyAddress: client.getChargebackPolicyContract().address,
+  disputeProtectionPolicyAddress: client.getDisputeProtectionPolicyContract().address,
   taker: takerAddress,
   // Always supply the effective owner from the fresh on-chain read.
   stakeOwner: onchain.stakeOwner,
 });
 // indexed: effective/raw ownership, total/locked/free stake, claimable,
-// authorizations, admissions-pause state, Vault controller, and per-row
-// freshness.
+// authorizations, Vault controller, per-row provenance, and the indexer head.
+
+const locks = await client.indexer.getStakeLocks({
+  chainId: 8453,
+  vaultAddress: client.getStakeVaultContract().address,
+  stakeOwner: onchain.stakeOwner,
+  status: 'ACTIVE',
+  limit: 50,
+});
+
+const activity = await client.indexer.getStakeActivity({
+  chainId: 8453,
+  vaultAddress: client.getStakeVaultContract().address,
+  merchant: takerAddress,
+  limit: 50,
+});
+
+const finalizedDisputes = await client.indexer.getDisputeProtectionIntents({
+  chainId: 8453,
+  policyAddress: client.getDisputeProtectionPolicyContract().address,
+  throughBlockNumber: finalizedBlockNumber.toString(),
+  limit: 50,
+});
 ```
 
-Stake writes expose direct and `.prepare()` variants: `depositStake`,
-`withdrawStake`, `claim`, `setTakerAuthorization`, `selectStakeOwner`, and
-`clearStakeOwner`. There is no withdrawal request, cooldown, or exit
+Stake and deposit-protection writes expose direct and `.prepare()` variants:
+`depositStake`, `withdrawStake`, `claim`, `setTakerAuthorization`,
+`selectStakeOwner`, `clearStakeOwner`, and `setDisputeProtectionEnabled`.
+There is no withdrawal request, cooldown, or exit
 lifecycle — `withdrawStake` is immediate up to `freeStake`, and `claim`
 withdraws the complete claimable balance. Chargebackable capacity is exactly
 the effective owner's free stake (1:1); never sum a taker's self-stake with a
 sponsor's stake.
 
-The vault's controller is the `ChargebackPolicy` contract. It owns
+The vault's controller is the `DisputeProtectionPolicy` contract. It owns
 per-payment-method risk windows (`getRiskWindow(paymentMethodHash)`),
-per-deposit chargeback enablement (`isChargebackEnabled(escrow, depositId)`),
-and the global `admissionsPaused()` switch. `@zkp2p/contracts-v2@0.4.0`
-resolves the deployed StakeVault, ChargebackPolicy, and OrchestratorV3 for
+per-deposit chargeback enablement (`isDisputeProtectionEnabled(escrow, depositId)`),
+and the global `admissionsPaused()` switch. The selected `@zkp2p/contracts-v2`
+bundle resolves the StakeVault, DisputeProtectionPolicy, and OrchestratorV3 for
 both the production and staging bundles; a bundle without them fails closed
 (`VITE_BASE_STAGING_STAKE_VAULT_ADDRESS` /
-`VITE_BASE_STAGING_CHARGEBACK_POLICY_ADDRESS` overrides support local
+`VITE_BASE_STAGING_DISPUTE_PROTECTION_POLICY_ADDRESS` overrides support local
 deployments).
 
 Keeper writes are direct and prepareable:
 
 ```ts
-const release = await client.releaseMaturedChargebackIntents.prepare({
+const enableProtection = await client.setDisputeProtectionEnabled.prepare({
+  escrow: depositEscrow,
+  depositId: 42n,
+  enabled: true,
+});
+
+const release = await client.releaseMaturedDisputeProtectionIntents.prepare({
   intentHashes: [intentHash],
-  chargebackPolicyAddress: snapshottedPolicyAddress,
+  disputeProtectionPolicyAddress: snapshottedPolicyAddress,
 });
 ```
 
-An explicit `chargebackPolicyAddress` is caller-pinned and may be outside the
+An explicit `disputeProtectionPolicyAddress` is caller-pinned and may be outside the
 client's configured deployment context, allowing sweepers to group intents by
 their snapshotted policy deployment without a later SDK configuration change
 rerouting them.
 
-`client.indexer.getStakingState()` composes the `@zkp2p/indexer-schema@0.20.0`
-account rows and preserves their individual freshness. Its caller-supplied
-`stakeOwner` must come from a fresh on-chain `stakeOwnerOf(taker)` read; stale
-indexed ownership is reported without attributing another owner's balance.
-Refetch immediately before signaling; the contract stays authoritative.
+`client.indexer.getStakingState()` composes the `@zkp2p/indexer-schema`
+account rows, preserves their individual update blocks, and reports the
+chain's actual indexer head as `freshness.indexerHeadBlockNumber`. Its
+caller-supplied `stakeOwner` must come from a fresh on-chain
+`stakeOwnerOf(taker)` read; stale indexed ownership is reported without
+attributing another owner's balance. Refetch immediately before signaling; the
+contract stays authoritative.
+
+The three history methods return `{ items, nextCursor, asOf }`; finalized
+disputes also return `endCursor`. Cursors are
+opaque keysets, limits are integers from 1 through 100, and all numeric values
+are unsigned decimal strings. `asOf` identifies the latest row observed in the
+returned page; it is not an indexer-head or strong-consistency guarantee.
+The finalized-dispute page requires a code-owned `throughBlockNumber`; use the
+same finalized cutoff for every cursor in one ingestion pass. Follow
+`nextCursor` while it is non-null, then atomically persist the terminal page's
+`endCursor` with its final block/log position; `endCursor` is null only for an
+empty page.
+
+Before enabling dispute-protected admission, prove that the live Base contracts
+still match the deployment manifest embedded in the exact SDK artifact:
+
+```ts
+const readiness = await client.getDisputeProtectionReadiness();
+
+if (readiness.state !== 'active_successor_verified' || !readiness.readyForDisputeProtection) {
+  throw new Error(`Dispute protection is unavailable: ${readiness.state}`);
+}
+```
+
+The reader pins every code and state read to one `asOfBlock`, including exact
+governance owners, authorization sets, attestation witnesses, and signature
+thresholds. It distinguishes
+`recognized_predecessor`, `passive_successor`, `active_successor_verified`,
+`verified_no_hook`, and `mismatch`. A dormant successor is checked only when
+`{ verifyPassiveSuccessor: true }` is supplied. An exact active successor stays
+verified while `orchestratorPaused`, `allowMultipleIntents`, and
+`policyAdmissionsPaused` report operational traffic gates;
+`readyForDisputeProtection` is true only when all three allow new protected
+traffic. Unknown hooks, misconfigured successors, runtime-code changes,
+dependency mismatches, and RPC failures return `mismatch` and fail closed.
+
+`SDK_BUILD_METADATA` and the `@zkp2p/sdk/build-metadata.json` export identify
+the SDK commit, contracts package, indexer schema package, and active manifest
+selection hashes. A local build has the deterministic `development` identity
+and is deliberately non-distributable, so its readiness reader returns
+`mismatch` before making RPC calls.
 
 For table-style liquidity UIs, the low-level `apiGetOrderbookTable()` adapter exposes curator's paginated public/private orderbook rows and row-level privacy metadata.
 
@@ -726,7 +796,7 @@ const stakingState = await client.indexer.getStakingState({
   chainId: 8453,
   environment: 'base',
   vaultAddress: '0xStakeVault',
-  chargebackPolicyAddress: '0xChargebackPolicy',
+  disputeProtectionPolicyAddress: '0xDisputeProtectionPolicy',
   taker: '0xTaker',
   stakeOwner: '0xEffectiveStakeOwner',
 });
@@ -775,6 +845,7 @@ import {
   useCreateDeposit,
   useSignalIntent,
   useExtendIntentLifetime,
+  useSetDisputeProtectionEnabled,
   useCreateVault,
   useVaultDelegation,
 } from '@zkp2p/sdk/react';
@@ -782,13 +853,14 @@ import {
 const createDeposit = useCreateDeposit({ client });
 const signalIntent = useSignalIntent({ client });
 const extendIntent = useExtendIntentLifetime({ client });
+const disputeProtection = useSetDisputeProtectionEnabled({ client });
 const createVault = useCreateVault({ client, sendTransaction });
 const vaultDelegation = useVaultDelegation({ client, sendTransaction, sendBatch });
 ```
 
 Hook groups:
 
-- Deposit lifecycle: `useCreateDeposit`, `useAddFunds`, `useRemoveFunds`, `useWithdrawDeposit`, `useSetAcceptingIntents`, `useSetIntentRange`, `useSetCurrencyMinRate`, `useSetRetainOnEmpty`
+- Deposit lifecycle: `useCreateDeposit`, `useAddFunds`, `useRemoveFunds`, `useWithdrawDeposit`, `useSetAcceptingIntents`, `useSetIntentRange`, `useSetCurrencyMinRate`, `useSetRetainOnEmpty`, `useSetDisputeProtectionEnabled`
 - Payment and currency management: `useAddPaymentMethods`, `useRemovePaymentMethod`, `useSetPaymentMethodActive`, `useAddCurrencies`, `useRemoveCurrency`, `useDeactivateCurrency`
 - Intent lifecycle: `useSignalIntent`, `useFulfillIntent`, `useReleaseFundsToPayer`, `usePruneExpiredIntents`, `useExtendIntentLifetime`
 - Delegation: `useSetDelegate`, `useRemoveDelegate`
@@ -805,7 +877,7 @@ import {
   getOrchestratorV3Contract,
   getPaymentMethodsCatalog,
   getRateManagerContracts,
-  getChargebackPolicyContract,
+  getDisputeProtectionPolicyContract,
   getStakeVaultContract,
   RISK_POSITION_SETTLED_EVENT_ABI,
   resolveFiatCurrencyBytes32,
@@ -816,7 +888,7 @@ const contracts = getContracts(8453, 'production');
 const rateManagerContracts = getRateManagerContracts(8453, 'production');
 const stakeVault = getStakeVaultContract(8453, 'staging');
 const orchestratorV3 = getOrchestratorV3Contract(8453, 'staging');
-const chargebackPolicy = getChargebackPolicyContract(8453, 'staging');
+const disputeProtectionPolicy = getDisputeProtectionPolicyContract(8453, 'staging');
 const paymentMethods = getPaymentMethodsCatalog(8453, 'production');
 const usdHash = resolveFiatCurrencyBytes32('USD');
 const wiseHash = resolvePaymentMethodHash('wise', { env: 'production' });

package/dist/build-metadata.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": 1,
+  "source": {
+    "repository": "zkp2p/zkp2p-clients",
+    "commitSha": "3a56c340d516a948d0c0f715722d37cf95a11b2b",
+    "kind": "github",
+    "distributable": true
+  },
+  "sdkPackageVersion": "0.12.2-rc.1",
+  "contractsPackageVersion": "0.4.1-rc.6",
+  "indexerSchemaPackageVersion": "0.22.0-rc.1",
+  "activeDisputeStack": {
+    "base": {
+      "version": 1,
+      "selectionHash": "a4f17ae7c1620ecfe7d036f0b9cc7b39c50e1382dc8dc14d2e5f7f21061cd5ad"
+    },
+    "baseStaging": {
+      "version": 1,
+      "selectionHash": "586c90f9de3d10b6d48f4286c709aa7f870fc2fdcfb0af1da947c1da76132dd0"
+    }
+  }
+}

package/dist/{chunk-GHQK65J2.mjs → chunk-3J4FPMPW.mjs}

@@ -43,5 +43,5 @@ var ContractError = class extends ZKP2PError {
 };
 
 export { APIError, ContractError, ErrorCode, NetworkError, ValidationError, ZKP2PError };
-//# sourceMappingURL=chunk-GHQK65J2.mjs.map
-//# sourceMappingURL=chunk-GHQK65J2.mjs.map
+//# sourceMappingURL=chunk-3J4FPMPW.mjs.map
+//# sourceMappingURL=chunk-3J4FPMPW.mjs.map

package/dist/{chunk-GHQK65J2.mjs.map → chunk-3J4FPMPW.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors/index.ts"],"names":["ErrorCode"],"mappings":";AAGO,IAAK,SAAA,qBAAAA,UAAAA,KAAL;AAEL,EAAAA,WAAA,YAAA,CAAA,GAAa,YAAA;AAEb,EAAAA,WAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,WAAA,KAAA,CAAA,GAAM,KAAA;AAEN,EAAAA,WAAA,UAAA,CAAA,GAAW,UAAA;AAEX,EAAAA,WAAA,SAAA,CAAA,GAAU,SAAA;AAVA,EAAA,OAAAA,UAAAA;AAAA,CAAA,EAAA,SAAA,IAAA,EAAA;AA+BL,IAAM,UAAA,GAAN,cAAyB,KAAA,CAAM;AAAA,EAQpC,WAAA,CAAY,OAAA,EAAiB,IAAA,GAAkB,SAAA,gBAAmB,SAAmB,KAAA,EAAgB;AACnG,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AACf,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AACF;AAUO,IAAM,eAAA,GAAN,cAA8B,UAAA,CAAW;AAAA,EAC9C,WAAA,CAAY,OAAA,EAAiB,KAAA,EAAgB,OAAA,EAAmB;AAC9D,IAAA,KAAA,CAAM,OAAA,EAAS,YAAA,mBAAsB,OAAA,EAAS,KAAK,CAAA;AACnD,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAKO,IAAM,YAAA,GAAN,cAA2B,UAAA,CAAW;AAAA,EAC3C,WAAA,CAAY,SAAiB,OAAA,EAAmB;AAC9C,IAAA,KAAA,CAAM,OAAA,EAAS,yBAAmB,OAAO,CAAA;AACzC,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AAAA,EACd;AACF;AAcO,IAAM,QAAA,GAAN,cAAuB,UAAA,CAAW;AAAA,EAIvC,WAAA,CAAY,OAAA,EAAiB,MAAA,EAAiB,OAAA,EAAmB;AAC/D,IAAA,KAAA,CAAM,OAAA,EAAS,iBAAe,OAAO,CAAA;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AAAA,EACd;AACF;AAOO,IAAM,aAAA,GAAN,cAA4B,UAAA,CAAW;AAAA,EAC5C,WAAA,CAAY,SAAiB,OAAA,EAAmB;AAC9C,IAAA,KAAA,CAAM,OAAA,EAAS,2BAAoB,OAAO,CAAA;AAC1C,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AAAA,EACd;AACF","file":"chunk-GHQK65J2.mjs","sourcesContent":["/**\n * Error codes for categorizing SDK errors.\n */\nexport enum ErrorCode {\n  /** Input validation failed */\n  VALIDATION = 'VALIDATION',\n  /** Network/RPC error */\n  NETWORK = 'NETWORK',\n  /** API request failed */\n  API = 'API',\n  /** Smart contract error */\n  CONTRACT = 'CONTRACT',\n  /** Unknown/uncategorized error */\n  UNKNOWN = 'UNKNOWN'\n}\n\n/**\n * Base error class for all SDK errors.\n *\n * All SDK-specific errors extend this class, making it easy to catch\n * and handle SDK errors uniformly.\n *\n * @example\n * ```typescript\n * try {\n *   await client.createDeposit(...);\n * } catch (error) {\n *   if (error instanceof ZKP2PError) {\n *     console.log('SDK Error:', error.code, error.message);\n *     console.log('Details:', error.details);\n *   }\n * }\n * ```\n */\nexport class ZKP2PError extends Error {\n  /** Error category code */\n  code: ErrorCode;\n  /** Additional error details (varies by error type) */\n  details?: unknown;\n  /** Field that caused the error (for validation errors) */\n  field?: string;\n\n  constructor(message: string, code: ErrorCode = ErrorCode.UNKNOWN, details?: unknown, field?: string) {\n    super(message);\n    this.name = 'ZKP2PError';\n    this.code = code;\n    this.details = details;\n    this.field = field;\n  }\n}\n\n/**\n * Thrown when input validation fails.\n *\n * @example\n * ```typescript\n * throw new ValidationError('Amount must be positive', 'amount');\n * ```\n */\nexport class ValidationError extends ZKP2PError {\n  constructor(message: string, field?: string, details?: unknown) {\n    super(message, ErrorCode.VALIDATION, details, field);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Thrown when a network or RPC request fails.\n */\nexport class NetworkError extends ZKP2PError {\n  constructor(message: string, details?: unknown) {\n    super(message, ErrorCode.NETWORK, details);\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * Thrown when an API request fails.\n *\n * @example\n * ```typescript\n * catch (error) {\n *   if (error instanceof APIError) {\n *     console.log('HTTP Status:', error.status);\n *   }\n * }\n * ```\n */\nexport class APIError extends ZKP2PError {\n  /** HTTP status code (if applicable) */\n  status?: number;\n\n  constructor(message: string, status?: number, details?: unknown) {\n    super(message, ErrorCode.API, details);\n    this.status = status;\n    this.name = 'APIError';\n  }\n}\n\n/**\n * Thrown when a smart contract call fails.\n *\n * Check the `details` property for the underlying viem error.\n */\nexport class ContractError extends ZKP2PError {\n  constructor(message: string, details?: unknown) {\n    super(message, ErrorCode.CONTRACT, details);\n    this.name = 'ContractError';\n  }\n}\n\n"]}
+{"version":3,"sources":["../src/errors/index.ts"],"names":["ErrorCode"],"mappings":";AAGO,IAAK,SAAA,qBAAAA,UAAAA,KAAL;AAEL,EAAAA,WAAA,YAAA,CAAA,GAAa,YAAA;AAEb,EAAAA,WAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,WAAA,KAAA,CAAA,GAAM,KAAA;AAEN,EAAAA,WAAA,UAAA,CAAA,GAAW,UAAA;AAEX,EAAAA,WAAA,SAAA,CAAA,GAAU,SAAA;AAVA,EAAA,OAAAA,UAAAA;AAAA,CAAA,EAAA,SAAA,IAAA,EAAA;AA+BL,IAAM,UAAA,GAAN,cAAyB,KAAA,CAAM;AAAA,EAQpC,WAAA,CAAY,OAAA,EAAiB,IAAA,GAAkB,SAAA,gBAAmB,SAAmB,KAAA,EAAgB;AACnG,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AACf,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AACF;AAUO,IAAM,eAAA,GAAN,cAA8B,UAAA,CAAW;AAAA,EAC9C,WAAA,CAAY,OAAA,EAAiB,KAAA,EAAgB,OAAA,EAAmB;AAC9D,IAAA,KAAA,CAAM,OAAA,EAAS,YAAA,mBAAsB,OAAA,EAAS,KAAK,CAAA;AACnD,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAKO,IAAM,YAAA,GAAN,cAA2B,UAAA,CAAW;AAAA,EAC3C,WAAA,CAAY,SAAiB,OAAA,EAAmB;AAC9C,IAAA,KAAA,CAAM,OAAA,EAAS,yBAAmB,OAAO,CAAA;AACzC,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AAAA,EACd;AACF;AAcO,IAAM,QAAA,GAAN,cAAuB,UAAA,CAAW;AAAA,EAIvC,WAAA,CAAY,OAAA,EAAiB,MAAA,EAAiB,OAAA,EAAmB;AAC/D,IAAA,KAAA,CAAM,OAAA,EAAS,iBAAe,OAAO,CAAA;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AAAA,EACd;AACF;AAOO,IAAM,aAAA,GAAN,cAA4B,UAAA,CAAW;AAAA,EAC5C,WAAA,CAAY,SAAiB,OAAA,EAAmB;AAC9C,IAAA,KAAA,CAAM,OAAA,EAAS,2BAAoB,OAAO,CAAA;AAC1C,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AAAA,EACd;AACF","file":"chunk-3J4FPMPW.mjs","sourcesContent":["/**\n * Error codes for categorizing SDK errors.\n */\nexport enum ErrorCode {\n  /** Input validation failed */\n  VALIDATION = 'VALIDATION',\n  /** Network/RPC error */\n  NETWORK = 'NETWORK',\n  /** API request failed */\n  API = 'API',\n  /** Smart contract error */\n  CONTRACT = 'CONTRACT',\n  /** Unknown/uncategorized error */\n  UNKNOWN = 'UNKNOWN'\n}\n\n/**\n * Base error class for all SDK errors.\n *\n * All SDK-specific errors extend this class, making it easy to catch\n * and handle SDK errors uniformly.\n *\n * @example\n * ```typescript\n * try {\n *   await client.createDeposit(...);\n * } catch (error) {\n *   if (error instanceof ZKP2PError) {\n *     console.log('SDK Error:', error.code, error.message);\n *     console.log('Details:', error.details);\n *   }\n * }\n * ```\n */\nexport class ZKP2PError extends Error {\n  /** Error category code */\n  code: ErrorCode;\n  /** Additional error details (varies by error type) */\n  details?: unknown;\n  /** Field that caused the error (for validation errors) */\n  field?: string;\n\n  constructor(message: string, code: ErrorCode = ErrorCode.UNKNOWN, details?: unknown, field?: string) {\n    super(message);\n    this.name = 'ZKP2PError';\n    this.code = code;\n    this.details = details;\n    this.field = field;\n  }\n}\n\n/**\n * Thrown when input validation fails.\n *\n * @example\n * ```typescript\n * throw new ValidationError('Amount must be positive', 'amount');\n * ```\n */\nexport class ValidationError extends ZKP2PError {\n  constructor(message: string, field?: string, details?: unknown) {\n    super(message, ErrorCode.VALIDATION, details, field);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Thrown when a network or RPC request fails.\n */\nexport class NetworkError extends ZKP2PError {\n  constructor(message: string, details?: unknown) {\n    super(message, ErrorCode.NETWORK, details);\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * Thrown when an API request fails.\n *\n * @example\n * ```typescript\n * catch (error) {\n *   if (error instanceof APIError) {\n *     console.log('HTTP Status:', error.status);\n *   }\n * }\n * ```\n */\nexport class APIError extends ZKP2PError {\n  /** HTTP status code (if applicable) */\n  status?: number;\n\n  constructor(message: string, status?: number, details?: unknown) {\n    super(message, ErrorCode.API, details);\n    this.status = status;\n    this.name = 'APIError';\n  }\n}\n\n/**\n * Thrown when a smart contract call fails.\n *\n * Check the `details` property for the underlying viem error.\n */\nexport class ContractError extends ZKP2PError {\n  constructor(message: string, details?: unknown) {\n    super(message, ErrorCode.CONTRACT, details);\n    this.name = 'ContractError';\n  }\n}\n\n"]}

package/dist/chunk-NCX4BO7G.mjs

@@ -0,0 +1,12 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// <define:__ZKP2P_SDK_BUILD_METADATA__>
+var define_ZKP2P_SDK_BUILD_METADATA_default = { schemaVersion: 1, source: { repository: "zkp2p/zkp2p-clients", commitSha: "3a56c340d516a948d0c0f715722d37cf95a11b2b", kind: "github", distributable: true }, sdkPackageVersion: "0.12.2-rc.1", contractsPackageVersion: "0.4.1-rc.6", indexerSchemaPackageVersion: "0.22.0-rc.1", activeDisputeStack: { base: { version: 1, selectionHash: "a4f17ae7c1620ecfe7d036f0b9cc7b39c50e1382dc8dc14d2e5f7f21061cd5ad" }, baseStaging: { version: 1, selectionHash: "586c90f9de3d10b6d48f4286c709aa7f870fc2fdcfb0af1da947c1da76132dd0" } } };
+
+export { __export, define_ZKP2P_SDK_BUILD_METADATA_default };
+//# sourceMappingURL=chunk-NCX4BO7G.mjs.map
+//# sourceMappingURL=chunk-NCX4BO7G.mjs.map

package/dist/chunk-NCX4BO7G.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["%3Cdefine:__ZKP2P_SDK_BUILD_METADATA__%3E"],"names":[],"mappings":";;;;;;;AAAA,IAAA,uCAAA,GAAA,EAAC,aAAA,EAAgB,CAAA,EAAE,MAAA,EAAS,EAAC,YAAa,qBAAA,EAAsB,SAAA,EAAY,0CAAA,EAA2C,IAAA,EAAO,UAAS,aAAA,EAAgB,IAAA,EAAI,EAAE,iBAAA,EAAoB,eAAc,uBAAA,EAA0B,YAAA,EAAa,2BAAA,EAA8B,aAAA,EAAc,oBAAqB,EAAC,IAAA,EAAO,EAAC,OAAA,EAAU,GAAE,aAAA,EAAgB,kEAAA,EAAkE,EAAE,WAAA,EAAc,EAAC,OAAA,EAAU,CAAA,EAAE,aAAA,EAAgB,kEAAA,IAAmE","file":"chunk-NCX4BO7G.mjs","sourcesContent":["{\"schemaVersion\":1,\"source\":{\"repository\":\"zkp2p/zkp2p-clients\",\"commitSha\":\"3a56c340d516a948d0c0f715722d37cf95a11b2b\",\"kind\":\"github\",\"distributable\":true},\"sdkPackageVersion\":\"0.12.2-rc.1\",\"contractsPackageVersion\":\"0.4.1-rc.6\",\"indexerSchemaPackageVersion\":\"0.22.0-rc.1\",\"activeDisputeStack\":{\"base\":{\"version\":1,\"selectionHash\":\"a4f17ae7c1620ecfe7d036f0b9cc7b39c50e1382dc8dc14d2e5f7f21061cd5ad\"},\"baseStaging\":{\"version\":1,\"selectionHash\":\"586c90f9de3d10b6d48f4286c709aa7f870fc2fdcfb0af1da947c1da76132dd0\"}}}"]}