internet-court/internet-court-skill/altllm-portal-auth

AltLLM Portal Auth

Wallet login and session bootstrap for the local altllm CLI, including external signers such as Privy.

Shared Setup

Before the first altllm command in a fresh checkout, read and follow:

- ../_shared/preflight.md

- ../_shared/session-and-target.md

Command Index

Rules

• Do not assume the CLI must control the wallet private key.
• If the wallet can sign the challenge message, use the prepare + verify flow.
• External signers such as Privy are valid as long as they return a standard wallet signature for the challenge.
• If neither a local private key nor --signature is available, return the challenge payload and stop.
• Before local auto-signing, validate that the returned challenge matches the requested wallet, chain, and expected AltLLM login challenge structure.
• For non-default, non-loopback API hosts, prefer --prepare and external signing instead of local auto-signing.
• Current backend support is still limited to EVM addresses and Ethereum-style signatures.
• Save the resulting session to ~/.altllm/portal-cli-session.json unless overridden.
• Use status or its whoami alias to confirm the saved user and target URL before running live commands.
• logout only removes the local session file. It does not revoke API keys.

Reference

See references/cli-reference.md for commands, payloads, and troubleshooting notes.