@rozoai/intent-common 0.1.3 → 0.1.4

package/src/api/payment.ts

@@ -1,483 +0,0 @@
-import { createPaymentBridgeConfig } from "../bridge-utils";
-import { getChainById } from "../chain";
-import { getKnownToken } from "../token";
-import { apiClient, ApiResponse, ApiVersion, setApiConfig } from "./base";
-
-/**
- * FeeType, Fee calculation type:
- * - exactIn (default): Fee deducted from input, recipient receives amount - fee
- * - exactOut: Fee added to input, recipient receives exact amount
- */
-export enum FeeType {
-  ExactIn = "exactIn",
-  ExactOut = "exactOut",
-}
-
-/**
- * PaymentStatus, Payment status
- */
-export enum PaymentStatus {
-  PaymentBounced = "payment_bounced",
-  PaymentCompleted = "payment_completed",
-  PaymentExpired = "payment_expired",
-  PaymentPayinCompleted = "payment_payin_completed",
-  PaymentPayoutCompleted = "payment_payout_completed",
-  PaymentRefunded = "payment_refunded",
-  PaymentStarted = "payment_started",
-  PaymentUnpaid = "payment_unpaid",
-}
-
-/**
- * PaymentErrorCode, Error code (only present when status is payment_bounced)
- */
-export enum PaymentErrorCode {
-  AmountTooHigh = "amountTooHigh",
-  AmountTooLow = "amountTooLow",
-  ChainUnavailable = "chainUnavailable",
-  InsufficientLiquidity = "insufficientLiquidity",
-  InvalidRecipient = "invalidRecipient",
-  MissingTrustline = "missingTrustline",
-  NetworkError = "networkError",
-  ProviderError = "providerError",
-  ServiceMaintenance = "serviceMaintenance",
-}
-
-/**
- * DestinationRequest
- */
-export interface DestinationRequest {
-  /**
-   * Receive amount (required for type=exactOut).
-   * For exactIn, this field is omitted in request and calculated in response.
-   */
-  amount?: string;
-  chainId: number;
-  /**
-   * Final recipient's wallet address
-   */
-  receiverAddress: string;
-  /**
-   * Memo for Stellar/Solana destinations
-   */
-  receiverMemo?: string;
-  /**
-   * Override default token address
-   */
-  tokenAddress?: string;
-  tokenSymbol: string;
-  [property: string]: any;
-}
-
-/**
- * DisplayInfo
- */
-export interface DisplayInfo {
-  /**
-   * Display currency
-   */
-  currency: string;
-  /**
-   * Detailed description
-   */
-  description?: string;
-  /**
-   * Short title
-   */
-  title: string;
-  [property: string]: any;
-}
-
-/**
- * SourceRequest
- */
-export interface SourceRequest {
-  /**
-   * Pay-in amount (required for type=exactIn).
-   * For exactOut, this field is omitted in request and calculated in response.
-   */
-  amount?: string;
-  chainId: number;
-  /**
-   * Override default token address
-   */
-  tokenAddress?: string;
-  tokenSymbol: string;
-  [property: string]: any;
-}
-
-/**
- * PaymentRequest
- */
-export interface CreatePaymentRequest {
-  /**
-   * Your application ID
-   */
-  appId: string;
-  destination: DestinationRequest;
-  display: DisplayInfo;
-  /**
-   * Custom metadata (max 4 KB recommended)
-   */
-  metadata?: { [key: string]: any };
-  /**
-   * Your order reference ID (for idempotency)
-   */
-  orderId?: string;
-  source: SourceRequest;
-  type?: FeeType;
-  /**
-   * Secret for HMAC-SHA256 signature verification.
-   * If not provided, a unique secret is auto-generated.
-   * The secret is returned in the response for you to store and use for verification.
-   */
-  webhookSecret?: string;
-  /**
-   * URL to receive payment status updates
-   */
-  webhookUrl?: string;
-  [property: string]: any;
-}
-
-/**
- * DestinationResponse
- */
-export interface DestinationResponse {
-  /**
-   * Amount to be sent to recipient
-   */
-  amount?: string;
-  chainId?: number;
-  /**
-   * Withdrawal confirmation time
-   */
-  confirmedAt?: Date;
-  /**
-   * Final recipient's wallet
-   */
-  receiverAddress?: string;
-  /**
-   * Memo for Stellar/Solana
-   */
-  receiverMemo?: string;
-  /**
-   * Token contract address
-   */
-  tokenAddress?: string;
-  tokenSymbol?: string;
-  /**
-   * Withdrawal transaction hash
-   */
-  txHash?: string;
-  [property: string]: any;
-}
-
-/**
- * SourceResponse
- */
-export interface SourceResponse {
-  /**
-   * Amount payer must send
-   */
-  amount?: string;
-  /**
-   * Actual amount received
-   */
-  amountReceived?: string;
-  chainId?: number;
-  /**
-   * Deposit confirmation time
-   */
-  confirmedAt?: Date;
-  /**
-   * Fee amount
-   */
-  fee?: string;
-  /**
-   * **BRIDGE ADDRESS**: This is where you must send the payment.
-   * The deposit address for the cross-chain bridge.
-   */
-  receiverAddress?: string;
-  /**
-   * **REQUIRED MEMO**: Must be included in transaction if present.
-   * Required for Stellar (chainId: 1500) and Solana (chainId: 900) deposits.
-   * The payment will fail if memo is not included when required.
-   */
-  receiverMemo?: string;
-  /**
-   * Payer's wallet address (populated after deposit)
-   */
-  senderAddress?: string;
-  /**
-   * Token contract address
-   */
-  tokenAddress?: string;
-  tokenSymbol?: string;
-  /**
-   * Deposit transaction hash
-   */
-  txHash?: string;
-  [property: string]: any;
-}
-
-/**
- * PaymentResponse
- */
-export interface PaymentResponse {
-  /**
-   * Your application ID
-   */
-  appId: string;
-  /**
-   * ISO 8601 timestamp
-   */
-  createdAt: Date;
-  destination: DestinationResponse;
-  display: DisplayInfo;
-  errorCode: PaymentErrorCode | null;
-  /**
-   * ISO 8601 timestamp (when payment expires)
-   */
-  expiresAt: Date;
-  /**
-   * Payment ID
-   */
-  id: string;
-  metadata: { [key: string]: any } | null;
-  /**
-   * Your order reference ID
-   */
-  orderId: string | null;
-  source: SourceResponse;
-  status: PaymentStatus;
-  type: FeeType;
-  /**
-   * ISO 8601 timestamp
-   */
-  updatedAt: Date;
-  /**
-   * Secret for webhook signature verification.
-   * Only present when webhookUrl was provided in the request.
-   * Store this securely to verify incoming webhook signatures.
-   */
-  webhookSecret: string | null;
-  [property: string]: any;
-}
-
-/**
- * Parameters for creating a new payment using the new backend interface
- */
-export interface CreateNewPaymentParams {
-  /** App ID for authentication */
-  appId: string;
-  // Destination (where funds will be received)
-  /** Destination chain ID (e.g., 8453 for Base, 900 for Solana, 1500 for Stellar) */
-  toChain: number;
-  /** Destination token address */
-  toToken: string;
-  /** Destination address - Can be EVM, Solana, or Stellar address */
-  toAddress: string;
-
-  // Preferred payment method (what user will pay with)
-  /** 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;
-
-  // Payment details
-  /** Amount in human-readable units (e.g., "1" for 1 USDC, "0.5" for half a USDC) */
-  toUnits?: string;
-
-  // Optional fields
-  /** Additional metadata to include */
-  metadata?: Record<string, unknown>;
-  /** Display title for the payment */
-  title?: string;
-  /** Display description for the payment */
-  description?: string;
-  /** Order reference ID (for idempotency) */
-  orderId?: string;
-  /** Fee calculation type (exactIn or exactOut) */
-  feeType?: FeeType;
-  /** Webhook URL to receive payment status updates */
-  webhookUrl?: string;
-  /** Secret for HMAC-SHA256 signature verification */
-  webhookSecret?: string;
-  /** Memo for Stellar/Solana destinations */
-  receiverMemo?: string;
-  /** API version to use (v1 or v2). Defaults to v2 */
-  apiVersion?: ApiVersion;
-}
-
-/**
- * Creates a payment using the new backend interface
- *
- * This function creates a payment using the new backend API structure with
- * separate source and destination objects, enum-based chain IDs and token symbols.
- *
- * **IMPORTANT: After successfully creating a payment:**
- * - Send funds to the bridge address at `response.source.receiverAddress`
- * - If `response.source.receiverMemo` exists, it MUST be included in the transaction
- *   (required for Stellar payments with preferredChain: 1500)
- *
- * @param params - Payment 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 createPayment({
- *   toChain: 8453, // Base
- *   toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
- *   toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
- *   preferredChain: 8453, // User pays from Base
- *   preferredTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
- *   toUnits: "1", // 1 USDC
- *   appId: "my-app-id",
- *   title: "Payment",
- * });
- *
- * // Send funds to the bridge address
- * const bridgeAddress = payment.source.receiverAddress;
- * const bridgeMemo = payment.source.receiverMemo; // Required for Stellar
- * // ... perform transaction to bridgeAddress with memo (if exists)
- * ```
- */
-export async function createPayment(
-  params: CreateNewPaymentParams
-): Promise<PaymentResponse> {
-  const {
-    toChain,
-    toToken,
-    toAddress,
-    preferredChain,
-    preferredTokenAddress,
-    toUnits,
-    appId,
-    metadata,
-    title,
-    description,
-    orderId,
-    feeType,
-    webhookUrl,
-    webhookSecret,
-    receiverMemo,
-    apiVersion,
-  } = params;
-
-  // Set API version if provided
-  if (apiVersion) {
-    setApiConfig({ version: apiVersion });
-  }
-
-  // Create payment bridge configuration
-  const { preferred, destination } = createPaymentBridgeConfig({
-    toChain,
-    toToken,
-    toAddress,
-    toUnits: toUnits ?? "0",
-    // Preferred payment method (what user will pay with)
-    preferredChain,
-    preferredTokenAddress,
-  });
-
-  const sourceChain = getChainById(Number(preferred.preferredChain));
-  const sourceToken = getKnownToken(
-    Number(preferred.preferredChain),
-    preferred.preferredTokenAddress
-  );
-
-  const destinationChain = getChainById(Number(destination.chainId));
-  const destinationToken = getKnownToken(
-    Number(destination.chainId),
-    destination.tokenAddress
-  );
-  const destinationAddress = destination.destinationAddress ?? toAddress;
-
-  if (!sourceToken || !destinationToken) {
-    throw new Error("Source or destination token not found");
-  }
-
-  // Build payment request data matching new backend interface
-  const paymentData: CreatePaymentRequest = {
-    appId,
-    type: feeType ?? FeeType.ExactIn,
-    ...(orderId ? { orderId } : {}),
-    source: {
-      chainId: sourceChain.chainId,
-      tokenSymbol: sourceToken.symbol,
-      amount: destination.amountUnits, // Use same amount for source
-      ...(preferred.preferredTokenAddress
-        ? { tokenAddress: preferred.preferredTokenAddress }
-        : {}),
-    },
-    destination: {
-      chainId: destinationChain.chainId,
-      receiverAddress: destinationAddress,
-      tokenSymbol: destinationToken.symbol,
-      amount: destination.amountUnits,
-      ...(destination.tokenAddress
-        ? { tokenAddress: destination.tokenAddress }
-        : {}),
-      ...(receiverMemo ? { receiverMemo } : {}),
-    },
-    display: {
-      currency: "USD",
-      title: title ?? "Pay",
-      ...(description ? { description } : {}),
-    },
-    metadata: {
-      ...(metadata ?? {}),
-      appId,
-    },
-    ...(webhookUrl ? { webhookUrl } : {}),
-    ...(webhookSecret ? { webhookSecret } : {}),
-  };
-
-  if (apiVersion === "v1") {
-    paymentData.display.intent = title ?? "Pay";
-    paymentData.destination.amountUnits = destination.amountUnits;
-    paymentData.destination.destinationAddress = destinationAddress;
-    paymentData.preferredToken = sourceToken.symbol;
-    paymentData.preferredChain = preferred.preferredChain;
-    paymentData.preferredTokenAddress = preferred.preferredTokenAddress;
-  }
-
-  // Create payment via API
-  const response = await apiClient.post<PaymentResponse>(
-    "/payment-api",
-    paymentData
-  );
-
-  if (!response?.data?.id) {
-    throw new Error(response?.error?.message ?? "Payment creation failed");
-  }
-
-  return response.data;
-}
-
-/**
- * Gets payment details by ID using the new backend API
- * @param paymentId - Payment ID
- * @param apiVersion - Optional API version to use (v2 or v4). Defaults to v4
- * @returns Promise with payment response
- */
-export const getPayment = (
-  paymentId: string,
-  apiVersion?: ApiVersion
-): Promise<ApiResponse<PaymentResponse>> => {
-  // Set API version if provided
-  if (apiVersion) {
-    setApiConfig({ version: apiVersion });
-  }
-
-  if (apiVersion === "v1") {
-    const isMugglePay = paymentId.includes("mugglepay_order");
-    const endpoint = isMugglePay
-      ? `/payment-api/${paymentId}`
-      : `/payment/id/${paymentId}`;
-    return apiClient.get<PaymentResponse>(endpoint);
-  }
-
-  return apiClient.get<PaymentResponse>(`/payment-api/payments/${paymentId}`);
-};

package/src/assert.ts

@@ -1,29 +0,0 @@
-import { debugJson } from "./debug";
-
-export function assert(condition: boolean, ...args: any[]): asserts condition {
-  if (condition) return;
-  let msg: string;
-  if (args.length === 1 && typeof args[0] === "function") {
-    msg = args[0]();
-  } else {
-    msg = args.map((a) => debugJson(a)).join(", ");
-  }
-  throw new Error("Assertion failed: " + msg);
-}
-
-export function assertNotNull<T>(
-  value: T | null | undefined,
-  ...args: any[]
-): T {
-  assert(value !== null && value !== undefined, ...args);
-  return value;
-}
-
-export function assertEqual<T>(a: T, b: T, ...args: any[]): void {
-  assert(a === b, ...args);
-}
-
-/** Used to compile-time check that switch statements are exhaustive, etc. */
-export function assertUnreachable(_: never): never {
-  throw new Error("Unreachable");
-}