@rozoai/intent-common 0.0.31 → 0.0.32-beta.2

package/dist/api/payment.d.ts

@@ -80,14 +80,112 @@ export interface PaymentResponseData {
     [key: string]: unknown;
 }
 /**
- * Creates a new payment
- * @param paymentData - Payment data to send
- * @returns Promise with payment response
+ * Simplified interface for creating a payment bridge
  */
-export declare const createRozoPayment: (paymentData: PaymentRequestData) => Promise<ApiResponse<PaymentResponseData>>;
+export interface CreatePaymentBridgeParams {
+    /** App ID for authentication */
+    appId: string;
+    /** Destination chain ID (e.g., 8453 for Base, 900 for Solana, 10001 for Stellar) */
+    toChain: number;
+    /** Destination token address */
+    toToken: string;
+    /** Destination address - Can be EVM, Solana, or Stellar address */
+    toAddress: string;
+    /** Chain ID where user will pay from (e.g., 137 for Polygon, 8453 for Base) */
+    preferredChain: number;
+    /** Token address user will pay with */
+    preferredTokenAddress: string;
+    /** Amount in human-readable units (e.g., "1" for 1 USDC, "0.5" for half a USDC) */
+    toUnits?: string;
+    /** Additional metadata to include */
+    metadata?: Record<string, unknown>;
+}
 /**
  * Gets payment details by ID
  * @param paymentId - Payment ID
  * @returns Promise with payment response
  */
 export declare const getRozoPayment: (paymentId: string) => Promise<ApiResponse<PaymentResponseData>>;
+/**
+ * Creates a payment bridge configuration and initiates a Rozo payment
+ *
+ * This function combines the payment bridge configuration logic with payment creation,
+ * handling cross-chain payment routing and metadata merging. It provides a simplified
+ * API that doesn't require understanding internal types like WalletPaymentOption.
+ *
+ * @param params - Payment bridge creation parameters
+ * @returns Promise resolving to the payment response data
+ * @throws Error if payment creation fails or required parameters are missing
+ *
+ * @example
+ * ```typescript
+ * // Simple same-chain payment
+ * const payment = await createPaymentBridge({
+ *   toChain: 8453, // Base
+ *   toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+ *   preferredChainId: 8453, // User pays from Base
+ *   preferredToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toUnits: "1", // 1 USDC
+ *   appId: "my-app-id",
+ *   intent: "Pay",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Cross-chain payment: Polygon to Base
+ * const payment = await createPaymentBridge({
+ *   toChain: 8453, // Base (destination)
+ *   toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+ *   preferredChainId: 137, // Polygon (user pays from)
+ *   preferredToken: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174", // Polygon USDC
+ *   toUnits: "1",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Payment to Solana address (payout → Solana)
+ * const payment = await createPaymentBridge({
+ *   toChain: 900, // Solana
+ *   toToken: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // Solana USDC
+ *   toAddress: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", // Solana address
+ *   preferredChainId: 8453, // User pays from Base
+ *   preferredToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toUnits: "1",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Payment paid in from Stellar account
+ * const payment = await createPaymentBridge({
+ *   toChain: 8453, // Payout on Base
+ *   toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", // EVM address
+ *   preferredChainId: 1500, // Pay in from Stellar
+ *   preferredToken: "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", // Stellar USDC (token format: code:issuer)
+ *   toUnits: "10",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Payment paying out to Stellar address (payout → Stellar)
+ * const payment = await createPaymentBridge({
+ *   toChain: 1500, // Stellar
+ *   toToken: "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", // Stellar USDC (token format: code:issuer)
+ *   toAddress: "GA5ZSEPRY3STUGUUXZGHV5CDEQ2AJGEAAUUMSZK2QIPICFL2JVP4X6T4", // Stellar address
+ *   preferredChainId: 8453, // User pays from Base
+ *   preferredToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toUnits: "1",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ */
+export declare function createRozoPayment(params: CreatePaymentBridgeParams): Promise<PaymentResponseData>;

package/dist/api/payment.js

@@ -1,16 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRozoPayment = exports.createRozoPayment = void 0;
-const base_1 = require("./base");
-/**
- * Creates a new payment
- * @param paymentData - Payment data to send
- * @returns Promise with payment response
- */
-const createRozoPayment = (paymentData) => {
-    return base_1.apiClient.post("/payment-api", paymentData);
-};
+exports.getRozoPayment = void 0;
 exports.createRozoPayment = createRozoPayment;
