@zkp2p/cash 0.6.0 → 0.6.2

package/AGENTS.md

@@ -353,9 +353,15 @@ button click. Re-prepare when the selected handle changes. Use
 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`.
+For native apps, use `prepareVenmoGmailConnect(handle, { returnUrl })` and
+open `link.url` with Expo's `openAuthSessionAsync(link.url, returnUrl)`.
+Register the scheme in your app binary; no registration with Peer is needed.
+Peer appends no data to the callback. Omitted/empty callbacks attempt closure;
+tabs that block it keep the success page. Always re-check status on return.
+
+The hosted flow verifies actual Venmo receipts, including Google-hosted custom
+inboxes. `VenmoGmailConnectError` is separate from `CashError`; no emails or
+Google tokens reach the partner. Configure `venmoGmail: { appearance, popup }`
+for branding and desktop dimensions; omission keeps Peer defaults.
+See the README for error codes, native callbacks, package-free URLs, and
+customization, plus `examples/venmo-link.ts`.

package/README.md

@@ -144,7 +144,7 @@ arbitrary protocol operations.
 
 | Verb                                                           | What it does                                                                                                                    |
 | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `prepareVenmoGmailConnect(payee)`                              | Optional Venmo handle registration; returns the payee hash and hosted URL                                                       |
+| `prepareVenmoGmailConnect(payee, { returnUrl }?)`              | Optional Venmo handle registration; returns the payee hash and hosted URL, with an optional app callback                        |
 | `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                      |
