@zkp2p/cash 0.6.0-rc.1 → 0.6.1

package/AGENTS.md

@@ -342,3 +342,26 @@ Alipay/CNY retains the Ethereum registry and `creationRateRpcUrl` /
 `creationRateTransport`. UPI rejects the wrong chain, invalid rounds, and
 observations older than 24 hours; market closures do not bypass freshness.
 UPI is available in production, preproduction, and staging without a feature flag.
+
+## Optional Venmo receipt linking
+
+Offer this separately; `cashout()` and `prepare()` never require or invoke it.
+Run `cash.prepareVenmoGmailConnect(handle)` when the user selects Venmo, then
+call `cash.openVenmoGmailConnect(link.payeeDetails)` directly from a separate
+button click. Re-prepare when the selected handle changes. Use
+`cash.isVenmoGmailConnected(link.payeeDetails)` after returning from a mobile
+tab or an ambiguous closure; service errors reject, and only an active Google
+credential counts as connected. Persist the hash with its environment and user.
+
+The hosted flow accepts Google-hosted school/custom domains and verifies actual
+Venmo receipts. `VenmoGmailConnectError` retains codes such as
+`venmo_google_oauth_receipt_not_found`, `popup_blocked`, `connection_closed`,
+and `connection_timeout`; it is separate from `CashError`. No emails or Google
+tokens reach the partner. `link.url` supports redirect/native hosts, which
+must check status on return. See the README and `examples/venmo-link.ts`.
+
+Configure optional `venmoGmail: { appearance, popup }` on `createCashClient()`
+to share partner branding between the prepared URL and popup. Omit it for Peer
+branding; omit `appearance.logoUrl` to keep the Peer logo beside Venmo. Popup
+width/height apply to desktop; mobile browsers control tab sizing. See the
+README's "Customize the hosted popup" section for the configuration example.

package/README.md

@@ -144,6 +144,9 @@ arbitrary protocol operations.
 
 | Verb                                                           | What it does                                                                                                                    |
 | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `prepareVenmoGmailConnect(payee)`                              | Optional Venmo handle registration; returns the payee hash and hosted URL                                                       |
+| `openVenmoGmailConnect(payeeDetails)`                          | Optional browser popup/tab; call directly from a click                                                                          |
+| `isVenmoGmailConnected(payeeDetails)`                          | Read whether an active Google receipt credential exists                                                                         |
 | `capabilities()`                                               | Sync discovery: Base USDC destination/default source, platforms × currencies × payee hints × amount bounds                      |
 | `capabilities({ includeRelaySources: true })`                  | Async discovery: adds live Relay SDK EVM source chains/tokens                                                                   |
 | `capabilities({ includeNearIntentsSources: true })`            | Async discovery: adds live NEAR Intents 1Click source assets                                                                    |
@@ -182,6 +185,97 @@ indexed deposit is unsupported, `orders()` excludes the whole deposit and
 `order()` returns `ORDER_NOT_FOUND`; Peer Cash never partially reclassifies a
 mixed historical deposit.
 
