wallet_funding_info
Get funding directions and QR codes to top up your Algorand vault, and see which of three setup steps still needs action.
Instructions
Explain how to put money in this wallet, and report which of the three setup steps the vault is on.
For the human, not the agent - it returns an address and instructions, and no part of it can be automated by the agent.
The three steps are in a forced order: ALGO must arrive before the vault can opt into the payment asset, and the opt-in must happen before USDC can be received at all. USDC sent to a vault that has not opted in is rejected outright - it does not sit pending, it fails.
Each step a human performs carries a scan value: an ARC-26 URI an Algorand
wallet can scan. It encodes the address AND the asset id, so the sender cannot
aim at the wrong asset by hand - which matters because sending the wrong one is
rejected rather than held. No amount is encoded; the human types that into their
own wallet where they see it before confirming.
TOPPING UP ONE ASSET. Pass asset - "ALGO", "USDC", or the asset id - and the
reply narrows to that asset's steps AND includes the QR code as an image, so the
human can scan it directly. ALGO codes are black; the payment asset's are blue
and captioned, so the two are not confused at a glance. Omit asset for the
whole picture as text.
The usual flow: wallet_status answers "how much do I have", then
wallet_funding_info(asset="USDC") answers "I want to top up USDC".
SET open_in_browser WHENEVER A HUMAN WANTS TO SCAN THE CODE. The image block
this returns renders in some MCP clients and not in a terminal, so on its own it
can reach the model and never reach the person holding the phone. With the flag,
Obolus writes a self-contained page and opens it in the default browser - no server
and no network needed.
qr_dir optionally writes the codes as PNG files into that directory, under the
same configured file root as body_file/output_file. obolus vault qr prints them
straight into a terminal.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset | No | ||
| qr_dir | No | ||
| open_in_browser | No |