@zkp2p/cash 0.6.1 → 0.6.3-rc.0

package/AGENTS.md

@@ -61,6 +61,12 @@ deposit-level integration share instead of applying maker L1/L2.
 - **Cash App is non-chargebackable.** Cash App cash-outs stay public, do not
   attach a Peer Pay merchant policy, and never require dispute-protection stake.
 
+- **X Money supports USD.** Use `platform: 'xmoney'` and a receiving X username
+  with X Money enabled. Raw string payees accept a leading `@` and normalize to
+  the bare lowercase handle; structured `offchainId` values must already be
+  normalized. Curator does not verify account existence or X Money enrollment.
+  No identity attestation or Peer Pay merchant policy is required.
+
 - **Wise, PayPal, and Alipay** carry `requiresIdentityAttestation: true`. A new curator
   registration needs a signed maker identity attestation this SDK cannot mint
   (first-party Peer web obtains it through the Peer TEE browser extension).
@@ -353,15 +359,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
@@ -283,10 +323,17 @@ See the [full appearance options](https://www.npmjs.com/package/@zkp2p/sdk#popup
 | 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                                                      |
+| X Money (USD)         | No access-policy follow-up                                                 | Bare lowercase X username; X Money must be enabled on the receiving account            |
 | 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 |
 
+Use `receive: { platform: 'xmoney', currency: 'USD', payee: '@YourHandle' }`
+for X Money. Raw handles are trimmed, lowercased, and stripped of a leading `@`;
+structured payee data must already use `offchainId: 'yourhandle'`. Registration
+normalizes the handle but does not verify that the X account exists or can receive
+X Money. Confirm that the receiving account has X Money enabled before cashing out.
+
 No platform requires an atomic access-policy flow. `cashout()` and `prepare()`
 work with any viem `WalletClient`, including a local or externally connected
 EOA; no Privy wallet or signer API is required. The deprecated

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

@@ -618,6 +618,7 @@ var PAYEE_HINTS = {
   mercadopago: "Mercado Pago alias or CVU",
   monzo: "Monzo.me username",
   chime: "ChimeSign (e.g. $andrew)",
+  xmoney: "X username with X Money enabled, with or without the leading @ (e.g. @andrew)",
   luxon: "Luxon Pay ID or account email",
   n26: "MoneyBeam email or phone number",
   alipay: "Email address linked to your Alipay account",
@@ -1893,6 +1894,8 @@ function normalizeCashPayee(platform, payee) {
   switch (platform) {
     case "venmo":
       return { offchainId: trimmed.replace(/^@+/, "") };
+    case "xmoney":
+      return { offchainId: trimmed.replace(/^@/, "").toLowerCase() };
     case "cashapp":
       return { offchainId: trimmed.replace(/^\$+/, "") };
     case "chime":
@@ -3429,7 +3432,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 +3440,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

@@ -597,6 +597,7 @@ var PAYEE_HINTS = {
   mercadopago: "Mercado Pago alias or CVU",
   monzo: "Monzo.me username",
   chime: "ChimeSign (e.g. $andrew)",
+  xmoney: "X username with X Money enabled, with or without the leading @ (e.g. @andrew)",
   luxon: "Luxon Pay ID or account email",
   n26: "MoneyBeam email or phone number",
   alipay: "Email address linked to your Alipay account",
@@ -1400,6 +1401,8 @@ function normalizeCashPayee(platform, payee) {
   switch (platform) {
     case "venmo":
       return { offchainId: trimmed.replace(/^@+/, "") };
+    case "xmoney":
+      return { offchainId: trimmed.replace(/^@/, "").toLowerCase() };
     case "cashapp":
       return { offchainId: trimmed.replace(/^\$+/, "") };
     case "chime":
@@ -2936,7 +2939,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 +2947,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.3-rc.0"};
 
 // 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.3-rc.0"};
 
 // 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/node-cashout.ts

@@ -16,6 +16,8 @@
  * no Privy wallet is required. Venmo and PayPal attach their access
  * policy in a confirmed follow-up transaction. Override the demo corridor with:
  *   CASH_PLATFORM=revolut CASH_CURRENCY=EUR CASH_PAYEE=your-revtag
+ *   CASH_PLATFORM=xmoney CASH_CURRENCY=USD CASH_PAYEE=@your-x-username
+ * X Money requires an enrolled receiving account; registration does not check enrollment.
  */
 import { createWalletClient, http } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';

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
@@ -52,6 +56,11 @@ Key facts:
   fillStats() separately.
 - capabilities() exposes one Zelle platform. A zelle cashout attaches only the
   generic Zelle payment method to the on-chain deposit.
+- X Money supports USD with `platform: 'xmoney'`. Raw payees such as
+  '@YourHandle' become 'yourhandle'; structured offchainId values must already
+  be normalized. The receiving account must have X Money enabled; registration
+  does not verify account existence or enrollment. No identity attestation or
+  Peer Pay merchant policy is required.
 - 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,

package/package.json

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

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

@@ -188,6 +188,12 @@ 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.
 
+X Money accepts `receive: { platform: 'xmoney', currency: 'USD', payee: '@YourHandle' }`.
+Raw handles normalize to the bare lowercase username. Structured payee data must
+already use `offchainId: 'yourhandle'`. Confirm that the receiving account has
+X Money enabled: registration does not verify account existence or enrollment.
+No identity attestation or Peer Pay merchant policy is required.
+
 ## 4. Order management - indexer-native
 
 - A cash order IS a deposit; the chain is the database. No storage layer.
@@ -293,15 +299,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`.