@zkp2p/cash 0.5.4-rc.2 → 0.6.0

package/AGENTS.md

@@ -8,7 +8,7 @@ You are integrating Peer Cash: an offramp that routes Relay-supported EVM
 assets or NEAR Intents 1Click external deposits into Base USDC, then converts
 Base USDC to fiat (Venmo, Revolut, Wise, Alipay, Zelle, ...) at a zero-spread
 Chainlink market rate. Existing corridors bind at intent signal; Alipay/CNY
-fixes a fresh Ethereum Chainlink snapshot during deposit preparation; opt-in UPI/INR uses Polygon Chainlink. The user whose USDC you
+fixes a fresh Ethereum Chainlink snapshot during deposit preparation; UPI/INR uses Polygon Chainlink. The user whose USDC you
 manage is the **maker**; a buyer pays them fiat and proves it with TEE-TLS; the
 protocol releases the USDC. Funds are held by the protocol, and only the maker
 can withdraw an unmatched deposit.
@@ -70,8 +70,7 @@ deposit-level integration share instead of applying maker L1/L2.
 - **Venmo, Revolut, Cash App, Monzo** validate the handle against the live
   platform at registration - the account must exist. The rest (Zelle, Chime,
   etc.) are format-checked only. Match handles to the `payeeHint`.
-- **UPI is staging/preproduction-only and opt-in.** Construct the client with
-  `features: { upi: true }`. Any valid UPI ID from any bank can receive; there
+- **UPI is available in every environment without a rollout flag.** Any valid UPI ID from any bank can receive; there
   is no seller bank login, extension, identity attestation, or prior
   registration flow. Buyers pay and verify through Amazon Pay using standard UPI.
 
@@ -342,4 +341,21 @@ read-only RPC with `upiCreationRateRpcUrl` or `upiCreationRateTransport`.
 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 remains opt-in on staging/preproduction and disabled in production.
