@profullstack/coinpay 0.3.10 → 0.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@profullstack/coinpay",
-  "version": "0.3.10",
-  "description": "CoinPay SDK & CLI — Accept cryptocurrency payments (BTC, ETH, SOL, POL, BCH, USDC) in your Node.js application",
+  "version": "0.4.0",
+  "description": "CoinPay SDK & CLI — Accept cryptocurrency payments (BTC, ETH, SOL, POL, BCH, USDC) with wallet and swap support",
   "type": "module",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -20,6 +20,14 @@
     "./webhooks": {
       "import": "./src/webhooks.js",
       "types": "./src/webhooks.d.ts"
+    },
+    "./wallet": {
+      "import": "./src/wallet.js",
+      "types": "./src/wallet.d.ts"
+    },
+    "./swap": {
+      "import": "./src/swap.js",
+      "types": "./src/swap.d.ts"
     }
   },
   "files": [
@@ -49,12 +57,16 @@
     "stablecoin",
     "non-custodial",
     "wallet",
+    "swap",
+    "exchange",
     "sdk",
     "cli",
     "web3",
     "blockchain",
     "payment-gateway",
-    "merchant"
+    "merchant",
+    "bip39",
+    "mnemonic"
   ],
   "author": "Profullstack, Inc.",
   "license": "MIT",
@@ -76,5 +88,10 @@
     "prettier": "^3.4.1"
   },
   "peerDependencies": {},
-  "dependencies": {}
+  "dependencies": {
+    "@scure/bip39": "^1.4.0",
+    "@scure/bip32": "^1.5.0",
+    "@noble/curves": "^1.6.0",
+    "@noble/hashes": "^1.5.0"
+  }
 }

package/src/index.d.ts

@@ -5,9 +5,17 @@
  * @module @profullstack/coinpay
  */
 
+// Client exports
 export { CoinPayClient } from './client.js';
-export type { CoinPayClientOptions, PaymentParams, ListPaymentsParams, WaitForPaymentOptions, CreateBusinessParams } from './client.js';
+export type { 
+  CoinPayClientOptions, 
+  PaymentParams, 
+  ListPaymentsParams, 
+  WaitForPaymentOptions, 
+  CreateBusinessParams 
+} from './client.js';
 
+// Payment exports
 export {
   createPayment,
   getPayment,
@@ -17,8 +25,13 @@ export {
   PaymentStatus,
   FiatCurrency,
 } from './payments.js';
-export type { CreatePaymentParams, GetPaymentParams, ListPaymentsFnParams } from './payments.js';
+export type { 
+  CreatePaymentParams, 
+  GetPaymentParams, 
+  ListPaymentsFnParams 
+} from './payments.js';
 
+// Webhook exports
 export {
   verifyWebhookSignature,
   generateWebhookSignature,
@@ -33,5 +46,55 @@ export type {
   ParsedWebhookEvent,
 } from './webhooks.js';
 
+// Wallet exports
+export {
+  WalletClient,
+  WalletChain,
+  DEFAULT_CHAINS,
+  generateMnemonic,
+  validateMnemonic,
+  getDerivationPath,
+  restoreFromBackup,
+} from './wallet.js';
+export type {
+  WalletChainType,
+  WalletCreateOptions,
+  WalletImportOptions,
+  WalletAddress,
+  AddressListResult,
+  WalletBalance,
+  SendOptions,
+  HistoryOptions,
+  Transaction,
+  FeeEstimate,
+} from './wallet.js';
+
+// Swap exports
+export {
+  SwapClient,
+  SwapCoins,
+  SwapStatus,
+  getSwapCoins,
+  getSwapQuote,
+  createSwap,
+  getSwapStatus,
+  getSwapHistory,
+} from './swap.js';
+export type {
+  SwapStatusType,
+  SwapClientOptions,
+  CoinInfo,
+  CoinsResult,
+  SwapQuote,
+  QuoteResult,
+  CreateSwapParams,
+  Swap,
+  SwapResult,
+  WaitForSwapOptions,
+  SwapHistoryOptions,
+  SwapHistoryPagination,
+  SwapHistoryResult,
+} from './swap.js';
+
 import { CoinPayClient } from './client.js';
 export default CoinPayClient;

package/src/index.js

@@ -16,6 +16,24 @@
  *   blockchain: Blockchain.BTC,
  *   description: 'Order #12345'
  * });
