send Commands

The /transfer command provides access to all transfer-related features, including viewing transfer history and initiating new transfers. The /send command is a shortcut to the "Send Funds" functionality.

Command Overview

Purpose: View and manage transfers, send funds

Authentication Required: Yes

KYC Required: Yes

Implementation Files:

src/bot/handlers/transfer.handler.ts

src/services/transfer.service.ts

Features

The transfer commands provide the following functionality:

List Transfers: View transaction history with pagination

Transfer Details: View detailed information about a specific transfer

Send Funds: Send funds to another user via email or wallet address

Withdraw to Wallet: Withdraw funds to an external wallet

Batch Transfer: Send funds to multiple recipients in a batch

Offramp Transfer: Convert crypto to fiat and withdraw to a bank account

Transfer Flows

/transfer → Transfer Operations Menu →
  → List Transfers
  → Send Funds
  → Withdraw to Wallet
  → Batch Transfer
  → Offramp Transfer

Send Funds Flow

/send or "Send Funds" →
  → Send by Email or Send by Wallet Address →
  → Enter Recipient →
  → Enter Amount →
  → Select Currency →
  → Select Purpose →
  → Confirm Transfer

List Transfers Flow

"List Transfers" → View Transfers List → Select Transfer → View Transfer Details

Response Examples

💸 Transfer Operations

Choose an operation:

With buttons:

📋 List Transfers

💸 Send Funds

🏧 Withdraw to Wallet

📦 Batch Transfer

🏦 Offramp Transfer

Send Funds Initial Screen

💸 Send Funds

How would you like to send funds?

With buttons:

📧 Send by Email

🔑 Send by Wallet Address

Cancel

Enter Amount Screen

💰 Enter Amount

Please enter the amount you want to send to recipient@example.com:

Select Currency Screen

💱 Select Currency

Please select the currency:

With buttons:

USDT

USDC

ETH

BTC

Cancel

Confirm Transfer Screen

✅ Confirm Transfer

You are about to send:
Amount: 100 USDT
To: recipient@example.com
Purpose: PAYMENT

Do you want to proceed?

With buttons:

✅ Confirm

❌ Cancel

Transfer List

📋 Your Transfers (Page 1/3)

Select a transfer to view details:

With buttons for each transfer and pagination controls.

Implementation Details

Transfer Command Handler

Multi-step Send Flow

The send flow uses session state to track progress:

Transfer Service Integration

The transfer features integrate with the TransferService to perform operations:

Transfer Data Structures

The transfer feature uses these key data structures:

Session States for Transfer Flow

The transfer flow uses these session states:

UserState.AWAITING_RECIPIENT_EMAIL: Waiting for recipient email

UserState.AWAITING_WALLET_ADDRESS: Waiting for recipient wallet address

UserState.AWAITING_AMOUNT: Waiting for transfer amount

UserState.AWAITING_CURRENCY: Waiting for currency selection

UserState.AWAITING_PURPOSE: Waiting for purpose selection

UserState.AWAITING_CONFIRMATION: Waiting for transfer confirmation

Input Validation

The transfer process includes validation for:

Email addresses: /^[^\s@]+@[^\s@]+\.[^\s@]+$/

Wallet addresses: Basic length and format checks

Amount: Must be a positive number

Currency: Must be from the supported list

Purpose code: Must be from the supported list

Error Handling

The transfer commands handle various error scenarios:

Authentication errors

KYC verification errors

Invalid input errors

API errors when fetching or creating transfers

Network errors

src/bot/messages/transfer.messages.ts - Contains transfer message templates

src/services/transfer.service.ts - Service for transfer operations

src/utils/copperxApi/copperxApi.transfers.ts - API client for transfer operations

src/types/transfers.types.ts - Transfer data type definitions

Best Practices

Always confirm transfers before execution

Provide clear feedback after transfer execution (success or failure)

Format currency amounts with appropriate decimal places

Allow cancellation at any step of the multi-step flow

Implement pagination for transfer lists to handle large transaction histories

Show relevant details in transfer history (date, amount, status)

transfer

/transfer and /send Commands#

Command Overview#

Features#

Transfer Flows#

Main Transfer Menu Flow#

Send Funds Flow#

List Transfers Flow#

Response Examples#

Transfer Operations Menu#

Send Funds Initial Screen#

Enter Amount Screen#

Select Currency Screen#

Confirm Transfer Screen#

Transfer List#

Implementation Details#

Transfer Command Handler#

Multi-step Send Flow#

Transfer Service Integration#

Transfer Data Structures#

Session States for Transfer Flow#

Input Validation#

Error Handling#

Related Files#

Best Practices#

/transfer and /send Commands

Command Overview

Features

Transfer Flows

Main Transfer Menu Flow

Send Funds Flow

List Transfers Flow

Response Examples

Transfer Operations Menu

Send Funds Initial Screen

Enter Amount Screen

Select Currency Screen

Confirm Transfer Screen

Transfer List

Implementation Details

Transfer Command Handler

Multi-step Send Flow

Transfer Service Integration

Transfer Data Structures

Session States for Transfer Flow

Input Validation

Error Handling

Related Files

Best Practices