@rozoai/intent-common 0.0.29 → 0.0.31-beta.1

package/dist/api/fee.d.ts

@@ -0,0 +1,36 @@
+import { ApiResponse } from "./base";
+/**
+ * Fee response data type (success case)
+ */
+export interface FeeResponseData {
+    appId: string;
+    amount: number;
+    currency: string;
+    fee: number;
+    feePercentage: string;
+    minimumFee: string;
+    amount_out: number;
+}
+/**
+ * Fee error response data type
+ */
+export interface FeeErrorData {
+    error: string;
+    message: string;
+    received: number;
+    maxAllowed: number;
+}
+/**
+ * Fee request parameters
+ */
+export interface GetFeeParams {
+    amount: number;
+    appId?: string;
+    currency?: string;
+}
+/**
+ * Gets fee calculation for a payment amount
+ * @param params - Fee calculation parameters (amount is required)
+ * @returns Promise with fee response or error
+ */
+export declare const getFee: (params: GetFeeParams) => Promise<ApiResponse<FeeResponseData>>;

package/dist/api/fee.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFee = void 0;
+/**
+ * Gets fee calculation for a payment amount
+ * @param params - Fee calculation parameters (amount is required)
+ * @returns Promise with fee response or error
+ */
+const getFee = async (params) => {
+    const { amount, appId = "rozodemo", currency = "USDC" } = params;
+    try {
+        const queryParams = new URLSearchParams({
+            amount: amount.toString(),
+            appId,
+            currency,
+        });
+        const response = await fetch(`https://intentapi.rozo.ai/getFee?${queryParams.toString()}`);
+        const data = (await response.json());
+        // Check if response contains an error
+        if (!response.ok || "error" in data) {
+            const errorData = data;
+            return {
+                data: null,
+                error: new Error(errorData.message || errorData.error),
+                status: response.status,
+            };
+        }
+        return {
+            data: data,
+            error: null,
+            status: response.status,
+        };
+    }
+    catch (error) {
+        return {
+            data: null,
+            error: error instanceof Error ? error : new Error(String(error)),
+            status: null,
+        };
+    }
+};
+exports.getFee = getFee;
+//# sourceMappingURL=fee.js.map

package/dist/api/fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee.js","sourceRoot":"","sources":["../../src/api/fee.ts"],"names":[],"mappings":";;;AAkCA;;;;GAIG;AACI,MAAM,MAAM,GAAG,KAAK,EACzB,MAAoB,EACmB,EAAE;IACzC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,UAAU,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IAEjE,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;YACtC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;YACzB,KAAK;YACL,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,oCAAoC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAC7D,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;QAEvE,sCAAsC;QACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAoB,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC;gBACtD,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAuB;YAC7B,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChE,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAxCW,QAAA,MAAM,UAwCjB"}

package/dist/bridge.d.ts

