Bundler e Cleaner

Transaction handling like sending bundles and the "Cleaner" operation

Send Bundles (Jito) (POST /api/transactions/send)

Submits a list of pre-constructed, serialized (likely base64-encoded) Solana transactions as a bundle. Fury can route these bundles through Jito's Block Engine for potential MEV protection and prioritized block inclusion.

Request Endpoint: POST /api/transactions/send

Request Body: application/json

{
  "transactions": [
    "base64_encoded_serialized_transaction_1",
    "base64_encoded_serialized_transaction_2"
    // ... more transactions
  ],
  "wait": false // Set to true to wait for block confirmation (longer response time)
}

Success Response (200 OK): Returns the signatures of the submitted transactions. Details might include Jito bundle info.

{
  "success": true,
  "txs": ["tx_sig_1", "tx_sig_2"],
  "details": { /* Potentially Jito bundle ID or confirmation status if wait=true */ }
}

Common Errors:

• 400 Bad Request: Invalid transaction format in the array.

• 500 Internal Server Error: Jito submission error, network issue, invalid transaction logic within the bundle.

Cleaner (POST /api/tokens/cleaner)

This specialized endpoint facilitates coordinated transfers between designated parties, often described as "cleaning" between seller and buyer addresses. It likely involves conditional logic based on the state of the walletAddress and potentially its transaction history (maxTxCount) or balance (minBalance) for the specified tokenAddress.

Note: This endpoint's exact workflow requires precise definition. Provide specific details on its use case (e.g., OTC settlement, specific bot logic) for accurate documentation.

Request Endpoint: POST /api/tokens/cleaner

Request Body: application/json

{
  "walletAddress": "involved_wallet_address", // Intermediary or party wallet
  "tokenAddress": "token_being_transferred",
  "minBalance": "10.0", // Example: Condition related to the wallet's balance of the token
  "maxTxCount": "5"  // Example: Condition related to transaction history/count
}

{
  "success": true,
  "status": "Cleaner operation status description (e.g., 'Funds transferred', 'Conditions not met')",
  "tx": "relevant_transaction_signature_if_action_taken"
}

Common Errors:

• 500 Internal Server Error: If the underlying logic, conditions, or transfers fail.