+## Optional Venmo receipt linking
+
+Partners such as Tailgate can offer **Link Venmo** separately from cash-out.
+`cashout()` and `prepare()` never open Gmail, check receipt credentials, or
+require this step. Skipping or cancelling linking leaves cash-out available.
+
+```ts
+import { createCashClient, VenmoGmailConnectError } from '@zkp2p/cash';
+
+const cash = createCashClient({ environment: 'production' });
+// Run when the user selects their Venmo account, before enabling Link Venmo.
+const link = await cash.prepareVenmoGmailConnect('@yourhandle');
+
+// Call directly from the button click, with no async work before this call.
+linkButton.onclick = () => {
+  cash.openVenmoGmailConnect(link.payeeDetails).catch((error: unknown) => {
+    if (error instanceof VenmoGmailConnectError) {
+      console.log(error.code, error.message);
+    }
+  });
+};
+
+// After completion, returning from a tab, or an ambiguous popup closure:
+const connected = await cash.isVenmoGmailConnected(link.payeeDetails);
+```
+
+The handle is registered with the environment's Curator and its authoritative
+payee hash goes to the hosted link. Re-prepare if the selected handle changes.
+Persist the hash with the environment and user account for later status checks.
+`link.url` also works as a normal link for redirect or native-browser hosts;
+those hosts must check status after the user returns.
+
+Production uses `app.peer.xyz`, preproduction `ramp-preprod.peer.xyz`, and
+staging `ramp-staging.peer.xyz`. `peerOrigin` and `curatorUrl` allow explicit
+overrides. Browser helpers require no React, extension, wallet, or signer.
+Preparation and status reads also work on the server.
+
+Desktop opens a popup; mobile requests a new browser tab (including Safari).
+The browser controls presentation and may sever the opener connection. In that
+case check status rather than assuming `connection_closed` or
+`connection_timeout` means verification failed. Status is true only for an
+active `google_oauth` credential; lookup failures reject.
+
+Gmail and Google-hosted school/custom-domain inboxes are accepted. The hosted
+flow verifies actual receipts; there is no email-domain precheck. A missing
+receipt reports `venmo_google_oauth_receipt_not_found` through
+`VenmoGmailConnectError.code`. Cancellation, popup blocking, and other hosted
+errors retain their codes. This error class is separate from `CashError`;
+registration and status service errors also reject. Emails and Google tokens
+never pass through the partner app or Cash SDK.
+
+See [the browser example](examples/venmo-link.ts). JSON codecs are exported for
+`PreparedVenmoGmailConnect` and `VenmoGmailConnectResult`.
+
+### Customize the hosted popup
+
+With `@zkp2p/cash@0.6.1`, configure branding once on the client. The same
+appearance is used by `link.url` and `openVenmoGmailConnect()`.
+
+```ts
+const cash = createCashClient({
+  environment: 'production',
+  venmoGmail: {
+    appearance: {
+      logoUrl: 'https://your-app.example/logo.png',
+      logoAlt: 'Your app',
+      backgroundColor: '#FFFFFF',
+      textColor: '#172033',
+      secondaryTextColor: '#636B7A',
+      buttonColor: '#6246EA',
+      buttonTextColor: '#FFFFFF',
+      fontFamily: 'Inter, sans-serif',
+      headingTextTransform: 'none',
+      buttonTextTransform: 'none',
+      buttonBorderRadius: 12,
+      buttonHeight: 52,
+    },
+    popup: { width: 500, height: 620 },
+  },
+});
+```
+
+Your hosted logo appears beside Venmo with three connecting dots. Without a
+partner logo, the page shows Peer beside Venmo. Colors use
+hex values and dimensions use pixels. Optional `fontUrl` accepts a hosted
+WOFF/WOFF2 font with cross-origin loading enabled. Popup dimensions apply to
+desktop; mobile browsers control the new tab's size. Styling never changes
+consent, account selection, or receipt verification.
+
+See the [full appearance options](https://www.npmjs.com/package/@zkp2p/sdk#popup-customization).
+
 ## Payout rails and access policies
 
 | Payout rail           | Access-policy behavior                                                     | New payee registration                                                                 |

package/dist/{createCashClient-94tPE0dH.d.cts → createCashClient-LTZshulP.d.cts}

@@ -1,5 +1,5 @@
-import { Address, WalletClient, Hash, Hex, Log, Transport } from 'viem';
-import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
+import { Address, Hash, WalletClient, Hex, Log, Transport } from 'viem';
+import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectResult, VenmoGmailAppearance, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { Execute, RelayClient, RelayChain, ProgressData } from '@relayprotocol/relay-sdk';
 
 /**
@@ -665,6 +665,10 @@ declare const CASH_ATTRIBUTION_CODE = "peer-cash";
 declare const CASH_REFERRAL_ATTRIBUTION_PREFIX = "peer-ref-";
 /** Convert a Peer referral code into its financially meaningful ERC-8021 marker. */
 declare function toCashReferralAttributionCode(rawCode: string): string;
+interface PreparedVenmoGmailConnect {
+    payeeDetails: Hash;
+    url: string;
+}
 interface CashClientOptions {
     /** `'production' | 'preproduction' | 'staging'` - selects contracts, curator, and indexer. */
     environment: RuntimeEnv;
@@ -678,6 +682,13 @@ interface CashClientOptions {
     indexerApiKey?: string;
     /** Curator (ZKP2P API) URL override. */
     curatorUrl?: string;
+    /** Peer web origin override for optional Venmo receipt linking. Defaults by environment. */
+    peerOrigin?: string;
+    /** Optional branding shared by prepared URLs and browser linking. Never affects cash-out. */
+    venmoGmail?: {
+        appearance?: VenmoGmailAppearance;
+        popup?: VenmoGmailPopupOptions;
+    };
     /** Optional ZKP2P API key. */
     apiKey?: string;
     /** Ethereum transport used only to snapshot Alipay/CNY's creation-time rate. */
@@ -850,6 +861,12 @@ interface OrdersOptions {
     limit?: number;
 }
 interface CashClient {
+    /** Optional: register the Venmo handle before enabling a separate link button. No deposit. */
+    prepareVenmoGmailConnect(payee: string): Promise<PreparedVenmoGmailConnect>;
+    /** Optional, browser-only: call directly from a click handler with the prepared payee hash. */
+    openVenmoGmailConnect(payeeDetails: Hash): Promise<VenmoGmailConnectResult>;
+    /** True only for an active Google receipt credential; errors reject instead of reporting unlinked. */
+    isVenmoGmailConnected(payeeDetails: Hash): Promise<boolean>;
     /** 0 - Discovery: sync, static. */
     capabilities(): CashCapabilities;
     /** 0b - Discovery with live Relay-supported EVM source chains/tokens. */
@@ -941,4 +958,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { type EstimateOptions as $, type CashClient as A, BASE_CHAIN_ID as B, type CashPayoutInfo as C, type CashClientOptions as D, type CashCorridorPricing as E, type CashFillEta as F, type CashLeg as G, type CashMultiCurrencyLeg as H, type IntentEntity as I, type CashNextAction as J, type CashOrderState as K, type CashPairFillStats as L, type CashPayeeInput as M, type NearIntentsSourceCapabilities as N, type CashPayout as O, type PrepareResult as P, type CashPayoutPricing as Q, type RelayExecutionResult as R, type CashPlatformCapability as S, type TopUpResult as T, type CashPreparedStepKind as U, type CashReceiveLeg as V, type WithdrawResult as W, type CashoutInput as X, type CashoutOptions as Y, type CuratorPayeeDataInput as Z, type EstimateInput as _, type CashBuyerProfile as a, MARKET_SPREAD_BPS as a0, MIN_CASHOUT_AMOUNT as a1, NEAR_INTENTS_API_URL as a2, NEAR_INTENTS_BASE_USDC_ASSET_ID as a3, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS as a4, NEAR_INTENTS_STATUSES as a5, type NearIntentsClient as a6, type NearIntentsOptions as a7, type NearIntentsQuoteRequest as a8, type NearIntentsStatusCode as a9, type NearIntentsToken as aa, type NearIntentsTradeType as ab, type NearIntentsTransaction as ac, ORACLE_MIN_CONVERSION_RATE_SENTINEL as ad, type OrdersOptions as ae, type PreparedCashoutReceipt as af, RECOMMENDED_MIN_CASHOUT_AMOUNT as ag, type RelayOptions as ah, type RelayQuoteInput as ai, type RelaySourceInput as aj, type RelayTransaction as ak, type SignerOptions as al, USDC_DECIMALS as am, type WatchOptions as an, type WithdrawOptions as ao, buildCapabilities as ap, createCashClient as aq, createNearIntentsClient as ar, normalizeCashPayee as as, quoteNearIntentsToBaseUsdc as at, readNearIntentsSourceCapabilities as au, readNearIntentsStatus as av, submitNearIntentsDeposit as aw, toCashReferralAttributionCode as ax, type CashDepositInput as b, type CreateDepositParamsArg as c, type CashOrder as d, type CashFill as e, type CashCapabilities as f, type CashoutResult as g, type CashEstimate as h, type CashFillStats as i, type NearIntentsDepositInput as j, type NearIntentsQuote as k, type NearIntentsQuoteInput as l, type NearIntentsStatus as m, type NearIntentsStatusInput as n, type CashPreparedStep as o, type RelayQuote as p, type RelayStatus as q, type CashSourceCapabilities as r, BASE_USDC_ADDRESS as s, CASH_ATTRIBUTION_CODE as t, CASH_ORDER_POLL_INTERVAL_MS as u, CASH_ORDER_STATUSES as v, CASH_REFERRAL_ATTRIBUTION_PREFIX as w, CASH_RETAIN_ON_EMPTY as x, type CashAsset as y, type CashChain as z };
+export { type EstimateInput as $, type CashChain as A, BASE_CHAIN_ID as B, type CashPayoutInfo as C, type CashClient as D, type CashClientOptions as E, type CashCorridorPricing as F, type CashFillEta as G, type CashLeg as H, type IntentEntity as I, type CashMultiCurrencyLeg as J, type CashNextAction as K, type CashOrderState as L, type CashPairFillStats as M, type NearIntentsSourceCapabilities as N, type CashPayeeInput as O, type PrepareResult as P, type CashPayout as Q, type RelayExecutionResult as R, type CashPayoutPricing as S, type TopUpResult as T, type CashPlatformCapability as U, type CashPreparedStepKind as V, type WithdrawResult as W, type CashReceiveLeg as X, type CashoutInput as Y, type CashoutOptions as Z, type CuratorPayeeDataInput as _, type CashBuyerProfile as a, type EstimateOptions as a0, MARKET_SPREAD_BPS as a1, MIN_CASHOUT_AMOUNT as a2, NEAR_INTENTS_API_URL as a3, NEAR_INTENTS_BASE_USDC_ASSET_ID as a4, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS as a5, NEAR_INTENTS_STATUSES as a6, type NearIntentsClient as a7, type NearIntentsOptions as a8, type NearIntentsQuoteRequest as a9, type NearIntentsStatusCode as aa, type NearIntentsToken as ab, type NearIntentsTradeType as ac, type NearIntentsTransaction as ad, ORACLE_MIN_CONVERSION_RATE_SENTINEL as ae, type OrdersOptions as af, type PreparedCashoutReceipt as ag, RECOMMENDED_MIN_CASHOUT_AMOUNT as ah, type RelayOptions as ai, type RelayQuoteInput as aj, type RelaySourceInput as ak, type RelayTransaction as al, type SignerOptions as am, USDC_DECIMALS as an, type WatchOptions as ao, type WithdrawOptions as ap, buildCapabilities as aq, createCashClient as ar, createNearIntentsClient as as, normalizeCashPayee as at, quoteNearIntentsToBaseUsdc as au, readNearIntentsSourceCapabilities as av, readNearIntentsStatus as aw, submitNearIntentsDeposit as ax, toCashReferralAttributionCode as ay, type CashDepositInput as b, type CreateDepositParamsArg as c, type CashOrder as d, type CashFill as e, type CashCapabilities as f, type CashoutResult as g, type CashEstimate as h, type CashFillStats as i, type NearIntentsDepositInput as j, type NearIntentsQuote as k, type NearIntentsQuoteInput as l, type NearIntentsStatus as m, type NearIntentsStatusInput as n, type CashPreparedStep as o, type PreparedVenmoGmailConnect as p, type RelayQuote as q, type RelayStatus as r, type CashSourceCapabilities as s, BASE_USDC_ADDRESS as t, CASH_ATTRIBUTION_CODE as u, CASH_ORDER_POLL_INTERVAL_MS as v, CASH_ORDER_STATUSES as w, CASH_REFERRAL_ATTRIBUTION_PREFIX as x, CASH_RETAIN_ON_EMPTY as y, type CashAsset as z };

package/dist/{createCashClient-94tPE0dH.d.ts → createCashClient-LTZshulP.d.ts}

@@ -1,5 +1,5 @@
-import { Address, WalletClient, Hash, Hex, Log, Transport } from 'viem';
-import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
+import { Address, Hash, WalletClient, Hex, Log, Transport } from 'viem';
+import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectResult, VenmoGmailAppearance, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { Execute, RelayClient, RelayChain, ProgressData } from '@relayprotocol/relay-sdk';
 
 /**
@@ -665,6 +665,10 @@ declare const CASH_ATTRIBUTION_CODE = "peer-cash";
 declare const CASH_REFERRAL_ATTRIBUTION_PREFIX = "peer-ref-";
 /** Convert a Peer referral code into its financially meaningful ERC-8021 marker. */
 declare function toCashReferralAttributionCode(rawCode: string): string;
+interface PreparedVenmoGmailConnect {
+    payeeDetails: Hash;
+    url: string;
+}
 interface CashClientOptions {
     /** `'production' | 'preproduction' | 'staging'` - selects contracts, curator, and indexer. */
     environment: RuntimeEnv;
@@ -678,6 +682,13 @@ interface CashClientOptions {
     indexerApiKey?: string;
     /** Curator (ZKP2P API) URL override. */
     curatorUrl?: string;
+    /** Peer web origin override for optional Venmo receipt linking. Defaults by environment. */
+    peerOrigin?: string;
+    /** Optional branding shared by prepared URLs and browser linking. Never affects cash-out. */
+    venmoGmail?: {
+        appearance?: VenmoGmailAppearance;
+        popup?: VenmoGmailPopupOptions;
+    };
     /** Optional ZKP2P API key. */
     apiKey?: string;
     /** Ethereum transport used only to snapshot Alipay/CNY's creation-time rate. */
@@ -850,6 +861,12 @@ interface OrdersOptions {
     limit?: number;
 }
 interface CashClient {
+    /** Optional: register the Venmo handle before enabling a separate link button. No deposit. */
+    prepareVenmoGmailConnect(payee: string): Promise<PreparedVenmoGmailConnect>;
+    /** Optional, browser-only: call directly from a click handler with the prepared payee hash. */
+    openVenmoGmailConnect(payeeDetails: Hash): Promise<VenmoGmailConnectResult>;
+    /** True only for an active Google receipt credential; errors reject instead of reporting unlinked. */
+    isVenmoGmailConnected(payeeDetails: Hash): Promise<boolean>;
     /** 0 - Discovery: sync, static. */
     capabilities(): CashCapabilities;
     /** 0b - Discovery with live Relay-supported EVM source chains/tokens. */
@@ -941,4 +958,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { type EstimateOptions as $, type CashClient as A, BASE_CHAIN_ID as B, type CashPayoutInfo as C, type CashClientOptions as D, type CashCorridorPricing as E, type CashFillEta as F, type CashLeg as G, type CashMultiCurrencyLeg as H, type IntentEntity as I, type CashNextAction as J, type CashOrderState as K, type CashPairFillStats as L, type CashPayeeInput as M, type NearIntentsSourceCapabilities as N, type CashPayout as O, type PrepareResult as P, type CashPayoutPricing as Q, type RelayExecutionResult as R, type CashPlatformCapability as S, type TopUpResult as T, type CashPreparedStepKind as U, type CashReceiveLeg as V, type WithdrawResult as W, type CashoutInput as X, type CashoutOptions as Y, type CuratorPayeeDataInput as Z, type EstimateInput as _, type CashBuyerProfile as a, MARKET_SPREAD_BPS as a0, MIN_CASHOUT_AMOUNT as a1, NEAR_INTENTS_API_URL as a2, NEAR_INTENTS_BASE_USDC_ASSET_ID as a3, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS as a4, NEAR_INTENTS_STATUSES as a5, type NearIntentsClient as a6, type NearIntentsOptions as a7, type NearIntentsQuoteRequest as a8, type NearIntentsStatusCode as a9, type NearIntentsToken as aa, type NearIntentsTradeType as ab, type NearIntentsTransaction as ac, ORACLE_MIN_CONVERSION_RATE_SENTINEL as ad, type OrdersOptions as ae, type PreparedCashoutReceipt as af, RECOMMENDED_MIN_CASHOUT_AMOUNT as ag, type RelayOptions as ah, type RelayQuoteInput as ai, type RelaySourceInput as aj, type RelayTransaction as ak, type SignerOptions as al, USDC_DECIMALS as am, type WatchOptions as an, type WithdrawOptions as ao, buildCapabilities as ap, createCashClient as aq, createNearIntentsClient as ar, normalizeCashPayee as as, quoteNearIntentsToBaseUsdc as at, readNearIntentsSourceCapabilities as au, readNearIntentsStatus as av, submitNearIntentsDeposit as aw, toCashReferralAttributionCode as ax, type CashDepositInput as b, type CreateDepositParamsArg as c, type CashOrder as d, type CashFill as e, type CashCapabilities as f, type CashoutResult as g, type CashEstimate as h, type CashFillStats as i, type NearIntentsDepositInput as j, type NearIntentsQuote as k, type NearIntentsQuoteInput as l, type NearIntentsStatus as m, type NearIntentsStatusInput as n, type CashPreparedStep as o, type RelayQuote as p, type RelayStatus as q, type CashSourceCapabilities as r, BASE_USDC_ADDRESS as s, CASH_ATTRIBUTION_CODE as t, CASH_ORDER_POLL_INTERVAL_MS as u, CASH_ORDER_STATUSES as v, CASH_REFERRAL_ATTRIBUTION_PREFIX as w, CASH_RETAIN_ON_EMPTY as x, type CashAsset as y, type CashChain as z };
+export { type EstimateInput as $, type CashChain as A, BASE_CHAIN_ID as B, type CashPayoutInfo as C, type CashClient as D, type CashClientOptions as E, type CashCorridorPricing as F, type CashFillEta as G, type CashLeg as H, type IntentEntity as I, type CashMultiCurrencyLeg as J, type CashNextAction as K, type CashOrderState as L, type CashPairFillStats as M, type NearIntentsSourceCapabilities as N, type CashPayeeInput as O, type PrepareResult as P, type CashPayout as Q, type RelayExecutionResult as R, type CashPayoutPricing as S, type TopUpResult as T, type CashPlatformCapability as U, type CashPreparedStepKind as V, type WithdrawResult as W, type CashReceiveLeg as X, type CashoutInput as Y, type CashoutOptions as Z, type CuratorPayeeDataInput as _, type CashBuyerProfile as a, type EstimateOptions as a0, MARKET_SPREAD_BPS as a1, MIN_CASHOUT_AMOUNT as a2, NEAR_INTENTS_API_URL as a3, NEAR_INTENTS_BASE_USDC_ASSET_ID as a4, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS as a5, NEAR_INTENTS_STATUSES as a6, type NearIntentsClient as a7, type NearIntentsOptions as a8, type NearIntentsQuoteRequest as a9, type NearIntentsStatusCode as aa, type NearIntentsToken as ab, type NearIntentsTradeType as ac, type NearIntentsTransaction as ad, ORACLE_MIN_CONVERSION_RATE_SENTINEL as ae, type OrdersOptions as af, type PreparedCashoutReceipt as ag, RECOMMENDED_MIN_CASHOUT_AMOUNT as ah, type RelayOptions as ai, type RelayQuoteInput as aj, type RelaySourceInput as ak, type RelayTransaction as al, type SignerOptions as am, USDC_DECIMALS as an, type WatchOptions as ao, type WithdrawOptions as ap, buildCapabilities as aq, createCashClient as ar, createNearIntentsClient as as, normalizeCashPayee as at, quoteNearIntentsToBaseUsdc as au, readNearIntentsSourceCapabilities as av, readNearIntentsStatus as aw, submitNearIntentsDeposit as ax, toCashReferralAttributionCode as ay, type CashDepositInput as b, type CreateDepositParamsArg as c, type CashOrder as d, type CashFill as e, type CashCapabilities as f, type CashoutResult as g, type CashEstimate as h, type CashFillStats as i, type NearIntentsDepositInput as j, type NearIntentsQuote as k, type NearIntentsQuoteInput as l, type NearIntentsStatus as m, type NearIntentsStatusInput as n, type CashPreparedStep as o, type PreparedVenmoGmailConnect as p, type RelayQuote as q, type RelayStatus as r, type CashSourceCapabilities as s, BASE_USDC_ADDRESS as t, CASH_ATTRIBUTION_CODE as u, CASH_ORDER_POLL_INTERVAL_MS as v, CASH_ORDER_STATUSES as w, CASH_REFERRAL_ATTRIBUTION_PREFIX as x, CASH_RETAIN_ON_EMPTY as y, type CashAsset as z };

package/dist/index.cjs

@@ -2466,6 +2466,12 @@ var cashErrorJsonSchema = zod.z.object({
   remediation: zod.z.string(),
   recovery: cashErrorRecoveryJsonSchema.optional()
 }).strict();
+var venmoGmailConnectResultJsonSchema = zod.z.object({
+  payeeDetails: zod.z.string().regex(/^0x[0-9a-f]{64}$/i)
+});
+var preparedVenmoGmailConnectJsonSchema = venmoGmailConnectResultJsonSchema.extend({
+  url: zod.z.url()
+});
 
 // src/client/nearIntents.ts
 var NEAR_INTENTS_API_URL = "https://1click.chaindefuser.com";
@@ -2856,6 +2862,11 @@ var DEFAULT_CURATOR_URLS = {
   preproduction: "https://api-preprod.zkp2p.xyz",
   staging: "https://api-staging.zkp2p.xyz"
 };
+var DEFAULT_PEER_ORIGINS = {
+  production: "https://app.peer.xyz",
+  preproduction: "https://ramp-preprod.peer.xyz",
+  staging: "https://ramp-staging.peer.xyz"
+};
 var ERC20_APPROVE_ABI = viem.parseAbi([
   "function approve(address spender, uint256 amount) returns (bool)"
 ]);
@@ -3418,6 +3429,33 @@ function createCashClient(options) {
     return hashes;
   }
   return {
+    async prepareVenmoGmailConnect(payee) {
+      const { hashedOnchainIds } = await readClient.registerPayeeDetails({
+        processorNames: ["venmo"],
+        payeeData: [normalizeCashPayee("venmo", payee)]
+      });
+      const payeeDetails = hashedOnchainIds[0];
+      const url = sdk.getVenmoGmailConnectUrl({
+        ...options.venmoGmail,
+        payeeDetails,
+        peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
+      });
+      return { payeeDetails, url };
+    },
+    openVenmoGmailConnect(payeeDetails) {
+      return sdk.openVenmoGmailConnect({
+        ...options.venmoGmail,
+        payeeDetails,
+        peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
+      });
+    },
+    async isVenmoGmailConnected(payeeDetails) {
+      const { responseObject } = await readClient.getSellerCredentialStatus({
+        processorName: "venmo",
+        payeeDetails
+      });
+      return responseObject.status === "active" && responseObject.credentialType === "google_oauth";
+    },
     capabilities,
     async sourceCapabilities() {
       return readRelaySourceCapabilities(options.relay);
@@ -4501,7 +4539,28 @@ function cashErrorFromJson(json) {
     ...recovery ? { recovery } : {}
   });
 }
+function preparedVenmoGmailConnectToJson(value) {
+  return preparedVenmoGmailConnectJsonSchema.parse(value);
+}
+function preparedVenmoGmailConnectFromJson(json) {
+  const parsed = preparedVenmoGmailConnectJsonSchema.parse(json);
+  return {
+    ...parsed,
+    payeeDetails: parsed.payeeDetails
+  };
+}
+function venmoGmailConnectResultToJson(value) {
+  return venmoGmailConnectResultJsonSchema.parse(value);
+}
+function venmoGmailConnectResultFromJson(json) {
+  const parsed = venmoGmailConnectResultJsonSchema.parse(json);
+  return { payeeDetails: parsed.payeeDetails };
+}
 
+Object.defineProperty(exports, "VenmoGmailConnectError", {
+  enumerable: true,
+  get: function () { return sdk.VenmoGmailConnectError; }
+});
 exports.BASE_CHAIN_ID = BASE_CHAIN_ID;
 exports.BASE_USDC_ADDRESS = BASE_USDC_ADDRESS;
 exports.CASH_ATTRIBUTION_CODE = CASH_ATTRIBUTION_CODE;
@@ -4614,6 +4673,9 @@ exports.preparedStepToJson = preparedStepToJson;
 exports.preparedTransactionJsonSchema = preparedTransactionJsonSchema;
 exports.preparedTxFromJson = preparedTxFromJson;
 exports.preparedTxToJson = preparedTxToJson;
+exports.preparedVenmoGmailConnectFromJson = preparedVenmoGmailConnectFromJson;
+exports.preparedVenmoGmailConnectJsonSchema = preparedVenmoGmailConnectJsonSchema;
+exports.preparedVenmoGmailConnectToJson = preparedVenmoGmailConnectToJson;
 exports.quoteNearIntentsToBaseUsdc = quoteNearIntentsToBaseUsdc;
 exports.rateToNumber = rateToNumber;
 exports.readAlipayCnyCreationRate = readAlipayCnyCreationRate;
@@ -4639,6 +4701,9 @@ exports.topUpResultFromJson = topUpResultFromJson;
 exports.topUpResultJsonSchema = topUpResultJsonSchema;
 exports.topUpResultToJson = topUpResultToJson;
 exports.usdc = usdc;
+exports.venmoGmailConnectResultFromJson = venmoGmailConnectResultFromJson;
+exports.venmoGmailConnectResultJsonSchema = venmoGmailConnectResultJsonSchema;
+exports.venmoGmailConnectResultToJson = venmoGmailConnectResultToJson;
 exports.withExplain = withExplain;
 exports.withdrawResultFromJson = withdrawResultFromJson;
 exports.withdrawResultJsonSchema = withdrawResultJsonSchema;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, R as RelayExecutionResult, p as RelayQuote, q as RelayStatus, r as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-94tPE0dH.cjs';
-export { B as BASE_CHAIN_ID, s as BASE_USDC_ADDRESS, t as CASH_ATTRIBUTION_CODE, u as CASH_ORDER_POLL_INTERVAL_MS, v as CASH_ORDER_STATUSES, w as CASH_REFERRAL_ATTRIBUTION_PREFIX, x as CASH_RETAIN_ON_EMPTY, y as CashAsset, z as CashChain, A as CashClient, D as CashClientOptions, E as CashCorridorPricing, F as CashFillEta, G as CashLeg, H as CashMultiCurrencyLeg, J as CashNextAction, K as CashOrderState, L as CashPairFillStats, M as CashPayeeInput, O as CashPayout, Q as CashPayoutPricing, S as CashPlatformCapability, U as CashPreparedStepKind, V as CashReceiveLeg, X as CashoutInput, Y as CashoutOptions, Z as CuratorPayeeDataInput, _ as EstimateInput, $ as EstimateOptions, a0 as MARKET_SPREAD_BPS, a1 as MIN_CASHOUT_AMOUNT, a2 as NEAR_INTENTS_API_URL, a3 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a4 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a5 as NEAR_INTENTS_STATUSES, a6 as NearIntentsClient, a7 as NearIntentsOptions, a8 as NearIntentsQuoteRequest, a9 as NearIntentsStatusCode, aa as NearIntentsToken, ab as NearIntentsTradeType, ac as NearIntentsTransaction, ad as ORACLE_MIN_CONVERSION_RATE_SENTINEL, ae as OrdersOptions, af as PreparedCashoutReceipt, ag as RECOMMENDED_MIN_CASHOUT_AMOUNT, ah as RelayOptions, ai as RelayQuoteInput, aj as RelaySourceInput, ak as RelayTransaction, al as SignerOptions, am as USDC_DECIMALS, an as WatchOptions, ao as WithdrawOptions, ap as buildCapabilities, aq as createCashClient, ar as createNearIntentsClient, as as normalizeCashPayee, at as quoteNearIntentsToBaseUsdc, au as readNearIntentsSourceCapabilities, av as readNearIntentsStatus, aw as submitNearIntentsDeposit, ax as toCashReferralAttributionCode } from './createCashClient-94tPE0dH.cjs';
+import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, p as PreparedVenmoGmailConnect, R as RelayExecutionResult, q as RelayQuote, r as RelayStatus, s as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-LTZshulP.cjs';
+export { B as BASE_CHAIN_ID, t as BASE_USDC_ADDRESS, u as CASH_ATTRIBUTION_CODE, v as CASH_ORDER_POLL_INTERVAL_MS, w as CASH_ORDER_STATUSES, x as CASH_REFERRAL_ATTRIBUTION_PREFIX, y as CASH_RETAIN_ON_EMPTY, z as CashAsset, A as CashChain, D as CashClient, E as CashClientOptions, F as CashCorridorPricing, G as CashFillEta, H as CashLeg, J as CashMultiCurrencyLeg, K as CashNextAction, L as CashOrderState, M as CashPairFillStats, O as CashPayeeInput, Q as CashPayout, S as CashPayoutPricing, U as CashPlatformCapability, V as CashPreparedStepKind, X as CashReceiveLeg, Y as CashoutInput, Z as CashoutOptions, _ as CuratorPayeeDataInput, $ as EstimateInput, a0 as EstimateOptions, a1 as MARKET_SPREAD_BPS, a2 as MIN_CASHOUT_AMOUNT, a3 as NEAR_INTENTS_API_URL, a4 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a5 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a6 as NEAR_INTENTS_STATUSES, a7 as NearIntentsClient, a8 as NearIntentsOptions, a9 as NearIntentsQuoteRequest, aa as NearIntentsStatusCode, ab as NearIntentsToken, ac as NearIntentsTradeType, ad as NearIntentsTransaction, ae as ORACLE_MIN_CONVERSION_RATE_SENTINEL, af as OrdersOptions, ag as PreparedCashoutReceipt, ah as RECOMMENDED_MIN_CASHOUT_AMOUNT, ai as RelayOptions, aj as RelayQuoteInput, ak as RelaySourceInput, al as RelayTransaction, am as SignerOptions, an as USDC_DECIMALS, ao as WatchOptions, ap as WithdrawOptions, aq as buildCapabilities, ar as createCashClient, as as createNearIntentsClient, at as normalizeCashPayee, au as quoteNearIntentsToBaseUsdc, av as readNearIntentsSourceCapabilities, aw as readNearIntentsStatus, ax as submitNearIntentsDeposit, ay as toCashReferralAttributionCode } from './createCashClient-LTZshulP.cjs';
 import { PublicClient, Log, Abi } from 'viem';
-import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
-export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
+import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction, VenmoGmailConnectResult } from '@zkp2p/sdk';
+export { CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailAppearance, VenmoGmailConnectError, VenmoGmailConnectResult, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { z } from 'zod';
 import '@relayprotocol/relay-sdk';
 
@@ -1540,6 +1540,15 @@ type RelayStatusJson = z.infer<typeof relayStatusJsonSchema>;
 type RelayExecutionResultJson = z.infer<typeof relayExecutionResultJsonSchema>;
 type CashErrorRecoveryJson = z.infer<typeof cashErrorRecoveryJsonSchema>;
 type CashErrorJson = z.infer<typeof cashErrorJsonSchema>;
+declare const venmoGmailConnectResultJsonSchema: z.ZodObject<{
+    payeeDetails: z.ZodString;
+}, z.core.$strip>;
+declare const preparedVenmoGmailConnectJsonSchema: z.ZodObject<{
+    payeeDetails: z.ZodString;
+    url: z.ZodURL;
+}, z.core.$strip>;
+type VenmoGmailConnectResultJson = z.infer<typeof venmoGmailConnectResultJsonSchema>;
+type PreparedVenmoGmailConnectJson = z.infer<typeof preparedVenmoGmailConnectJsonSchema>;
 
 /**
  * JSON codecs - lossless (de)serialization for every wire type. bigints encode
@@ -1593,5 +1602,9 @@ declare function capabilitiesToJson(caps: CashCapabilities): CashCapabilitiesJso
 declare function capabilitiesFromJson(json: unknown): CashCapabilities;
 declare function cashErrorToJson(error: CashErrorShape): CashErrorJson;
 declare function cashErrorFromJson(json: unknown): CashError;
+declare function preparedVenmoGmailConnectToJson(value: PreparedVenmoGmailConnect): PreparedVenmoGmailConnectJson;
+declare function preparedVenmoGmailConnectFromJson(json: unknown): PreparedVenmoGmailConnect;
+declare function venmoGmailConnectResultToJson(value: VenmoGmailConnectResult): VenmoGmailConnectResultJson;
+declare function venmoGmailConnectResultFromJson(json: unknown): VenmoGmailConnectResult;
 
-export { CREATION_RATE_MAX_STALENESS_SECONDS, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type CreationRateReader, type CreationRateSnapshot, type DeriveCashOrderOptions, type MethodCurrencyLike, NearIntentsDepositInput, type NearIntentsDepositInputJson, NearIntentsQuote, NearIntentsQuoteInput, type NearIntentsQuoteInputJson, type NearIntentsQuoteJson, NearIntentsSourceCapabilities, type NearIntentsSourceCapabilitiesJson, NearIntentsStatus, NearIntentsStatusInput, type NearIntentsStatusInputJson, type NearIntentsStatusJson, type NearIntentsTokenJson, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashCorridorSupported, isCashError, isCreationRateCorridor, isFillLive, isMarketRateSupported, isUserRejectedError, nearIntentsCapabilitiesFromJson, nearIntentsCapabilitiesToJson, nearIntentsDepositInputFromJson, nearIntentsDepositInputJsonSchema, nearIntentsDepositInputToJson, nearIntentsQuoteFromJson, nearIntentsQuoteInputFromJson, nearIntentsQuoteInputJsonSchema, nearIntentsQuoteInputToJson, nearIntentsQuoteJsonSchema, nearIntentsQuoteRequestJsonSchema, nearIntentsQuoteResponseSchema, nearIntentsQuoteToJson, nearIntentsSourceCapabilitiesJsonSchema, nearIntentsStatusCodeSchema, nearIntentsStatusFromJson, nearIntentsStatusInputFromJson, nearIntentsStatusInputJsonSchema, nearIntentsStatusInputToJson, nearIntentsStatusJsonSchema, nearIntentsStatusResponseSchema, nearIntentsStatusToJson, nearIntentsTokenJsonSchema, nearIntentsTokensResponseSchema, nearIntentsTransactionJsonSchema, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, readAlipayCnyCreationRate, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { CREATION_RATE_MAX_STALENESS_SECONDS, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type CreationRateReader, type CreationRateSnapshot, type DeriveCashOrderOptions, type MethodCurrencyLike, NearIntentsDepositInput, type NearIntentsDepositInputJson, NearIntentsQuote, NearIntentsQuoteInput, type NearIntentsQuoteInputJson, type NearIntentsQuoteJson, NearIntentsSourceCapabilities, type NearIntentsSourceCapabilitiesJson, NearIntentsStatus, NearIntentsStatusInput, type NearIntentsStatusInputJson, type NearIntentsStatusJson, type NearIntentsTokenJson, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, PreparedVenmoGmailConnect, type PreparedVenmoGmailConnectJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, type VenmoGmailConnectResultJson, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashCorridorSupported, isCashError, isCreationRateCorridor, isFillLive, isMarketRateSupported, isUserRejectedError, nearIntentsCapabilitiesFromJson, nearIntentsCapabilitiesToJson, nearIntentsDepositInputFromJson, nearIntentsDepositInputJsonSchema, nearIntentsDepositInputToJson, nearIntentsQuoteFromJson, nearIntentsQuoteInputFromJson, nearIntentsQuoteInputJsonSchema, nearIntentsQuoteInputToJson, nearIntentsQuoteJsonSchema, nearIntentsQuoteRequestJsonSchema, nearIntentsQuoteResponseSchema, nearIntentsQuoteToJson, nearIntentsSourceCapabilitiesJsonSchema, nearIntentsStatusCodeSchema, nearIntentsStatusFromJson, nearIntentsStatusInputFromJson, nearIntentsStatusInputJsonSchema, nearIntentsStatusInputToJson, nearIntentsStatusJsonSchema, nearIntentsStatusResponseSchema, nearIntentsStatusToJson, nearIntentsTokenJsonSchema, nearIntentsTokensResponseSchema, nearIntentsTransactionJsonSchema, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, preparedVenmoGmailConnectFromJson, preparedVenmoGmailConnectJsonSchema, preparedVenmoGmailConnectToJson, rateToNumber, readAlipayCnyCreationRate, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, venmoGmailConnectResultFromJson, venmoGmailConnectResultJsonSchema, venmoGmailConnectResultToJson, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, R as RelayExecutionResult, p as RelayQuote, q as RelayStatus, r as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-94tPE0dH.js';
-export { B as BASE_CHAIN_ID, s as BASE_USDC_ADDRESS, t as CASH_ATTRIBUTION_CODE, u as CASH_ORDER_POLL_INTERVAL_MS, v as CASH_ORDER_STATUSES, w as CASH_REFERRAL_ATTRIBUTION_PREFIX, x as CASH_RETAIN_ON_EMPTY, y as CashAsset, z as CashChain, A as CashClient, D as CashClientOptions, E as CashCorridorPricing, F as CashFillEta, G as CashLeg, H as CashMultiCurrencyLeg, J as CashNextAction, K as CashOrderState, L as CashPairFillStats, M as CashPayeeInput, O as CashPayout, Q as CashPayoutPricing, S as CashPlatformCapability, U as CashPreparedStepKind, V as CashReceiveLeg, X as CashoutInput, Y as CashoutOptions, Z as CuratorPayeeDataInput, _ as EstimateInput, $ as EstimateOptions, a0 as MARKET_SPREAD_BPS, a1 as MIN_CASHOUT_AMOUNT, a2 as NEAR_INTENTS_API_URL, a3 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a4 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a5 as NEAR_INTENTS_STATUSES, a6 as NearIntentsClient, a7 as NearIntentsOptions, a8 as NearIntentsQuoteRequest, a9 as NearIntentsStatusCode, aa as NearIntentsToken, ab as NearIntentsTradeType, ac as NearIntentsTransaction, ad as ORACLE_MIN_CONVERSION_RATE_SENTINEL, ae as OrdersOptions, af as PreparedCashoutReceipt, ag as RECOMMENDED_MIN_CASHOUT_AMOUNT, ah as RelayOptions, ai as RelayQuoteInput, aj as RelaySourceInput, ak as RelayTransaction, al as SignerOptions, am as USDC_DECIMALS, an as WatchOptions, ao as WithdrawOptions, ap as buildCapabilities, aq as createCashClient, ar as createNearIntentsClient, as as normalizeCashPayee, at as quoteNearIntentsToBaseUsdc, au as readNearIntentsSourceCapabilities, av as readNearIntentsStatus, aw as submitNearIntentsDeposit, ax as toCashReferralAttributionCode } from './createCashClient-94tPE0dH.js';
+import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, p as PreparedVenmoGmailConnect, R as RelayExecutionResult, q as RelayQuote, r as RelayStatus, s as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-LTZshulP.js';
+export { B as BASE_CHAIN_ID, t as BASE_USDC_ADDRESS, u as CASH_ATTRIBUTION_CODE, v as CASH_ORDER_POLL_INTERVAL_MS, w as CASH_ORDER_STATUSES, x as CASH_REFERRAL_ATTRIBUTION_PREFIX, y as CASH_RETAIN_ON_EMPTY, z as CashAsset, A as CashChain, D as CashClient, E as CashClientOptions, F as CashCorridorPricing, G as CashFillEta, H as CashLeg, J as CashMultiCurrencyLeg, K as CashNextAction, L as CashOrderState, M as CashPairFillStats, O as CashPayeeInput, Q as CashPayout, S as CashPayoutPricing, U as CashPlatformCapability, V as CashPreparedStepKind, X as CashReceiveLeg, Y as CashoutInput, Z as CashoutOptions, _ as CuratorPayeeDataInput, $ as EstimateInput, a0 as EstimateOptions, a1 as MARKET_SPREAD_BPS, a2 as MIN_CASHOUT_AMOUNT, a3 as NEAR_INTENTS_API_URL, a4 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a5 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a6 as NEAR_INTENTS_STATUSES, a7 as NearIntentsClient, a8 as NearIntentsOptions, a9 as NearIntentsQuoteRequest, aa as NearIntentsStatusCode, ab as NearIntentsToken, ac as NearIntentsTradeType, ad as NearIntentsTransaction, ae as ORACLE_MIN_CONVERSION_RATE_SENTINEL, af as OrdersOptions, ag as PreparedCashoutReceipt, ah as RECOMMENDED_MIN_CASHOUT_AMOUNT, ai as RelayOptions, aj as RelayQuoteInput, ak as RelaySourceInput, al as RelayTransaction, am as SignerOptions, an as USDC_DECIMALS, ao as WatchOptions, ap as WithdrawOptions, aq as buildCapabilities, ar as createCashClient, as as createNearIntentsClient, at as normalizeCashPayee, au as quoteNearIntentsToBaseUsdc, av as readNearIntentsSourceCapabilities, aw as readNearIntentsStatus, ax as submitNearIntentsDeposit, ay as toCashReferralAttributionCode } from './createCashClient-LTZshulP.js';
 import { PublicClient, Log, Abi } from 'viem';
-import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
-export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
+import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction, VenmoGmailConnectResult } from '@zkp2p/sdk';
+export { CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailAppearance, VenmoGmailConnectError, VenmoGmailConnectResult, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { z } from 'zod';
 import '@relayprotocol/relay-sdk';
 
@@ -1540,6 +1540,15 @@ type RelayStatusJson = z.infer<typeof relayStatusJsonSchema>;
 type RelayExecutionResultJson = z.infer<typeof relayExecutionResultJsonSchema>;
 type CashErrorRecoveryJson = z.infer<typeof cashErrorRecoveryJsonSchema>;
 type CashErrorJson = z.infer<typeof cashErrorJsonSchema>;
+declare const venmoGmailConnectResultJsonSchema: z.ZodObject<{
+    payeeDetails: z.ZodString;
+}, z.core.$strip>;
+declare const preparedVenmoGmailConnectJsonSchema: z.ZodObject<{
+    payeeDetails: z.ZodString;
+    url: z.ZodURL;
+}, z.core.$strip>;
+type VenmoGmailConnectResultJson = z.infer<typeof venmoGmailConnectResultJsonSchema>;
+type PreparedVenmoGmailConnectJson = z.infer<typeof preparedVenmoGmailConnectJsonSchema>;
 
 /**
  * JSON codecs - lossless (de)serialization for every wire type. bigints encode
@@ -1593,5 +1602,9 @@ declare function capabilitiesToJson(caps: CashCapabilities): CashCapabilitiesJso
 declare function capabilitiesFromJson(json: unknown): CashCapabilities;
 declare function cashErrorToJson(error: CashErrorShape): CashErrorJson;
 declare function cashErrorFromJson(json: unknown): CashError;
+declare function preparedVenmoGmailConnectToJson(value: PreparedVenmoGmailConnect): PreparedVenmoGmailConnectJson;
+declare function preparedVenmoGmailConnectFromJson(json: unknown): PreparedVenmoGmailConnect;
+declare function venmoGmailConnectResultToJson(value: VenmoGmailConnectResult): VenmoGmailConnectResultJson;
+declare function venmoGmailConnectResultFromJson(json: unknown): VenmoGmailConnectResult;
 
-export { CREATION_RATE_MAX_STALENESS_SECONDS, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type CreationRateReader, type CreationRateSnapshot, type DeriveCashOrderOptions, type MethodCurrencyLike, NearIntentsDepositInput, type NearIntentsDepositInputJson, NearIntentsQuote, NearIntentsQuoteInput, type NearIntentsQuoteInputJson, type NearIntentsQuoteJson, NearIntentsSourceCapabilities, type NearIntentsSourceCapabilitiesJson, NearIntentsStatus, NearIntentsStatusInput, type NearIntentsStatusInputJson, type NearIntentsStatusJson, type NearIntentsTokenJson, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashCorridorSupported, isCashError, isCreationRateCorridor, isFillLive, isMarketRateSupported, isUserRejectedError, nearIntentsCapabilitiesFromJson, nearIntentsCapabilitiesToJson, nearIntentsDepositInputFromJson, nearIntentsDepositInputJsonSchema, nearIntentsDepositInputToJson, nearIntentsQuoteFromJson, nearIntentsQuoteInputFromJson, nearIntentsQuoteInputJsonSchema, nearIntentsQuoteInputToJson, nearIntentsQuoteJsonSchema, nearIntentsQuoteRequestJsonSchema, nearIntentsQuoteResponseSchema, nearIntentsQuoteToJson, nearIntentsSourceCapabilitiesJsonSchema, nearIntentsStatusCodeSchema, nearIntentsStatusFromJson, nearIntentsStatusInputFromJson, nearIntentsStatusInputJsonSchema, nearIntentsStatusInputToJson, nearIntentsStatusJsonSchema, nearIntentsStatusResponseSchema, nearIntentsStatusToJson, nearIntentsTokenJsonSchema, nearIntentsTokensResponseSchema, nearIntentsTransactionJsonSchema, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, readAlipayCnyCreationRate, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { CREATION_RATE_MAX_STALENESS_SECONDS, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type CreationRateReader, type CreationRateSnapshot, type DeriveCashOrderOptions, type MethodCurrencyLike, NearIntentsDepositInput, type NearIntentsDepositInputJson, NearIntentsQuote, NearIntentsQuoteInput, type NearIntentsQuoteInputJson, type NearIntentsQuoteJson, NearIntentsSourceCapabilities, type NearIntentsSourceCapabilitiesJson, NearIntentsStatus, NearIntentsStatusInput, type NearIntentsStatusInputJson, type NearIntentsStatusJson, type NearIntentsTokenJson, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, PreparedVenmoGmailConnect, type PreparedVenmoGmailConnectJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, type VenmoGmailConnectResultJson, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashCorridorSupported, isCashError, isCreationRateCorridor, isFillLive, isMarketRateSupported, isUserRejectedError, nearIntentsCapabilitiesFromJson, nearIntentsCapabilitiesToJson, nearIntentsDepositInputFromJson, nearIntentsDepositInputJsonSchema, nearIntentsDepositInputToJson, nearIntentsQuoteFromJson, nearIntentsQuoteInputFromJson, nearIntentsQuoteInputJsonSchema, nearIntentsQuoteInputToJson, nearIntentsQuoteJsonSchema, nearIntentsQuoteRequestJsonSchema, nearIntentsQuoteResponseSchema, nearIntentsQuoteToJson, nearIntentsSourceCapabilitiesJsonSchema, nearIntentsStatusCodeSchema, nearIntentsStatusFromJson, nearIntentsStatusInputFromJson, nearIntentsStatusInputJsonSchema, nearIntentsStatusInputToJson, nearIntentsStatusJsonSchema, nearIntentsStatusResponseSchema, nearIntentsStatusToJson, nearIntentsTokenJsonSchema, nearIntentsTokensResponseSchema, nearIntentsTransactionJsonSchema, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, preparedVenmoGmailConnectFromJson, preparedVenmoGmailConnectJsonSchema, preparedVenmoGmailConnectToJson, rateToNumber, readAlipayCnyCreationRate, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, venmoGmailConnectResultFromJson, venmoGmailConnectResultJsonSchema, venmoGmailConnectResultToJson, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/index.js

@@ -2,7 +2,8 @@ import { MARKET_SPREAD_BPS, ORACLE_MIN_CONVERSION_RATE_SENTINEL, CASH_RETAIN_ON_
 export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, CashError, MARKET_SPREAD_BPS, ORACLE_MIN_CONVERSION_RATE_SENTINEL, USDC_DECIMALS, errors, isCashError, isUserRejectedError } from './chunk-UIELF4TY.js';
 import { parseAbi, parseEventLogs, isAddress, http, createPublicClient, createWalletClient, encodeFunctionData } from 'viem';
 import { mainnet, polygon, base } from 'viem/chains';
-import { getSpreadOracleConfig, currencyInfo, getGatingServiceAddress, resolvePaymentMethodNameFromHash, getCurrencyCodeFromHash, createCompositeDepositId, appendAttributionToCalldata, Zkp2pClient, getPaymentMethodsCatalog, resolvePaymentMethodHashFromCatalog, defaultIndexerEndpoint, IndexerClient, CHAINLINK_ORACLE_FEEDS } from '@zkp2p/sdk';
+import { getSpreadOracleConfig, currencyInfo, getGatingServiceAddress, resolvePaymentMethodNameFromHash, getCurrencyCodeFromHash, createCompositeDepositId, appendAttributionToCalldata, openVenmoGmailConnect, getVenmoGmailConnectUrl, Zkp2pClient, getPaymentMethodsCatalog, resolvePaymentMethodHashFromCatalog, defaultIndexerEndpoint, IndexerClient, CHAINLINK_ORACLE_FEEDS } from '@zkp2p/sdk';
+export { VenmoGmailConnectError } from '@zkp2p/sdk';
 import { createClient, MAINNET_RELAY_API } from '@relayprotocol/relay-sdk';
 import { fetchChainConfigs, configureDynamicChains } from '@relayprotocol/relay-sdk/chain-utils';
 import { z } from 'zod';
@@ -1972,6 +1973,12 @@ var cashErrorJsonSchema = z.object({
   remediation: z.string(),
   recovery: cashErrorRecoveryJsonSchema.optional()
 }).strict();
+var venmoGmailConnectResultJsonSchema = z.object({
+  payeeDetails: z.string().regex(/^0x[0-9a-f]{64}$/i)
+});
+var preparedVenmoGmailConnectJsonSchema = venmoGmailConnectResultJsonSchema.extend({
+  url: z.url()
+});
 
 // src/client/nearIntents.ts
 var NEAR_INTENTS_API_URL = "https://1click.chaindefuser.com";
@@ -2362,6 +2369,11 @@ var DEFAULT_CURATOR_URLS = {
   preproduction: "https://api-preprod.zkp2p.xyz",
   staging: "https://api-staging.zkp2p.xyz"
 };
+var DEFAULT_PEER_ORIGINS = {
+  production: "https://app.peer.xyz",
+  preproduction: "https://ramp-preprod.peer.xyz",
+  staging: "https://ramp-staging.peer.xyz"
+};
 var ERC20_APPROVE_ABI = parseAbi([
   "function approve(address spender, uint256 amount) returns (bool)"
 ]);
@@ -2924,6 +2936,33 @@ function createCashClient(options) {
     return hashes;
   }
   return {
+    async prepareVenmoGmailConnect(payee) {
+      const { hashedOnchainIds } = await readClient.registerPayeeDetails({
+        processorNames: ["venmo"],
+        payeeData: [normalizeCashPayee("venmo", payee)]
+      });
+      const payeeDetails = hashedOnchainIds[0];
+      const url = getVenmoGmailConnectUrl({
+        ...options.venmoGmail,
+        payeeDetails,
+        peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
+      });
+      return { payeeDetails, url };
+    },
+    openVenmoGmailConnect(payeeDetails) {
+      return openVenmoGmailConnect({
+        ...options.venmoGmail,
+        payeeDetails,
+        peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
+      });
+    },
+    async isVenmoGmailConnected(payeeDetails) {
+      const { responseObject } = await readClient.getSellerCredentialStatus({
+        processorName: "venmo",
+        payeeDetails
+      });
+      return responseObject.status === "active" && responseObject.credentialType === "google_oauth";
+    },
     capabilities,
     async sourceCapabilities() {
       return readRelaySourceCapabilities(options.relay);
@@ -4007,5 +4046,22 @@ function cashErrorFromJson(json) {
     ...recovery ? { recovery } : {}
   });
 }
+function preparedVenmoGmailConnectToJson(value) {
+  return preparedVenmoGmailConnectJsonSchema.parse(value);
+}
+function preparedVenmoGmailConnectFromJson(json) {
+  const parsed = preparedVenmoGmailConnectJsonSchema.parse(json);
+  return {
+    ...parsed,
+    payeeDetails: parsed.payeeDetails
+  };
+}
+function venmoGmailConnectResultToJson(value) {
+  return venmoGmailConnectResultJsonSchema.parse(value);
+}
+function venmoGmailConnectResultFromJson(json) {
+  const parsed = venmoGmailConnectResultJsonSchema.parse(json);
+  return { payeeDetails: parsed.payeeDetails };
+}
 
-export { CASH_ATTRIBUTION_CODE, CASH_REFERRAL_ATTRIBUTION_PREFIX, CREATION_RATE_MAX_STALENESS_SECONDS, MIN_CASHOUT_AMOUNT, NEAR_INTENTS_API_URL, NEAR_INTENTS_BASE_USDC_ASSET_ID, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, NEAR_INTENTS_STATUSES, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, createNearIntentsClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashCorridorSupported, isCreationRateCorridor, isFillLive, isMarketRateSupported, nearIntentsCapabilitiesFromJson, nearIntentsCapabilitiesToJson, nearIntentsDepositInputFromJson, nearIntentsDepositInputJsonSchema, nearIntentsDepositInputToJson, nearIntentsQuoteFromJson, nearIntentsQuoteInputFromJson, nearIntentsQuoteInputJsonSchema, nearIntentsQuoteInputToJson, nearIntentsQuoteJsonSchema, nearIntentsQuoteRequestJsonSchema, nearIntentsQuoteResponseSchema, nearIntentsQuoteToJson, nearIntentsSourceCapabilitiesJsonSchema, nearIntentsStatusCodeSchema, nearIntentsStatusFromJson, nearIntentsStatusInputFromJson, nearIntentsStatusInputJsonSchema, nearIntentsStatusInputToJson, nearIntentsStatusJsonSchema, nearIntentsStatusResponseSchema, nearIntentsStatusToJson, nearIntentsTokenJsonSchema, nearIntentsTokensResponseSchema, nearIntentsTransactionJsonSchema, nonNegativeBigintString, normalizeCashPayee, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, quoteNearIntentsToBaseUsdc, rateToNumber, readAlipayCnyCreationRate, readNearIntentsSourceCapabilities, readNearIntentsStatus, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, submitNearIntentsDeposit, toCashReferralAttributionCode, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { CASH_ATTRIBUTION_CODE, CASH_REFERRAL_ATTRIBUTION_PREFIX, CREATION_RATE_MAX_STALENESS_SECONDS, MIN_CASHOUT_AMOUNT, NEAR_INTENTS_API_URL, NEAR_INTENTS_BASE_USDC_ASSET_ID, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, NEAR_INTENTS_STATUSES, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, createNearIntentsClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashCorridorSupported, isCreationRateCorridor, isFillLive, isMarketRateSupported, nearIntentsCapabilitiesFromJson, nearIntentsCapabilitiesToJson, nearIntentsDepositInputFromJson, nearIntentsDepositInputJsonSchema, nearIntentsDepositInputToJson, nearIntentsQuoteFromJson, nearIntentsQuoteInputFromJson, nearIntentsQuoteInputJsonSchema, nearIntentsQuoteInputToJson, nearIntentsQuoteJsonSchema, nearIntentsQuoteRequestJsonSchema, nearIntentsQuoteResponseSchema, nearIntentsQuoteToJson, nearIntentsSourceCapabilitiesJsonSchema, nearIntentsStatusCodeSchema, nearIntentsStatusFromJson, nearIntentsStatusInputFromJson, nearIntentsStatusInputJsonSchema, nearIntentsStatusInputToJson, nearIntentsStatusJsonSchema, nearIntentsStatusResponseSchema, nearIntentsStatusToJson, nearIntentsTokenJsonSchema, nearIntentsTokensResponseSchema, nearIntentsTransactionJsonSchema, nonNegativeBigintString, normalizeCashPayee, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, preparedVenmoGmailConnectFromJson, preparedVenmoGmailConnectJsonSchema, preparedVenmoGmailConnectToJson, quoteNearIntentsToBaseUsdc, rateToNumber, readAlipayCnyCreationRate, readNearIntentsSourceCapabilities, readNearIntentsStatus, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, submitNearIntentsDeposit, toCashReferralAttributionCode, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, venmoGmailConnectResultFromJson, venmoGmailConnectResultJsonSchema, venmoGmailConnectResultToJson, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { A as CashClient, _ as EstimateInput, h as CashEstimate, Y as CashoutOptions, g as CashoutResult, X as CashoutInput, T as TopUpResult, W as WithdrawResult, d as CashOrder } from './createCashClient-94tPE0dH.cjs';
+import { D as CashClient, $ as EstimateInput, h as CashEstimate, Z as CashoutOptions, g as CashoutResult, Y as CashoutInput, T as TopUpResult, W as WithdrawResult, d as CashOrder } from './createCashClient-LTZshulP.cjs';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { A as CashClient, _ as EstimateInput, h as CashEstimate, Y as CashoutOptions, g as CashoutResult, X as CashoutInput, T as TopUpResult, W as WithdrawResult, d as CashOrder } from './createCashClient-94tPE0dH.js';
+import { D as CashClient, $ as EstimateInput, h as CashEstimate, Z as CashoutOptions, g as CashoutResult, Y as CashoutInput, T as TopUpResult, W as WithdrawResult, d as CashOrder } from './createCashClient-LTZshulP.js';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/tools.cjs

@@ -2,7 +2,7 @@
 
 // package.json
 var package_default = {
-  version: "0.6.0-rc.1"};
+  version: "0.6.1"};
 
 // src/tools/index.ts
 var bigintString = {

package/dist/tools.js

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "0.6.0-rc.1"};
+  version: "0.6.1"};
 
 // src/tools/index.ts
 var bigintString = {

package/docs/partner-integrations.md

@@ -139,3 +139,26 @@ before any resubmission.
   assets.
 - Test a small staging cash-out through `awaiting-buyer`, `withdraw()`, and
   `returned` before enabling production funds.
+
+## Optional Venmo receipt linking
+
+Offer this separately; `cashout()` and `prepare()` never require or invoke it.
+Run `cash.prepareVenmoGmailConnect(handle)` when the user selects Venmo, then
+call `cash.openVenmoGmailConnect(link.payeeDetails)` directly from a separate
+button click. Re-prepare when the selected handle changes. Use
+`cash.isVenmoGmailConnected(link.payeeDetails)` after returning from a mobile
+tab or an ambiguous closure; service errors reject, and only an active Google
+credential counts as connected. Persist the hash with its environment and user.
+
+The hosted flow accepts Google-hosted school/custom domains and verifies actual
+Venmo receipts. `VenmoGmailConnectError` retains codes such as
+`venmo_google_oauth_receipt_not_found`, `popup_blocked`, `connection_closed`,
+and `connection_timeout`; it is separate from `CashError`. No emails or Google
+tokens reach the partner. `link.url` supports redirect/native hosts, which
+must check status on return. See the README and `examples/venmo-link.ts`.
+
+Configure optional `venmoGmail: { appearance, popup }` on `createCashClient()`
+to share partner branding between the prepared URL and popup. Omit it for Peer
+branding; omit `appearance.logoUrl` to keep the Peer logo beside Venmo. Popup
+width/height apply to desktop; mobile browsers control tab sizing. See the
+README's "Customize the hosted popup" section for the configuration example.

package/examples/venmo-link.ts

@@ -0,0 +1,39 @@
+import {
+  createCashClient,
+  VenmoGmailConnectError,
+  type PreparedVenmoGmailConnect,
+} from '@zkp2p/cash';
+
+const cash = createCashClient({
+  environment: 'production',
+  // Optional: omit venmoGmail for Peer branding and the default popup size.
+  venmoGmail: {
+    appearance: { buttonColor: '#6246EA', buttonTextColor: '#FFFFFF' },
+    popup: { width: 500, height: 620 },
+  },
+});
+
+/** Optional onboarding: call with the selected handle before enabling the link button. */
+export async function prepareVenmoLink(handle: string) {
+  return cash.prepareVenmoGmailConnect(handle);
+}
+
+/** Bind this to a click. Keep registration/other awaits outside the handler. */
+export function linkVenmo(link: PreparedVenmoGmailConnect) {
+  return cash.openVenmoGmailConnect(link.payeeDetails).catch((error: unknown) => {
+    if (error instanceof VenmoGmailConnectError) {
+      // Render error.message. For an ambiguous closure/timeout, offer a status refresh.
+      // Missing receipts: let the user choose the inbox that receives their receipts.
+      console.error(error.code, error.message);
+    }
+    throw error;
+  });
+}
+
+/** Also call when returning from a mobile tab or redirect opened with link.url. */
+export function checkVenmoLink(link: PreparedVenmoGmailConnect) {
+  return cash.isVenmoGmailConnected(link.payeeDetails);
+}
+
+// cash.cashout(...) remains a separate action and does not require these helpers.
+// No Gmail address is taken here: receipt verification belongs to the hosted flow.

package/llms.txt

@@ -12,6 +12,20 @@
 
 Key facts:
 
+- Optional Venmo receipt linking: prepareVenmoGmailConnect(handle) registers
+  the selected handle and returns { payeeDetails, url }. From a separate click,
+  openVenmoGmailConnect(payeeDetails) opens the environment's hosted flow.
+  isVenmoGmailConnected(payeeDetails) checks for an active Google credential;
+  lookup errors reject. Cashout and prepare never call or require these steps.
+  Mobile may open a tab; check status on return or ambiguous popup closure.
+  Google-hosted school/custom domains are supported; actual receipt failures
+  use VenmoGmailConnectError.code, including venmo_google_oauth_receipt_not_found.
+  Partner apps receive neither emails nor Google tokens. Re-prepare when the
+  handle changes; persist payee hash with environment and user account.
+  Optional createCashClient({ venmoGmail: { appearance, popup } }) shares branding
+  between the prepared URL and popup. Defaults use Peer branding; desktop popup
+  dimensions do not control mobile tab sizing. See the README customization example.
+
 - The cashing-out user is the MAKER: their USDC becomes a protocol-held order;
   a buyer pays fiat and proves it with TEE-TLS; the protocol releases the USDC.
 - Destination is always Base USDC. Relay sources come from live SDK metadata;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/cash",
-  "version": "0.6.0-rc.1",
+  "version": "0.6.1",
   "description": "Peer Cash - offramp-only SDK for routing Relay or NEAR Intents assets to Base USDC, then cashing out to fiat at zero-spread Chainlink market rates.",
   "license": "MIT",
   "author": "Peer (https://peer.xyz)",
@@ -108,7 +108,7 @@
   },
   "dependencies": {
     "@relayprotocol/relay-sdk": "^7.0.1",
-    "@zkp2p/sdk": "0.14.2-rc.1",
+    "@zkp2p/sdk": "0.14.2",
     "zod": "^4.4.3"
   },
   "peerDependencies": {

package/skills/peer-cash-integration/SKILL.md

@@ -282,3 +282,26 @@ old and not in the future. Record the observation time and selected chain,
 then stop before funding if the read fails. Unit-test fixtures prove routing,
 not live availability. The authoritative feed listing is
 https://data.chain.link/feeds/polygon/mainnet/inr-usd.
+
+## Optional Venmo receipt linking
+
+Offer this separately; `cashout()` and `prepare()` never require or invoke it.
+Run `cash.prepareVenmoGmailConnect(handle)` when the user selects Venmo, then
+call `cash.openVenmoGmailConnect(link.payeeDetails)` directly from a separate
+button click. Re-prepare when the selected handle changes. Use
+`cash.isVenmoGmailConnected(link.payeeDetails)` after returning from a mobile
+tab or an ambiguous closure; service errors reject, and only an active Google
+credential counts as connected. Persist the hash with its environment and user.
+
+The hosted flow accepts Google-hosted school/custom domains and verifies actual
+Venmo receipts. `VenmoGmailConnectError` retains codes such as
+`venmo_google_oauth_receipt_not_found`, `popup_blocked`, `connection_closed`,
+and `connection_timeout`; it is separate from `CashError`. No emails or Google
+tokens reach the partner. `link.url` supports redirect/native hosts, which
+must check status on return. See the README and `examples/venmo-link.ts`.
+
+Configure optional `venmoGmail: { appearance, popup }` on `createCashClient()`
+to share partner branding between the prepared URL and popup. Omit it for Peer
+branding; omit `appearance.logoUrl` to keep the Peer logo beside Venmo. Popup
+width/height apply to desktop; mobile browsers control tab sizing. See the
+README's "Customize the hosted popup" section for the configuration example.

package/skills/upi-preprod-qa/SKILL.md

@@ -59,13 +59,12 @@ Inspect `disputeProtectionRequiresStake` before buyer QA so stake admission is
 not mistaken for a payment-proof failure.
 
 Buyer QA belongs to the client and attestation repositories. Amazon Pay is the
-sole client flow: no HDFC/Gmail selector or fallback copy. Pay with standard UPI
+sole buyer proof flow. Pay with standard UPI
 to a person, then verify from the same Amazon account. Exclude UPI Lite, merchant
 payments and incoming transactions. Keep session evidence encrypted. A real
 intent requires the exact payment identity, allowed payment-time window, and an
 unused payment nullifier. Report maker deposit, buyer signal, evidence proof,
-and settlement as separate checkpoints. Backend HDFC support is retained until
-a separately authorized retirement; do not remove its server routes here.
+and settlement as separate checkpoints.
 
 After buyer intents are cancelled or otherwise terminal, call the supported
 `withdraw` path and verify the receipt and returned order state. If a transaction