Agent Wallet Dashboard

Run a local Next.js dashboard to inspect wallet config, balances, and payment history.

The Agent Wallet Dashboard is a read-only UI for operators and developers who want visibility into zbdw state.

Repository

Source code, setup docs, and sample-data fixtures.

Works with zbdw files

Reads ~/.zbd-wallet/config.json and ~/.zbd-wallet/payments.json by default.

Run Locally

npm install
npm run dev

Open the URL printed by the Next.js dev server.

Environment Variables

Variable	Default
ZBD_WALLET_CONFIG	~/.zbd-wallet/config.json
ZBD_WALLET_PAYMENTS	~/.zbd-wallet/payments.json
ZBD_API_BASE_URL	https://api.zbdpay.com

Use Included Sample Data

ZBD_WALLET_CONFIG="$PWD/sample-data/config.json" \
ZBD_WALLET_PAYMENTS="$PWD/sample-data/payments.json" \
npm run dev

Built-in Features

Auto-refresh

Refreshes wallet data every 15 seconds with manual refresh support.

CSV Export

Export filtered payment ledgers (All, Received, Sent).

Transaction Dialog

Click rows for detailed payload and copy actions.

Theme Toggle

Persistent light/dark mode with local preference storage.

The dashboard is intentionally read-only. It does not mutate wallet files.