topup

Top-up Skill

Answer one question — "how much do I have, and how do I add more" — and hand back a recharge link the person can click without logging in, because their own key is already in it.

Assume the person may not be technical. They came to run a browser or an agent, not to learn about public keys. Do the lookup for them; say the result in plain money.

Step 0: Is connectonion here at all?

co --version

• It runs → go to Step 1.
• It does not → this machine has no co yet. Run the install-connectonion skill first (it installs co, and its co init step creates the key this skill needs), then come back here. Do not ask the user to install anything by hand — the install skill does it.

Step 1: The key that identifies this account

The recharge page fills in from the account's public key, and it lives in ~/.co. Read it — never type it, never show its full value in logs:

python3 -c "from connectonion import address; from pathlib import Path; d=address.load(Path.home()/'.co'); print(d['address'] if d else '')"

• Prints a 0x… address → that is KEY. Keep it.
• Prints nothing → the account was never created. Run install-connectonion (its co init writes the key), then retry this step. On Windows use py -3 or python.

Step 2: The balance

Ask the API with the stored token — co already has it, so this needs nothing from the user. /auth/me returns balance_usd directly (credits minus what has been spent):

TOKEN=$(python3 -c "from connectonion.cli.commands.project_cmd_lib import load_api_key; print(load_api_key() or '')")
BACKEND=$(python3 -c "from connectonion.backend import backend_url; print(backend_url())")
curl -s "$BACKEND/api/v1/auth/me" -H "Authorization: Bearer $TOKEN"

Read balance_usd from the JSON. (Verified against production: /auth/me gives balance_usd; /api/v1/tokens/balance gives the raw credits_usd and total_spent_usd whose difference is the same number — use /auth/me, it does the subtraction.)