@rozoai/intent-pay 0.1.58 → 0.1.59-beta.0

package/build/src/utils/format.js

@@ -146,6 +146,27 @@ function tokenAmountToRoundedUsd(amount, token, round = "nearest") {
     const amountUnits = formatUnits(BigInt(amount), token.decimals);
     return roundUsd(Number(amountUnits) * token.usd, round);
 }
+/**
+ * Convert a `RozoPayTokenAmount.amount` value to a full-precision, human-readable
+ * decimal string suitable for sending to the backend (checkout/create-payment
+ * payloads, on-chain transfer amounts, etc).
+ *
+ * `amount` is documented as `BigIntStr` (integer base units, e.g. lamports/wei)
+ * but some endpoints (e.g. Solana tRPC payment options) have been observed to
+ * return an already-human-readable decimal string instead (e.g. "0.012985327").
+ * `BigInt()` throws on decimal strings, so this detects the shape first:
+ * - Contains a "." → already a decimal token amount, pass through as-is.
+ * - Otherwise → integer base units, convert via `formatUnits`.
+ */
+function tokenBaseAmountToDecimalString(amount, decimals) {
+    if (typeof amount === "string" && amount.includes(".")) {
+        return amount;
+    }
+    return formatUnits(BigInt(amount), decimals);
+}
+function formatNativeInsufficientBalance(balance) {
+    return `Balance too low: ${tokenBaseAmountToDecimalString(balance.amount, balance.token.decimals)} ${balance.token.symbol} (~$${formatTokenAmount(balance.usd, USD_DECIMALS)})`;
+}
 
-export { USD_DECIMALS, fallbackDisplayDecimals, formatTokenAmount, formatUsd, roundDecimals, roundTokenAmount, roundTokenAmountUnits, roundUsd, stripTrailingZeros, tokenAmountToRoundedUsd, trimTokenAmount, usdToRoundedTokenAmount };
+export { USD_DECIMALS, fallbackDisplayDecimals, formatNativeInsufficientBalance, formatTokenAmount, formatUsd, roundDecimals, roundTokenAmount, roundTokenAmountUnits, roundUsd, stripTrailingZeros, tokenAmountToRoundedUsd, tokenBaseAmountToDecimalString, trimTokenAmount, usdToRoundedTokenAmount };
 //# sourceMappingURL=format.js.map