+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`.

package/README.md

@@ -4,7 +4,7 @@ Route Relay-supported EVM assets or NEAR Intents 1Click external deposits into
 Base USDC, then cash out to fiat on Venmo, Revolut, Wise, Alipay, Zelle, and
 more at a zero-spread Chainlink market rate with no centralized off-ramp
 provider. Existing corridors bind the live oracle when a buyer signals;
-Alipay/CNY and opt-in UPI/INR fix fresh Chainlink snapshots when the SDK prepares
+Alipay/CNY and UPI/INR fix fresh Chainlink snapshots when the SDK prepares
 the deposit (Ethereum for CNY; Polygon for INR).
 
 Peer Cash is an **offramp-only** SDK for the [ZKP2P](https://peer.xyz)
@@ -98,15 +98,13 @@ for await (const order of cash.watch(depositId)) {
 
 UPI requires the canonical UPI/INR catalog from `@zkp2p/sdk` 0.14.2-rc.1
 or its approved successor; a missing catalog entry keeps the corridor disabled.
-UPI is an opt-in staging and preproduction corridor. Production remains disabled
-pending rollout review. Any valid UPI ID from any bank can receive a cash-out. The seller
+UPI is available in every environment without an opt-in. Any valid UPI ID from any bank can receive a cash-out. The seller
 does not connect a bank account, install an extension, or complete a separate
 registration flow:
 
 ```ts
 const cash = createCashClient({
   environment: 'preproduction',
-  features: { upi: true },
 });
 
 await cash.cashout(
@@ -146,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                                                                    |
@@ -184,16 +185,70 @@ 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`.
+
 ## Payout rails and access policies
 
-| Payout rail                  | Access-policy behavior                                                     | New payee registration                                                                 |
-| ---------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| Venmo                        | Peer Pay merchant policy attaches for that payment method                  | Curator validates the live handle                                                      |
-| PayPal                       | Same method-scoped Peer Pay follow-up                                      | Requires a Peer TEE browser-extension identity attestation                             |
-| Cash App                     | No access-policy follow-up; non-chargebackable and no stake required       | Curator validates the live handle                                                      |
-| Wise                         | No access-policy follow-up                                                 | Requires a Peer TEE browser-extension identity attestation                             |
-| UPI (staging/preprod opt-in) | No access-policy follow-up                                                 | Any valid UPI ID; no account connection or identity attestation                        |
-| Other supported rails        | No access-policy follow-up; use `capabilities()` for currencies and format | Follow the `payeeHint`; live-validation behavior is described in the integration guide |
+| Payout rail           | Access-policy behavior                                                     | New payee registration                                                                 |
+| --------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| Venmo                 | Peer Pay merchant policy attaches for that payment method                  | Curator validates the live handle                                                      |
+| PayPal                | Same method-scoped Peer Pay follow-up                                      | Requires a Peer TEE browser-extension identity attestation                             |
+| Cash App              | No access-policy follow-up; non-chargebackable and no stake required       | Curator validates the live handle                                                      |
+| Wise                  | No access-policy follow-up                                                 | Requires a Peer TEE browser-extension identity attestation                             |
+| UPI                   | No access-policy follow-up                                                 | Any valid UPI ID; no account connection or identity attestation                        |
+| Other supported rails | No access-policy follow-up; use `capabilities()` for currencies and format | Follow the `payeeHint`; live-validation behavior is described in the integration guide |
 
 No platform requires an atomic access-policy flow. `cashout()` and `prepare()`
 work with any viem `WalletClient`, including a local or externally connected
@@ -483,7 +538,7 @@ is the default source and the only destination asset for cashout orders.
 Runnable first-party examples in [`examples/`](examples):
 
 - [`node-cashout.ts`](examples/node-cashout.ts) - server-side cash-out with a private-key signer, plus order tracking.
-- [`upi-staging-cashout.ts`](examples/upi-staging-cashout.ts) - opt-in UPI/INR cash-out to any valid UPI ID on staging or preproduction.
+- [`upi-staging-cashout.ts`](examples/upi-staging-cashout.ts) - UPI/INR cash-out to any valid UPI ID on staging or preproduction.
 - [`agent-tool-use.ts`](examples/agent-tool-use.ts) - wiring the verbs into an agent tool-use loop with host-side signing.
 - [`carpe-diem-provider-cashout`](examples/carpe-diem-provider-cashout) - cash out confirmed Carpe Diem provider DIEM revenue through the connected Base wallet.
 - [`mpp-merchant-cashout`](examples/mpp-merchant-cashout) - turn confirmed MPP merchant revenue into an unsigned Peer Cash plan while the merchant keeps custody and signing.

package/dist/{createCashClient-ECL3HN5H.d.cts → createCashClient-CZgoTClw.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 } from '@zkp2p/sdk';
 import { Execute, RelayClient, RelayChain, ProgressData } from '@relayprotocol/relay-sdk';
 
 /**
@@ -468,16 +468,10 @@ declare function quoteNearIntentsToBaseUsdc(input: NearIntentsQuoteInput, option
 declare function submitNearIntentsDeposit(input: NearIntentsDepositInput, options?: NearIntentsOptions): Promise<NearIntentsStatus>;
 declare function readNearIntentsStatus(input: NearIntentsStatusInput, options?: NearIntentsOptions): Promise<NearIntentsStatus>;
 
-interface CashCatalogFeatures {
-    upi?: boolean;
-}
-
 /** Hard floor: below one cent a deposit is dust and can never fill. */
 declare const MIN_CASHOUT_AMOUNT = 10000n;
 /** Recommended floor: sub-1-USDC deposits force min==max fills and starve matching. */
 declare const RECOMMENDED_MIN_CASHOUT_AMOUNT = 1000000n;
-/** Opt-in product surfaces that are not yet available on production contracts. */
-type CashFeatureFlags = CashCatalogFeatures;
 type CashCorridorPricing = {
     kind: 'oracle-at-intent-signal';
     spreadBps: 0;
@@ -560,7 +554,7 @@ interface CashCapabilities {
         spreadBps: 0;
     };
 }
-declare function buildCapabilities(environment: RuntimeEnv, features?: CashFeatureFlags): CashCapabilities;
+declare function buildCapabilities(environment: RuntimeEnv): CashCapabilities;
 
 interface CashPairFillStats {
     /** Fulfilled intents through this pair or currency set inside the rolling 30-day window. */
@@ -671,11 +665,13 @@ 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;
-    /** Fail-closed opt-ins for corridors that are not deployed to production. */
-    features?: CashFeatureFlags;
     /** viem transport for RPC reads; defaults to the public Base RPC. */
     transport?: Transport;
     /** Convenience alternative to `transport`. */
@@ -686,6 +682,8 @@ 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 ZKP2P API key. */
     apiKey?: string;
     /** Ethereum transport used only to snapshot Alipay/CNY's creation-time rate. */
@@ -858,6 +856,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. */
@@ -949,4 +953,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { type CuratorPayeeDataInput 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 CashFeatureFlags as G, type CashFillEta as H, type IntentEntity as I, type CashLeg as J, type CashMultiCurrencyLeg as K, type CashNextAction as L, type CashOrderState as M, type NearIntentsSourceCapabilities as N, type CashPairFillStats as O, type PrepareResult as P, type CashPayeeInput as Q, type RelayExecutionResult as R, type CashPayout as S, type TopUpResult as T, type CashPayoutPricing as U, type CashPlatformCapability as V, type WithdrawResult as W, type CashPreparedStepKind as X, type CashReceiveLeg as Y, type CashoutInput as Z, type CashoutOptions as _, type CashBuyerProfile as a, type EstimateInput as a0, type EstimateOptions as a1, MARKET_SPREAD_BPS as a2, MIN_CASHOUT_AMOUNT as a3, NEAR_INTENTS_API_URL as a4, NEAR_INTENTS_BASE_USDC_ASSET_ID as a5, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS as a6, NEAR_INTENTS_STATUSES as a7, type NearIntentsClient as a8, type NearIntentsOptions as a9, type NearIntentsQuoteRequest as aa, type NearIntentsStatusCode as ab, type NearIntentsToken as ac, type NearIntentsTradeType as ad, type NearIntentsTransaction as ae, ORACLE_MIN_CONVERSION_RATE_SENTINEL as af, type OrdersOptions as ag, type PreparedCashoutReceipt as ah, RECOMMENDED_MIN_CASHOUT_AMOUNT as ai, type RelayOptions as aj, type RelayQuoteInput as ak, type RelaySourceInput as al, type RelayTransaction as am, type SignerOptions as an, USDC_DECIMALS as ao, type WatchOptions as ap, type WithdrawOptions as aq, buildCapabilities as ar, createCashClient as as, createNearIntentsClient as at, normalizeCashPayee as au, quoteNearIntentsToBaseUsdc as av, readNearIntentsSourceCapabilities as aw, readNearIntentsStatus as ax, submitNearIntentsDeposit as ay, toCashReferralAttributionCode as az, type CashDepositInput as b, type CashCatalogFeatures as c, type CreateDepositParamsArg as d, type CashOrder as e, type CashFill as f, type CashCapabilities as g, type CashoutResult as h, type CashEstimate as i, type CashFillStats as j, type NearIntentsDepositInput as k, type NearIntentsQuote as l, type NearIntentsQuoteInput as m, type NearIntentsStatus as n, type NearIntentsStatusInput as o, type CashPreparedStep 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 };
+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-ECL3HN5H.d.ts → createCashClient-CZgoTClw.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 } from '@zkp2p/sdk';
 import { Execute, RelayClient, RelayChain, ProgressData } from '@relayprotocol/relay-sdk';
 
 /**
@@ -468,16 +468,10 @@ declare function quoteNearIntentsToBaseUsdc(input: NearIntentsQuoteInput, option
 declare function submitNearIntentsDeposit(input: NearIntentsDepositInput, options?: NearIntentsOptions): Promise<NearIntentsStatus>;
 declare function readNearIntentsStatus(input: NearIntentsStatusInput, options?: NearIntentsOptions): Promise<NearIntentsStatus>;
 
-interface CashCatalogFeatures {
-    upi?: boolean;
-}
-
 /** Hard floor: below one cent a deposit is dust and can never fill. */
 declare const MIN_CASHOUT_AMOUNT = 10000n;
 /** Recommended floor: sub-1-USDC deposits force min==max fills and starve matching. */
 declare const RECOMMENDED_MIN_CASHOUT_AMOUNT = 1000000n;
-/** Opt-in product surfaces that are not yet available on production contracts. */
-type CashFeatureFlags = CashCatalogFeatures;
 type CashCorridorPricing = {
     kind: 'oracle-at-intent-signal';
     spreadBps: 0;
@@ -560,7 +554,7 @@ interface CashCapabilities {
         spreadBps: 0;
     };
 }
-declare function buildCapabilities(environment: RuntimeEnv, features?: CashFeatureFlags): CashCapabilities;
+declare function buildCapabilities(environment: RuntimeEnv): CashCapabilities;
 
 interface CashPairFillStats {
     /** Fulfilled intents through this pair or currency set inside the rolling 30-day window. */
@@ -671,11 +665,13 @@ 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;
-    /** Fail-closed opt-ins for corridors that are not deployed to production. */
-    features?: CashFeatureFlags;
     /** viem transport for RPC reads; defaults to the public Base RPC. */
     transport?: Transport;
     /** Convenience alternative to `transport`. */
@@ -686,6 +682,8 @@ 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 ZKP2P API key. */
     apiKey?: string;
     /** Ethereum transport used only to snapshot Alipay/CNY's creation-time rate. */
@@ -858,6 +856,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. */
@@ -949,4 +953,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { type CuratorPayeeDataInput 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 CashFeatureFlags as G, type CashFillEta as H, type IntentEntity as I, type CashLeg as J, type CashMultiCurrencyLeg as K, type CashNextAction as L, type CashOrderState as M, type NearIntentsSourceCapabilities as N, type CashPairFillStats as O, type PrepareResult as P, type CashPayeeInput as Q, type RelayExecutionResult as R, type CashPayout as S, type TopUpResult as T, type CashPayoutPricing as U, type CashPlatformCapability as V, type WithdrawResult as W, type CashPreparedStepKind as X, type CashReceiveLeg as Y, type CashoutInput as Z, type CashoutOptions as _, type CashBuyerProfile as a, type EstimateInput as a0, type EstimateOptions as a1, MARKET_SPREAD_BPS as a2, MIN_CASHOUT_AMOUNT as a3, NEAR_INTENTS_API_URL as a4, NEAR_INTENTS_BASE_USDC_ASSET_ID as a5, NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS as a6, NEAR_INTENTS_STATUSES as a7, type NearIntentsClient as a8, type NearIntentsOptions as a9, type NearIntentsQuoteRequest as aa, type NearIntentsStatusCode as ab, type NearIntentsToken as ac, type NearIntentsTradeType as ad, type NearIntentsTransaction as ae, ORACLE_MIN_CONVERSION_RATE_SENTINEL as af, type OrdersOptions as ag, type PreparedCashoutReceipt as ah, RECOMMENDED_MIN_CASHOUT_AMOUNT as ai, type RelayOptions as aj, type RelayQuoteInput as ak, type RelaySourceInput as al, type RelayTransaction as am, type SignerOptions as an, USDC_DECIMALS as ao, type WatchOptions as ap, type WithdrawOptions as aq, buildCapabilities as ar, createCashClient as as, createNearIntentsClient as at, normalizeCashPayee as au, quoteNearIntentsToBaseUsdc as av, readNearIntentsSourceCapabilities as aw, readNearIntentsStatus as ax, submitNearIntentsDeposit as ay, toCashReferralAttributionCode as az, type CashDepositInput as b, type CashCatalogFeatures as c, type CreateDepositParamsArg as d, type CashOrder as e, type CashFill as f, type CashCapabilities as g, type CashoutResult as h, type CashEstimate as i, type CashFillStats as j, type NearIntentsDepositInput as k, type NearIntentsQuote as l, type NearIntentsQuoteInput as m, type NearIntentsStatus as n, type NearIntentsStatusInput as o, type CashPreparedStep 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 };
+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

@@ -142,14 +142,8 @@ async function readCashCreationRate(publicClient, platform, currency, nowSeconds
 async function readAlipayCnyCreationRate(publicClient, nowSeconds = Math.floor(Date.now() / 1e3)) {
   return readCashCreationRate(publicClient, "alipay", "CNY", nowSeconds);
 }
-function getCashPaymentMethodsCatalog(environment, features = {}) {
-  const catalog = sdk.getPaymentMethodsCatalog(8453, environment);
-  if ((environment === "staging" || environment === "preproduction") && features.upi === true) {
-    return catalog;
-  }
-  const enabledCatalog = { ...catalog };
-  delete enabledCatalog.upi;
-  return enabledCatalog;
+function getCashPaymentMethodsCatalog(environment) {
+  return sdk.getPaymentMethodsCatalog(8453, environment);
 }
 function resolveCashPaymentMethodHash(processorName, catalog) {
   if (processorName.trim().toLowerCase() === "upi" && !catalog.upi) {
@@ -192,12 +186,12 @@ function buildIntentAmountRange(amount) {
   const min = amount < DEFAULT_MIN_ORDER_FLOOR ? amount : DEFAULT_MIN_ORDER_FLOOR;
   return { min, max: amount };
 }
-async function prepareCashDepositParams(client, input, adapters, creationRateReader, features) {
+async function prepareCashDepositParams(client, input, adapters, creationRateReader) {
   const { payouts } = input;
   if (!payouts.length) throw new Error("At least one payout is required");
   const chainId = client.chainId;
   const runtimeEnv = client.runtimeEnv;
-  const catalog = getCashPaymentMethodsCatalog(runtimeEnv, features);
+  const catalog = getCashPaymentMethodsCatalog(runtimeEnv);
   const intentGatingService = sdk.getGatingServiceAddress(chainId, runtimeEnv);
   const processorNames = payouts.map((p) => p.processorName);
   const paymentMethodsOverride = processorNames.map(
@@ -633,8 +627,8 @@ var IDENTITY_ATTESTATION_PLATFORMS = /* @__PURE__ */ new Set(["wise", "paypal",
 function platformRequiresIdentityAttestation(platform) {
   return IDENTITY_ATTESTATION_PLATFORMS.has(platform.toLowerCase());
 }
-function buildCapabilities(environment, features = {}) {
-  const catalog = getCashPaymentMethodsCatalog(environment, features);
+function buildCapabilities(environment) {
+  const catalog = getCashPaymentMethodsCatalog(environment);
   const platforms = Object.entries(catalog).map(([platform, entry]) => {
     const currencies2 = (entry.currencies ?? []).map((hash) => sdk.getCurrencyCodeFromHash(hash)).filter(
       (code) => code != null && (isMarketRateSupported(code) || isCreationRateCorridor(platform, code))
@@ -2472,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";
@@ -2862,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)"
 ]);
@@ -2913,8 +2918,8 @@ async function submitAndConfirm(client, verb, send) {
 function isKnownPreBroadcastFailure(mapped) {
   return mapped.code === "TRANSACTION_REJECTED" || mapped.code === "INSUFFICIENT_TOKEN_BALANCE" || mapped.code === "ALLOWANCE_NOT_VISIBLE" || mapped.code === "ESCROW_PAUSED";
 }
-function cashoutAccessPolicyPaymentMethods(depositInput, environment, features) {
-  const catalog = getCashPaymentMethodsCatalog(environment, features);
+function cashoutAccessPolicyPaymentMethods(depositInput, environment) {
+  const catalog = getCashPaymentMethodsCatalog(environment);
   return [
     ...new Set(
       depositInput.payouts.filter((payout) => CASH_RESTRICTED_PLATFORMS.has(payout.processorName.toLowerCase())).map((payout) => resolveCashPaymentMethodHash(payout.processorName, catalog))
@@ -3011,7 +3016,7 @@ function createCashClient(options) {
     if (legs.length === 0) {
       throw errors.invalidPayoutPlatforms("at least one payout leg is required");
     }
-    const capabilities2 = buildCapabilities(environment, options.features);
+    const capabilities2 = buildCapabilities(environment);
     const seenPlatforms = /* @__PURE__ */ new Set();
     const payouts = legs.map((leg) => {
       const platform = capabilities2.platforms.find(
@@ -3092,8 +3097,7 @@ function createCashClient(options) {
           } catch (err) {
             throw errors.oracleReadFailed(currency, err);
           }
-        },
-        options.features
+        }
       );
     } catch (err) {
       if (isCashError(err)) throw err;
@@ -3145,7 +3149,7 @@ function createCashClient(options) {
     const payouts = derivePayouts(
       deposit.paymentMethods ?? [],
       deposit.currencies ?? [],
-      getCashPaymentMethodsCatalog(environment, options.features)
+      getCashPaymentMethodsCatalog(environment)
     );
     let attributedToCash = false;
     if (!isCashPayoutSet(payouts)) {
@@ -3203,7 +3207,7 @@ function createCashClient(options) {
     return escrowContext(depositId);
   }
   function capabilities(capabilityOptions) {
-    const baseCapabilities = buildCapabilities(environment, options.features);
+    const baseCapabilities = buildCapabilities(environment);
     if (!capabilityOptions?.includeRelaySources && !capabilityOptions?.includeNearIntentsSources) {
       return baseCapabilities;
     }
@@ -3381,11 +3385,7 @@ function createCashClient(options) {
   }
   async function configureCashoutAccess(client, signer, depositInput, depositId, source) {
     const groupIds = CASH_ACCESS_GROUP_IDS[environment];
-    const paymentMethods = cashoutAccessPolicyPaymentMethods(
-      depositInput,
-      environment,
-      options.features
-    );
+    const paymentMethods = cashoutAccessPolicyPaymentMethods(depositInput, environment);
     const hashes = [];
     for (const paymentMethod of paymentMethods) {
       const prepared = prepareCashoutAccess(depositId, paymentMethod, client, source);
@@ -3429,6 +3429,31 @@ 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({
+        payeeDetails,
+        peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
+      });
+      return { payeeDetails, url };
+    },
+    openVenmoGmailConnect(payeeDetails) {
+      return sdk.openVenmoGmailConnect({
+        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);
@@ -3691,8 +3716,7 @@ function createCashClient(options) {
       const hashedOnchainIds = (params.paymentMethodDataOverride ?? []).map((d) => d.payeeDetails);
       const accessPolicyPaymentMethods = cashoutAccessPolicyPaymentMethods(
         depositInput,
-        environment,
-        options.features
+        environment
       );
       return {
         txs: [approve, prepared],
@@ -3763,7 +3787,7 @@ function createCashClient(options) {
       } catch (err) {
         throw errors.indexerUnavailable("orders", err);
       }
-      const catalog = getCashPaymentMethodsCatalog(environment, options.features);
+      const catalog = getCashPaymentMethodsCatalog(environment);
       let attributedCashDeposits = /* @__PURE__ */ new Set();
       const fixedRateCandidates = deposits.filter((deposit) => {
         const payouts = derivePayouts(
@@ -4513,7 +4537,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;
@@ -4626,6 +4671,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;
@@ -4651,6 +4699,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 CashCatalogFeatures, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, j as CashFillStats, N as NearIntentsSourceCapabilities, k as NearIntentsDepositInput, l as NearIntentsQuote, m as NearIntentsQuoteInput, n as NearIntentsStatus, o as NearIntentsStatusInput, P as PrepareResult, p as CashPreparedStep, R as RelayExecutionResult, q as RelayQuote, r as RelayStatus, s as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-ECL3HN5H.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 CashFeatureFlags, H as CashFillEta, J as CashLeg, K as CashMultiCurrencyLeg, L as CashNextAction, M as CashOrderState, O as CashPairFillStats, Q as CashPayeeInput, S as CashPayout, U as CashPayoutPricing, V as CashPlatformCapability, X as CashPreparedStepKind, Y as CashReceiveLeg, Z as CashoutInput, _ as CashoutOptions, $ as CuratorPayeeDataInput, a0 as EstimateInput, a1 as EstimateOptions, a2 as MARKET_SPREAD_BPS, a3 as MIN_CASHOUT_AMOUNT, a4 as NEAR_INTENTS_API_URL, a5 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a6 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a7 as NEAR_INTENTS_STATUSES, a8 as NearIntentsClient, a9 as NearIntentsOptions, aa as NearIntentsQuoteRequest, ab as NearIntentsStatusCode, ac as NearIntentsToken, ad as NearIntentsTradeType, ae as NearIntentsTransaction, af as ORACLE_MIN_CONVERSION_RATE_SENTINEL, ag as OrdersOptions, ah as PreparedCashoutReceipt, ai as RECOMMENDED_MIN_CASHOUT_AMOUNT, aj as RelayOptions, ak as RelayQuoteInput, al as RelaySourceInput, am as RelayTransaction, an as SignerOptions, ao as USDC_DECIMALS, ap as WatchOptions, aq as WithdrawOptions, ar as buildCapabilities, as as createCashClient, at as createNearIntentsClient, au as normalizeCashPayee, av as quoteNearIntentsToBaseUsdc, aw as readNearIntentsSourceCapabilities, ax as readNearIntentsStatus, ay as submitNearIntentsDeposit, az as toCashReferralAttributionCode } from './createCashClient-ECL3HN5H.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-CZgoTClw.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-CZgoTClw.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, VenmoGmailConnectError, VenmoGmailConnectResult } from '@zkp2p/sdk';
 import { z } from 'zod';
 import '@relayprotocol/relay-sdk';
 
@@ -258,7 +258,7 @@ declare function buildIntentAmountRange(amount: bigint): {
  * arrays with signal-time oracle configs. Alipay/CNY and UPI/INR instead fix
  * fresh Chainlink snapshots from Ethereum and Polygon as their maker floors.
  */
-declare function prepareCashDepositParams(client: Zkp2pClient, input: CashDepositInput, adapters?: OracleAdapterOverrides, creationRateReader?: CreationRateReader, features?: CashCatalogFeatures): Promise<CreateDepositParamsArg>;
+declare function prepareCashDepositParams(client: Zkp2pClient, input: CashDepositInput, adapters?: OracleAdapterOverrides, creationRateReader?: CreationRateReader): Promise<CreateDepositParamsArg>;
 
 /**
  * Whether a signaled fill can still be completed by its buyer. Uses the
@@ -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 CashCatalogFeatures, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, j as CashFillStats, N as NearIntentsSourceCapabilities, k as NearIntentsDepositInput, l as NearIntentsQuote, m as NearIntentsQuoteInput, n as NearIntentsStatus, o as NearIntentsStatusInput, P as PrepareResult, p as CashPreparedStep, R as RelayExecutionResult, q as RelayQuote, r as RelayStatus, s as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-ECL3HN5H.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 CashFeatureFlags, H as CashFillEta, J as CashLeg, K as CashMultiCurrencyLeg, L as CashNextAction, M as CashOrderState, O as CashPairFillStats, Q as CashPayeeInput, S as CashPayout, U as CashPayoutPricing, V as CashPlatformCapability, X as CashPreparedStepKind, Y as CashReceiveLeg, Z as CashoutInput, _ as CashoutOptions, $ as CuratorPayeeDataInput, a0 as EstimateInput, a1 as EstimateOptions, a2 as MARKET_SPREAD_BPS, a3 as MIN_CASHOUT_AMOUNT, a4 as NEAR_INTENTS_API_URL, a5 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a6 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a7 as NEAR_INTENTS_STATUSES, a8 as NearIntentsClient, a9 as NearIntentsOptions, aa as NearIntentsQuoteRequest, ab as NearIntentsStatusCode, ac as NearIntentsToken, ad as NearIntentsTradeType, ae as NearIntentsTransaction, af as ORACLE_MIN_CONVERSION_RATE_SENTINEL, ag as OrdersOptions, ah as PreparedCashoutReceipt, ai as RECOMMENDED_MIN_CASHOUT_AMOUNT, aj as RelayOptions, ak as RelayQuoteInput, al as RelaySourceInput, am as RelayTransaction, an as SignerOptions, ao as USDC_DECIMALS, ap as WatchOptions, aq as WithdrawOptions, ar as buildCapabilities, as as createCashClient, at as createNearIntentsClient, au as normalizeCashPayee, av as quoteNearIntentsToBaseUsdc, aw as readNearIntentsSourceCapabilities, ax as readNearIntentsStatus, ay as submitNearIntentsDeposit, az as toCashReferralAttributionCode } from './createCashClient-ECL3HN5H.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-CZgoTClw.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-CZgoTClw.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, VenmoGmailConnectError, VenmoGmailConnectResult } from '@zkp2p/sdk';
 import { z } from 'zod';
 import '@relayprotocol/relay-sdk';
 
@@ -258,7 +258,7 @@ declare function buildIntentAmountRange(amount: bigint): {
  * arrays with signal-time oracle configs. Alipay/CNY and UPI/INR instead fix
  * fresh Chainlink snapshots from Ethereum and Polygon as their maker floors.
  */
-declare function prepareCashDepositParams(client: Zkp2pClient, input: CashDepositInput, adapters?: OracleAdapterOverrides, creationRateReader?: CreationRateReader, features?: CashCatalogFeatures): Promise<CreateDepositParamsArg>;
+declare function prepareCashDepositParams(client: Zkp2pClient, input: CashDepositInput, adapters?: OracleAdapterOverrides, creationRateReader?: CreationRateReader): Promise<CreateDepositParamsArg>;
 
 /**
  * Whether a signaled fill can still be completed by its buyer. Uses the
@@ -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';
@@ -120,14 +121,8 @@ async function readCashCreationRate(publicClient, platform, currency, nowSeconds
 async function readAlipayCnyCreationRate(publicClient, nowSeconds = Math.floor(Date.now() / 1e3)) {
   return readCashCreationRate(publicClient, "alipay", "CNY", nowSeconds);
 }
-function getCashPaymentMethodsCatalog(environment, features = {}) {
-  const catalog = getPaymentMethodsCatalog(8453, environment);
-  if ((environment === "staging" || environment === "preproduction") && features.upi === true) {
-    return catalog;
-  }
-  const enabledCatalog = { ...catalog };
-  delete enabledCatalog.upi;
-  return enabledCatalog;
+function getCashPaymentMethodsCatalog(environment) {
+  return getPaymentMethodsCatalog(8453, environment);
 }
 function resolveCashPaymentMethodHash(processorName, catalog) {
   if (processorName.trim().toLowerCase() === "upi" && !catalog.upi) {
@@ -170,12 +165,12 @@ function buildIntentAmountRange(amount) {
   const min = amount < DEFAULT_MIN_ORDER_FLOOR ? amount : DEFAULT_MIN_ORDER_FLOOR;
   return { min, max: amount };
 }
-async function prepareCashDepositParams(client, input, adapters, creationRateReader, features) {
+async function prepareCashDepositParams(client, input, adapters, creationRateReader) {
   const { payouts } = input;
   if (!payouts.length) throw new Error("At least one payout is required");
   const chainId = client.chainId;
   const runtimeEnv = client.runtimeEnv;
-  const catalog = getCashPaymentMethodsCatalog(runtimeEnv, features);
+  const catalog = getCashPaymentMethodsCatalog(runtimeEnv);
   const intentGatingService = getGatingServiceAddress(chainId, runtimeEnv);
   const processorNames = payouts.map((p) => p.processorName);
   const paymentMethodsOverride = processorNames.map(
@@ -611,8 +606,8 @@ var IDENTITY_ATTESTATION_PLATFORMS = /* @__PURE__ */ new Set(["wise", "paypal",
 function platformRequiresIdentityAttestation(platform) {
   return IDENTITY_ATTESTATION_PLATFORMS.has(platform.toLowerCase());
 }
-function buildCapabilities(environment, features = {}) {
-  const catalog = getCashPaymentMethodsCatalog(environment, features);
+function buildCapabilities(environment) {
+  const catalog = getCashPaymentMethodsCatalog(environment);
   const platforms = Object.entries(catalog).map(([platform, entry]) => {
     const currencies2 = (entry.currencies ?? []).map((hash) => getCurrencyCodeFromHash(hash)).filter(
       (code) => code != null && (isMarketRateSupported(code) || isCreationRateCorridor(platform, code))
@@ -1978,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";
@@ -2368,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)"
 ]);
@@ -2419,8 +2425,8 @@ async function submitAndConfirm(client, verb, send) {
 function isKnownPreBroadcastFailure(mapped) {
   return mapped.code === "TRANSACTION_REJECTED" || mapped.code === "INSUFFICIENT_TOKEN_BALANCE" || mapped.code === "ALLOWANCE_NOT_VISIBLE" || mapped.code === "ESCROW_PAUSED";
 }
-function cashoutAccessPolicyPaymentMethods(depositInput, environment, features) {
-  const catalog = getCashPaymentMethodsCatalog(environment, features);
+function cashoutAccessPolicyPaymentMethods(depositInput, environment) {
+  const catalog = getCashPaymentMethodsCatalog(environment);
   return [
     ...new Set(
       depositInput.payouts.filter((payout) => CASH_RESTRICTED_PLATFORMS.has(payout.processorName.toLowerCase())).map((payout) => resolveCashPaymentMethodHash(payout.processorName, catalog))
@@ -2517,7 +2523,7 @@ function createCashClient(options) {
     if (legs.length === 0) {
       throw errors.invalidPayoutPlatforms("at least one payout leg is required");
     }
-    const capabilities2 = buildCapabilities(environment, options.features);
+    const capabilities2 = buildCapabilities(environment);
     const seenPlatforms = /* @__PURE__ */ new Set();
     const payouts = legs.map((leg) => {
       const platform = capabilities2.platforms.find(
@@ -2598,8 +2604,7 @@ function createCashClient(options) {
           } catch (err) {
             throw errors.oracleReadFailed(currency, err);
           }
-        },
-        options.features
+        }
       );
     } catch (err) {
       if (isCashError(err)) throw err;
@@ -2651,7 +2656,7 @@ function createCashClient(options) {
     const payouts = derivePayouts(
       deposit.paymentMethods ?? [],
       deposit.currencies ?? [],
-      getCashPaymentMethodsCatalog(environment, options.features)
+      getCashPaymentMethodsCatalog(environment)
     );
     let attributedToCash = false;
     if (!isCashPayoutSet(payouts)) {
@@ -2709,7 +2714,7 @@ function createCashClient(options) {
     return escrowContext(depositId);
   }
   function capabilities(capabilityOptions) {
-    const baseCapabilities = buildCapabilities(environment, options.features);
+    const baseCapabilities = buildCapabilities(environment);
     if (!capabilityOptions?.includeRelaySources && !capabilityOptions?.includeNearIntentsSources) {
       return baseCapabilities;
     }
@@ -2887,11 +2892,7 @@ function createCashClient(options) {
   }
   async function configureCashoutAccess(client, signer, depositInput, depositId, source) {
     const groupIds = CASH_ACCESS_GROUP_IDS[environment];
-    const paymentMethods = cashoutAccessPolicyPaymentMethods(
-      depositInput,
-      environment,
-      options.features
-    );
+    const paymentMethods = cashoutAccessPolicyPaymentMethods(depositInput, environment);
     const hashes = [];
     for (const paymentMethod of paymentMethods) {
       const prepared = prepareCashoutAccess(depositId, paymentMethod, client, source);
@@ -2935,6 +2936,31 @@ 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({
+        payeeDetails,
+        peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
+      });
+      return { payeeDetails, url };
+    },
+    openVenmoGmailConnect(payeeDetails) {
+      return openVenmoGmailConnect({
+        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);
@@ -3197,8 +3223,7 @@ function createCashClient(options) {
       const hashedOnchainIds = (params.paymentMethodDataOverride ?? []).map((d) => d.payeeDetails);
       const accessPolicyPaymentMethods = cashoutAccessPolicyPaymentMethods(
         depositInput,
-        environment,
-        options.features
+        environment
       );
       return {
         txs: [approve, prepared],
@@ -3269,7 +3294,7 @@ function createCashClient(options) {
       } catch (err) {
         throw errors.indexerUnavailable("orders", err);
       }
-      const catalog = getCashPaymentMethodsCatalog(environment, options.features);
+      const catalog = getCashPaymentMethodsCatalog(environment);
       let attributedCashDeposits = /* @__PURE__ */ new Set();
       const fixedRateCandidates = deposits.filter((deposit) => {
         const payouts = derivePayouts(
@@ -4019,5 +4044,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 { D as CashClient, a0 as EstimateInput, i as CashEstimate, _ as CashoutOptions, h as CashoutResult, Z as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-ECL3HN5H.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-CZgoTClw.cjs';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { D as CashClient, a0 as EstimateInput, i as CashEstimate, _ as CashoutOptions, h as CashoutResult, Z as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-ECL3HN5H.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-CZgoTClw.js';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/tools.cjs

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

package/dist/tools.js

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

package/docs/partner-integrations.md

@@ -139,3 +139,20 @@ 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`.

package/examples/upi-staging-cashout.ts

@@ -9,7 +9,6 @@ export async function cashOutToUpi(
 ) {
   const cash = createCashClient({
     environment,
-    features: { upi: true },
   });
 
   const upi = cash.capabilities().platforms.find(({ platform }) => platform === 'upi');

package/examples/venmo-link.ts

@@ -0,0 +1,33 @@
+import {
+  createCashClient,
+  VenmoGmailConnectError,
+  type PreparedVenmoGmailConnect,
+} from '@zkp2p/cash';
+
+/** Optional onboarding: call with the selected handle before enabling the link button. */
+export async function prepareVenmoLink(handle: string) {
+  const cash = createCashClient({ environment: 'production' });
+  return cash.prepareVenmoGmailConnect(handle);
+}
+
+/** Bind this to a click. Keep registration/other awaits outside the handler. */
+export function linkVenmo(link: PreparedVenmoGmailConnect) {
+  const cash = createCashClient({ environment: 'production' });
+  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) {
+  const cash = createCashClient({ environment: 'production' });
+  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,17 @@
 
 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.
+
 - 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;
@@ -38,8 +49,8 @@ Key facts:
   fillStats() separately.
 - capabilities() exposes one Zelle platform. A zelle cashout attaches only the
   generic Zelle payment method to the on-chain deposit.
-- UPI/INR is staging/preproduction-only and fail-closed. Enable it with
-  `createCashClient({ environment: 'preproduction', features: { upi: true } })`.
+- UPI/INR is available without feature flags. For example, use
+  `createCashClient({ environment: 'preproduction' })`.
   Any valid UPI ID from any bank can receive without a seller login,
   extension, identity attestation, or prior registration flow. Buyers
   pay and verify through Amazon Pay using standard UPI.
@@ -136,4 +147,4 @@ read-only RPC with `upiCreationRateRpcUrl` or `upiCreationRateTransport`.
 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 remains opt-in on staging/preproduction and disabled in production.
+UPI is available in production, preproduction, and staging without a feature flag.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/cash",
-  "version": "0.5.4-rc.2",
+  "version": "0.6.0",
   "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-rc.4",
     "zod": "^4.4.3"
   },
   "peerDependencies": {

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

@@ -183,8 +183,7 @@ platforms outright: a previously registered handle can be reused with bare
 payee data. Handle `PAYEE_VERIFICATION_REQUIRED` when registration is still
 needed.
 
-UPI is a staging/preproduction-only opt-in while production rollout awaits review. Enable it
-with `features: { upi: true }` on a staging or preproduction client. Accept any locally valid
+UPI is available on production, preproduction, and staging clients without feature flags. Accept any locally valid
 UPI ID from any bank; do not add a seller bank-login, extension, identity
 attestation, or pre-registration step. Buyers pay and verify through Amazon Pay using standard UPI; UPI Lite and
 merchant payments are unsupported.
@@ -273,7 +272,7 @@ read-only RPC with `upiCreationRateRpcUrl` or `upiCreationRateTransport`.
 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 remains opt-in on staging/preproduction and disabled in production.
+UPI is available in production, preproduction, and staging without a feature flag.
 
 Before a funded UPI QA run, call
 `cash.estimate({ amount: 1000000n, platform: 'upi', currency: 'INR' }, { includeEta: false })`
@@ -283,3 +282,20 @@ 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`.

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

@@ -6,9 +6,8 @@ description: Verify the Cash SDK Amazon Pay UPI corridor on preproduction, inclu
 # UPI preproduction QA
 
 Use the exact published Cash candidate and record its SDK/contracts versions.
-Require `createCashClient({ environment: 'preproduction', features: { upi: true } })`
-to advertise UPI/INR. Without the flag, and in production even with the flag,
-UPI must be absent and unsigned preparation must reject before registration or rate reads.
+Require `createCashClient({ environment: 'preproduction' })` to advertise UPI/INR.
+UPI is available without feature flags in every environment.
 The canonical contracts catalog must contain the live UPI method and INR currency;
 never invent a catalog entry when the package or registry omits one.
 
@@ -19,13 +18,10 @@ any transaction:
 import { createCashClient } from '@zkp2p/cash';
 
 for (const environment of ['staging', 'preproduction', 'production'] as const) {
-  for (const upi of [false, true]) {
-    const client = createCashClient({ environment, features: { upi } });
-    const method = client.capabilities().platforms.find((item) => item.platform === 'upi');
-    const expected = upi && environment !== 'production';
-    if (Boolean(method?.currencies.includes('INR')) !== expected) {
-      throw new Error(`Unexpected UPI catalog for ${environment}, flag=${upi}`);
-    }
+  const client = createCashClient({ environment });
+  const method = client.capabilities().platforms.find((item) => item.platform === 'upi');
+  if (!method?.currencies.includes('INR')) {
+    throw new Error(`Missing UPI catalog for ${environment}`);
   }
 }
 ```
@@ -63,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