@zkp2p/cash 0.6.1 → 0.6.2

package/AGENTS.md

@@ -353,15 +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`.
-
-Configure optional `venmoGmail: { appearance, popup }` on `createCashClient()`
-to share partner branding between the prepared URL and popup. Omit it for Peer
-branding; omit `appearance.logoUrl` to keep the Peer logo beside Venmo. Popup
-width/height apply to desktop; mobile browsers control tab sizing. See the
-README's "Customize the hosted popup" section for the configuration example.
+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,46 @@ 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

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

@@ -861,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-LTZshulP.d.ts → createCashClient-p7RZVUmC.d.ts}

@@ -861,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,7 +3429,7 @@ function createCashClient(options) {
     return hashes;
   }
   return {
-    async prepareVenmoGmailConnect(payee) {
+    async prepareVenmoGmailConnect(payee, connectOptions) {
       const { hashedOnchainIds } = await readClient.registerPayeeDetails({
         processorNames: ["venmo"],
         payeeData: [normalizeCashPayee("venmo", payee)]
@@ -3437,6 +3437,7 @@ function createCashClient(options) {
       const payeeDetails = hashedOnchainIds[0];
       const url = sdk.getVenmoGmailConnectUrl({
         ...options.venmoGmail,
+        ...connectOptions,
         payeeDetails,
         peerOrigin: options.peerOrigin ?? DEFAULT_PEER_ORIGINS[environment]
       });

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, p as PreparedVenmoGmailConnect, R as RelayExecutionResult, q as RelayQuote, r as RelayStatus, s as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-LTZshulP.cjs';
-export { B as BASE_CHAIN_ID, t as BASE_USDC_ADDRESS, u as CASH_ATTRIBUTION_CODE, v as CASH_ORDER_POLL_INTERVAL_MS, w as CASH_ORDER_STATUSES, x as CASH_REFERRAL_ATTRIBUTION_PREFIX, y as CASH_RETAIN_ON_EMPTY, z as CashAsset, A as CashChain, D as CashClient, E as CashClientOptions, F as CashCorridorPricing, G as CashFillEta, H as CashLeg, J as CashMultiCurrencyLeg, K as CashNextAction, L as CashOrderState, M as CashPairFillStats, O as CashPayeeInput, Q as CashPayout, S as CashPayoutPricing, U as CashPlatformCapability, V as CashPreparedStepKind, X as CashReceiveLeg, Y as CashoutInput, Z as CashoutOptions, _ as CuratorPayeeDataInput, $ as EstimateInput, a0 as EstimateOptions, a1 as MARKET_SPREAD_BPS, a2 as MIN_CASHOUT_AMOUNT, a3 as NEAR_INTENTS_API_URL, a4 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a5 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a6 as NEAR_INTENTS_STATUSES, a7 as NearIntentsClient, a8 as NearIntentsOptions, a9 as NearIntentsQuoteRequest, aa as NearIntentsStatusCode, ab as NearIntentsToken, ac as NearIntentsTradeType, ad as NearIntentsTransaction, ae as ORACLE_MIN_CONVERSION_RATE_SENTINEL, af as OrdersOptions, ag as PreparedCashoutReceipt, ah as RECOMMENDED_MIN_CASHOUT_AMOUNT, ai as RelayOptions, aj as RelayQuoteInput, ak as RelaySourceInput, al as RelayTransaction, am as SignerOptions, an as USDC_DECIMALS, ao as WatchOptions, ap as WithdrawOptions, aq as buildCapabilities, ar as createCashClient, as as createNearIntentsClient, at as normalizeCashPayee, au as quoteNearIntentsToBaseUsdc, av as readNearIntentsSourceCapabilities, aw as readNearIntentsStatus, ax as submitNearIntentsDeposit, ay as toCashReferralAttributionCode } from './createCashClient-LTZshulP.cjs';
+import { 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, VenmoGmailAppearance, VenmoGmailConnectError, VenmoGmailConnectResult, VenmoGmailPopupOptions } from '@zkp2p/sdk';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CashPayoutInfo, I as IntentEntity, a as CashBuyerProfile, b as CashDepositInput, c as CreateDepositParamsArg, d as CashOrder, e as CashFill, f as CashCapabilities, g as CashoutResult, h as CashEstimate, i as CashFillStats, N as NearIntentsSourceCapabilities, j as NearIntentsDepositInput, k as NearIntentsQuote, l as NearIntentsQuoteInput, m as NearIntentsStatus, n as NearIntentsStatusInput, P as PrepareResult, o as CashPreparedStep, p as PreparedVenmoGmailConnect, R as RelayExecutionResult, q as RelayQuote, r as RelayStatus, s as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-LTZshulP.js';
-export { B as BASE_CHAIN_ID, t as BASE_USDC_ADDRESS, u as CASH_ATTRIBUTION_CODE, v as CASH_ORDER_POLL_INTERVAL_MS, w as CASH_ORDER_STATUSES, x as CASH_REFERRAL_ATTRIBUTION_PREFIX, y as CASH_RETAIN_ON_EMPTY, z as CashAsset, A as CashChain, D as CashClient, E as CashClientOptions, F as CashCorridorPricing, G as CashFillEta, H as CashLeg, J as CashMultiCurrencyLeg, K as CashNextAction, L as CashOrderState, M as CashPairFillStats, O as CashPayeeInput, Q as CashPayout, S as CashPayoutPricing, U as CashPlatformCapability, V as CashPreparedStepKind, X as CashReceiveLeg, Y as CashoutInput, Z as CashoutOptions, _ as CuratorPayeeDataInput, $ as EstimateInput, a0 as EstimateOptions, a1 as MARKET_SPREAD_BPS, a2 as MIN_CASHOUT_AMOUNT, a3 as NEAR_INTENTS_API_URL, a4 as NEAR_INTENTS_BASE_USDC_ASSET_ID, a5 as NEAR_INTENTS_DEFAULT_SLIPPAGE_BPS, a6 as NEAR_INTENTS_STATUSES, a7 as NearIntentsClient, a8 as NearIntentsOptions, a9 as NearIntentsQuoteRequest, aa as NearIntentsStatusCode, ab as NearIntentsToken, ac as NearIntentsTradeType, ad as NearIntentsTransaction, ae as ORACLE_MIN_CONVERSION_RATE_SENTINEL, af as OrdersOptions, ag as PreparedCashoutReceipt, ah as RECOMMENDED_MIN_CASHOUT_AMOUNT, ai as RelayOptions, aj as RelayQuoteInput, ak as RelaySourceInput, al as RelayTransaction, am as SignerOptions, an as USDC_DECIMALS, ao as WatchOptions, ap as WithdrawOptions, aq as buildCapabilities, ar as createCashClient, as as createNearIntentsClient, at as normalizeCashPayee, au as quoteNearIntentsToBaseUsdc, av as readNearIntentsSourceCapabilities, aw as readNearIntentsStatus, ax as submitNearIntentsDeposit, ay as toCashReferralAttributionCode } from './createCashClient-LTZshulP.js';
+import { 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, VenmoGmailAppearance, VenmoGmailConnectError, VenmoGmailConnectResult, VenmoGmailPopupOptions } from '@zkp2p/sdk';

package/dist/index.js

@@ -2936,7 +2936,7 @@ function createCashClient(options) {
     return hashes;
   }
   return {
-    async prepareVenmoGmailConnect(payee) {
+    async prepareVenmoGmailConnect(payee, connectOptions) {
       const { hashedOnchainIds } = await readClient.registerPayeeDetails({
         processorNames: ["venmo"],
         payeeData: [normalizeCashPayee("venmo", payee)]
@@ -2944,6 +2944,7 @@ function createCashClient(options) {
       const payeeDetails = hashedOnchainIds[0];
       const url = getVenmoGmailConnectUrl({
         ...options.venmoGmail,
+        ...connectOptions,
         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-LTZshulP.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-LTZshulP.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.1"};
+  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.1"};
+  version: "0.6.2"};
 
 // src/tools/index.ts
 var bigintString = {

package/docs/partner-integrations.md

@@ -150,15 +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`.
-
-Configure optional `venmoGmail: { appearance, popup }` on `createCashClient()`
-to share partner branding between the prepared URL and popup. Omit it for Peer
-branding; omit `appearance.logoUrl` to keep the Peer logo beside Venmo. Popup
-width/height apply to desktop; mobile browsers control tab sizing. See the
-README's "Customize the hosted popup" section for the configuration example.
+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

@@ -18,6 +18,11 @@ export async function prepareVenmoLink(handle: string) {
   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) {
   return cash.openVenmoGmailConnect(link.payeeDetails).catch((error: unknown) => {

package/llms.txt

@@ -17,7 +17,11 @@ 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

package/package.json

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

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

@@ -293,15 +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`.
-
-Configure optional `venmoGmail: { appearance, popup }` on `createCashClient()`
-to share partner branding between the prepared URL and popup. Omit it for Peer
-branding; omit `appearance.logoUrl` to keep the Peer logo beside Venmo. Popup
-width/height apply to desktop; mobile browsers control tab sizing. See the
-README's "Customize the hosted popup" section for the configuration example.
+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`.