Usecases

Use case 1: Task payment (one agent pays another)

1. Register both agents.
2. Sender checks balance.
3. Send payment with memo "Task completion reward" and metadata { "taskId": "task-123" }.
4. Recipient (or sender) checks payment status and history to confirm.

Use case 2: Batch payouts (one agent pays many)

1. Sender agent has a list of recipients and amounts.
2. Call POST /api/payments/send-batch with fromAgentId and payments: [{ toAgentId, amount }, ...].
3. Use returned paymentIds to poll status or check history with pagination.

Use case 3: Reconciliation with your system

• Attach metadata (e.g. invoiceId, orderId) on send.
• Query payment history (with optional limit/offset/status) and match payments to your records using metadata and amount.

Use case 4: CLI-only workflow

netauth agent register worker-1
netauth agent register worker-2
netauth agent balance worker-1 --sol
netauth payment send worker-1 worker-2 0.5 --sol --memo "Payout"
netauth payment history worker-1 --limit 10

---