---
name: wallet
description: Check the PostBridge workspace wallet balance and add funds. Use when the user asks about postage balance, credits, wallet status, or wants to top up before mailing.
license: MIT
metadata:
  author: postbridge
  version: "0.1"
---

# Wallet balance and top-up

All PostBridge sends spend from the authenticated workspace wallet.

## Workflow

1. **Balance.** Call `get_balance` and report the amount and currency. If the
   balance is below the cost of an intended send, say so before quoting.
2. **Top-up.** `top_up_wallet` moves real money. NEVER call it without explicit
   user confirmation of the exact amount. Report the resulting balance after
   the operation.
3. **Failed payments.** If a top-up fails, report the error as returned and
   suggest the user check the payment method in the PostBridge dashboard. Do
   not retry automatically.

## Rules

- Balance and top-up are financial operations: confirm amounts, never round,
  never guess currency.
- A low balance is information, not an instruction to top up.