package/build/src/utils/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sources":["../../../src/utils/format.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"format.js","sources":["../../../src/utils/format.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/build/src/utils/token.js

@@ -1,9 +1,55 @@
-import { TokenSymbol, supportedTokens, getKnownToken, rozoStellar } from '@rozoai/intent-common';
+import { arbitrum, base, bsc, ethereum, polygon, getChainNativeToken, supportedTokens, TokenSymbol, solana, rozoSolana, solanaSOL, stellar, rozoStellar, stellarXLM, isNativeToken, normalizeTokenAddress, getKnownToken } from '@rozoai/intent-common';
+export { isNativeToken } from '@rozoai/intent-common';
+import { zeroAddress } from 'viem';
 
+// Keep source-only EVM natives outside supportedTokens: the proxy uses that
+// map to generate stablecoin deposit rows before applying its native allowlist.
+const evmNativeSourceTokens = [arbitrum, base, bsc, ethereum, polygon].map((chain) => getChainNativeToken(chain.chainId));
+const sourcePaymentTokens = [
+    ...Array.from(supportedTokens.values()).flat(),
+    ...evmNativeSourceTokens,
+];
+/** Compare proxy source identities without changing destination or quoted addresses. */
+function normalizeSourceTokenAddress(chainId, address) {
+    if ((chainId === solana.chainId || chainId === rozoSolana.chainId) &&
+        (address === "native" || address === "11111111111111111111111111111112" || address === solanaSOL.token)) {
+        return solanaSOL.token;
+    }
+    if ((chainId === stellar.chainId || chainId === rozoStellar.chainId) &&
+        (address === "XLM" || address === stellarXLM.token)) {
+        return stellarXLM.token;
+    }
+    if (evmNativeSourceTokens.some((token) => token.chainId === chainId) &&
+        address.startsWith("0x") &&
+        isNativeToken(address)) {
+        return zeroAddress;
+    }
+    return normalizeTokenAddress(chainId, address) ?? address;
+}
+function sourceTokenChainId(chainId) {
+    if (chainId === solana.chainId)
+        return rozoSolana.chainId;
+    if (chainId === stellar.chainId)
+        return rozoStellar.chainId;
+    return chainId;
+}
+/** A quoted source may use the proxy sentinel, unlike known payout tokens. */
+function getSourcePaymentToken(chainId, address) {
+    return (getKnownToken(chainId, address) ??
+        sourcePaymentTokens.find((token) => sourceTokenChainId(token.chainId) === sourceTokenChainId(chainId) &&
+            normalizeSourceTokenAddress(token.chainId, token.token) ===
+                normalizeSourceTokenAddress(chainId, address)));
+}
 /**
  * Converts preferredSymbol array to preferredTokens array.
- * Only USDC, USDT, USDT0, and EURC symbols are allowed.
- * Finds tokens matching the symbols across supported chains (Base, Polygon, Ethereum, Solana, Stellar).
+ *
+ * Explicit preferredSymbol values are respected as given: stablecoins
+ * (USDC, USDT, USDT0, EURC) or native (ETH/BNB/POL/SOL/XLM). When neither
+ * preferredSymbol nor preferredTokens is provided, defaults to stablecoins
+ * plus native tokens so native options aren't silently filtered out of the
+ * default request. Matches tokens across supported chains (Base, Polygon,
+ * Ethereum, Solana, Stellar) via sourcePaymentTokens, which includes the
+ * source-only EVM natives kept outside supportedTokens.
  */
 function convertPreferredSymbolsToTokens(symbols, existingPreferredTokens) {
     // If preferredTokens is explicitly provided, it takes precedence
@@ -11,16 +57,29 @@ function convertPreferredSymbolsToTokens(symbols, existingPreferredTokens) {
     if (existingPreferredTokens !== undefined) {
         return existingPreferredTokens.filter((v) => !!v);
     }
-    // If no preferredSymbol provided, show all supported USD stablecoins
+    const nativeSymbols = [
+        TokenSymbol.ETH,
+        TokenSymbol.BNB,
+        TokenSymbol.POL,
+        TokenSymbol.SOL,
+        TokenSymbol.XLM,
+    ];
+    // If no preferredSymbol provided, default to stablecoins plus native tokens
     const symbolsToUse = symbols && symbols.length > 0
         ? symbols
-        : [TokenSymbol.USDC, TokenSymbol.USDT, TokenSymbol.USDT0];
+        : [TokenSymbol.USDC, TokenSymbol.USDT, TokenSymbol.USDT0, ...nativeSymbols];
     // Validate that only allowed symbols are used
-    const allowedSymbols = [TokenSymbol.USDC, TokenSymbol.USDT, TokenSymbol.USDT0, TokenSymbol.EURC];
+    const allowedSymbols = [
+        TokenSymbol.USDC,
+        TokenSymbol.USDT,
+        TokenSymbol.USDT0,
+        TokenSymbol.EURC,
+        ...nativeSymbols,
+    ];
     const validSymbols = symbolsToUse.filter((s) => allowedSymbols.includes(s));
     const invalidSymbols = symbolsToUse.filter((s) => !allowedSymbols.includes(s));
     if (invalidSymbols.length > 0) {
-        console.warn(`[RozoPay] Invalid preferredSymbol values: ${invalidSymbols.join(", ")}. Only USDC, USDT, USDT0, and EURC are allowed.`);
+        console.warn(`[RozoPay] Invalid preferredSymbol values: ${invalidSymbols.join(", ")}. Allowed: ${allowedSymbols.join(", ")}.`);
     }
     if (validSymbols.length === 0) {
         return undefined;
@@ -29,24 +88,13 @@ function convertPreferredSymbolsToTokens(symbols, existingPreferredTokens) {
     const tokens = [];
     const symbolSet = new Set(validSymbols);
     // Iterate through all supported tokens (organized by chain)
-    for (const chainTokens of supportedTokens.values()) {
-        for (const token of chainTokens) {
-            if (symbolSet.has(token.symbol)) {
-                tokens.push(token);
-            }
+    for (const token of sourcePaymentTokens) {
+        if (symbolSet.has(token.symbol)) {
+            tokens.push(token);
         }
     }
     return tokens.length > 0 ? tokens : undefined;
 }
-/** Resolve the canonical Stellar asset, never trust a wallet option's issuer or symbol. */
-function getStellarPaymentAsset(tokenAddress) {
-    const token = getKnownToken(rozoStellar.chainId, tokenAddress);
-    const [code, issuer] = token?.token.split(":") ?? [];
-    if (!token || !code || !issuer || code !== token.symbol) {
-        throw new Error("Unsupported Stellar token");
-    }
-    return { code, issuer };
-}
 
-export { convertPreferredSymbolsToTokens, getStellarPaymentAsset };
+export { convertPreferredSymbolsToTokens, getSourcePaymentToken, normalizeSourceTokenAddress, sourcePaymentTokens, sourceTokenChainId };
 //# sourceMappingURL=token.js.map

package/build/src/utils/token.js.map

@@ -1 +1 @@
-{"version":3,"file":"token.js","sources":["../../../src/utils/token.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;AAIG;AACG,SAAU,+BAA+B,CAC7C,OAAkC,EAClC,uBAA4C,EAAA;;;AAI5C,IAAA,IAAI,uBAAuB,KAAK,SAAS,EAAE;AACzC,QAAA,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnD;;IAGA,MAAM,YAAY,GAChB,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG;AAC1B,UAAE;AACF,UAAE,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;;AAG7D,IAAA,MAAM,cAAc,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC;AAChG,IAAA,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC3E,IAAA,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CACxC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CACnC;AAED,IAAA,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE;AAC7B,QAAA,OAAO,CAAC,IAAI,CACV,CAAA,0CAAA,EAA6C,cAAc,CAAC,IAAI,CAC9D,IAAI,CACL,CAAA,+CAAA,CAAiD,CACnD;IACH;AAEA,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,QAAA,OAAO,SAAS;IAClB;;IAGA,MAAM,MAAM,GAAY,EAAE;AAC1B,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC;;IAGvC,KAAK,MAAM,WAAW,IAAI,eAAe,CAAC,MAAM,EAAE,EAAE;AAClD,QAAA,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE;YAC/B,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,MAAqB,CAAC,EAAE;AAC9C,gBAAA,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACpB;QACF;IACF;AAEA,IAAA,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS;AAC/C;AAEA;AACM,SAAU,sBAAsB,CAAC,YAAoB,EAAA;IACzD,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,OAAO,EAAE,YAAY,CAAC;AAC9D,IAAA,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;AACpD,IAAA,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE;AACvD,QAAA,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC;IAC9C;AACA,IAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE;AACzB;;"}
+{"version":3,"file":"token.js","sources":["../../../src/utils/token.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/build/utils/format.d.ts

@@ -1,4 +1,4 @@
-import { BigIntStr, RozoPayToken } from "@rozoai/intent-common";
+import { BigIntStr, RozoPayToken, type Token, type WalletPaymentOption } from "@rozoai/intent-common";
 export declare const USD_DECIMALS = 2;
 /**
  * Fallback for `token.displayDecimals` when absent. Mirrors
@@ -64,3 +64,41 @@ export declare function usdToRoundedTokenAmount(usd: number, token: RozoPayToken
  * @returns The formatted USD amount
  */
 export declare function tokenAmountToRoundedUsd(amount: bigint | BigIntStr, token: RozoPayToken, round?: "up" | "down" | "nearest"): string;
+/**
+ * Build a Stellar SEP-0007 `pay` URI that opens a Stellar wallet with the
+ * destination, amount, asset, and optional memo pre-filled.
+ *
+ * Native XLM uses asset_code=XLM with no asset_issuer. Custom assets use the
+ * token address (issuer) and token symbol parsed from the Rozo token object.
+ */
+export declare function generateStellarDeepLink({ amountUnits, recipientAddress, token, memo, }: {
+    amountUnits: string;
+    recipientAddress: string;
+    token: Token;
+    memo?: string | null;
+}): string;
+/**
+ * Convert a `RozoPayTokenAmount.amount` value to a full-precision, human-readable
+ * decimal string suitable for sending to the backend (checkout/create-payment
+ * payloads, on-chain transfer amounts, etc).
+ *
+ * `amount` is documented as `BigIntStr` (integer base units, e.g. lamports/wei)
+ * but some endpoints (e.g. Solana tRPC payment options) have been observed to
+ * return an already-human-readable decimal string instead (e.g. "0.012985327").
+ * `BigInt()` throws on decimal strings, so this detects the shape first:
+ * - Contains a "." → already a decimal token amount, pass through as-is.
+ * - Otherwise → integer base units, convert via `formatUnits`.
+ */
+export declare function tokenBaseAmountToDecimalString(amount: bigint | string, decimals: number): string;
+export declare function formatNativeInsufficientBalance(balance: WalletPaymentOption["balance"]): string;
+/**
+ * Inverse of `tokenBaseAmountToDecimalString`: convert a
+ * `RozoPayTokenAmount.amount` value to an integer base-units bigint, suitable
+ * for on-chain transfer instructions (e.g. lamports for SOL, raw SPL/ERC20
+ * transfer amounts).
+ *
+ * Same shape ambiguity as above — detects a decimal string (already
+ * human-readable) and converts it up to base units via `parseUnits`;
+ * otherwise assumes the string is already an integer base-units amount.
+ */
+export declare function tokenAmountToBaseUnits(amount: bigint | BigIntStr, decimals: number): bigint;

package/build/utils/token.d.ts

@@ -1,8 +1,21 @@
-import { Token, TokenSymbol } from "@rozoai/intent-common";
+import { isNativeToken, Token, TokenSymbol } from "@rozoai/intent-common";
+export { isNativeToken };
+export declare const sourcePaymentTokens: Token[];
+/** Compare proxy source identities without changing destination or quoted addresses. */
+export declare function normalizeSourceTokenAddress(chainId: number, address: string): string;
+export declare function sourceTokenChainId(chainId: number): number;
+/** A quoted source may use the proxy sentinel, unlike known payout tokens. */
+export declare function getSourcePaymentToken(chainId: number, address: string): Token | undefined;
 /**
  * Converts preferredSymbol array to preferredTokens array.
- * Only USDC, USDT, USDT0, and EURC symbols are allowed.
- * Finds tokens matching the symbols across supported chains (Base, Polygon, Ethereum, Solana, Stellar).
+ *
+ * Explicit preferredSymbol values are respected as given: stablecoins
+ * (USDC, USDT, USDT0, EURC) or native (ETH/BNB/POL/SOL/XLM). When neither
+ * preferredSymbol nor preferredTokens is provided, defaults to stablecoins
+ * plus native tokens so native options aren't silently filtered out of the
+ * default request. Matches tokens across supported chains (Base, Polygon,
+ * Ethereum, Solana, Stellar) via sourcePaymentTokens, which includes the
+ * source-only EVM natives kept outside supportedTokens.
  */
 export declare function convertPreferredSymbolsToTokens(symbols: TokenSymbol[] | undefined, existingPreferredTokens: Token[] | undefined): Token[] | undefined;
 /** Resolve the canonical Stellar asset, never trust a wallet option's issuer or symbol. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozoai/intent-pay",
-  "version": "0.1.58",
+  "version": "0.1.59-beta.0",
   "private": false,
   "description": "Seamless crypto payments. Onboard users from any chain, any coin into your app with one click.",
   "keywords": [
@@ -49,7 +49,7 @@
     "@reown/appkit": "^1.7.0",
     "@rollup/plugin-image": "^3.0.3",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@rozoai/intent-common": "0.1.41",
+    "@rozoai/intent-common": "0.1.42",
     "@solana/spl-memo": "^0.2.5",
     "@solana/spl-token": "^0.4.14",
     "@solana/wallet-adapter-base": "^0.9.27",