@rozoai/intent-pay 0.1.34 → 0.1.35-beta.1

package/build/src/utils/token.js

@@ -1,8 +1,28 @@
 import { TokenSymbol, supportedTokens } from '@rozoai/intent-common';
+import { ethAddress } from 'viem';
 
+/**
+ * Native-token address markers across supported ecosystems:
+ * - EVM natives (ETH/BNB/POL/MNT) all use the conventional `ethAddress`
+ *   placeholder (0xEeee…eEeE).
+ * - Solana native SOL uses the system program address.
+ * - Stellar native XLM uses the "XLM" sentinel.
+ *
+ * A token is "native" when its address matches one of these (case-insensitive).
+ */
+const NATIVE_TOKEN_ADDRESSES = new Set([ethAddress, "11111111111111111111111111111112", "XLM"].map((a) => a.toLowerCase()));
+/** Returns true if the given token is a chain-native token (ETH/BNB/POL/SOL/XLM, etc.). */
+function isNativeToken(token) {
+    if (!token?.token)
+        return false;
+    return NATIVE_TOKEN_ADDRESSES.has(token.token.toLowerCase());
+}
 /**
  * Converts preferredSymbol array to preferredTokens array.
- * Only USDC, USDT, and EURC symbols are allowed.
+ * Explicit preferredSymbol values are respected as given (USDC, USDT, 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.
  * Finds tokens matching the symbols across supported chains (Base, Polygon, Ethereum, Solana, Stellar).
  */
 function convertPreferredSymbolsToTokens(symbols, existingPreferredTokens) {
@@ -11,16 +31,28 @@ function convertPreferredSymbolsToTokens(symbols, existingPreferredTokens) {
     if (existingPreferredTokens !== undefined) {
         return existingPreferredTokens.filter((v) => !!v);
     }
-    // If no preferredSymbol provided, default to USDC and USDT
+    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.USDC, TokenSymbol.USDT, ...nativeSymbols];
     // Validate that only allowed symbols are used
-    const allowedSymbols = [TokenSymbol.USDC, TokenSymbol.USDT, TokenSymbol.EURC];
+    const allowedSymbols = [
+        TokenSymbol.USDC,
+        TokenSymbol.USDT,
+        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, and EURC are allowed.`);
+        console.warn(`[RozoPay] Invalid preferredSymbol values: ${invalidSymbols.join(", ")}. Allowed: ${allowedSymbols.join(", ")}.`);
     }
     if (validSymbols.length === 0) {
         return undefined;
@@ -39,5 +71,5 @@ function convertPreferredSymbolsToTokens(symbols, existingPreferredTokens) {
     return tokens.length > 0 ? tokens : undefined;
 }
 
-export { convertPreferredSymbolsToTokens };
+export { convertPreferredSymbolsToTokens, isNativeToken };
 //# 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;AACa,SAAA,+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,CAAC;KACnD;;IAGD,MAAM,YAAY,GAChB,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;AAC3B,UAAE,OAAO;UACP,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;;AAG3C,IAAA,MAAM,cAAc,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;AAC9E,IAAA,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,IAAA,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CACxC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CACnC,CAAC;AAEF,IAAA,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE;AAC7B,QAAA,OAAO,CAAC,IAAI,CACV,CAAA,0CAAA,EAA6C,cAAc,CAAC,IAAI,CAC9D,IAAI,CACL,CAA0C,wCAAA,CAAA,CAC5C,CAAC;KACH;AAED,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,QAAA,OAAO,SAAS,CAAC;KAClB;;IAGD,MAAM,MAAM,GAAY,EAAE,CAAC;AAC3B,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;;IAGxC,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,CAAC;aACpB;SACF;KACF;AAED,IAAA,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;AAChD;;;;"}
+{"version":3,"file":"token.js","sources":["../../../src/utils/token.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;;;;;;;;AAQG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CACpC,CAAC,UAAU,EAAE,kCAAkC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAC5D,CAAC,CAAC,WAAW,EAAE,CAChB,CACF,CAAC;AAEF;AACM,SAAU,aAAa,CAAC,KAA2C,EAAA;IACvE,IAAI,CAAC,KAAK,EAAE,KAAK;AAAE,QAAA,OAAO,KAAK,CAAC;IAChC,OAAO,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;AAOG;AACa,SAAA,+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,CAAC;KACnD;AAED,IAAA,MAAM,aAAa,GAAG;AACpB,QAAA,WAAW,CAAC,GAAG;AACf,QAAA,WAAW,CAAC,GAAG;AACf,QAAA,WAAW,CAAC,GAAG;AACf,QAAA,WAAW,CAAC,GAAG;AACf,QAAA,WAAW,CAAC,GAAG;KAChB,CAAC;;IAGF,MAAM,YAAY,GAChB,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;AAC3B,UAAE,OAAO;AACT,UAAE,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,aAAa,CAAC,CAAC;;AAG7D,IAAA,MAAM,cAAc,GAAG;AACrB,QAAA,WAAW,CAAC,IAAI;AAChB,QAAA,WAAW,CAAC,IAAI;AAChB,QAAA,WAAW,CAAC,IAAI;AAChB,QAAA,GAAG,aAAa;KACjB,CAAC;AACF,IAAA,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,IAAA,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CACxC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CACnC,CAAC;AAEF,IAAA,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE;AAC7B,QAAA,OAAO,CAAC,IAAI,CACV,6CAA6C,cAAc,CAAC,IAAI,CAC9D,IAAI,CACL,CAAc,WAAA,EAAA,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAA,CAAG,CAC5C,CAAC;KACH;AAED,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,QAAA,OAAO,SAAS,CAAC;KAClB;;IAGD,MAAM,MAAM,GAAY,EAAE,CAAC;AAC3B,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;;IAGxC,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,CAAC;aACpB;SACF;KACF;AAED,IAAA,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;AAChD;;;;"}

package/build/utils/format.d.ts

@@ -47,3 +47,27 @@ 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;
+/**
+ * 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 | BigIntStr, decimals: number): 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,7 +1,14 @@
 import { Token, TokenSymbol } from "@rozoai/intent-common";
+/** Returns true if the given token is a chain-native token (ETH/BNB/POL/SOL/XLM, etc.). */
+export declare function isNativeToken(token: {
+    token: string;
+} | null | undefined): boolean;
 /**
  * Converts preferredSymbol array to preferredTokens array.
- * Only USDC, USDT, and EURC symbols are allowed.
+ * Explicit preferredSymbol values are respected as given (USDC, USDT, 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.
  * Finds tokens matching the symbols across supported chains (Base, Polygon, Ethereum, Solana, Stellar).
  */
 export declare function convertPreferredSymbolsToTokens(symbols: TokenSymbol[] | undefined, existingPreferredTokens: Token[] | undefined): Token[] | undefined;

package/package.json

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