@@ -239,6 +239,83 @@ 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`.
 
+### Return to an Expo / React Native app
+
+Cash `0.6.2` supports an optional callback on the prepared URL. The popup
+helper is browser-only; native apps open the URL using their system browser
+session:
+
+```ts
+import { createCashClient } from '@zkp2p/cash';
+import * as WebBrowser from 'expo-web-browser';
+
+const cash = createCashClient({ environment: 'production' });
+const returnUrl = 'partner-app://venmo-linked';
+const link = await cash.prepareVenmoGmailConnect('@yourhandle', { returnUrl });
+await WebBrowser.openAuthSessionAsync(link.url, returnUrl);
+const connected = await cash.isVenmoGmailConnected(link.payeeDetails);
+```
+
+Register the callback scheme in your app binary and test on iOS and Android;
+see [Expo's callback requirements](https://docs.expo.dev/versions/latest/sdk/webbrowser/#webbrowseropenauthsessionasyncurl-redirecturl-options).
+Peer requires no callback registration or deployment configuration. After
+verification, the hosted page navigates to `returnUrl` unchanged: no Google
+credentials, email, account hash, or status are appended. Errors remain on
+the page with a manual return button. Always re-check connection status on
+return or dismissal; a browser return alone is not proof of linking.
+
+Preparation and status checks can stay on your backend. If it already has
+`payeeDetails`, your app needs no Cash package:
+
+```ts
+const connectUrl = new URL('https://app.peer.xyz/connect/venmo');
+connectUrl.searchParams.set('returnUrl', returnUrl);
+connectUrl.hash = payeeDetails;
+await WebBrowser.openAuthSessionAsync(connectUrl.toString(), returnUrl);
+// Re-check seller-credential/status through your backend.
+```
+
+Without a callback, or with an empty one, the hosted page attempts to close
+after verification. Script-opened desktop popups can close; mobile tabs that
+block closure retain the success page for manual dismissal.
+
+### Customize the hosted popup
+
+With `@zkp2p/cash@0.6.1`, configure branding once on the client. The same
+appearance is used by `link.url` and `openVenmoGmailConnect()`.
+
+```ts
+const cash = createCashClient({
+  environment: 'production',
+  venmoGmail: {
+    appearance: {
+      logoUrl: 'https://your-app.example/logo.png',
+      logoAlt: 'Your app',
+      backgroundColor: '#FFFFFF',
+      textColor: '#172033',
+      secondaryTextColor: '#636B7A',
+      buttonColor: '#6246EA',
+      buttonTextColor: '#FFFFFF',
+      fontFamily: 'Inter, sans-serif',
+      headingTextTransform: 'none',
+      buttonTextTransform: 'none',
+      buttonBorderRadius: 12,
+      buttonHeight: 52,
+    },
+    popup: { width: 500, height: 620 },
+  },
+});
+```
+
+Your hosted logo appears beside Venmo with three connecting dots. Without a
+partner logo, the page shows Peer beside Venmo. Colors use
+hex values and dimensions use pixels. Optional `fontUrl` accepts a hosted
+WOFF/WOFF2 font with cross-origin loading enabled. Popup dimensions apply to
+desktop; mobile browsers control the new tab's size. Styling never changes
+consent, account selection, or receipt verification.
+
+See the [full appearance options](https://www.npmjs.com/package/@zkp2p/sdk#popup-customization).
+
 ## Payout rails and access policies
 
 | Payout rail           | Access-policy behavior                                                     | New payee registration                                                                 |

package/dist/{createCashClient-CZgoTClw.d.cts → createCashClient-p7RZVUmC.d.cts}

@@ -1,5 +1,5 @@
 import { Address, Hash, WalletClient, Hex, Log, Transport } from 'viem';
-import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectResult } from '@zkp2p/sdk';
+import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectResult, VenmoGmailAppearance, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { Execute, RelayClient, RelayChain, ProgressData } from '@relayprotocol/relay-sdk';
 
 /**
@@ -684,6 +684,11 @@ interface CashClientOptions {
     curatorUrl?: string;
     /** Peer web origin override for optional Venmo receipt linking. Defaults by environment. */
     peerOrigin?: string;
+    /** Optional branding shared by prepared URLs and browser linking. Never affects cash-out. */
+    venmoGmail?: {
+        appearance?: VenmoGmailAppearance;
+        popup?: VenmoGmailPopupOptions;
+    };
     /** Optional ZKP2P API key. */
     apiKey?: string;
     /** Ethereum transport used only to snapshot Alipay/CNY's creation-time rate. */
@@ -856,8 +861,10 @@ interface OrdersOptions {
     limit?: number;
 }
 interface CashClient {
-    /** Optional: register the Venmo handle before enabling a separate link button. No deposit. */
-    prepareVenmoGmailConnect(payee: string): Promise<PreparedVenmoGmailConnect>;
+    /** Register a Venmo handle and prepare a hosted URL, optionally returning to a native app. No deposit. */
+    prepareVenmoGmailConnect(payee: string, options?: {
+        returnUrl?: 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. */

package/dist/{createCashClient-CZgoTClw.d.ts → createCashClient-p7RZVUmC.d.ts}

@@ -1,5 +1,5 @@
 import { Address, Hash, WalletClient, Hex, Log, Transport } from 'viem';
-import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectResult } from '@zkp2p/sdk';
+import { IndexerIntentStatus, Zkp2pClient, IndexerIntent, CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectResult, VenmoGmailAppearance, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { Execute, RelayClient, RelayChain, ProgressData } from '@relayprotocol/relay-sdk';
 
 /**
@@ -684,6 +684,11 @@ interface CashClientOptions {
     curatorUrl?: string;
     /** Peer web origin override for optional Venmo receipt linking. Defaults by environment. */
     peerOrigin?: string;
+    /** Optional branding shared by prepared URLs and browser linking. Never affects cash-out. */
+    venmoGmail?: {
+        appearance?: VenmoGmailAppearance;
+        popup?: VenmoGmailPopupOptions;
+    };
     /** Optional ZKP2P API key. */
     apiKey?: string;
     /** Ethereum transport used only to snapshot Alipay/CNY's creation-time rate. */
@@ -856,8 +861,10 @@ interface OrdersOptions {
     limit?: number;
 }
 interface CashClient {
-    /** Optional: register the Venmo handle before enabling a separate link button. No deposit. */
-    prepareVenmoGmailConnect(payee: string): Promise<PreparedVenmoGmailConnect>;
+    /** Register a Venmo handle and prepare a hosted URL, optionally returning to a native app. No deposit. */
+    prepareVenmoGmailConnect(payee: string, options?: {
+        returnUrl?: 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. */

package/dist/index.cjs

@@ -3429,13 +3429,15 @@ function createCashClient(options) {
     return hashes;
   }
   return {
-    async prepareVenmoGmailConnect(payee) {
+    async prepareVenmoGmailConnect(payee, connectOptions) {
       const { hashedOnchainIds } = await readClient.registerPayeeDetails({
         processorNames: ["venmo"],
         payeeData: [normalizeCashPayee("venmo", payee)]
       });
       const payeeDetails = hashedOnchainIds[0];
       const url = sdk.getVenmoGmailConnectUrl({
+        ...options.venmoGmail,
+        ...connectOptions,
         payeeDetails,
         peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
       });
@@ -3443,6 +3445,7 @@ function createCashClient(options) {
     },
     openVenmoGmailConnect(payeeDetails) {
       return sdk.openVenmoGmailConnect({
+        ...options.venmoGmail,
         payeeDetails,
         peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
       });

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, 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 { 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-p7RZVUmC.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-p7RZVUmC.cjs';
 import { PublicClient, Log, Abi } from 'viem';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction, VenmoGmailConnectResult } from '@zkp2p/sdk';
-export { CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectError, VenmoGmailConnectResult } from '@zkp2p/sdk';
+export { CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailAppearance, VenmoGmailConnectError, VenmoGmailConnectResult, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { z } from 'zod';
 import '@relayprotocol/relay-sdk';
 

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, 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 { 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-p7RZVUmC.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-p7RZVUmC.js';
 import { PublicClient, Log, Abi } from 'viem';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction, VenmoGmailConnectResult } from '@zkp2p/sdk';
-export { CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailConnectError, VenmoGmailConnectResult } from '@zkp2p/sdk';
+export { CurrencyType, PreparedTransaction, RuntimeEnv, VenmoGmailAppearance, VenmoGmailConnectError, VenmoGmailConnectResult, VenmoGmailPopupOptions } from '@zkp2p/sdk';
 import { z } from 'zod';
 import '@relayprotocol/relay-sdk';
 

package/dist/index.js

@@ -2936,13 +2936,15 @@ function createCashClient(options) {
     return hashes;
   }
   return {
-    async prepareVenmoGmailConnect(payee) {
+    async prepareVenmoGmailConnect(payee, connectOptions) {
       const { hashedOnchainIds } = await readClient.registerPayeeDetails({
         processorNames: ["venmo"],
         payeeData: [normalizeCashPayee("venmo", payee)]
       });
       const payeeDetails = hashedOnchainIds[0];
       const url = getVenmoGmailConnectUrl({
+        ...options.venmoGmail,
+        ...connectOptions,
         payeeDetails,
         peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
       });
@@ -2950,6 +2952,7 @@ function createCashClient(options) {
     },
     openVenmoGmailConnect(payeeDetails) {
       return openVenmoGmailConnect({
+        ...options.venmoGmail,
         payeeDetails,
         peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
       });

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-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 { 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-p7RZVUmC.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, $ 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 { 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-p7RZVUmC.js';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/tools.cjs

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

package/dist/tools.js

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

package/docs/partner-integrations.md

@@ -150,9 +150,15 @@ button click. Re-prepare when the selected handle changes. Use
 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`.
