Herald + CLI Tool

#!/usr/bin/env node

import { Command } from 'commander';
import { liquidationCommand } from './commands/liquidation';
import { governanceCommand } from './commands/governance';
import { batchCommand } from './commands/batch';
import { rewardsCommand } from './commands/rewards';
import { bridgeCommand } from './commands/bridge';
import { multisigCommand } from './commands/multisig';
import { checkCommand } from './commands/check';
import { usageCommand } from './commands/usage';

const program = new Command();

program
  .name('herald')
  .description('CLI for sending Herald notifications')
  .version('1.0.0');

liquidationCommand(program);
governanceCommand(program);
batchCommand(program);
rewardsCommand(program);
bridgeCommand(program);
multisigCommand(program);
checkCommand(program);
usageCommand(program);

program.parse();

import { Command } from 'commander';
import { Herald } from '@herald-protocol/sdk';

const herald = new Herald({ apiKey: process.env.HERALD_API_KEY! });

export function liquidationCommand(program: Command) {
  program
    .command('liquidation')
    .description('Send liquidation warning to a wallet')
    .argument('<wallet>', 'Recipient wallet address')
    .requiredOption('--hf <number>', 'Health factor')
    .requiredOption('--pos <id>', 'Position ID')
    .option('--debt <number>', 'Debt amount', '0')
    .option('--asset <symbol>', 'Asset symbol', 'SOL')
    .action(async (wallet: string, opts) => {
      const idempotencyKey = `liquidation_${opts.pos}_${Math.floor(Date.now() / 30000)}`;

      const result = await herald.notify({
        wallet,
        subject: `⚠️ Liquidation Warning — Health factor: ${opts.hf}`,
        body: [
          `Position #${opts.pos} is approaching liquidation.`,
          `Health factor: ${opts.hf}`,
          `Debt: ${opts.debt} ${opts.asset}`,
          `Add collateral or repay immediately.`,
        ].join('\n'),
        category: 'defi',
        receipt: true,
        idempotencyKey,
      });

      console.log(`Sent: ${result.notificationId} (${result.status})`);
    });
}