v0.1.0 - first release

An MCP server that gives an AI agent a disposable Algorand wallet, so it can pay
for x402 resources without a human provisioning anything.

uv tool install obol-wallet
claude mcp add obol -e OBOL_NETWORK=testnet -- obol-mcp

On PyPI: https://pypi.org/project/obol-wallet/0.1.0/

What works

Payments settle on testnet from a short-lived session account funded by a vault
that never signs a payment itself. Sessions open lazily on the first paid call,
sweep themselves back after an idle timeout, and an unclean exit is recovered on
the next start — proved by killing the process at all three windows where money
can be stranded, not by mocking them.

Three tools: x402_fetch, wallet_status, wallet_funding_info. There are no
verbs for any particular merchant, deliberately.

What to know before using it

• The session balance is the real ceiling, enforced on chain. The in-process
  caps are configuration and protect your own money.
• Approval is per tool, not per payment. Most MCP clients ask once and
  remember, so the caps in config.toml are your actual spending boundary. This
  was measured rather than assumed — see DESIGN.md §7.1.
• Your seed is the only way back to your money. It lives in your data
  directory; back it up.
• A settled payment proves settlement and nothing else — not that the
  resource was correct, honest, or worth its price.

The first mainnet payment is the next milestone and is not part of this release.