@zkp2p/sdk 0.7.1 → 0.7.2

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
@@ -272,13 +273,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 +299,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-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