@zkp2p/sdk 0.7.1 → 0.8.0

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.5.2`
+Current version: `0.7.1`
 
 ## Why This SDK
 
@@ -73,6 +73,7 @@ const client = new Zkp2pClient({
 - Supported runtime environments: `'production'`, `'preproduction'`, `'staging'`
 - `runtimeEnv` default: `'production'`
 - `rpcUrl`: optional RPC URL override (defaults to wallet's chain RPC)
+- `rpcTransport`: optional viem transport override for contract reads
 - `apiKey`: optional internal curator API key for internal seller verification only
 - `authorizationToken` / `getAuthorizationToken`: optional bearer auth for indexer flows
 - `indexerApiKey`: optional `x-api-key` for indexer proxy auth
@@ -168,8 +169,8 @@ const result = await client.createDeposit({
   token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
   amount: 10_000_000n,
   intentAmountRange: { min: 100_000n, max: 5_000_000n },
-  processorNames: ['wise'],
-  depositData: [{ email: 'maker@example.com' }],
+  processorNames: ['revolut'],
+  payeeData: [{ offchainId: 'maker-revtag' }],
   conversionRates: [[{ currency: Currency.USD, conversionRate: '1020000000000000000' }]],
 });
 
@@ -184,9 +185,20 @@ If you do not pass `payeeDetailsHashes`, `createDeposit()` can register the paye
 ```ts
 import { resolvePaymentMethodHash } from '@zkp2p/sdk';
 
