Files

david b10706cf69 fix(wallet-monitor): post only on state changes, drop reminder re-alerts

Slack posts now fire only when a wallet newly drops below its threshold
or recovers above it; a wallet that stays low never re-posts. The
reminder_hours mechanism is removed entirely — per-wallet reminder
clocks drifted apart (Ogmios blips skip wallets from a run), so with
many chronically-low wallets some clock came due nearly every run,
collapsing the 6h cadence to the hourly cron interval.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-28 11:12:45 +02:00

src

fix(wallet-monitor): post only on state changes, drop reminder re-alerts

2026-07-28 11:12:45 +02:00

.env.example

fix(wallet-monitor): post only on state changes, drop reminder re-alerts

2026-07-28 11:12:45 +02:00

Dockerfile

feat(wallet-monitor): Slack alerts for low operator wallet balances

2026-06-16 11:00:30 +02:00

package.json

feat(wallet-monitor): Slack alerts for low operator wallet balances

2026-06-16 11:00:30 +02:00

README.md

fix(wallet-monitor): post only on state changes, drop reminder re-alerts

2026-07-28 11:12:45 +02:00

tsconfig.json

feat(wallet-monitor): Slack alerts for low operator wallet balances

2026-06-16 11:00:30 +02:00

wallets.example.json

fix(wallet-monitor): post only on state changes, drop reminder re-alerts

2026-07-28 11:12:45 +02:00

README.md

wallet-monitor

One-shot wallet-balance Slack alerter for the vector-marketplace mainnet box.

Checks every wallet in wallets.json against a threshold (default 10 APEX) and posts a combined Slack message only when something changed since the last run — a wallet newly dropped below its threshold, or climbed back above it. A wallet that merely stays low never re-posts. Each alert lists every monitored wallet — low (🔴) and healthy (🟢) — with its full, copy-pasteable address; it stays fully silent while nothing changes. Balances are read from Ogmios via ReadOnlyOgmiosProvider (@marketplace/shared/chain) — the same client behind the buyer's /v1/wallet/balance and buyer/scripts/monitor-wallets.ts.

It is not a long-running server: it runs once and exits, invoked hourly by cron through docker compose run --rm. Dedup state lives in wallet-monitor/data/state.json (bind-mounted, gitignored).

Files

File	Purpose
`src/index.ts`	one-shot check + classify + Slack post + state
`src/config.ts`	env loading + `wallets.json` parsing/validation
`src/slack.ts`	`postSlack()` Incoming-Webhook helper
`wallets.json`	the wallet list + thresholds (gitignored; see `wallets.example.json`)
`.env`	`SLACK_WEBHOOK_URL` (gitignored; see `.env.example`)

Deploy on the box (one-time)

Generate wallets.json. From a laptop with SSH access, run pnpm tsx buyer/scripts/monitor-wallets.ts --json and copy the address of each of the 7 *@vector-marketplace rows into wallet-monitor/wallets.json (start from wallets.example.json). Per-wallet min_ap3x is optional.
Set the webhook. cp wallet-monitor/.env.example wallet-monitor/.env and fill in SLACK_WEBHOOK_URL.
Build. docker compose -f deploy/mainnet/docker-compose.wallet-monitor.yml build
Smoke-test the webhook. docker compose -f deploy/mainnet/docker-compose.wallet-monitor.yml run --rm -e TEST=1 wallet-monitor → expect a "✅ wallet-monitor configured" message in Slack.

Schedule it. Add /etc/cron.d/wallet-monitor:

0 * * * * root cd /root/agents-marketplace && docker compose -f deploy/mainnet/docker-compose.wallet-monitor.yml run --rm wallet-monitor >> /var/log/wallet-monitor.log 2>&1

Behaviour notes

Failures don't alert. If Ogmios is unreachable or a wallet query errors, the run logs to stderr and exits non-zero — no Slack noise — and that wallet's state is left untouched (an Ogmios blip is never mistaken for a recovery).
State only advances on a successful post. A failed Slack POST leaves the state file unchanged so the alert retries on the next run.