+ *
+ * @example
+ * // Wallet usage
+ * import { WalletClient } from '@profullstack/coinpay';
+ *
+ * // Create a new wallet
+ * const wallet = await WalletClient.create({ words: 12, chains: ['BTC', 'ETH'] });
+ * console.log('Backup your seed:', wallet.getMnemonic());
+ *
+ * // Or import existing
+ * const wallet = await WalletClient.fromSeed('your twelve word mnemonic phrase ...');
+ *
+ * @example
+ * // Swap usage
+ * import { SwapClient } from '@profullstack/coinpay';
+ *
+ * const swap = new SwapClient({ walletId: 'your-wallet-id' });
+ * const quote = await swap.getSwapQuote('BTC', 'ETH', 0.1);
  */
 
 import { CoinPayClient } from './client.js';
@@ -47,6 +65,29 @@ import {
   waitForEscrow,
 } from './escrow.js';
 
+// Wallet exports
+import {
+  WalletClient,
+  WalletChain,
+  DEFAULT_CHAINS,
+  generateMnemonic,
+  validateMnemonic,
+  getDerivationPath,
+  restoreFromBackup,
+} from './wallet.js';
+
+// Swap exports
+import {
+  SwapClient,
+  SwapCoins,
+  SwapStatus,
+  getSwapCoins,
+  getSwapQuote,
+  createSwap,
+  getSwapStatus,
+  getSwapHistory,
+} from './swap.js';
+
 export {
   // Client
   CoinPayClient,
@@ -66,6 +107,25 @@ export {
   getEscrowEvents,
   waitForEscrow,
   
+  // Wallet
+  WalletClient,
+  WalletChain,
+  DEFAULT_CHAINS,
+  generateMnemonic,
+  validateMnemonic,
+  getDerivationPath,
+  restoreFromBackup,
+  
+  // Swap
+  SwapClient,
+  SwapCoins,
+  SwapStatus,
+  getSwapCoins,
+  getSwapQuote,
+  createSwap,
+  getSwapStatus,
+  getSwapHistory,
+  
   // Constants
   Blockchain,
   Cryptocurrency,  // Deprecated, use Blockchain
@@ -80,4 +140,4 @@ export {
   WebhookEvent,
 };
 
-export default CoinPayClient;
+export default CoinPayClient;

package/src/swap.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Swap Module Type Definitions
+ */
+
+/**
+ * Supported coins for swaps
+ */
+export declare const SwapCoins: readonly string[];
+
+/**
+ * Swap status values
+ */
+export declare const SwapStatus: {
+  readonly PENDING: 'pending';
+  readonly PROCESSING: 'processing';
+  readonly SETTLING: 'settling';
+  readonly SETTLED: 'settled';
+  readonly FAILED: 'failed';
+  readonly REFUNDED: 'refunded';
+  readonly EXPIRED: 'expired';
+};
+
+export type SwapStatusType = (typeof SwapStatus)[keyof typeof SwapStatus];
+
+/**
+ * Swap client options
+ */
+export interface SwapClientOptions {
+  /** Wallet ID for tracking swaps */
+  walletId?: string;
+  /** API base URL */
+  baseUrl?: string;
+  /** Request timeout in ms */
+  timeout?: number;
+}
+
+/**
+ * Coin information
+ */
+export interface CoinInfo {
+  symbol: string;
+  name: string;
+  network: string;
+  ticker: string;
+}
+
+/**
+ * Coins list result
+ */
+export interface CoinsResult {
+  success: boolean;
+  provider: string;
+  coins: CoinInfo[];
+  count: number;
+}
+
+/**
+ * Swap quote
+ */
+export interface SwapQuote {
+  from: string;
+  to: string;
+  depositAmount: string;
+  settleAmount: string;
+  rate: string;
+  minAmount: number;
+  provider: string;
+}
+
+/**
+ * Quote result
+ */
+export interface QuoteResult {
+  success: boolean;
+  quote: SwapQuote;
+}
+
+/**
+ * Create swap parameters
+ */
+export interface CreateSwapParams {
+  /** Source coin (e.g., 'BTC') */
+  from: string;
+  /** Destination coin (e.g., 'ETH') */
+  to: string;
+  /** Amount to swap */
+  amount: string | number;
+  /** Address to receive swapped coins */
+  settleAddress: string;
+  /** Address for refunds (recommended) */
+  refundAddress?: string;
+  /** Override wallet ID */
+  walletId?: string;
+}
+
+/**
+ * Swap details
+ */
+export interface Swap {
+  id: string;
+  from: string;
+  to: string;
+  depositAddress: string;
+  depositAmount: string;
+  depositCoin?: string;
+  settleAddress: string;
+  settleAmount?: string;
+  settleCoin?: string;
+  status: SwapStatusType;
+  createdAt: string;
+  provider: string;
+}
+
+/**
+ * Swap result
+ */
+export interface SwapResult {
+  success: boolean;
+  swap: Swap;
+}
+
+/**
+ * Wait for swap options
+ */
+export interface WaitForSwapOptions {
+  /** Polling interval in ms (default: 10000) */
+  interval?: number;
+  /** Maximum wait time in ms (default: 3600000) */
+  timeout?: number;
+  /** Statuses to wait for */
+  targetStatuses?: SwapStatusType[];
+  /** Callback when status changes */
+  onStatusChange?: (status: SwapStatusType, swap: Swap) => void;
+}
+
+/**
+ * Swap history options
+ */
+export interface SwapHistoryOptions {
+  /** Filter by status */
+  status?: SwapStatusType;
+  /** Number of results (default: 50) */
+  limit?: number;
+  /** Pagination offset */
+  offset?: number;
+}
+
+/**
+ * Swap history pagination
+ */
+export interface SwapHistoryPagination {
+  total: number;
+  limit: number;
+  offset: number;
+  hasMore: boolean;
+}
+
+/**
+ * Swap history result
+ */
+export interface SwapHistoryResult {
+  success: boolean;
+  swaps: Swap[];
+  pagination: SwapHistoryPagination;
+}
+
+/**
+ * SwapClient class for handling cryptocurrency swaps
+ */
+export declare class SwapClient {
+  /**
+   * Create a SwapClient
+   */
+  constructor(options?: SwapClientOptions);
+  
+  /**
+   * Set the wallet ID for tracking swaps
+   */
+  setWalletId(walletId: string): void;
+  
+  /**
+   * Get list of supported coins for swaps
+   */
+  getSwapCoins(options?: { search?: string }): Promise<CoinsResult>;
+  
+  /**
+   * Get a swap quote
+   */
+  getSwapQuote(from: string, to: string, amount: string | number): Promise<QuoteResult>;
+  
+  /**
+   * Create a swap transaction
+   */
+  createSwap(params: CreateSwapParams): Promise<SwapResult>;
+  
+  /**
+   * Get the status of a swap
+   */
+  getSwapStatus(swapId: string): Promise<SwapResult>;
+  
+  /**
+   * Wait for a swap to complete
+   */
+  waitForSwap(swapId: string, options?: WaitForSwapOptions): Promise<SwapResult>;
+  
+  /**
+   * Get swap history for a wallet
+   */
+  getSwapHistory(walletId?: string, options?: SwapHistoryOptions): Promise<SwapHistoryResult>;
+}
+
+/**
+ * Get supported swap coins (convenience function)
+ */
+export declare function getSwapCoins(options?: {
+  baseUrl?: string;
+  search?: string;
+}): Promise<CoinsResult>;
+
+/**
+ * Get a swap quote (convenience function)
+ */
+export declare function getSwapQuote(
+  from: string,
+  to: string,
+  amount: string | number,
+  options?: { baseUrl?: string }
+): Promise<QuoteResult>;
+
+/**
+ * Create a swap (convenience function)
+ */
+export declare function createSwap(
+  params: CreateSwapParams,
+  options?: { baseUrl?: string }
+): Promise<SwapResult>;
+
+/**
+ * Get swap status (convenience function)
+ */
+export declare function getSwapStatus(
+  swapId: string,
+  options?: { baseUrl?: string }
+): Promise<SwapResult>;
+
+/**
+ * Get swap history (convenience function)
+ */
+export declare function getSwapHistory(
+  walletId: string,
+  options?: SwapHistoryOptions & { baseUrl?: string }
+): Promise<SwapHistoryResult>;
+
+export default SwapClient;