+const bridge_1 = require("../bridge");
+const base_1 = require("./base");
 /**
  * Gets payment details by ID
  * @param paymentId - Payment ID
@@ -24,4 +17,118 @@ const getRozoPayment = (paymentId) => {
     return base_1.apiClient.get(endpoint);
 };
 exports.getRozoPayment = getRozoPayment;
+/**
+ * Creates a payment bridge configuration and initiates a Rozo payment
+ *
+ * This function combines the payment bridge configuration logic with payment creation,
+ * handling cross-chain payment routing and metadata merging. It provides a simplified
+ * API that doesn't require understanding internal types like WalletPaymentOption.
+ *
+ * @param params - Payment bridge creation parameters
+ * @returns Promise resolving to the payment response data
+ * @throws Error if payment creation fails or required parameters are missing
+ *
+ * @example
+ * ```typescript
+ * // Simple same-chain payment
+ * const payment = await createPaymentBridge({
+ *   toChain: 8453, // Base
+ *   toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+ *   preferredChainId: 8453, // User pays from Base
+ *   preferredToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toUnits: "1", // 1 USDC
+ *   appId: "my-app-id",
+ *   intent: "Pay",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Cross-chain payment: Polygon to Base
+ * const payment = await createPaymentBridge({
+ *   toChain: 8453, // Base (destination)
+ *   toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+ *   preferredChainId: 137, // Polygon (user pays from)
+ *   preferredToken: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174", // Polygon USDC
+ *   toUnits: "1",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Payment to Solana address (payout → Solana)
+ * const payment = await createPaymentBridge({
+ *   toChain: 900, // Solana
+ *   toToken: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // Solana USDC
+ *   toAddress: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", // Solana address
+ *   preferredChainId: 8453, // User pays from Base
+ *   preferredToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toUnits: "1",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Payment paid in from Stellar account
+ * const payment = await createPaymentBridge({
+ *   toChain: 8453, // Payout on Base
+ *   toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", // EVM address
+ *   preferredChainId: 1500, // Pay in from Stellar
+ *   preferredToken: "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", // Stellar USDC (token format: code:issuer)
+ *   toUnits: "10",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Payment paying out to Stellar address (payout → Stellar)
+ * const payment = await createPaymentBridge({
+ *   toChain: 1500, // Stellar
+ *   toToken: "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", // Stellar USDC (token format: code:issuer)
+ *   toAddress: "GA5ZSEPRY3STUGUUXZGHV5CDEQ2AJGEAAUUMSZK2QIPICFL2JVP4X6T4", // Stellar address
+ *   preferredChainId: 8453, // User pays from Base
+ *   preferredToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+ *   toUnits: "1",
+ *   appId: "my-app-id",
+ * });
+ * ```
+ */
+async function createRozoPayment(params) {
+    const { toChain, toToken, toAddress, preferredChain, preferredTokenAddress, toUnits, appId, metadata, } = params;
+    // Create payment bridge configuration
+    const { preferred, destination, isIntentPayment } = (0, bridge_1.createPaymentBridgeConfig)({
+        toChain,
+        toToken,
+        toAddress,
+        toUnits: toUnits ?? "0",
+        // Preferred payment method (what user will pay with)
+        preferredChain,
+        preferredTokenAddress,
+    });
+    // Build payment request data
+    const paymentData = {
+        appId,
+        display: {
+            intent: "",
+            paymentValue: String(toUnits ?? ""),
+            currency: "USD",
+        },
+        destination,
+        ...preferred,
+        ...(metadata ?? {}),
+        ...(isIntentPayment ? { intents: true } : {}),
+    };
+    // Create payment via API
+    const response = await base_1.apiClient.post("/payment-api", paymentData);
+    if (!response?.data?.id) {
+        throw new Error(response?.error?.message ?? "Payment creation failed");
+    }
+    return response.data;
+}
 //# sourceMappingURL=payment.js.map