@@ -30,11 +30,11 @@ export interface DestinationConfig {
  * the complexity of multi-chain payments by:
  *
  * 1. **Preferred Payment Method**: Identifies which chain/token the user will pay from
- *    - Supports Base USDC, Polygon USDC, Solana USDC, Stellar USDC, and BSC USDT
+ *    - Supports Base USDC, Polygon USDC, Solana USDC, Stellar USDC, Worldchain USDC, and BSC USDT
  *    - Sets appropriate chain ID and token address for the source transaction
  *
  * 2. **Destination Configuration**: Determines where funds will be received
- *    - Supports Base, Solana, and Stellar as destination chains
+ *    - Supports Base, Solana, Stellar, and Worldchain as destination chains
  *    - Handles special address formats for Solana and Stellar addresses
  *    - Defaults to Base USDC when no special destination is specified
  *

package/dist/bridge.js

@@ -12,11 +12,11 @@ const _1 = require(".");
  * the complexity of multi-chain payments by:
  *
  * 1. **Preferred Payment Method**: Identifies which chain/token the user will pay from
- *    - Supports Base USDC, Polygon USDC, Solana USDC, Stellar USDC, and BSC USDT
+ *    - Supports Base USDC, Polygon USDC, Solana USDC, Stellar USDC, Worldchain USDC, and BSC USDT
  *    - Sets appropriate chain ID and token address for the source transaction
  *
  * 2. **Destination Configuration**: Determines where funds will be received
- *    - Supports Base, Solana, and Stellar as destination chains
+ *    - Supports Base, Solana, Stellar, and Worldchain as destination chains
  *    - Handles special address formats for Solana and Stellar addresses
  *    - Defaults to Base USDC when no special destination is specified
  *
@@ -123,6 +123,15 @@ function createPaymentBridgeConfig({ toChain = _1.baseUSDC.chainId, toToken = _1
                     preferredTokenAddress: `USDC:${_1.rozoStellarUSDC.token}`,
                 };
             }
+            // Pay In USDC Worldchain
+            else if (payInTokenAddress === _1.worldchainUSDC.token) {
+                log?.(`[Payment Bridge] Pay In USDC Worldchain`);
+                preferred = {
+                    preferredChain: String(_1.worldchainUSDC.chainId),
+                    preferredToken: "USDC",
+                    preferredTokenAddress: _1.worldchainUSDC.token,
+                };
+            }
             // Pay In USDT BSC
             else if (payInTokenAddress === _1.bscUSDT.token) {
                 log?.(`[Payment Bridge] Pay In USDT BSC`);

package/dist/bridge.js.map

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

package/dist/daimoPay.d.ts

@@ -44,11 +44,11 @@ export declare const zBridgeTokenOutOptions: z.ZodArray<z.ZodObject<{
     token: z.ZodEffects<z.ZodString, `0x${string}`, string>;
     amount: z.ZodEffects<z.ZodEffects<z.ZodString, `${bigint}`, string>, bigint, string>;
 }, "strip", z.ZodTypeAny, {
-    token: `0x${string}`;
     amount: bigint;
+    token: `0x${string}`;
 }, {
-    token: string;
     amount: string;
+    token: string;
 }>, "many">;
 export type BridgeTokenOutOptions = z.infer<typeof zBridgeTokenOutOptions>;
 export declare const zRozoPayOrderMetadata: z.ZodObject<{

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./api/fee";
 export * from "./api/payment";
 export * from "./assert";
 export * from "./bridge";

package/dist/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./api/fee"), exports);
 __exportStar(require("./api/payment"), exports);
 __exportStar(require("./assert"), exports);
 __exportStar(require("./bridge"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,mDAAiC;AACjC,iDAA+B;AAC/B,0CAAwB;AACxB,wCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,gDAA8B;AAC9B,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,mDAAiC;AACjC,iDAA+B;AAC/B,0CAAwB;AACxB,wCAAsB"}

package/dist/supportedChains.d.ts

@@ -0,0 +1,28 @@
+import { Token } from ".";
+/**
+ * Returns the list of currently active chains and tokens in wallet payment options,
+ * with dynamic logic for including BSC/Worldchain based on appId or preferences.
+ *
+ * CURRENTLY SUPPORTED CHAINS/TOKENS:
+ * - Base (8453) - USDC
+ * - Polygon (137) - USDC
+ * - BSC (56) - USDT (only for MugglePay apps/pref)
+ * - Worldchain (480) - USDC (only for World apps/pref)
+ *
+ * @param {string} appId - The Rozo appId; can affect which chains are enabled.
+ * @param {number[]} [preferredChains=[]] - Preferred chain IDs (may enable Worldchain).
+ * @returns {{
+ *   chains: Array<{ chainId: number; [k: string]: any }>;
+ *   tokens: Token[];
+ * }} An object with arrays of supported chains and supported token addresses.
+ *
+ * @example
+ * const { chains, tokens } = getSupportedChains("MP_demo", [8453, 56]);
+ */
+export declare function getSupportedChains(appId: string, preferredChains?: number[]): {
+    chains: Array<{
+        chainId: number;
+        [k: string]: any;
+    }>;
+    tokens: Token[];
+};

package/dist/supportedChains.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSupportedChains = getSupportedChains;
+const _1 = require(".");
+const supportedChainsList = [_1.base, _1.polygon];
+const supportedTokens = [_1.baseUSDC, _1.polygonUSDC];
+/**
+ * Returns the list of currently active chains and tokens in wallet payment options,
+ * with dynamic logic for including BSC/Worldchain based on appId or preferences.
+ *
+ * CURRENTLY SUPPORTED CHAINS/TOKENS:
+ * - Base (8453) - USDC
+ * - Polygon (137) - USDC
+ * - BSC (56) - USDT (only for MugglePay apps/pref)
+ * - Worldchain (480) - USDC (only for World apps/pref)
+ *
+ * @param {string} appId - The Rozo appId; can affect which chains are enabled.
+ * @param {number[]} [preferredChains=[]] - Preferred chain IDs (may enable Worldchain).
+ * @returns {{
+ *   chains: Array<{ chainId: number; [k: string]: any }>;
+ *   tokens: Token[];
+ * }} An object with arrays of supported chains and supported token addresses.
+ *
+ * @example
+ * const { chains, tokens } = getSupportedChains("MP_demo", [8453, 56]);
+ */
+function getSupportedChains(appId, preferredChains = []) {
+    const showBSCUSDT = appId.includes("MP");
+    const showWorldchainUSDC = typeof appId === "string" && appId.toLowerCase().includes("world")
+        ? true
+        : Array.isArray(preferredChains) &&
+            preferredChains.includes(_1.worldchain.chainId);
+    // Build chains array - always includes base and polygon, conditionally includes BSC and Worldchain
+    const chains = [
+        ...supportedChainsList,
+        ...(showBSCUSDT && _1.bsc ? [_1.bsc] : []),
+        ...(showWorldchainUSDC && _1.worldchain ? [_1.worldchain] : []),
+    ].filter(Boolean);
+    // Build tokens array - always includes base and polygon, conditionally includes BSC and Worldchain
+    // Ensure we always have at least base and polygon tokens
+    const tokens = [
+        ...supportedTokens,
+        ...(showBSCUSDT && _1.bscUSDT ? [_1.bscUSDT] : []),
+        ...(showWorldchainUSDC && _1.worldchainUSDC ? [_1.worldchainUSDC] : []),
+    ].filter(Boolean);
+    return {
+        chains,
+        tokens,
+    };
+}
+//# sourceMappingURL=supportedChains.js.map

package/dist/supportedChains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportedChains.js","sourceRoot":"","sources":["../src/supportedChains.ts"],"names":[],"mappings":";;AAmCA,gDAiCC;AApED,wBAUW;AAEX,MAAM,mBAAmB,GAAG,CAAC,OAAI,EAAE,UAAO,CAAC,CAAC;AAC5C,MAAM,eAAe,GAAG,CAAC,WAAQ,EAAE,cAAW,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,kBAAkB,CAChC,KAAa,EACb,kBAA4B,EAAE;IAK9B,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,kBAAkB,GACtB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;QAChE,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;YAC9B,eAAe,CAAC,QAAQ,CAAC,aAAU,CAAC,OAAO,CAAC,CAAC;IAEnD,mGAAmG;IACnG,MAAM,MAAM,GAAG;QACb,GAAG,mBAAmB;QACtB,GAAG,CAAC,WAAW,IAAI,MAAG,CAAC,CAAC,CAAC,CAAC,MAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,kBAAkB,IAAI,aAAU,CAAC,CAAC,CAAC,CAAC,aAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,mGAAmG;IACnG,yDAAyD;IACzD,MAAM,MAAM,GAAY;QACtB,GAAG,eAAe;QAClB,GAAG,CAAC,WAAW,IAAI,UAAO,CAAC,CAAC,CAAC,CAAC,UAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,kBAAkB,IAAI,iBAAc,CAAC,CAAC,CAAC,CAAC,iBAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,OAAO;QACL,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozoai/intent-common",
-  "version": "0.0.29",
+  "version": "0.0.31-beta.1",
   "description": "Intent Pay shared types and utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/api/README.md

@@ -30,7 +30,7 @@ These defaults are automatically used by the API client, so you can start making
 ```bash
 api/
 ├── base.ts         # Core API client functionality
-├── index.ts        # Re-exports all API modules
+├── fee.ts          # Fee calculation endpoint
 ├── payment.ts      # Payment-specific endpoints
 └── README.md       # Documentation
 ```
@@ -67,83 +67,313 @@ const response = await apiClient.get("/some-endpoint", {
 
 ## Using Payment API
 
-The payment module provides typed functions for payment operations:
+The payment module provides typed functions for payment operations. The `createRozoPayment` function is the core method for creating cross-chain payments.
+
+### Creating a Payment
+
+The `createRozoPayment` function requires a `PaymentRequestData` object with the following structure:
 
 ```typescript
 import {
   createRozoPayment,
   getRozoPayment,
-  createRozoPaymentRequest,
+  createPaymentBridgeConfig,
+  mergedMetadata,
+  PaymentRequestData,
 } from "@rozoai/intent-common";
 
-// Create a payment
+// Basic payment creation
 const handleSubmitPayment = async () => {
-  const paymentData = createRozoPaymentRequest({
+  // First, create payment bridge configuration
+  // This determines the preferred payment method and destination
+  // payInTokenAddress can be: USDC Base, USDC Polygon, USDC Solana, USDC Stellar, or USDT BNB
+  const { preferred, destination } = createPaymentBridgeConfig({
+    toChain: 8453, // Base chain
+    toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+    toAddress: "0x1234567890123456789012345678901234567890",
+    toUnits: "1000000", // 1 USDC (6 decimals)
+    payInTokenAddress: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174", // Polygon USDC
+  });
+
+  // Construct payment data
+  const paymentData: PaymentRequestData = {
     appId: "your-app-id",
     display: {
       intent: "Pay for product",
-      paymentValue: "100.00",
+      paymentValue: "1.00", // Display value in USD
       currency: "USD",
     },
     destination: {
-      chainId: "8453",
-      amountUnits: "100000000",
-      tokenSymbol: "USDC",
-      tokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+      destinationAddress: destination.destinationAddress,
+      chainId: destination.chainId,
+      amountUnits: destination.amountUnits,
+      tokenSymbol: destination.tokenSymbol,
+      tokenAddress: destination.tokenAddress,
     },
-  });
+    // Spread preferred payment configuration
+    ...preferred,
+    // Optional: external ID for tracking
+    externalId: "order-123",
+    // Optional: metadata
+    metadata: {
+      preferredChain: preferred.preferredChain,
+      preferredToken: preferred.preferredToken,
+      preferredTokenAddress: preferred.preferredTokenAddress,
+      // Merge additional metadata
+      ...mergedMetadata({
+        customField: "value",
+      }),
+    },
+  };
 
+  // Create the payment
   const response = await createRozoPayment(paymentData);
 
   if (response.data) {
     console.log("Payment created:", response.data.id);
+    console.log("Payment status:", response.data.status);
+    console.log("Payment URL:", response.data.url);
   } else if (response.error) {
     console.error("Error creating payment:", response.error.message);
   }
 };
+```
+
+### Example: Pay Out to Stellar
+
+```typescript
+// Paying out to a Stellar address
+const { preferred, destination } = createPaymentBridgeConfig({
+  toStellarAddress: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", // REQUIRED: Stellar address
+  toAddress: "0x1234567890123456789012345678901234567890", // REQUIRED: any valid EVM address
+  // toChain and toToken are optional (default to USDC Base)
+  toUnits: "1000000", // 1 USDC
+  payInTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+});
+
+const paymentData: PaymentRequestData = {
+  appId: "your-app-id",
+  display: {
+    intent: "Pay to Stellar wallet",
+    paymentValue: "1.00",
+    currency: "USD",
+  },
+  ...preferred,
+  destination,
+};
+
+const response = await createRozoPayment(paymentData);
+```
+
+### Example: Pay Out to Solana
+
+```typescript
+// Paying out to a Solana address
+const { preferred, destination } = createPaymentBridgeConfig({
+  toSolanaAddress: "So11111111111111111111111111111111111111112", // REQUIRED: Solana address
+  toAddress: "0x1234567890123456789012345678901234567890", // REQUIRED: any valid EVM address
+  // toChain and toToken are optional (default to USDC Base)
+  toUnits: "1000000", // 1 USDC
+  payInTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+});
+
+const paymentData: PaymentRequestData = {
+  appId: "your-app-id",
+  display: {
+    intent: "Pay to Solana wallet",
+    paymentValue: "1.00",
+    currency: "USD",
+  },
+  ...preferred,
+  destination,
+};
+
+const response = await createRozoPayment(paymentData);
+```
+
+### Payment Request Data Structure
+
+The `PaymentRequestData` interface includes:
+
+- **`appId`** (required): Your application identifier
+- **`display`** (required): Payment display information
+  - `intent`: Description of the payment
+  - `paymentValue`: Amount as a string (e.g., "100.00")
+  - `currency`: Currency code (e.g., "USD")
+- **`destination`** (required): Payment destination configuration
+  - `destinationAddress`: Recipient address
+  - `chainId`: Destination chain ID as string
+  - `amountUnits`: Amount in smallest token unit (as string)
+  - `tokenSymbol`: Token symbol (e.g., "USDC")
+  - `tokenAddress`: Token contract address
+- **`preferredChain`** (optional): Preferred source chain ID
+- **`preferredToken`** (optional): Preferred source token symbol
+- **`preferredTokenAddress`** (optional): Preferred source token address
+- **`externalId`** (optional): External identifier for tracking
+- **`metadata`** (optional): Additional metadata object
+
+### Using createPaymentBridgeConfig
+
+The `createPaymentBridgeConfig` helper function simplifies cross-chain payment configuration. It determines the preferred payment method based on the `payInTokenAddress` parameter.
+
+**Important Notes:**
+
+- **For EVM chain payouts (Base, Polygon, etc.)**: Provide `toAddress` with the destination EVM address. `toChain` and `toToken` are optional but default to USDC Base.
+- **For Stellar payouts**: You **must** provide `toStellarAddress` with the Stellar address. You **must** also provide `toAddress` with any valid EVM address (required for internal routing). `toChain` and `toToken` are optional but default to USDC Base.
+- **For Solana payouts**: You **must** provide `toSolanaAddress` with the Solana address. You **must** also provide `toAddress` with any valid EVM address (required for internal routing). `toChain` and `toToken` are optional but default to USDC Base.
+
+**Supported `payInTokenAddress` values:**
+
+- **USDC Base** - Base chain USDC token
+- **USDC Polygon** - Polygon chain USDC token
+- **USDC Solana** - Solana USDC token
+- **USDC Stellar** - Stellar USDC token (format: `USDC:issuerPK` or issuer public key)
+- **USDT BNB** - BSC (Binance Smart Chain) USDT token
+
+```typescript
+import { createPaymentBridgeConfig } from "@rozoai/intent-common";
+
+// Example: User pays with Polygon USDC, receives on Base
+const { preferred, destination } = createPaymentBridgeConfig({
+  toChain: 8453, // Base
+  toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+  toAddress: "0x...",
+  toUnits: "1000000", // 1 USDC
+  payInTokenAddress: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174", // Polygon USDC
+});
+
+// preferred contains: preferredChain, preferredToken, preferredTokenAddress
+// destination contains: destinationAddress, chainId, amountUnits, tokenSymbol, tokenAddress
+```
+
+**More examples:**
+
+```typescript
+// Pay with Base USDC
+const { preferred, destination } = createPaymentBridgeConfig({
+  toChain: 8453,
+  toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  toAddress: "0x...",
+  toUnits: "1000000",
+  payInTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+});
+
+// Pay with Solana USDC - Pay Out to Solana
+// Note: toSolanaAddress is REQUIRED, toAddress is REQUIRED (any valid EVM address)
+// toChain and toToken are optional (default to USDC Base)
+const { preferred, destination } = createPaymentBridgeConfig({
+  toSolanaAddress: "So11111111111111111111111111111111111111112", // Solana destination address
+  toAddress: "0x1234567890123456789012345678901234567890", // Required: any valid EVM address
+  // toChain and toToken are optional, default to USDC Base
+  toUnits: "1000000",
+  payInTokenAddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // Solana USDC
+});
 
-// Get payment details
+// Pay with Stellar USDC - Pay Out to Stellar
+// Note: toStellarAddress is REQUIRED, toAddress is REQUIRED (any valid EVM address)
+// toChain and toToken are optional (default to USDC Base)
+const { preferred, destination } = createPaymentBridgeConfig({
+  toStellarAddress: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", // Stellar destination address
+  toAddress: "0x1234567890123456789012345678901234567890", // Required: any valid EVM address
+  // toChain and toToken are optional, default to USDC Base
+  toUnits: "1000000",
+  payInTokenAddress:
+    "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", // Stellar USDC
+});
+
+// Pay with BSC USDT
+const { preferred, destination } = createPaymentBridgeConfig({
+  toChain: 8453,
+  toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  toAddress: "0x...",
+  toUnits: "1000000",
+  payInTokenAddress: "0x55d398326f99059fF775485246999027B3197955", // BSC USDT
+});
+```
+
+### Getting Payment Details
+
+```typescript
+// Get payment by ID
 const fetchPaymentDetails = async (paymentId: string) => {
   const response = await getRozoPayment(paymentId);
 
   if (response.data) {
     console.log("Payment status:", response.data.status);
+    console.log("Payment intent:", response.data.display.intent);
+    console.log(
+      "Destination address:",
+      response.data.destination.destinationAddress
+    );
+    console.log("Transaction hash:", response.data.destination.txHash);
+  } else if (response.error) {
+    console.error("Error fetching payment:", response.error.message);
   }
 };
 ```
 
+### Real-World Usage Pattern
+
+In the SDK, `createRozoPayment` is typically used within payment flow effects:
+
+```typescript
+// Example from paymentEffects.ts
+const paymentData: PaymentRequestData = {
+  appId: payParams?.rozoAppId ?? payParams?.appId ?? DEFAULT_ROZO_APP_ID,
+  display: {
+    intent: order?.metadata?.intent ?? "",
+    paymentValue: String(toUnits),
+    currency: "USD",
+  },
+  ...preferred, // Spread preferred config from createPaymentBridgeConfig
+  destination, // Destination config from createPaymentBridgeConfig
+  externalId: order?.externalId ?? "",
+  metadata: {
+    preferredChain: preferred.preferredChain,
+    preferredToken: preferred.preferredToken,
+    preferredTokenAddress: preferred.preferredTokenAddress,
+    ...mergedMetadata({
+      ...(payParams?.metadata ?? {}),
+      ...(order?.metadata ?? {}),
+      ...(order.userMetadata ?? {}),
+    }),
+  },
+};
+
+const rozoPayment = await createRozoPayment(paymentData);
+if (!rozoPayment?.data?.id) {
+  throw new Error(rozoPayment?.error?.message ?? "Payment creation failed");
+}
+```
+
 ## React Hooks
 
-React hooks for these APIs are available in the `@rozoai/intent-pay` package:
+React hooks for these APIs are available in the `@rozoai/intent-pay` package. The SDK handles payment creation internally through the payment state machine, but you can access payment state using hooks:
 
 ```typescript
 // In @rozoai/intent-pay
-import {
-  useCreateRozoPayment,
-  useRozoPayment,
-  useRozoPayments
-} from '@rozoai/intent-pay';
+import { useRozoPay, useRozoPayStatus, useRozoPayUI } from "@rozoai/intent-pay";
 
 // Use in React components
-const PaymentForm = () => {
-  const [paymentState, submitPayment] = useCreateRozoPayment();
-
-  const handleSubmit = (formData) => {
-    submitPayment({
-      appId: 'your-app-id',
-      display: { ... },
-      destination: { ... }
-    });
-  };
+const PaymentComponent = () => {
+  const { createPreviewOrder, payWallet } = useRozoPay();
+  const { paymentStatus } = useRozoPayStatus();
+  const { isOpen, openRozoPay, closeRozoPay } = useRozoPayUI();
+
+  // Payment creation is handled internally by the SDK
+  // when using RozoPayButton or calling createPreviewOrder
+  // The SDK automatically uses createRozoPayment under the hood
 
-  if (paymentState.isLoading) return <div>Processing...</div>;
-  if (paymentState.isError) return <div>Error: {paymentState.error?.message}</div>;
-  if (paymentState.isSuccess) return <div>Success! ID: {paymentState.data?.id}</div>;
+  if (paymentStatus === "payment_completed") {
+    return <div>Payment successful!</div>;
+  }
 
-  return <FormComponent onSubmit={handleSubmit} />;
+  return <RozoPayButton {...paymentProps} />;
 };
 ```
 
+Note: The SDK's payment flow automatically handles `createRozoPayment` calls internally. You typically don't need to call it directly when using the SDK components.
+
 ## Error Handling
 
 All API responses include standardized error handling:
@@ -181,17 +411,25 @@ const response: ApiResponse<PaymentResponseData> = await getRozoPayment(
 The API client is pre-configured with production RozoAI settings, so you can use it immediately:
 
 ```typescript
-import { createRozoPayment } from "@rozoai/intent-common";
+import {
+  createRozoPayment,
+  createPaymentBridgeConfig,
+} from "@rozoai/intent-common";
 
 // Works out of the box with default configuration
+const { preferred, destination } = createPaymentBridgeConfig({
+  toChain: 8453,
+  toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  toAddress: "0x...",
+  toUnits: "10000000",
+  payInTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+});
+
 const response = await createRozoPayment({
   appId: "your-app-id",
   display: { intent: "Payment", paymentValue: "10.00", currency: "USD" },
-  destination: {
-    chainId: "8453",
-    amountUnits: "10000000",
-    tokenSymbol: "USDC",
-  },
+  ...preferred,
+  destination,
 });
 ```
 
@@ -256,15 +494,56 @@ setApiConfig({
 });
 ```
 
+## Using Fee API
+
+The fee module provides a function to calculate fees for payment amounts:
+
+```typescript
+import { getFee } from "@rozoai/intent-common";
+
+// Get fee calculation (only amount is required)
+const calculateFee = async () => {
+  const response = await getFee({
+    amount: 0.1,
+    // Optional parameters with defaults:
+    // appId: "rozodemo",
+    // currency: "USDC"
+  });
+
+  if (response.data) {
+    console.log("Fee:", response.data.fee);
+    console.log("Fee Percentage:", response.data.feePercentage);
+    console.log("Amount Out:", response.data.amount_out);
+    console.log("Minimum Fee:", response.data.minimumFee);
+  } else if (response.error) {
+    console.error("Error calculating fee:", response.error.message);
+    // Error response includes details like max allowed amount
+  }
+};
+
+// With custom appId and currency
+const response = await getFee({
+  amount: 100,
+  appId: "myapp",
+  currency: "USDC",
+});
+```
+
 ## Available Payment Functions
 
-- `createRozoPayment(paymentData)` - Create a new payment
-- `getRozoPayment(paymentId)` - Get payment by ID
-- `getRozoPaymentByExternalId(externalId)` - Get payment by external ID
-- `updateRozoPayment(paymentId, paymentData)` - Update a payment
-- `cancelRozoPayment(paymentId)` - Cancel a payment
-- `listRozoPayments(params?)` - List all payments with optional filters
-- `createRozoPaymentRequest(options)` - Create a payment request payload
+- **`createRozoPayment(paymentData: PaymentRequestData)`** - Create a new cross-chain payment. Requires `appId`, `display`, and `destination`. Use `createPaymentBridgeConfig` to generate `preferred` and `destination` configurations. Returns `ApiResponse<PaymentResponseData>` with payment ID, status, and URL.
+
+- **`getRozoPayment(paymentId: string)`** - Get payment details by ID. Automatically handles both standard payment IDs and MugglePay order IDs. Returns `ApiResponse<PaymentResponseData>` with full payment information including status, destination, and transaction hashes.
+
+### Helper Functions
+
+- **`createPaymentBridgeConfig(config: PaymentBridgeConfig)`** - Creates payment bridge configuration for cross-chain payments. Determines preferred payment method (source chain/token) and destination configuration. The `payInTokenAddress` parameter supports: USDC Base, USDC Polygon, USDC Solana, USDC Stellar, and USDT BNB. Returns `{ preferred: PreferredPaymentConfig, destination: DestinationConfig }`.
+
+- **`mergedMetadata(...metadataObjects)`** - Utility function to merge multiple metadata objects while handling conflicts and filtering sensitive fields.
+
+## Available Fee Functions
+
+- `getFee(params)` - Calculate fee for a payment amount (amount required, appId and currency optional)
 
 ## Best Practices
 

package/src/api/fee.ts

@@ -0,0 +1,80 @@
+import { ApiResponse } from "./base";
+
+/**
+ * Fee response data type (success case)
+ */
+export interface FeeResponseData {
+  appId: string;
+  amount: number;
+  currency: string;
+  fee: number;
+  feePercentage: string;
+  minimumFee: string;
+  amount_out: number;
+}
+
+/**
+ * Fee error response data type
+ */
+export interface FeeErrorData {
+  error: string;
+  message: string;
+  received: number;
+  maxAllowed: number;
+}
+
+/**
+ * Fee request parameters
+ */
+export interface GetFeeParams {
+  amount: number;
+  appId?: string;
+  currency?: string;
+}
+
+/**
+ * Gets fee calculation for a payment amount
+ * @param params - Fee calculation parameters (amount is required)
+ * @returns Promise with fee response or error
+ */
+export const getFee = async (
+  params: GetFeeParams
+): Promise<ApiResponse<FeeResponseData>> => {
+  const { amount, appId = "rozodemo", currency = "USDC" } = params;
+
+  try {
+    const queryParams = new URLSearchParams({
+      amount: amount.toString(),
+      appId,
+      currency,
+    });
+
+    const response = await fetch(
+      `https://intentapi.rozo.ai/getFee?${queryParams.toString()}`
+    );
+
+    const data = (await response.json()) as FeeResponseData | FeeErrorData;
+
+    // Check if response contains an error
+    if (!response.ok || "error" in data) {
+      const errorData = data as FeeErrorData;
+      return {
+        data: null,
+        error: new Error(errorData.message || errorData.error),
+        status: response.status,
+      };
+    }
+
+    return {
+      data: data as FeeResponseData,
+      error: null,
+      status: response.status,
+    };
+  } catch (error) {
+    return {
+      data: null,
+      error: error instanceof Error ? error : new Error(String(error)),
+      status: null,
+    };
+  }
+};

package/src/bridge.ts

@@ -14,6 +14,7 @@ import {
   rozoSolanaUSDC,
   rozoStellar,
   rozoStellarUSDC,
+  worldchainUSDC,
 } from ".";
 import type { PaymentResponseData } from "./api/payment";
 
@@ -50,11 +51,11 @@ export interface DestinationConfig {
  * the complexity of multi-chain payments by:
  *
  * 1. **Preferred Payment Method**: Identifies which chain/token the user will pay from
- *    - Supports Base USDC, Polygon USDC, Solana USDC, Stellar USDC, and BSC USDT
+ *    - Supports Base USDC, Polygon USDC, Solana USDC, Stellar USDC, Worldchain USDC, and BSC USDT
  *    - Sets appropriate chain ID and token address for the source transaction
  *
  * 2. **Destination Configuration**: Determines where funds will be received
- *    - Supports Base, Solana, and Stellar as destination chains
+ *    - Supports Base, Solana, Stellar, and Worldchain as destination chains
  *    - Handles special address formats for Solana and Stellar addresses
  *    - Defaults to Base USDC when no special destination is specified
  *
@@ -177,6 +178,15 @@ export function createPaymentBridgeConfig({
           preferredTokenAddress: `USDC:${rozoStellarUSDC.token}`,
         };
       }
+      // Pay In USDC Worldchain
+      else if (payInTokenAddress === worldchainUSDC.token) {
+        log?.(`[Payment Bridge] Pay In USDC Worldchain`);
+        preferred = {
+          preferredChain: String(worldchainUSDC.chainId),
+          preferredToken: "USDC",
+          preferredTokenAddress: worldchainUSDC.token,
+        };
+      }
       // Pay In USDT BSC
       else if (payInTokenAddress === bscUSDT.token) {
         log?.(`[Payment Bridge] Pay In USDT BSC`);

package/src/index.ts

@@ -1,3 +1,4 @@
+export * from "./api/fee";
 export * from "./api/payment";
 export * from "./assert";
 export * from "./bridge";