About authenticate-wallet
authenticate-wallet is a skill for signing in to Agentic Wallet with the `npx awal` CLI. It guides users or agents through email OTP verification, status checks, and input validation.
Key features
- 01Two-step email OTP login
- 02Check wallet authentication status
- 03Validate email and OTP input
- 04Machine-readable JSON output
Use cases
- 01Start authentication when the wallet is signed out
- 02Complete login with an email code
- 03Check wallet health and address
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/authenticate-walletin Claude Code to confirm it loaded.
Details
From the project READMEAuthenticating with the Agentic Wallet
When the wallet is not signed in (detected via npx awal status or when wallet operations fail with authentication errors), use the npx awal CLI to authenticate.
If you have access to email, you can authenticate the wallet yourself, otherwise you'll need to ask your human to give you an email address and to tell you the OTP code they receive.
Authentication Flow
Authentication uses a two-step email OTP process:
Step 1: Initiate login
npx [email protected] auth login <email>
This sends a 6-digit verification code to the email and outputs a flowId.
Step 2: Verify OTP
npx [email protected] auth verify <otp>
Use the 6-digit code from the user's email to complete authentication. The flow ID from step 1 is saved automatically to a local file — you do not pass it as an argument. If you have the ability to access the user's email, you can read the OTP code, or you can ask your human for the code.
Input Validation
Before constructing the command, validate all user-provided values to prevent shell injection:
- email: Must match a standard email format (
^[^\s;|&]+@[^\s;|&]+$). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters. - otp: Must be exactly 6 digits (
^\d{6}$).
Do not pass unvalidated user input into the command.
Checking Authentication Status
npx [email protected] status
Displays wallet server health and authentication status including wallet address.
Example Session
# Check current status
npx [email protected] status
# Start login (sends OTP to email)
npx [email protected] auth login [email protected]
# Output: flowId: abc123...
# After user receives code, verify (flow ID saved automatically)
npx [email protected] auth verify 123456
# Confirm authentication
npx [email protected] status
Available CLI Commands
| Command | Purpose |
|---|---|
npx [email protected] status | Check server health and auth status |
npx [email protected] auth login <email> | Send OTP code to email, returns flowId |
npx [email protected] auth verify <otp> | Complete authentication with OTP code |
npx [email protected] balance | Get balances across Base, Polygon, and Solana (use --chain for a single chain) |
npx [email protected] address | Get wallet address |
npx [email protected] show | Open the wallet companion window |
JSON Output
All commands support --json for machine-readable output:
npx [email protected] status --json
npx [email protected] auth login [email protected] --json
npx [email protected] auth verify <otp> --json