package/dist/api/payment.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/api/payment.ts"],"names":[],"mappings":";;;AAAA,iCAAgD;AAuFhD;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAC/B,WAA+B,EACY,EAAE;IAC7C,OAAO,gBAAS,CAAC,IAAI,CAAsB,cAAc,EAAE,WAAW,CAAC,CAAC;AAC1E,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B;AAEF;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAC5B,SAAiB,EAC0B,EAAE;IAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,WAAW;QAC1B,CAAC,CAAC,eAAe,SAAS,EAAE;QAC5B,CAAC,CAAC,cAAc,SAAS,EAAE,CAAC;IAC9B,OAAO,gBAAS,CAAC,GAAG,CAAsB,QAAQ,CAAC,CAAC;AACtD,CAAC,CAAC;AARW,QAAA,cAAc,kBAQzB"}
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/api/payment.ts"],"names":[],"mappings":";;;AAsNA,8CAmDC;AAzQD,sCAAsD;AACtD,iCAAgD;AAoHhD;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAC5B,SAAiB,EAC0B,EAAE;IAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,WAAW;QAC1B,CAAC,CAAC,eAAe,SAAS,EAAE;QAC5B,CAAC,CAAC,cAAc,SAAS,EAAE,CAAC;IAC9B,OAAO,gBAAS,CAAC,GAAG,CAAsB,QAAQ,CAAC,CAAC;AACtD,CAAC,CAAC;AARW,QAAA,cAAc,kBAQzB;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAAiC;IAEjC,MAAM,EACJ,OAAO,EACP,OAAO,EACP,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,OAAO,EACP,KAAK,EACL,QAAQ,GACT,GAAG,MAAM,CAAC;IACX,sCAAsC;IACtC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,IAAA,kCAAyB,EAC3E;QACE,OAAO;QACP,OAAO;QACP,SAAS;QACT,OAAO,EAAE,OAAO,IAAI,GAAG;QACvB,qDAAqD;QACrD,cAAc;QACd,qBAAqB;KACtB,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,WAAW,GAAuB;QACtC,KAAK;QACL,OAAO,EAAE;YACP,MAAM,EAAE,EAAE;YACV,YAAY,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;YACnC,QAAQ,EAAE,KAAK;SAChB;QACD,WAAW;QACX,GAAG,SAAS;QACZ,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;QACnB,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;IAEF,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,gBAAS,CAAC,IAAI,CACnC,cAAc,EACd,WAAW,CACZ,CAAC;IAEF,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,IAAI,yBAAyB,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/dist/bridge.d.ts

