Wallet Operations

Endpoints for managing token distribution and consolidation across multiple Solana wallets.

Distribute (POST /api/wallets/distribute)

Sends amounts of a specific token from a single source wallet to multiple recipient wallets efficiently, potentially bundling transfers into fewer transactions.

Request Endpoint: POST /api/wallets/distribute

Request Body: application/json

{
  "fromWalletAddress": "source_distributor_wallet",
  "tokenAddress": "mint_address_of_token",
  "recipients": [
    { "wallet": "recipient_1_address", "amount": 100.0 }, // Raw amounts
    { "wallet": "recipient_2_address", "amount": 250.5 },
    { "wallet": "recipient_3_address", "amount": 50.0 }
  ]
}

Success Response (200 OK): Returns signatures for the distribution transactions.

{
  "success": true,
  "transactions": ["tx_sig_1", "tx_sig_2"], // May be one or multiple txs
  "details": "Distribution completed"
}

Common Errors:

• 500 Internal Server Error: Insufficient balance in the source wallet, invalid recipient address.

Consolidate Funds (POST /api/wallets/consolidate)

Gathers a specific token from multiple source wallets and sends the total to a single destination wallet.

Note: The exact behavior of minAmount needs clarification. Assuming it's a minimum to pull from each source wallet:

Request Endpoint: POST /api/wallets/consolidate

Request Body: application/json

{
  "toWalletAddress": "central_destination_wallet",
  "tokenAddress": "mint_address_of_token",
  "fromWallets": [
    "source_wallet_1",
    "source_wallet_2",
    "source_wallet_3"
  ],
  "minAmount": "0.01" // Example: Minimum raw amount to pull from each source wallet (Verify interpretation)
}

Success Response (200 OK): Returns signature(s) for the consolidation transaction(s).

{
  "success": true,
  "tx": "consolidation_tx_signature", // Might be one tx if bundled
  "details": "Consolidation completed"
}

Common Errors:

• 500 Internal Server Error: Failure accessing/transferring from a source wallet (e.g., insufficient funds, wallet closed).