+For native apps, use `prepareVenmoGmailConnect(handle, { returnUrl })` and
+open `link.url` with Expo's `openAuthSessionAsync(link.url, returnUrl)`.
+Register the scheme in your app binary; no registration with Peer is needed.
+Peer appends no data to the callback. Omitted/empty callbacks attempt closure;
+tabs that block it keep the success page. Always re-check status on return.
+
+The hosted flow verifies actual Venmo receipts, including Google-hosted custom
+inboxes. `VenmoGmailConnectError` is separate from `CashError`; no emails or
+Google tokens reach the partner. Configure `venmoGmail: { appearance, popup }`
+for branding and desktop dimensions; omission keeps Peer defaults.
+See the README for error codes, native callbacks, package-free URLs, and
+customization, plus `examples/venmo-link.ts`.

package/examples/onchain-demo/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "description": "Peer Cash Demo: the express sell flow stored entirely onchain on Base, after zSwap by z0r0z",
   "dependencies": {
-    "@zkp2p/cash": "0.5.3",
+    "@zkp2p/cash": "0.6.1",
     "esbuild": "0.28.2",
     "solc": "0.8.36",
     "viem": "2.55.18"

package/examples/onchain-demo/src/stubs/viem-chains.mjs

@@ -1,7 +1,8 @@
 // Slim stand-in for viem/chains. The full catalog is ~700 chain definitions
 // (~250 KB minified) and every byte of this page is paid for in deploy gas;
-// the app and its SDKs only ever import these two.
+// the app and its SDKs only ever import these.
 export { base } from '../../node_modules/viem/_esm/chains/definitions/base.js';
 export { hardhat } from '../../node_modules/viem/_esm/chains/definitions/hardhat.js';
 export { mainnet } from '../../node_modules/viem/_esm/chains/definitions/mainnet.js';
+export { polygon } from '../../node_modules/viem/_esm/chains/definitions/polygon.js';
 export { sepolia } from '../../node_modules/viem/_esm/chains/definitions/sepolia.js';

package/examples/venmo-link.ts

@@ -4,15 +4,27 @@ import {
   type PreparedVenmoGmailConnect,
 } from '@zkp2p/cash';
 
+const cash = createCashClient({
+  environment: 'production',
+  // Optional: omit venmoGmail for Peer branding and the default popup size.
+  venmoGmail: {
+    appearance: { buttonColor: '#6246EA', buttonTextColor: '#FFFFFF' },
+    popup: { width: 500, height: 620 },
+  },
+});
+
 /** Optional onboarding: call with the selected handle before enabling the link button. */
 export async function prepareVenmoLink(handle: string) {
-  const cash = createCashClient({ environment: 'production' });
   return cash.prepareVenmoGmailConnect(handle);
 }
 
+/** Native: open link.url with expo-web-browser's openAuthSessionAsync(url, returnUrl). */
+export async function prepareNativeVenmoLink(handle: string, returnUrl: string) {
+  return cash.prepareVenmoGmailConnect(handle, { returnUrl });
+}
+
 /** 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.
@@ -25,7 +37,6 @@ export function linkVenmo(link: PreparedVenmoGmailConnect) {
 
 /** 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);
 }
 

package/llms.txt

@@ -17,11 +17,18 @@ Key facts:
   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.
+  Native hosts use prepareVenmoGmailConnect(handle, { returnUrl }) and open
+  link.url with Expo openAuthSessionAsync(link.url, returnUrl). Register the
+  app scheme in the binary; Peer needs no callback registration and appends
+  no data. Omitted/empty callbacks attempt closure; blocked tabs keep the
+  success page. Always check status on return or ambiguous popup closure.
   Google-hosted school/custom domains are supported; actual receipt failures
   use VenmoGmailConnectError.code, including venmo_google_oauth_receipt_not_found.
   Partner apps receive neither emails nor Google tokens. Re-prepare when the
   handle changes; persist payee hash with environment and user account.
+  Optional createCashClient({ venmoGmail: { appearance, popup } }) shares branding
+  between the prepared URL and popup. Defaults use Peer branding; desktop popup
+  dimensions do not control mobile tab sizing. See the README customization example.
 
 - The cashing-out user is the MAKER: their USDC becomes a protocol-held order;
   a buyer pays fiat and proves it with TEE-TLS; the protocol releases the USDC.

package/package.json

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

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

@@ -293,9 +293,15 @@ button click. Re-prepare when the selected handle changes. Use
 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`.
+For native apps, use `prepareVenmoGmailConnect(handle, { returnUrl })` and
+open `link.url` with Expo's `openAuthSessionAsync(link.url, returnUrl)`.
+Register the scheme in your app binary; no registration with Peer is needed.
+Peer appends no data to the callback. Omitted/empty callbacks attempt closure;
+tabs that block it keep the success page. Always re-check status on return.
+
+The hosted flow verifies actual Venmo receipts, including Google-hosted custom
+inboxes. `VenmoGmailConnectError` is separate from `CashError`; no emails or
+Google tokens reach the partner. Configure `venmoGmail: { appearance, popup }`
+for branding and desktop dimensions; omission keeps Peer defaults.
+See the README for error codes, native callbacks, package-free URLs, and
+customization, plus `examples/venmo-link.ts`.