+// App-specific: request this from the ZKP2P attestation service after capturing
+// Wise registration material through PeerAuth / Buyer TEE.
+const identityAttestation = await getWiseIdentityAttestation();
+
 const { hashedOnchainIds } = await client.registerPayeeDetails({
   processorNames: ['wise'],
-  depositData: [{ email: 'maker@example.com' }],
+  payeeData: [
+    {
+      offchainId: 'maker-wisetag',
+      // Wise maker registration requires an identity attestation from the
+      // attestation service. Pass it directly or inside metadata.identityAttestation.
+      identityAttestation,
+    },
+  ],
 });
 
 const quote = await client.getQuote({
@@ -272,13 +284,23 @@ Use `referralFees[]` for multi-recipient fee distribution on OrchestratorV2.
 
 ## Referral Account API
 
-Authenticated apps can manage Peer referral accounts through the SDK. Configure
-`authorizationToken` or `getAuthorizationToken` on `Zkp2pClient`, or pass an
-override per call.
+Apps can read referral data publicly by wallet address and can write with either
+a Privy bearer token or an EIP-712 wallet signature. Configure
+`authorizationToken` / `getAuthorizationToken` on `Zkp2pClient` for bearer mode,
+or use the `WithSignature` methods for wallet-only integrations.
 
 ```ts
+const publicDashboard = await client.getReferralDashboard({
+  address: '0x1111111111111111111111111111111111111111',
+});
+
+const lookup = await client.lookupReferralCode('PEER42');
+// { code, referrerWalletAddress, isActive }
+
 const dashboard = await client.getReferralDashboard();
-// { code, l1FeeBps, l2FeeBps, l1RefereeCount, ... }
+// { code, redemption, l1FeeBps, l2FeeBps, l1RefereeCount, ... }
+
+await client.createReferralCode();
 
 await client.redeemReferralCode('PEER42');
 
@@ -288,10 +310,29 @@ const earnings = await client.getReferralEarnings();
 // { totalWei, l1Wei, l2Wei, unattributedWei, ... }
 ```
 
-The dashboard call returns the authenticated user's generated referral code.
-`redeemReferralCode()` applies another user's code to the authenticated account;
-`updateReferralCode()` customizes the authenticated user's own code. Codes are
-normalized to uppercase before being sent to curator.
+For external integrators without Privy, the SDK signs the curator EIP-712
+payload with the configured `walletClient`. Production signatures default to the
+`base_production` audience and a current Unix `issuedAt`; override `audience` for
+non-production curator environments.
+
+```ts
+const { code: myCode } = await client.createReferralCodeWithSignature();
+
+await client.redeemReferralCodeWithSignature('PEER42', {
+  referrerWalletAddress: lookup.referrerWalletAddress,
+});
+
+await client.updateReferralCodeWithSignature('MYCODE', {
+  oldCode: myCode,
+});
+```
+
+Public `getReferralDashboard({ address })`, `getReferralEarnings({ address })`,
+and `lookupReferralCode()` do not send auth headers. Bearer-mode dashboard reads
+create or fetch the authenticated user's code. Signature-mode writes send exactly
+the body shape expected by `/v2/referral/code`, `/v2/referral/redeem`, and
+`PATCH /v2/referral/code`; codes are normalized to uppercase before signing and
+submission.
 
 ## Prepared Transactions
 

package/dist/{chunk-BQINCOSO.mjs → chunk-EIOXBVXP.mjs}

@@ -21,8 +21,7 @@ var TAKER_TIER_FEE_DISCOUNT_BPS = {
   PEER: 5,
   PLUS: 10,
   PRO: 20,
-  PLATINUM: 30,
-  PEER_PRESIDENT: 30
+  PLATINUM: 30
 };
 function getTakerTierFeeDiscountBps(tier) {
   if (!tier) return 0;
@@ -108,5 +107,5 @@ var prepareSetDelegationTx = async (client, params, referrer) => {
 };
 
 export { TAKER_TIER_CAPS, TAKER_TIER_FEE_DISCOUNT_BPS, TAKER_TIER_ORDER, TAKER_TIER_SCHEDULE, ZERO_ADDRESS, ZERO_RATE_MANAGER_ID, asErrorMessage, assertAtomicDelegationSwitchSupport, assertDelegationMethodSupport, classifyDelegationState, getDelegationRoute, getNextTakerTier, getTakerTierFeeDiscountBps, isZeroRateManagerId, normalizeRateManagerId, normalizeRegistry, prepareClearDelegationTx, prepareSetDelegationTx };
-//# sourceMappingURL=chunk-BQINCOSO.mjs.map
-//# sourceMappingURL=chunk-BQINCOSO.mjs.map
+//# sourceMappingURL=chunk-EIOXBVXP.mjs.map
+//# sourceMappingURL=chunk-EIOXBVXP.mjs.map

package/dist/chunk-EIOXBVXP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/takerTiers.ts","../src/react/hooks/vaultUtils.ts"],"names":[],"mappings":"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","file":"chunk-EIOXBVXP.mjs","sourcesContent":["import type { TakerTierLevel } from './types';\n\n/**\n * Canonical taker tier schedule — the single client-side source of truth for\n * per-intent caps and volume thresholds. Mirrors the curator's authoritative\n * tier engine (curator `src/common/services/tier/tierConstants.ts`), which is\n * what the backend actually enforces.\n *\n * The live qualification signal is Peer Pay volume. Historical maker tiers\n * earned before July 1, 2026 UTC are preserved; after that cutoff, only Peer\n * Pay volume moves the tier. Curator keeps the response field name\n * `peerPayVolume` for compatibility.\n *\n * A user's *live* tier, cap, and progression always come from the taker-tier\n * API payload (`TakerTier.perIntentCapBaseUnits`, `minVolumeForTier`,\n * `volumeToNextTier`, `peerPayVolume`). Those values are DB-backed and\n * server-authoritative — they vary per environment (e.g. preprod runs\n * different thresholds than these). This static schedule is ONLY a\n * documented-default reference for displays that must show every tier at once\n * (the Fees & Tiers ladder) when no live payload is available; never gate or\n * compute a user's real cap from it.\n *\n * Volume bands track the live tuned qualification thresholds — PEER $1k,\n * PLUS $10k, PRO $50k, PLATINUM $100k. Caps ($100/$250/$1k/$2.5k/$5k) are unchanged.\n * Read the live per-user values from the API: curator can change qualification\n * inputs behind the compatibility fields without changing this reference table.\n *\n * Ordered highest tier → lowest (PLATINUM first) to match UI display order.\n */\nexport interface TakerTierScheduleEntry {\n  tier: TakerTierLevel;\n  /** Per-intent order cap in whole USD (base, before platform risk multipliers). */\n  perIntentCapUsd: number;\n  /** Inclusive lower bound of Peer Pay volume (USD) that qualifies for this tier. */\n  minVolumeUsd: number;\n  /** Inclusive upper bound of Peer Pay volume (USD); `Infinity` for the top tier. */\n  maxVolumeUsd: number;\n}\n\nexport const TAKER_TIER_SCHEDULE: readonly TakerTierScheduleEntry[] = [\n  { tier: 'PLATINUM', perIntentCapUsd: 5000, minVolumeUsd: 100000, maxVolumeUsd: Infinity },\n  { tier: 'PRO', perIntentCapUsd: 2500, minVolumeUsd: 50000, maxVolumeUsd: 99999 },\n  { tier: 'PLUS', perIntentCapUsd: 1000, minVolumeUsd: 10000, maxVolumeUsd: 49999 },\n  { tier: 'PEER', perIntentCapUsd: 250, minVolumeUsd: 1000, maxVolumeUsd: 9999 },\n  { tier: 'PEASANT', perIntentCapUsd: 100, minVolumeUsd: 0, maxVolumeUsd: 999 },\n];\n\n/** Volume-based tier order, lowest → highest, for next-tier progression. */\nexport const TAKER_TIER_ORDER: readonly TakerTierLevel[] = [\n  'PEASANT',\n  'PEER',\n  'PLUS',\n  'PRO',\n  'PLATINUM',\n];\n\n/** Per-intent caps (whole USD) keyed by tier, derived from the schedule. */\nexport const TAKER_TIER_CAPS: Readonly<Record<string, number>> = Object.fromEntries(\n  TAKER_TIER_SCHEDULE.map((entry) => [entry.tier, entry.perIntentCapUsd]),\n);\n\n/**\n * Default take-fee discount (in basis points) applied per tier, mirroring\n * curator `TIER_FEE_DISCOUNT_BPS`. The discount is subtracted from the base\n * service fee server-side at quote and sign time — it is NOT returned by the\n * tier endpoint. These are documented defaults for reference fee displays only;\n * the curator DB control-plane can override them, so prefer the fee shown on a\n * live quote when one is available.\n */\nexport const TAKER_TIER_FEE_DISCOUNT_BPS: Readonly<Record<TakerTierLevel, number>> = {\n  PEASANT: 0,\n  PEER: 5,\n  PLUS: 10,\n  PRO: 20,\n  PLATINUM: 30,\n};\n\n/** The default fee-discount (bps) for a tier, or 0 for unknown tiers. */\nexport function getTakerTierFeeDiscountBps(tier: string | undefined): number {\n  if (!tier) return 0;\n  return TAKER_TIER_FEE_DISCOUNT_BPS[tier as TakerTierLevel] ?? 0;\n}\n\n/** The next tier up from `currentTier`, or `null` at the top / for unknown tiers. */\nexport function getNextTakerTier(currentTier: string | undefined): TakerTierLevel | null {\n  if (!currentTier) return null;\n  const index = TAKER_TIER_ORDER.indexOf(currentTier as TakerTierLevel);\n  if (index === -1 || index >= TAKER_TIER_ORDER.length - 1) return null;\n  return TAKER_TIER_ORDER[index + 1];\n}\n","import type { Address, Hex } from 'viem';\nimport type { PreparedTransaction } from '../../types/prepared';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000' as const;\nexport const ZERO_RATE_MANAGER_ID =\n  '0x0000000000000000000000000000000000000000000000000000000000000000' as const;\n\n// ---------------------------------------------------------------------------\n// Normalizers\n// ---------------------------------------------------------------------------\n\nexport const normalizeRateManagerId = (value?: string | null): string =>\n  (value ?? ZERO_RATE_MANAGER_ID).toLowerCase();\n\nexport const normalizeRegistry = (value?: string | null): string =>\n  (value ?? ZERO_ADDRESS).toLowerCase();\n\nexport const isZeroRateManagerId = (value?: string | null): boolean => {\n  if (!value) return true;\n  const normalized = value.toLowerCase();\n  return normalized === ZERO_ADDRESS || normalized === ZERO_RATE_MANAGER_ID;\n};\n\n// ---------------------------------------------------------------------------\n// Error helper\n// ---------------------------------------------------------------------------\n\nexport const asErrorMessage = (error: unknown): string => {\n  if (!error) return 'Unknown error';\n  if (error instanceof Error) return error.message;\n  if (typeof error === 'string') return error;\n\n  const anyErr = error as Record<string, unknown>;\n  if (typeof anyErr.shortMessage === 'string') return anyErr.shortMessage;\n  if (typeof anyErr.details === 'string') return anyErr.details;\n  if (typeof anyErr.message === 'string') return anyErr.message;\n\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Delegation state classification\n// ---------------------------------------------------------------------------\n\nexport type DelegationState = 'delegated_here' | 'delegated_elsewhere' | 'not_delegated';\n\n/**\n * Classify whether a deposit is delegated to the target vault, delegated\n * elsewhere, or not delegated at all.\n *\n * @param currentRateManagerId    The deposit's current rateManagerId (from indexer)\n * @param currentRegistry         The deposit's current rateManagerAddress / registry (from indexer)\n * @param targetRateManagerId     The vault's rateManagerId we're comparing against\n * @param targetRegistry          The vault's registry address we're comparing against\n */\nexport const classifyDelegationState = (\n  currentRateManagerId: string | null | undefined,\n  currentRegistry: string | null | undefined,\n  targetRateManagerId: string,\n  targetRegistry: string | null | undefined,\n): DelegationState => {\n  if (isZeroRateManagerId(currentRateManagerId)) {\n    return 'not_delegated';\n  }\n\n  const normalizedCurrent = normalizeRateManagerId(currentRateManagerId);\n  const normalizedTarget = targetRateManagerId.toLowerCase();\n  const normalizedCurrentRegistry = normalizeRegistry(currentRegistry);\n  const normalizedTargetRegistry = targetRegistry ? targetRegistry.toLowerCase() : '';\n\n  const idsMatch = normalizedCurrent === normalizedTarget;\n  const registryMatches = normalizedTargetRegistry\n    ? normalizedCurrentRegistry === normalizedTargetRegistry\n    : true;\n\n  if (idsMatch && registryMatches) {\n    return 'delegated_here';\n  }\n\n  return 'delegated_elsewhere';\n};\n\nexport const assertAtomicDelegationSwitchSupport = (\n  requiresSwitch: boolean,\n  canBatch: boolean,\n): void => {\n  if (!requiresSwitch || canBatch) return;\n  throw new Error(\n    'Switching delegation targets requires smart-account batching. Clear the existing delegation first.',\n  );\n};\n\n// ---------------------------------------------------------------------------\n// Contract routing\n// ---------------------------------------------------------------------------\n\nexport type DelegationRoute = 'v2';\n\nexport const getDelegationRoute = (_client: unknown, _escrow: Address): DelegationRoute => 'v2';\n\ntype DelegationMethodSupportClient = Partial<\n  Record<'setRateManager' | 'clearRateManager', { prepare?: unknown }>\n>;\n\nexport const assertDelegationMethodSupport = (\n  client: DelegationMethodSupportClient,\n  _route: DelegationRoute,\n  action: 'set' | 'clear',\n): void => {\n  const method = action === 'set' ? 'setRateManager' : 'clearRateManager';\n  if (client?.[method]?.prepare) return;\n  throw new Error(`Delegation requires SDK ${method} support`);\n};\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface DelegationDepositTarget {\n  compositeDepositId: string;\n  escrow: Address;\n  depositId: bigint;\n  currentRateManagerId?: string | null;\n  currentRateManagerRegistry?: string | null;\n}\n\nexport interface BatchResult {\n  hashes: string[];\n  failed: Array<{ compositeDepositId: string; error: string }>;\n}\n\n/**\n * Callback the consumer provides for sending a single prepared transaction.\n * Returns the transaction hash.\n */\nexport type SendTransactionFn = (tx: { to: Address; data: Hex; value?: bigint }) => Promise<string>;\n\n/**\n * Optional callback for batching multiple calls in a single user operation\n * (e.g. via a smart account). If not provided, transactions are sent\n * sequentially via sendTransaction.\n */\nexport type SendBatchFn = (\n  txs: Array<{ to: Address; data: Hex; value?: bigint }>,\n) => Promise<string>;\n\n// ---------------------------------------------------------------------------\n// Prepare helpers (used internally by hooks)\n// ---------------------------------------------------------------------------\n\nexport const prepareClearDelegationTx = async (\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client: any,\n  params: { escrow: Address; depositId: bigint },\n  referrer?: string | string[],\n): Promise<PreparedTransaction> => {\n  const route = getDelegationRoute(client, params.escrow);\n  assertDelegationMethodSupport(client, route, 'clear');\n  return client.clearRateManager.prepare({\n    escrowAddress: params.escrow,\n    depositId: params.depositId,\n    ...(referrer ? { txOverrides: { referrer } } : {}),\n  });\n};\n\nexport const prepareSetDelegationTx = async (\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client: any,\n  params: {\n    escrow: Address;\n    depositId: bigint;\n    registry: Address;\n    rateManagerId: Hex;\n  },\n  referrer?: string | string[],\n): Promise<PreparedTransaction> => {\n  const route = getDelegationRoute(client, params.escrow);\n  assertDelegationMethodSupport(client, route, 'set');\n  return client.setRateManager.prepare({\n    escrowAddress: params.escrow,\n    depositId: params.depositId,\n    rateManagerAddress: params.registry,\n    rateManagerId: params.rateManagerId,\n    ...(referrer ? { txOverrides: { referrer } } : {}),\n  });\n};\n"]}

package/dist/{chunk-NMIFJSZ3.mjs → chunk-ZM4ZP5GQ.mjs}

@@ -41021,5 +41021,5 @@ function enrichPvIntentView(view, chainId, env = "production") {
 }
 
 export { asciiToBytes32, enrichPvDepositView, enrichPvIntentView, ensureBytes32, getContracts, getGatingServiceAddress, getPaymentMethodsCatalog, getRateManagerContracts, parseBigIntLike, parseDepositView, parseIntentView, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash };
-//# sourceMappingURL=chunk-NMIFJSZ3.mjs.map
-//# sourceMappingURL=chunk-NMIFJSZ3.mjs.map
+//# sourceMappingURL=chunk-ZM4ZP5GQ.mjs.map
+//# sourceMappingURL=chunk-ZM4ZP5GQ.mjs.map