@@ -1,19 +1,17 @@
 import { RozoPayHydratedOrderWithOrg } from ".";
 import type { PaymentResponseData } from "./api/payment";
 export interface PaymentBridgeConfig {
-    toChain?: number;
-    toToken?: string;
+    toChain: number;
+    toToken: string;
     toAddress: string;
-    toStellarAddress?: string;
-    toSolanaAddress?: string;
     toUnits: string;
-    payInTokenAddress: string;
-    log?: (msg: string) => void;
+    preferredChain: number;
+    preferredTokenAddress: string;
 }
 export interface PreferredPaymentConfig {
     preferredChain: string;
-    preferredToken: "USDC" | "USDT" | "XLM";
-    preferredTokenAddress?: string;
+    preferredToken: string;
+    preferredTokenAddress: string;
 }
 export interface DestinationConfig {
     destinationAddress?: string;
@@ -22,79 +20,117 @@ export interface DestinationConfig {
     tokenSymbol: string;
     tokenAddress: string;
 }
+interface PaymentBridge {
+    preferred: PreferredPaymentConfig;
+    destination: DestinationConfig;
+    isIntentPayment: boolean;
+}
 /**
  * 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
+ * and the preferred payment method 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, Worldchain USDC, and BSC USDT
+ *    - Supports Base USDC, Polygon USDC, Ethereum 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, 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
+ *    - Automatically handles special address formats for Solana and Stellar addresses
+ *    - Configures destination token based on chain type (e.g., Stellar/Solana USDC)
  *
- * 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)
+ * 3. **Intent Payment Detection**: Determines if this is a cross-chain intent payment
+ *    - Returns `isIntentPayment: true` when preferred chain/token differs from destination
+ *    - Returns `isIntentPayment: false` for same-chain, same-token payments
  *
  * @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
+ * @param config.toChain - Destination chain ID (e.g., 8453 for Base, 900 for Solana, 10001 for Stellar)
+ * @param config.toToken - Destination token address (must be a supported token on the destination chain)
+ * @param config.toAddress - Destination address (format validated based on chain type: EVM 0x..., Solana Base58, Stellar G...)
+ * @param config.toUnits - Amount in human-readable units (e.g., "1" for 1 USDC, "0.5" for half a USDC)
+ * @param config.preferredChain - Chain ID where the user will pay from (e.g., 137 for Polygon, 8453 for Base)
+ * @param config.preferredTokenAddress - Token address the user selected to pay with (must be a supported token on preferredChain)
+ *
+ * @returns Payment routing configuration object
  * @returns preferred - Source payment configuration (chain, token user will pay from)
+ * @returns preferred.preferredChain - Chain ID as string where payment originates
+ * @returns preferred.preferredToken - Token symbol (e.g., "USDC", "USDT")
+ * @returns preferred.preferredTokenAddress - Token contract address
  * @returns destination - Destination payment configuration (chain, token user will receive)
+ * @returns destination.destinationAddress - Address where funds will be received
+ * @returns destination.chainId - Destination chain ID as string
+ * @returns destination.amountUnits - Payment amount in token units
+ * @returns destination.tokenSymbol - Destination token symbol
+ * @returns destination.tokenAddress - Destination token contract address
+ * @returns isIntentPayment - Boolean indicating if this is a cross-chain intent payment
+ *
+ * @throws {Error} If the destination token is not supported for the destination chain
+ * @throws {Error} If the destination address format is invalid for the destination chain
+ * @throws {Error} If the preferred token is not supported for the preferred chain
+ * @throws {Error} If the destination chain or token is not supported
  *
  * @example
  * ```typescript
  * // User wants to pay with Polygon USDC to receive on Base
- * const { preferred, destination } = createPaymentBridgeConfig({
- *   toChain: 8453, // Base
+ * import { baseUSDC, polygonUSDCe } from '@rozoai/intent-common';
+ * import { base, polygon } from '@rozoai/intent-common';
+ *
+ * const { preferred, destination, isIntentPayment } = createPaymentBridgeConfig({
+ *   toChain: base.chainId, // 8453
  *   toToken: baseUSDC.token,
- *   toAddress: '0x123...',
- *   toUnits: '1000000', // 1 USDC
- *   payInTokenAddress: polygonUSDC.token,
- *   log: console.log
+ *   toAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+ *   toUnits: '1000000', // 1 USDC (6 decimals)
+ *   preferredChain: polygon.chainId, // 137
+ *   preferredToken: polygonUSDCe.token,
  * });
  *
- * // preferred = { preferredChain: '137', preferredToken: 'USDC', preferredTokenAddress: '0x2791...' }
- * // destination = { destinationAddress: '0x123...', chainId: '8453', amountUnits: '1000000', ... }
+ * // preferred = { preferredChain: '137', preferredToken: 'USDCe', preferredTokenAddress: '0x2791...' }
+ * // destination = { destinationAddress: '0x742d...', chainId: '8453', amountUnits: '1000000', tokenSymbol: 'USDC', tokenAddress: '0x8335...' }
+ * // isIntentPayment = true (different chains)
  * ```
  *
  * @example
  * ```typescript
- * // User wants to pay to a Stellar address
- * const { preferred, destination } = createPaymentBridgeConfig({
- *   toStellarAddress: 'GDZS...',
- *   toUnits: '1000000',
- *   payInTokenAddress: baseUSDC.token,
+ * // User wants to pay to a Stellar address using Base USDC
+ * import { baseUSDC, rozoStellarUSDC } from '@rozoai/intent-common';
+ * import { base, rozoStellar } from '@rozoai/intent-common';
+ *
+ * const { preferred, destination, isIntentPayment } = createPaymentBridgeConfig({
+ *   toChain: rozoStellar.chainId, // 10001
+ *   toToken: rozoStellarUSDC.token,
+ *   toAddress: 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',
+ *   toUnits: '10000000', // 1 USDC (7 decimals for Stellar)
+ *   preferredChain: base.chainId, // 8453
+ *   preferredToken: baseUSDC.token,
  * });
  *
- * // destination will be configured for Stellar chain with USDC:issuerPK format
+ * // preferred = { preferredChain: '8453', preferredToken: 'USDC', preferredTokenAddress: '0x8335...' }
+ * // destination = { destinationAddress: 'GA5Z...', chainId: '10001', amountUnits: '10000000', tokenSymbol: 'USDC', tokenAddress: 'USDC:GA5Z...' }
+ * // isIntentPayment = true (Base to Stellar)
  * ```
  *
- * @note Currently only supports Base USDC and Stellar USDC as destination chains.
- *       Support for additional destination chains is planned.
+ * @example
+ * ```typescript
+ * // Same-chain payment (not an intent payment)
+ * const { preferred, destination, isIntentPayment } = createPaymentBridgeConfig({
+ *   toChain: base.chainId, // 8453
+ *   toToken: baseUSDC.token,
+ *   toAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+ *   toUnits: '1000000',
+ *   preferredChain: base.chainId, // 8453
+ *   preferredToken: baseUSDC.token,
+ * });
+ *
+ * // isIntentPayment = false (same chain and token)
+ * ```
  *
  * @see PreferredPaymentConfig
  * @see DestinationConfig
+ * @see PaymentBridgeConfig
  */
-export declare function createPaymentBridgeConfig({ toChain, toToken, toAddress, toStellarAddress, toSolanaAddress, toUnits, payInTokenAddress, log, }: PaymentBridgeConfig): {
-    preferred: PreferredPaymentConfig;
-    destination: DestinationConfig;
-};
+export declare function createPaymentBridgeConfig({ toChain, toToken, toAddress, toUnits, preferredChain, preferredTokenAddress, }: PaymentBridgeConfig): PaymentBridge;
 /**
  * Transforms a payment API response into a fully hydrated order object
  *
@@ -162,3 +198,4 @@ export declare function createPaymentBridgeConfig({ toChain, toToken, toAddress,
  * @see getKnownToken
  */
 export declare function formatResponseToHydratedOrder(order: PaymentResponseData): RozoPayHydratedOrderWithOrg;
+export {};