@rozoai/intent-common 0.0.28-beta.2 → 0.0.28-beta.3

package/dist/bridge.js

@@ -0,0 +1,316 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPaymentBridgeConfig = createPaymentBridgeConfig;
+exports.formatResponseToHydratedOrder = formatResponseToHydratedOrder;
+const viem_1 = require("viem");
+const _1 = require(".");
+/**
+ * Creates payment bridge configuration for cross-chain payment routing
+ *
+ * Determines the optimal payment routing based on the destination chain/token
+ * and the wallet payment option selected by the user. This function handles
+ * 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
+ *    - 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
+ *    - Handles special address formats for Solana and Stellar addresses
+ *    - Defaults to Base USDC when no special destination is specified
+ *
+ * 3. **Cross-Chain Bridging**: Configures the payment bridge parameters
+ *    - Maps user's selected wallet/token to the appropriate payment method
+ *    - Sets up destination chain and token configuration
+ *    - Handles token address formatting (e.g., Stellar's `USDC:issuerPK` format)
+ *
+ * @param config - Payment bridge configuration parameters
+ * @param config.toChain - Destination chain ID (defaults to Base: 8453)
+ * @param config.toToken - Destination token address (defaults to Base USDC)
+ * @param config.toAddress - Standard EVM destination address
+ * @param config.toStellarAddress - Stellar-specific destination address (if paying to Stellar)
+ * @param config.toSolanaAddress - Solana-specific destination address (if paying to Solana)
+ * @param config.toUnits - Amount in token units (smallest denomination)
+ * @param config.payInTokenAddress - Token address user selected to pay with
+ * @param config.log - Optional logging function for debugging
+ *
+ * @returns Payment routing configuration
+ * @returns preferred - Source payment configuration (chain, token user will pay from)
+ * @returns destination - Destination payment configuration (chain, token user will receive)
+ *
+ * @example
+ * ```typescript
+ * // User wants to pay with Polygon USDC to receive on Base
+ * const { preferred, destination } = createPaymentBridgeConfig({
+ *   toChain: 8453, // Base
+ *   toToken: baseUSDC.token,
+ *   toAddress: '0x123...',
+ *   toUnits: '1000000', // 1 USDC
+ *   payInTokenAddress: polygonUSDC.token,
+ *   log: console.log
+ * });
+ *
+ * // preferred = { preferredChain: '137', preferredToken: 'USDC', preferredTokenAddress: '0x2791...' }
+ * // destination = { destinationAddress: '0x123...', chainId: '8453', amountUnits: '1000000', ... }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // User wants to pay to a Stellar address
+ * const { preferred, destination } = createPaymentBridgeConfig({
+ *   toStellarAddress: 'GDZS...',
+ *   toUnits: '1000000',
+ *   payInTokenAddress: baseUSDC.token,
+ * });
+ *
+ * // destination will be configured for Stellar chain with USDC:issuerPK format
+ * ```
+ *
+ * @note Currently only supports Base USDC and Stellar USDC as destination chains.
+ *       Support for additional destination chains is planned.
+ *
+ * @see PreferredPaymentConfig
+ * @see DestinationConfig
+ */
+function createPaymentBridgeConfig({ toChain = _1.baseUSDC.chainId, toToken = _1.baseUSDC.token, toAddress, toStellarAddress, toSolanaAddress, toUnits, payInTokenAddress, log, }) {
+    // Default configuration for Base USDC payments
+    let preferred = {
+        preferredChain: String(toChain),
+        preferredToken: "USDC",
+    };
+    let destination = {
+        destinationAddress: toAddress,
+        chainId: String(toChain),
+        amountUnits: toUnits,
+        tokenSymbol: "USDC",
+        tokenAddress: toToken,
+    };
+    /**
+     * IMPORTANT: Because we only support PAY OUT USDC BASE & STELLAR
+     * So, We force toChain and toToken to Base USDC as default PayParams
+     *
+     * @TODO: Adjust this when we support another PAY OUT chain
+     */
+    if (toChain === _1.base.chainId && toToken === _1.baseUSDC.token) {
+        // Determine preferred payment method based on wallet selection
+        if (payInTokenAddress) {
+            // Pay In USDC Polygon
+            if (payInTokenAddress === _1.polygonUSDC.token) {
+                log?.(`[Payment Bridge] Pay In USDC Polygon`);
+                preferred = {
+                    preferredChain: String(_1.polygonUSDC.chainId),
+                    preferredToken: "USDC",
+                    preferredTokenAddress: _1.polygonUSDC.token,
+                };
+            }
+            // Pay In USDC Solana
+            else if (payInTokenAddress === _1.rozoSolanaUSDC.token) {
+                log?.(`[Payment Bridge] Pay In USDC Solana`);
+                preferred = {
+                    preferredChain: String(_1.rozoSolanaUSDC.chainId),
+                    preferredToken: "USDC",
+                    preferredTokenAddress: _1.rozoSolanaUSDC.token,
+                };
+            }
+            // Pay In USDC Stellar
+            else if (payInTokenAddress === _1.rozoStellarUSDC.token) {
+                log?.(`[Payment Bridge] Pay In USDC Stellar`);
+                preferred = {
+                    preferredChain: String(_1.rozoStellarUSDC.chainId),
+                    preferredToken: "USDC",
+                    preferredTokenAddress: `USDC:${_1.rozoStellarUSDC.token}`,
+                };
+            }
+            // Pay In USDT BSC
+            else if (payInTokenAddress === _1.bscUSDT.token) {
+                log?.(`[Payment Bridge] Pay In USDT BSC`);
+                preferred = {
+                    preferredChain: String(_1.bscUSDT.chainId),
+                    preferredToken: "USDT",
+                    preferredTokenAddress: _1.bscUSDT.token,
+                };
+            }
+        }
+        // Determine destination based on special address types
+        if (toStellarAddress) {
+            log?.(`[Payment Bridge] Pay Out USDC Stellar`);
+            destination = {
+                destinationAddress: toStellarAddress,
+                chainId: String(_1.rozoStellar.chainId),
+                amountUnits: toUnits,
+                tokenSymbol: "USDC",
+                tokenAddress: `USDC:${_1.rozoStellarUSDC.token}`,
+            };
+        }
+        else if (toSolanaAddress) {
+            log?.(`[Payment Bridge] Pay Out USDC Solana`);
+            destination = {
+                destinationAddress: toSolanaAddress,
+                chainId: String(_1.rozoSolanaUSDC.chainId),
+                amountUnits: toUnits,
+                tokenSymbol: "USDC",
+                tokenAddress: _1.rozoSolanaUSDC.token,
+            };
+        }
+        else {
+            log?.(`[Payment Bridge] Pay Out USDC Base`);
+            // Keep default Base configuration
+        }
+    }
+    return { preferred, destination };
+}
+/**
+ * Transforms a payment API response into a fully hydrated order object
+ *
+ * Converts the payment response data from the RozoAI payment API into a complete
+ * `RozoPayHydratedOrderWithOrg` object that contains all the information needed
+ * to display order status, track payments, and handle cross-chain transactions.
+ *
+ * This function performs several key transformations:
+ *
+ * 1. **Token Resolution**: Identifies the correct token based on chain and address
+ *    - Uses `getKnownToken()` to resolve token metadata (decimals, symbol, logo, etc.)
+ *    - Handles special cases for Stellar tokens using issuer public key
+ *
+ * 2. **Order Structure**: Creates a complete order with all required fields
+ *    - Generates random order ID for internal tracking
+ *    - Sets up intent, handoff, and contract addresses
+ *    - Configures bridge token options and destination amounts
+ *
+ * 3. **Status Initialization**: Sets initial payment statuses
+ *    - Source status: WAITING_PAYMENT (awaiting user transaction)
+ *    - Destination status: PENDING (not yet received)
+ *    - Intent status: UNPAID (payment not initiated)
+ *
+ * 4. **Metadata Merge**: Combines various metadata sources
+ *    - Merges order metadata, user metadata, and custom metadata
+ *    - Preserves external ID and organization information
+ *
+ * @param order - Payment response data from the RozoAI payment API
+ * @param order.metadata - Payment metadata including chain, token, and routing info
+ * @param order.destination - Destination configuration (chain, token, amount, address)
+ * @param order.source - Source transaction info (if payment has been initiated)
+ * @param order.orgId - Organization ID for the payment
+ * @param order.externalId - External reference ID (if provided by merchant)
+ *
+ * @returns Complete hydrated order object with all payment tracking information
+ * @returns id - Unique order identifier (random BigInt)
+ * @returns mode - Order mode (HYDRATED)
+ * @returns sourceStatus - Source transaction status
+ * @returns destStatus - Destination transaction status
+ * @returns intentStatus - Overall payment intent status
+ * @returns metadata - Merged metadata from all sources
+ * @returns org - Organization information
+ *
+ * @example
+ * ```typescript
+ * const paymentResponse = await getRozoPayment(paymentId);
+ *
+ * const hydratedOrder = formatPaymentResponseDataToHydratedOrder(
+ *   paymentResponse.data,
+ *   'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN'
+ * );
+ *
+ * console.log(hydratedOrder.sourceStatus); // 'WAITING_PAYMENT'
+ * console.log(hydratedOrder.destFinalCallTokenAmount.token.symbol); // 'USDC'
+ * console.log(hydratedOrder.usdValue); // 10.00
+ * ```
+ *
+ * @note The generated order ID is random and intended for client-side tracking only.
+ *       Use `externalId` or the API payment ID for server-side reference.
+ *
+ * @note The function sets a 5-minute expiration timestamp from the current time.
+ *
+ * @see PaymentResponseData
+ * @see RozoPayHydratedOrderWithOrg
+ * @see getKnownToken
+ */
+function formatResponseToHydratedOrder(order) {
+    const destAddress = order.metadata.receivingAddress;
+    const requiredChain = order.metadata.preferredChain || _1.baseUSDC.chainId;
+    const chain = (0, _1.getKnownToken)(Number(requiredChain), Number(requiredChain) === _1.rozoStellar.chainId
+        ? _1.rozoStellarUSDC.token
+        : order.metadata.preferredTokenAddress);
+    return {
+        id: BigInt(Math.floor(Math.random() * Number.MAX_SAFE_INTEGER)),
+        mode: _1.RozoPayOrderMode.HYDRATED,
+        intentAddr: destAddress,
+        handoffAddr: destAddress,
+        escrowContractAddress: destAddress,
+        bridgerContractAddress: destAddress,
+        // @TODO: use correct destination token
+        bridgeTokenOutOptions: [
+            {
+                token: {
+                    chainId: _1.baseUSDC.chainId,
+                    token: _1.baseUSDC.token,
+                    symbol: _1.baseUSDC.symbol,
+                    usd: 1,
+                    priceFromUsd: 1,
+                    decimals: _1.baseUSDC.decimals,
+                    displayDecimals: 2,
+                    logoSourceURI: _1.baseUSDC.logoSourceURI,
+                    logoURI: _1.baseUSDC.logoURI,
+                    maxAcceptUsd: 100000,
+                    maxSendUsd: 0,
+                },
+                amount: (0, viem_1.parseUnits)(order.destination.amountUnits, _1.baseUSDC.decimals).toString(),
+                usd: Number(order.destination.amountUnits),
+            },
+        ],
+        selectedBridgeTokenOutAddr: null,
+        selectedBridgeTokenOutAmount: null,
+        destFinalCallTokenAmount: {
+            token: {
+                chainId: chain ? chain.chainId : _1.baseUSDC.chainId,
+                token: chain ? chain.token : _1.baseUSDC.token,
+                symbol: chain ? chain.symbol : _1.baseUSDC.symbol,
+                usd: 1,
+                priceFromUsd: 1,
+                decimals: chain ? chain.decimals : _1.baseUSDC.decimals,
+                displayDecimals: 2,
+                logoSourceURI: chain ? chain.logoSourceURI : _1.baseUSDC.logoSourceURI,
+                logoURI: chain ? chain.logoURI : _1.baseUSDC.logoURI,
+                maxAcceptUsd: 100000,
+                maxSendUsd: 0,
+            },
+            amount: (0, viem_1.parseUnits)(order.destination.amountUnits, chain ? chain.decimals : _1.baseUSDC.decimals).toString(),
+            usd: Number(order.destination.amountUnits),
+        },
+        usdValue: Number(order.destination.amountUnits),
+        destFinalCall: {
+            to: destAddress,
+            value: BigInt("0"),
+            data: "0x",
+        },
+        refundAddr: order.source?.sourceAddress || null,
+        nonce: order.nonce,
+        sourceTokenAmount: null,
+        sourceFulfillerAddr: null,
+        sourceInitiateTxHash: null,
+        sourceStartTxHash: null,
+        sourceStatus: _1.RozoPayOrderStatusSource.WAITING_PAYMENT,
+        destStatus: _1.RozoPayOrderStatusDest.PENDING,
+        intentStatus: _1.RozoPayIntentStatus.UNPAID,
+        destFastFinishTxHash: null,
+        destClaimTxHash: null,
+        redirectUri: null,
+        createdAt: Math.floor(Date.now() / 1000),
+        lastUpdatedAt: Math.floor(Date.now() / 1000),
+        orgId: order.orgId,
+        metadata: {
+            ...(order?.metadata ?? {}),
+            ...(order.userMetadata ?? {}),
+            ...(order.metadata ?? {}),
+        },
+        externalId: order.externalId,
+        userMetadata: order.userMetadata,
+        expirationTs: BigInt(Math.floor(Date.now() / 1000 + 5 * 60).toString()),
+        org: {
+            orgId: order.orgId,
+            name: "Pay Rozo",
+        },
+    };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/daimoPay.d.ts

@@ -122,10 +122,6 @@ export declare const zRozoPayOrderMetadata: z.ZodObject<{
         price?: string | undefined;
         priceDetails?: string | undefined;
     }[];
-    style?: {
-        background?: string | undefined;
-    } | undefined;
-    orgLogo?: string | undefined;
     payer?: {
         preferredChains?: number[] | undefined;
         preferredTokens?: {
@@ -136,6 +132,10 @@ export declare const zRozoPayOrderMetadata: z.ZodObject<{
         paymentOptions?: string[] | undefined;
     } | undefined;
     memo?: string | undefined;
+    style?: {
+        background?: string | undefined;
+    } | undefined;
+    orgLogo?: string | undefined;
     customDeeplinkUrl?: string | undefined;
 }, {
     intent: string;
@@ -146,10 +146,6 @@ export declare const zRozoPayOrderMetadata: z.ZodObject<{
         price?: string | undefined;
         priceDetails?: string | undefined;
     }[];
-    style?: {
-        background?: string | undefined;
-    } | undefined;
-    orgLogo?: string | undefined;
     payer?: {
         preferredChains?: number[] | undefined;
         preferredTokens?: {
@@ -160,6 +156,10 @@ export declare const zRozoPayOrderMetadata: z.ZodObject<{
         paymentOptions?: string[] | undefined;
     } | undefined;
     memo?: string | undefined;
+    style?: {
+        background?: string | undefined;
+    } | undefined;
+    orgLogo?: string | undefined;
     customDeeplinkUrl?: string | undefined;
 }>;
 export type RozoPayOrderMetadata = z.infer<typeof zRozoPayOrderMetadata>;

package/dist/index.d.ts

@@ -1,4 +1,6 @@
+export * from "./api";
 export * from "./assert";
+export * from "./bridge";
 export * from "./chain";
 export * from "./daimoPay";
 export * from "./debug";

package/dist/index.js

@@ -14,7 +14,9 @@ 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"), exports);
 __exportStar(require("./assert"), exports);
+__exportStar(require("./bridge"), exports);
 __exportStar(require("./chain"), exports);
 __exportStar(require("./daimoPay"), exports);
 __exportStar(require("./debug"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,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,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,mDAAiC;AACjC,iDAA+B;AAC/B,0CAAwB;AACxB,wCAAsB"}

package/package.json

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

package/src/api/README.md

@@ -0,0 +1,275 @@
+# API Client Utility
+
+A clean, flexible TypeScript utility for handling API requests to the RozoAI API service.
+
+## Overview
+
+This utility provides a modular approach to API requests with:
+
+- A base client for core HTTP operations
+- Endpoint-specific modules for domain operations
+- TypeScript interfaces for type safety
+- Configuration management for API URLs and tokens
+- Pre-configured defaults for RozoAI API
+
+## Default Configuration
+
+The API client comes pre-configured with RozoAI production settings:
+
+```typescript
+import { ROZO_API_URL, ROZO_API_TOKEN } from "@rozoai/intent-common";
+
+console.log(ROZO_API_URL); // "https://intentapiv2.rozo.ai/functions/v1"
+console.log(ROZO_API_TOKEN); // Pre-configured production token
+```
+
+These defaults are automatically used by the API client, so you can start making requests immediately without any configuration.
+
+## Structure
+
+```bash
+api/
+├── base.ts         # Core API client functionality
+├── index.ts        # Re-exports all API modules
+├── payment.ts      # Payment-specific endpoints
+└── README.md       # Documentation
+```
+
+## Base API Client
+
+The base client (`base.ts`) provides the foundation for all API requests:
+
+```typescript
+import { apiClient, setApiConfig } from "@rozoai/intent-common";
+
+// Configure the API client (optional, uses defaults if not set)
+setApiConfig({
+  baseUrl: "https://intentapiv2.rozo.ai/functions/v1",
+  apiToken: "your-api-token",
+});
+
+// Make a GET request
+const response = await apiClient.get("/some-endpoint");
+
+// Make a POST request with data
+const response = await apiClient.post("/some-endpoint", { data: "value" });
+
+// Make a request with custom headers
+const response = await apiClient.get("/some-endpoint", {
+  headers: { "Custom-Header": "value" },
+});
+
+// Make a request with query parameters
+const response = await apiClient.get("/some-endpoint", {
+  params: { filter: "active", sort: "desc" },
+});
+```
+
+## Using Payment API
+
+The payment module provides typed functions for payment operations:
+
+```typescript
+import {
+  createRozoPayment,
+  getRozoPayment,
+  createRozoPaymentRequest,
+} from "@rozoai/intent-common";
+
+// Create a payment
+const handleSubmitPayment = async () => {
+  const paymentData = createRozoPaymentRequest({
+    appId: "your-app-id",
+    display: {
+      intent: "Pay for product",
+      paymentValue: "100.00",
+      currency: "USD",
+    },
+    destination: {
+      chainId: "8453",
+      amountUnits: "100000000",
+      tokenSymbol: "USDC",
+      tokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    },
+  });
+
+  const response = await createRozoPayment(paymentData);
+
+  if (response.data) {
+    console.log("Payment created:", response.data.id);
+  } else if (response.error) {
+    console.error("Error creating payment:", response.error.message);
+  }
+};
+
+// Get payment details
+const fetchPaymentDetails = async (paymentId: string) => {
+  const response = await getRozoPayment(paymentId);
+
+  if (response.data) {
+    console.log("Payment status:", response.data.status);
+  }
+};
+```
+
+## React Hooks
+
+React hooks for these APIs are available in the `@rozoai/intent-pay` package:
+
+```typescript
+// In @rozoai/intent-pay
+import {
+  useCreateRozoPayment,
+  useRozoPayment,
+  useRozoPayments
+} from '@rozoai/intent-pay';
+
+// Use in React components
+const PaymentForm = () => {
+  const [paymentState, submitPayment] = useCreateRozoPayment();
+
+  const handleSubmit = (formData) => {
+    submitPayment({
+      appId: 'your-app-id',
+      display: { ... },
+      destination: { ... }
+    });
+  };
+
+  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>;
+
+  return <FormComponent onSubmit={handleSubmit} />;
+};
+```
+
+## Error Handling
+
+All API responses include standardized error handling:
+
+```typescript
+const response = await createRozoPayment(data);
+
+if (response.error) {
+  // Handle error
+  console.error("API Error:", response.error.message);
+  return;
+}
+
+// Process successful response
+const paymentData = response.data;
+```
+
+## TypeScript Integration
+
+All functions are fully typed:
+
+```typescript
+import { PaymentResponseData, ApiResponse } from "@rozoai/intent-common";
+
+const response: ApiResponse<PaymentResponseData> = await getRozoPayment(
+  paymentId
+);
+// response.data will be typed as PaymentResponseData | null
+```
+
+## Configuration
+
+### Using Default Configuration
+
+The API client is pre-configured with production RozoAI settings, so you can use it immediately:
+
+```typescript
+import { createRozoPayment } from "@rozoai/intent-common";
+
+// Works out of the box with default configuration
+const response = await createRozoPayment({
+  appId: "your-app-id",
+  display: { intent: "Payment", paymentValue: "10.00", currency: "USD" },
+  destination: {
+    chainId: "8453",
+    amountUnits: "10000000",
+    tokenSymbol: "USDC",
+  },
+});
+```
+
+### Customizing Configuration
+
+For testing, staging, or custom environments, you can override the defaults:
+
+```typescript
+import {
+  setApiConfig,
+  getApiConfig,
+  ROZO_API_URL,
+  ROZO_API_TOKEN,
+} from "@rozoai/intent-common";
+
+// Override for staging environment
+setApiConfig({
+  baseUrl: "https://staging-api.rozo.ai/v1",
+  apiToken: "your-staging-token",
+});
+
+// Or reset to production defaults
+setApiConfig({
+  baseUrl: ROZO_API_URL,
+  apiToken: ROZO_API_TOKEN,
+});
+
+// Get current configuration
+const config = getApiConfig();
+console.log(config.baseUrl, config.apiToken);
+```
+
+### Configuration in Different Environments
+
+**Production (Default):**
+
+```typescript
+// No configuration needed - uses ROZO_API_URL and ROZO_API_TOKEN automatically
+import { createRozoPayment } from "@rozoai/intent-common";
+const response = await createRozoPayment(data);
+```
+
+**Staging:**
+
+```typescript
+import { setApiConfig } from "@rozoai/intent-common";
+
+setApiConfig({
+  baseUrl: "https://staging.intentapi.rozo.ai/v1",
+  apiToken: process.env.STAGING_API_TOKEN,
+});
+```
+
+**Development/Testing:**
+
+```typescript
+import { setApiConfig } from "@rozoai/intent-common";
+
+setApiConfig({
+  baseUrl: "http://localhost:3000/api",
+  apiToken: "dev_token",
+});
+```
+
+## 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
+
+## Best Practices
+
+- Configure the API client once at app initialization
+- Leverage TypeScript interfaces for type safety
+- Handle loading, error, and success states properly
+- Use the React hooks (from @rozoai/intent-pay) when working in React components
+- Implement proper error handling for all API calls