/api/raida/lockers/peek

{
  "status": "success",
  "operation": "locker_peek",
  "successful_peeks": 24,
  "responses_received": 25,
  "coin_count": 5,
  "raida_responses": [
    {
      "raida_id": 0,
      "received": true,
      "status": "ALL_PASS",
      "coin_count": 5
    },
    {
      "raida_id": 1,
      "received": true,
      "status": "ALL_PASS",
      "coin_count": 5
    },
    // ... 23 more RAIDA responses ...
  ],
  "coins": [
    {
      "denomination": "100",
      "serial_number": 12345,
      "value": 100
    },
    {
      "denomination": "250",
      "serial_number": 67890,
      "value": 250
    },
    {
      "denomination": "25",
      "serial_number": 54321,
      "value": 25
    },
    {
      "denomination": "5",
      "serial_number": 98765,
      "value": 5
    },
    {
      "denomination": "1",
      "serial_number": 13579,
      "value": 1
    }
  ]
}

{
  "status": "error",
  "message": "Invalid locker_key (must be 32 hex characters)",
  "error_code": 400
}

{
  "status": "error",
  "message": "Locker not found",
  "error_code": 404
}

{
  "status": "error",
  "message": "Insufficient RAIDA responses",
  "error_code": 503
}

const API_HOST = 'http://localhost:8080';

async function receiveLockerTransfer(lockerKey) {
    try {
        // Step 1: Peek to verify locker contents
        console.log('Step 1: Peeking locker...');
        const peekResp = await fetch(
            `${API_HOST}/api/raida/lockers/peek?locker_key=${lockerKey}`
        );

        if (!peekResp.ok) {
            const error = await peekResp.json();
            throw new Error(`Peek failed: ${error.message}`);
        }

        const peekData = await peekResp.json();
        console.log(`Found ${peekData.coin_count} coins in locker`);

        // Step 2: Calculate total value
        const totalValue = peekData.coins.reduce((sum, coin) => sum + coin.value, 0);
        console.log(`Total value: ${totalValue} CloudCoins`);

        // Step 3: Confirm with user (in real app, show UI dialog)
        console.log('Confirm download? (yes/no)');
        // Assuming user confirms...

        // Step 4: Download coins from locker
        console.log('Step 2: Downloading coins...');
        const downloadResp = await fetch(
            `${API_HOST}/api/transactions/locker/download?locker_key=${lockerKey}`
        );

        if (!downloadResp.ok) {
            const error = await downloadResp.json();
            throw new Error(`Download failed: ${error.message}`);
        }

        const downloadData = await downloadResp.json();
        console.log(`Successfully downloaded ${downloadData.coins_downloaded} coins`);
        console.log(`Files saved to: ${downloadData.import_folder}`);

        // Step 5: Verify locker is now empty (optional)
        console.log('Step 3: Verifying locker is empty...');
        const verifyResp = await fetch(
            `${API_HOST}/api/raida/lockers/peek?locker_key=${lockerKey}`
        );

        const verifyData = await verifyResp.json();
        if (verifyData.coin_count === 0) {
            console.log('✓ Locker is now empty - transfer complete');
        } else {
            console.warn(`⚠ Warning: ${verifyData.coin_count} coins still in locker`);
        }

    } catch (error) {
        console.error('Transfer failed:', error.message);
    }
}

// Example usage
const receivedLockerKey = 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6';
receiveLockerTransfer(receivedLockerKey);