Function handleCommand

server/src/api/control.js:19–57

* Handles a single control command from the `adm-pool` CLI. * * The control channel is a local Unix domain socket with owner-only (`0600`) * permissions; the operator password is only ever read here, never logged. * @param {{cmd: string, password?: string}} message Parsed control request * @ret

(message)

 * @returns {object} JSON-serializable response
 */
function handleCommand(message) {
  const { cmd, password } = message;

  switch (cmd) {
    case 'status':
      return { ok: true, health: buildHealth() };

    case 'unlock': {
      if (!password) {
        return { ok: false, error: 'Operator password is required.' };
      }

      try {
        const { address } = secret.unlock(password);

        log.info(`Pool ${address} unlocked via control socket. Payouts and ADM notifications enabled.`);

        return { ok: true, message: `Pool unlocked for ${address}.`, health: buildHealth() };
      } catch (error) {
        return { ok: false, error: error.message };
      }
    }

    case 'lock': {
      try {
        secret.lock();

        log.log('Pool locked via control socket. Decrypted passphrase cleared from memory.');

        return { ok: true, message: 'Pool locked. Decrypted passphrase cleared from memory.', health: buildHealth() };
      } catch (error) {
        return { ok: false, error: error.message };
      }
    }

    default:
      return { ok: false, error: `Unknown command: ${cmd}` };
  }
}

/**
 * Starts the local control socket that backs `adm-pool unlock`, `lock`, and `status`.